diff options
Diffstat (limited to 'runtime/doc')
-rw-r--r-- | runtime/doc/evim-it.UTF-8.1 | 54 | ||||
-rw-r--r-- | runtime/doc/evim-ru.1 | 59 | ||||
-rw-r--r-- | runtime/doc/evim-ru.UTF-8.1 | 59 | ||||
-rw-r--r-- | runtime/doc/help.txt | 3 | ||||
-rw-r--r-- | runtime/doc/options.txt | 27 | ||||
-rw-r--r-- | runtime/doc/spell.txt | 121 | ||||
-rw-r--r-- | runtime/doc/syntax.txt | 13 | ||||
-rw-r--r-- | runtime/doc/tags | 15 | ||||
-rw-r--r-- | runtime/doc/vim-it.UTF-8.1 | 558 | ||||
-rw-r--r-- | runtime/doc/vimdiff-it.UTF-8.1 | 48 | ||||
-rw-r--r-- | runtime/doc/vimdiff-ru.1 | 50 | ||||
-rw-r--r-- | runtime/doc/vimtutor-it.UTF-8.1 | 54 | ||||
-rw-r--r-- | runtime/doc/vimtutor-ru.UTF-8.1 | 51 | ||||
-rw-r--r-- | runtime/doc/xxd-ru.1 | 408 | ||||
-rw-r--r-- | runtime/doc/xxd-ru.UTF-8.1 | 408 |
15 files changed, 1925 insertions, 3 deletions
diff --git a/runtime/doc/evim-it.UTF-8.1 b/runtime/doc/evim-it.UTF-8.1 new file mode 100644 index 000000000..c6656bfd5 --- /dev/null +++ b/runtime/doc/evim-it.UTF-8.1 @@ -0,0 +1,54 @@ +.TH EVIM 1 "16 febbraio 2002 " +.SH NOME +evim \- Vim "facile", Vim impostato in modo da poter essere usato +facilmente per modificare file, anche da chi non abbia familiarità +con i comandi. +.SH SINTASSI +.br +.B evim +[opzioni] [file ..] +.br +.B eview +.SH DESCRIZIONE +.B evim +Inizia +.B Vim +e imposta le opzioni per farlo comportare come un editore "modeless". +State sempre usando Vim, ma come un editore "posizionati-e-clicca". +Simile all'uso di Notepad in MS-Windows. +.B evim +richiede la presenza della GUI, per avere a disposizione menu e barra +strumenti. +.PP +Da usarsi solo da parte di chi non è in grado di lavorare con Vim nella +maniera usuale. +La modifica file sarà molto meno efficiente. +.PP +.B eview +come sopra, ma parte in modalità "Sola Lettura". Funziona come evim \-R. +.PP +Vedere vim(1) per dettagli riguardo a Vim, opzioni, etc. +.PP +L'opzione 'insertmode' è impostata per poter immettere del testo direttamente. +.br +Sono definite delle mappature che consentono di usare COPIA e INCOLLA con i +familiari tasti usati sotto MS-Windows. +CTRL-X taglia testo, CTRL-C copia testo e CTRL-V incolla testo. +Usate CTRL-Q per ottenere quello chs si ottierrebbe con CTRL-V in Vim nativo. +.SH OPZIONI +Vedere vim(1). +.SH FILE +.TP 15 +/usr/local/lib/vim/evim.vim +Lo script caricato per inizializzare eVim. +.SH NAC [NOTO ANCHE COME] +Noto Anche Come "Vim per semplici". +Quando usate evim si suppone che prendiate un fazzoletto, +facciate un nodo ad ogni angolo e ve lo mettiate in testa. +.SH VEDERE ANCHE +vim(1) +.SH AUTORE +Buona parte di +.B Vim +è stato scritto da Bram Moolenaar, con molto aiuto da altri. +Vedere il Menu "Aiuto/Crediti". diff --git a/runtime/doc/evim-ru.1 b/runtime/doc/evim-ru.1 new file mode 100644 index 000000000..6d6f5debf --- /dev/null +++ b/runtime/doc/evim-ru.1 @@ -0,0 +1,59 @@ +.TH EVIM 1 "2002 February 16" +.SH +evim \- Vim, Vim +.SH +.br +.B evim +[] [ ..] +.br +.B eview +.SH + +.B evim + +.B Vim + , + . Vim +Notepad MS-Windows. +.B eVim + , + . +.PP + , - + Vim . + , Vim. +.PP + +.B eview + , " + ". +evim \-R. +.PP + Vim, .. +vim(1). +.PP + +.B evim + 'insertmode', . +.br + , , MS-Windows + . CTRL-X +, CTRL-C CTRL-V . + CTRL-V, CTRL-Q. +.SH +. vim(1). +.SH +.TP 15 +/usr/local/lib/vim/evim.vim +, eVim. +.SH AKA +eVim "Vim ". + + , . +.SH +vim(1) +.SH + +.B Vim + (Bram Moolenaar), + . . /. diff --git a/runtime/doc/evim-ru.UTF-8.1 b/runtime/doc/evim-ru.UTF-8.1 new file mode 100644 index 000000000..581c364c2 --- /dev/null +++ b/runtime/doc/evim-ru.UTF-8.1 @@ -0,0 +1,59 @@ +.TH EVIM 1 "2002 February 16" +.SH ИМЯ +evim \- простой Vim, позволяет редактировать файл с помощью Vim в безрежимном режиме +.SH КОМАНДНАЯ СТРОКА +.br +.B evim +[ключи] [файл ..] +.br +.B eview +.SH ОПИСАНИЕ +Команда +.B evim +запускает +.B Vim +и настраивает ряд опций таким образом, что он начинает вести себя +как обычный безрежимный редактор. В этом режиме Vim напоминает +Notepad из MS-Windows. +.B eVim +всегда запускается с поддержкой графического интерфейса, чтобы обеспечить +использование меню и инструментальной панели. +.PP +Эта команда создана для тех, кто по каким-то причинам не в состоянии +работать с Vim в обычном режиме. Редактирование файлов при этом происходит +гораздо менее эффективно, чем при использовании обычного Vim. +.PP +Команда +.B eview +выполняет почти ту же самую задачу, но файл открывается в режиме "только +для чтения". Использование этой команды полностью идентично использованию +evim \-R. +.PP +Подробнее о Vim, ключах запуска и т.п. смотрите на странице справочника +vim(1). +.PP +При использовании +.B evim +включается опция 'insertmode', что позволяет вводить текст напрямую. +.br +Кроме того, настраиваются привязки, позволяющие использовать кнопки MS-Windows +для выполнения команд копирования и вклейки. CTRL-X используется для вырезания +текста, CTRL-C для копирования и CTRL-V для вклейки. Чтобы воспользоваться +изначальным значением кнопки CTRL-V, используйте CTRL-Q. +.SH ПАРАМЕТРЫ ЗАПУСКА +См. vim(1). +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/evim.vim +Сценарий, который загружается для инициализации eVim. +.SH AKA +eVim также известен как "Vim для чайников". +Для наилучшего эффекта рекомендуется во время использования повязать +на голове платок, предварительно завязав на каждом конце по узелку. +.SH СМОТРИ ТАКЖЕ +vim(1) +.SH АВТОРЫ +Большая часть +.B Vim +создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное +количество людей. См. меню Справка/Благодарности. diff --git a/runtime/doc/help.txt b/runtime/doc/help.txt index 63f1ef3be..2007a8af8 100644 --- a/runtime/doc/help.txt +++ b/runtime/doc/help.txt @@ -1,4 +1,4 @@ -*help.txt* For Vim version 7.0aa. Last change: 2004 Dec 30 +*help.txt* For Vim version 7.0aa. Last change: 2005 Mar 19 VIM - main help file k @@ -122,6 +122,7 @@ Advanced editing ~ |quickfix.txt| commands for a quick edit-compile-fix cycle |windows.txt| commands for using multiple windows and buffers |syntax.txt| syntax highlighting +|spell.txt| spell checking |diff.txt| working with two or three versions of the same file |autocmd.txt| automatically executing commands on an event |filetype.txt| settings done specifically for a type of file diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 46000c014..3a525cfc4 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 7.0aa. Last change: 2005 Mar 14 +*options.txt* For Vim version 7.0aa. Last change: 2005 Mar 19 VIM REFERENCE MANUAL by Bram Moolenaar @@ -3349,6 +3349,9 @@ A jump table for the options with a short description can be found at |Q_op|. |hl-Folded| f line used for closed folds |hl-FoldColumn| F 'foldcolumn' |hl-SignColumn| > column used for |signs| + |hl-SpellBad| B misspelled word |spell| + |hl-SpellRare| R rare word |spell| + |hl-SpellLocal| L word from other region |spell| The display modes are: r reverse (termcap entry "mr" and "me") @@ -5621,6 +5624,28 @@ A jump table for the options with a short description can be found at |Q_op|. set. NOTE: This option is set to 0 when 'compatible' is set. + *'spell'* *'nospell'* +'spell' boolean (default off) + local to window + {not in Vi} + {not available when compiled without the |+syntax| + feature} + When on spell checking will be done. See |spell|. + The languages used are specified with 'spelllang'. + + *'spelllang'* *'spl'* +'spelllang' 'spl' string (default empty) + local to buffer + {not in Vi} + {not available when compiled without the |+syntax| + feature} + A comma separated list of languages. when the 'spell' option is on + spellchecking will be done for these languages. Example: > + set spelllang=en_us,nl +< This means both US English and Dutch words are recognized. Words that + are not recognized will be highlighted. + More info at |spell|. + *'splitbelow'* *'sb'* *'nosplitbelow'* *'nosb'* 'splitbelow' 'sb' boolean (default off) global diff --git a/runtime/doc/spell.txt b/runtime/doc/spell.txt new file mode 100644 index 000000000..91dba4dca --- /dev/null +++ b/runtime/doc/spell.txt @@ -0,0 +1,121 @@ +*spell.txt* For Vim version 7.0aa. Last change: 2005 Mar 20 + + + VIM REFERENCE MANUAL by Bram Moolenaar + + +Spell checking *spell* + +1. Quick start |spell-quickstart| +X. Spell file format |spell-file-format| + +{Vi does not have any of these commands} + +Spell checking is not available when the |+syntax| feature has been disabled +at compile time. + +============================================================================== +1. Quick start *spell-quickstart* + +This command switches on spell checking: > + + :setlocal spell spelllang=en_us + +This switches the 'spell' option on and specifies to check for US English. + +The words that are not recognized are highlighted with one of these: + SpellBad word not recognized + SpellRare rare word + SpellLocal wrong spelling for selected region + + +REGIONS + +A word may be spelled differently in various regions. For example, English +comes in (at least) these variants: + + en all regions + en_us US + en_gb Great Britain + en_ca Canada + +Words that are not used in one region but are used in another region are +highlighted with SpellLocal. + +Always use lowercase letters. + + +SPELL FILES + +Vim searches for spell files in the "spell" subdirectory of the directories in +'runtimepath'. The name is: xx.yyy.spl, where: + xx the language name + yyy the value of 'encoding' + +Exception: Vim uses "latin1" when 'encoding' is "iso-8859-15". The euro sign +doesn't matter for spelling. + +A spell file might not be available in the current 'encoding'. You may try +using the "iconv" program to create one: > + + iconv -f latin1 -t koi8-r de.latin1.spl >de.koi8-r.spl + +However, if some characters cannot be presented in the target encoding this +will give wrong results. + +If a spell file only uses ASCII characters the encoding can be omitted. This +is useful for English: "en.spl" The file with encoding is checked first, thus +you could have one with encoding that includes words with non-ASCII characters +and use the ASCII file as a fall-back. + +============================================================================== +X. Spell file format *spell-file-format* + *E751* + +The spelling for a language is specified in file with a specific format. +The first character of a line specifies what follows in the line: + + char argument meaning ~ + - xx words for xx region follow (repeats) + <space> <word> normal word + > <word> rare word + = <word> word with non-keyword characters + + <word> optional word addition + # <anything> comment + +Empty lines are ignored. The word continues until the end of the line. Watch +out for trailing white space! + +Words that start with an upper-case letter will be required to be written that +way. Otherwise, words must be in lower-case. + +It is possible that a word appears both with an upper-case letter and as a +rare word. This means that the word with an upper-case letter is OK and the +word without the upper-case letter is rare. + *E753* +The region is specified with "-xx". For example, in the "en.spl" file "-us" +starts the word for "en_us". This can be repeated for words that are used in +more than one region. For example "-ca-us" is used for Canadian and US +English words. Use "---" to go back to the words for all regions. + +Vim supports up to six regions. *E752* + +It is possible to have a match that starts with a valid word. In that case +the match is used, because it is longer. Example: + + we + =we're + +"re" is not a word, thus "=we're" is needed to avoid it gets highlighted. + +The "+" items may appear after any word. For English "'s" is used. Be +careful with this, it may hide mistakes. + +Vim will check for duplicate words in the files used, but you will only get +warnings if the 'verbose' option is set to 1 or more. + +Note that the "=" and "+" words will slow down the operation. Use them only +when really needed. + + + vim:tw=78:sw=4:ts=8:ft=help:norl: diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt index eecfcaa5b..6503e2b5f 100644 --- a/runtime/doc/syntax.txt +++ b/runtime/doc/syntax.txt @@ -1,4 +1,4 @@ -*syntax.txt* For Vim version 7.0aa. Last change: 2005 Mar 14 +*syntax.txt* For Vim version 7.0aa. Last change: 2005 Mar 19 VIM REFERENCE MANUAL by Bram Moolenaar @@ -3893,6 +3893,17 @@ SpecialKey Meta and special keys listed with ":map", also for text used to show unprintable characters in the text, 'listchars'. Generally: text that is displayed differently from what it really is. + *hl-SpellBad* +SpellBad Word that is not recognized by the spellchecker. |spell| + This will be combined with the highlighting used otherwise. + *hl-SpellLocal* +SpellLocal Word that is recognized by the spellchecker as one that is + used in another region. |spell| + This will be combined with the highlighting used otherwise. + *hl-SpellRare* +SpellRare Word that is recognized by the spellchecker as one that is + hardly ever used. |spell| + This will be combined with the highlighting used otherwise. *hl-StatusLine* StatusLine status line of current window *hl-StatusLineNC* diff --git a/runtime/doc/tags b/runtime/doc/tags index 87953dc6f..a1b79f87d 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -548,6 +548,7 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME* 'nosmd' options.txt /*'nosmd'* 'nosn' options.txt /*'nosn'* 'nosol' options.txt /*'nosol'* +'nospell' options.txt /*'nospell'* 'nosplitbelow' options.txt /*'nosplitbelow'* 'nosplitright' options.txt /*'nosplitright'* 'nospr' options.txt /*'nospr'* @@ -727,6 +728,9 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME* 'sol' options.txt /*'sol'* 'sourceany' vi_diff.txt /*'sourceany'* 'sp' options.txt /*'sp'* +'spell' options.txt /*'spell'* +'spelllang' options.txt /*'spelllang'* +'spl' options.txt /*'spl'* 'splitbelow' options.txt /*'splitbelow'* 'splitright' options.txt /*'splitright'* 'spr' options.txt /*'spr'* @@ -3684,6 +3688,9 @@ E748 repeat.txt /*E748* E749 eval.txt /*E749* E75 vi_diff.txt /*E75* E750 repeat.txt /*E750* +E751 spell.txt /*E751* +E752 spell.txt /*E752* +E753 spell.txt /*E753* E76 pattern.txt /*E76* E77 message.txt /*E77* E78 motion.txt /*E78* @@ -5154,6 +5161,9 @@ hl-Scrollbar syntax.txt /*hl-Scrollbar* hl-Search syntax.txt /*hl-Search* hl-SignColumn syntax.txt /*hl-SignColumn* hl-SpecialKey syntax.txt /*hl-SpecialKey* +hl-SpellBad syntax.txt /*hl-SpellBad* +hl-SpellLocal syntax.txt /*hl-SpellLocal* +hl-SpellRare syntax.txt /*hl-SpellRare* hl-StatusLine syntax.txt /*hl-StatusLine* hl-StatusLineNC syntax.txt /*hl-StatusLineNC* hl-Title syntax.txt /*hl-Title* @@ -5760,6 +5770,7 @@ new-script-5.4 version5.txt /*new-script-5.4* new-search-path version6.txt /*new-search-path* new-searchpat version6.txt /*new-searchpat* new-session-files version5.txt /*new-session-files* +new-spell version7.txt /*new-spell* new-unlisted-buffers version6.txt /*new-unlisted-buffers* new-user-defined version5.txt /*new-user-defined* new-user-manual version6.txt /*new-user-manual* @@ -6206,6 +6217,10 @@ spec_chglog_prepend pi_spec.txt /*spec_chglog_prepend* spec_chglog_release_info pi_spec.txt /*spec_chglog_release_info* special-buffers windows.txt /*special-buffers* speed-up tips.txt /*speed-up* +spell spell.txt /*spell* +spell-file-format spell.txt /*spell-file-format* +spell-quickstart spell.txt /*spell-quickstart* +spell.txt spell.txt /*spell.txt* split() eval.txt /*split()* splitfind windows.txt /*splitfind* splitview windows.txt /*splitview* diff --git a/runtime/doc/vim-it.UTF-8.1 b/runtime/doc/vim-it.UTF-8.1 new file mode 100644 index 000000000..882a56deb --- /dev/null +++ b/runtime/doc/vim-it.UTF-8.1 @@ -0,0 +1,558 @@ +.TH VIM 1 "22 febbraio 2002" +.SH NOME +vim \- VI Migliorato, un editor di testi per programmatori +.SH SINTASSI +.br +.B vim +[opzioni] [file ..] +.br +.B vim +[opzioni] - +.br +.B vim +[opzioni] \-t tag +.br +.B vim +[opzioni] \-q [file_errori] +.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 DESCRIZIONE +.B Vim +Un editore di testi, compatibile con, e migliore di, Vi. +Può essere usato per editare qualsiasi file di testo. +Particolarmente utile per editare programmi. +.PP +Ci sono parecchi miglioramenti rispetto a Vi: undo multipli, +finestre e buffer multipli, evidenziazione sintattica, possibilità +di modificare la linea di comando, completamento nomi file, help +in linea, selezione testi in modalità visuale, etc.. +Vedere ":help vi_diff.txt" per un sommario delle differenze fra +.B Vim +e Vi. +.PP +Mentre usate +.B Vim +potete ricevere molto aiuto dal sistema di help online, col comando ":help". +Vedere qui sotto la sezione AIUTO ONLINE. +.PP +Quasi sempre +.B Vim +viene invocato, per modificare un file, col comando +.PP + vim file +.PP +Più in generale +.B Vim +viene invocato con: +.PP + vim [opzioni] [lista_file] +.PP +Se lista_file non è presente, l'editor inizia aprendo un buffer vuoto. +Altrimenti, una e una sola delle quattro maniere indicate qui sotto può +essere usata per scegliere uno o più file da modificare. +.TP 12 +file .. +Una lista di nomi di file. +Il primo di questi sarà il file corrente, e verrà letto nel buffer. +Il cursore sarà posizionato sulla prima linea del buffer. +Potete arrivare agli altri file col comando ":next". +Per editare un file il cui nome inizia per "-" premettete "--" alla +lista_file. +.TP +- +Il file da editare è letto dallo "stdin" [di solito, ma non +necessriamente, il terminale - NdT]. I comandi sono letti da "stderr", +che dovrebbe essere un terminale [tty]. +.TP +-t {tag} +Il file da editare e la posizione iniziale del cursore dipendono da "tag", +una specie di "etichetta" a cui saltare. +{tag} viene cercata nel file tags, ed il file ad essa associato diventa +quello corrente, ed il comando ad essa associato viene eseguito. +Di solito si usa per programmi C, nel qual caso {tag} potrebbe essere un +nome di funzione. +L'effetto è che il file contenente quella funzione diventa il file corrente +e il cursore è posizionato all'inizio della funzione. +Vedere ":help tag-commands". +.TP +-q [file_errori] +Inizia nella modalità quickFix [correzione veloce]. +Il file [file_errori] è letto e il primo errore è visualizzato. +Se [file_errori] non è indicato, il suo nome è ottenuto dal valore +dell'opzione 'errorfile' (che, se non specificata, vale "AztecC.Err" +per l'Amiga, "errors.err" su altri sistemi). +Si può saltare all'errore successivo col comando ":cn". +Vedere ":help quickfix". +.PP +.B Vim +si comporta in modo diverso se invocato con nomi differenti (il programma +eseguibile "sottostante" può essere sempre lo stesso). +.TP 10 +vim +Modalità "Normal", comportamento normale. +.TP +ex +Inizia in modalità "Ex". +Si può passare in modalità "Normal" col comandi ":vi". +Si può invocare la modalità "Ex" anche con l'argomento "-e". +.TP +view +Inizia in modalità "Sola Lettura". Non potete modificare i file. +Si può invocare la modalità "Sola Lettura" anche con l'argomento "-R". +.TP +gvim gview +La versione GUI [Graphical User Interface]. +Apre una nuova finestra. +Si può invocare la modalità "GUI" anche con l'argomento "-g". +.TP +evim eview +La versione GUI in modalità "Facile" (semplificata). +Apre una nuova finestra. +Si può invocare la modalità "Facile" anche con l'argomento "-y". +.TP +rvim rview rgvim rgview +Come sopra, ma con restrizioni ai comandi. Non si potrnno eseguire comandi +dello shell o sospendere +.B Vim. +Si può invocare la modalità "Ristretta" anche con l'argomento "-Z". +.SH OPZIONI +Le opzioni possono essere in un ordine qualsiasi, prima o dopo i nomi di +file. Opzioni che non necessitano un argomento possono essere raggruppate +dietro a un solo "-". +.TP 12 ++[numero] +Per il primo file il cursore sarà posizionato sulla linea "numero". +Se "numero" manca, il cursore sarà posizionato sull'ultima linea del file. +.TP ++/{espressione} +Per il primo file il cursore sarà posizionato alla +prima occorrenza di {espressione}. +Vedere ":help search-pattern" per come specificare l'espressione. +.TP ++{comando} +.TP +-c {comando} +{comando} sarà eseguito dopo che il +primo file è stato letto. +{comando} è interpretato come un comando Ex. +Se il {comando} contiene spazi deve essere incluso fra doppi apici +(o altro delimitatore, a seconda dello shell che si sta usando). +Esempio: Vim "+set si" main.c +.br +Note: Si possono avere fino a 10 comandi "+" o "-c". +.TP +-S {file} +I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. +Equivalente a -c "source {file}". +{file} non può avere un nome che inizia per '-'. +Se {file} è omesso si usa "Session.vim" (funziona solo se -S è l'ultimo +argomento specificato). +.TP +--cmd {comando} +Come "-c", ma il comando è eseguito PRIMA +di eseguire qualsiasi file vimrc. +Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi +"-c". +.TP +-A +Se +.B Vim +è stato compilato con supporto ARABIC per editare file con orientamento +destra-sinistra e tastiera con mappatura Araba, questa opzione inizia +.B Vim +in modalità "Arabic", cioè impostando 'arabic'. +Altrimenti viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +-b +Modalità "Binaria". +Vengono impostate alcune opzioni che permettono di modificare un file +binario o un programma eseguibile. +.TP +-C +Compatibile. Imposta l'opzione 'compatible'. +In questo modo +.B Vim +ha quasi lo stesso comportamento di Vi, anche in presenza di un file +di configurazione .vimrc [proprio di Vim - NdT]. +.TP +-d +Inizia in modalità "Diff" [differenze]. +Dovrebbero esserci come argomenti due o tre nomi di file. +.B Vim +aprirà tutti i file evidenziando le differenze fra gli stessi. +Funziona come vimdiff(1). +.TP +-d {dispositivo} +Apre {dispositivo} per usarlo come terminale. +Solo per l'Amiga. +Esempio: +"\-d con:20/30/600/150". +.TP +-D +Debugging. Vim si mette in modalità "debugging" a partire +dall'esecuzione del primo comando da uno script. +.TP +-e +Eseguire +.B Vim +in modalità "Ex", come se il programma eseguito sia "ex". +.TP +-E +Eseguire +.B Vim +in modalità "Ex" migliorata, come se il programma eseguito sia "exim". +.TP +-f +Direttamente [Foreground]. Per la versione GUI, +.B Vim +non crea [fork] una nuova finestra, indipendente dallo shell di invocazione. +Per l'Amiga, +.B Vim +non è fatto ripartire per aprire una nuova finestra. +Opzione da usare quando +.B Vim +è eseguito da un programma che attende la fine della +sessione di edit (ad es. mail). +Sull'Amiga i comandi ":sh" e ":!" non sono disponibili. +.TP +--nofork +Direttamente [Foreground]. Per la versione GUI, +.B Vim +non crea [fork] una nuova finestra, indipendente dallo shell di invocazione. +.TP +-F +Se +.B Vim +è stato compilato con supporto FKMAP per editare file con orientamento +destra-sinistra e tastiera con mappatura Farsi, questa opzione inizia +.B Vim +in modalità "Farsi", cioè impostando 'fkmap' e 'rightleft'. +Altrimenti viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +-g +Se +.B Vim +è stato compilato con supporto GUI, questa opzione chiede di usarla. +Se Vim è stato compilato senza supporto GUI viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +-h +Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. +Subito dopo +.B Vim +esce. +.TP +-H +Se +.B Vim +è stato compilato col supporto RIGHTLEFT per editare file con orientamento +destra-sinistra e tastiera con mappatura Ebraica, questa opzione inizia +.B Vim +in modalità "Ebraica", cioè impostando 'hkmap' e 'rightleft'. +Altrimenti viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +-i {viminfo} +Se è abilitato l'uso di un file viminfo, questa opzione indica il nome +del file da usare invece di quello predefinito "~/.viminfo". +Si può anche evitare l'uso di un file .viminfo, dando come nome "NONE". +.TP +-L +Equivalente a -r. +.TP +-l +Modalità Lisp. +Imposta le opzini 'lisp' e 'showmatch'. +.TP +-m +Inibisce modifica file. +Annulla l'opzione 'write'. +E' ancora possibile modificare un buffer [in memoria - Ndt], ma non scriverlo. +.TP +-M +Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate, +in modo da impedire sia modifiche che riscritture. Da notare che queste +opzioni possono essere abilitate in seguito, permettendo così modifiche. +.TP +-N +Modalità "Non-compatibile". Annulla l'opzione 'compatible'. +Così +.B Vim +va un po' meglio, ma è meno compatibile con Vi, anche in assenza di un +file .vimrc. +.TP +-n +Inibisce l'uso di un file di swap. +Il recupero dopo una caduta di macchina diventa impossibile. +Utile per editare un file su un supporto molto lento (ad es. floppy). +Il comando ":set uc=0" ha lo stesso effetto. +Per abilitare il recupero usare ":set uc=200". +.TP +-nb +Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli. +.TP +-o[N] +Apri N finestre in orizzontale. +Se N manca, apri una finestra per ciascun file. +.TP +-O[N] +Apri N finestre, in verticale. +Se N manca, apri una finestra per ciascun file. +.TP +-R +Modalità "Sola Lettura". +Imposta l'opzione 'readonly'. +Si può ancora modificare il buffer, ma siete protetti da una riscrittura +involontaria. +Se volete davvero riscrivere il file, aggiungete un punto esclamativo +al comando "Ex", come in ":w!". +L'opzione -R implica anche l'opzione -n (vedere sotto). +L'opzione 'readonly' può essere annullata con ":set noro". +Vedere ":help 'readonly'". +.TP +-r +Lista file di swap, assieme a dati utili per un recupero. +.TP +-r {file} +Modalità "Recovery". +Il file di swap è usato per recuperare una sessione di edit finita male. +Il file di swap è un file con lo stesso nome file del file di testo +editato, col suffisso ".swp". +Vedere ":help recovery". +.TP +-s +Modalità silenziosa. Solo quando invocato come "Ex" o quando l'opzione +"-e" è stata data prima dell'opzione "-s". +.TP +-s {scriptin} +Lo script file {scriptin} è letto. +I caratteri nel file sono interpretati come se immessi da voi. +Lo stesso si può ottenere col comando ":source! {scriptin}". +Se la fine del file di input viene raggiunta prima che Vim termini, +l'ulteriore input viene preso dalla tastiera. +.TP +-T {terminale} +Dice a +.B Vim +quale tipo di terminale state usando. +Utile solo se il terminale non viene riconosciuto correttamente da Vim. +Dovrebbe essere un terminale noto a +.B Vim +(internamente) o definito nel file termcap o terminfo. +.TP +-u {vimrc} +Usa i comandi nel file {vimrc} per inizializzazioni. +Tutte le altre inizializzazioni non sono eseguite. +Usate questa opzione per editare qualche file di tipo speciale. +Può anche essere usato per non fare alcuna inizializzazione dando +come nome "NONE". +Vedere ":help initialization" da vim per ulteriori dettagli. +.TP +-U {gvimrc} +Usa i comandi nel file {gvimrc} per inizializzazioni GUI. +Tutte le altre inizializzazioni GUI non sono eseguite. +Può anche essere usata per non fare alcuna inizializzazione GUI dando +come nome "NONE". +Vedere ":help gui-init" da vim per ulteriori dettagli. +.TP +-V[N] +Verboso. Vim manda messaggi relativi agli script file che esegue +e quando legge o scrive un file viminfo. Il numero opzionale N è il valore +dell'opzione 'verbose'. +Il valore predefinito è 10. +.TP +-v +Inizia +.B Vim +in modalità "Vi", come se il programma eseguibile fosse "vi". Questo ha +effetto solo quando Vim viene invocato con il nome "ex". +.TP +-w {scriptout} +Ogni carattere immesso viene registrato nel file {scriptout}, +finché non uscite da +.B Vim. +Utile se si vuole creare uno script file da usare con "vim -s" o +":source!". +Se il file {scriptout} esiste, quel che immettete viene aggiunto in fondo. +.TP +-W {scriptout} +Come -w, ma uno script file esistente viene sovrascritto. +.TP +-x +Uso di cifratura nella scrittura dei file. E' necessario immettere +una chiave di cifratura. +.TP +-X +Non connetterti al server X. Vim parte più rapidamente, +ma il titolo della finestra e la clipboard non sono disponibili. +.TP +-y +Eseguire +.B Vim +in modalità "Facile" (semplificata), come se l'eseguibile invocato +sia "evim" o "eview". +Fa sì che +.B Vim +si comporti come un editor che usa solo il mouse e i caratteri. +.TP +-Z +Modalità "Ristretta". Vim si comporta come se invocato con un nome +che inizia per "r". +.TP +-- +Specifica la fine delle opzioni. +Argomenti specificati dopo questo sono considerati nomi file. +Si può usare per editare un file il cui nome inizi per '-'. +.TP +--echo-wid +Solo con GUI GTK: Visualizza Window ID su "stdout". +.TP +--help +Vim dà un messaggio ed esce, come con l'argomento "-h". +.TP +--literal +Considera i nomi passati come argomenti letterai, senza espandere +metacaratteri. Non necessario in Unix, lo shell espande i metacaratteri. +.TP +--noplugin +Non caricare plugin. Implicito se si specifica -u NONE. +.TP +--remote +Connettersi a un server Vim e chiedere di editare i file elencati come altri +argomenti. Se non si trova un server viene dato un messaggio e i file sono +editati nel Vim corrente. +.TP +--remote-expr {expr} +Connettersi a un server Vim, valutare ivi {expr} e stampare il risultatoi +su "stdout". +.TP +--remote-send {chiavi} +Connettersi a un server Vim e spedirgli {chiavi}. +.TP +--remote-silent +Come --remote, ma senza avvisare se non si trova un server. +.TP +--remote-wait +Come --remote, ma Vim non termina finché i file non sono stati editati. +.TP +--remote-wait-silent +Come --remote-wait, ma senza avvisare se non si trova un server. +.TP +--serverlist +Lista i nomi di tutti i server Vim disponibili. +.TP +--servername {nome} +Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia +usato con l'argomento --remote, nel qual caso indica il server a cui +connettersi. +.TP +--socketid {id} +Solo con GUI GTK: Usa il meccanismo GtkPlug per eseguire gvim in un'altra +finestra. +.TP +--version +Stampa la versione di Vim ed esci. +.SH AIUTO ONLINE +Battere ":help" in +.B Vim +per iniziare. +Battere ":help argomento" per ricevere aiuto su uno specifico argomento. +Per esempio: ":help ZZ" per ricevere aiuto sul comando "ZZ". +Usare <Tab> e CTRL-D per completare gli argomenti +(":help cmdline-completion"). +Ci sono "tag" nei file di help per saltare da un argomento a un altro +(simili a legami ipertestuali, vedere ":help"). +Tutti i file di documentazione possono essere navigati così. Ad es.: +":help syntax.txt". +.SH FILE +.TP 15 +/usr/local/lib/vim/doc/*.txt +I file di cocumentaziona di +.B Vim +. +Usate ":help doc-file-list" per avere la lista completa. +.TP +/usr/local/lib/vim/doc/tags +Il file di tags usato per trovare informazioni nei file di documentazione. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Inizializzazioni sintattiche a livello di sistema. +.TP +/usr/local/lib/vim/syntax/*.vim +File di colorazione sintattica per vari linguaggi. +.TP +/usr/local/lib/vim/vimrc +Inizializzazioni +.B Vim +a livello di sistema. +.TP +/usr/local/lib/vim/gvimrc +Inizializzazioni gvim a livello di sistema. +.TP +/usr/local/lib/vim/optwin.vim +Script Vim usato dal comando ":options", un modo semplice +per visualizzare e impostare opzioni. +.TP +/usr/local/lib/vim/menu.vim +Inzializzazioni del menu gvim a livello di sistema. +.TP +/usr/local/lib/vim/bugreport.vim +Script Vim per generare una segnalazione di errore. Vedere ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Script Vim per determinare il tipo di un file a partire dal suo nome. +Vedere ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Script Vim per determinare il tipo di un file a partire dal suo contenuto. +Vedere ":help 'filetype'". +.TP +/usr/local/lib/vim/*.ps +File usati per stampa PostScript. +.PP +Per informazioni aggiornate [in inglese - NdT] vedere la home page di Vim: +.br +<URL:http://www.vim.org/> +.SH VEDERE ANCHE +vimtutor(1) +.SH AUTORE +Buona parte di +.B Vim +è stato scritto da Bram Moolenaar, con molto aiuto da altri. +Vedere ":help credits" in +.B Vim. +.br +.B Vim +è basato su Stevie, scritto da: Tim Thompson, +Tony Andrews e G.R. (Fred) Walter. +In verità, poco o nulla è rimasto del loro codice originale. +.SH BACHI +Probabili. +Vedere ":help todo" per una lista di problemi noti. +.PP +Si noti che un certo numero di comportamenti che possono essere considerati +errori da qualcuno, sono in effetti causati da una riproduzione fin troppo +fedele del comportamento di Vi. +Se ritenete che altre cose siano errori "perché Vi si comporta diversamente", +date prima un'occhiata al file vi_diff.txt +(o battere :help vi_diff.txt da Vim). +Date anche un'occhiata alle opzioni 'compatible' e 'cpoptions. diff --git a/runtime/doc/vimdiff-it.UTF-8.1 b/runtime/doc/vimdiff-it.UTF-8.1 new file mode 100644 index 000000000..e71e774e8 --- /dev/null +++ b/runtime/doc/vimdiff-it.UTF-8.1 @@ -0,0 +1,48 @@ +.TH VIMDIFF 1 "30 marzo 2001" +.SH NOME +vimdiff \- modifica due o tre versioni di un file con Vim, visualizzando le +differenze +.SH SINTASSI +.br +.B vimdiff +[opzioni] file1 file2 [file3] +.PP +.B gvimdiff +.SH DESCRIZIONE +.B Vimdiff +inizia +.B Vim +per due (o tre) file. +Ogni file ha una sua finestra. +Le differenze fra file sono evidenziate. +E' una maniera elegante per controllare modifiche e portare modifiche +verso un'altra versione dello stesso file. +.PP +Vedere vim(1) per dettagli su Vim in generale. +.PP +Se iniziato con +.B gvimdiff +la GUI sarà utilizzata, se disponibile. +.PP +In ogni finestra l'opzione 'diff' è impostata, evidenziando così le +differenze. +.br +Le opzioni 'wrap' e 'scrollbind' sono impostate per migliorare la +visibilità del testo. +.br +L'opzione 'foldmethod' è impostata al valore "diff", che mette gruppi di +linee uguali fra i diversi file in una piegatura. 'foldcolumn' è impostato +a due per poter facilmente visualizzare le piegature, aprirle e chiuderle. +.SH OPZIONI +Lo schermo è diviso verticalmente, come se aveste usato l'opzione "\-O". +Per dividerlo orizzontalmente, usare l'opzione "\-o". +.PP +Per tutte le altre opzioni, vedere vim(1). +.SH VEDERE ANCHE +vim(1) +.SH AUTORE +Buona parte di +.B Vim +è stato scritto da Bram Moolenaar, con molto aiuto da altri. +Vedere ":help credits" in +.B Vim. diff --git a/runtime/doc/vimdiff-ru.1 b/runtime/doc/vimdiff-ru.1 new file mode 100644 index 000000000..7517f87e0 --- /dev/null +++ b/runtime/doc/vimdiff-ru.1 @@ -0,0 +1,50 @@ +.TH VIMDIFF 1 "2001 March 30" +.SH +vimdiff \- Vim + . +.SH +.br +.B vimdiff +[] 1 2 [3] +.PP +.B gvimdiff +.SH + +.B vimdiff + +.B Vim + ( ) . . + . + ӣ + . +.PP + Vim . vim(1). +.PP + +.B gvimdiff + , . +.PP + 'diff', + . +.br + + 'wrap' 'scrollbind'. +.br + 'foldmethod' "diff", + , . + 'foldcolumn' 2, +, . +.SH + , + "-O". , + , "-o". +.PP + vim(1). +.SH +vim(1) +.SH + +.B Vim + (Bram Moolenaar), + . . ":help credits" +.B Vim. diff --git a/runtime/doc/vimtutor-it.UTF-8.1 b/runtime/doc/vimtutor-it.UTF-8.1 new file mode 100644 index 000000000..86f263725 --- /dev/null +++ b/runtime/doc/vimtutor-it.UTF-8.1 @@ -0,0 +1,54 @@ +.TH VIMTUTOR 1 "2001 April 2" +.SH NOME +vimtutor \- the Vim tutor +.SH SINTASSI +.br +.B vimtutor [lingua] +.SH DESCRIZIONE +.B Vimtutor +inizia il +.B Vim +tutor. +It copies the tutor file first, so that it can be modified without changing +the original file. +.PP +The +.B Vimtutor +is useful for people that want to learn their first +.B Vim +commands. +.PP +The optional [language] argument is the two-letter name of a language, like +"it" or "es". +If the [language] argument is missing, the language of the current locale will +be used. +If a tutor in this language is available, it will be used. +Otherwise the English version will be used. +.PP +.B Vim +is always started in Vi compatible mode. +.SH FILE +.TP 15 +/usr/local/lib/vim/tutor/tutor[.language] +The +.B Vimtutor +text file(s). +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +The Vim script used to copy the +.B Vimtutor +text file. +.SH AUTORE +The +.B Vimtutor +è stato scritto in origine per Vi da Michael C. Pierce e Robert K. Ware, +Colorado School of Mines, usando idee fornite da Charles Smith, +Colorado State University. +E-mail: bware@mines.colorado.edu. +.br +E' stato modificato per +.B Vim +da Bram Moolenaar. +Per i nomi dei traduttori, vedere i file usati nelle rispettive lingue. +.SH VEDERE ANCHE +vim(1) diff --git a/runtime/doc/vimtutor-ru.UTF-8.1 b/runtime/doc/vimtutor-ru.UTF-8.1 new file mode 100644 index 000000000..6b1ba90df --- /dev/null +++ b/runtime/doc/vimtutor-ru.UTF-8.1 @@ -0,0 +1,51 @@ +.TH VIMTUTOR 1 "2001 April 2" +.SH ИМЯ +vimtutor \- учебник по Vim +.SH КОМАНДНАЯ СТРОКА +.br +.B vimtutor [язык] +.SH ОПИСАНИЕ +Команда +.B vimtutor +запускает учебник по +.B Vim. +При этом сначала происходит создание копии файла учебника, +чтобы его можно было редактировать без опасения потерять исходный файл. +.PP +Программа +.B vimtutor +полезна для новичков, желающих научиться самым основным командам +.B Vim. +.PP +Необязательный параметр [язык] представляет собой двухсимвольный код языка, +например "ru" или "it". +Если параметр [язык] не указан, то используется язык активной в настоящий +момент локали. Если учебник на этом языке не существует, то по умолчанию +используется учебник на английском языке. +.PP +При работе с учебником +.B Vim +всегда запускается в режиме совместимости с Vi. +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/tutor/tutor[.язык] +Текст учебника +.B vimtutor. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Сценарий Vim, который используется для создания рабочей +копии текста учебника +.B vimtutor. +.SH АВТОРЫ +.B Vimtutor +был впервые написан для Vi Майклом К. Пирсом (Michael C. Pierce) и +Робертом К. Уэа (Robert K. Ware) из Colorado School of Mines по +идее Чарльза Смита (Charles Smith) из Colorado State University. +E-mail: bware@mines.colorado.edu. +.br +Впоследствии учебник был доработан для использования в +.B Vim +Брамом Мооленааром (Bram Moolenaar). +Имена переводчиков учебника упоминаются в соответствующих файлах. +.SH СМОТРИ ТАКЖЕ +vim(1) diff --git a/runtime/doc/xxd-ru.1 b/runtime/doc/xxd-ru.1 new file mode 100644 index 000000000..9c2f92d3d --- /dev/null +++ b/runtime/doc/xxd-ru.1 @@ -0,0 +1,408 @@ +.TH XXD 1 "August 1996" " man 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 +.I xxd +\- + . +.SH +.B xxd +\-h[elp] +.br +.B xxd +[] [_ [_]] +.br +.B xxd +\-r[evert] [] [_ [_]] +.SH +.I xxd + , + , . + + . + +.BR uuencode(1) + +.BR uudecode(1), + ASCII-, + , , , +xxd , + . +.SH + +.I _ + , . + , +.I _ + +.RB \` \- ', + . + , +.I _ +( +.RB \` \- ' +), . +.PP + , "" , + , . + +. , + . + , +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 + +.B \-cols 8 + . +.PP +.TP +.IR \-a " | " \-autoskip + : + '*'. + . +.TP +.IR \-b " | " \-bits + ( ). + + "1" "0". + , + ( ascii ebcdic). \-r, \-p, \-i + . +.TP +.IR "\-c " | " \-cols " + +.RI < >, + . 16 +(\-i: 12, \-ps: 30, \-b: 6). + : 256. +.TP +.IR \-E " | " \-EBCDIC + ASCII EBCDIC. + . , + \-r, \-p \-i. +.TP +.IR "\-g " | " \-groupsize " + +.RI < > +( ), . + +.I \-g 0 + . + +.RI < "> " 2 + \fI1\fP . + postscript include. +.TP +.IR \-h " | " \-help + . + . +.TP +.IR \-i " | " \-include + C. + , + , xxd +. +.TP +.IR "\-l " | " \-len " + +.RI < > + . +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain + , + "" "postscript". +.TP +.IR \-r " | " \-revert + : + ( ). + , xxd + . +.I \-r \-p + "" + - . + . +.TP +.I \-seek + +.I \-r +: +.RI < > + , . +.TP +.I \-s [\+][\-]seek + ( ) +.RI < > + _. +\fI\+ \fR, + (, + ). \fI\- \fR, + (, \fI \+ \fR: + ). + \-s , xxd . +.TP +.I \-u + . + . +.TP +.IR \-v " | " \-version + . +.SH +.PP +.I xxd \-r + . + , + , + . xxd +lseek(2) . +, , +. +.PP +.I xxd \-r + . . +.PP + +, +.I xxd \-r + + (. \-c). , , + ascii ( ebcdic), . + +postscript xxd \-r \-p . + , . +.PP + +.PP +\fI% xxd \-i \fR +.PP + +.PP +\fI% xxd \-i \< \fR +.PP + +.I xxd \-s \+seek + +.I xxd \-s seek, + , "" , lseek(2). + `+' , + , + , xxd . + ( ݣ !) ... +.PP + ; , 'cat' + : +.PP +\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +.PP + 0x480 +(= 1024+128). + `+' " ", `128' + , dd: +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +.PP + 0x100 +(= 1024-768): +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +.PP + , , , + `+' . +xxd strace(1) truss(1) , +\-s. +.SH +.PP +.br + ӣ, ң (0x30 ) +.B file +: +.PP +\fI% xxd \-s 0x30 file +.PP +.br + (0x30 ) +.B file +: +.PP +\fI% xxd \-s \-0x30 file +.PP +.br + 120 + 40 : +.PP +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e544820585844203120224d616e75616c207061 +.br +676520666f7220787864220a2e5c220a2e5c2220 +.br +32317374204d617920313939360a2e5c22204d61 +.br +6e207061676520617574686f723a0a2e5c222020 +.br +2020546f6e79204e7567656e74203c746f6e7940 +.br +7363746e7567656e2e7070702e67752e6564752e +.br +.PP +.br + 120 12 : +.PP +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +.br +000000c: 616e 7561 6c20 7061 6765 2066 anual page f +.br +0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +.br +0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +.br +0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +.br +000003c: 6e20 7061 6765 2061 7574 686f n page autho +.br +0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +.br +0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +.br +0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +.br +000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +.PP +.br + xxd.1: +.PP +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +.PP +.br + +.B _ + +.B _ + 100 0x00 : +.PP +\fI% xxd _ | xxd \-r \-s 100 \> _\fR +.br +.PP +.br + xxd.1: +.PP +\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3235 7468 204d 6179 2031 3939 25th May 199 +.PP +.br + 65537- , +0x00, , 'A' +(0x41): +.PP +\fI% echo '010000: 41' | xxd \-r \> file\fR +.PP +.br + + : +.PP +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP + 1- , 'A'. + '\-r \-s' , ; + , : +.PP +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +.PP +xxd , +.B vim(1), + + `a' `z': +.PP +\fI:'a,'z!xxd\fR +.PP + xxd , +.B vim(1), + + `a' `z': +.PP +\fI:'a,'z!xxd \-r\fR +.PP + xxd , +.B vim(1), + + . + +.PP +\fI!!xxd \-r\fR +.PP + : +.PP +\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 + xxd : +.TP +0 + . +.TP +\-1 + ( +.I xxd \-r \-i + ). +.TP +1 + . +.TP +2 + . +.TP +3 + . +.TP +4,5 + . +.SH +uuencode(1), uudecode(1), patch(1) +.br +.SH + ţ . + ţ . , +, . +.br +.SH + xxd 1.7. +.SH +.br +(c) 1990-1997 (Juergen Weigert) +.br +<jnweiger@informatik.uni-erlangen.de> +.LP + . +.br + - , + . +.br + , ޣ. +.PP + (Tony Nugent) +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br + (Bram Moolenaar). + (Juergen Weigert). +.PP diff --git a/runtime/doc/xxd-ru.UTF-8.1 b/runtime/doc/xxd-ru.UTF-8.1 new file mode 100644 index 000000000..ce75f8304 --- /dev/null +++ b/runtime/doc/xxd-ru.UTF-8.1 @@ -0,0 +1,408 @@ +.TH XXD 1 "August 1996" "Страница man для 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 ИМЯ +.I xxd +\- создаёт представление файла в виде шестнадцатеричных кодов или выполняет +обратное преобразование. +.SH КОМАНДНАЯ СТРОКА +.B xxd +\-h[elp] +.br +.B xxd +[ключи] [входной_файл [выходной_файл]] +.br +.B xxd +\-r[evert] [ключи] [входной_файл [выходной_файл]] +.SH ОПИСАНИЕ +.I xxd +создаёт представление указанного файла или данных, прочитанных из потока +стандартного ввода, в виде шестнадцатеричных кодов. Эта команда также может +выполнить обратное преобразование заданных шестнадцатеричными кодами данных +в исходный бинарный формат. +Подобно командам +.BR uuencode(1) +и +.BR uudecode(1), +она позволяет выполнять преобразование бинарных данных в ASCII-код, +который можно передавать по электронной почте, однако, помимо этого, программа +xxd позволяет выполнять декодирование в поток стандартного вывода, +а также может применяться для создания заплаток для бинарных файлов. +.SH КЛЮЧИ ЗАПУСКА +Если +.I входной_файл +не задан, то соответствующие данные читаются из потока стандартного ввода. +В случае, если в качестве +.I входного_файла +используется символ +.RB \` \- ', +источником данных также выступает поток стандартного ввода. +В том случае, если не указан +.I выходной_файл +(или вместо него используется символ +.RB \` \- ' +), результат преобразования направляется в поток стандартного вывода. +.PP +Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не +проверяет более одной буквы ключа, если в этом ключе не используется параметр. +Пробелы между единственным символом ключа и соответствующим параметром не являются +обязательными. Параметры ключей могут быть заданы с использованием десятичного, +шестнадцатеричного или восьмеричного формата. +Таким образом, ключи +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +и +.B \-cols 8 +являются равнозначными. +.PP +.TP +.IR \-a " | " \-autoskip +Включает автоматический пропуск: вместо последовательности +нулевых строк используется одиночный символ '*'. По умолчанию +не применяется. +.TP +.IR \-b " | " \-bits +Вместо шестнадцатеричного кода используются биты (двоичные цифры). +При использовании этого ключа вместо обычного шестнадцатеричного представления +октетов используются наборы из восьми символов "1" и "0". Каждая строка +предваряется номером строки в шестнадцатеричном виде, а завершается символьным +представлением (в виде ascii или ebcdic). Ключи \-r, \-p, \-i в этом режиме +не работают. +.TP +.IR "\-c кол " | " \-cols кол" +Задаёт количество октетов +.RI < кол >, +которое выводится на каждой строке. По умолчанию используется значение 16 +(\-i: 12, \-ps: 30, \-b: 6). +Максимально допустимое значение: 256. +.TP +.IR \-E " | " \-EBCDIC +Изменяет способ кодирования символов в правой колонке с ASCII на EBCDIC. Этот ключ +не изменяет шестнадцатеричное представление. Данный ключ не имеет смысла, +если используются ключи \-r, \-p или \-i. +.TP +.IR "\-g байт " | " \-groupsize байт" +Позволяет выполнять группировку указанного количества +.RI < байтов > +(две шестнадцатеричные цифры или восемь битов), отделяя группы друг от друга пробелами. +Значение +.I \-g 0 +применяется для отказа от использования группировки. +По умолчанию используется значение +.RI < байт "> равное " 2 +в обычном режиме и \fI1\fP в битовом режиме. Группировка не применяется +в режимах postscript и include. +.TP +.IR \-h " | " \-help +Выводит справку по доступным ключам командной строки и завершает работу программы. +Создание шестнадцатеричного представления не выполняется. +.TP +.IR \-i " | " \-include +Позволяет создавать вывод в стиле подключаемых заголовочных файлов языка C. +Вывод содержит полноценное определение статического массива данных, имя которого +соответствует имени входного файла, если xxd не считывает данные из потока стандартного +ввода. +.TP +.IR "\-l длина " | " \-len длина" +Завершает работу после записи заданного в параметре +.RI < длина > +количества октетов. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +Использует непрерывный формат вывода шестнадцатеричного кода, +известный как "простой" стиль или стиль "postscript". +.TP +.IR \-r " | " \-revert +Изменяет смысл операции на противоположный: позволяет выполнять преобразование +шестнадцатеричного представления в бинарный код (или применять результат в качестве заплаты). +Если вывод происходит не в поток стандартного вывода, то xxd выполняет добавление кода +к соответствующему файлу. При использовании комбинации ключей +.I \-r \-p +происходит чтение "простого" шестнадцатеричного представления без использования +информации о номерах строк и какого-либо специального раскроя колонок. Пробелы +и символы новой строки могут встречаться в любом месте исходных данных. +.TP +.I \-seek смещение +При использовании после ключа +.I \-r +: добавлять указанное +.RI < смещение > +к файловым позициям, обнаруженным в исходных данных. +.TP +.I \-s [\+][\-]seek +Начинает работу с указанного абсолютного (или относительного) +.RI < смещения > +в байтах во входном_файле. +\fI\+ \fRуказывает, что смещение является относительным по отношению +к текущей файловой позиции в потоке стандартного ввода (бессмысленно, если чтение +происходит не из потока стандартного ввода). \fI\- \fRуказывает, что должно быть прочитано +указанное количество символов от конца ввода (либо, если сочетается с \fI \+ \fR: +перед текущей позиции файла в потоке стандартного ввода). +Если ключ \-s не используется, то xxd начинает работу от текущей позиции в файле. +.TP +.I \-u +Использует шестнадцатеричные цифры в верхнем регистре. По умолчанию используются цифры в +нижнем регистре символов. +.TP +.IR \-v " | " \-version +Отображает информацию о версии программы. +.SH ПОДВОДНЫЕ КАМНИ +.PP +.I xxd \-r +обладает встроенным интеллектом для распознавания информации о номерах строк. +Если возможен поиск по входному файлу, то номера строк в начале каждой строки +шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут +быть пропущены или пересекаться друг с другом. В этих случаях xxd использует +lseek(2) для перехода к следующей позиции. Если поиск по входному файлу +невозможен, то допустимы только пропуски строк, которые заполняются нулевыми +байтами. +.PP +.I xxd \-r +никогда не выводит сообщений об ошибках. Мусор пропускается молча. +.PP +При редактировании шестнадцатеричных представлений бинарных файлов обращайте +внимание, что +.I xxd \-r +пропускает в строке ввода любые данные после прочтения достаточного количества +колонок шестнадцатеричных данных (см. ключ \-c). Это означает, что изменения, +внесенные в колонки с печатными символами ascii (или ebcdic), всегда игнорируются. +При обратном преобразовании шестнадцатеричного представления в стиле +postscript с помощью команды xxd \-r \-p количество колонок не учитывается. +В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр. +.PP +Обратите внимание на различие между командами +.PP +\fI% xxd \-i файл\fR +.PP +и +.PP +\fI% xxd \-i \< файл\fR +.PP +Команда +.I xxd \-s \+seek +может отличаться от +.I xxd \-s seek, +поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов lseek(2). +При использовании `+' поведение будет отличаться, если входные данные +поступают с потока стандартного ввода, а позиция в файле стандартного ввода не находится +в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода. +Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию... +.PP +Отмотка назад потока стандартного ввода; необходимо, поскольку 'cat' уже выполнила +чтение до конца потока стандартного ввода: +.PP +\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x480 +(= 1024+128). +Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется +к первому килобайту, где завершает работу dd: +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x100 +(= 1024-768): +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +.PP +В то же время, следует заметить, что подобные ситуации встречаются довольно редко, +так что символ `+' обычно не используется. Автор предпочитает наблюдать за работой +xxd с помощью strace(1) или truss(1) в тех случаях, когда применяется ключ +\-s. +.SH ПРИМЕРЫ +.PP +.br +Вывести всё, кроме первых трёх строк (0x30 байтов) файла +.B file +: +.PP +\fI% xxd \-s 0x30 file +.PP +.br +Вывести три строки (0x30 байтов) от конца файла +.B file +: +.PP +\fI% xxd \-s \-0x30 file +.PP +.br +Вывести 120 байтов в виде непрерывного шестнадцатеричного представления +по 40 октетов в строке: +.PP +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e544820585844203120224d616e75616c207061 +.br +676520666f7220787864220a2e5c220a2e5c2220 +.br +32317374204d617920313939360a2e5c22204d61 +.br +6e207061676520617574686f723a0a2e5c222020 +.br +2020546f6e79204e7567656e74203c746f6e7940 +.br +7363746e7567656e2e7070702e67752e6564752e +.br +.PP +.br +Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке: +.PP +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +.br +000000c: 616e 7561 6c20 7061 6765 2066 anual page f +.br +0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +.br +0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +.br +0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +.br +000003c: 6e20 7061 6765 2061 7574 686f n page autho +.br +0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +.br +0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +.br +0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +.br +000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +.PP +.br +Показать дату из файла xxd.1: +.PP +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +.PP +.br +Скопировать +.B входной_файл +в +.B выходной_файл +с добавлением 100 байтов со значением 0x00 в начало файла: +.PP +\fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR +.br +.PP +.br +Заменить дату в файле xxd.1: +.PP +\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3235 7468 204d 6179 2031 3939 25th May 199 +.PP +.br +Создать 65537-байтный файл, все байты которого имеют значение +0x00, кроме последнего байта, который должен иметь значение 'A' +(0x41): +.PP +\fI% echo '010000: 41' | xxd \-r \> file\fR +.PP +.br +Создать шестнадцатеричное представление этого файла с +использованием автоматического пропуска: +.PP +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Создать 1-байтный файл, содержащий символ 'A'. +Число после '\-r \-s' добавляется к номерам строк, найденным в файле; +иначе говоря, предшествующие байты пропускаются: +.PP +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +.PP +xxd можно использовать в качестве фильтра в редакторе, например в +.B vim(1), +чтобы создать шестнадцатеричное представление области между +отметками `a' и `z': +.PP +\fI:'a,'z!xxd\fR +.PP +Вы можете использовать xxd в качестве фильтра в редакторе, например в +.B vim(1), +для восстановления данных из шестнадцатеричного представления +между отметками `a' и `z': +.PP +\fI:'a,'z!xxd \-r\fR +.PP +Вы можете использовать xxd в качестве фильтра в редакторе, например в +.B vim(1), +для восстановления данных из единственной строки +шестнадцатеричного представления. Поместите курсор в соответствующую строку +и наберите +.PP +\fI!!xxd \-r\fR +.PP +Чтобы прочитать единственный символ из канала связи: +.PP +\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 ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ +Программа xxd завершает работу со следующими значениями: +.TP +0 +Ошибки не обнаружены. +.TP +\-1 +Операция не поддерживается (выполнение +.I xxd \-r \-i +пока невозможно). +.TP +1 +Ошибка при разборе ключей командной строки. +.TP +2 +Проблемы во входном файле. +.TP +3 +Проблемы в выходном файле. +.TP +4,5 +Желательная позиция поиска недостижима. +.SH СМОТРИ ТАКЖЕ +uuencode(1), uudecode(1), patch(1) +.br +.SH ПРЕДУПРЕЖДЕНИЕ +Странность этой программы соответствует особенностям мозга её создателя. +Используйте её на свой страх и риск. Копируйте файлы, отслеживайте +вызовы, становитесь волшебником. +.br +.SH ВЕРСИЯ +Эта страница справочника документирует xxd версии 1.7. +.SH АВТОР +.br +(c) 1990-1997 Юрген Вайгерт (Juergen Weigert) +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Вы можете свободно распространять программу со ссылкой на меня. +.br +Если использование этой программы принесло вам какой-то доход, +поделитесь со мной. +.br +Если вы потеряли деньги, то я тут не причём. +.PP +Первый вариант страницы справочника написан Тони Наджентом (Tony Nugent) +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Небольшие изменения внесены Брамом Мооленааром (Bram Moolenaar). +Страница отредактирована Юргеном Вайгертом (Juergen Weigert). +.PP |