VIM

Section: User Commands (1)
Updated: 2006 kwi 11
Page Index
 

NAME

vim - Vi rozbudowany, edytor tekstu dla programisty  

SYNOPSIS


vim [opcje] [plik ..]
vim [opcje] -
vim [opcje] -t znacznik
vim [opcje] -q [plik_b��du]


ex gex
view
gvim gview vimx evim eview
rvim rview rgvim rgview  

OPIS

Vim jest edytorem tekstu kompatybilnym z Vi. Mo�e by� u�ywany do edycji wszelkiego rodzaju plik�w tekstowych. U�yteczny zw�aszcza przy edycji program�w.

Posiada wiele usprawnie� w por�wnaniu z Vi: wielopoziomowe cofanie zmian, wiele okien i bufor�w, pod�wietlanie sk�adni, edycja linii polece�, uzupe�nianie nazw plik�w, pomoc on-line, wizualna selekcja, itd. Zobacz ":help vi_diff.txt" dla podsumowania r�nic pomi�dzy Vimem i Vi.

W czasie korzystania z Vima mo�na uzyska� obszern� pomoc z systemu pomocy on-line dzi�ki poleceniu ":help". Zobacz rozdzia� POMOC ON-LINE poni�ej.

Najcz�ciej Vim jest uruchamiany do edycji pojedynczego pliku poleceniem

       vim plik

Bardziej og�lnie Vim jest uruchamiany poprzez:

       vim [opcje] [lista plik�w]

Je�li brak listy plik�w edytor rozpocznie z pustym buforem. W innym wypadku istnieje dok�adnie jedna z czterech mo�liwo�ci by wybra� jeden lub wi�cej plik�w do edycji.

plik ..
Lista nazw plik�w. Pierwsza nazwa b�dzie nazw� bie��cego pliku, kt�ry zostanie wczytany do bufora. Kursor zostanie umieszczony w pierwszym wierszu. Do kolejnych plik�w mo�na przej�� dzi�ki poleceniu ":next". By otworzy� plik, kt�rego nazwa zaczyna si� od my�lnika nale�y list� plik�w poprzedzi� "--".
-
Plik do edycji jest wczytany ze standardowego wej�cia. Polecenia s� odczytywane ze standardowego wyj�cia b��d�w, kt�rym powinien by� terminal (tty).
-t {znacznik}
Plik do edycji i pocz�tkowa pozycja kursora zale�y od "znacznika", rodzaju etykiety goto. {znacznika} szuka si� w pliku tags, zwi�zany z nim plik staje si� plikiem bie��cym i wykonuje si� powi�zane polecenie. Zazwyczaj u�ywa si� tego sposobu dla program�w w C, w kt�rych wypadku {znacznik} mo�e by� nazw� funkcji. W efekcie plik zawieraj�cy okre�lon� funkcj� staje si� plikiem bie��cym a kursor jest umieszczony na pocz�tku funkcji. Zobacz ":help tag-commands".
-q [plik_b��d�w]
Zacznij w trybie quickFix. Plik [plik_b��d�w] zostaje zinterpretowany i poka�e si� pierwszy b��d. Je�li brak opcji [plik_b��d�w] nazwa pliku zostanie pobrana z opcji 'errorfile' (domy�lnie "AztecC.Err" dla Amigi, "errros.err" dla innych system�w. Do kolejnych b��d�w mo�na przeskoczy� dzi�ki poleceniu ":cn". Zobacz ":help quickfix".

W zale�no�ci od wywo�ania Vim zachowuje si� inaczej (program mo�e by� ca�y czas tym samym plikiem).

vim
"Normalny" spos�b, wszystko jest domy�lne.
ex
Zacznij w trybie Ex. Przejd� do trybu Normalnego poleceniem ":vi". Mo�na tak�e uruchomi� poprzez argument "-e".
view
Zacznij w trybie tylko do odczytu. W ten spos�b b�dziesz chroniony przed zapisywaniem pliku. Mo�na tak�e uruchomi� poprzez argument "-R".
gvim gview
Wersja GUI. Uruchamia nowe okno. Mo�na tak�e uruchomi� poprzez argument "-g".
evim eview
Wersja GUI w �atwym trybie. Uruchamia nowe okno. Mo�na tak�e uruchomi� poprzez argument "-y".
rvim rview rgvim rgview
Podobnie jak powy�ej, ale z ograniczeniami. Nie b�dzie mo�na uruchomi� polece� pow�oki lub zawiesi� Vima. Mo�na tak�e uruchomi� poprzez argument "-Z".
 

OPCJE

Opcje mo�na poda� w dowolnej kolejno�ci, przed lub po nazwach plik�w. Opcje bez argument�w mo�na ��czy� po pojedynczym my�lniku.
+[num]
W pierwszym pliku kursor zostanie umieszczony w wierszu "num". Je�li brak "num" kursor zostanie umieszczony w ostatnim wierszu.
+/{wz�r}
W pierwszym pliku kursor zostanie umieszczony na pierwszym wyst�pieniu {wz�r}. Zobacz ":help search-pattern" by dowiedzie� si� jakie s� mo�liwe wzorce wyszukiwania.
+{polecenie}
-c {polecenie}
{polecenie} zostanie wykonane po tym jak wczyta si� pierwszy plik. {polecenie} jest interpretowane jako polecenie Ex. Je�li {poleceni} zawiera bia�e znaki musi by� umieszczone w podw�jnych cudzys�owach (zale�y to od u�ywanej pow�oki). Przyk�ad: vim "+set si" main.c
Uwaga: Mo�na u�y� do 10 polece� "+" lub "-c".
-S {plik}
{plik} zostanie zinterpretowany po wczytaniu pierwszego pliku. Jest r�wnowa�ne -c "source {plik}". {plik} nie mo�e zaczyna� si� '-'. Je�li nie podano {plik} zostanie u�yty "Session.vim" (dzia�a tylko wtedy je�li -S jest ostatnim argumentem).
--cmd {polecenie}
Podobne do "-c", ale polecenie jest wykonywane tu� przed interpretacj� jakiegokolwiek pliku vimrc. Mo�na u�y� do 10 takich polece�, niezale�nie od polece� od "-c"
-A
Je�li Vim zosta� skompilowany ze wsparciem dla j�zyk�w arabskich (edycja od prawej do lewej i arabska mapa klawiatury) ta opcja uruchamia Vima w trybie arabskim, np. ustawia si� opcja 'arabic'. W innym wypadku pojawi si� komunikat b��du i Vim zako�czy dzia�anie.
-b
Tryb binarny. Ustawi si� kilka opcji, kt�re umo�liwi� edycj� plik�w binarnych lub wykonywalnych.
-C
Kompatybilny. Ustawia opcj� 'compatible'. W ten spos�b Vim b�dzie zachowywa� si� jak Vi, nawet je�li istnieje plik .vimrc.
-d
Uruchom w trybie diff. Powinno si� u�y� dw�ch, trzech lub czterech nazwy plik�w jako argument�w. Vim otworzy wszystkie te pliki i poka�e r�nice mi�dzy nimi. Dzia�a jak vimdiff(1).
-d {urz�dzenie}
Otw�rz {urz�dzenie} by u�ywa� jako terminal. Tylko na Amidze. Przyk�ad: "-d con:20/30/600/150".
-D
Debugowanie. Przejd� do trybu debugowanie wykonuj�c pierwsze polecenie ze skryptu.
-e
Uruchom Vima w trybie Ex, dzia�a tak samo jakby wywo�ano program jako "ex".
-E
Uruchom Vima w ulepszonym trybie Ex, dzia�a tak samo jakby wywo�ano program jako "exim".
-f
Pierszy plan. Dla wersji GUI. Vim nie nie oddzieli si� od pow�oki w jakiej zosta� uruchomiony. Na Amidze Vim nie jest uruchomiony ponownie by otworzy� nowe okno. Opcja powinna by� u�yta kiedy Vim jest wywo�ywany przez program, kt�ry ma zaczeka� na koniec sesji (np. mail). Na Amidze polecenia ":sh" i ":!" nie b�d� dzia�a�.
--nofork
Pierwszy plan. Dla wersji GUI. Vim nie oddzieli si� od pow�oki w jakiej zosta� uruchomiony.
-F
Je�li Vim zosta� skompilowany ze wsparciem FKMAP dla edycji tekst�w od prawej do lewej i mapowania klawiatury Farsi, ta opcja uruchomi Vima w trybie Farsi, np. zostawi� ustawione opcje 'fkmap' i 'rightleft'. W innym wypadku pojawi si� komunikat b��du i Vim zako�czy dzia�anie.
-g
Je�li Vim zosta� skompilowany ze wsparciem dla GUI ta opcja uruchomi GUI. W innym wypadku pojawi si� komunikat b��du i Vim zako�czy dzia�anie.
-h
Wy�wietli kr�tk� pomoc o argumentach linii polece� i opcjach. Potem Vim zako�czy dzia�anie.
-H
Je�li Vim zosta� skompilowany ze wsparciem RIGHTLEFT dla edycji od prawej do lewej oraz ma mapowanie klawiatury dla hebrajskiego, ta opcja uruchomi Vima w trybie hebrajskim, np. ustawi opcje 'hkmap' i 'rightleft'. W innym wypadku pojawi si� komunikat b��du i Vim zako�czy dzia�anie.
-i {viminfo}
Kiedy Vim u�ywa pliku viminfo ta opcja wska�e jakiego pliku u�y� zamiast domy�lnego "~/.viminfo". Mo�na te� omin�� u�ycie pliku .viminfo przez podanie nazwy "NONE".
-L
To samo co -r.
-l
Tryb Lisp. Ustawia opcje 'lisp' i 'showmatch'.
-m
Zmiana pliku jest niemo�liwa. Przestawia opcj� 'write'. Mo�na zmienia� zawarto�� bufora, ale zapisanie pliku nie jest mo�liwe.
-M
Opcje 'modifiable' i 'write' zostan� wy��czone, tak wi�c zmiany w pliku oraz ich zapisanie nie s� mo�liwe. Warto�� tych opcji mo�na zmieni�.
-N
Tryb niekompatybilny. Przestawia opcj� 'compatible'. Dzi�ki temu Vim b�dzie zachowywa� si� odrobin� lepiej, ale mniej zgodnie z Vi nawet je�li nie istnieje plik .vimrc.
-n
Nie powstanie plik wymiany. Odzyskanie pliku po wypadku nie b�dzie mo�liwe. Wygodne je�li instnieje potrzeba edycji na bardzo wolnym medium (np. dyskietce). Ten cel mo�na osi�gn�� tak�e przez ":set uc=0". Mo�na odwr�ci� przez ":set uc=200".
-nb
Uruchom jako serwer edytora dla NetBeans. Zobacz dokumentacj� by dowiedzie� si� wi�cej.
-o[N]
Otw�rz N okien w stosie. Kiedy brak N, otw�rz jedno okno dla ka�dego pliku.
-O[N]
Otw�rz N okien obok siebie. Kiedy brak N, otw�rz jedno okno dla ka�dego pliku.
-p[N]
Otw�rz N kart. Kiedy brak N, otw�rz jedn� kart� dla ka�dego pliku.
-R
Tryb tylko do odczytu. Zostanie ustawiona opcja 'readonly'. Ca�y czas mo�na zmienia� bufor, ale b�dzie istnia�a blokada by chroni� przed przypadkowym zapisaniem pliku. Je�li chcesz zapisa� plik dodaj wykrzyknik do polecenia Ex, np. ":w!". Opcja -R implikuje opcj� -n (zobacz poni�ej). Opcja 'readonly' mo�e zosta� przestawiona poprzez ":set noro". Zobacz ":help 'readonly'".
-r
Wypisz list� plik�w wymiany razem z informacjami o nich.
-r {plik}
Tryb odzyskiwania danych. Plik wymiany zostanie wykorzystany do odzyskania gwa�townie przerwanej sesji. Plik wymiany to plik z tak� sam� nazw� co plik oryginalny z dodanym ".swp". Zobacz ":help recovery".
-s
Tryb cichy. Rozpocz�ty tylko kiedy uruchomiony jako "Ex" lub opcja "-e" zosta�a podana przed opcj� "-s".
-s {skrypt}
Zostanie wczytany plik {skrypt}. Znaki w pliku zostan� zinterpretowane jakby by�y wpisywane. To samo mo�na osi�gn�� poprzez polecenie ":source! {skrypt}". Je�li osi�gni�to koniec pliku zanim edytor zako�czy� dzia�anie, dalsze znaki odczytywane s� z klawiatury.
-T {terminal}
Przekazuje Vimowi nazw� terminalu jakiego u�ywasz. Wymagane tylko wtedy je�li nie dzia�a automatycznie. Powinien by� to terminal znany Vimowi (builtin) lub zdefiniowany w plikach termcap lub terminfo.
-u {vimrc}
U�yj polece� z pliku {vimrc} w czasie uruchamiania. Wszystkie inne mo�liwe pliki uruchamiania zostan� pomini�te. U�ywaj do edytowania plik�w specjalnych. Mo�na pomin�� tak�e wszystkie mo�liwe pliki uruchamiania poprzez podanie nazwy "NONE". Zobacz ":help initialization" by pozna� wi�cej szczeg��w.
-U {gvimrc}
U�yj polece� z pliku {gvimrc} w czasie uruchamiania GUI. Wszystkie inne mo�liwe pliki uruchamiania GUI zostan� pomini�te. Mo�na pomin�� tak�e wszystkie mo�liwe pliki uruchamiania GUI poprzez podanie nazwy "NONE". Zobacz ":help gui-init" by pozna� wi�cej szczeg��w.
-V[N]
Tryb gadatliwy. Wypisz wiadomo�ci o tym jaki pliki s� wczytywane i o informacjach pobieranych i dodawanych do pliku viminfo. Opcjonalny argument N jest warto�ci� 'verbose'. Domy�lnie 10.
-v
Uruchom Vima w trybie Vi, tak jakby program by� nazwany "vi". Ma znaczenie tylko wtedy je�li program nazwany jest "ex".
-w {plik}
Wszystkie wci�ni�cia klawiszy, a� do zako�czenia dzia�ania programu, s� zapisywane w {plik} . U�yteczne je�li chce si� stworzy� skrypt do u�ycia z "vim -s" lub ":source!". Je�li {plik} istnieje, znaki s� dopisywane.
-W {plik}
Podobnie do -w, ale istniej�cy plik jest nadpisywany.
-x
U�yj szyfrowania podczas zapisywania plik�w. Zostaniesz poproszony o podanie klucza.
-X
Nie ��cz z serwerem X. Skraca czas uruchamiania w terminalu, ale tytu� okna i schowek nie b�d� wykorzystywane.
-y
Uruchom Vima w �atwym trybie, tak jakby program zosta� wywo�any "evim" lub "eview". Vim b�dzie zachowywa� si� bardziej jak edytor kliknij-i-wpisz.
-Z
Tryb ograniczony. Zachowuje si� jakby nazwa programu zaczyna�a si� od "r".
--
Oznacza koniec opcji. Argumenty po tej opcji b�d� traktowane jak nazwy plik�w. U�ywa si� do otwierania plik�w, kt�rych nazwy zaczynaj� si� od '-'.
--echo-wid
Wy��cznie GTK GUI: wypisz ID okna na standardowe wyj�cie.
--help
Wy�wietl informacj� o pomocy i zako�czy, to samo co"-h".
--literal
Potraktuj nazwy plik�w dos�ownie i nie rozwi�zuj kwantyfikator�w. Nie ma znaczenia na Uniksach gdzie pow�oka rozwi�zuje kwantyfikatory.
--noplugin
Pomi� �adowanie wtyczek. Implikowane przy -u NONE.
--remote
Po��cz si� z serwerem Vima i edytuj w nim reszt� plik�w podanych jako argumenty. Je�li nie znaleziono serwera zostanie zg�oszony b��d a pliki zostan� otwarte w bie��cym Vimie.
--remote-expr {wyra�enie}
Po��cz z serwerem Vima, rozwi�� w nim {wyra�enie} i wypisz rozwi�zanie na standardowe wyj�cie.
--remote-send {klawisze}
Po��cz z serwerem Vima i wy�lij do niego {klawisze}.
--remote-silent
Tak samo jak -remote, ale bez ostrze�enia kiedy nie znaleziono serwera.
--remote-wait
Tak samo jak -remote, ale Vim nie zako�czy dop�ki pliki pozostan� otwarte.
--remote-wait-silent
Tak samo jak --remote-wait, ale bez ostrze�enie kiedy nie znaleziono serwera.
--serverlist
Wypisz nazwy wszystkich serwer�w Vima jakie mo�na znale��.
--servername {nazwa}
U�yj {nazwa} jako nazwy serwera. Wykorzystane dla bie��cego Vima o ile nie po��czone z argumentem --remote, wtedy jest to nazwa serwera do po��czenia.
--socketid {id}
Wy��cznie GTK GUI: U�yj mechanizmu GtkPlug by uruchomi� gvima w innym oknie.
--version
Wypisz informacj� o wersji i zako�cz.
 

POMOC ON-LINE

By rozpocz�� wpisz ":help" w Vimie Wpisz ":help temat" by uzyska� pomoc na okre�lony temat. Przyk�ad: ":help ZZ" by uzyska� pomoc na temat polecenia "ZZ". U�yj <Tab> i CTRL-D aby uzupe�ni� tematy (":help cmdline-completion"). W plikach pomocy istniej� znaczniki by u�atwi� skakanie z jednego miejsca do innego (rodzaj link�w hipertekstowych, zobacz ":help"). Mo�na w ten spos�b zobaczy� ca�� dokumentacj�, np. ":help syntax.txt".  

PLIKI

/usr/share/vim/vim82/doc/*.txt
Dokumentacja Vima U�yj ":help doc-file-list" aby uzyska� pe�n� list�.
/usr/share/vim/vim82/doc/tags
Plik znacznik�w s�u�y do znajdowania informacji w plikach dokumentacji.
/usr/share/vim/vim82/syntax/syntax.vim
Globalne uruchamianie pod�wietlania sk�adni.
/usr/share/vim/vim82/syntax/*.vim
Pliki sk�adni dla r�nych j�zyk�w.
/etc/vimrc
Globalny plik uruchamiania Vima
~/.vimrc
Osobiste parametry uruchamiania Vima
/etc/gvimrc
Globalne uruchamianie gvima.
~/.gvimrc
Osobiste parametry uruchamiania gvima.
/usr/share/vim/vim82/optwin.vim
Skrypt u�ywany w poleceniu ":options", dobry spos�b do przegl�dania i ustawiania opcji.
/usr/share/vim/vim82/menu.vim
Globalne uruchamianie menu gvima.
/usr/share/vim/vim82/bugreport.vim
Skrypt s�u��cy do tworzenia raport�w o b��dach. Zobacz ":help bugs".
/usr/share/vim/vim82/filetype.vim
Skrypt do wykrywania typu pliku wed�ug jego nazwy. Zobacz ":help 'filetype'".
/usr/share/vim/vim82/scripts.vim
Skrypt do wykrywania typu pliku wed�ug jego zawarto�ci. Zobacz ":help 'filetype'".
/usr/share/vim/vim82/print/*.ps
Pliku u�ywane do drukowania PostScriptu.

Naj�wie�sze wiadomo�ci na stronie Vima:
<URL:http://www.vim.org/>  

ZOBACZ TAK�E

vimtutor(1)  

AUTOR

Vim zosta� napisany przez Brama Moolenaara z du�� pomoc� innych os�b. Zobacz ":help credits" w Vimie.
Vim bazuje na Steviem, nad kt�rym pracowali: Tim Thompson, Tony Andrews i G.R. (Fred) Walter. Ma�o ju� zosta�o z oryginalnego kodu.  

B��DY

Prawdopodobne. Zobacz ":help todo" by pozna� list� znanych problem�w.

Pami�taj �e pewna ilo�� problem�w, kt�re mog� by� uznawane przez niekt�rych ludzi za b��dy s� w rzeczywisto�ci spowodowane wierno�ci� w odtwarzaniu zachowania Vi. Je�li s�dzisz, �e inne rzeczy s� b��dami "poniewa� Vi robi to inaczej", powiniene� przyjrze� si� bli�ej plikowi vi_diff.txt (lub wpisa� ":help vi_diff.txt" w Vimie). Sprawd� tak�e opis opcji 'compatible' i 'cpoptions'.

 

Index

NAME
SYNOPSIS
OPIS
OPCJE
POMOC ON-LINE
PLIKI
ZOBACZ TAK�E
AUTOR
B��DY