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) | |
download | vim-git-899dddf88804af20d560b5277f1ca1bc4dd8e2b3.tar.gz |
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 bcdb9480d..6395b5c3b 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 000000000..284b5bcb9 --- /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 000000000..da940c0a7 --- /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 ceb3282aa..eace7e925 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 1bb6ff1d5..ec9ddb6f8 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 f782dbce2..5c7b5bbb5 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 6629dab82..03dd1cd30 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 773de9d05..2bd5091fb 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 44bf2c184..43e4890c0 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 000000000..25dd78698 --- /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} +Podobnie do \-w, ale istniejący plik jest nadpisywany. +.TP +\-x +Użyj szyfrowania podczas zapisywania plików. Zostaniesz poproszony +o podanie klucza. +.TP +\-X +Nie łącz z serwerem X. Skraca czas uruchamiania w terminalu, ale tytuł +okna i schowek nie będą wykorzystywane. +.TP +\-y +Uruchom +.B Vima +w łatwym trybie, tak jakby program został wywołany "evim" lub "eview". +.B Vim +będzie zachowywał się bardziej jak edytor kliknij-i-wpisz. +.TP +\-Z +Tryb ograniczony. Zachowuje się jakby nazwa programu zaczynała się od +"r". +.TP +\-\- +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 '\-'. +.TP +\-\-echo\-wid +Wyłącznie GTK GUI: wypisz ID okna na standardowe wyjście. +.TP +\-\-help +Wyświetl informację o pomocy i zakończy, to samo co"\-h". +.TP +\-\-literal +Potraktuj nazwy plików dosłownie i nie rozwiązuj kwantyfikatorów. Nie +ma znaczenia na Uniksach gdzie powłoka rozwiązuje kwantyfikatorów +.TP +\-\-noplugin +Pomiń ładowanie wtyczek. Implikowane przy \-u NONE. +.TP +\-\-remote +Połącz się z serwerem Vima i edytuj w nim resztę argumentów. Jeśli nie +znaleziono serwera zostanie zgłoszony błąd a pliki będą otwarte +w bieżącym Vimie. +.TP +\-\-remote\-expr {wyrażenie} +Połącz z serwerem Vima, rozwiąż w nim {wyrażenie} i wypisz rozwiązanie +na standardowe wyjście. +.TP +\-\-remote\-send {klawisze} +Połącz z serwerem Vima i wyślij do niego {klawisze}. +.TP +\-\-remote\-silent +Tak samo jak \-remote, ale bez ostrzeżenia kiedy nie znaleziono +serwera. +.TP +\-\-remote\-wait +Tak samo jak \-remote, ale Vim nie zakończy dopóki pliki nie zostaną +otwarte. +.TP +\-\-remote\-wait\-silent +Tak samo jak \-\-remote\-wait, ale bez ostrzeżenie kiedy nie +znaleziono serwera. +.TP +\-\-serverlist +Wypisz nazwy wszystkich serwerów Vima jakie można znaleźć. +.TP +\-\-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. +.TP +\-\-socketid {id} +Wyłącznie GTK GUI: Użyj mechanizmu GtkPlug by uruchomić gvima w innym +oknie. +.TP +\-\-version +Wypisz informację o wersji i zakończ. +.SH POMOC ON-LINE +By rozpocząć wpisz ":help" w +.B 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 hipertekstowych, +zobacz ":help"). +Można w ten sposób zobaczyć całą dokumentację, np. ":help syntax.txt". +.SH PLIKI +.TP 15 +/usr/local/lib/vim/doc/*.txt +Dokumentacja +.B Vima +Użyj ":help doc\-file\-list" aby uzyskać pełną listę. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Globalne uruchamianie podświetlania składni. +.TP +/usr/local/lib/vim/syntax/*.vim +Pliki składni dla różnych języków. +.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 używany w poleceniu ":options", dobry sposób do przeglądania +i ustawiania opcji. +.TP +/usr/local/lib/vim/menu.vim +Globalne uruchamianie menu gvima. +.TP +/usr/local/lib/vim/bugreport.vim +Skrypt służący do tworzenia raportów o błędach. Zobacz ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Skrypt do wykrywania typu pliku według jego nazwy. Zobacz ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Skrypt do wykrywania typu pliku według jego zawartości. Zobacz ":help 'filetype'". +.TP +/usr/local/lib/vim/*.ps +Pliku używane do drukowania PostScriptu. +.PP +Najświeższe wiadomości na stronie +.B Vima: +.br +<URL:http://www.vim.org/> +.SH ZOBACZ TAKŻE +vimtutor(1) +.SH AUTOR +.B Vim +został napisany przez Brama Moolenaara z dużą pomocą innych osób. +Zobacz ":help credits" w +.B Vimie. +.br +.B 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. +.SH BŁĘDY +Prawdopodobne. +Zobacz ":help todo" by poznać listę znanych problemów. +.PP +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'. diff --git a/runtime/doc/vim-pl.UTF-8.1 b/runtime/doc/vim-pl.UTF-8.1 new file mode 100644 index 000000000..ab19a527c --- /dev/null +++ b/runtime/doc/vim-pl.UTF-8.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} +Podobnie do \-w, ale istniejÄ
cy plik jest nadpisywany. +.TP +\-x +UĹźyj szyfrowania podczas zapisywania plikĂłw. Zostaniesz poproszony +o podanie klucza. +.TP +\-X +Nie ĹÄ
cz z serwerem X. Skraca czas uruchamiania w terminalu, ale tytuĹ +okna i schowek nie bÄdÄ
wykorzystywane. +.TP +\-y +Uruchom +.B Vima +w Ĺatwym trybie, tak jakby program zostaĹ wywoĹany "evim" lub "eview". +.B Vim +bÄdzie zachowywaĹ siÄ bardziej jak edytor kliknij-i-wpisz. +.TP +\-Z +Tryb ograniczony. Zachowuje siÄ jakby nazwa programu zaczynaĹa siÄ od +"r". +.TP +\-\- +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 '\-'. +.TP +\-\-echo\-wid +WyĹÄ
cznie GTK GUI: wypisz ID okna na standardowe wyjĹcie. +.TP +\-\-help +WyĹwietl informacjÄ o pomocy i zakoĹczy, to samo co"\-h". +.TP +\-\-literal +Potraktuj nazwy plikĂłw dosĹownie i nie rozwiÄ
zuj kwantyfikatorĂłw. Nie +ma znaczenia na Uniksach gdzie powĹoka rozwiÄ
zuje kwantyfikatorĂłw +.TP +\-\-noplugin +PomiĹ Ĺadowanie wtyczek. Implikowane przy \-u NONE. +.TP +\-\-remote +PoĹÄ
cz siÄ z serwerem Vima i edytuj w nim resztÄ argumentĂłw. JeĹli nie +znaleziono serwera zostanie zgĹoszony bĹÄ
d a pliki bÄdÄ
otwarte +w bieĹźÄ
cym Vimie. +.TP +\-\-remote\-expr {wyraĹźenie} +PoĹÄ
cz z serwerem Vima, rozwiÄ
Ĺź w nim {wyraĹźenie} i wypisz rozwiÄ
zanie +na standardowe wyjĹcie. +.TP +\-\-remote\-send {klawisze} +PoĹÄ
cz z serwerem Vima i wyĹlij do niego {klawisze}. +.TP +\-\-remote\-silent +Tak samo jak \-remote, ale bez ostrzeĹźenia kiedy nie znaleziono +serwera. +.TP +\-\-remote\-wait +Tak samo jak \-remote, ale Vim nie zakoĹczy dopĂłki pliki nie zostanÄ
+otwarte. +.TP +\-\-remote\-wait\-silent +Tak samo jak \-\-remote\-wait, ale bez ostrzeĹźenie kiedy nie +znaleziono serwera. +.TP +\-\-serverlist +Wypisz nazwy wszystkich serwerĂłw Vima jakie moĹźna znaleĹşÄ. +.TP +\-\-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. +.TP +\-\-socketid {id} +WyĹÄ
cznie GTK GUI: UĹźyj mechanizmu GtkPlug by uruchomiÄ gvima w innym +oknie. +.TP +\-\-version +Wypisz informacjÄ o wersji i zakoĹcz. +.SH POMOC ON-LINE +By rozpoczÄ
Ä wpisz ":help" w +.B 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 hipertekstowych, +zobacz ":help"). +MoĹźna w ten sposĂłb zobaczyÄ caĹÄ
dokumentacjÄ, np. ":help syntax.txt". +.SH PLIKI +.TP 15 +/usr/local/lib/vim/doc/*.txt +Dokumentacja +.B Vima +UĹźyj ":help doc\-file\-list" aby uzyskaÄ peĹnÄ
listÄ. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Globalne uruchamianie podĹwietlania skĹadni. +.TP +/usr/local/lib/vim/syntax/*.vim +Pliki skĹadni dla róşnych jÄzykĂłw. +.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 uĹźywany w poleceniu ":options", dobry sposĂłb do przeglÄ
dania +i ustawiania opcji. +.TP +/usr/local/lib/vim/menu.vim +Globalne uruchamianie menu gvima. +.TP +/usr/local/lib/vim/bugreport.vim +Skrypt sĹuĹźÄ
cy do tworzenia raportĂłw o bĹÄdach. Zobacz ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Skrypt do wykrywania typu pliku wedĹug jego nazwy. Zobacz ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Skrypt do wykrywania typu pliku wedĹug jego zawartoĹci. Zobacz ":help 'filetype'". +.TP +/usr/local/lib/vim/*.ps +Pliku uĹźywane do drukowania PostScriptu. +.PP +NajĹwieĹźsze wiadomoĹci na stronie +.B Vima: +.br +<URL:http://www.vim.org/> +.SH ZOBACZ TAKĹťE +vimtutor(1) +.SH AUTOR +.B Vim +zostaĹ napisany przez Brama Moolenaara z duĹźÄ
pomocÄ
innych osĂłb. +Zobacz ":help credits" w +.B Vimie. +.br +.B 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. +.SH BĹÄDY +Prawdopodobne. +Zobacz ":help todo" by poznaÄ listÄ znanych problemĂłw. +.PP +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'. diff --git a/runtime/doc/vimdiff-pl.1 b/runtime/doc/vimdiff-pl.1 new file mode 100644 index 000000000..ac3de3f8e --- /dev/null +++ b/runtime/doc/vimdiff-pl.1 @@ -0,0 +1,46 @@ +.TH VIMDIFF 1 "2001 Mar 30" +.SH NAZWA +vimdiff \- edytuj dwie lub trzy wersje pliku w Vimie i zobacz różnice +.SH SYNOPSIS +.br +.B vimdiff +[opcje] plik1 plik2 [plik3] +.PP +.B gvimdiff +.SH OPIS +.B Vimdiff +uruchomi +.B Vima +z dwoma (lub trzema plikami), każdy z nich we własnym oknie. +Różnice między plikami zostaną podświetlone. +Jest to dobry sposób by przeanalizować różnice i przenieść zmiany z jednej +wersji pliku do innej. +.PP +Zobacz vim(1) by poznać więcej szczegółów o samym Vimie. +.PP +Kiedy uruchomiony jako +.B gvimdiff +zostanie uruchomione GUI (jeśli dostępne). +.PP +W każdym oknie zostanie ustawiona opcja 'diff', która spowoduje +podświetlenie różnic. +.br +Opcje 'wrap' i 'scrollbind' zostaną ustawione by tekst dobrze się +przeglądało. +.br +Opcja 'foldmethod' zostanie ustawiona na "diff", dzięki temu +niezmienione linie zostaną zwinięte. 'foldcolumn' będzie równe 2 aby +łatwo wyszukiwać, otwierać i zamykać zwinięcia. +.SH OPCJE +Pionowy podział jest użyty do wyrównania linii, tak jakby użyto +opcji "\-O". Aby uzyskać poziomy podział użyj opcji "\-o". +.PP +Aby poznać inne opcje zobacz vim(1). +.SH ZOBACZ TAKŻE +vim(1) +.SH AUTOR +Większość +.B Vima +została napisana przez Brama Moolenaara przy pomocy wielu innych osób. +Zobacz ":help credits w +.B Vimie. diff --git a/runtime/doc/vimdiff-pl.UTF-8.1 b/runtime/doc/vimdiff-pl.UTF-8.1 new file mode 100644 index 000000000..0d9186eb4 --- /dev/null +++ b/runtime/doc/vimdiff-pl.UTF-8.1 @@ -0,0 +1,46 @@ +.TH VIMDIFF 1 "2001 Mar 30" +.SH NAZWA +vimdiff \- edytuj dwie lub trzy wersje pliku w Vimie i zobacz róşnice +.SH SYNOPSIS +.br +.B vimdiff +[opcje] plik1 plik2 [plik3] +.PP +.B gvimdiff +.SH OPIS +.B Vimdiff +uruchomi +.B Vima +z dwoma (lub trzema plikami), kaĹźdy z nich we wĹasnym oknie. +Róşnice miÄdzy plikami zostanÄ
podĹwietlone. +Jest to dobry sposĂłb by przeanalizowaÄ róşnice i przenieĹÄ zmiany z jednej +wersji pliku do innej. +.PP +Zobacz vim(1) by poznaÄ wiÄcej szczegĂłĹĂłw o samym Vimie. +.PP +Kiedy uruchomiony jako +.B gvimdiff +zostanie uruchomione GUI (jeĹli dostÄpne). +.PP +W kaĹźdym oknie zostanie ustawiona opcja 'diff', ktĂłra spowoduje +podĹwietlenie róşnic. +.br +Opcje 'wrap' i 'scrollbind' zostanÄ
ustawione by tekst dobrze siÄ +przeglÄ
daĹo. +.br +Opcja 'foldmethod' zostanie ustawiona na "diff", dziÄki temu +niezmienione linie zostanÄ
zwiniÄte. 'foldcolumn' bÄdzie rĂłwne 2 aby +Ĺatwo wyszukiwaÄ, otwieraÄ i zamykaÄ zwiniÄcia. +.SH OPCJE +Pionowy podziaĹ jest uĹźyty do wyrĂłwnania linii, tak jakby uĹźyto +opcji "\-O". Aby uzyskaÄ poziomy podziaĹ uĹźyj opcji "\-o". +.PP +Aby poznaÄ inne opcje zobacz vim(1). +.SH ZOBACZ TAKĹťE +vim(1) +.SH AUTOR +WiÄkszoĹÄ +.B Vima +zostaĹa napisana przez Brama Moolenaara przy pomocy wielu innych osĂłb. +Zobacz ":help credits w +.B Vimie. diff --git a/runtime/doc/vimtutor-pl.1 b/runtime/doc/vimtutor-pl.1 new file mode 100644 index 000000000..a7ac50f62 --- /dev/null +++ b/runtime/doc/vimtutor-pl.1 @@ -0,0 +1,48 @@ +.TH VIMTUTOR 1 "2001 Kwi 2" +.SH NAZWA +vimtutor \- nauczyciel Vima +.SH SYNOPSIS +.br +.B vimtutor [język] +.SH OPIS +.B Vimtutor +uruchamia nauczycie +.B Vima. +Najpierw kopiuje właściwy plik, dzięki temu można go zmieniać bez obaw +utraty treści. +.PP +.B Vimtutor +przyda się ludziom, którzy chcą się nauczyć pierwszych poleceń +.B Vima +.PP +Opcjonalny argument [język] jest dwu literowym kodem języka, tak jak +"it" lub "es". +Jeśli brak argumentu [język] zostanie użyty język bieżącej +lokalizacji. +Jeśli nauczyciel w tym języku jest dostępny, zostanie użyty \- w innym +wypadku zostanie wykorzystana wersja angielska. +.PP +.B Vim +jest uruchamiany zawsze w trybie kompatybilności z Vi +.SH PLIKI +.TP 15 +/usr/local/lib/vim/tutor/tutor[.languague] +Tekstowe pliki +.B Vimtutora. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Skrypt Vima używany do kopiowania pliku +.B Vimtutora. +.SH AUTOR +.B Vimtutor +został początkowo napisany dla Vim przez Michaela C. Pierce'a +i Roberta K. Ware'a z Colorado School of Mines zainspirowani przez +Charlesa Smitha z Colorado State University. +E-mail: bware@mines.colorado.edu +.br +Zmodyfikowany na potrzeby +.B Vima +przez Brama Moolenaara. +Nazwiska tłumaczy w plikach. +.SH ZOBACZ TAKŻE +vim(1) diff --git a/runtime/doc/vimtutor-pl.UTF-8.1 b/runtime/doc/vimtutor-pl.UTF-8.1 new file mode 100644 index 000000000..78ee1be63 --- /dev/null +++ b/runtime/doc/vimtutor-pl.UTF-8.1 @@ -0,0 +1,48 @@ +.TH VIMTUTOR 1 "2001 Kwi 2" +.SH NAZWA +vimtutor \- nauczyciel Vima +.SH SYNOPSIS +.br +.B vimtutor [jÄzyk] +.SH OPIS +.B Vimtutor +uruchamia nauczycie +.B Vima. +Najpierw kopiuje wĹaĹciwy plik, dziÄki temu moĹźna go zmieniaÄ bez obaw +utraty treĹci. +.PP +.B Vimtutor +przyda siÄ ludziom, ktĂłrzy chcÄ
siÄ nauczyÄ pierwszych poleceĹ +.B Vima +.PP +Opcjonalny argument [jÄzyk] jest dwu literowym kodem jÄzyka, tak jak +"it" lub "es". +JeĹli brak argumentu [jÄzyk] zostanie uĹźyty jÄzyk bieĹźÄ
cej +lokalizacji. +JeĹli nauczyciel w tym jÄzyku jest dostÄpny, zostanie uĹźyty \- w innym +wypadku zostanie wykorzystana wersja angielska. +.PP +.B Vim +jest uruchamiany zawsze w trybie kompatybilnoĹci z Vi +.SH PLIKI +.TP 15 +/usr/local/lib/vim/tutor/tutor[.languague] +Tekstowe pliki +.B Vimtutora. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Skrypt Vima uĹźywany do kopiowania pliku +.B Vimtutora. +.SH AUTOR +.B Vimtutor +zostaĹ poczÄ
tkowo napisany dla Vim przez Michaela C. Pierce'a +i Roberta K. Ware'a z Colorado School of Mines zainspirowani przez +Charlesa Smitha z Colorado State University. +E-mail: bware@mines.colorado.edu +.br +Zmodyfikowany na potrzeby +.B Vima +przez Brama Moolenaara. +Nazwiska tĹumaczy w plikach. +.SH ZOBACZ TAKĹťE +vim(1) diff --git a/runtime/doc/xxd-pl.1 b/runtime/doc/xxd-pl.1 new file mode 100644 index 000000000..222151dc5 --- /dev/null +++ b/runtime/doc/xxd-pl.1 @@ -0,0 +1,389 @@ +.TH XXD 1 "Sierpień 1996" "Strona podręcznika dla xxd" +.\" +.\" 21st May 1996 +.\" Man page author: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Changes by Bram Moolenaar <Bram@vim.org> +.SH NAZWA +.I xxd +\- zrzut pliku do hex lub odwrotnie +.SH SYNOPSIS +.B xxd +\-h[elp] +.br +.B xxd +[opcje] [plik_we [plik_wy]] +.br +.B xxd +\-r[evert] [opcje] [plik_we [plik_wy]] +.SH OPIS +.I xxd +tworzy zrzut heksowy podanego pliku na standardowe wyjście. +Może także przetworzyć zrzut heksowy z powrotem do oryginalnej, +binarnej formy. +Podobnie jak +.BR uuencode (1) +i +.BR uudecode (1) +pozwala na przekazanie danych binarnych w bezpiecznej w poczcie formie +ASCII, ale ma zalety dekodowania na standardowe wyjście. +Ponadto można go użyć do przeprowadzenia łatania plików binarnych. +.SH OPCJE +Jeśli nie podano +.I plik_we +xxd czyta ze standardowego wejście. +Jeśli określono +.I plik_wy +jako znak +.RB \` \- ' +wtedy dane wejściowe czytane są ze standardowego wejścia. +Jeśli nie podano +.I plik_wy +(lub podano jako +.RB \` \- ' +), wyniki są wysyłane na standardowe wyjście. +.PP +Pamiętaj, że użyty został "leniwy" parser, który nie sprawdza więcej +niż pierwszej litery opcji (o ile ta nie została obdarzona +parametrem). Spacje między jedno literowymi opcjami i ich parametrami +są opcjonalne. Parametry opcji mogą być określone w notacji dziesiętnej, +heksadecymalej lub oktalnej. +Stąd +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +i +.B \-cols 8 +są sobie równoważne. +.PP +.TP +.IR \-a " | " \-autoskip +przełącza autoskip: pojedyncza '*' zastępuje linie nul. Domyślnie +wyłączone. +.TP +.IR \-b " | " \-bits +Przełącza do zrzutu bitowego (cyfr binarnych) zamiast heksowego. +Opcja ta zapisuje oktety ajko osiem cyfr 1 lub 0 zamias normalnego +zrzutu heksowego. Każda linia jest poprzedzona przez +heksadecymalny numer linii a za nim jego reprezentacja w ascii (lub +ebcdic). Opcje linii poleceń \-r, \-p, \-i nie działają w tym +trybie. +.TP +.IR "\-c cols " | " \-cols cols" +formatuje liczbę +.RI < cols > +oktetów na wiersz. Domyślnie 16 (\-i: 12, \-ps: 30, \-b: 6). Maks. +256. +.TP +.IR \-E " | "\-EBCDIC +zmienia kodowanie znaków w prawej kolumnie z ASCII na EBCDIC. +Nie zmienia prezentacji heksadecymalej. Opcja nie działa w połączeniu +z \-r, \-p lub \-i. +.TP +.IR "\-g bajtów " | " \-groupsize bajtów" +oddziela wyjście każdych +.RI < bajtów > +bajtów (dwa heksowe znaki lub osiem cyfr binarnych każde) przez biały +znak. +Określ +.I \-g 0 +by wyłączyć grupowanie. +.RI < Bajtów "> domyślnie jest " 2 +w trybie normalnym i \fI1\fP w trybie bitów. +Grupowanie nie działa w trybie postscriptu lub włączania. +.TP +.IR \-h " | " \-help +wypisuje podsumowanie dostępnych poleceń i kończy działanie. Nie +zostaje przeprowadzony żaden zrzut. +.TP +.IR \-i " | " \-include +wyjście w stylu włączania pliku w C. Zostaje zapisana kompletna +statyczna tablica definicji (nazwana według pliku wejścia), o ile xxd +nie czyta ze standardowego wejścia. +.TP +.IR "\-l len " | "\-len len" +zakończ po wypisaniu +.RI < len> +oktetów. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +wyjście w postcriptowym ciągłym stylu zrzutu heksowego. Znany także +jako zwykły zrzut heksowy. +.TP +.IR \-r " | " \-revert +odwróć operację: przekonwertuj (lub załataj) zrzut heksowy w binarkę. +Jeśli nie zapisuje na standardowe wyjście, xxd zapisze plik wyjściowy +bez obcinania go. Użyj kombinacji +.I \-r \-p +by odczytać zwykły zrzut heksadecymalny bez numerów linii +i określonego układu kolumn. Dodatkowe białe znaki i łamanie wierszy +są dozwolone wszędzie. +.TP +.I \-seek offset +Kiedy użyty po +.IR \-r : +odwraca z +.RI < offset > +dodanym do pozycji w pliku odnalezionym w zrzucie heksowym. +.TP +.I \-s [+][\-]seek +zaczyna na +.RI < seek > +bajtów abs. (lub wzg.) offsecie pliku wejściowego. +\fI+ fRwskazuje, że seek jest względne do bieżącej pozycji pliku (bez +znaczenia jeśli nie wczytuje ze standardowego wejścia). \fI\- \fRwskazuje +że seek powinno być o tyle znaków od końca wejścia (lub jeśli +połączone z \fI+\fR: przezhd bieżącą pozycją pliku na standardowym +wejściu). +Bez opcji \-s xxd zaczyna od bieżącej pozycji w pliku. +.TP +.I \-u +użyj wielkich liter w znakach heksowych. Domyślnie są małe znaki. +.TP +.IR \-v " | " \-version +pokazuje wersję programu. +.SH OSTRZEŻENIA +.PP +.I xxd \-r +potrafi określić numery linii. Jeśli plik wyjścia jest możliwy do +przeszukania wtedy numery linii na początku wiersza zrzutu heksowego +mogą być nie po kolei, może brakować wierszy lub nakładać się na +siebie. W takich wypadkach xxd użyje lseek(2) by znaleźć następną +pozycję. Jeśli plik wyjściowy nie jest możliwy do przeszukania możliwe +są tylko przerwy, które zostaną wypełnione bajtami null. +.PP +.I xxd \-r +nigdy nie podaje błędów analizy. Śmieci są ignorowane. +.PP +W czasie edycji zrzutów heksowych, proszę zauważyć że +.I xxd \-r +pomija wszystko w linii wejścia po odczytaniu wystarczającej ilości +kolumn danych heksadecymalnych (zobacz opcję \-c). Oznacza to także, +że zmiany w drukowanych kolumnach ascii (lub ebcdic) są zawsze +ignorowane. Odwrócenie zwykłego (lub postscriptowego) stylu zrzutu +poprzez xxd \-r \-p nie zależy od kolejności kolumn. Tutaj cokolwiej +co wygląda jak para cyfr heks jest interpretowane. +.PP +Zauważ różnicę między +.br +\fI% xxd \-i plik\fR +.br +i +.br +\fI% xxd \-i < plik\fR +.PP +.I xxd \-s \+seek +może być różne od +.IR "xxd \-s seek" , +ponieważ lseek(2) jest użyty do "przewinięcie" wejścia. '+' robi +różnicę jeśli źródłem wejścia jest standardowe wejście i jeśli pozycja +w pliku ze standardowego wejścia nie jest początkiem pliku w chwili +uruchomienia xxd. Następujące przykłady mogą wyjaśnić (lub bardziej +zmylić!)... +.PP +Przewiń standardowe wejście przed przeczytaniem; potrzebne ponieważ +`cat' już odczytał do końca standardowego wejścia. +.br +\fI% sh \-c 'cat > zwykła_kopia; xxd \-s 0 > hex_kopia' < plik +.PP +Zrzut heksowy od pozycji pliku 0x480 (=1024+128) w przód. +Znak `+' oznacza "względny wobec bieżącej pozycji", stąd `128' dodaje +do 1k gdzie zakończył dd. +.br +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +.PP +Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej. +.br +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +.PP +Jakkolwiek, jest to rzadka sytuacja i użycie `+' jest rzadko +potrzebne. +Autor woli monitorować działanie xxd przy pomocy strace(1) lub truss(1) kiedy \-s jest użyte. +.SH PRZYKŁADY +.PP +.br +Wypisz wszystko z wyjątkiem pierwszych trzech linii (heksowe 0x30 bajtów) +.B pliku +\. +.br +\fI% xxd \-s 0x30 plik +.PP +.br +Wypisz trzy linie (heksowe 0x30 bajtów) z końca +.B pliku +\. +.br +\fI% xxd \-s \-0x30 plik +.PP +.br +Wypisz 120 bajtów jako ciągły zrzut heksowy z 40 oktetami na linię. +.br +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e54482058584420312022417567757374203139 +.br +39362220224d616e75616c207061676520666f72 +.br +20787864220a2e5c220a2e5c222032317374204d +.br +617920313939360a2e5c22204d616e2070616765 +.br +20617574686f723a0a2e5c2220202020546f6e79 +.br +204e7567656e74203c746f6e79407363746e7567 +.br + +.br +Zrzut heksowy z pierwszymi 120 bajtami tej strony podręcznika z 12 +oktetami na linię. +.br +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +.br +000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +.br +0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +.br +0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\ +.br +0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M +.br +000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\" +.br +0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +.br +0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\" +.br +0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +.br +000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +.PP +.br +Pokaż tylko datę z pliku xxd.1 +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +.PP +.br +Kopiuj +.B plik_we +do +.B plik_wy +i poprzedź 100 bajtami o wartości 0x00. +.br +\fI% xxd plik_we | xxd \-r \-s 100 \> plik_wy\fR +.br + +.br +Podmień datę w pliku xxd.1 +.br +\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +.PP +.br +Utwórz plik o 65537 bajtach, wszystkich równych 0x00, +z wyjątkiem ostatniego, który ma być 'A' (hex 0x41). +.br +\fI% echo '010000: 41' | xxd \-r \> plik\fR +.PP +.br +Zrzut heksowy tego pliku z autoskipem. +.br +\fI% xxd \-a \-c 12 plik\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Utwórz jedno bajtowy plik zawierający pojednczą literę 'A'. +Liczba po '\-r \-s' dodaje numery linii znalezione w pliku; +w efekcie poprzedzające bajty są ukryte. +.br +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR +.PP +Użyj xxd jako filtra wewnątrz edytora takiego jak +.B vim(1) +aby uzyskać zrzut heksowy zakresu między markerami `a' i `z'. +.br +\fI:'a,'z!xxd\fR +.PP +Użyj xxd jako filtra wewnątrz edytora takiego jak +.B vim(1) +by odzyskać binarny zrzut heksowy zakresu pomiędzy markerami `a' +i `z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +Użyj xxd jako filtra wewnątrz edytora takiego jak +.B vim(1) +by odzyskać jedną linię zrzutu heksowego. Przejdź z kursorem na linię +i wpisz: +.br +\fI!!xxd \-r\fR +.PP +Odczytaj pojednycze znaki z portu szeregowego +.br +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.PP +.SH "ZWRACANE WARTOŚCI" +Zwracane są następujące wartości błędów: +.TP +0 +nie znaleziono błędów. +.TP +\-1 +operacja nie jest wspierana ( +.I xxd \-r \-i +cały czas niemożliwa). +.TP +1 +błąd w czasie analizowania opcji. +.TP +2 +problemy z plikiem wejściowym. +.TP +3 +problemy z plikiem wyjściowym. +.TP +4,5 +żądana pozycja jest nieosiągalna. +.SH "ZOBACZ TAKŻE" +uuencode(1), uudecode(1), patch(1) +.br +.SH OSTRZEŻENIA +Dziwaczność narzędzi dorównuje dziwaczności mózgu twórcy. +Używaj wyłącznie na własną odpowiedzialność. Kopiuj pliki. Analizuj +je. Stań się czarodziejem. +.br +.SH WERSJA +Strona podręcznika opisuje xxd w wersji 1.7 +.SH AUTOR +.br +(c) 1990-1997 by Juergen Weigert +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Kopiuj do woli i podaj moje dane, +.br +zarabiaj pieniądze i dziel się ze mną, +.br +trać pieniądze i nie miej do mnie pretensji. +.PP +Strona podręcznika zapoczątkowana przez Tony'ego Nugenta +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Małe zmiany: Bram Moolenaar. +Redakcja: Juergen Weigert. +.PP diff --git a/runtime/doc/xxd-pl.UTF-8.1 b/runtime/doc/xxd-pl.UTF-8.1 new file mode 100644 index 000000000..624de29de --- /dev/null +++ b/runtime/doc/xxd-pl.UTF-8.1 @@ -0,0 +1,389 @@ +.TH XXD 1 "SierpieĹ 1996" "Strona podrÄcznika dla xxd" +.\" +.\" 21st May 1996 +.\" Man page author: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Changes by Bram Moolenaar <Bram@vim.org> +.SH NAZWA +.I xxd +\- zrzut pliku do hex lub odwrotnie +.SH SYNOPSIS +.B xxd +\-h[elp] +.br +.B xxd +[opcje] [plik_we [plik_wy]] +.br +.B xxd +\-r[evert] [opcje] [plik_we [plik_wy]] +.SH OPIS +.I xxd +tworzy zrzut heksowy podanego pliku na standardowe wyjĹcie. +MoĹźe takĹźe przetworzyÄ zrzut heksowy z powrotem do oryginalnej, +binarnej formy. +Podobnie jak +.BR uuencode (1) +i +.BR uudecode (1) +pozwala na przekazanie danych binarnych w bezpiecznej w poczcie formie +ASCII, ale ma zalety dekodowania na standardowe wyjĹcie. +Ponadto moĹźna go uĹźyÄ do przeprowadzenia Ĺatania plikĂłw binarnych. +.SH OPCJE +JeĹli nie podano +.I plik_we +xxd czyta ze standardowego wejĹcie. +JeĹli okreĹlono +.I plik_wy +jako znak +.RB \` \- ' +wtedy dane wejĹciowe czytane sÄ
ze standardowego wejĹcia. +JeĹli nie podano +.I plik_wy +(lub podano jako +.RB \` \- ' +), wyniki sÄ
wysyĹane na standardowe wyjĹcie. +.PP +PamiÄtaj, Ĺźe uĹźyty zostaĹ "leniwy" parser, ktĂłry nie sprawdza wiÄcej +niĹź pierwszej litery opcji (o ile ta nie zostaĹa obdarzona +parametrem). Spacje miÄdzy jedno literowymi opcjami i ich parametrami +sÄ
opcjonalne. Parametry opcji mogÄ
byÄ okreĹlone w notacji dziesiÄtnej, +heksadecymalej lub oktalnej. +StÄ
d +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +i +.B \-cols 8 +sÄ
sobie rĂłwnowaĹźne. +.PP +.TP +.IR \-a " | " \-autoskip +przeĹÄ
cza autoskip: pojedyncza '*' zastÄpuje linie nul. DomyĹlnie +wyĹÄ
czone. +.TP +.IR \-b " | " \-bits +PrzeĹÄ
cza do zrzutu bitowego (cyfr binarnych) zamiast heksowego. +Opcja ta zapisuje oktety ajko osiem cyfr 1 lub 0 zamias normalnego +zrzutu heksowego. KaĹźda linia jest poprzedzona przez +heksadecymalny numer linii a za nim jego reprezentacja w ascii (lub +ebcdic). Opcje linii poleceĹ \-r, \-p, \-i nie dziaĹajÄ
w tym +trybie. +.TP +.IR "\-c cols " | " \-cols cols" +formatuje liczbÄ +.RI < cols > +oktetĂłw na wiersz. DomyĹlnie 16 (\-i: 12, \-ps: 30, \-b: 6). Maks. +256. +.TP +.IR \-E " | "\-EBCDIC +zmienia kodowanie znakĂłw w prawej kolumnie z ASCII na EBCDIC. +Nie zmienia prezentacji heksadecymalej. Opcja nie dziaĹa w poĹÄ
czeniu +z \-r, \-p lub \-i. +.TP +.IR "\-g bajtĂłw " | " \-groupsize bajtĂłw" +oddziela wyjĹcie kaĹźdych +.RI < bajtĂłw > +bajtĂłw (dwa heksowe znaki lub osiem cyfr binarnych kaĹźde) przez biaĹy +znak. +OkreĹl +.I \-g 0 +by wyĹÄ
czyÄ grupowanie. +.RI < BajtĂłw "> domyĹlnie jest " 2 +w trybie normalnym i \fI1\fP w trybie bitĂłw. +Grupowanie nie dziaĹa w trybie postscriptu lub wĹÄ
czania. +.TP +.IR \-h " | " \-help +wypisuje podsumowanie dostÄpnych poleceĹ i koĹczy dziaĹanie. Nie +zostaje przeprowadzony Ĺźaden zrzut. +.TP +.IR \-i " | " \-include +wyjĹcie w stylu wĹÄ
czania pliku w C. Zostaje zapisana kompletna +statyczna tablica definicji (nazwana wedĹug pliku wejĹcia), o ile xxd +nie czyta ze standardowego wejĹcia. +.TP +.IR "\-l len " | "\-len len" +zakoĹcz po wypisaniu +.RI < len> +oktetĂłw. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +wyjĹcie w postcriptowym ciÄ
gĹym stylu zrzutu heksowego. Znany takĹźe +jako zwykĹy zrzut heksowy. +.TP +.IR \-r " | " \-revert +odwrĂłÄ operacjÄ: przekonwertuj (lub zaĹataj) zrzut heksowy w binarkÄ. +JeĹli nie zapisuje na standardowe wyjĹcie, xxd zapisze plik wyjĹciowy +bez obcinania go. UĹźyj kombinacji +.I \-r \-p +by odczytaÄ zwykĹy zrzut heksadecymalny bez numerĂłw linii +i okreĹlonego ukĹadu kolumn. Dodatkowe biaĹe znaki i Ĺamanie wierszy +sÄ
dozwolone wszÄdzie. +.TP +.I \-seek offset +Kiedy uĹźyty po +.IR \-r : +odwraca z +.RI < offset > +dodanym do pozycji w pliku odnalezionym w zrzucie heksowym. +.TP +.I \-s [+][\-]seek +zaczyna na +.RI < seek > +bajtĂłw abs. (lub wzg.) offsecie pliku wejĹciowego. +\fI+ fRwskazuje, Ĺźe seek jest wzglÄdne do bieĹźÄ
cej pozycji pliku (bez +znaczenia jeĹli nie wczytuje ze standardowego wejĹcia). \fI\- \fRwskazuje +Ĺźe seek powinno byÄ o tyle znakĂłw od koĹca wejĹcia (lub jeĹli +poĹÄ
czone z \fI+\fR: przezhd bieĹźÄ
cÄ
pozycjÄ
pliku na standardowym +wejĹciu). +Bez opcji \-s xxd zaczyna od bieĹźÄ
cej pozycji w pliku. +.TP +.I \-u +uĹźyj wielkich liter w znakach heksowych. DomyĹlnie sÄ
maĹe znaki. +.TP +.IR \-v " | " \-version +pokazuje wersjÄ programu. +.SH OSTRZEĹťENIA +.PP +.I xxd \-r +potrafi okreĹliÄ numery linii. JeĹli plik wyjĹcia jest moĹźliwy do +przeszukania wtedy numery linii na poczÄ
tku wiersza zrzutu heksowego +mogÄ
byÄ nie po kolei, moĹźe brakowaÄ wierszy lub nakĹadaÄ siÄ na +siebie. W takich wypadkach xxd uĹźyje lseek(2) by znaleĹşÄ nastÄpnÄ
+pozycjÄ. JeĹli plik wyjĹciowy nie jest moĹźliwy do przeszukania moĹźliwe +sÄ
tylko przerwy, ktĂłre zostanÄ
wypeĹnione bajtami null. +.PP +.I xxd \-r +nigdy nie podaje bĹÄdĂłw analizy. Ĺmieci sÄ
ignorowane. +.PP +W czasie edycji zrzutĂłw heksowych, proszÄ zauwaĹźyÄ Ĺźe +.I xxd \-r +pomija wszystko w linii wejĹcia po odczytaniu wystarczajÄ
cej iloĹci +kolumn danych heksadecymalnych (zobacz opcjÄ \-c). Oznacza to takĹźe, +Ĺźe zmiany w drukowanych kolumnach ascii (lub ebcdic) sÄ
zawsze +ignorowane. OdwrĂłcenie zwykĹego (lub postscriptowego) stylu zrzutu +poprzez xxd \-r \-p nie zaleĹźy od kolejnoĹci kolumn. Tutaj cokolwiej +co wyglÄ
da jak para cyfr heks jest interpretowane. +.PP +ZauwaĹź róşnicÄ miÄdzy +.br +\fI% xxd \-i plik\fR +.br +i +.br +\fI% xxd \-i < plik\fR +.PP +.I xxd \-s \+seek +moĹźe byÄ róşne od +.IR "xxd \-s seek" , +poniewaĹź lseek(2) jest uĹźyty do "przewiniÄcie" wejĹcia. '+' robi +róşnicÄ jeĹli ĹşrĂłdĹem wejĹcia jest standardowe wejĹcie i jeĹli pozycja +w pliku ze standardowego wejĹcia nie jest poczÄ
tkiem pliku w chwili +uruchomienia xxd. NastÄpujÄ
ce przykĹady mogÄ
wyjaĹniÄ (lub bardziej +zmyliÄ!)... +.PP +PrzewiĹ standardowe wejĹcie przed przeczytaniem; potrzebne poniewaĹź +`cat' juĹź odczytaĹ do koĹca standardowego wejĹcia. +.br +\fI% sh \-c 'cat > zwykĹa_kopia; xxd \-s 0 > hex_kopia' < plik +.PP +Zrzut heksowy od pozycji pliku 0x480 (=1024+128) w przĂłd. +Znak `+' oznacza "wzglÄdny wobec bieĹźÄ
cej pozycji", stÄ
d `128' dodaje +do 1k gdzie zakoĹczyĹ dd. +.br +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +.PP +Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej. +.br +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +.PP +Jakkolwiek, jest to rzadka sytuacja i uĹźycie `+' jest rzadko +potrzebne. +Autor woli monitorowaÄ dziaĹanie xxd przy pomocy strace(1) lub truss(1) kiedy \-s jest uĹźyte. +.SH PRZYKĹADY +.PP +.br +Wypisz wszystko z wyjÄ
tkiem pierwszych trzech linii (heksowe 0x30 bajtĂłw) +.B pliku +\. +.br +\fI% xxd \-s 0x30 plik +.PP +.br +Wypisz trzy linie (heksowe 0x30 bajtĂłw) z koĹca +.B pliku +\. +.br +\fI% xxd \-s \-0x30 plik +.PP +.br +Wypisz 120 bajtĂłw jako ciÄ
gĹy zrzut heksowy z 40 oktetami na liniÄ. +.br +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e54482058584420312022417567757374203139 +.br +39362220224d616e75616c207061676520666f72 +.br +20787864220a2e5c220a2e5c222032317374204d +.br +617920313939360a2e5c22204d616e2070616765 +.br +20617574686f723a0a2e5c2220202020546f6e79 +.br +204e7567656e74203c746f6e79407363746e7567 +.br + +.br +Zrzut heksowy z pierwszymi 120 bajtami tej strony podrÄcznika z 12 +oktetami na liniÄ. +.br +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +.br +000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +.br +0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +.br +0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\ +.br +0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M +.br +000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\" +.br +0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +.br +0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\" +.br +0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +.br +000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +.PP +.br +PokaĹź tylko datÄ z pliku xxd.1 +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +.PP +.br +Kopiuj +.B plik_we +do +.B plik_wy +i poprzedĹş 100 bajtami o wartoĹci 0x00. +.br +\fI% xxd plik_we | xxd \-r \-s 100 \> plik_wy\fR +.br + +.br +PodmieĹ datÄ w pliku xxd.1 +.br +\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +.PP +.br +UtwĂłrz plik o 65537 bajtach, wszystkich rĂłwnych 0x00, +z wyjÄ
tkiem ostatniego, ktĂłry ma byÄ 'A' (hex 0x41). +.br +\fI% echo '010000: 41' | xxd \-r \> plik\fR +.PP +.br +Zrzut heksowy tego pliku z autoskipem. +.br +\fI% xxd \-a \-c 12 plik\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +UtwĂłrz jedno bajtowy plik zawierajÄ
cy pojednczÄ
literÄ 'A'. +Liczba po '\-r \-s' dodaje numery linii znalezione w pliku; +w efekcie poprzedzajÄ
ce bajty sÄ
ukryte. +.br +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR +.PP +UĹźyj xxd jako filtra wewnÄ
trz edytora takiego jak +.B vim(1) +aby uzyskaÄ zrzut heksowy zakresu miÄdzy markerami `a' i `z'. +.br +\fI:'a,'z!xxd\fR +.PP +UĹźyj xxd jako filtra wewnÄ
trz edytora takiego jak +.B vim(1) +by odzyskaÄ binarny zrzut heksowy zakresu pomiÄdzy markerami `a' +i `z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +UĹźyj xxd jako filtra wewnÄ
trz edytora takiego jak +.B vim(1) +by odzyskaÄ jednÄ
liniÄ zrzutu heksowego. PrzejdĹş z kursorem na liniÄ +i wpisz: +.br +\fI!!xxd \-r\fR +.PP +Odczytaj pojednycze znaki z portu szeregowego +.br +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.PP +.SH "ZWRACANE WARTOĹCI" +Zwracane sÄ
nastÄpujÄ
ce wartoĹci bĹÄdĂłw: +.TP +0 +nie znaleziono bĹÄdĂłw. +.TP +\-1 +operacja nie jest wspierana ( +.I xxd \-r \-i +caĹy czas niemoĹźliwa). +.TP +1 +bĹÄ
d w czasie analizowania opcji. +.TP +2 +problemy z plikiem wejĹciowym. +.TP +3 +problemy z plikiem wyjĹciowym. +.TP +4,5 +ĹźÄ
dana pozycja jest nieosiÄ
galna. +.SH "ZOBACZ TAKĹťE" +uuencode(1), uudecode(1), patch(1) +.br +.SH OSTRZEĹťENIA +DziwacznoĹÄ narzÄdzi dorĂłwnuje dziwacznoĹci mĂłzgu twĂłrcy. +UĹźywaj wyĹÄ
cznie na wĹasnÄ
odpowiedzialnoĹÄ. Kopiuj pliki. Analizuj +je. StaĹ siÄ czarodziejem. +.br +.SH WERSJA +Strona podrÄcznika opisuje xxd w wersji 1.7 +.SH AUTOR +.br +(c) 1990-1997 by Juergen Weigert +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Kopiuj do woli i podaj moje dane, +.br +zarabiaj pieniÄ
dze i dziel siÄ ze mnÄ
, +.br +traÄ pieniÄ
dze i nie miej do mnie pretensji. +.PP +Strona podrÄcznika zapoczÄ
tkowana przez Tony'ego Nugenta +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +MaĹe zmiany: Bram Moolenaar. +Redakcja: Juergen Weigert. +.PP |