diff options
author | Bram Moolenaar <Bram@vim.org> | 2006-03-26 21:06:50 +0000 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2006-03-26 21:06:50 +0000 |
commit | 899dddf88804af20d560b5277f1ca1bc4dd8e2b3 (patch) | |
tree | 17525001ae02c1e762f4dd6b383612bd16f7238d /runtime/doc | |
parent | 5c6a2d53232f248c0ba0e4278a447042aa00371e (diff) |
updated for version 7.0b02v7.0b02
Diffstat (limited to 'runtime/doc')
-rw-r--r-- | runtime/doc/eval.txt | 3 | ||||
-rw-r--r-- | runtime/doc/evim-pl.1 | 53 | ||||
-rw-r--r-- | runtime/doc/evim-pl.UTF-8.1 | 53 | ||||
-rw-r--r-- | runtime/doc/if_ruby.txt | 44 | ||||
-rw-r--r-- | runtime/doc/options.txt | 18 | ||||
-rw-r--r-- | runtime/doc/spell.txt | 45 | ||||
-rw-r--r-- | runtime/doc/tags | 2 | ||||
-rw-r--r-- | runtime/doc/todo.txt | 21 | ||||
-rw-r--r-- | runtime/doc/version7.txt | 19 | ||||
-rw-r--r-- | runtime/doc/vim-pl.1 | 555 | ||||
-rw-r--r-- | runtime/doc/vim-pl.UTF-8.1 | 555 | ||||
-rw-r--r-- | runtime/doc/vimdiff-pl.1 | 46 | ||||
-rw-r--r-- | runtime/doc/vimdiff-pl.UTF-8.1 | 46 | ||||
-rw-r--r-- | runtime/doc/vimtutor-pl.1 | 48 | ||||
-rw-r--r-- | runtime/doc/vimtutor-pl.UTF-8.1 | 48 | ||||
-rw-r--r-- | runtime/doc/xxd-pl.1 | 389 | ||||
-rw-r--r-- | runtime/doc/xxd-pl.UTF-8.1 | 389 |
17 files changed, 2287 insertions, 47 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index bcdb9480dc..6395b5c3b3 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1,4 +1,4 @@ -*eval.txt* For Vim version 7.0b. Last change: 2006 Mar 25 +*eval.txt* For Vim version 7.0b. Last change: 2006 Mar 26 VIM REFERENCE MANUAL by Bram Moolenaar @@ -2471,6 +2471,7 @@ finddir({name}[, {path}[, {count}]]) *finddir()* If {path} is omitted or empty then 'path' is used. If the optional {count} is given, find {count}'s occurrence of {name} in {path} instead of the first one. + When {count} is negative return all the matches in a |List|. This is quite similar to the ex-command |:find|. {only available when compiled with the +file_in_path feature} diff --git a/runtime/doc/evim-pl.1 b/runtime/doc/evim-pl.1 new file mode 100644 index 0000000000..284b5bcb9b --- /dev/null +++ b/runtime/doc/evim-pl.1 @@ -0,0 +1,53 @@ +.TH EVIM 1 "2002 Lut 16" +.SH NAZWA +evim \- łatwy Vim, edytuj plik w Vimie z ustawieniami dla edycji bez +trybów +.SH SYNOPSIS +.br +.B evim +[opcje] [plik ...] +.br +.B eview +.SH OPIS +.B eVim +uruchamia +.B Vima +i ustawia opcje tak by zachowywał się jak edytor bez trybów. +To jest cały czas Vim ale używany jako edytor wskaż-i-kliknij. +Zachowanie w stlu Notepada dla MS-Windows. +.B eVim +będzie zawsze uruchomiony w GUI by włączyć menu i pasek narzędzi. +.PP +Przeznaczony tylko dla ludzi, którzy naprawdę nie potrafią pracować +z Vimem w normalny sposób. Edycja będzie o wiele mniej efektywna. +.PP +.B eview +działa tak samo, ale zaczyna w trybie tylko do odczytu. Działa tak +samo jak evim \-R. +.PP +Zobacz vim(1) by poznać więcej szczegółów o Vimie, opcjach, itd. +.PP +Opcja 'insertmode' jest ustawiona by można było od razu wpisywać +tekst. +.br +Mapowania są ustawione tak by Kopiowanie i Wklejanie działało +z klawiszami MS-Windows. CTRL-X wycina tekst, CTRL-C kopiuje +a CTRL-V wkleja. Użyj CTRL-Q by uzyskać oryginalne znaczenie +CTRL-V. +.SH OPCJE +Zobacz vim(1). +.SH PLIKI +.TP 15 +/usr/local/lib/vim/evim.vim +Skrypt uruchamiania dla eVima. +.SH ZNANY JAKO +Znany jako "Vim dla frajerów". +Jeśli używasz evima oczekuje się, że wyjmiesz chusteczkę do nosa, +zrobisz węzęł w każdym rogu i będziesz to nosił na głowie. +.SH ZOBACZ TAKŻE +vim(1) +.SH AUTOR +Większość +.B Vima +została napisana przez Brama Moolenaara z dużą pomocą innych osób. +Zobacz menu Help/Credits. diff --git a/runtime/doc/evim-pl.UTF-8.1 b/runtime/doc/evim-pl.UTF-8.1 new file mode 100644 index 0000000000..da940c0a73 --- /dev/null +++ b/runtime/doc/evim-pl.UTF-8.1 @@ -0,0 +1,53 @@ +.TH EVIM 1 "2002 Lut 16" +.SH NAZWA +evim \- Ĺatwy Vim, edytuj plik w Vimie z ustawieniami dla edycji bez +trybĂłw +.SH SYNOPSIS +.br +.B evim +[opcje] [plik ...] +.br +.B eview +.SH OPIS +.B eVim +uruchamia +.B Vima +i ustawia opcje tak by zachowywaĹ siÄ jak edytor bez trybĂłw. +To jest caĹy czas Vim ale uĹźywany jako edytor wskaĹź-i-kliknij. +Zachowanie w stlu Notepada dla MS-Windows. +.B eVim +bÄdzie zawsze uruchomiony w GUI by wĹÄ
czyÄ menu i pasek narzÄdzi. +.PP +Przeznaczony tylko dla ludzi, ktĂłrzy naprawdÄ nie potrafiÄ
pracowaÄ +z Vimem w normalny sposĂłb. Edycja bÄdzie o wiele mniej efektywna. +.PP +.B eview +dziaĹa tak samo, ale zaczyna w trybie tylko do odczytu. DziaĹa tak +samo jak evim \-R. +.PP +Zobacz vim(1) by poznaÄ wiÄcej szczegĂłĹĂłw o Vimie, opcjach, itd. +.PP +Opcja 'insertmode' jest ustawiona by moĹźna byĹo od razu wpisywaÄ +tekst. +.br +Mapowania sÄ
ustawione tak by Kopiowanie i Wklejanie dziaĹaĹo +z klawiszami MS-Windows. CTRL-X wycina tekst, CTRL-C kopiuje +a CTRL-V wkleja. UĹźyj CTRL-Q by uzyskaÄ oryginalne znaczenie +CTRL-V. +.SH OPCJE +Zobacz vim(1). +.SH PLIKI +.TP 15 +/usr/local/lib/vim/evim.vim +Skrypt uruchamiania dla eVima. +.SH ZNANY JAKO +Znany jako "Vim dla frajerĂłw". +JeĹli uĹźywasz evima oczekuje siÄ, Ĺźe wyjmiesz chusteczkÄ do nosa, +zrobisz wÄzÄĹ w kaĹźdym rogu i bÄdziesz to nosiĹ na gĹowie. +.SH ZOBACZ TAKĹťE +vim(1) +.SH AUTOR +WiÄkszoĹÄ +.B Vima +zostaĹa napisana przez Brama Moolenaara z duĹźÄ
pomocÄ
innych osĂłb. +Zobacz menu Help/Credits. diff --git a/runtime/doc/if_ruby.txt b/runtime/doc/if_ruby.txt index ceb3282aa3..eace7e925f 100644 --- a/runtime/doc/if_ruby.txt +++ b/runtime/doc/if_ruby.txt @@ -1,4 +1,4 @@ -*if_ruby.txt* For Vim version 7.0b. Last change: 2006 Mar 06 +*if_ruby.txt* For Vim version 7.0b. Last change: 2006 Mar 26 VIM REFERENCE MANUAL by Shugo Maeda @@ -78,23 +78,26 @@ Executing Ruby commands is not possible in the |sandbox|. Ruby code gets all of its access to vim via the "VIM" module. Overview > - print "Hello" # displays a message - VIM.command(cmd) # execute an ex command - num = VIM::Window.count # gets the number of windows - w = VIM::Window[n] # gets window "n" - cw = VIM::Window.current # gets the current window - num = VIM::Buffer.count # gets the number of buffers - b = VIM::Buffer[n] # gets buffer "n" - cb = VIM::Buffer.current # gets the current buffer - w.height = lines # sets the window height - w.cursor = [row, col] # sets the window cursor position - pos = w.cursor # gets an array [row, col] - name = b.name # gets the buffer file name - line = b[n] # gets a line from the buffer - num = b.count # gets the number of lines - b[n] = str # sets a line in the buffer - b.delete(n) # deletes a line - b.append(n, str) # appends a line after n + print "Hello" # displays a message + VIM.command(cmd) # execute an ex command + num = VIM::Window.count # gets the number of windows + w = VIM::Window[n] # gets window "n" + cw = VIM::Window.current # gets the current window + num = VIM::Buffer.count # gets the number of buffers + b = VIM::Buffer[n] # gets buffer "n" + cb = VIM::Buffer.current # gets the current buffer + w.height = lines # sets the window height + w.cursor = [row, col] # sets the window cursor position + pos = w.cursor # gets an array [row, col] + name = b.name # gets the buffer file name + line = b[n] # gets a line from the buffer + num = b.count # gets the number of lines + b[n] = str # sets a line in the buffer + b.delete(n) # deletes a line + b.append(n, str) # appends a line after n + line = VIM::Buffer.current.line # gets the current line + num = VIM::Buffer.current.line_number # gets the current line number + VIM::Buffer.current.line = "test" # sets the current line number < Module Functions: @@ -144,6 +147,11 @@ self[{n}] = {str} delete({n}) Deletes a line from the buffer. {n} is the line number. append({n}, {str}) Appends a line after the line {n}. +line Returns the current line of the buffer if the buffer is + active. +line = {str} Sets the current line of the buffer if the buffer is active. +line_number Returns the number of the current line if the buffer is + active. ============================================================================== 4. VIM::Window objects *ruby-window* diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 1bb6ff1d53..ec9ddb6f87 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 7.0b. Last change: 2006 Mar 25 +*options.txt* For Vim version 7.0b. Last change: 2006 Mar 26 VIM REFERENCE MANUAL by Bram Moolenaar @@ -78,7 +78,7 @@ achieve special effects. These options come in three forms: If the option is a list of flags, superfluous flags are removed. When adding a flag that was already present the option value doesn't change. -< Also see |:set-args| above. + Also see |:set-args| above. {not in Vi} :se[t] {option}^={value} *:set^=* @@ -269,7 +269,13 @@ You will not get back the 'list' value as it was the last time you edited shown (but that might change in the future). {not in Vi} -:setl[ocal] {option}< Set the local value of {option} to its global value. +:setl[ocal] {option}< Set the local value of {option} to its global value by + copying the value. + {not in Vi} + +:se[t] {option}< Set the local value of {option} to its global value by + making it empty. Only makes sense for |global-local| + options. {not in Vi} *:setg* *:setglobal* @@ -316,7 +322,11 @@ This only works for a string option. For a boolean option you need to use the :setlocal autoread< Note that for non-boolean options using "<" copies the global value to the local value, it doesn't switch back to using the global value (that matters -when changing the global value later). +when the global value changes later). You can also use: > + :set path< +This will make the local value of 'path' empty, so that the global value is +used. Thus it does the same as: > + :setlocal path= Note: In the future more global options can be made global-local. Using ":setlocal" on a global option might work differently then. diff --git a/runtime/doc/spell.txt b/runtime/doc/spell.txt index f782dbce2e..5c7b5bbb56 100644 --- a/runtime/doc/spell.txt +++ b/runtime/doc/spell.txt @@ -1,4 +1,4 @@ -*spell.txt* For Vim version 7.0b. Last change: 2006 Mar 10 +*spell.txt* For Vim version 7.0b. Last change: 2006 Mar 26 VIM REFERENCE MANUAL by Bram Moolenaar @@ -975,7 +975,7 @@ The first line is a header and has four fields: For PFX the fields are exactly the same. The basic format for the following lines is: - SFX {flag} {strip} {add} {condition} + SFX {flag} {strip} {add} {condition} {extra} {flag} Must be the same as the {flag} used in the first line. @@ -987,6 +987,8 @@ The basic format for the following lines is: When {strip} is 0 (zero) then nothing is stripped. {add} Characters added to the basic word, after removing {strip}. + Optionally there is a '/' followed by flags. The flags apply + to the word plus affix. See |spell-affix-flags| {condition} A simplistic pattern. Only when this matches with a basic word will the suffix be used for that word. This is normally @@ -1002,6 +1004,13 @@ The basic format for the following lines is: complement of the specified characters. [^abc] matches any character but a, b and c. +{extra} Optional extra text: + rare word + affix is rare + nocomp no compounding for word + affix + # comment Comment is ignored + - Hunspell uses this, ignored + "rare" and "nocomp" are deprecated. + For PFX the fields are the same, but the {strip}, {add} and {condition} apply to the start of the word. @@ -1228,7 +1237,7 @@ A specific example: Allow a compound to be made of two words and a dash: In the .aff file: COMPOUNDRULE sde ~ NEEDAFFIX x ~ - COMPOUNDMAX 3 ~ + COMPOUNDWORDMAX 3 ~ COMPOUNDMIN 1 ~ In the .dic file: start/s ~ @@ -1252,10 +1261,10 @@ When omitted there is no minimal length. Obviously you could just leave out the compound flag from short words instead, this feature is present for compatibility with Myspell. - *spell-COMPOUNDMAX* + *spell-COMPOUNDWORDMAX* The maximum number of words that can be concatenated into a compound word is -specified with COMPOUNDMAX. Example: - COMPOUNDMAX 3 ~ +specified with COMPOUNDWORDMAX. Example: + COMPOUNDWORDMAX 3 ~ When omitted there is no maximum. It applies to all compound words. @@ -1270,14 +1279,13 @@ with COMPOUNDSYLMAX. Example: This has no effect if there is no SYLLABLE item. Without COMPOUNDSYLMAX there is no limit on the number of syllables. -If both COMPOUNDMAX and COMPOUNDSYLMAX are defined, a compound word is +If both COMPOUNDWORDMAX and COMPOUNDSYLMAX are defined, a compound word is accepted if it fits one of the criteria, thus is either made from up to -COMPOUNDMAX words or contains up to COMPOUNDSYLMAX syllables. +COMPOUNDWORDMAX words or contains up to COMPOUNDSYLMAX syllables. *spell-COMPOUNDFORBIDFLAG* The COMPOUNDFORBIDFLAG specifies a flag that can be used on an affix. It means that the word plus affix cannot be used in a compound word. -NOT IMPLEMENTED YET. *spell-COMPOUNDPERMITFLAG* The COMPOUNDPERMITFLAG specifies a flag that can be used on an affix. It @@ -1285,6 +1293,13 @@ means that the word plus affix can also be used in a compound word in a way where the affix ends up halfway the word. NOT IMPLEMENTED YET. + *spell-COMPOUNDROOT* +The COMPOUNDROOT flag is used for words in the dictionary that are already a +compound. This means it counts for two words when checking the compounding +rules. Can also be used for an affix to count the affix as a compounding +word. +NOT IMPLEMENTED YET. + *spell-SYLLABLE* The SYLLABLE item defines characters or character sequences that are used to count the number of syllables in a word. Example: @@ -1487,6 +1502,9 @@ COMPOUND (Hunspell) *spell-COMPOUND* Remove the first line with the count and rename the other items to COMPOUNDRULE |spell-COMPOUNDRULE| +COMPOUNDFIRST (Hunspell) *spell-COMPOUNDFIRST* + Use COMPOUNDRULE instead. |spell-COMPOUNDRULE| + COMPOUNDBEGIN (Hunspell) *spell-COMPOUNDBEGIN* Use COMPOUNDRULE instead. |spell-COMPOUNDRULE| @@ -1496,17 +1514,10 @@ COMPOUNDEND (Hunspell) *spell-COMPOUNDEND* COMPOUNDMIDDLE (Hunspell) *spell-COMPOUNDMIDDLE* Use COMPOUNDRULE instead. |spell-COMPOUNDRULE| -COMPOUNDROOT (Hunspell) *spell-COMPOUNDROOT* - Flag for words in the dictionary that are already a compound. - Vim doesn't use it. - COMPOUNDSYLLABLE (Hunspell) *spell-COMPOUNDSYLLABLE* Use SYLLABLE and COMPOUNDSYLMAX instead. |spell-SYLLABLE| |spell-COMPOUNDSYLMAX| -COMPOUNDWORDMAX (Hunspell) *spell-COMPOUNDWORDMAX* - Use COMPOUNDMAX instead. |spell-COMPOUNDMAX| - FORBIDDENWORD (Hunspell) *spell-FORBIDDENWORD* Use BAD instead. |spell-BAD| @@ -1517,7 +1528,7 @@ LANG (Hunspell) *spell-LANG* must be specified separately. LEMMA_PRESENT (Hunspell) *spell-LEMMA_PRESENT* - Only needed for mprphological analysis. + Only needed for morphological analysis. MAXNGRAMSUGS (Hunspell) *spell-MAXNGRAMSUGS* Not supported. diff --git a/runtime/doc/tags b/runtime/doc/tags index 6629dab82e..03dd1cd308 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -6813,9 +6813,9 @@ spell-COMPLEXPREFIXES spell.txt /*spell-COMPLEXPREFIXES* spell-COMPOUND spell.txt /*spell-COMPOUND* spell-COMPOUNDBEGIN spell.txt /*spell-COMPOUNDBEGIN* spell-COMPOUNDEND spell.txt /*spell-COMPOUNDEND* +spell-COMPOUNDFIRST spell.txt /*spell-COMPOUNDFIRST* spell-COMPOUNDFLAG spell.txt /*spell-COMPOUNDFLAG* spell-COMPOUNDFORBIDFLAG spell.txt /*spell-COMPOUNDFORBIDFLAG* -spell-COMPOUNDMAX spell.txt /*spell-COMPOUNDMAX* spell-COMPOUNDMIDDLE spell.txt /*spell-COMPOUNDMIDDLE* spell-COMPOUNDMIN spell.txt /*spell-COMPOUNDMIN* spell-COMPOUNDPERMITFLAG spell.txt /*spell-COMPOUNDPERMITFLAG* diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt index 773de9d050..2bd5091fb0 100644 --- a/runtime/doc/todo.txt +++ b/runtime/doc/todo.txt @@ -1,4 +1,4 @@ -*todo.txt* For Vim version 7.0b. Last change: 2006 Mar 25 +*todo.txt* For Vim version 7.0b. Last change: 2006 Mar 26 VIM REFERENCE MANUAL by Bram Moolenaar @@ -30,6 +30,18 @@ be worked on, but only if you sponsor Vim development. See |sponsor|. *known-bugs* -------------------- Known bugs and current work ----------------------- +In completion using Enter to accept the current match causes trouble. +Leave it out? Typing a space already works + +New Hungarian dictionary. (Laci Nemeth) + test COMPOUNDFORBIDFLAG + implement use of COMPOUNDPERMITFLAG + implement use of CHECKCOMPOUND* flags, <compoptions> + implement using CHECKCOMPOUNDPATTERN: match words with sl_comppat[]. + +Mac: When started from finder path isn't set and curdir is /. +Benji Fisher suggests using system() (2006 Mar 26) + Add more tests for all new functionality in Vim 7. Especially new functions. Win32: Describe how to do debugging. (George Reilly) @@ -1121,9 +1133,8 @@ Spell checking: support both). - Support breakpoint character ? 0xb7 and ignore it? Makes it possible to use same wordlist for hyphenation. -- Compound word is accepted if nr of words is <= COMPOUNDMAX OR nr of +- Compound word is accepted if nr of words is <= COMPOUNDWORDMAX OR nr of syllables <= COMPOUNDSYLMAX. Specify using AND in the affix file? -- COMPOUNDMAX -> COMPOUNDWORDMAX? - NEEDCOMPOUND also used for affix? Or is this called ONLYINCOMPOUND now? Or is ONLYINCOMPOUND only for inside a compound, not at start or end? - Do we need a flag for the rule that when compounding is done the following @@ -1133,7 +1144,7 @@ Spell checking: - Lots of code depends on LANG, that isn't right. Enable each mechanism in the affix file separately. - Example with compounding dash is bad, gets in the way of setting - COMPOUNDMIN and COMPOUNDMAX to a reasonable value. + COMPOUNDMIN and COMPOUNDWORDMAX to a reasonable value. - PSEUDOROOT == NEEDAFFIX - COMPOUNDROOT -> COMPOUNDED? For a word that already is a compound word Or use COMPOUNDED2, COMPOUNDED3, etc. @@ -1148,7 +1159,7 @@ Spell checking: We might not need this at all, you can use the NEEDAFFIX flag and the affix which is required. - When a suffix has more than one syllable, it may count as a word for - COMPOUNDMAX. + COMPOUNDWORDMAX. - Add flags to count extra syllables in a word. SYLLABLEADD1 SYLLABLEADD2, etc.? Or make it possible to specify the syllable count of a word directly, e.g., after another slash: /abc/3 diff --git a/runtime/doc/version7.txt b/runtime/doc/version7.txt index 44bf2c1845..43e4890c0d 100644 --- a/runtime/doc/version7.txt +++ b/runtime/doc/version7.txt @@ -1,4 +1,4 @@ -*version7.txt* For Vim version 7.0b. Last change: 2006 Mar 25 +*version7.txt* For Vim version 7.0b. Last change: 2006 Mar 26 VIM REFERENCE MANUAL by Bram Moolenaar @@ -356,6 +356,7 @@ several other languages. French - translated by David Blanchet Italian - translated by Antonio Colombo Russian - translated by Vassily Ragosin +Polish - translated by Mikolaj Machowski The Unix Makefile installs the Italian manual pages in .../man/it/man1/, .../man/it.ISO8859-1/man1/ and .../man/it.UTF-8/man1/. There appears to be no @@ -899,6 +900,7 @@ limits syntax and ftplugin file. (Nikolai Weibull) Lisp indent file. (Sergey Khorev) loginaccess and logindefs syntax and ftplugin file. (Nikolai Weibull) m4 ftplugin file. (Nikolai Weibull) +mailaliases syntax file. (Nikolai Weibull) mailcap ftplugin file. (Nikolai Weibull) manconf syntax and ftplugin file. (Nikolai Weibull) matlab ftplugin file. (Jake Wasserman) @@ -2187,4 +2189,19 @@ install directory. To make the 16 bit DOS version compile exclude not used highlight initializations and build a tiny instead of small version. +finddir() and findfile() accept a negative cound and return a List then. + +The Python indent file contained a few debugging statements, removed. + +Expanding {} for a function name, resulting in a name starting with "s:" was +not handled correctly. + +Spelling: renamed COMPOUNDMAX to COMPOUNDWORDMAX. Added several items to be +able to handle the new Hungarian dictionary. + +Mac: Default to building for the current platform only, that is much faster +than building a universal binary. Also, using Perl/Python/etc. only works for +the current platform. + + vim:tw=78:ts=8:ft=help:norl: diff --git a/runtime/doc/vim-pl.1 b/runtime/doc/vim-pl.1 new file mode 100644 index 0000000000..25dd78698c --- /dev/null +++ b/runtime/doc/vim-pl.1 @@ -0,0 +1,555 @@ +.TH VIM 1 "2002 Lut 22" +.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 błędu] +.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. Może być +używany do edycji wszelkiego rodzaju plików tekstowych. +Użyteczny zwłaszcza przy edycji programów. +.PP +Posiada wiele usprawnień w porównaniu z Vi: wielo poziomowe 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óżnić pomiędzy +.B Vimem +i Vi. +.PP +W czasie korzystania z +.B Vima +można uzyskać obszerną pomoc z systemu pomocy on-line dzięki poleceniu ":help". +Zobacz rozdział POMOC ON-LINE poniżej. +.PP +Najczęściej +.B Vim +jest uruchamiany do edycji pojedynczego pliku poleceniem +.PP + vim plik +.PP +Bardziej ogólnie +.B Vim +jest uruchamiany poprzez: +.PP + vim [opcje] [lista plików] +.PP +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. +.TP 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ć "\-\-". +.TP +\- +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). +.TP +\-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} powinien 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". +.TP +\-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". +.PP +W zależności od wywołania +.B Vim +zachowuje się inaczej (program może być cały czas tym samym +plikiem). +.TP 10 +vim +"Normalny" sposób, wszystko jest domyślne. +.TP +ex +Zacznij w trybie Ex. +Przejdź do trybu Normalnego poleceniem ":vi". +Można także uruchomić poprzez argument "\-e". +.TP +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". +.TP +gvim gview +Wersja GUI. +Uruchamia nowe okno. +Można także uruchomić poprzez argument "\-g". +.TP +evim eview +Wersja GUI w łatwym trybie. +Uruchamia nowe okno. +Można także uruchomić poprzez argument "\-y". +.TP +rvim rview rgvim rgview +Podobnie jak powyżej, ale z ograniczeniami. Nie będzie można uruchomić +poleceń powłoki lub zawiesić +.B Vima. +Można także uruchomić poprzez argument "\-Z". +.SH 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. +.TP 12 ++[num] +W pierwszym pliku kursor zostanie umieszczony w wierszu "num". +Jeśli brak "num" kursor zostanie umieszczony w ostatnim wierszu. +.TP ++/{wzór} +W pierwszym pliku kursor zostanie umieszczony na pierwszym wystąpieniu +{wzór}. +Zobacz ":help search-pattern" by dowiedzieć się jakie są możliwości +wzorów wyszukiwania. +.TP ++{polecenie} +.TP +\-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 +.br +Uwaga: Można użyć do 10 poleceń "+" lub "\-c". +.TP +\-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). +.TP +\-\-cmd {polecenie} +Podobne do "\-c", ale polecenie jest wykonywane tuż przed +interpretacją jakiegokolwiek pliku vimrc. +Można użyć do 10 takich poleceń, niezależni od poleceń od "\-c" +.TP +\-A +Jeśli +.B Vim +został skompilowany ze wsparciem dla języków 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 błędu i +.B Vim +zakończy działanie. +.TP +\-b +Tryb binarny. +Ustawi się kilka opcji, które umożliwią edycję plików binarnych lub +wykonywalnych. +.TP +\-C +Kompatybilny. Ustawia opcję 'compatible'. +W ten sposób +.B Vim +będzie zachowywał się jak Vi, nawet jeśli istnieje plik .vimrc. +.TP +\-d +Uruchom w trybie diff. +Powinno być dwa lub trzy nazwy plików jako argumenty. +.B Vim +otworzy wszystkie te pliki i pokaże różnice między nimi. +Działa jak vimdiff(1). +.TP +\-d {urządzenie} +Otwórz {urządzenie} by używać jako terminal. +Tylko na Amidze. +Przykład: +"\-d con:20/30/600/150". +.TP +\-D +Debugowanie. Przejdź do trybu debugowanie wykonując pierwsze polecenie +ze skryptu. +.TP +\-e +Uruchom +.B Vima +w trybie Ex, działa tak samo jakby wywołano program jako "ex". +.TP +\-E +Uruchom +.B Vima +w ulepszonym trybie Ex, działa tak samo jakby wywołano program jako +"exim". +.TP +\-f +Pierszy plan. Dla wersji GUI. +.B Vim +nie nie oddzieli się od powłoki w jakiej został uruchomiony. Na Amidze +.B Vim +nie jest uruchomiony ponownie by otworzyć nowe okno. +Opcja powinna być użyta kiedy +.B 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ć. +.TP +\-\-nofork +Pierwszy plan. Dla wersji GUI. +.B Vim +nie oddzieli się od powłoki w jakiej został uruchomiony. +.TP +\-F +Jeśli Vim został skompilowany ze wsparciem FKMAP dla edycji tekstów 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 błędu i +.B Vim +zakończy działanie. +.TP +\-g +Jeśli +.B Vim +został skompilowany ze wsparciem dla GUI ta opcja uruchomi GUI. +W innym wypadku pojawi się komunikat błędu i +.B Vim +zakończy działanie. +.TP +\-h +Wyświetli krótką pomoc o argumentach linii poleceń i opcjach. Potem +.B Vim +zakończy działanie. +.TP +\-H +Jeśli +.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 błędu i +.B Vim +zakończy działanie. +.TP +\-i {viminfo} +Kiedy +.B 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". +.TP +\-L +To samo co \-r. +.TP +\-l +Tryb Lisp. +Ustawia opcje 'lisp' i 'showmatch'. +.TP +\-m +Zmiana pliku jest niemożliwa. +Przestawia opcję 'write'. +Można cały czas zmienić zawartość bufora, ale zapisanie pliku nie jest +możliwa. +.TP +\-M +Opcje 'modifiable' i 'write' zostaną wyłączone, tak więc zmiany +w pliku oraz ich zapisanie nie są możliwe. Można wartość tych opcji +zmienić. +.TP +\-N +Tryb niekompatibylny. Przestawia opcję 'compatible'. Dzięki temu +.B Vim +będzie zachowywał się odrobinę lepiej, ale mniej zgodznie z Vi nawet +jeśli nie istnieje plik .vimrc. +.TP +\-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". +.TP +\-nb +Uruchom jako serwer edytora dla NetBeans. Zobacz dokumentację by +dowiedzieć się więcej. +.TP +\-o[N] +Otwórz N okien w stosie. +Kiedy brak N, otwórz jedno okno dla każdego pliku. +.TP +\-O[N] +Otwórz N okien obok siebie. +Kiedy brak N, otwórz jedno okno dla każdego pliku. +.TP +\-p[N] +Otwórz N kart. +Kiedy brak N, otwórz jedną kartę dla każdego pliku. +.TP +\-R +Tryb tylko do odczytu. +Zostanie ustawiona opcja 'readonly'. +Cały czas można zmieniać bufor, ale będzie istniała blokada 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'". +.TP +\-r +Wypisz listę plików wymiany razem z informacjami o nich. +.TP +\-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". +.TP +\-s +Tryb cichy. Rozpoczęty tylko kiedy uruchomiony jako "Ex" lub opcja +"\-e" została podana przed opcją "\-s". +.TP +\-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. +.TP +\-T {terminal} +Przekazuje +.B Vimowi +nazwę terminalu jakiego używasz. +Wymagane tylko wtedy jeśli nie działa automatycznie. +Powinien być to terminal znany +.B Vimowi +(builtin) lub zdefiniowany w plikach termcap lub terminfo. +.TP +\-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. +.TP +\-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. +.TP +\-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. +.TP +\-v +Uruchom +.B Vima +w trybie Vi, tak jakby program był nazwany "vi". Ma znaczenie +tylko wtedy jeśli program nazwany jest "ex". +.TP +\-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. +.TP +\-W {plik} |