Install vim73
[msysgit/mtrensch.git] / share / vim / vim73 / doc / vim-pl.1
blobd506b33c98691f06bee58805edaecf2ab268b989
1 .TH VIM 1 "2006 kwi 11"
2 .SH NAME
3 vim \- Vi rozbudowany, edytor tekstu dla programisty
4 .SH SYNOPSIS
5 .br
6 .B vim
7 [opcje] [plik ..]
8 .br
9 .B vim
10 [opcje] \-
11 .br
12 .B vim
13 [opcje] \-t znacznik
14 .br
15 .B vim
16 [opcje] \-q [plik_b³êdu]
17 .PP
18 .br
19 .B ex
20 .br
21 .B view
22 .br
23 .B gvim
24 .B gview
25 .B evim
26 .B eview
27 .br
28 .B rvim
29 .B rview
30 .B rgvim
31 .B rgview
32 .SH OPIS
33 .B Vim
34 jest edytorem tekstu kompatybilnym z Vi. Mo¿e byæ
35 u¿ywany do edycji wszelkiego rodzaju plików tekstowych.
36 U¿yteczny zw³aszcza przy edycji programów.
37 .PP
38 Posiada wiele usprawnieñ w porównaniu z Vi: wielopoziomowe cofanie zmian,
39 wiele okien i buforów, pod¶wietlanie sk³adni, edycja linii poleceñ,
40 uzupe³nianie nazw plików, pomoc on-line, wizualna selekcja, itd.
41 Zobacz ":help vi_diff.txt" dla podsumowania ró¿nic pomiêdzy
42 .B Vimem
43 i Vi.
44 .PP
45 W czasie korzystania z
46 .B Vima
47 mo¿na uzyskaæ obszern± pomoc z systemu pomocy on-line dziêki poleceniu ":help".
48 Zobacz rozdzia³ POMOC ON-LINE poni¿ej.
49 .PP
50 Najczê¶ciej
51 .B Vim
52 jest uruchamiany do edycji pojedynczego pliku poleceniem
53 .PP
54         vim plik
55 .PP
56 Bardziej ogólnie
57 .B Vim
58 jest uruchamiany poprzez:
59 .PP
60         vim [opcje] [lista plików]
61 .PP
62 Je¶li brak listy plików edytor rozpocznie z pustym buforem. W innym
63 wypadku istnieje dok³adnie jedna z czterech mo¿liwo¶ci by wybraæ jeden
64 lub wiêcej plików do edycji.
65 .TP 12
66 plik ..
67 Lista nazw plików.
68 Pierwsza nazwa bêdzie nazw± bie¿±cego pliku, który zostanie wczytany
69 do bufora. Kursor zostanie umieszczony w pierwszym wierszu. Do
70 kolejnych plików mo¿na przej¶æ dziêki poleceniu ":next". By otworzyæ
71 plik, którego nazwa zaczyna siê od my¶lnika nale¿y listê plików
72 poprzedziæ "\-\-".
73 .TP
75 Plik do edycji jest wczytany ze standardowego wej¶cia. Polecenia s±
76 odczytywane ze standardowego wyj¶cia b³êdów, którym powinien byæ
77 terminal (tty).
78 .TP
79 \-t {znacznik}
80 Plik do edycji i pocz±tkowa pozycja kursora zale¿y od "znacznika",
81 rodzaju etykiety goto.
82 {znacznika} szuka siê w pliku tags, zwi±zany z nim plik staje siê
83 plikiem bie¿±cym i wykonuje siê powi±zane polecenie.
84 Zazwyczaj u¿ywa siê tego sposobu dla programów w C, w których wypadku
85 {znacznik} mo¿e byæ nazw± funkcji.
86 W efekcie plik zawieraj±cy okre¶lon± funkcjê staje siê plikiem
87 bie¿±cym a kursor jest umieszczony na pocz±tku funkcji.
88 Zobacz ":help tag-commands".
89 .TP
90 \-q [plik_b³êdów]
91 Zacznij w trybie quickFix.
92 Plik [plik_b³êdów] zostaje zinterpretowany i poka¿e siê pierwszy b³±d.
93 Je¶li brak opcji [plik_b³êdów] nazwa pliku zostanie pobrana z opcji
94 \&'errorfile' (domy¶lnie "AztecC.Err" dla Amigi, "errros.err" dla innych
95 systemów.
96 Do kolejnych b³êdów mo¿na przeskoczyæ dziêki poleceniu ":cn".
97 Zobacz ":help quickfix".
98 .PP
99 W zale¿no¶ci od wywo³ania
100 .B Vim
101 zachowuje siê inaczej (program mo¿e byæ ca³y czas tym samym
102 plikiem).
103 .TP 10
105 "Normalny" sposób, wszystko jest domy¶lne.
108 Zacznij w trybie Ex.
109 Przejd¼ do trybu Normalnego poleceniem ":vi".
110 Mo¿na tak¿e uruchomiæ poprzez argument "\-e".
112 view
113 Zacznij w trybie tylko do odczytu. W ten sposób bêdziesz chroniony
114 przed zapisywaniem pliku. Mo¿na tak¿e uruchomiæ poprzez argument
115 "\-R".
117 gvim gview
118 Wersja GUI.
119 Uruchamia nowe okno.
120 Mo¿na tak¿e uruchomiæ poprzez argument "\-g".
122 evim eview
123 Wersja GUI w ³atwym trybie.
124 Uruchamia nowe okno.
125 Mo¿na tak¿e uruchomiæ poprzez argument "\-y".
127 rvim rview rgvim rgview
128 Podobnie jak powy¿ej, ale z ograniczeniami. Nie bêdzie mo¿na uruchomiæ
129 poleceñ pow³oki lub zawiesiæ
130 .B Vima.
131 Mo¿na tak¿e uruchomiæ poprzez argument "\-Z".
132 .SH OPCJE
133 Opcje mo¿na podaæ w dowolnej kolejno¶ci, przed lub po nazwach plików.
134 Opcje bez argumentów mo¿na ³±czyæ po pojedynczym my¶lniku.
135 .TP 12
136 +[num]
137 W pierwszym pliku kursor zostanie umieszczony w wierszu "num".
138 Je¶li brak "num" kursor zostanie umieszczony w ostatnim wierszu.
140 +/{wzór}
141 W pierwszym pliku kursor zostanie umieszczony na pierwszym wyst±pieniu
142 {wzór}.
143 Zobacz ":help search-pattern" by dowiedzieæ siê jakie s± mo¿liwe
144 wzorce wyszukiwania.
146 +{polecenie}
148 \-c {polecenie}
149 {polecenie} zostanie wykonane po tym jak wczyta siê pierwszy plik.
150 {polecenie} jest interpretowane jako polecenie Ex.
151 Je¶li {poleceni} zawiera bia³e znaki musi byæ umieszczone w podwójnych
152 cudzys³owach (zale¿y to od u¿ywanej pow³oki).
153 Przyk³ad: Vim "+set si" main.c
155 Uwaga: Mo¿na u¿yæ do 10 poleceñ "+" lub "\-c".
157 \-S {plik}
158 {plik} zostanie zinterpretowany po wczytaniu pierwszego pliku.
159 Jest równowa¿ne \-c "source {plik}".
160 {plik} nie mo¿e zaczynaæ siê '\-'.
161 Je¶li nie podano {plik} zostanie u¿yty "Session.vim" (dzia³a tylko
162 wtedy je¶li \-S jest ostatnim argumentem).
164 \-\-cmd {polecenie}
165 Podobne do "\-c", ale polecenie jest wykonywane tu¿ przed
166 interpretacj± jakiegokolwiek pliku vimrc.
167 Mo¿na u¿yæ do 10 takich poleceñ, niezale¿nie od poleceñ od "\-c"
170 Je¶li
171 .B Vim
172 zosta³ skompilowany ze wsparciem dla jêzyków arabskich (edycja od
173 prawej do lewej i arabska mapa klawiatury) ta opcja uruchamia
174 .B Vima
175 w trybie arabskim, np. ustawia siê opcja 'arabic'. W innym wypadku
176 pojawi siê komunikat b³êdu i
177 .B Vim
178 zakoñczy dzia³anie.
181 Tryb binarny.
182 Ustawi siê kilka opcji, które umo¿liwi± edycjê plików binarnych lub
183 wykonywalnych.
186 Kompatybilny. Ustawia opcjê 'compatible'.
187 W ten sposób 
188 .B Vim
189 bêdzie zachowywa³ siê jak Vi, nawet je¶li istnieje plik .vimrc.
192 Uruchom w trybie diff.
193 Powinno siê u¿yæ dwóch, trzech lub czterech nazwy plików jako argumentów.
194 .B Vim
195 otworzy wszystkie te pliki i poka¿e ró¿nice miêdzy nimi.
196 Dzia³a jak vimdiff(1).
198 \-d {urz±dzenie}
199 Otwórz {urz±dzenie} by u¿ywaæ jako terminal.
200 Tylko na Amidze.
201 Przyk³ad:
202 "\-d con:20/30/600/150".
205 Debugowanie. Przejd¼ do trybu debugowanie wykonuj±c pierwsze polecenie
206 ze skryptu.
209 Uruchom
210 .B Vima
211 w trybie Ex, dzia³a tak samo jakby wywo³ano program jako "ex".
214 Uruchom
215 .B Vima
216 w ulepszonym trybie Ex, dzia³a tak samo jakby wywo³ano program jako
217 "exim".
220 Pierszy plan. Dla wersji GUI.
221 .B Vim
222 nie nie oddzieli siê od pow³oki w jakiej zosta³ uruchomiony. Na Amidze
223 .B Vim
224 nie jest uruchomiony ponownie by otworzyæ nowe okno.
225 Opcja powinna byæ u¿yta kiedy
226 .B Vim
227 jest wywo³ywany przez program, który ma zaczekaæ na koniec sesji (np.
228 mail).
229 Na Amidze polecenia ":sh" i ":!" nie bêd± dzia³aæ.
231 \-\-nofork
232 Pierwszy plan. Dla wersji GUI.
233 .B Vim
234 nie oddzieli siê od pow³oki w jakiej zosta³ uruchomiony.
237 Je¶li Vim zosta³ skompilowany ze wsparciem FKMAP dla edycji tekstów od
238 prawej do lewej i mapowania klawiatury Farsi, ta opcja uruchomi
239 .B Vima
240 w trybie Farsi, np. zostawi± ustawione opcje 'fkmap' i 'rightleft'.
241 W innym wypadku pojawi siê komunikat b³êdu i
242 .B Vim
243 zakoñczy dzia³anie.
246 Je¶li
247 .B Vim
248 zosta³ skompilowany ze wsparciem dla GUI ta opcja uruchomi GUI.
249 W innym wypadku pojawi siê komunikat b³êdu i
250 .B Vim
251 zakoñczy dzia³anie.
254 Wy¶wietli krótk± pomoc o argumentach linii poleceñ i opcjach. Potem
255 .B Vim
256 zakoñczy dzia³anie.
259 Je¶li
260 .B Vim
261 zosta³ skompilowany ze wsparciem RIGHTLEFT dla edycji od prawej do
262 lewej oraz ma mapowanie klawiatury dla hebrajskiego, ta opcja uruchomi
263 .B Vima
264 w trybie hebrajskim, np. ustawi opcje 'hkmap' i 'rightleft'.
265 W innym wypadku pojawi siê komunikat b³êdu i
266 .B Vim
267 zakoñczy dzia³anie.
269 \-i {viminfo}
270 Kiedy
271 .B Vim
272 u¿ywa pliku viminfo ta opcja wska¿e jakiego pliku u¿yæ zamiast
273 domy¶lnego "~/.viminfo".
274 Mo¿na te¿ omin±æ u¿ycie pliku .viminfo przez podanie nazwy "NONE".
277 To samo co \-r.
280 Tryb Lisp.
281 Ustawia opcje 'lisp' i 'showmatch'.
284 Zmiana pliku jest niemo¿liwa.
285 Przestawia opcjê 'write'.
286 Mo¿na zmieniaæ zawarto¶æ bufora, ale zapisanie pliku nie jest
287 mo¿liwe.
290 Opcje 'modifiable' i 'write' zostan± wy³±czone, tak wiêc zmiany
291 w pliku oraz ich zapisanie nie s± mo¿liwe. Warto¶æ tych opcji mo¿na
292 zmieniæ.
295 Tryb niekompatybilny. Przestawia opcjê 'compatible'. Dziêki temu
296 .B Vim
297 bêdzie zachowywa³ siê odrobinê lepiej, ale mniej zgodnie z Vi nawet
298 je¶li nie istnieje plik .vimrc.
301 Nie powstanie plik wymiany. Odzyskanie pliku po wypadku nie bêdzie
302 mo¿liwe.
303 Wygodne je¶li instnieje potrzeba edycji na bardzo wolnym medium (np.
304 dyskietce). Ten cel mo¿na osi±gn±æ tak¿e przez ":set uc=0". Mo¿na
305 odwróciæ przez ":set uc=200".
307 \-nb
308 Uruchom jako serwer edytora dla NetBeans. Zobacz dokumentacjê by
309 dowiedzieæ siê wiêcej.
311 \-o[N]
312 Otwórz N okien w stosie.
313 Kiedy brak N, otwórz jedno okno dla ka¿dego pliku.
315 \-O[N]
316 Otwórz N okien obok siebie.
317 Kiedy brak N, otwórz jedno okno dla ka¿dego pliku.
319 \-p[N]
320 Otwórz N kart.
321 Kiedy brak N, otwórz jedn± kartê dla ka¿dego pliku.
324 Tryb tylko do odczytu.
325 Zostanie ustawiona opcja 'readonly'.
326 Ca³y czas mo¿na zmieniaæ bufor, ale bêdzie istnia³a blokada by chroniæ
327 przed przypadkowym zapisaniem pliku.
328 Je¶li chcesz zapisaæ plik dodaj wykrzyknik do polecenia Ex, np. ":w!".
329 Opcja \-R implikuje opcjê \-n (zobacz poni¿ej).
330 Opcja 'readonly' mo¿e zostaæ przestawiona poprzez ":set noro".
331 Zobacz ":help 'readonly'".
334 Wypisz listê plików wymiany razem z informacjami o nich.
336 \-r {plik}
337 Tryb odzyskiwania danych.
338 Plik wymiany zostanie wykorzystany do odzyskania gwa³townie przerwanej sesji.
339 Plik wymiany to plik z tak± sam± nazw± co plik oryginalny z dodanym ".swp".
340 Zobacz ":help recovery".
343 Tryb cichy. Rozpoczêty tylko kiedy uruchomiony jako "Ex" lub opcja
344 "\-e" zosta³a podana przed opcj± "\-s".
346 \-s {skrypt}
347 Zostanie wczytany plik {skrypt}.
348 Znaki w pliku zostan± zinterpretowane jakby by³y wpisywane.
349 To samo mo¿na osi±gn±æ poprzez polecenie ":source! {skrypt}".
350 Je¶li osi±gniêto koniec pliku zanim edytor zakoñczy³ dzia³anie, dalsze
351 znaki odczytywane s± z klawiatury.
353 \-T {terminal}
354 Przekazuje
355 .B Vimowi
356 nazwê terminalu jakiego u¿ywasz.
357 Wymagane tylko wtedy je¶li nie dzia³a automatycznie.
358 Powinien byæ to terminal znany
359 .B Vimowi
360 (builtin) lub zdefiniowany w plikach termcap lub terminfo.
362 \-u {vimrc}
363 U¿yj poleceñ z pliku {vimrc} w czasie uruchamiania.
364 Wszystkie inne mo¿liwe pliki uruchamiania zostan± pominiête.
365 U¿ywaj do edytowania plików specjalnych.
366 Mo¿na pomin±æ tak¿e wszystkie mo¿liwe pliki uruchamiania poprzez
367 podanie nazwy "NONE".
368 Zobacz ":help initialization" by poznaæ wiêcej szczegó³ów.
370 \-U {gvimrc}
371 U¿yj poleceñ z pliku {gvimrc} w czasie uruchamiania GUI.
372 Wszystkie inne mo¿liwe pliki uruchamiania GUI zostan± pominiête.
373 Mo¿na pomin±æ tak¿e wszystkie mo¿liwe pliki uruchamiania GUI poprzez
374 podanie nazwy "NONE".
375 Zobacz ":help gui-init" by poznaæ wiêcej szczegó³ów.
377 \-V[N]
378 Tryb gadatliwy. Wypisz wiadomo¶ci o tym jaki pliki s± wczytywane
379 i o informacjach pobieranych i dodawanych do pliku viminfo. Opcjonalny
380 argument N jest warto¶ci± 'verbose'. Domy¶lnie 10.
383 Uruchom
384 .B Vima
385 w trybie Vi, tak jakby program by³ nazwany "vi". Ma znaczenie
386 tylko wtedy je¶li program nazwany jest "ex".
388 \-w {plik}
389 Wszystkie wci¶niêcia klawiszy, a¿ do zakoñczenia dzia³ania programu,
390 s± zapisywane w {plik} .
391 U¿yteczne je¶li chce siê stworzyæ skrypt do u¿ycia z "vim \-s" lub
392 ":source!".
393 Je¶li {plik} istnieje, znaki s± dopisywane.
395 \-W {plik}
396 Podobnie do \-w, ale istniej±cy plik jest nadpisywany.
399 U¿yj szyfrowania podczas zapisywania plików. Zostaniesz poproszony
400 o podanie klucza.
403 Nie ³±cz z serwerem X. Skraca czas uruchamiania w terminalu, ale tytu³
404 okna i schowek nie bêd± wykorzystywane.
407 Uruchom
408 .B Vima
409 w ³atwym trybie, tak jakby program zosta³ wywo³any "evim" lub "eview".
410 .B Vim
411 bêdzie zachowywa³ siê bardziej jak edytor kliknij-i-wpisz.
414 Tryb ograniczony. Zachowuje siê jakby nazwa programu zaczyna³a siê od
415 "r".
417 \-\-
418 Oznacza koniec opcji.
419 Argumenty po tej opcji bêd± traktowane jak nazwy plików. U¿ywa siê do
420 otwierania plików, których nazwy zaczynaj± siê od '\-'.
422 \-\-echo\-wid
423 Wy³±cznie GTK GUI: wypisz ID okna na standardowe wyj¶cie.
425 \-\-help
426 Wy¶wietl informacjê o pomocy i zakoñczy, to samo co"\-h".
428 \-\-literal
429 Potraktuj nazwy plików dos³ownie i nie rozwi±zuj kwantyfikatorów. Nie
430 ma znaczenia na Uniksach gdzie pow³oka rozwi±zuje kwantyfikatory.
432 \-\-noplugin
433 Pomiñ ³adowanie wtyczek. Implikowane przy \-u NONE.
435 \-\-remote
436 Po³±cz siê z serwerem Vima i edytuj w nim resztê plików podanych jako
437 argumenty. Je¶li nie znaleziono serwera zostanie zg³oszony b³±d a pliki zostan±
438 otwarte w bie¿±cym Vimie.
440 \-\-remote\-expr {wyra¿enie}
441 Po³±cz z serwerem Vima, rozwi±¿ w nim {wyra¿enie} i wypisz rozwi±zanie
442 na standardowe wyj¶cie.
444 \-\-remote\-send {klawisze}
445 Po³±cz z serwerem Vima i wy¶lij do niego {klawisze}.
447 \-\-remote\-silent
448 Tak samo jak \-remote, ale bez ostrze¿enia kiedy nie znaleziono
449 serwera.
451 \-\-remote\-wait
452 Tak samo jak \-remote, ale Vim nie zakoñczy dopóki pliki pozostan±
453 otwarte.
455 \-\-remote\-wait\-silent
456 Tak samo jak \-\-remote\-wait, ale bez ostrze¿enie kiedy nie
457 znaleziono serwera.
459 \-\-serverlist
460 Wypisz nazwy wszystkich serwerów Vima jakie mo¿na znale¼æ.
462 \-\-servername {nazwa}
463 U¿yj {nazwa} jako nazwy serwera. Wykorzystane dla bie¿±cego Vima o ile
464 nie po³±czone z argumentem \-\-remote, wtedy jest to nazwa serwera do
465 po³±czenia.
467 \-\-socketid {id}
468 Wy³±cznie GTK GUI: U¿yj mechanizmu GtkPlug by uruchomiæ gvima w innym
469 oknie.
471 \-\-version
472 Wypisz informacjê o wersji i zakoñcz.
473 .SH POMOC ON-LINE
474 By rozpocz±æ wpisz ":help" w
475 .B Vimie
476 Wpisz ":help temat" by uzyskaæ pomoc na okre¶lony temat.
477 Przyk³ad: ":help ZZ" by uzyskaæ pomoc na temat polecenia "ZZ".
478 U¿yj <Tab> i CTRL\-D aby uzupe³niæ tematy (":help
479 cmdline\-completion"). W plikach pomocy istniej± znaczniki by u³atwiæ
480 skakanie z jednego miejsca do innego (rodzaj linków hipertekstowych,
481 zobacz ":help").
482 Mo¿na w ten sposób zobaczyæ ca³± dokumentacjê, np. ":help syntax.txt".
483 .SH PLIKI
484 .TP 15
485 /usr/local/lib/vim/doc/*.txt
486 Dokumentacja
487 .B Vima
488 U¿yj ":help doc\-file\-list" aby uzyskaæ pe³n± listê.
490 /usr/local/lib/vim/doc/tags
491 Plik znaczników s³u¿y do znajdowania informacji w plikach dokumentacji.
493 /usr/local/lib/vim/syntax/syntax.vim
494 Globalne uruchamianie pod¶wietlania sk³adni.
496 /usr/local/lib/vim/syntax/*.vim
497 Pliki sk³adni dla ró¿nych jêzyków.
499 /usr/local/lib/vim/vimrc
500 Globalny plik uruchamiania
501 .B Vima
503 ~/.vimrc
504 Osobiste parametry uruchamiania
505 .B Vima
507 /usr/local/lib/vim/gvimrc
508 Globalne uruchamianie gvima.
510 ~/.gvimrc
511 Osobiste parametry uruchamiania gvima.
513 /usr/local/lib/vim/optwin.vim
514 Skrypt u¿ywany w poleceniu ":options", dobry sposób do przegl±dania
515 i ustawiania opcji.
517 /usr/local/lib/vim/menu.vim
518 Globalne uruchamianie menu gvima.
520 /usr/local/lib/vim/bugreport.vim
521 Skrypt s³u¿±cy do tworzenia raportów o b³êdach. Zobacz ":help bugs".
523 /usr/local/lib/vim/filetype.vim
524 Skrypt do wykrywania typu pliku wed³ug jego nazwy. Zobacz ":help 'filetype'".
526 /usr/local/lib/vim/scripts.vim
527 Skrypt do wykrywania typu pliku wed³ug jego zawarto¶ci. Zobacz ":help 'filetype'".
529 /usr/local/lib/vim/print/*.ps
530 Pliku u¿ywane do drukowania PostScriptu.
532 Naj¶wie¿sze wiadomo¶ci na stronie
533 .B Vima:
535 <URL:http://www.vim.org/>
536 .SH ZOBACZ TAK¯E
537 vimtutor(1)
538 .SH AUTOR
539 .B Vim
540 zosta³ napisany przez Brama Moolenaara z du¿± pomoc± innych osób.
541 Zobacz ":help credits" w
542 .B Vimie.
544 .B Vim
545 bazuje na Steviem, nad którym pracowali: Tim Thompson, Tony Andrews
546 i G.R. (Fred) Walter.
547 Ma³o ju¿ zosta³o z oryginalnego kodu.
548 .SH B£ÊDY
549 Prawdopodobne.
550 Zobacz ":help todo" by poznaæ listê znanych problemów.
552 Pamiêtaj ¿e pewna ilo¶æ problemów, które mog± byæ uznawane przez
553 niektórych ludzi za b³êdy s± w rzeczywisto¶ci spowodowane wierno¶ci±
554 w odtwarzaniu zachowania Vi.
555 Je¶li s±dzisz, ¿e inne rzeczy s± b³êdami "poniewa¿ Vi robi to
556 inaczej", powiniene¶ przyjrzeæ siê bli¿ej plikowi vi_diff.txt (lub
557 wpisaæ ":help vi_diff.txt" w Vimie).
558 Sprawd¼ tak¿e opis opcji 'compatible' i 'cpoptions'.