vim [opcje] [plik ..]
vim [opcje] -
vim [opcje] -t znacznik
vim [opcje] -q [plik_b��du]
ex
view
gvim gview evim eview
rvim rview rgvim rgview
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.
12 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).
10 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".
12 +[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.
15 /usr/local/lib/vim/doc/*.txt Dokumentacja Vima U�yj ":help doc-file-list" aby uzyska� pe�n� list�.
/usr/local/lib/vim/doc/tags Plik znacznik�w s�u�y do znajdowania informacji w plikach dokumentacji.
/usr/local/lib/vim/syntax/syntax.vim Globalne uruchamianie pod�wietlania sk�adni.
/usr/local/lib/vim/syntax/*.vim Pliki sk�adni dla r�nych j�zyk�w.
/usr/local/lib/vim/vimrc Globalny plik uruchamiania Vima
~/.vimrc Osobiste parametry uruchamiania Vima
/usr/local/lib/vim/gvimrc Globalne uruchamianie gvima.
~/.gvimrc Osobiste parametry uruchamiania gvima.
/usr/local/lib/vim/optwin.vim Skrypt u�ywany w poleceniu ":options", dobry spos�b do przegl�dania i ustawiania opcji.
/usr/local/lib/vim/menu.vim Globalne uruchamianie menu gvima.
/usr/local/lib/vim/bugreport.vim Skrypt s�u��cy do tworzenia raport�w o b��dach. Zobacz ":help bugs".
/usr/local/lib/vim/filetype.vim Skrypt do wykrywania typu pliku wed�ug jego nazwy. Zobacz ":help 'filetype'".
/usr/local/lib/vim/scripts.vim Skrypt do wykrywania typu pliku wed�ug jego zawarto�ci. Zobacz ":help 'filetype'".
/usr/local/lib/vim/print/*.ps Pliku u�ywane do drukowania PostScriptu.
Naj�wie�sze wiadomo�ci na stronie Vima:
<URL:http://www.vim.org/>
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.
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'.