vim (9.1)

(root)/
share/
man/
pl.ISO8859-2/
man1/
vim.1
VIM(1) General Commands Manual VIM(1)

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
view
gvim gview 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 ar‐
gument "-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 poje‐
dynczym 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 cud‐
zys�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 za‐
pisanie 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 edy‐
tor 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 automaty‐
cznie. Powinien by� to terminal znany Vimowi (builtin) lub zdefiniowany w plikach termcap lub ter‐
minfo.

-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 do‐
dawanych 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� wyko‐
rzystywane.

-y Uruchom Vima w �atwym trybie, tak jakby program zosta� wywo�any "evim" lub "eview". Vim b�dzie za‐
chowywa� 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 otwiera‐
nia 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 hipertek‐
stowych, zobacz ":help"). Mo�na w ten spos�b zobaczy� ca�� dokumentacj�, np. ":help syntax.txt".

PLIKI
/BuggyBox/vim/9.1/any/share/vim/vim91/doc/*.txt
Dokumentacja Vima U�yj ":help doc-file-list" aby uzyska� pe�n� list�.

/BuggyBox/vim/9.1/any/share/vim/vim91/doc/tags
Plik znacznik�w s�u�y do znajdowania informacji w plikach dokumentacji.

/BuggyBox/vim/9.1/any/share/vim/vim91/syntax/syntax.vim
Globalne uruchamianie pod�wietlania sk�adni.

/BuggyBox/vim/9.1/any/share/vim/vim91/syntax/*.vim
Pliki sk�adni dla r�nych j�zyk�w.

/BuggyBox/vim/9.1/any/share/vim/vimrc
Globalny plik uruchamiania Vima

~/.vimrc Osobiste parametry uruchamiania Vima

/BuggyBox/vim/9.1/any/share/vim/gvimrc
Globalne uruchamianie gvima.

~/.gvimrc Osobiste parametry uruchamiania gvima.

/BuggyBox/vim/9.1/any/share/vim/vim91/optwin.vim
Skrypt u�ywany w poleceniu ":options", dobry spos�b do przegl�dania i ustawiania opcji.

/BuggyBox/vim/9.1/any/share/vim/vim91/menu.vim
Globalne uruchamianie menu gvima.

/BuggyBox/vim/9.1/any/share/vim/vim91/bugreport.vim
Skrypt s�u��cy do tworzenia raport�w o b��dach. Zobacz ":help bugs".

/BuggyBox/vim/9.1/any/share/vim/vim91/filetype.vim
Skrypt do wykrywania typu pliku wed�ug jego nazwy. Zobacz ":help 'filetype'".

/BuggyBox/vim/9.1/any/share/vim/vim91/scripts.vim
Skrypt do wykrywania typu pliku wed�ug jego zawarto�ci. Zobacz ":help 'filetype'".

/BuggyBox/vim/9.1/any/share/vim/vim91/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'.

2006 kwi 11 VIM(1)