.TH VIM 1 "2006 kwi 11"
.SH NAME
vim \- Vi rozbudowany, edytor tekstu dla programisty
.SH SYNOPSIS
.br
.B vim
[opcje] [plik ..]
.br
.B vim
[opcje] \-
.br
.B vim
[opcje] \-t znacznik
.br
.B vim
[opcje] \-q [plik_bdu]
.PP
.br
.B ex
.br
.B view
.br
.B gvim
.B gview
.B evim
.B eview
.br
.B rvim
.B rview
.B rgvim
.B rgview
.SH OPIS
.B Vim
jest edytorem tekstu kompatybilnym z Vi. Moe by
uywany do edycji wszelkiego rodzaju plikw tekstowych.
Uyteczny zwaszcza przy edycji programw.
.PP
Posiada wiele usprawnie w porwnaniu z Vi: wielopoziomowe cofanie zmian,
wiele okien i buforw, podwietlanie skadni, edycja linii polece,
uzupenianie nazw plikw, pomoc on-line, wizualna selekcja, itd.
Zobacz ":help vi_diff.txt" dla podsumowania rnic pomidzy
.B Vimem
i Vi.
.PP
W czasie korzystania z
.B Vima
mona uzyska obszern pomoc z systemu pomocy on-line dziki poleceniu ":help".
Zobacz rozdzia POMOC ON-LINE poniej.
.PP
Najczciej
.B Vim
jest uruchamiany do edycji pojedynczego pliku poleceniem
.PP
	vim plik
.PP
Bardziej oglnie
.B Vim
jest uruchamiany poprzez:
.PP
	vim [opcje] [lista plikw]
.PP
Jeli brak listy plikw edytor rozpocznie z pustym buforem. W innym
wypadku istnieje dokadnie jedna z czterech moliwoci by wybra jeden
lub wicej plikw do edycji.
.TP 12
plik ..
Lista nazw plikw.
Pierwsza nazwa bdzie nazw biecego pliku, ktry zostanie wczytany
do bufora. Kursor zostanie umieszczony w pierwszym wierszu. Do
kolejnych plikw mona przej dziki poleceniu ":next". By otworzy
plik, ktrego nazwa zaczyna si od mylnika naley list plikw
poprzedzi "\-\-".
.TP
\-
Plik do edycji jest wczytany ze standardowego wejcia. Polecenia s
odczytywane ze standardowego wyjcia bdw, ktrym powinien by
terminal (tty).
.TP
\-t {znacznik}
Plik do edycji i pocztkowa pozycja kursora zaley od "znacznika",
rodzaju etykiety goto.
{znacznika} szuka si w pliku tags, zwizany z nim plik staje si
plikiem biecym i wykonuje si powizane polecenie.
Zazwyczaj uywa si tego sposobu dla programw w C, w ktrych wypadku
{znacznik} moe by nazw funkcji.
W efekcie plik zawierajcy okrelon funkcj staje si plikiem
biecym a kursor jest umieszczony na pocztku funkcji.
Zobacz ":help tag-commands".
.TP
\-q [plik_bdw]
Zacznij w trybie quickFix.
Plik [plik_bdw] zostaje zinterpretowany i pokae si pierwszy bd.
Jeli brak opcji [plik_bdw] nazwa pliku zostanie pobrana z opcji
\&'errorfile' (domylnie "AztecC.Err" dla Amigi, "errros.err" dla innych
systemw.
Do kolejnych bdw mona przeskoczy dziki poleceniu ":cn".
Zobacz ":help quickfix".
.PP
W zalenoci od wywoania
.B Vim
zachowuje si inaczej (program moe by cay czas tym samym
plikiem).
.TP 10
vim
"Normalny" sposb, wszystko jest domylne.
.TP
ex
Zacznij w trybie Ex.
Przejd do trybu Normalnego poleceniem ":vi".
Mona take uruchomi poprzez argument "\-e".
.TP
view
Zacznij w trybie tylko do odczytu. W ten sposb bdziesz chroniony
przed zapisywaniem pliku. Mona take uruchomi poprzez argument
"\-R".
.TP
gvim gview
Wersja GUI.
Uruchamia nowe okno.
Mona take uruchomi poprzez argument "\-g".
.TP
evim eview
Wersja GUI w atwym trybie.
Uruchamia nowe okno.
Mona take uruchomi poprzez argument "\-y".
.TP
rvim rview rgvim rgview
Podobnie jak powyej, ale z ograniczeniami. Nie bdzie mona uruchomi
polece powoki lub zawiesi
.B Vima.
Mona take uruchomi poprzez argument "\-Z".
.SH OPCJE
Opcje mona poda w dowolnej kolejnoci, przed lub po nazwach plikw.
Opcje bez argumentw mona czy po pojedynczym mylniku.
.TP 12
+[num]
W pierwszym pliku kursor zostanie umieszczony w wierszu "num".
Jeli brak "num" kursor zostanie umieszczony w ostatnim wierszu.
.TP
+/{wzr}
W pierwszym pliku kursor zostanie umieszczony na pierwszym wystpieniu
{wzr}.
Zobacz ":help search-pattern" by dowiedzie si jakie s moliwe
wzorce wyszukiwania.
.TP
+{polecenie}
.TP
\-c {polecenie}
{polecenie} zostanie wykonane po tym jak wczyta si pierwszy plik.
{polecenie} jest interpretowane jako polecenie Ex.
Jeli {poleceni} zawiera biae znaki musi by umieszczone w podwjnych
cudzysowach (zaley to od uywanej powoki).
Przykad: Vim "+set si" main.c
.br
Uwaga: Mona uy do 10 polece "+" lub "\-c".
.TP
\-S {plik}
{plik} zostanie zinterpretowany po wczytaniu pierwszego pliku.
Jest rwnowane \-c "source {plik}".
{plik} nie moe zaczyna si '\-'.
Jeli nie podano {plik} zostanie uyty "Session.vim" (dziaa tylko
wtedy jeli \-S jest ostatnim argumentem).
.TP
\-\-cmd {polecenie}
Podobne do "\-c", ale polecenie jest wykonywane tu przed
interpretacj jakiegokolwiek pliku vimrc.
Mona uy do 10 takich polece, niezalenie od polece od "\-c"
.TP
\-A
Jeli
.B Vim
zosta skompilowany ze wsparciem dla jzykw arabskich (edycja od
prawej do lewej i arabska mapa klawiatury) ta opcja uruchamia
.B Vima
w trybie arabskim, np. ustawia si opcja 'arabic'. W innym wypadku
pojawi si komunikat bdu i
.B Vim
zakoczy dziaanie.
.TP
\-b
Tryb binarny.
Ustawi si kilka opcji, ktre umoliwi edycj plikw binarnych lub
wykonywalnych.
.TP
\-C
Kompatybilny. Ustawia opcj 'compatible'.
W ten sposb 
.B Vim
bdzie zachowywa si jak Vi, nawet jeli istnieje plik .vimrc.
.TP
\-d
Uruchom w trybie diff.
Powinno si uy dwch, trzech lub czterech nazwy plikw jako argumentw.
.B Vim
otworzy wszystkie te pliki i pokae rnice midzy nimi.
Dziaa jak vimdiff(1).
.TP
\-d {urzdzenie}
Otwrz {urzdzenie} by uywa jako terminal.
Tylko na Amidze.
Przykad:
"\-d con:20/30/600/150".
.TP
\-D
Debugowanie. Przejd do trybu debugowanie wykonujc pierwsze polecenie
ze skryptu.
.TP
\-e
Uruchom
.B Vima
w trybie Ex, dziaa tak samo jakby wywoano program jako "ex".
.TP
\-E
Uruchom
.B Vima
w ulepszonym trybie Ex, dziaa tak samo jakby wywoano program jako
"exim".
.TP
\-f
Pierszy plan. Dla wersji GUI.
.B Vim
nie nie oddzieli si od powoki w jakiej zosta uruchomiony. Na Amidze
.B Vim
nie jest uruchomiony ponownie by otworzy nowe okno.
Opcja powinna by uyta kiedy
.B Vim
jest wywoywany przez program, ktry ma zaczeka na koniec sesji (np.
mail).
Na Amidze polecenia ":sh" i ":!" nie bd dziaa.
.TP
\-\-nofork
Pierwszy plan. Dla wersji GUI.
.B Vim
nie oddzieli si od powoki w jakiej zosta uruchomiony.
.TP
\-F
Jeli Vim zosta skompilowany ze wsparciem FKMAP dla edycji tekstw od
prawej do lewej i mapowania klawiatury Farsi, ta opcja uruchomi
.B Vima
w trybie Farsi, np. zostawi ustawione opcje 'fkmap' i 'rightleft'.
W innym wypadku pojawi si komunikat bdu i
.B Vim
zakoczy dziaanie.
.TP
\-g
Jeli
.B Vim
zosta skompilowany ze wsparciem dla GUI ta opcja uruchomi GUI.
W innym wypadku pojawi si komunikat bdu i
.B Vim
zakoczy dziaanie.
.TP
\-h
Wywietli krtk pomoc o argumentach linii polece i opcjach. Potem
.B Vim
zakoczy dziaanie.
.TP
\-H
Jeli
.B Vim
zosta skompilowany ze wsparciem RIGHTLEFT dla edycji od prawej do
lewej oraz ma mapowanie klawiatury dla hebrajskiego, ta opcja uruchomi
.B Vima
w trybie hebrajskim, np. ustawi opcje 'hkmap' i 'rightleft'.
W innym wypadku pojawi si komunikat bdu i
.B Vim
zakoczy dziaanie.
.TP
\-i {viminfo}
Kiedy
.B Vim
uywa pliku viminfo ta opcja wskae jakiego pliku uy zamiast
domylnego "~/.viminfo".
Mona te omin uycie pliku .viminfo przez podanie nazwy "NONE".
.TP
\-L
To samo co \-r.
.TP
\-l
Tryb Lisp.
Ustawia opcje 'lisp' i 'showmatch'.
.TP
\-m
Zmiana pliku jest niemoliwa.
Przestawia opcj 'write'.
Mona zmienia zawarto bufora, ale zapisanie pliku nie jest
moliwe.
.TP
\-M
Opcje 'modifiable' i 'write' zostan wyczone, tak wic zmiany
w pliku oraz ich zapisanie nie s moliwe. Warto tych opcji mona
zmieni.
.TP
\-N
Tryb niekompatybilny. Przestawia opcj 'compatible'. Dziki temu
.B Vim
bdzie zachowywa si odrobin lepiej, ale mniej zgodnie z Vi nawet
jeli nie istnieje plik .vimrc.
.TP
\-n
Nie powstanie plik wymiany. Odzyskanie pliku po wypadku nie bdzie
moliwe.
Wygodne jeli instnieje potrzeba edycji na bardzo wolnym medium (np.
dyskietce). Ten cel mona osign take przez ":set uc=0". Mona
odwrci przez ":set uc=200".
.TP
\-nb
Uruchom jako serwer edytora dla NetBeans. Zobacz dokumentacj by
dowiedzie si wicej.
.TP
\-o[N]
Otwrz N okien w stosie.
Kiedy brak N, otwrz jedno okno dla kadego pliku.
.TP
\-O[N]
Otwrz N okien obok siebie.
Kiedy brak N, otwrz jedno okno dla kadego pliku.
.TP
\-p[N]
Otwrz N kart.
Kiedy brak N, otwrz jedn kart dla kadego pliku.
.TP
\-R
Tryb tylko do odczytu.
Zostanie ustawiona opcja 'readonly'.
Cay czas mona zmienia bufor, ale bdzie istniaa blokada by chroni
przed przypadkowym zapisaniem pliku.
Jeli chcesz zapisa plik dodaj wykrzyknik do polecenia Ex, np. ":w!".
Opcja \-R implikuje opcj \-n (zobacz poniej).
Opcja 'readonly' moe zosta przestawiona poprzez ":set noro".
Zobacz ":help 'readonly'".
.TP
\-r
Wypisz list plikw wymiany razem z informacjami o nich.
.TP
\-r {plik}
Tryb odzyskiwania danych.
Plik wymiany zostanie wykorzystany do odzyskania gwatownie przerwanej sesji.
Plik wymiany to plik z tak sam nazw co plik oryginalny z dodanym ".swp".
Zobacz ":help recovery".
.TP
\-s
Tryb cichy. Rozpoczty tylko kiedy uruchomiony jako "Ex" lub opcja
"\-e" zostaa podana przed opcj "\-s".
.TP
\-s {skrypt}
Zostanie wczytany plik {skrypt}.
Znaki w pliku zostan zinterpretowane jakby byy wpisywane.
To samo mona osign poprzez polecenie ":source! {skrypt}".
Jeli osignito koniec pliku zanim edytor zakoczy dziaanie, dalsze
znaki odczytywane s z klawiatury.
.TP
\-T {terminal}
Przekazuje
.B Vimowi
nazw terminalu jakiego uywasz.
Wymagane tylko wtedy jeli nie dziaa automatycznie.
Powinien by to terminal znany
.B Vimowi
(builtin) lub zdefiniowany w plikach termcap lub terminfo.
.TP
\-u {vimrc}
Uyj polece z pliku {vimrc} w czasie uruchamiania.
Wszystkie inne moliwe pliki uruchamiania zostan pominite.
Uywaj do edytowania plikw specjalnych.
Mona pomin take wszystkie moliwe pliki uruchamiania poprzez
podanie nazwy "NONE".
Zobacz ":help initialization" by pozna wicej szczegw.
.TP
\-U {gvimrc}
Uyj polece z pliku {gvimrc} w czasie uruchamiania GUI.
Wszystkie inne moliwe pliki uruchamiania GUI zostan pominite.
Mona pomin take wszystkie moliwe pliki uruchamiania GUI poprzez
podanie nazwy "NONE".
Zobacz ":help gui-init" by pozna wicej szczegw.
.TP
\-V[N]
Tryb gadatliwy. Wypisz wiadomoci o tym jaki pliki s wczytywane
i o informacjach pobieranych i dodawanych do pliku viminfo. Opcjonalny
argument N jest wartoci 'verbose'. Domylnie 10.
.TP
\-v
Uruchom
.B Vima
w trybie Vi, tak jakby program by nazwany "vi". Ma znaczenie
tylko wtedy jeli program nazwany jest "ex".
.TP
\-w {plik}
Wszystkie wcinicia klawiszy, a do zakoczenia dziaania programu,
s zapisywane w {plik} .
Uyteczne jeli chce si stworzy skrypt do uycia z "vim \-s" lub
":source!".
Jeli {plik} istnieje, znaki s dopisywane.
.TP
\-W {plik}
Podobnie do \-w, ale istniejcy plik jest nadpisywany.
.TP
\-x
Uyj szyfrowania podczas zapisywania plikw. Zostaniesz poproszony
o podanie klucza.
.TP
\-X
Nie cz z serwerem X. Skraca czas uruchamiania w terminalu, ale tytu
okna i schowek nie bd wykorzystywane.
.TP
\-y
Uruchom
.B Vima
w atwym trybie, tak jakby program zosta wywoany "evim" lub "eview".
.B Vim
bdzie zachowywa si bardziej jak edytor kliknij-i-wpisz.
.TP
\-Z
Tryb ograniczony. Zachowuje si jakby nazwa programu zaczynaa si od
"r".
.TP
\-\-
Oznacza koniec opcji.
Argumenty po tej opcji bd traktowane jak nazwy plikw. Uywa si do
otwierania plikw, ktrych nazwy zaczynaj si od '\-'.
.TP
\-\-echo\-wid
Wycznie GTK GUI: wypisz ID okna na standardowe wyjcie.
.TP
\-\-help
Wywietl informacj o pomocy i zakoczy, to samo co"\-h".
.TP
\-\-literal
Potraktuj nazwy plikw dosownie i nie rozwizuj kwantyfikatorw. Nie
ma znaczenia na Uniksach gdzie powoka rozwizuje kwantyfikatory.
.TP
\-\-noplugin
Pomi adowanie wtyczek. Implikowane przy \-u NONE.
.TP
\-\-remote
Pocz si z serwerem Vima i edytuj w nim reszt plikw podanych jako
argumenty. Jeli nie znaleziono serwera zostanie zgoszony bd a pliki zostan
otwarte w biecym Vimie.
.TP
\-\-remote\-expr {wyraenie}
Pocz z serwerem Vima, rozwi w nim {wyraenie} i wypisz rozwizanie
na standardowe wyjcie.
.TP
\-\-remote\-send {klawisze}
Pocz z serwerem Vima i wylij do niego {klawisze}.
.TP
\-\-remote\-silent
Tak samo jak \-remote, ale bez ostrzeenia kiedy nie znaleziono
serwera.
.TP
\-\-remote\-wait
Tak samo jak \-remote, ale Vim nie zakoczy dopki pliki pozostan
otwarte.
.TP
\-\-remote\-wait\-silent
Tak samo jak \-\-remote\-wait, ale bez ostrzeenie kiedy nie
znaleziono serwera.
.TP
\-\-serverlist
Wypisz nazwy wszystkich serwerw Vima jakie mona znale.
.TP
\-\-servername {nazwa}
Uyj {nazwa} jako nazwy serwera. Wykorzystane dla biecego Vima o ile
nie poczone z argumentem \-\-remote, wtedy jest to nazwa serwera do
poczenia.
.TP
\-\-socketid {id}
Wycznie GTK GUI: Uyj mechanizmu GtkPlug by uruchomi gvima w innym
oknie.
.TP
\-\-version
Wypisz informacj o wersji i zakocz.
.SH POMOC ON-LINE
By rozpocz wpisz ":help" w
.B Vimie
Wpisz ":help temat" by uzyska pomoc na okrelony temat.
Przykad: ":help ZZ" by uzyska pomoc na temat polecenia "ZZ".
Uyj <Tab> i CTRL\-D aby uzupeni tematy (":help
cmdline\-completion"). W plikach pomocy istniej znaczniki by uatwi
skakanie z jednego miejsca do innego (rodzaj linkw hipertekstowych,
zobacz ":help").
Mona w ten sposb zobaczy ca dokumentacj, np. ":help syntax.txt".
.SH PLIKI
.TP 15
/usr/local/lib/vim/doc/*.txt
Dokumentacja
.B Vima
Uyj ":help doc\-file\-list" aby uzyska pen list.
.TP
/usr/local/lib/vim/doc/tags
Plik znacznikw suy do znajdowania informacji w plikach dokumentacji.
.TP
/usr/local/lib/vim/syntax/syntax.vim
Globalne uruchamianie podwietlania skadni.
.TP
/usr/local/lib/vim/syntax/*.vim
Pliki skadni dla rnych jzykw.
.TP
/usr/local/lib/vim/vimrc
Globalny plik uruchamiania
.B Vima
.TP
~/.vimrc
Osobiste parametry uruchamiania
.B Vima
.TP
/usr/local/lib/vim/gvimrc
Globalne uruchamianie gvima.
.TP
~/.gvimrc
Osobiste parametry uruchamiania gvima.
.TP
/usr/local/lib/vim/optwin.vim
Skrypt uywany w poleceniu ":options", dobry sposb do przegldania
i ustawiania opcji.
.TP
/usr/local/lib/vim/menu.vim
Globalne uruchamianie menu gvima.
.TP
/usr/local/lib/vim/bugreport.vim
Skrypt sucy do tworzenia raportw o bdach. Zobacz ":help bugs".
.TP
/usr/local/lib/vim/filetype.vim
Skrypt do wykrywania typu pliku wedug jego nazwy. Zobacz ":help 'filetype'".
.TP
/usr/local/lib/vim/scripts.vim
Skrypt do wykrywania typu pliku wedug jego zawartoci. Zobacz ":help 'filetype'".
.TP
/usr/local/lib/vim/print/*.ps
Pliku uywane do drukowania PostScriptu.
.PP
Najwiesze wiadomoci na stronie
.B Vima:
.br
<URL:http://www.vim.org/>
.SH ZOBACZ TAKE
vimtutor(1)
.SH AUTOR
.B Vim
zosta napisany przez Brama Moolenaara z du pomoc innych osb.
Zobacz ":help credits" w
.B Vimie.
.br
.B Vim
bazuje na Steviem, nad ktrym pracowali: Tim Thompson, Tony Andrews
i G.R. (Fred) Walter.
Mao ju zostao z oryginalnego kodu.
.SH BDY
Prawdopodobne.
Zobacz ":help todo" by pozna list znanych problemw.
.PP
Pamitaj e pewna ilo problemw, ktre mog by uznawane przez
niektrych ludzi za bdy s w rzeczywistoci spowodowane wiernoci
w odtwarzaniu zachowania Vi.
Jeli sdzisz, e inne rzeczy s bdami "poniewa Vi robi to
inaczej", powiniene przyjrze si bliej plikowi vi_diff.txt (lub
wpisa ":help vi_diff.txt" w Vimie).
Sprawd take opis opcji 'compatible' i 'cpoptions'.