diff options
| -rw-r--r-- | .gitignore | 8 | ||||
| -rw-r--r-- | runtime/doc/Makefile | 212 | ||||
| -rw-r--r-- | runtime/doc/eval.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/evim-fr.1 | 57 | ||||
| -rwxr-xr-x | runtime/doc/evim-it.1 | 54 | ||||
| -rw-r--r-- | runtime/doc/evim-pl.1 | 53 | ||||
| -rw-r--r-- | runtime/doc/evim-ru.1 | 59 | ||||
| -rw-r--r-- | runtime/doc/index.txt | 1 | ||||
| -rw-r--r-- | runtime/doc/makehtml.awk | 7 | ||||
| -rw-r--r-- | runtime/doc/manpages/de/vim-de.1 (renamed from runtime/doc/vim-de.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/evim.1 (renamed from runtime/doc/evim.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/fr/evim-fr.1 (renamed from runtime/doc/evim-fr.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/fr/vim-fr.1 (renamed from runtime/doc/vim-fr.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/fr/vimdiff-fr.1 (renamed from runtime/doc/vimdiff-fr.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/fr/vimtutor-fr.1 (renamed from runtime/doc/vimtutor-fr.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/fr/xxd-fr.1 (renamed from runtime/doc/xxd-fr.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/it/evim-it.1 (renamed from runtime/doc/evim-it.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/it/vim-it.1 (renamed from runtime/doc/vim-it.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/it/vimdiff-it.1 (renamed from runtime/doc/vimdiff-it.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/it/vimtutor-it.1 (renamed from runtime/doc/vimtutor-it.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/it/xxd-it.1 (renamed from runtime/doc/xxd-it.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ja/evim-ja.1 (renamed from runtime/doc/evim-ja.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ja/vim-ja.1 (renamed from runtime/doc/vim-ja.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ja/vimdiff-ja.1 (renamed from runtime/doc/vimdiff-ja.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ja/vimtutor-ja.1 (renamed from runtime/doc/vimtutor-ja.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ja/xxd-ja.1 (renamed from runtime/doc/xxd-ja.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/pl/evim-pl.1 (renamed from runtime/doc/evim-pl.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/pl/vim-pl.1 (renamed from runtime/doc/vim-pl.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/pl/vimdiff-pl.1 (renamed from runtime/doc/vimdiff-pl.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/pl/vimtutor-pl.1 (renamed from runtime/doc/vimtutor-pl.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/pl/xxd-pl.1 (renamed from runtime/doc/xxd-pl.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ru/evim-ru.1 (renamed from runtime/doc/evim-ru.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ru/vim-ru.1 (renamed from runtime/doc/vim-ru.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ru/vimdiff-ru.1 (renamed from runtime/doc/vimdiff-ru.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ru/vimtutor-ru.1 (renamed from runtime/doc/vimtutor-ru.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/ru/xxd-ru.1 (renamed from runtime/doc/xxd-ru.UTF-8.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/vim.1 (renamed from runtime/doc/vim.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/vimdiff.1 (renamed from runtime/doc/vimdiff.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/vimtutor.1 (renamed from runtime/doc/vimtutor.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/manpages/xxd.1 (renamed from runtime/doc/xxd.1) | 0 | ||||
| -rw-r--r-- | runtime/doc/message.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/os_390.txt | 1 | ||||
| -rw-r--r-- | runtime/doc/various.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/vim-de.1 | 478 | ||||
| -rw-r--r-- | runtime/doc/vim-fr.1 | 589 | ||||
| -rwxr-xr-x | runtime/doc/vim-it.1 | 566 | ||||
| -rw-r--r-- | runtime/doc/vim-pl.1 | 558 | ||||
| -rw-r--r-- | runtime/doc/vim-ru.1 | 489 | ||||
| -rw-r--r-- | runtime/doc/vim.man | 428 | ||||
| -rw-r--r-- | runtime/doc/vimdiff-fr.1 | 54 | ||||
| -rwxr-xr-x | runtime/doc/vimdiff-it.1 | 48 | ||||
| -rw-r--r-- | runtime/doc/vimdiff-pl.1 | 46 | ||||
| -rw-r--r-- | runtime/doc/vimdiff-ru.1 | 50 | ||||
| -rw-r--r-- | runtime/doc/vimdiff.man | 46 | ||||
| -rw-r--r-- | runtime/doc/vimtutor-fr.1 | 60 | ||||
| -rwxr-xr-x | runtime/doc/vimtutor-it.1 | 58 | ||||
| -rw-r--r-- | runtime/doc/vimtutor-pl.1 | 51 | ||||
| -rw-r--r-- | runtime/doc/vimtutor-ru.1 | 51 | ||||
| -rw-r--r-- | runtime/doc/vimtutor.man | 50 | ||||
| -rw-r--r-- | runtime/doc/xxd-fr.1 | 396 | ||||
| -rwxr-xr-x | runtime/doc/xxd-it.1 | 402 | ||||
| -rw-r--r-- | runtime/doc/xxd-pl.1 | 389 | ||||
| -rw-r--r-- | runtime/doc/xxd-ru.1 | 408 | ||||
| -rw-r--r-- | runtime/doc/xxd.man | 262 |
64 files changed, 67 insertions, 5870 deletions
diff --git a/.gitignore b/.gitignore index 4a6bbfec0f..5332ef5c76 100644 --- a/.gitignore +++ b/.gitignore @@ -54,3 +54,11 @@ # local make targets local.mk +# runtime/doc +/runtime/doc/*.html +/runtime/doc/**/*.man +/runtime/doc/tags +/runtime/doc/tags.ref +/runtime/doc/doctags +/runtime/doc/errors.log + diff --git a/runtime/doc/Makefile b/runtime/doc/Makefile index 8bd5aaf049..16ce4d9082 100644 --- a/runtime/doc/Makefile +++ b/runtime/doc/Makefile @@ -9,10 +9,6 @@ AWK = awk # Set to $(VIMTARGET) when executed from src/Makefile. VIMEXE = vim -# include the config.mk from the source directory. It's only needed to set -# AWK, used for "make html". Comment this out if the include gives problems. -include ../../src/auto/config.mk - DOCS = \ arabic.txt \ autocmd.txt \ @@ -34,7 +30,6 @@ DOCS = \ gui_w16.txt \ gui_w32.txt \ gui_x11.txt \ - hangulin.txt \ hebrew.txt \ help.txt \ helphelp.txt \ @@ -52,12 +47,17 @@ DOCS = \ index.txt \ insert.txt \ intro.txt \ + job_control.txt \ map.txt \ mbyte.txt \ message.txt \ mlang.txt \ motion.txt \ + msgpack_rpc.txt \ netbeans.txt \ + nvim_clipboard.txt \ + nvim_intro.txt \ + nvim_python.txt \ options.txt \ os_390.txt \ os_amiga.txt \ @@ -162,7 +162,6 @@ HTMLS = \ gui_w16.html \ gui_w32.html \ gui_x11.html \ - hangulin.html \ hebrew.html \ helphelp.html \ howto.html \ @@ -179,12 +178,17 @@ HTMLS = \ index.html \ insert.html \ intro.html \ + job_control.html \ map.html \ mbyte.html \ message.html \ mlang.html \ motion.html \ + msgpack_rpc.html \ netbeans.html \ + nvim_clipboard.html \ + nvim_intro.html \ + nvim_python.html \ options.html \ os_390.html \ os_amiga.html \ @@ -270,32 +274,43 @@ HTMLS = \ windows.html \ workshop.html -CONVERTED = \ - vim-fr.UTF-8.1 \ - evim-fr.UTF-8.1 \ - vimdiff-fr.UTF-8.1 \ - vimtutor-fr.UTF-8.1 \ - xxd-fr.UTF-8.1 \ - vim-it.UTF-8.1 \ - evim-it.UTF-8.1 \ - vimdiff-it.UTF-8.1 \ - vimtutor-it.UTF-8.1 \ - xxd-it.UTF-8.1 \ - vim-pl.UTF-8.1 \ - evim-pl.UTF-8.1 \ - vimdiff-pl.UTF-8.1 \ - vimtutor-pl.UTF-8.1 \ - xxd-pl.UTF-8.1 \ - vim-ru.UTF-8.1 \ - evim-ru.UTF-8.1 \ - vimdiff-ru.UTF-8.1 \ - vimtutor-ru.UTF-8.1 \ - xxd-ru.UTF-8.1 +MANPAGES = \ + manpages/vim.man \ + manpages/evim.man \ + manpages/vimdiff.man \ + manpages/vimtutor.man \ + manpages/xxd.man \ + manpages/de/vim-de.man \ + manpages/fr/vim-fr.man \ + manpages/fr/evim-fr.man \ + manpages/fr/vimdiff-fr.man \ + manpages/fr/vimtutor-fr.man \ + manpages/fr/xxd-fr.man \ + manpages/pl/vim-pl.man \ + manpages/pl/evim-pl.man \ + manpages/pl/vimdiff-pl.man \ + manpages/pl/vimtutor-pl.man \ + manpages/pl/xxd-pl.man \ + manpages/it/vim-it.man \ + manpages/it/evim-it.man \ + manpages/it/vimdiff-it.man \ + manpages/it/vimtutor-it.man \ + manpages/it/xxd-it.man \ + manpages/ru/vim-ru.man \ + manpages/ru/evim-ru.man \ + manpages/ru/vimdiff-ru.man \ + manpages/ru/vimtutor-ru.man \ + manpages/ru/xxd-ru.man \ + manpages/ja/vim-ja.man \ + manpages/ja/evim-ja.man \ + manpages/ja/vimdiff-ja.man \ + manpages/ja/vimtutor-ja.man \ + manpages/ja/xxd-ja.man .SUFFIXES: -.SUFFIXES: .c .o .txt .html +.SUFFIXES: .c .o .txt .html .1 .man -all: tags vim.man evim.man vimdiff.man vimtutor.man xxd.man $(CONVERTED) +all: tags manpages html # Use Vim to generate the tags file. Can only be used when Vim has been # compiled and installed. Supports multiple languages. @@ -310,28 +325,15 @@ tags: doctags $(DOCS) doctags: doctags.c $(CC) doctags.c -o doctags -vim.man: vim.1 - nroff -man vim.1 | sed -e s/.//g > vim.man - -evim.man: evim.1 - nroff -man evim.1 | sed -e s/.//g > evim.man - -vimdiff.man: vimdiff.1 - nroff -man vimdiff.1 | sed -e s/.//g > vimdiff.man +manpages: $(MANPAGES) -vimtutor.man: vimtutor.1 - nroff -man vimtutor.1 | sed -e s/.//g > vimtutor.man - -xxd.man: xxd.1 - nroff -man xxd.1 | sed -e s/.//g > xxd.man - -uganda.nsis.txt: uganda.txt - sed -e 's/[ ]*\*[-a-zA-Z0-9.]*\*//g' -e 's/vim:tw=78://' \ - uganda.txt | uniq >uganda.nsis.txt +# OSX groff dosn't support utf-8 as input encoding, so this won't work there. +.1.man: + groff -k -mandoc -Tutf8 $< | sed -e s/.^H//g > $@ # Awk version of .txt to .html conversion. html: noerrors tags $(HTMLS) - @if test -f errors.log; then more errors.log; fi + @if test -f errors.log; then cat errors.log; fi noerrors: -rm -f errors.log @@ -359,119 +361,5 @@ perlhtml: tags $(DOCS) ./vim2html.pl tags $(DOCS) clean: - -rm doctags *.html tags.ref - -# These files are in the extra archive, skip if not present - -arabic.txt: - touch arabic.txt - -farsi.txt: - touch farsi.txt - -hebrew.txt: - touch hebrew.txt - -russian.txt: - touch russian.txt - -gui_w16.txt: - touch gui_w16.txt - -gui_w32.txt: - touch gui_w32.txt - -if_ole.txt: - touch if_ole.txt - -os_390.txt: - touch os_390.txt - -os_amiga.txt: - touch os_amiga.txt - -os_beos.txt: - touch os_beos.txt - -os_dos.txt: - touch os_dos.txt - -os_mac.txt: - touch os_mac.txt - -os_mint.txt: - touch os_mint.txt - -os_os2.txt: - touch os_os2.txt - -os_qnx.txt: - touch os_qnx.txt - -os_risc.txt: - touch os_risc.txt - -os_win32.txt: - touch os_win32.txt - -# Note that $< works with GNU make while $> works for BSD make. -# Is there a solution that works for both?? -vim-fr.UTF-8.1: vim-fr.1 - iconv -f latin1 -t utf-8 $< >$@ - -evim-fr.UTF-8.1: evim-fr.1 - iconv -f latin1 -t utf-8 $< >$@ - -vimdiff-fr.UTF-8.1: vimdiff-fr.1 - iconv -f latin1 -t utf-8 $< >$@ - -vimtutor-fr.UTF-8.1: vimtutor-fr.1 - iconv -f latin1 -t utf-8 $< >$@ - -xxd-fr.UTF-8.1: xxd-fr.1 - iconv -f latin1 -t utf-8 $< >$@ - -vim-it.UTF-8.1: vim-it.1 - iconv -f latin1 -t utf-8 $< >$@ - -evim-it.UTF-8.1: evim-it.1 - iconv -f latin1 -t utf-8 $< >$@ - -vimdiff-it.UTF-8.1: vimdiff-it.1 - iconv -f latin1 -t utf-8 $< >$@ - -vimtutor-it.UTF-8.1: vimtutor-it.1 - iconv -f latin1 -t utf-8 $< >$@ - -xxd-it.UTF-8.1: xxd-it.1 - iconv -f latin1 -t utf-8 $< >$@ - -vim-pl.UTF-8.1: vim-pl.1 - iconv -f latin2 -t utf-8 $< >$@ - -evim-pl.UTF-8.1: evim-pl.1 - iconv -f latin2 -t utf-8 $< >$@ - -vimdiff-pl.UTF-8.1: vimdiff-pl.1 - iconv -f latin2 -t utf-8 $< >$@ - -vimtutor-pl.UTF-8.1: vimtutor-pl.1 - iconv -f latin2 -t utf-8 $< >$@ - -xxd-pl.UTF-8.1: xxd-pl.1 - iconv -f latin2 -t utf-8 $< >$@ - -vim-ru.UTF-8.1: vim-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ - -evim-ru.UTF-8.1: evim-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ - -vimdiff-ru.UTF-8.1: vimdiff-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ - -vimtutor-ru.UTF-8.1: vimtutor-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ + -rm -f doctags *.html tags.ref $(MANPAGES) $(HTMLS) errors.log -xxd-ru.UTF-8.1: xxd-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index ec2086e3eb..5953648148 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -6714,7 +6714,7 @@ gui_photon Compiled with Photon GUI. gui_running Vim is running in the GUI, or it will start soon. gui_win32 Compiled with MS Windows Win32 GUI. gui_win32s idem, and Win32s system being used (Windows 3.1) -hangul_input Compiled with Hangul input support. |hangul| +hangul_input Compiled with Hangul input support. iconv Can use iconv() for conversion. insert_expand Compiled with support for CTRL-X expansion commands in Insert mode. diff --git a/runtime/doc/evim-fr.1 b/runtime/doc/evim-fr.1 deleted file mode 100644 index 898ed70c2a..0000000000 --- a/runtime/doc/evim-fr.1 +++ /dev/null @@ -1,57 +0,0 @@ -.TH EVIM 1 "16 fИvrier 2002" -.SH NAME -evim \- ╚ Easy Vim ╩, Иdite un fichier avec Vim sans utiliser les modes -.SH SYNOPSIS -.br -.B evim -[options] [fichier ...] -.br -.B eview -.SH DESCRIPTION -.B eVim -lance -.B Vim -et configure ses options afin qu'il se comporte comme un Иditeur sans mode. -Cela reste Vim, mais vous pouvez l'utiliser comme un Иditeur ╚ cliquer-taper ╩. -Cela ressemble beaucoup Ю l'Иdition avec Notepad sur MS-Windows. -.B eVim -ne fonctionne qu'avec l'interface graphique, qui est nИcessaire pour permettre -l'utilisation des menus et de la barre d'outils. -.PP -Il n'est utile qu'aux personnes qui ne parviennent vraiment pas Ю utiliser Vim -de faГon traditionnelle. L'Иdition est alors bien moins efficace. -.PP -.B eview -fait la mЙme chose, mais dИmarre Vim en mode Lecture-seule. -Cela revient Ю lancer evim \-R. -.PP -Voir vim(1) pour davantage d'informations sur Vim, les options, etc. -.PP -L'option 'insertmode' est activИe pour permettre de taper directement du texte. -.br -Les mappages sont configurИs pour que Copier et Coller fonctionnent avec les -raccourcis habituels de MS-Windows. CTRL-X coupe le texte, CTRL-C copie le -texte et CTRL-V colle le texte. -Vous pouvez utiliser CTRL-Q pour obtenir la fonction originale de CTRL-V. -.SH OPTIONS -Voir vim(1). -.SH FICHIERS -.TP 15 -/usr/local/lib/vim/evim.vim -Le script chargИ pour initialiser eVim. -.SH AUSSI CONNU SOUS -иgalement connu sous le nom ╚ Vim pour gumbies ╩ [N.D.T. : Flying Circus...]. -Quand vous utilisez eVim, vous Йtes censИ prendre un mouchoir de poche, -faire un noeud Ю chaque coin et le porter sur votre tЙte. -.SH VOIR AUSSI -vim(1) -.SH AUTEUR -La majeure partie de -.B Vim -a ИtИ Иcrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. -Voir le menu Aide/Remerciements ou ":help credits" dans -.B Vim. -.SH TRADUCTION -Cette page de manuel a ИtИ traduite David Blanchet. -<david.blanchet@free.fr> 2005-03-26. -Mise Ю jour 2013-05-10, Dominique PellИ <dominique.pelle@gmail.com> diff --git a/runtime/doc/evim-it.1 b/runtime/doc/evim-it.1 deleted file mode 100755 index 1e98a2d3f7..0000000000 --- a/runtime/doc/evim-it.1 +++ /dev/null @@ -1,54 +0,0 @@ -.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 menЫ e barra -strumenti. -.PP -Da usarsi soltanto se non si Х 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 che si otterrebbe 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 menЫ "Aiuto/Crediti". diff --git a/runtime/doc/evim-pl.1 b/runtime/doc/evim-pl.1 deleted file mode 100644 index 490ee3a7ce..0000000000 --- a/runtime/doc/evim-pl.1 +++ /dev/null @@ -1,53 +0,0 @@ -.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 stylu 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 mog╠ 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, CTRL-C kopiuje a CTRL-V -wkleja tekst. U©yj CTRL-Q by uzyskaФ oryginalne przeznaczenie -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-ru.1 b/runtime/doc/evim-ru.1 deleted file mode 100644 index 6d6f5debf3..0000000000 --- a/runtime/doc/evim-ru.1 +++ /dev/null @@ -1,59 +0,0 @@ -.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/index.txt b/runtime/doc/index.txt index cda17681fd..a9e884777e 100644 --- a/runtime/doc/index.txt +++ b/runtime/doc/index.txt @@ -34,7 +34,6 @@ tag char action in Insert mode ~ |i_CTRL-@| CTRL-@ insert previously inserted text and stop insert |i_CTRL-A| CTRL-A insert previously inserted text - CTRL-B not used |i_CTRL-B-gone| |i_CTRL-C| CTRL-C quit insert mode, without checking for abbreviation, unless 'insertmode' set. |i_CTRL-D| CTRL-D delete one shiftwidth of indent in the current diff --git a/runtime/doc/makehtml.awk b/runtime/doc/makehtml.awk index 5e40069391..a1f77f5aba 100644 --- a/runtime/doc/makehtml.awk +++ b/runtime/doc/makehtml.awk @@ -6,6 +6,13 @@ BEGIN { sample="no"; while ( getline ti <"tags.ref" > 0 ) { nf=split(ti,tag," "); + # as help.txt renders into index.html and index.txt -> vimindex.html, + # this hack is needed to get the links right to those pages. + if ( tag[2] == "index.txt" ) { + tag[2] = "vimindex.txt" + } else if ( tag[2] == "help.txt" ) { + tag[2] = "index.txt" + } tagkey[tag[1]]="yes";tagref[tag[1]]=tag[2]; } skip_word["and"]="yes"; diff --git a/runtime/doc/vim-de.UTF-8.1 b/runtime/doc/manpages/de/vim-de.1 index f79e622a74..f79e622a74 100644 --- a/runtime/doc/vim-de.UTF-8.1 +++ b/runtime/doc/manpages/de/vim-de.1 diff --git a/runtime/doc/evim.1 b/runtime/doc/manpages/evim.1 index bb859ceada..bb859ceada 100644 --- a/runtime/doc/evim.1 +++ b/runtime/doc/manpages/evim.1 diff --git a/runtime/doc/evim-fr.UTF-8.1 b/runtime/doc/manpages/fr/evim-fr.1 index 2b38e66cb5..2b38e66cb5 100644 --- a/runtime/doc/evim-fr.UTF-8.1 +++ b/runtime/doc/manpages/fr/evim-fr.1 diff --git a/runtime/doc/vim-fr.UTF-8.1 b/runtime/doc/manpages/fr/vim-fr.1 index 67be106673..67be106673 100644 --- a/runtime/doc/vim-fr.UTF-8.1 +++ b/runtime/doc/manpages/fr/vim-fr.1 diff --git a/runtime/doc/vimdiff-fr.UTF-8.1 b/runtime/doc/manpages/fr/vimdiff-fr.1 index 3b44a3dd58..3b44a3dd58 100644 --- a/runtime/doc/vimdiff-fr.UTF-8.1 +++ b/runtime/doc/manpages/fr/vimdiff-fr.1 diff --git a/runtime/doc/vimtutor-fr.UTF-8.1 b/runtime/doc/manpages/fr/vimtutor-fr.1 index f47f840ec1..f47f840ec1 100644 --- a/runtime/doc/vimtutor-fr.UTF-8.1 +++ b/runtime/doc/manpages/fr/vimtutor-fr.1 diff --git a/runtime/doc/xxd-fr.UTF-8.1 b/runtime/doc/manpages/fr/xxd-fr.1 index 7956b3ba2a..7956b3ba2a 100644 --- a/runtime/doc/xxd-fr.UTF-8.1 +++ b/runtime/doc/manpages/fr/xxd-fr.1 diff --git a/runtime/doc/evim-it.UTF-8.1 b/runtime/doc/manpages/it/evim-it.1 index f96d0cb42c..f96d0cb42c 100644 --- a/runtime/doc/evim-it.UTF-8.1 +++ b/runtime/doc/manpages/it/evim-it.1 diff --git a/runtime/doc/vim-it.UTF-8.1 b/runtime/doc/manpages/it/vim-it.1 index 51e7e043da..51e7e043da 100644 --- a/runtime/doc/vim-it.UTF-8.1 +++ b/runtime/doc/manpages/it/vim-it.1 diff --git a/runtime/doc/vimdiff-it.UTF-8.1 b/runtime/doc/manpages/it/vimdiff-it.1 index 090892fa93..090892fa93 100644 --- a/runtime/doc/vimdiff-it.UTF-8.1 +++ b/runtime/doc/manpages/it/vimdiff-it.1 diff --git a/runtime/doc/vimtutor-it.UTF-8.1 b/runtime/doc/manpages/it/vimtutor-it.1 index a33dcb00b0..a33dcb00b0 100644 --- a/runtime/doc/vimtutor-it.UTF-8.1 +++ b/runtime/doc/manpages/it/vimtutor-it.1 diff --git a/runtime/doc/xxd-it.UTF-8.1 b/runtime/doc/manpages/it/xxd-it.1 index b6ccabd2e3..b6ccabd2e3 100644 --- a/runtime/doc/xxd-it.UTF-8.1 +++ b/runtime/doc/manpages/it/xxd-it.1 diff --git a/runtime/doc/evim-ja.UTF-8.1 b/runtime/doc/manpages/ja/evim-ja.1 index 1b7a657ebc..1b7a657ebc 100644 --- a/runtime/doc/evim-ja.UTF-8.1 +++ b/runtime/doc/manpages/ja/evim-ja.1 diff --git a/runtime/doc/vim-ja.UTF-8.1 b/runtime/doc/manpages/ja/vim-ja.1 index a4788b3c48..a4788b3c48 100644 --- a/runtime/doc/vim-ja.UTF-8.1 +++ b/runtime/doc/manpages/ja/vim-ja.1 diff --git a/runtime/doc/vimdiff-ja.UTF-8.1 b/runtime/doc/manpages/ja/vimdiff-ja.1 index 56fadfef6e..56fadfef6e 100644 --- a/runtime/doc/vimdiff-ja.UTF-8.1 +++ b/runtime/doc/manpages/ja/vimdiff-ja.1 diff --git a/runtime/doc/vimtutor-ja.UTF-8.1 b/runtime/doc/manpages/ja/vimtutor-ja.1 index 29b9b48f2c..29b9b48f2c 100644 --- a/runtime/doc/vimtutor-ja.UTF-8.1 +++ b/runtime/doc/manpages/ja/vimtutor-ja.1 diff --git a/runtime/doc/xxd-ja.UTF-8.1 b/runtime/doc/manpages/ja/xxd-ja.1 index 8a8d54b021..8a8d54b021 100644 --- a/runtime/doc/xxd-ja.UTF-8.1 +++ b/runtime/doc/manpages/ja/xxd-ja.1 diff --git a/runtime/doc/evim-pl.UTF-8.1 b/runtime/doc/manpages/pl/evim-pl.1 index 096a12add2..096a12add2 100644 --- a/runtime/doc/evim-pl.UTF-8.1 +++ b/runtime/doc/manpages/pl/evim-pl.1 diff --git a/runtime/doc/vim-pl.UTF-8.1 b/runtime/doc/manpages/pl/vim-pl.1 index f3551d2f63..f3551d2f63 100644 --- a/runtime/doc/vim-pl.UTF-8.1 +++ b/runtime/doc/manpages/pl/vim-pl.1 diff --git a/runtime/doc/vimdiff-pl.UTF-8.1 b/runtime/doc/manpages/pl/vimdiff-pl.1 index d66fdc9c03..d66fdc9c03 100644 --- a/runtime/doc/vimdiff-pl.UTF-8.1 +++ b/runtime/doc/manpages/pl/vimdiff-pl.1 diff --git a/runtime/doc/vimtutor-pl.UTF-8.1 b/runtime/doc/manpages/pl/vimtutor-pl.1 index 199fcd0e8f..199fcd0e8f 100644 --- a/runtime/doc/vimtutor-pl.UTF-8.1 +++ b/runtime/doc/manpages/pl/vimtutor-pl.1 diff --git a/runtime/doc/xxd-pl.UTF-8.1 b/runtime/doc/manpages/pl/xxd-pl.1 index e63ce64b74..e63ce64b74 100644 --- a/runtime/doc/xxd-pl.UTF-8.1 +++ b/runtime/doc/manpages/pl/xxd-pl.1 diff --git a/runtime/doc/evim-ru.UTF-8.1 b/runtime/doc/manpages/ru/evim-ru.1 index 581c364c22..581c364c22 100644 --- a/runtime/doc/evim-ru.UTF-8.1 +++ b/runtime/doc/manpages/ru/evim-ru.1 diff --git a/runtime/doc/vim-ru.UTF-8.1 b/runtime/doc/manpages/ru/vim-ru.1 index ef527213e3..ef527213e3 100644 --- a/runtime/doc/vim-ru.UTF-8.1 +++ b/runtime/doc/manpages/ru/vim-ru.1 diff --git a/runtime/doc/vimdiff-ru.UTF-8.1 b/runtime/doc/manpages/ru/vimdiff-ru.1 index 2f17e9c2e5..2f17e9c2e5 100644 --- a/runtime/doc/vimdiff-ru.UTF-8.1 +++ b/runtime/doc/manpages/ru/vimdiff-ru.1 diff --git a/runtime/doc/vimtutor-ru.UTF-8.1 b/runtime/doc/manpages/ru/vimtutor-ru.1 index 6b1ba90df0..6b1ba90df0 100644 --- a/runtime/doc/vimtutor-ru.UTF-8.1 +++ b/runtime/doc/manpages/ru/vimtutor-ru.1 diff --git a/runtime/doc/xxd-ru.UTF-8.1 b/runtime/doc/manpages/ru/xxd-ru.1 index 647845bab4..647845bab4 100644 --- a/runtime/doc/xxd-ru.UTF-8.1 +++ b/runtime/doc/manpages/ru/xxd-ru.1 diff --git a/runtime/doc/vim.1 b/runtime/doc/manpages/vim.1 index 820caa24f5..820caa24f5 100644 --- a/runtime/doc/vim.1 +++ b/runtime/doc/manpages/vim.1 diff --git a/runtime/doc/vimdiff.1 b/runtime/doc/manpages/vimdiff.1 index bed2b32889..bed2b32889 100644 --- a/runtime/doc/vimdiff.1 +++ b/runtime/doc/manpages/vimdiff.1 diff --git a/runtime/doc/vimtutor.1 b/runtime/doc/manpages/vimtutor.1 index 0aa7e8d8d9..0aa7e8d8d9 100644 --- a/runtime/doc/vimtutor.1 +++ b/runtime/doc/manpages/vimtutor.1 diff --git a/runtime/doc/xxd.1 b/runtime/doc/manpages/xxd.1 index e8f7358591..e8f7358591 100644 --- a/runtime/doc/xxd.1 +++ b/runtime/doc/manpages/xxd.1 diff --git a/runtime/doc/message.txt b/runtime/doc/message.txt index 84afe2f2b1..9365f39b2a 100644 --- a/runtime/doc/message.txt +++ b/runtime/doc/message.txt @@ -476,8 +476,6 @@ in memory, you can reduce that with these options: helps for a change that affects all lines. - 'undoreload' Set to zero to disable. -Also see |msdos-limitations|. - *E339* > Pattern too long diff --git a/runtime/doc/os_390.txt b/runtime/doc/os_390.txt index 5e564d8416..5501b8009b 100644 --- a/runtime/doc/os_390.txt +++ b/runtime/doc/os_390.txt @@ -103,7 +103,6 @@ Disabled at compile time: Never tested: - Perl interface (|perl|) - - Hangul input (|hangul|) - Encryption support (|encryption|) - Langmap (|'langmap'|) - Python support (|Python|) diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt index 2f1868e84e..a7050fa2e8 100644 --- a/runtime/doc/various.txt +++ b/runtime/doc/various.txt @@ -357,7 +357,7 @@ N *+gettext* message translations |multi-lang| *+GUI_GTK* Unix only: GTK+ |GUI| *+GUI_Motif* Unix only: Motif |GUI| *+GUI_Photon* QNX only: Photon |GUI| -m *+hangul_input* Hangul input support |hangul| +m *+hangul_input* Hangul input support hangul *+iconv* Compiled with the |iconv()| function *+iconv/dyn* Likewise |iconv-dynamic| |/dyn| N *+insert_expand* |insert_expand| Insert mode completion diff --git a/runtime/doc/vim-de.1 b/runtime/doc/vim-de.1 deleted file mode 100644 index 0ba4938f7a..0000000000 --- a/runtime/doc/vim-de.1 +++ /dev/null @@ -1,478 +0,0 @@ -.\"******************************************************************* -.\" -.\" This file was generated with po4a. Translate the source file. -.\" -.\"******************************************************************* -.\" Translated by bw1 (2008) and Florian Rehnisch <fm-r@gmx.de> (2012) -.\" Kudos to the folks on vim-dev and debian-l10n-german -.TH VIM 1 "2006 Apr 11" -.SH BEZEICHNUNG -vim \- Vi IMproved, ein Text\-Editor fЭr Programmierer -.SH эBERSICHT -.br -\fBvim\fP [Optionen] [Datei ...] -.br -\fBvim\fP [Optionen] \- -.br -\fBvim\fP [Optionen] \-t Tag -.br -\fBvim\fP [Optionen] \-q [Fehlerdatei] -.PP -.br -\fBex\fP -.br -\fBview\fP -.br -\fBgvim\fP \fBgview\fP \fBevim\fP \fBeview\fP -.br -\fBrvim\fP \fBrview\fP \fBrgvim\fP \fBrgview\fP -.SH BESCHREIBUNG -\fBVim\fP ist ein Text\-Editor, der aufwДrtskompatibel zu Vi ist. Er kann -verwendet werden, um alle Arten von Klartext zu bearbeiten. Er ist besonders -nЭtzlich, um Programme zu bearbeiten. -.PP -Vim hat einige Erweiterungen gegenЭber Vi, z.B.: RЭckgДngigmachen in -mehreren Schritten, mehrere Fenster und Puffer, Syntax\-Hervorhebung, -Bearbeiten der Befehlszeile, DateinamenergДnzung, eingebaute Hilfe, visuelle -Auswahl, usw. ... Siehe ╩:help vi_diff.txt╚ fЭr eine эbersicht der -Unterschiede zwischen \fBVim\fP und Vi. -.PP -Im laufenden \fBVim\fP kann mit dem Befehl ╩:help╚ viel Hilfe durch das -eingebaute Hilfesystem erlangt werden. Siehe den Abschnitt EINGEBAUTE HILFE -weiter unten. -.PP -Meistens wird \fBVim\fP zum Editieren einer einzigen Datei mit dem folgende -Befehl gestartet: -.PP - vim Datei -.PP -Allgemeiner betrachtet, wird \fBVim\fP folgendermaъen gestartet: -.PP - vim [Optionen] [Dateiliste] -.PP -Bei einer fehlenden Dateiliste startet der Editor mit einem leeren -Puffer. Andernfalls werden nach den folgenden vier MЖglichkeiten eine oder -mehrere Dateien bearbeitet: -.TP 12 -Datei ... -Eine Liste von Dateinamen. Die erste Datei wird in den Puffer geladen und -zur aktuellen. Der Cursor wird auf der ersten Zeile des Puffers -platziert. Zu den anderen Dateien kann mit dem Befehl ╩:next╚ gelangt -werden. Falls einer der Dateinamen mit einem Bindestrich beginnt, stellen -Sie der Dateiliste ╩\-\-╚ voran. -.TP -\- -Die zu bearbeitende Datei wird von der Standardeingabe gelesen. Befehle -werden von der Standardfehlerausgabe gelesen, die ein Text\-Terminal sein -sollte. -.TP -\-t {Tag} -Die zu editierende Datei und die anfДngliche Cursor\-Position hДngen von -einem ╩Tag╚ ab, einer Art Sprungmarke. {Tag} wird in der Tag\-Datei -nachgeschlagen, die zugehЖrige Datei wird zur aktuellen und der zugehЖrige -Befehl wird ausgefЭhrt. Dies wird meistens fЭr Programme in der Sprache ╩C╚ -benutzt, wobei {Tag} ein Funktionsname sein kЖnnte. Die Wirkung dieses -Befehls ist, dass die Datei, die die Funktion enthДlt, als aktuelle im -Editor geЖffnet und angezeigt wird und der Cursor auf dem Beginn der -Funktion positioniert wird. Siehe ╩:help tag\-commands╚. -.TP -\-q [Fehlerdatei] -Startet im QuickFix\-Modus. Die Datei [Fehlerdatei] wird gelesen und der -erste Fehler wird angezeigt. Falls [Fehlerdatei] ausgelassen wird, wird der -Dateiname aus der Option 'errorfile' verwendet (bei AmigaOS ist dies -vorgabemДъig ╩AztecC.Err╚, sowie "errors.err╚ bei anderen). Weitere Fehler -kЖnnen mit dem ╩:cn╚\-Befehl angesprungen werden. Siehe ":help quickfix╚. -.PP -\fBVim\fP reagiert unterschiedlich auf den Namen, der verwendet wird, um Vim zu -starten (die ausfЭhrbare Datei kann dieselbe sein). -.TP 10 -vim -der ╩normale╚ Weg, alles ist standardmДъig -.TP -ex -Startet im Ex\-Modus. Mit dem Befehl ╩:vi╚ gelangt man in den normalen -Modus. Funktioniert auch mit dem Argument ╩\-e╚. -.TP -view -Startet im Nur\-Lesen\-Modus. Die Datei wird vor dem эberschreiben -geschЭtzt. Dasselbe wird mit dem Parameter ╩\-R╚ erreicht. -.TP -gvim gview -Die grafische Version: жffnet ein neues Fenster. Dasselbe wird mit dem -Parameter ╩\-g╚ erreicht. -.TP -evim eview -Die grafische Version im einfachen Modus: жffnet ein neues Fenster. Dasselbe -wird mit dem Parameter ╩\-y╚ erreicht. -.TP -rvim rview rgvim rgview -Wie die obigen, aber mit BeschrДnkungen: Es ist nicht mЖglich, Shell\-Befehle -aufzurufen oder mit Unterbrechung in eine Shell zurЭckzuspringen. Dasselbe -wird mit dem Parameter ╩\-Z╚ erreicht. -.SH OPTIONEN -Die Optionen kЖnnen in beliebiger Reihenfolge vor oder nach den Dateinamen -angegeben werden. Optionen ohne Parameter kЖnnen hinter einem einzigen -Bindestrich gruppiert werden. -.TP 12 -+[Nummer] -In der ersten Datei wird der Cursor auf die Zeile [Nummer] gesetzt. Falls -[Nummer] nicht angegeben wird, wird der Cursor in die letzte Zeile der Datei -gesetzt. -.TP -+/{Suchmuster} -In der ersten Datei wird der Cursor auf das erste Auftreten von {Suchmuster} -gesetzt. Siehe ╩:help search\-pattern╚. -.TP -+{Befehl} -.TP -\-c {Befehl} -{Befehl} wird nach dem Lesen der ersten Datei ausgefЭhrt. Als {Befehl} wird -ein Ex\-Befehl erwartet. Sind in {Befehl} Leerzeichen vorhanden, muss alles -in AnfЭhrungszeichen gesetzt werden (hДngt von der verwendeten Shell -ab). Beispiel: vim "+set si" main.c -.br -Anmerkung: Sie kЖnnen bis zu 10 ╩+╚\- oder "\-c╚\-Befehle verwenden. -.TP -\-S {Datei} -{Datei} wird nach dem Lesen der ersten Datei ausgefЭhrt. Dies entspricht ╩\-c -"source {Datei}"╚. {Datei} darf nicht mit einem Bindestrich (\-) -anfangen. Wenn kein Dateiname angegeben wird, wird ╩Session.vim╚ verwendet -(Funktioniert nur, wenn ╩\-S╚ als letzter Parameter steht). -.TP -\-\-cmd {Befehl} -Wie ╩\-c╚, aber dieser Befehl wird vor allen VimRC\-Dateien ausgefЭhrt. Sie -kЖnnen unabhДngig von den ╩\-c╚\-Befehlen bis zu 10 dieser Befehle verwenden. -.TP -\-A -Falls \fBVim\fP mit UnterstЭtzung fЭr das Schreiben von rechts nach links und -arabischer Tastaturbelegung compiliert wurde (ARABIC), startet dieser -Parameter den Modus fЭrs Arabische (:set arabic). Anderenfalls beendet sich -\fBVim\fP mit einer Fehlermeldung. -.TP -b -BinДrer Modus: Es werden einige Variablen gesetzt, sodass es mЖglich ist, -eine binДre oder ausfЭhrbare Datei zu bearbeiten. -.TP -\-C -Kompatibel: Setzt die Option 'compatible'. Das macht \fBVim\fP im Verhalten -sehr Дhnlich zu Vi, selbst wenn eine VimRC\-Datei existiert. -.TP -\-d -Startet im diff\-Modus. Es sollten zwei, drei oder vier Dateinamen als -Parameter Эbergeben werden. \fBVim\fP Жffnet sie alle und zeigt die -Unterschiede an. Arbeitet wie vimdiff(1). -.TP -\-d {GerДt} -жffnet das {GerДt}, um es als Terminal zu nutzen. Nur fЭr AmigaOS. Beispiel: -"\-d con:20/30/600/150". -.TP -D -Debug\-Modus: \fBVim\fP geht in den Debug\-Modus, wenn der erste Befehl in einem -Skript ausgefЭhrt wird. -.TP -\-e -Startet \fBVim\fP im Ex\-Modus, als wЭrde als ausfЭhrbare Datei ╩ex╚ aufgerufen. -.TP -\-E -Startet \fBVim\fP im erweiterten Ex\-Modus, als wЭrde die ausfЭhrbare Datei als -╩exim╚ aufgerufen. -.TP -\-f -Vordergrund: Bei der GUI\-Version erzeugt \fBVim\fP keinen neuen Prozess und -lЖst sich nicht von der Shell, in der er aufgerufen wurde. Bei AmigaOS wird -kein neues Fenster geЖffnet. Dieser Parameter wird benutzt, damit das -aufrufende Programm auf das Beenden des Bearbeitungssitzung wartet (z.B.: -mail). Bei AmigaOS funktionieren die Befehle ╩:sh╚ und ":!╚ nicht. -.TP -\-\-nofork -Vordergrund: Bei der GUI\-Version erzeugt \fBVim\fP keinen neuen Prozess und -lЖst sich nicht von der Shell, in der er aufgerufen wurde. -.TP -\-F -Wenn \fBVim\fP mit FKMAP\-UnterstЭtzung fЭr das Schreiben von rechts nach links -und Farsi\-Tastatur\-Belegung kompiliert wurde, startet Vim im Farsi\-Modus, -d.h. die Optionen 'fkmap' und 'rightleft' werden gesetzt. Andernfalls bricht -\fBVim\fP mit einer Fehlermeldung ab. -.TP -\-g -Falls \fBVim\fP mit GUI\-UnterstЭtzung kompiliert wurde, wird die GUI -aktiviert. Falls keine GUI\-UnterstЭtzung einkompiliert wurde, wird mit einer -Fehlermeldung abgebrochen. -.TP -\-h -Gibt eine kleine Hilfe fЭr die Befehlszeilenparameter aus. Danach beendet -sich \fBVim.\fP -.TP -\-H -HebrДisch\-Modus, falls \fBVim\fP mit RIGHTLEFT\-UnterstЭtzung fЭr das Schreiben -von rechts nach links und hebrДischer Tastaturbelegung kompiliert wurde, -werden die Optionen 'hkmap' und 'rightleft' gesetzt. Andernfalls beendet -sich \fBVim\fP mit einer Fehlermeldung. -.TP -\-i {VimInfo} -Wenn eine VimInfo\-Datei verwendet wird: Verwendet statt ╩~/.viminfo╚ die -angegebene Datei. Es ist auch mЖglich die Verwendung einer VimInfo\-Datei -durch Angabe des Dateinamen ╩NONE╚ zu verhindern, -.TP -\-L -dasselbe wie ╩\-r╚ -.TP -\-l -Lisp\-Modus. Aktiviert die Optionen 'lisp' und 'showmatch'. -.TP -\-m -Deaktiviert das VerДndern von Dateien, indem die Option 'write' gelЖscht -wird. Der Puffer kann verДndert werden, nur das Schreiben einer Datei ist -nicht mЖglich. -.TP -\-M -Keine VerДnderungen erlaubt: Die Optionen 'modifiable' und 'write' werden -gelЖscht, so dass дnderungen nicht erlaubt sind und Dateien nicht -geschrieben werden kЖnnen. Man beachte, dass diese Optionen ('modifiable', -\&'write') dennnoch nachtrДglich zum Erlauben von дnderungen gesetzt werden -kЖnnen. -.TP -\-N -Nicht\-kompatibler Modus: LЖscht die Option 'compatible'. Dies veranlasst -\fBVim\fP, sich ein wenig besser, aber weniger Vi\-kompatibel zu verhalten, -selbst wenn es keine VimRC\-Datei gibt. -.TP -\-n -Verwendet keine Auslagerungsdatei: Eine Wiederherstellung nach einem Absturz -ist nicht mЖglich. Auf einem langsamen Medium (Diskette) kann diese -Einstellung nЭtzlich sein. Kann auch mit ╩set uc=0╚ erreicht werden; kann -mit ╩set uc=200╚ aufgehoben werden. -.TP -\-nb -\fBVim\fP fungiert als Server fЭr NetBeans. Details siehe Dokumentation. -.TP -\-o[N] -жffnet [N] Fenster Эbereinander. Wenn keine Zahl angegeben wird, Жffne ein -Fenster pro Datei. -.TP -\-O[N] -жffnet [N] Fenster nebeneinander. Wenn keine Zahl angegeben wird, Жffne ein -Fenster pro Datei. -.TP -\-p[N] -жffnet [N] Reiterseiten. Wenn keine Zahl angegeben wird, Жffne eine -Reiterseite pro Datei. -.TP -\-R -Nur\-Lesen\-Modus: Die Option 'readonly' wird gesetzt. Der Puffer kann noch -bearbeitet werden, aber es wird verhindert, eine Datei aus Versehen zu -Эberschreiben. Wenn Sie wirklich eine Datei Эberschreiben wollen, fЭgen Sie -dem Ex\-Befehl ein Ausrufezeichen hinzu (wie in ╩:w!╚). Die Option "\-R╚ -bedingt die Option ╩\-n╚ (siehe oben). Die Option 'readonly' kann durch ":set -noro╚ gelЖscht werden. Siehe ╩:help 'readonly'╚. -.TP -\-r -Listet die Auslagerungsdateien und gibt Informationen zu ihrer -Verwendbarkeit zur Wiederherstellung. -.TP -\-r {Datei} -Wiederherstellungsmodus: Die Auslagerungsdatei wird zur Wiederherstellung -verwendet und hat denselben Dateinamen wie die Text\-Datei + ╩.swp╚. Siehe -":help recovery╚. -.TP -\-s -Der stille Modus: Nur wenn die ausfЭhrbare Datei als ╩ex╚ aufgerufen wird -oder vor ╩\-s╚ die Option "\-e╚ gegeben wird. -.TP -\-s {Eingabeskript} -Die Datei {Eingabeskript} wird gelesen und ausgefЭhrt, als wЭrden Sie die -Zeichen in ihr tippen. Dasselbe kann mit dem Befehl ╩:source! -{Eingabeskript}╚ erreicht werden. Wird das Ende der Datei vor dem Beenden -des Editors erreicht, werden weitere Zeichen von der Tastatur gelesen. -.TP -\-T {Terminal} -Setzt den Namen des benutzten Terminals. Nur erforderlich, wenn die -Automatik nicht funktioniert. Sollte ein \fBVim\fP bekanntes Terminal sein: -(builtin) oder in einer termcap\- oder terminfo\-Datei definiert. -.TP -\-u {VimRC} -Verwendet zur Initialisierung die Befehle in der Datei {VimRC}. Alle anderen -Initialisierungen werden Эbersprungen. Benutzen Sie dies, um eine besondere -Art von Dateien zu bearbeiten. Dies kann auch benutzt werden, um alle -Initialisierungen zu Эberspringen, indem der Name ╩NONE╚ angegeben wird. FЭr -weitere Einzelheiten siehe ╩:help initialisation╚ innerhalb von Vim. -.TP -\-U {GvimRC} -Benutzt die Befehle in der Datei {GvimRC} fЭr die Initialisierung der -grafischen OberflДche. Alle anderen Initialisierungen werden -Эbersprungen. Dies kann ebenfalls benutzt werden, um alle -GUI\-Initialisierungen zu Эberspringen, indem der Name ╩NONE╚ angegeben -wird. Siehe ╩:help gui\-init╚ innerhalb von Vim fЭr weitere Einzelheiten. -.TP -\-V[N] -AusfЭhrlich (verbose): Gibt Meldungen darЭber, welche Befehlsdateien -eingelesen werden, und Эber das Lesen und Schreiben einer VimInfo\-Datei. Die -optionale Zahl N ist der Wert fЭr 'verbose'. Vorgabe ist 10. -.TP -\-v -Startet \fBVim\fP im Vi\-Modus, so als wЭrde die ausfЭhrbare Datei mit ╩vi╚ -aufgerufen. Dies wirkt sich nur aus, wenn die ausfЭhrbare Datei als ╩ex╚ -aufgerufen wird. -.TP -\-w {Ausgabeskript} -Alle Zeichen, die eingetippt werden, werden in der Datei {Ausgabeskript} -aufgezeichnet, solange bis Sie \fBVim\fP beenden. Dies ist nЭtzlich, falls Sie -eine Skript\-Datei zum Benutzen mit ╩vim \-s╚ oder ":source!╚ erzeugen -wollen. Falls die Datei {Ausgabeskript} vorhanden ist, werden die Zeichen -angehДngt. -.TP -\-W {Ausgabeskript} -Wie \-w, aber eine bereits vorhandene Datei wird Эberschrieben. -.TP -\-x -Benutzt beim Schreiben von Dateien eine VerschlЭsselung. Fragt nach dem -SchlЭssel. -.TP -\-X -FЭhrt keine Verbindung zum X\-Server durch. Dadurch verkЭrzt sich die -Startzeit, aber der Fenstertitel und die Zwischenablage werden nicht -verwendet. -.TP -\-y -Startet \fBVim\fP im einfachen Modus, als wЭrde die ausfЭhrbare Datei mit -╩evim╚ oder ╩eview╚ aufgerufen. \fBVim\fP verhДlt sich dann wie ein Editor zum -Klicken und Tippen. -.TP -\-Z -EingeschrДnkter Modus: Funktioniert, als wЭrde der Name der ausfЭhrbaren -Datei mit ╩r╚ beginnen. -.TP -\-\- -Markiert das Ende der Optionen. Argumente, die folgen, werden als Dateinamen -behandelt. Dies kann benutzt werden, um einen Dateinamen mit ╩\-╚ am Anfang -zu verwenden. -.TP -\-\-echo\-wid -Nur GTK\-GUI: Schreibe die Fenster\-ID auf die Standardausgabe. -.TP -\-\-help -Gibt eine Hilfe\-Nachricht aus und beendet, wie ╩\-h╚. -.TP -\-\-literal -Nimmt die Dateinamen so wie sie sind und vervollstДndigt sie nicht nach -Metazeichen (*,?). Dies wirkt sich nicht unter Unix aus, wo die Shell die -Metazeichen expandiert. -.TP -\-\-noplugin -Lade keine Plugins. Impliziert durch ╩\-u NONE╚. -.TP -\-\-remote -Verbindet mit einem Vim\-Server und lДsst ihn die in den restlichen -Argumenten angegeben Dateien editieren. Wenn kein Server gefunden wird, -fЭhrt dies zu einer Warnmeldung und die Dateien werden im gegenwДrtigen Vim -zum Bearbeiten geЖffnet. -.TP -\-\-remote\-expr {Ausdruck} -Verbindet mit einem Vim\-Server, fЭhrt {Ausdruck} aus und zeigt das Ergebnis -auf der Standardausgabe an. -.TP -\-\-remote\-send {Zeichen} -Verbindet mit einem Vim\-Server und sendet ihm {Zeichen}. -.TP -\-\-remote\-silent -Wie ╩\-\-remote╚, aber ohne Warnung, wenn kein Server gefunden wird. -.TP -\-\-remote\-wait -Wie ╩\-\-remote╚, aber Vim beendet sich nicht, bis die Dateien bearbeitet -wurden. -.TP -\-\-remote\-wait\-silent -Wie ╩\-\-remote\-wait╚, aber ohne Warnung, wenn kein Server gefunden wird. -.TP -\-\-serverlist -Listet die Namen aller gefundenen Vim\-Server auf. -.TP -\-\-servername {Name} -Benutzt {Name} als Server\-Namen. Wird fЭr den gegenwДrtigen Vim benutzt, -auъer es wird mit dem Argument ╩\-\-remote╚ benutzt, dann ist es der Name des -zu kontaktierenden Servers. -.TP -\-\-socketid {id} -Nur GTK\-GUI: Benutzt den GtkPlug\-Mechanismus, um GVim in einem anderen -Fenster laufen zu lassen. -.TP -\-\-version -Versionsinformation anzeigen und beenden -.SH "EINGEBAUTE HILFE" -Tippen Sie in \fBVim\fP ╩:help╚, um zu beginnen. Geben Sie ":help begriff╚ ein, -um Hilfe Эber ein bestimmtes Thema zu bekommen. Zum Beispiel ╩:help ZZ╚ fЭr -Hilfe Эber den Befehl ╩ZZ╚. Benutzen Sie <Tab> und CTRL\-D, um -Begriffe zu vervollstДndigen (╩:help cmdline\-completion╚). Tags sind -vorhanden, um von einem Ort zum anderen zu springen (eine Art -Hypertext\-VerknЭpfungen, siehe ╩:help╚). Auf diese Weise kЖnnen alle -Dokumentations\-Dateien aufgerufen werden, zum Beispiel ╩:help syntax.txt╚. -.SH DATEIEN -.TP 15 -/usr/local/lib/vim/doc/*.txt -Dokumentations\-Dateien fЭr \fBVim\fP. Verwenden Sie ╩:help doc\-file\-list╚, um -die gesamte Liste zu bekommen. -.TP -/usr/local/lib/vim/doc/tags -Die ╩Tag╚\-Datei, die verwendet wird, um Informationen in der Dokumentation -zu finden. -.TP -/usr/local/lib/vim/syntax/syntax.vim -Die systemweite Einrichtung der Syntaxhervorhebung. -.TP -/usr/local/lib/vim/syntax/*.vim -Syntaxdateien fЭr die verschiedenen Sprachen. -.TP -/usr/local/lib/vim/vimrc -Systemweite Einstellungsdatei fЭr \fBVim\fP -.TP -~/.vimrc -PersЖnliche Einstellungsdatei fЭr \fBVim\fP -.TP -/usr/local/lib/vim/gvimrc -Systemweite Einstellungsdatei fЭr GVim -.TP -~/.gvimrc -PersЖnliche Einstellungsdatei fЭr GVim -.TP -/usr/local/lib/vim/optwin.vim -Das Script, das von dem Befehl ╩:options╚ verwendet wird, eine schЖne -MЖglichkeit, um Optionen zu betrachten und zu setzen. -.TP -/usr/local/lib/vim/menu.vim -Systemweite Einstellungsdatei fЭr das MenЭ von GVim -.TP -/usr/local/lib/vim/bugreport.vim -Das Script zum Generieren eines Fehlerberichts. Siehe ╩:help bugs╚. -.TP -/usr/local/lib/vim/filetype.vim -Mit diesem Script erkennt Vim den Typ einer Datei anhand ihres -Dateinamens. Siehe ╩:help 'filetype'╚. -.TP -/usr/local/lib/vim/scripts.vim -Mit diesem Script erkennt Vim den Typ einer Datei anhand ihres -Inhaltes. Siehe ╩:help 'filetype'╚. -.TP -/usr/local/lib/vim/print/*.ps -Diese Dateien werden zum Drucken von PostScript verwendet. -.PP -FЭr die neuesten Informationen lesen Sie die Vim\-Homepage: -.br -<URL:http://www.vim.org/> -.SH "SIEHE AUCH" -vimtutor(1) -.SH AUTOR -\fBVim\fP wurde grЖъtenteils von Bram Moolenaar erstellt, mit viel Hilfe von -anderen Leuten. Siehe ╩:help credits╚ in \fBVim.\fP -.br -\fBVim\fP basiert auf Stevie, der von Tim Thompson, Tony Andrews und -G.R. (Fred) Walter geschrieben wurde. Es ist jedoch kaum etwas vom -ursprЭnglichen Code Эbrig geblieben. -.SH FEHLER -Die sind mЖglich. Siehe ╩:help todo╚ fЭr eine Liste bekannter Probleme. -.PP -Beachten Sie, dass gewisse Dinge, die manche Leute als Fehler betrachten -mЖgen, in Wirklichkeit durch zu getreue Nachbildung des Vi\-Verhaltens -verursacht werden. Und falls Sie denken, dass andere Dinge Fehler sind, -╩weil Vi es anders tut╚, sollten Sie einen genaueren Blick auf die Datei -vi_diff.txt werfen (oder in Vim ╩:help vi_diff.txt╚ tippen). Sehen Sie sich -auch die Optionen 'compatible' und 'cpoptions' an. diff --git a/runtime/doc/vim-fr.1 b/runtime/doc/vim-fr.1 deleted file mode 100644 index 209ab915c9..0000000000 --- a/runtime/doc/vim-fr.1 +++ /dev/null @@ -1,589 +0,0 @@ -.\" Traduction lundi 7 aoШt 2000 par Richard Hitier -.\" (richard.hitier@dial.oleane.com) -.\" Mise Ю jour de la traduction par David Blanchet -.\" (david.blanchet@free.fr) 2006-06-10 -.\" Mise Ю jour de la traduction par Dominique PellИ -.\" (dominique.pelle@gmail.com) 2013-05-10 -.\" -.TH VIM 1 "22 fИvrier 2002" -.SH NOM -vim \- Vi IMproved, Иditeur de texte pour programmeurs -.SH SYNOPSIS -.br -.B vim -[options] [fichier ...] -.br -.B vim -[options] \- -.br -.B vim -[options] \-t marqueur -.br -.B vim -[options] \-q [fichiererreurs] -.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 DESCRIPTION -.B Vim -est un Иditeur de texte proposant une compatibilitИ ascendante -avec Vi. Il permet d'Иditer n'importe quel type de texte brut. -Il est particuliХrement adaptИ pour l'Иdition des programmes. -.PP -Il comporte de nombreuses amИliorations par rapport Ю Vi : annulation sur -plusieurs niveaux, fenЙtres et tampons multiples, coloration syntaxique, -Иdition en ligne de commande, complХtement des noms de fichiers, aide en -ligne, sИlection visuelle, etc. -Voir ":help vi_diff.txt" pour un rИsumИ des diffИrences entre -.B Vim -et Vi. -.PP -Pendant l'exИcution de -.B Vim -\, une aide abondante est accessible au travers du systХme d'aide -en ligne, grБce Ю la commande ":help". -Voir la section AIDE EN LIGNE plus bas. -.PP -Le plus souvent -.B Vim -est dИmarrИ pour Иditer un unique fichier avec la commande -.PP - vim fichier -.PP -Plus gИnИralement, -.B Vim -est lancИ avec : -.PP - vim [options] [listefichiers] -.PP -Si la listefichiers est omise, l'Иditeur dИmarre avec un tampon vide. -Autrement, l'une des quatre mИthodes suivantes vous permettra de choisir -un ou plusieurs fichiers Ю Иditer. -.TP 12 -fichier ... -Une liste de noms de fichiers. -Le premier sera le fichier courant et sera lu dans le tampon. -Le curseur sera placИ sur la premiХre ligne du tampon. -Vous pouvez passer aux autres fichiers avec la commande ":next". -Pour Иditer un fichier dИbutant par un tiret, faites prИcИder la -liste de fichiers par "\-\-". -.TP -\- -Le fichier Ю Иditer est lu sur l'entrИe standard (stdin). Les commandes sont -lues depuis stderr, qui devrait Йtre un terminal. -.TP -\-t {marqueur} -Le fichier Ю Иditer et la position initiale du curseur dИpendent -d'un "marqueur", qui est une sorte d'Иtiquette. -{marqueur} est recherchИ dans le fichier des marqueurs, le fichier correspondant -devient le fichier courant et la commande associИe est exИcutИe. -Principalement utile pour les programmes en C ; dans ce cas, {marqueur} -peut Йtre le nom d'une fonction. -Au final, le fichier contenant cette fonction devient le fichier -courant et le curseur est placИ au dИbut de la fonction. -Voir ":help tag\-commands". -.TP -\-q [fichiererreurs] -DИmarre en mode Mise-au-point (QuickFix). -Le fichier [fichiererreurs] est lu et la premiХre erreur est affichИe. -Si [fichiererreurs] est omis, le nom du fichier est lu dans -l'option 'errorfile' ("AztecC.Err" par dИfaut sur Amiga, "errors.err" sur les -autres systХmes). -La commande ":cn" permet de sauter aux erreurs suivantes. -Voir ":help quickfix". -.PP -.B Vim -se comporte diffИremment selon le nom de la commande (l'exИcutable peut -cependant Йtre le mЙme fichier). -.TP 10 -vim -La faГon "normale", le comportement par dИfaut. -.TP -ex -DИmarre en mode Ex. -La commande ":vi" permet de passer en mode Normal. -Ce mode est Иgalement accessible avec l'argument "\-e". -.TP -view -DИmarre en mode Lecture-Seule. Vous Йtes protИgИ de l'Иcriture accidentelle -des fichiers. Ce mode est Иgalement accessible avec l'argument "\-R". -.TP -gvim gview -La version graphique. -Ouvre une nouvelle fenЙtre. -иgalement accessible avec l'argument "\-g". -.TP -evim eview -La version graphique en mode DИbutant (easy). -Ouvre une nouvelle fenЙtre. -иgalement accessible avec l'argument "\-y". -.TP -rvim rview rgvim rgview -Comme ci-dessus, mais avec des restrictions. Il vous sera impossible de -lancer des commandes du shell, ou de suspendre -.B Vim. -иgalement accessible avec l'argument "\-Z". -.SH OPTIONS -Les options peuvent Йtre spИcifiИes dans n'importe quel ordre, -avant ou aprХs les noms de fichiers. Les options sans arguments -peuvent Йtre combinИes aprХs un unique tiret. -.TP 12 -+[num] -Place le curseur sur la ligne "num" dans le premier fichier. -Si "num" est omis, le curseur sera placИ sur la derniХre ligne. -.TP -+/{motif} -Place le curseur sur la premiХre occurrence de {motif} dans le premier fichier. -Voir ":help search\-pattern" pour connaНtre les motifs de recherches -disponibles. -.TP -+{commande} -.TP -\-c {commande} -ExИcute {commande} aprХs la lecture du premier fichier. -{commande} est interprИtИe comme une commande Ex. -Si la {commande} contient des espaces, elle doit Йtre entourИe -de doubles-apostrophes (cela dИpend du shell utilisИ). -Exemple : Vim "+set si" main.c -.br -Note : vous pouvez utiliser jusqu'Ю 10 commandes "+" ou "\-c". -.TP -\-S {fichier} -Source {fichier} aprХs la lecture du premier fichier. -C'est Иquivalent Ю \-c "source {fichier}". -{fichier} ne peut pas dИbuter par un '\-'. -Si {fichier} est omis, "Session.vim" est utilisИ (cela ne fonctionne que si -\-S est le dernier argument). -.TP -\-\-cmd {commande} -Comme "\-c", mais la commande est exИcutИe juste avant de traiter les fichiers -vimrc. -Vous pouvez utiliser jusqu'Ю 10 de ces commandes, indИpendamment des -commandes "\-c". -.TP -\-A -Si -.B Vim -a ИtИ compilИ avec le support de la fonctionnalitИ ARABIC pour l'Иdition de -fichiers de droite Ю gauche et les claviers arabes, cette option lance -.B Vim -en mode Arabe, c.-Ю-d. que l'option 'arabic' est activИe. -Sinon, un message d'erreur est Иmis et -.B Vim -quitte. -.TP -\-b -Mode Binaire. -Active plusieurs options pour permettre l'Иdition -d'un fichier binaire ou exИcutable. -.TP -\-C -Compatible. Active l'option 'compatible'. -.B Vim -se comportera alors quasiment comme Vi, mЙme s'il existe un fichier .vimrc. -.TP -\-d -DИmarre en mode Diff. -Deux, trois ou quatre noms de fichiers doivent Йtre spИcifiИs. -.B Vim -ouvrira alors tous les fichiers et affichera leurs diffИrences. -Fonctionne comme vimdiff(1). -.TP -\-d {pИriph} -Ouvre {pИriph} pour l'utiliser comme terminal. -Uniquement sur Amiga. -Exemple : -"\-d con:20/30/600/150". -.TP -\-D -Debogage. Passe en mode DИbogage lors de l'exИcution de la premiХre commande -d'un script. -.TP -\-e -DИmarre -.B Vim -en mode Ex, comme si l'exИcutable s'appelait "ex". -.TP -\-E -DИmarre -.B Vim -en mode Ex amИliorИ, comme si l'exИcutable "exim" avait ИtИ invoquИ. -.TP -\-f -Premier-plan (Foreground). Pour la version graphique, -.B Vim -ne forke pas et ne se dИtache pas du shell dans lequel il a ИtИ invoquИ. -Sur Amiga, -.B Vim -n'est pas relancИ pour ouvrir une nouvelle fenЙtre. -Cette option est utile quand -.B Vim -est exИcutИ par un programme qui attend la fin de la session d'Иdition -(par exemple mail). -Sur Amiga, les commandes ":sh" et ":!" ne fonctionneront pas. -.TP -\-\-nofork -Premier-plan (Foreground). Pour la version graphique, -.B Vim -ne forkera pas et ne se dИtachera pas du shell dans lequel il a ИtИ lancИ. -.TP -\-F -Si -.B Vim -a ИtИ compilИ avec le support de la fonctionnalitИ FKMAP pour l'Иdition de -fichiers de droite Ю gauche et les claviers farsi, cette option lance -.B Vim -en mode Farsi, c.-Ю-d. avec les options 'fkmap' et 'rightleft' activИes. -Sinon, un message d'erreur est Иmis et -.B Vim -quitte. -.TP -\-g -Si -.B Vim -a ИtИ compilИ avec le support de l'IHM graphique, cette option active -l'IHM graphique. Si le support n'a pas ИtИ compilИ, un message d'erreur -est Иmis et -.B Vim -quitte. -.TP -\-h -Donne une aide succincte sur les arguments et les options de la ligne de -commande. AprХs cela, -.B Vim -quitte. -.TP -\-H -Si -.B Vim -a ИtИ compilИ avec le support de la fonctionnalitИ RIGHTLEFT pour l'Иdition de -fichiers de droite Ю gauche et les claviers hИbreux, cette option lance -.B Vim -en mode HИbreu, c.-Ю-d. avec les options 'hkmap' et 'rightleft' activИes. -Sinon, un message d'erreur est Иmis et -.B Vim -quitte. -.TP -\-i {viminfo} -Lorsque l'utilisation d'un fichier viminfo est activИe, cette option indique -le nom de fichier Ю utiliser Ю la place de "~/.viminfo" par dИfaut. -Il est possible d'empЙcher l'utilisation d'un fichier ".viminfo", en -spИcifiant le nom de fichier "NONE". -.TP -\-L -Comme \-r. -.TP -\-l -Mode Lisp. -Active les options 'lisp' et 'showmatch'. -.TP -\-m -EmpЙche la modification des fichiers. -DИsactive l'option 'write'. -Vous pouvez toujours modifier le tampon, mais il vous sera impossible -d'Иcrire le fichier. -.TP -\-M -N'autorise aucune modification. les options 'modifiable' et 'write' sont -dИsactivИes, de sorte que les changements ne sont pas autorisИs et que les -fichiers ne peuvent pas Йtre Иcrits. Note : ces options peuvent Йtre activИes -pour autoriser les modifications. -.TP -\-N -Mode Non-compatible. DИsactive l'option 'compatible'. -Cela amИliorera le comportement de -.B Vim -\, mais il sera moins conforme Ю celui de Vi, mЙme s'il n'existe aucun -fichier ".vimrc". -.TP -\-n -N'utilise pas de fichier d'Иchange (swapfile). -Le recouvrement aprХs un plantage sera impossible. -Utile pour Иditer un fichier sur un support trХs lent (disquette par ex.). -иgalement activable avec ":set uc=0". -Il est possible de l'annuler avec ":set uc=200". -.TP -\-nb -Devient un serveur d'Иdition pour NetBeans. Consulter la documentation Ю ce -sujet pour davantage de dИtails. -.TP -\-o[N] -Ouvre N fenЙtres les unes au-dessus des autres. -Quand N est omis, ouvre une fenЙtre pour chaque fichier. -.TP -\-O[N] -Ouvre N fenЙtres cТte Ю cТte. -Quand N est omis, ouvre une fenЙtre pour chaque fichier fichier. -.TP -\-p[N] -Ouvre N onglets. -Quand N est omis, ouvre un onglet pour chaque fichier fichier. -.TP -\-R -Mode Lecture-Seule. -Active l'option 'readonly'. -Vous pouvez toujours Иditer le tampon, mais il vous sera impossible de -d'Иcraser accidentellement un fichier. -Si vous voulez Иcraser un fichier, ajoutez un point d'exclamation Ю la commande -Ex, comme dans ":w!". -L'option \-R impose l'option \-n (voir ci-dessus). -L'option 'readonly' peut Йtre dИsactivИe avec ":set noro". -Voir ":help 'readonly'". -.TP -\-r -Donne la liste des fichiers d'Иchange, avec des informations pour les utiliser -Ю des fins de recouvrement. -.TP -\-r {file} -Mode Recouvrement. -Utilise le fichier d'Иchange pour rИcouvrer d'une session d'Иdition plantИe. -Le fichier d'Иchange est un fichier avec le mЙme nom que le fichier texte, -suivi du suffixe ".swp". -Voir ":help recovery". -.TP -\-s -Mode Silencieux. Disponible uniquement quand -.B Vim -est lancИ en tant que "ex" ou quand l'option "\-e" a ИtИ spИcifiИe avant -l'option "\-s". -.TP -\-s {scriptEntrИe} -Lit le fichier de script {scriptEntrИe}. -Les caractХres du fichier sont interprИtИs comme si vous les tapiez. -La commande ":source! {scriptEntrИe}" donne le mЙme rИsultat. -Si la fin du fichier est atteinte avant que l'Иditeur quitte, les caractХres -suivants sont lus depuis le clavier. -.TP -\-T {terminal} -Indique Ю -.B Vim -le nom du terminal utilisИ. -Cela n'est requis que lorsque la dИtection automatique Иchoue. -Le {terminal} devrait Йtre connu de -.B Vim -(intИgrИ) ou dИfini dans le fichier termcap ou terminfo. -.TP -\-u {vimrc} -Utilise les commandes du fichier {vimrc} pour les initialisations. -Toutes les autres initialisations sont omises. -ю utiliser pour Иditer un type de fichiers particulier. -Cela permet aussi d'omettre toute initialisation en spИcifiant le nom de -fichier "NONE". -Voir ":help initialization" dans Vim pour davantage de dИtails. -.TP -\-U {gvimrc} -Utilise les commandes du fichier {gvimrc} pour l'initialisation de l'IHM -graphique. -Toutes les autres initialisations graphiques sont omises. -Cela permet aussi d'omettre toute initialisation graphique en spИcifiant le nom -de fichier "NONE". -Voir ":help gui\-init" dans Vim pour davantage de dИtails. -.TP -\-V[N] -Mode Verbeux. -Donne des messages Ю propos des fichiers sourcИs, ainsi que sur la lecture -et les Иcritures dans le fichier viminfo. le nombre optionnel N prИcise la -valeur de l'option 'verbose' (10 par dИfaut). -.TP -\-v -DИmarre -.B Vim -en mode Vi, comme si l'exИcutable s'appelait "vi". Cela n'a d'effet que si -l'exИcutable invoquИ est "ex". -.TP -\-w {scriptSortie} -Tous les caractХres que vous tapez sont enregistrИs dans le fichier -{scriptSortie}, jusqu'Ю ce que vous quittiez -.B Vim. -C'est utile quand vous voulez crИer un fichier de script Ю utiliser avec -"vim \-s" ou ":source!". -Si le fichier {scriptSortie} existe, les caractХres sont ajoutИs Ю la fin. -.TP -\-W {scriptSortie} -Comme \-w, mais un fichier existant sera ИcrasИ. -.TP -\-x -Chiffre les fichiers lors de l'Иcriture. Une clИ de chiffrement sera demandИe. -.TP -\-X -Ne se connecte pas au serveur X. AccИlХre le temps de dИmarrage dans un -terminal, mais le titre de la fenЙtre et le presse-papier seront inaccessibles. -.TP -\-y -DИmarre -.B Vim -en mode DИbutant (easy), comme si l'exИcutable s'appelait "evim" ou "eview". -Donne Ю -.B Vim -un comportement plus proche des Иditeurs ╚ cliquez-tapez ╩. -.TP -\-Z -Mode restreint. Fonctionne comme si l'exИcutable commenГait par la lettre 'r'. -.TP -\-\- -DИlimite la fin des options. -Les arguments qui suivent seront considИrИs comme des noms de fichiers. -Cela permet d'Иditer des fichiers dИbutant par un '\-'. -.TP -\-\-echo\-wid -IHM graphique GTK uniquement : retourne la Window ID sur stdout. -.TP -\-\-help -Donne un message d'aide et quitte, comme "\-h". -.TP -\-\-literal -Prend les arguments de noms de fichiers littИralement, sans Иtendre les -jokers. N'a aucun effet sur Unix, oЫ le shell Иtend les jokers. -.TP -\-\-noplugin -Ne charge pas les greffons. Implicite avec \-u NONE. -.TP -\-\-remote -Se connecte Ю un serveur Vim et lui fait Иditer les fichiers spИcifiИs dans -le reste des arguments. Si aucun serveur n'est trouvИ, un avertissement est -Иmis et les fichiers sont ИditИs dans le Vim courant. -.TP -\-\-remote\-expr {expr} -Se connecte Ю un serveur Vim, y Иvalue {expr} et affiche le rИsultat sur la -sortie standard (stdout). -.TP -\-\-remote\-send {touches} -Se connecte Ю un serveur Vim et y envoie {touches}. -.TP -\-\-remote\-silent -Comme \-\-remote, mais sans Иmettre d'avertissement si aucun serveur n'est -trouvИ. -.TP -\-\-remote\-wait -Comme \-\-remote, mais Vim ne quitte pas tant que le fichier est en cours -d'Иdition. -.TP -\-\-remote\-wait\-silent -Comme \-\-remote\-wait, mais sans Иmettre d'avertissement si aucun serveur n'est -trouvИ. -.TP -\-\-serverlist -Donne la liste des noms de tous les serveurs Vim disponibles. -.TP -\-\-servername {nom} -Utilise {nom} pour le nom de serveur. Ce nom est donnИ au Vim courant, Ю moins -qu'il ne soit utilisИ avec un argument \-\-remote. Dans ce cas, il s'agit du nom -du serveur auquel se connecter. -.TP -\-\-socketid {id} -IHM graphique GTK+ uniquement : utilise le mИcanisme GtkPlug pour faire -fonctionner gvim dans une autre fenЙtre. -.TP -\-\-version -Affiche les informations sur la version puis quitte. -.SH AIDE EN LIGNE -Taper ":help" dans -.B Vim -pour commencer. -Taper ":help sujet" pour obtenir de l'aide sur un sujet prИcis. -Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ". -Utiliser <Tab> et CTRL\-D pour complИter les sujets (":help -cmdline\-completion"). -Des marqueurs sont inclus dans l'aide et vous permettent de sauter d'un endroit -Ю un autre (comme des liens hypertextes, voir ":help"). -L'ensemble des fichiers de la documentation peut Йtre consultИ de cette -faГon, par exemple ":help syntax.txt". -.SH FICHIERS -.TP 15 -/usr/local/lib/vim/doc/*.txt -Les fichiers de la documentation de -.B Vim. -Utiliser ":help doc\-file\-list" pour obtenir la liste complХte. -.TP -/usr/local/lib/vim/doc/tags -Le fichier des marqueurs utilisИ pour trouver les informations dans les -fichiers de la documentation. -.TP -/usr/local/lib/vim/syntax/syntax.vim -Initialisation de la syntaxe pour l'ensemble du systХme. -.TP -/usr/local/lib/vim/syntax/*.vim -Fichiers de syntaxe pour diffИrents langages. -.TP -/usr/local/lib/vim/vimrc -Initialisation de -.B Vim -pour l'ensemble du systХme. -.TP -~/.vimrc -Initialisation de -.B Vim -de votre compte utilisateur. -.TP -/usr/local/lib/vim/gvimrc -Initialisation de gvim pour l'ensemble du systХme. -.TP -~/.gvimrc -Initialisation de gvim pour votre compte utilisateur. -.TP -/usr/local/lib/vim/optwin.vim -Script utilisИ pour la commande ":options", une maniХre pratique de consulter -et de modifier les options. -.TP -/usr/local/lib/vim/menu.vim -Initialisation des menus de gvim pour l'ensemble du systХme. -.TP -/usr/local/lib/vim/bugreport.vim -Script pour gИnИrer un rapport de bogue. Voir ":help bugs". -.TP -/usr/local/lib/vim/filetype.vim -Script pour dИtecter le type d'un fichier d'aprХs son nom. -Voir ":help 'filetype'". -.TP -/usr/local/lib/vim/scripts.vim -Script pour dИtecter le type d'un fichier d'aprХs son contenu. -Voir ":help 'filetype'". -.TP -/usr/local/lib/vim/print/*.ps -Fichiers utilisИs pour l'impression PostScript. -.PP -Pour disposer d'informations rИcentes, consulter le site Internet de VIM : -.br -<URL:http://www.vim.org/> -.SH VOIR AUSSI -vimtutor(1) -.SH AUTEUR -La majeure partie de -.B Vim -a ИtИ Иcrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. -Voir ":help credits" dans -.B Vim. -.br -.B Vim -est basИ sur Stevie, rИalisИ par Tim Thompson, -Tony Andrews et G.R. (Fred) Walter. -Toutefois, pratiquement rien du code original ne subsiste. -.SH BOGUES -Probablement. -Voir ":help todo" pour consulter la liste des problХmes connus. -.PP -NOTE : Remarquez que bon nombre de points, qui pourraient Йtre considИrИs comme -des bugs par certains, sont en fait dus Ю une reproduction trop fidХle -du comportement de Vi. Et si vous pensez que d'autres points sont des -bugs "parce que Vi le fait diffИremment", vous devriez jeter un oeil -attentif au fichier vi_diff.txt (ou taper ":help vi_diff.txt" dans Vim). -Regardez aussi les options 'compatible' et 'coptions'. -.SH TRADUCTION -Cette page de manuel a ИtИ traduite par Richard Hitier. -<richard.hitier@dial.oleane.com> 2000-08-07. -.br -Cette page de manuel a ИtИ mise Ю jour par David Blanchet. -<david.blanchet@free.fr> 2006-04-10. -Mise Ю jour 2013-05-10, Dominique PellИ <dominique.pelle@gmail.com> diff --git a/runtime/doc/vim-it.1 b/runtime/doc/vim-it.1 deleted file mode 100755 index 0ab3eff0d2..0000000000 --- a/runtime/doc/vim-it.1 +++ /dev/null @@ -1,566 +0,0 @@ -.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 Modo Visual, 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 nome_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 -nome_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 -necessariamente, 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 in Modo 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 -Modo Normal, comportamento normale. -.TP -ex -Inizia in Modo "Ex". -Si puР passare in Modo Normal col comando ":vi". -Si puР invocare il Modo "Ex" anche con l'argomento "\-e". -.TP -view -Inizia in Modo Read-only (Sola Lettura). Non potete modificare i file. -Si puР invocare il Modo Read-only anche con l'argomento "\-R". -.TP -gvim gview -La versione GUI [Graphical User Interface]. -Apre una nuova finestra. -Si puР invocare il Modo GUI anche con l'argomento "\-g". -.TP -evim eview -La versione GUI in Modo Easy (semplificata). -Apre una nuova finestra. -Si puР invocare il Modo Easy anche con l'argomento "\-y". -.TP -rvim rview rgvim rgview -Come sopra, ma con restrizioni ai comandi. Non si potranno eseguire comandi -della shell o sospendere -.B Vim. -Si puР chiedere la stessa cosa 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 specificate -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 della 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 Modo Arabic, cioХ impostando 'arabic'. -Altrimenti viene dato un messaggio di errore e -.B Vim -termina in modo anormale. -.TP -\-b -Modo Binary (binario). -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, vi usa .exrc \- Ndt]. -.TP -\-d -Inizia in Modo Diff [differenze]. -Dovrebbero esserci come argomenti due o tre o quattro 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 Modo "debugging" a partire -dall'esecuzione del primo comando da uno script. -.TP -\-e -Eseguire -.B Vim -in Modo Ex, come se il programma eseguito sia "ex". -.TP -\-E -Eseguire -.B Vim -in Modo Ex migliorato, come se il programma eseguito sia "exim". -.TP -\-f -Direttamente [Foreground]. Per la versione GUI, -.B Vim -non crea [fork] una nuova finestra, indipendente dalla 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 dalla 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 Modo 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 Modo Ebraico, 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 -Modo Lisp. -Imposta le opzioni 'lisp' e 'showmatch'. -.TP -\-m -Inibisce modifica file. -Annulla l'opzione 'write'. -х 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 -Modo "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 -Modo Read-only (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} -Modo Recovery (ripristino). -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 -Modo silenzioso. 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 Modo 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 Modo Easy (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 -Modo ristretto. 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 letterali, senza espandere -metacaratteri. Non necessario in Unix, la 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 risultato -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 documentazione 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 -~/.vimrc -Le vostre personali inizializzazioni di -.B Vim -. -.TP -/usr/local/lib/vim/gvimrc -Inizializzazioni gvim a livello di sistema. -.TP -~/.gvimrc -Le vostre personali inizializzazioni di gvim. -.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 -Inizializzazioni del menЫ 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/print/*.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/vim-pl.1 b/runtime/doc/vim-pl.1 deleted file mode 100644 index d506b33c98..0000000000 --- a/runtime/doc/vim-pl.1 +++ /dev/null @@ -1,558 +0,0 @@ -.TH VIM 1 "2006 kwi 11" -.SH NAME -vim \- Vi rozbudowany, edytor tekstu dla programisty -.SH SYNOPSIS -.br -.B vim -[opcje] [plik ..] -.br -.B vim -[opcje] \- -.br -.B vim -[opcje] \-t znacznik -.br -.B vim -[opcje] \-q [plik_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: wielopoziomowe 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С©nic 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} mo©e 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©liwe -wzorce 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©nie 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 siЙ u©yФ dwСch, trzech lub czterech nazwy plikСw jako argumentСw. -.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 zmieniaФ zawarto╤Ф bufora, ale zapisanie pliku nie jest -mo©liwe. -.TP -\-M -Opcje 'modifiable' i 'write' zostan╠ wyЁ╠czone, tak wiЙc zmiany -w pliku oraz ich zapisanie nie s╠ mo©liwe. Warto╤Ф tych opcji mo©na -zmieniФ. -.TP -\-N -Tryb niekompatybilny. Przestawia opcjЙ 'compatible'. DziЙki temu -.B Vim -bЙdzie zachowywaЁ siЙ odrobinЙ lepiej, ale mniej zgodnie 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 by chroniФ -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 kwantyfikatory. -.TP -\-\-noplugin -PomiЯ Ёadowanie wtyczek. Implikowane przy \-u NONE. -.TP -\-\-remote -PoЁ╠cz siЙ z serwerem Vima i edytuj w nim resztЙ plikСw podanych jako -argumenty. Je╤li nie znaleziono serwera zostanie zgЁoszony bЁ╠d a pliki zostan╠ -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 pozostan╠ -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/doc/tags -Plik znacznikСw sЁu©y do znajdowania informacji w plikach dokumentacji. -.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/print/*.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-ru.1 b/runtime/doc/vim-ru.1 deleted file mode 100644 index dfcb3ece98..0000000000 --- a/runtime/doc/vim-ru.1 +++ /dev/null @@ -1,489 +0,0 @@ -.TH VIM 1 "2002 Feb 22" -.SH ИМЯ -vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов -.SH КОМАНДНАЯ СТРОКА -.br -.B vim -[ключи] [файл ..] -.br -.B vim -[ключи] \- -.br -.B vim -[ключи] \-t метка -.br -.B vim -[ключи] \-q [файл ошибок] -.PP -.br -.B ex -.br -.B view -.br -.B gvim -.B gview -.br -.B rvim -.B rview -.B rgvim -.B rgview -.SH ОПИСАНИЕ -.B Vim --- текстовый редактор, обратно-совместимый с Vi. -Он может быть использован для правки всех видов простого текста. -Особенно он хорош для правки исходных текстов программ. -.PP -По сравнению с Vi, -.B Vim -имеет много усовершенствований: многократная отмена операций, -множественность окон и буферов, подсветка синтаксиса, правка командной строки, -автодополнение имён файлов, встроенная справка, визуальное выделение и т.п. -См. ":help vi_diff.txt" для получения полного списка различий между -.B Vim -и Vi. -.PP -Во время работы в -.B Vim -можно получить справку с помощью системы встроенной справки (команда ":help"). -См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту. -.PP -Чаще всего -.B Vim -запускают для правки одного файла при помощи команды -.PP - vim файл -.PP -В общем виде команда запуска -.B Vim -выглядит так: -.PP - vim [ключи] [список файлов] -.PP -Если список файлов отсутствует, редактор начнёт работу с пустым буфером. -В противном случае имя файла должно быть указано одним из следующих четырёх способов: -.TP 12 -файл .. -Список имён файлов. -Первый файл будет объявлен активным и загружен в буфер. Курсор будет помещён -в первой строке буфера. Доступ к другим файлам может быть осуществлён при -помощи команды ":next". Чтобы править файл, имя которого начинается с символа -"дефис" (-), перед списком файлов необходимо поставить "--". -.TP -\- -Файл будет прочитан из потока стандартного ввода. Команды будут считываться -из стандартного потока диагностики (stderr), который должен быть -терминалом. -.TP -\-t {метка} -Имя файла и начальная позиция курсора зависят от "метки", похожей на метку goto. -{метка} ищется в файле меток, соответствующий файл становится активным, а -соответствующая команда исполняется. -Чаще всего используется в программах на языке Си, где {метка} может быть именем -функции. -Файл, содержащий функцию, становится активным, а курсор помещается в начало функции. -См. ":help tag-commands". -.TP -\-q [файл ошибок] -Начать работу в режиме быстрого исправления. -При этом считывается [файл ошибок] и первая ошибка выводится на экран. -Если [файл ошибок] не указан, имя файла берётся из значения опции 'errorfile' -(по умолчанию: "AztecC.Err" для Amiga, "errors.err" для других систем). -К следующим ошибкам можно перейти по команде ":cn". -См. ":help quickfix". -.PP -.B Vim -ведёт себя по-разному в зависимости от имени команды (исполняемый файл может -быть одним и тем же). -.TP 10 -vim -"Нормальный" запуск, всё по умолчанию. -.TP -ex -Запуск в режиме Ex. Для перехода в нормальный режим -необходимо выполнить команду ":vi". Режим Ex включает -также ключ "\-e". -.TP -view -Запуск в режиме "только для чтения". Вы будете защищены от случайной записи -файла. То же самое можно сделать ключом "\-R". -.TP -gvim gview -Версия с графическим интерфейсом. Запускается в новом окне. -То же самое можно сделать при запуске с ключом "\-g". -.TP -rvim rview rgvim rgview -Как и предыдущие команды, но с ограничениями. Нельзя запускать команды оболочки -или приостанавливать работу -.B Vim. -Вместо приставки "r" можно использовать ключ "\-Z". -.SH КЛЮЧИ -Ключи могут быть указаны в любом порядке, до или после имён -файлов. Ключи без аргументов могут быть объединены под одним -дефисом. -.TP 12 -+[номер] -В первом файле курсор будет помещён на строку с указанным номером. -Если "номер" не указан, курсор будет помещён на последнюю строку. -.TP -+/{шаблон} -В первом файле курсор будет помещён на место первого совпадения -с указанным шаблоном. См. ":help search-pattern" для получения -списка допустимых шаблонов. -.TP -+{команда} -.TP -\-c {команда} -{команда} исполняется после загрузки первого файла как команда Ex. -Если {команда} содержит пробелы, то она должна быть заключена в -двойные кавычки (в зависимости от используемой оболочки). -Пример: vim "+set si" main.c -.br -Примечание: Можно указывать до десяти команд "+" или "\-c". -.TP -\-\-cmd {команда} -Как "\-c", но команда исполняется перед обработкой любого файла -настроек (vimrc). -Можно указывать до десяти таких команд, независимо от количества -команд "\-c". -.TP -\-A -Если -.B Vim -был собран с поддержкой арабского языка для правки файлов, -набранных справа налево, и с поддержкой арабской клавиатуры, -этот ключ запускает -.B Vim -в арабском режиме, с включенной опцией 'arabic'. В противном -случае -.B Vim -завершает работу с ошибкой. -.TP -\-b -Двоичный режим. -Производится настройка некоторых опций, делающих возможной правку -двоичного или исполняемого файла. -.TP -\-C -Режим совместимости. Включает опцию 'compatible'. -.B Vim -будет работать почти как Vi, даже если существует файл .vimrc. -.TP -\-d -Режим поиска различий. -Должно быть указано два или три имени файла. -.B Vim -откроет все файлы и покажет различия между ними -(как vimdiff(1)). -.TP -\-d {устройство} -Открыть {устройство} для использования в качестве терминала (только на Amiga). -Пример: -"\-d con:20/30/600/150". -.TP -\-e -Запустить -.B Vim -в режиме Ex, как будто исполняемый файл имеет имя "ex". -.TP -\-f -Режим активного приложения. Версия -.B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. На платформе Amiga -.B Vim -не будет создавать новое окно. Этот ключ нужно использовать, -когда -.B Vim -запускается программой, которая должна ждать завершения -сеанса правки (например, программа для работы с электронной почтой). -На платформе Amiga команды ":sh" и ":!" не будут работать. -.TP -\-\-nofork -Режим активного приложения. Версия -.B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. -.TP -\-F -Если -.B Vim -был собран с поддержкой FKMAP для правки текста справа налево -и настроек клавиатуры для языка фарси, этот ключ запускает -.B Vim -в режиме фарси, иначе говоря, с включёнными опциями -\&'fkmap' и 'rightleft'. -В противном случае -.B Vim -завершает работу с сообщением об ошибке. -.TP -\-g -Если -.B Vim -был собран с поддержкой графического интерфейса, этот ключ -включает графический интерфейс. В противном случае -.B Vim -завершает работу с сообщением об ошибке. -.TP -\-h -Выводит краткую информацию об аргументах и ключах командной строки. -После этого -.B Vim -завершает работу. -.TP -\-H -Если -.B Vim -был собран с поддержкой правки текста справа налево -и настроек клавиатуры для иврита, этот ключ запускает -.B Vim -в режиме иврита, иначе говоря, с включёнными опциями 'hkmap' и 'rightleft'. -В противном случае -.B Vim -завершает работу с сообщением об ошибке. -.TP -\-i {viminfo} -Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо -"~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo -путём указания имени "NONE". -.TP -\-L -То же, что и \-r. -.TP -\-l -Режим Lisp. Включаются опции 'lisp' и 'showmatch'. -.TP -\-m -Изменение файлов запрещено. При этом отключается опция 'write', поэтому -запись файлов становится невозможной. -.TP -\-N -Режим неполной совместимости. Отключается 'compatible'. -.B Vim -будет работать лучше, но не будет полностью совместим с Vi, даже если -отсутствует файл сценария настроек (.vimrc). -.TP -\-n -Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. -Удобно для правки файла на очень медленном носителе (например, гибком диске). -То же самое можно сделать командой ":set uc=0". Отмена -- ":set uc=200". -.TP -\-o[N] -Открыть N окон, разделённых по горизонтали. Если N не указано, то открывается -по одному окну на каждый файл. -.TP -\-O[N] -Открыть N окон, разделённых по вертикали. Если N не указано, то открывается -по одному окну на каждый файл. -.TP -\-R -Режим "только для чтения". Включается опция 'readonly'. -Файл в буфере доступен для редактирования, но его копию на диске нельзя -случайно перезаписать. Для сохранения файла необходимо добавить восклицательный -знак к соответствующей команде Ex (например, ":w!"). -Ключ "\-R" подразумевает также, что используется и ключ "\-n" (см. выше). -Опция 'readonly' может быть выключена по команде ":set noro". -См. ":help 'readonly'". -.TP -\-r -Вывести список своп-файлов и информацию об их использовании для восстановления после сбоя. -.TP -\-r {файл} -Режим восстановления. -Для восстановления после сбоя будет использован своп-файл. -Своп-файл имеет то же имя, что и текстовый файл, но с добавлением расширения ".swp". -См. ":help recovery". -.TP -\-s -Тихий режим. Только при запуске как "Ex" или если перед "\-s" указан ключ "\-e". -.TP -\-s {scriptin} -Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается -в виде команд, как если бы они были набраны на консоли. -То же самое достигается командой ":source! {scriptin}". -Если конец файла считывается до завершения работы редактора, то в дальнейшем -ввод осуществляется с клавиатуры. -.TP -\-T {terminal} -Сообщает -.B Vim -тип используемого терминала. Необходимо только в тех ситуациях, когда -автоматическое определение терминала не работает. Имя терминала должно быть -известно -.B Vim -(встроено в него) или определено в файлах termcap или terminfo. -.TP -\-u {vimrc} -Использовать команды из файла сценария {vimrc} для настройки. -Все остальные файлы настроек пропускаются. -Удобно для редактирования специальных типов файлов. -Чтобы избежать использования сценариев настроек вообще, можно использовать -имя "NONE". См. ":help initialization". -.TP -\-U {gvimrc} -Использовать команды из файла сценария {gvimrc} для настройки графического -интерфейса. -Все остальные файлы настроек для графического интерфейса пропускаются. -Чтобы избежать использования сценариев настроек графического интерфейса вообще, -можно использовать имя "NONE". См. ":help gui-init". -.TP -\-V -"Болтливый" режим. Выводить сообщения о том, какие файлы читаются, и о -чтении-записи файла viminfo. -.TP -\-v -Запустить -.B Vim -в режиме Vi, как будто исполняемый файл имеет имя "vi". Имеет смысл только если -исполняемый файл имеет имя "ex". -.TP -\-w {scriptout} -Все символы, введённые с клавиатуры вплоть до момента завершения работы, -записываются в файл {scriptout}. -Удобно в том случае, когда вы хотите создать файл сценария для последующего -использования с "vim \-s" или ":source!". Если файл {scriptout} уже существует, -то новые символы будут добавляются в конец файла. -.TP -\-W {scriptout} -Как "\-w", но уже существующий файл будет перезаписан. -.TP -\-x -Шифровать записываемые файлы. Будет выдано приглашение ввести пароль. -.TP -\-X -Не подключаться к X-серверу. Ускоряет загрузку на консоли, но делает невозможным -использование заголовка окна и буфера обмена. -.TP -\-Z -Ограниченный режим. Работает так же, как и программы, начинающиеся с "r". -.TP -\-\- -Конец ключей. Все остальные аргументы рассматриваются как имена файлов. -Может быть использовано для правки файлов, имена которых начинаются с дефиса. -.TP -\-\-help -Вывести краткую справку и завершить работу. То же, что и "\-h". -.TP -\-\-version -Вывести информацию о версии программы и завершить работу. -.TP -\-\-remote -Подключиться к серверу Vim и заставить его править файлы, указанные в -последующих аргументах. Если сервер не найден, выводится предупреждение, -а файлы правятся в местной копии Vim. -.TP -\-\-remote\-expr {выражение} -Подключиться к серверу Vim и вычислить на нём указанное {выражение}. -Результат вычисления будет выведен в поток стандартного вывода (stdout). -.TP -\-\-remote\-send {ключи} -Подключиться к серверу Vim и передать ему указанные {ключи}. -.TP -\-\-remote\-silent -Как "\-\-remote", но без вывода предупреждения, если сервер не найден. -.TP -\-\-remote\-wait -Как "\-\-remote", но Vim не будет завершать работу до тех пор, пока не будет -выполнена правка всех файлов. -.TP -\-\-remote\-wait\-silent -Как "\-\-remote\-wait", но без вывода предупреждения, если сервер не найден. -.TP -\-\-serverlist -Вывести список всех доступных серверов Vim. -.TP -\-\-servername {имя} -Использовать указанное {имя} в качестве имени сервера. Если ключ -"\-\-remote" не указан, то {имя} присваивается данной копии Vim, -в противном случае указывает на имя сервера, к которому следует -подключиться. -.TP -\-\-socketid {id} -Только для графического интерфейса GTK: использовать механизм GtkPlug для -запуска gvim в отдельном окне. -.TP -\-\-echo\-wid -Только для графического интерфейса GTK: вывести идентификатор окна (Window ID) -в поток стандартного вывода (stdout). -.SH ВСТРОЕННАЯ СПРАВКА -Для начала, наберите команду ":help". -Введите ":help тема", чтобы получить справку по конкретной теме. -Например, команда ":help ZZ" выведет информацию о команде "ZZ". -Используйте <Tab> и CTRL-D для автоматического дополнения -названий тем (":help cmdline-completion"). -Для быстрого перемещения по справочнику используются метки (что-то -вроде гипертекстовых ссылок, см. ":help"). Таким образом можно -просматривать все файлы справки, например ":help syntax.txt". -.SH ФАЙЛЫ -.TP 15 -/usr/local/lib/vim/doc/*.txt -Файлы справочника -.B Vim. -См. ":help doc-file-list" для получения полного списка. -.TP -/usr/local/lib/vim/doc/tags -Файл меток, используемый для поиска информации в файлах справки. -.TP -/usr/local/lib/vim/syntax/syntax.vim -Системные настройки синтаксиса. -.TP -/usr/local/lib/vim/syntax/*.vim -Файлы синтаксиса для разных языков. -.TP -/usr/local/lib/vim/vimrc -Системные настройки -.B Vim. -.TP -/usr/local/lib/vim/gvimrc -Системный настройки графического интерфейса. -.TP -/usr/local/lib/vim/optwin.vim -Сценарий, используемый при выполнении команды ":options". -Хороший способ просматривать и изменять настройки. -.TP -/usr/local/lib/vim/menu.vim -Системные настройки меню для gvim. -.TP -/usr/local/lib/vim/bugreport.vim -Сценарий для создания отчёта об обнаруженных глюках. См. ":help bugs". -.TP -/usr/local/lib/vim/filetype.vim -Сценарий для определения типа файла по имени. См. ":help 'filetype'". -.TP -/usr/local/lib/vim/scripts.vim -Сценарий для определения типа файла по содержимому. См. ":help 'filetype'". -.TP -/usr/local/lib/vim/print/*.ps -Файлы для печати PostScript. -.PP -Более свежая информация -- на сайте VIM: -.br -<URL:http://www.vim.org/> -.SH СМОТРИ ТАКЖЕ -vimtutor(1) -.SH АВТОРЫ -Большая часть -.B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. ":help credits" в -.B Vim. -.br -.B Vim -базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson), -Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). -Однако, в настоящее время в Vim почти не осталось ничего от исторического кода -его предшественника. -.br -Русская локализация -.B Vim -выполняется в рамках проекта "РуВим", -см. <URL:http://sourceforge.net/projects/ruvim/>. -.SH ГЛЮКИ -Скорее всего есть. -См. ":help todo" -- список известных проблем. -.PP -Заметим, что многие вещи, которые считаются глюками, на самом деле -являются результатом слишком полного воспроизведения поведения Vi. -Если вы думаете, что что-то является ошибкой только потому, что -"Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt -(или наберите ":help vi_diff.txt" в Vim) и используйте опции 'compatible' -и 'cpoptions'. diff --git a/runtime/doc/vim.man b/runtime/doc/vim.man deleted file mode 100644 index 5b9b83cb6c..0000000000 --- a/runtime/doc/vim.man +++ /dev/null @@ -1,428 +0,0 @@ -VIM(1) VIM(1) - - - -NAME - vim - Vi IMproved, a programmers text editor - -SYNOPSIS - vim [options] [file ..] - vim [options] - - vim [options] -t tag - vim [options] -q [errorfile] - - ex - view - gvim gview evim eview - rvim rview rgvim rgview - -DESCRIPTION - Vim is a text editor that is upwards compatible to Vi. It can be used - to edit all kinds of plain text. It is especially useful for editing - programs. - - There are a lot of enhancements above Vi: multi level undo, multi win- - dows and buffers, syntax highlighting, command line editing, filename - completion, on-line help, visual selection, etc.. See ":help - vi_diff.txt" for a summary of the differences between Vim and Vi. - - While running Vim a lot of help can be obtained from the on-line help - system, with the ":help" command. See the ON-LINE HELP section below. - - Most often Vim is started to edit a single file with the command - - vim file - - More generally Vim is started with: - - vim [options] [filelist] - - If the filelist is missing, the editor will start with an empty buffer. - Otherwise exactly one out of the following four may be used to choose - one or more files to be edited. - - file .. A list of filenames. The first one will be the current - file and read into the buffer. The cursor will be posi- - tioned on the first line of the buffer. You can get to the - other files with the ":next" command. To edit a file that - starts with a dash, precede the filelist with "--". - - - The file to edit is read from stdin. Commands are read - from stderr, which should be a tty. - - -t {tag} The file to edit and the initial cursor position depends on - a "tag", a sort of goto label. {tag} is looked up in the - tags file, the associated file becomes the current file and - the associated command is executed. Mostly this is used - for C programs, in which case {tag} could be a function - name. The effect is that the file containing that function - becomes the current file and the cursor is positioned on - the start of the function. See ":help tag-commands". - - -q [errorfile] - Start in quickFix mode. The file [errorfile] is read and - the first error is displayed. If [errorfile] is omitted, - the filename is obtained from the 'errorfile' option - (defaults to "AztecC.Err" for the Amiga, "errors.err" on - other systems). Further errors can be jumped to with the - ":cn" command. See ":help quickfix". - - Vim behaves differently, depending on the name of the command (the exe- - cutable may still be the same file). - - vim The "normal" way, everything is default. - - ex Start in Ex mode. Go to Normal mode with the ":vi" command. - Can also be done with the "-e" argument. - - view Start in read-only mode. You will be protected from writing - the files. Can also be done with the "-R" argument. - - gvim gview - The GUI version. Starts a new window. Can also be done with - the "-g" argument. - - evim eview - The GUI version in easy mode. Starts a new window. Can also - be done with the "-y" argument. - - rvim rview rgvim rgview - Like the above, but with restrictions. It will not be possi- - ble to start shell commands, or suspend Vim. Can also be - done with the "-Z" argument. - -OPTIONS - The options may be given in any order, before or after filenames. - Options without an argument can be combined after a single dash. - - +[num] For the first file the cursor will be positioned on line - "num". If "num" is missing, the cursor will be positioned - on the last line. - - +/{pat} For the first file the cursor will be positioned on the - first occurrence of {pat}. See ":help search-pattern" for - the available search patterns. - - +{command} - - -c {command} - {command} will be executed after the first file has been - read. {command} is interpreted as an Ex command. If the - {command} contains spaces it must be enclosed in double - quotes (this depends on the shell that is used). Example: - Vim "+set si" main.c - Note: You can use up to 10 "+" or "-c" commands. - - -S {file} {file} will be sourced after the first file has been read. - This is equivalent to -c "source {file}". {file} cannot - start with '-'. If {file} is omitted "Session.vim" is used - (only works when -S is the last argument). - - --cmd {command} - Like using "-c", but the command is executed just before - processing any vimrc file. You can use up to 10 of these - commands, independently from "-c" commands. - - -A If Vim has been compiled with ARABIC support for editing - right-to-left oriented files and Arabic keyboard mapping, - this option starts Vim in Arabic mode, i.e. 'arabic' is - set. Otherwise an error message is given and Vim aborts. - - -b Binary mode. A few options will be set that makes it pos- - sible to edit a binary or executable file. - - -C Compatible. Set the 'compatible' option. This will make - Vim behave mostly like Vi, even though a .vimrc file - exists. - - -d Start in diff mode. There should be two, three or four - file name arguments. Vim will open all the files and show - differences between them. Works like vimdiff(1). - - -d {device} Open {device} for use as a terminal. Only on the Amiga. - Example: "-d con:20/30/600/150". - - -D Debugging. Go to debugging mode when executing the first - command from a script. - - -e Start Vim in Ex mode, just like the executable was called - "ex". - - -E Start Vim in improved Ex mode, just like the executable was - called "exim". - - -f Foreground. For the GUI version, Vim will not fork and - detach from the shell it was started in. On the Amiga, Vim - is not restarted to open a new window. This option should - be used when Vim is executed by a program that will wait - for the edit session to finish (e.g. mail). On the Amiga - the ":sh" and ":!" commands will not work. - - --nofork Foreground. For the GUI version, Vim will not fork and - detach from the shell it was started in. - - -F If Vim has been compiled with FKMAP support for editing - right-to-left oriented files and Farsi keyboard mapping, - this option starts Vim in Farsi mode, i.e. 'fkmap' and - 'rightleft' are set. Otherwise an error message is given - and Vim aborts. - - -g If Vim has been compiled with GUI support, this option - enables the GUI. If no GUI support was compiled in, an - error message is given and Vim aborts. - - -h Give a bit of help about the command line arguments and - options. After this Vim exits. - - -H If Vim has been compiled with RIGHTLEFT support for editing - right-to-left oriented files and Hebrew keyboard mapping, - this option starts Vim in Hebrew mode, i.e. 'hkmap' and - 'rightleft' are set. Otherwise an error message is given - and Vim aborts. - - -i {viminfo} - When using the viminfo file is enabled, this option sets - the filename to use, instead of the default "~/.viminfo". - This can also be used to skip the use of the .viminfo file, - by giving the name "NONE". - - -L Same as -r. - - -l Lisp mode. Sets the 'lisp' and 'showmatch' options on. - - -m Modifying files is disabled. Resets the 'write' option. - You can still modify the buffer, but writing a file is not - possible. - - -M Modifications not allowed. The 'modifiable' and 'write' - options will be unset, so that changes are not allowed and - files can not be written. Note that these options can be - set to enable making modifications. - - -N No-compatible mode. Reset the 'compatible' option. This - will make Vim behave a bit better, but less Vi compatible, - even though a .vimrc file does not exist. - - -n No swap file will be used. Recovery after a crash will be - impossible. Handy if you want to edit a file on a very - slow medium (e.g. floppy). Can also be done with ":set - uc=0". Can be undone with ":set uc=200". - - -nb Become an editor server for NetBeans. See the docs for - details. - - -o[N] Open N windows stacked. When N is omitted, open one window - for each file. - - -O[N] Open N windows side by side. When N is omitted, open one - window for each file. - - -p[N] Open N tab pages. When N is omitted, open one tab page for - each file. - - -R Read-only mode. The 'readonly' option will be set. You - can still edit the buffer, but will be prevented from acci- - dently overwriting a file. If you do want to overwrite a - file, add an exclamation mark to the Ex command, as in - ":w!". The -R option also implies the -n option (see - below). The 'readonly' option can be reset with ":set - noro". See ":help 'readonly'". - - -r List swap files, with information about using them for - recovery. - - -r {file} Recovery mode. The swap file is used to recover a crashed - editing session. The swap file is a file with the same - filename as the text file with ".swp" appended. See ":help - recovery". - - -s Silent mode. Only when started as "Ex" or when the "-e" - option was given before the "-s" option. - - -s {scriptin} - The script file {scriptin} is read. The characters in the - file are interpreted as if you had typed them. The same - can be done with the command ":source! {scriptin}". If the - end of the file is reached before the editor exits, further - characters are read from the keyboard. - - -T {terminal} - Tells Vim the name of the terminal you are using. Only - required when the automatic way doesn't work. Should be a - terminal known to Vim (builtin) or defined in the termcap - or terminfo file. - - -u {vimrc} Use the commands in the file {vimrc} for initializations. - All the other initializations are skipped. Use this to - edit a special kind of files. It can also be used to skip - all initializations by giving the name "NONE". See ":help - initialization" within vim for more details. - - -U {gvimrc} Use the commands in the file {gvimrc} for GUI initializa- - tions. All the other GUI initializations are skipped. It - can also be used to skip all GUI initializations by giving - the name "NONE". See ":help gui-init" within vim for more - details. - - -V[N] Verbose. Give messages about which files are sourced and - for reading and writing a viminfo file. The optional num- - ber N is the value for 'verbose'. Default is 10. - - -v Start Vim in Vi mode, just like the executable was called - "vi". This only has effect when the executable is called - "ex". - - -w {scriptout} - All the characters that you type are recorded in the file - {scriptout}, until you exit Vim. This is useful if you - want to create a script file to be used with "vim -s" or - ":source!". If the {scriptout} file exists, characters are - appended. - - -W {scriptout} - Like -w, but an existing file is overwritten. - - -x Use encryption when writing files. Will prompt for a crypt - key. - - -X Don't connect to the X server. Shortens startup time in a - terminal, but the window title and clipboard will not be - used. - - -y Start Vim in easy mode, just like the executable was called - "evim" or "eview". Makes Vim behave like a click-and-type - editor. - - -Z Restricted mode. Works like the executable starts with - "r". - - -- Denotes the end of the options. Arguments after this will - be handled as a file name. This can be used to edit a - filename that starts with a '-'. - - --echo-wid GTK GUI only: Echo the Window ID on stdout. - - --help Give a help message and exit, just like "-h". - - --literal Take file name arguments literally, do not expand wild- - cards. This has no effect on Unix where the shell expands - wildcards. - - --noplugin Skip loading plugins. Implied by -u NONE. - - --remote Connect to a Vim server and make it edit the files given in - the rest of the arguments. If no server is found a warning - is given and the files are edited in the current Vim. - - --remote-expr {expr} - Connect to a Vim server, evaluate {expr} in it and print - the result on stdout. - - --remote-send {keys} - Connect to a Vim server and send {keys} to it. - - --remote-silent - As --remote, but without the warning when no server is - found. - - --remote-wait - As --remote, but Vim does not exit until the files have - been edited. - - --remote-wait-silent - As --remote-wait, but without the warning when no server is - found. - - --serverlist - List the names of all Vim servers that can be found. - - --servername {name} - Use {name} as the server name. Used for the current Vim, - unless used with a --remote argument, then it's the name of - the server to connect to. - - --socketid {id} - GTK GUI only: Use the GtkPlug mechanism to run gvim in - another window. - - --version Print version information and exit. - -ON-LINE HELP - Type ":help" in Vim to get started. Type ":help subject" to get help - on a specific subject. For example: ":help ZZ" to get help for the - "ZZ" command. Use <Tab> and CTRL-D to complete subjects (":help cmd- - line-completion"). Tags are present to jump from one place to another - (sort of hypertext links, see ":help"). All documentation files can be - viewed in this way, for example ":help syntax.txt". - -FILES - /usr/local/lib/vim/doc/*.txt - The Vim documentation files. Use ":help doc-file-list" - to get the complete list. - - /usr/local/lib/vim/doc/tags - The tags file used for finding information in the docu- - mentation files. - - /usr/local/lib/vim/syntax/syntax.vim - System wide syntax initializations. - - /usr/local/lib/vim/syntax/*.vim - Syntax files for various languages. - - /usr/local/lib/vim/vimrc - System wide Vim initializations. - - ~/.vimrc Your personal Vim initializations. - - /usr/local/lib/vim/gvimrc - System wide gvim initializations. - - ~/.gvimrc Your personal gvim initializations. - - /usr/local/lib/vim/optwin.vim - Script used for the ":options" command, a nice way to - view and set options. - - /usr/local/lib/vim/menu.vim - System wide menu initializations for gvim. - - /usr/local/lib/vim/bugreport.vim - Script to generate a bug report. See ":help bugs". - - /usr/local/lib/vim/filetype.vim - Script to detect the type of a file by its name. See - ":help 'filetype'". - - /usr/local/lib/vim/scripts.vim - Script to detect the type of a file by its contents. - See ":help 'filetype'". - - /usr/local/lib/vim/print/*.ps - Files used for PostScript printing. - - For recent info read the VIM home page: - <URL:http://www.vim.org/> - -SEE ALSO - vimtutor(1) - -AUTHOR - Most of Vim was made by Bram Moolenaar, with a lot of help from others. - See ":help credits" in Vim. - Vim is based on Stevie, worked on by: Tim Thompson, Tony Andrews and - G.R. (Fred) Walter. Although hardly any of the original code remains. - -BUGS - Probably. See ":help todo" for a list of known problems. - - Note that a number of things that may be regarded as bugs by some, are - in fact caused by a too-faithful reproduction of Vi's behaviour. And - if you think other things are bugs "because Vi does it differently", - you should take a closer look at the vi_diff.txt file (or type :help - vi_diff.txt when in Vim). Also have a look at the 'compatible' and - 'cpoptions' options. - - - - 2006 Apr 11 VIM(1) diff --git a/runtime/doc/vimdiff-fr.1 b/runtime/doc/vimdiff-fr.1 deleted file mode 100644 index 67a64e381b..0000000000 --- a/runtime/doc/vimdiff-fr.1 +++ /dev/null @@ -1,54 +0,0 @@ -.TH VIMDIFF 1 "30 mars 2001" -.SH NOM -vimdiff \- ouvre deux, trois ou quatre versions d'un fichier dans Vim et -affiche leurs diffИrences -.SH SYNOPSIS -.br -.B vimdiff -[options] fichier1 fichier2 [fichier3 [fichier4]] -.PP -.B gvimdiff -.SH DESCRIPTION -.B Vimdiff -dИmarre -.B Vim -avec deux (ou trois ou quatre) fichiers. -Chaque fichier est ouvert dans sa propre fenЙtre. -Les diffИrences entre ces fichiers sont mises en surbrillance. -C'est un outil trХs pratique pour visualiser et reporter les -changements entre deux versions d'un mЙme fichier. -.PP -Consulter vim(1) pour des informations sur l'Иditeur Vim lui-mЙme. -.PP -Si -.B gvimdiff -est invoquИ, l'IHM graphique est dИmarrИe quand elle est disponible. -.PP -L'option 'diff' est activИe dans chacune des fenЙtres, ce qui provoque la mise -en surbrillance des diffИrences. -.br -Les options 'wrap' et 'scrollbind' sont activИes pour donner un aspect -agrИable au texte. -.br -L'option 'foldmethod' est fixИe Ю "diff", ce qui replie les lignes consИcutives -identiques. 'foldcolumn' est fixИ Ю 2 pour trouver les replis rapidement et -les ouvrir ou les fermer facilement. -.SH ARGUMENTS -La fenЙtre de Vim est partagИe verticalement afin d'afficher les lignes -correspondantes les unes en face des autres, comme si l'argument "\-O" Иtait -spИcifiИ. Utilisez l'argument "\-o" pour obtenir un partage horizontal Ю la -place. -.PP -Pour connaНtre les autres arguments disponibles, consultez vim(1). -.SH VOIR AUSSI -vim(1) -.SH AUTEUR -La majeure partie de -.B Vim -a ИtИ Иcrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. -Voir ":help credits" dans -.B Vim. -.SH TRADUCTION -Cette page de manuel a ИtИ traduite par David Blanchet -<david.blanchet@free.fr> 2005-03-12. -Mise Ю jour 2012-05-06, Dominique PellИ <dominique.pelle@gmail.com> diff --git a/runtime/doc/vimdiff-it.1 b/runtime/doc/vimdiff-it.1 deleted file mode 100755 index 2203877acf..0000000000 --- a/runtime/doc/vimdiff-it.1 +++ /dev/null @@ -1,48 +0,0 @@ -.TH VIMDIFF 1 "30 marzo 2001" -.SH NOME -vimdiff \- modifica due, tre o quattro versioni di un file con Vim, -visualizzando le differenze -.SH SINTASSI -.br -.B vimdiff -[opzioni] file1 file2 [file3 [file4]] -.PP -.B gvimdiff -.SH DESCRIZIONE -.B Vimdiff -inizia -.B Vim -per due (o tre o quattro) file. -Ogni file ha una sua finestra. -Le differenze fra file sono evidenziate. -х 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-pl.1 b/runtime/doc/vimdiff-pl.1 deleted file mode 100644 index 5332f78328..0000000000 --- a/runtime/doc/vimdiff-pl.1 +++ /dev/null @@ -1,46 +0,0 @@ -.TH VIMDIFF 1 "2001 Mar 30" -.SH NAZWA -vimdiff \- edytuj dwie, trzy lub cztery wersje pliku w Vimie i zobacz rС©nice -.SH SYNOPSIS -.br -.B vimdiff -[opcje] plik1 plik2 [plik3 [plik4]] -.PP -.B gvimdiff -.SH OPIS -.B Vimdiff -uruchomi -.B Vima -z dwoma (trzema lub czterema 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 siЙ -wygodnie przegl╠daЁo. -.br -Opcja 'foldmethod' zostanie ustawiona na "diff", dziЙki czemu -niezmienione linie zostan╠ zwiniЙte. 'foldcolumn' bЙdzie rСwne 2 aby -Ёatwo wyszukiwaФ, otwieraФ i zamykaФ zwiniЙcia. -.SH OPCJE -Pionowy podziaЁ zostanie 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-ru.1 b/runtime/doc/vimdiff-ru.1 deleted file mode 100644 index 385536790e..0000000000 --- a/runtime/doc/vimdiff-ru.1 +++ /dev/null @@ -1,50 +0,0 @@ -.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/vimdiff.man b/runtime/doc/vimdiff.man deleted file mode 100644 index 913ac13847..0000000000 --- a/runtime/doc/vimdiff.man +++ /dev/null @@ -1,46 +0,0 @@ -VIMDIFF(1) VIMDIFF(1) - - - -NAME - vimdiff - edit two, three or four versions of a file with Vim and show - differences - -SYNOPSIS - vimdiff [options] file1 file2 [file3 [file4]] - - gvimdiff - -DESCRIPTION - Vimdiff starts Vim on two (or three or four) files. Each file gets its - own window. The differences between the files are highlighted. This - is a nice way to inspect changes and to move changes from one version - to another version of the same file. - - See vim(1) for details about Vim itself. - - When started as gvimdiff the GUI will be started, if available. - - In each window the 'diff' option will be set, which causes the differ- - ences to be highlighted. - The 'wrap' and 'scrollbind' options are set to make the text look good. - The 'foldmethod' option is set to "diff", which puts ranges of lines - without changes in a fold. 'foldcolumn' is set to two to make it easy - to spot the folds and open or close them. - -OPTIONS - Vertical splits are used to align the lines, as if the "-O" argument - was used. To use horizontal splits instead, use the "-o" argument. - - For all other arguments see vim(1). - -SEE ALSO - vim(1) - -AUTHOR - Most of Vim was made by Bram Moolenaar, with a lot of help from others. - See ":help credits" in Vim. - - - - 2001 March 30 VIMDIFF(1) diff --git a/runtime/doc/vimtutor-fr.1 b/runtime/doc/vimtutor-fr.1 deleted file mode 100644 index 06e03fbef3..0000000000 --- a/runtime/doc/vimtutor-fr.1 +++ /dev/null @@ -1,60 +0,0 @@ -.TH VIMTUTOR 1 "2 avril 2001" -.SH NAME -vimtutor \- tutoriel Vim -.SH SYNOPSIS -.br -.B vimtutor [\-g] [langue] -.SH DESCRIPTION -.B Vimtutor -lance le tutoriel -.B Vim -\. -Il copie d'abord le fichier du tutoriel, afin que vous puissiez le modifier -sans altИrer le fichier original. -.PP -.B Vimtutor -est utile pour les personnes souhaitant apprendre leurs premiХres commandes -.B Vim -\. -.PP -L'argument optionnel \-g lance vimtutor avec gvim plutТt qu'avec vim, si l'IHM -graphique de vim est disponible, ou le lance avec vim si gvim n'est pas -disponible. -.PP -L'argument optionnel [langue] est le nom d'une langue, spИcifiИe par son -symbole Ю deux lettres, tels que "it" ou "es". Si l'argument [langue] est omis, -la langue de la rИgion linguistique actuelle sera retenue. Si le tutoriel est -disponible dans cette langue, il est proposИ. Sinon, c'est la version anglaise -qui est proposИe. -.PP -.B Vim -est toujours lancИ en mode Compatible Vi. -.SH FICHIERS -.TP 15 -/usr/local/lib/vim/tutor/tutor[.langue] -Les fichiers textes de -.B Vimtutor -\. -.TP 15 -/usr/local/lib/vim/tutor/tutor.vim -Le script Vim utilisИ pour copier les fichiers texte de -.B Vimtutor -\. -.SH AUTEUR -.B Vimtutor -a ИtИ Иcrit Ю l'origine pour Vi par Michael C. Pierce et Robert K. Ware, de la -Colorado School of Mines, en reprenant des idИes Иmises par Charles Smith, de -la Colorado State University. -E-mail : bware@mines.colorado.edu. -.br -Il a ИtИ modifiИ pour -.B Vim -par Bram Moolenaar. -Pour connaНtre le nom des traducteurs, consultez les fichiers textes du -tutoriel. -.SH VOIR AUSSI -vim(1) -.SH TRADUCTION -Cette page de manuel a ИtИ traduite par David Blanchet -<david.blanchet@free.fr> 2004-12-27. -Mise Ю jour 2012-05-06, Dominique PellИ <dominique.pelle@gmail.com> diff --git a/runtime/doc/vimtutor-it.1 b/runtime/doc/vimtutor-it.1 deleted file mode 100755 index b5c1e61e01..0000000000 --- a/runtime/doc/vimtutor-it.1 +++ /dev/null @@ -1,58 +0,0 @@ -.TH VIMTUTOR 1 "2 aprile 2001" -.SH NOME -vimtutor \- Un breve corso per imparare Vim -.SH SINTASSI -.br -.B vimtutor [\-g] [lingua] -.SH DESCRIZIONE -.B Vimtutor -inizia il -.B Vim -tutor (una breve corso per imparare Vim). -Per prima cosa viene creata una copia del file di lavoro, che puР cosЛ essere -modificato senza alterare il file usato come modello. -.PP -Il comando -.B Vimtutor -Х utile a chi voglia imparare i primi comandi -.B Vim -. -.PP -L'argomento opzionale \-g inizia vimtutor usando gvim invece che vim, se la -versione GUI di vim Х disponibile. oppure utilizza vim, se gvim non Х -disponibile. -.PP -L'arogmento opzionale [lingua] Х l'abbreviazione di due lettere del nome -di una lingua, per esempio "it" oppure "es". -se L'argomento [lingua] non viene specificato, si utilizza la lingua "locale" -del computer. -Se la versione in quella lingua del "tutor" Х disponibile, sarЮ usata. -Altrimenti sarЮ usata la versione inglese. -.PP -.B Vim -Х sempre iniziato in Modo compatibile con vi. -.SH FILE -.TP 15 -/usr/local/lib/vim/tutor/tutor[.language] -Il/I file di testo per -.B Vimtutor - -.TP 15 -/usr/local/lib/vim/tutor/tutor.vim -Lo script di Vim usato per copiare il file di testo -.B Vimtutor -. -.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 -х 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-pl.1 b/runtime/doc/vimtutor-pl.1 deleted file mode 100644 index e603ca5b8f..0000000000 --- a/runtime/doc/vimtutor-pl.1 +++ /dev/null @@ -1,51 +0,0 @@ -.TH VIMTUTOR 1 "2001 Kwi 2" -.SH NAZWA -vimtutor \- nauczyciel Vima -.SH SYNOPSIS -.br -.B vimtutor -g [jЙzyk] -.SH OPIS -.B Vimtutor -uruchamia nauczyciela -.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 \-g uruchamia vimtutor w gvimie a nie w Vimie je╤li -graficzna wersja Vima jest dostЙpna, je╤li nie zostanie uruchomiony Vim. -.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[.jЙzyk] -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 Vi 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-ru.1 b/runtime/doc/vimtutor-ru.1 deleted file mode 100644 index fa3c5d9b08..0000000000 --- a/runtime/doc/vimtutor-ru.1 +++ /dev/null @@ -1,51 +0,0 @@ -.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/vimtutor.man b/runtime/doc/vimtutor.man deleted file mode 100644 index 9f2350a0ae..0000000000 --- a/runtime/doc/vimtutor.man +++ /dev/null @@ -1,50 +0,0 @@ -VIMTUTOR(1) VIMTUTOR(1) - - - -NAME - vimtutor - the Vim tutor - -SYNOPSIS - vimtutor [-g] [language] - -DESCRIPTION - Vimtutor starts the Vim tutor. It copies the tutor file first, so that - it can be modified without changing the original file. - - The Vimtutor is useful for people that want to learn their first Vim - commands. - - The optional argument -g starts vimtutor with gvim rather than vim, if - the GUI version of vim is available, or falls back to Vim if gvim is - not found. - - 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. - - Vim is always started in Vi compatible mode. - -FILES - /usr/local/lib/vim/tutor/tutor[.language] - The Vimtutor text file(s). - - /usr/local/lib/vim/tutor/tutor.vim - The Vim script used to copy the Vimtutor text file. - -AUTHOR - The Vimtutor was originally written for Vi by Michael C. Pierce and - Robert K. Ware, Colorado School of Mines using ideas supplied by - Charles Smith, Colorado State University. E-mail: bware@mines.colБ─░ - orado.edu. - It was modified for Vim by Bram Moolenaar. For the names of the transБ─░ - lators see the tutor files. - -SEE ALSO - vim(1) - - - - 2001 April 2 VIMTUTOR(1) diff --git a/runtime/doc/xxd-fr.1 b/runtime/doc/xxd-fr.1 deleted file mode 100644 index be780858bf..0000000000 --- a/runtime/doc/xxd-fr.1 +++ /dev/null @@ -1,396 +0,0 @@ -.TH XXD 1 "aoШt 1996" "Page de manuel pour 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> -.\" French translation by David Blanchet <david.blanchet@free.fr> 2005-03 -.SH NOM -.I xxd -\- convertit en reprИsentation hexadИcimale et inversement. -.SH SYNOPSIS -.B xxd -\-h[elp] -.br -.B xxd -[options] [fichier_entree [fichier_sortie]] -.br -.B xxd -\-r[evert] [options] [fichier_entree [fichier_sortie]] -.SH DESCRIPTION -.I xxd -crИe un fichier contenant la reprИsentation hexadИcimale d'un fichier -binaire ou de l'entrИe standard. -Il peut Иgalement convertir un fichier de codes hexadИcimaux en un fichier -binaire. -Comme -.BR uuencode (1) -et -.BR uudecode (1) -il permet la transmission de donnИes binaires dans une reprИsentation ASCII -compatible avec le courrier Иlectronique, mais a l'avantage de dИcoder la -sortie standard. -De plus, il peut Йtre utilisИ pour appliquer des rustines Ю des fichiers -binaires. -.SH OPTIONS -Si aucun -.I fichier_entree -n'est spИcifiИ, l'entrИe standard est utilisИe. -Si -.I fichier_entree -correspond au caractХre -.RB '\-' -\, l'entrИe standard est employИe comme source des donnИes en entrИe. -Si aucun -.I fichier_sortie -n'est spИcifiИ (ou qu'un caractХre -.RB '\-' -est donnИ Ю sa place), le rИsultat est envoyИ sur la sortie standard. -.PP -NOTE : un analyseur paresseux est utilisИ. Il ne vИrifie pas au-delЮ de la -premiХre lettre de l'option, Ю moins que cette derniХre ne requiert un -paramХtre. -L'espace entre l'option et son paramХtre est optionnel. -Les paramХtres des options peuvent Йtre spИcifiИs en notation dИcimale, -hexadИcimale ou octale. -Ainsi -.BR \-c8 , -.BR "\-c 8" , -.B \-c 010 -et -.B \-cols 8 -sont tous Иquivalents. -.TP -.IR \-a " | " \-autoskip -active la fonctionnalitИ "autoskip" : le caractХre '*' remplace les lignes -d'octets nuls. DИsactivИe par dИfaut. -.TP -.IR \-b " | " \-bits -Convertit en binaires plutТt qu'en hexadИcimal. -Cette option Иcrit les octets comme une sИquence de "1" et de "0" au lieu -d'une conversion en hexadИcimal traditionnel. Chaque ligne est prИcИdИe par un -numИro de ligne en hexadИcimal et suivie de la reprИsentation ASCII (ou -EBCDIC) correspondante. Les options \-r, \-p, \-i ne fonctionnent pas dans ce -mode. -.TP -.IR "\-c cols " | " \-cols cols" -place -.RI < cols > -octets par ligne. 16 par dИfaut (\-i : 12, \-ps : 30, \-b : 6). Maximum 256. -.TP -.IR \-E " | " \-EBCDIC -Passe le codage des caractХres de la colonne de droite de ASCII Ю EBCDIC. -Cela ne change pas la reprИsentation hexadИcimale. Cette option est sans effet -quand elle est utilisИe avec \-r, \-p or \-i. -.TP -.IR "\-g octets " | " \-groupsize octets" -Regroupe les octets (deux chiffres hexadИcimaux ou huit chiffres binaires) -par groupe de -.RI < octets > -\, sИparИs par des espaces blancs. SpИcifiez -.I \-g 0 -pour supprimer le regroupement. -.RI < octets > -vaut 2 par dИfaut dans le mode normal et \fI1\fP en -reprИsentation binaire. Le regroupement ne s'applique pas aux styles -Postscript et Include. -.TP -.IR \-h " | " \-help -Affiche un rИsumИ des commandes disponibles et quitte. Aucune conversion n'est -effectuИe. -.TP -.IR \-i " | " \-include -produit une sortie dans le style #include (fichier C Ю inclure). La dИfinition -complХte d'un tableau statique est Иcrite et est nommИe d'aprХs le fichier -d'origine, Ю moins que xxd lise depuis l'entrИe standard. -.TP -.IR "\-l long " | " \-len long" -ArrЙte aprХs l'Иcriture de -.RI < long > -octets. -.TP -.IR \-p " | " \-ps " | " \-postscript " | " \-plain -Produit une conversion continue dans le style Postscript (postscript continuous -hexdumd style). -иgalement connu sous le nom de ╚ conversion brute ╩ (plain hexdump style). -.TP -.IR \-r " | " \-revert -OpИration inverse : convertit un fichier hexadИcimal en un fichier binaire (ou -applique une rustine Ю un fichier binaire). -Si l'Иcriture n'a pas lieu sur la sortie standard, xxd Иcrit dans le fichier -qu'il produit sans le tronquer. Utilisez la combinaison -.I \-r \-p -pour lire de l'hexadИcimal brut sans information sur le numИro des lignes et -sans format de colonnes particulier. Des espaces blancs et coupures de lignes -supplИmentaires sont autorisИs Ю n'importe quel endroit. -.TP -.I \-seek dИcalage -UtilisИ aprХs l'option -.IR \-r : -inverse la conversion en ajoutant -.RI < dИcalage > -aux positions dans le fichier donnИes dans le code hexadИcimal. -.TP -.I \-s [+][\-]dИcalage -DИbute au -.RI < dИcalage > -absolu ou relatif dans fichier_entree. -\fI+ \fRindique que le dИcalage est relatif Ю la position courante dans -l'entrИe standard (sans effet si la lecture n'a pas lieu sur l'entrИe -standard). \fI\- \fRindique un dИcalage en caractХres depuis la fin de -l'entrИe (utilisИ avec \fI+\fR, dИsigne la position avant la position -actuelle de l'entrИe standard). -Sans l'option \-s, xxd dИmarre Ю la position courante du fichier. -.TP -.I \-u -Utilise des chiffres hexadИcimaux majuscules. La casse par dИfaut est -minuscule. -.TP -.IR \-v " | " \-version -Affiche la version de xxd. -.SH MISE EN GARDE -.I xxd \-r -effectue des opИrations internes un peu obscures lors de l'Иvaluation -des informations sur les numИros de lignes. Si le fichier de sortie est -adressable, alors les numИros de lignes au dИbut de chaque ligne d'hexadИcimal -peuvent Йtre dИsordonnИes, des lignes peuvent manquer ou se chevaucher. Dans -ces cas, xxd utilisera lseek(2) pour dИterminer la prochaine position. Si le -fichier n'est pas adressable, seuls les vides sont autorisИs, et ils seront -comblИs par des octets nuls. -.PP -.I xxd \-r -ne gИnХre aucune erreur lors de l'analyse. Les problХmes sont passИs -silencieusement. -.PP -Lors de l'Иdition de la reprИsentation hexadИcimale, veuillez noter que -.I xxd \-r -ignore tout ce qui se trouve sur la ligne aprХs avoir lu suffisamment de -donnИes hexadИcimales (voir l'option \-c). Cela signifie Иgalement que les -modifications dans la colonne ASCII (ou EBCDIC) sont toujours ignorИes. La -conversion inverse de donnИes hexadИcimales brutes (postscript) avec xxd \-r -\-p ne dИpend pas d'un nombre correct de colonnes. Dans ce cas, tout ce qui -ressemble Ю une paire de chiffres hexadИcimaux est interprИtИ. -.PP -Remarquez la diffИrence entre -.br -\fI% xxd \-i fichier\fR -.br -et -.br -\fI% xxd \-i < fichier\fR -.PP -.I xxd \-s \+seek -peut diffИrer de -.IR "xxd \-s seek" , -car lseek(2) est utilisИ pour ╚ revenir en arriХre ╩. Le '+' fait une -diffИrence quand la source des donnИes est l'entrИe standard et si la position -dans le fichier de l'entrИe standard n'est pas au dИbut du fichier lorsque xxd -est dИmarrИ et qu'il reГoit ses donnИes. -L'exemple suivant peut vous aider Ю comprendre (ou bien vous perdre davantage -encore !)... -.PP -Remettre l'entrИe standard au dИpart avant de lire ; nИcessaire car 'cat' a -dИjЮ lu jusqu'Ю la fin de l'entrИe standard. -.br -\fI% sh \-c 'cat > donnees_binaires; xxd \-s 0 > donnees_hexa' < fichier\fR -.PP -Convertir Ю partir de la position 0x480 (= 1024 + 128) du fichier. -Le symbole '+' signifie "relativement Ю la position actuelle', ainsi 128 est -ajoutИ aux 1024 octets comptabilisИs pour dd. -.br -\fI% sh \-c 'dd of=donnees_binaires bs=1k count=1; xxd \-s +128 > -donnees_hexa' < fichier\fR -.PP -Convertir de fichier depuis la position 0x100 (= 1024 \- 768) du fichier. -.br -\fI% sh \-c 'dd of=donnees_binaires bs=1k count=1; xxd \-s +\-768 > -donnees_hexa' < fichier\fR -.PP -Toutefois, cette situation est peu frИquente et l'utilisation de '+' est -rarement requise. L'auteur prИfХre surveiller les effets de xxd avec strace(1) -ou truss(1) quand \-s est employИ. -.SH EXEMPLES -Afficher la totalitИ du -.B fichier -sauf les trois premiХres lignes (0x30 octets en hexadИcimal). -.br -\fI% xxd \-s 0x30 fichier\fR -.PP -afficher les trois derniХres lignes (0x30 octets en hexadИcimal) du -.B fichier -\. -.br -\fI% xxd \-s \-0x30 fichier\fR -.PP -.br -Afficher 120 octets convertis en continu, avec 20 octets par ligne. -.br -\fI% xxd \-l 120 \-ps \-c 20 xxd\-fr.1\fR -.br -2e54482058584420312022616ffb742031393936 -.br -22202250616765206465206d616e75656c20706f -.br -757220787864220a2e5c220a2e5c222032317374 -.br -204d617920313939360a2e5c22204d616e207061 -.br -676520617574686f723a0a2e5c2220202020546f -.br -6e79204e7567656e74203c746f6e79407363746e -.br -204e7567656e74203c746f6e79407363746e7567 -.br -2e54482058584420312022417567757374203139 -.PP -Convertir les 120 premiers octets de cette page de manuel avec 12 octets par -ligne. -.br -\fI% xxd \-l 120 \-c 12 xxd\-fr.1\fR -.br -0000000: 2e54 4820 5858 4420 3120 2261 .TH XXD 1 "a -.br -000000c: 6ffb 7420 3139 3936 2220 2250 o.t 1996" "P -.br -0000018: 6167 6520 6465 206d 616e 7565 age de manue -.br -0000024: 6c20 706f 7572 2078 7864 220a l pour xxd". -.br -0000030: 2e5c 220a 2e5c 2220 3231 7374 .\"..\" 21st -.br -000003c: 204d 6179 2031 3939 360a 2e5c May 1996..\ -.br -0000048: 2220 4d61 6e20 7061 6765 2061 " Man page a -.br -0000054: 7574 686f 723a 0a2e 5c22 2020 uthor:..\" -.br -0000060: 2020 546f 6e79 204e 7567 656e Tony Nugen -.br -000006c: 7420 3c74 6f6e 7940 7363 746e t <tony@sctn -.PP -Afficher la date Иcrite au dИbut du fichier xxd\-fr.1. -.br -\fI% xxd \-s 0x38 \-l 13 \-c 13 xxd.1\fR -.br -0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 -.PP -Copier -.B fichier_entree -vers -.B fichier_sortie -en ajoutant 100 octets de valeur 0x00 avant. -.br -\fI% xxd fichier_entree | xxd \-r \-s 100 \> fichier_sortie\fR -.PP -Patcher la date dans le fichier xxd.1 -.br -\fI% echo '0000037: 3574 68' | xxd \-r \- xxd\-fr.1\fR -.br -\fI% xxd \-s 0x38 \-l 13 \-c 13 xxd\-fr.1\fR -.br -0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 -.PP -CrИer un fichier de 65537 octets tous nuls (0x00), -sauf le dernier qui vaut 'A' (0x41 en hexadИcimal). -.br -\fI% echo '010000: 41' | xxd \-r \> fichier\fR -.PP -.br -Convertir le fichier de l'exemple prИcИdent avec la fonctionnalitИ "autoskip". -.br -\fI% xxd \-a \-c 12 fichier\fR -.br -0000000: 0000 0000 0000 0000 0000 0000 ............ -.br -* -.br -000fffc: 0000 0000 40 ....A -.PP -CrИer un fichier d'un octet, contenant seulement le caractХre 'A'. -Le nombre aprХs '\-r \-s' s'ajoute aux numИros de lignes trouvИes dans le -fichier ; les octets initiaux sont supprimИs. -.br -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> fichier\fR -.PP -Utiliser xxd comme filtre dans un Иditeur tel que -.B vim(1) -pour convertir une zone comprise entre les marques 'a' et 'z'. -.br -\fI:'a,'z!xxd\fR -.PP -Utiliser xxd comme filtre dans un Иditeur tel que -.B vim(1) -pour rИcupИrer une conversion binaire comprise entre les marques 'a' et 'z'. -.br -\fI:'a,'z!xxd \-r\fR -.PP -Utiliser xxd comme filtre dans un Иditeur tel que -.B vim(1) -pour rИcupИrer une ligne convertie. Placez le curseur sur la ligne et tapez : -.br -\fI!!xxd \-r\fR -.PP -Lire des caractХres depuis une connexion sИrie : -.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 -.SH VALEURS DE RETOUR -Les erreurs suivantes sont rapportИes : -.TP -0 -aucune erreur ne s'est produit. -.TP -\-1 -opИration non supportИe ( -.I xxd \-r \-i -reste impossible). -.TP -1 -erreur lors de l'analyse des options. -.TP -2 -problХme avec le fichier d'entrИe. -.TP -3 -problХme avec le fichier de sortie. -.TP -4, 5 -la position spИcifiИe n'est pas atteignable. -.SH VOIR AUSSI -uuencode(1), uudecode(1), patch(1) -.SH AVERTISSEMENTS -L'ИtrangetИ de cet outil reflХte celle du cerveau de ses crИateurs. -Utilisez cet outil Ю vos risques et pИrils. Dupliquez vos fichiers. -Surveillez l'outil. Devenez un gourou. -.SH VERSION -Cette page de manuel documente la version 1.7 de xxd. -.SH AUTEUR -(c) 1990-1997 par Juergen Weigert -.br -<jnweiger@informatik.uni-erlangen.de> -.LP -"Distribute freely and credit me, -.br -make money and share with me, -.br -lose money and don't ask me." -.PP -Distribution libre en citant l'auteur, -.br -gagnez de l'argent, pensez Ю moi, -.br -perdez de l'argent, oubliez-moi. -.PP -Page de manuel dИbutИe par Tony Nugent -.br -<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> -.br -Modifications mineures par Bram Moolenaar. -иditИ par Juergen Weigert. -.SH TRADUCTION -Cette page de manuel a ИtИ traduite par David Blanchet -<david.blanchet@free.fr> 2004-12-24. -Mise Ю jour 2013-05-10, Dominique PellИ <dominique.pelle@gmail.com> diff --git a/runtime/doc/xxd-it.1 b/runtime/doc/xxd-it.1 deleted file mode 100755 index 3d8dabb950..0000000000 --- a/runtime/doc/xxd-it.1 +++ /dev/null @@ -1,402 +0,0 @@ -.TH XXD 1 "Agosto 1996" "Pagina di manuale per xxd" -.\" -.\" 21 Maggio 1996 -.\" Autore della pagina di manuale: -.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> -.\" Modificato da Bram Moolenaar <Bram@vim.org> -.SH NOME -.I xxd -\- Produce esadecimale da un file binario o viceversa. -.SH SINTASSI -.B xxd -\-h[elp] -.br -.B xxd -[opzioni] [input_file [output_file]] -.br -.B xxd -\-r[evert] [opzioni] [input_file [output_file]] -.SH DESCRIZIONE -.I xxd -crea un'immagine esadecimale di un dato file o dello "standard input". -PuР anche ottenere da un'immagine esadecimale il file binario originale. -Come -.BR uuencode (1) -e -.BR uudecode (1) -permette di trasmettere dati binari in una rappresentazione ASCII "a prova -di email", ma ha anche il vantaggio di poter decodificare sullo "standard -output". Inoltre, puР essere usato per effettuare delle modifiche (patch) -a file binari. -.SH OPZIONI -Se non si specifica un -.I input_file -il programma legge dallo "standard input". -Se -.I input_file -Х specificato come il carattere -.RB \` \- ' -, l'input Х letto dallo "standard input". -Se non si specifica un -.I output_file -(o si mette al suo posto il carattere -.RB \` \- ' -), i risultati sono inviati allo "standard output". -.PP -Si noti che la scansione dei caratteri Х "pigra", e non controlla oltre -la prima lettera dell'opzione, a meno che l'opzione sia seguita da un -parametro. -Gli spazi fra una singola lettera di opzione e il corrispondente parametro -dopo di essa sono facoltativi. -I parametri delle opzioni possono essere specificati usando la notazione -decimale, esadecimale oppure ottale. -Pertanto -.BR \-c8 , -.BR "\-c 8" , -.B \-c 010 -e -.B \-cols 8 -sono notazioni equivalenti fra loro. -.PP -.TP -.IR \-a " | " \-autoskip -Richiesta di autoskip: Un singolo '*' rimpiazza linee di zeri binari. -Valore di default: off. -.TP -.IR \-b " | " \-bits -Richiesta di una immagine binaria (cifre binarie), invece che esadecimale. -Questa opzione scrive un byte come otto cifre "1" e "0" invece di usare i -numeri esadecimali. Ogni linea Х preceduta da un indirizzo in esadecimale e -seguita da una decodifica ascii (o ebcdic). Le opzioni specificabili dalla -linea comando \-r, \-p, \-i non funzionano in questo modo. -.TP -.IR "\-c colonne " | " \-cols colonne" -.IR "\-c colonne " | " \-cols colonne" -In ogni linea sono formattate -.RI < colonne > -colonne. Valore di default 16 (\-i: 12, \-ps: 30, \-b: 6). -Valore massimo 256. -.TP -.IR \-E " | " \-EBCDIC -Cambia la codifica della colonna di destra da ASCII a EBCDIC. -Questo non modifica la rappresentazione esadecimale. Non ha senso -specificare questa opzione in combinazione con \-r, \-p o \-i. -.TP -.IR "\-g numero_byte " | " \-groupsize numero_byte" -Inserisci ogni -.RI < numero_byte > -byte di output (di due caratteri esadecimali o otto numeri binari ognuno) -uno spazio bianco. -Specificando -.I \-g 0 -i byte di output non sono separati da alcuno spazio. -.RI < numero_byte > ha come valore di default " 2 -in modalitЮ normale [esadecimale] e \fI1\fP in modalitЮ binaria. -Il raggruppamento non si applica agli stili "PostScript" e "include". -.TP -.IR \-h " | " \-help -stampa un sommario dei comandi disponibili ed esce. Non viene fatto -null'altro. -.TP -.IR \-i " | " \-include -L'output Х nello stile dei file "include" in C. Viene preparata la -definizione completa di un "array" [vettore], dandogli il nome del -file di input), tranne che nel caso in cui xxd legga dallo "standard input". -.TP -.IR "\-l numero " | " \-len numero" -Il programma esce dopo aver scritto -.RI < numero > -byte. -.TP -.IR \-p " | " \-ps " | " \-postscript " | " \-plain -L'output Х nello stile di un dump continuo sotto postscript. -Noto anche come stile esadecimale semplice [plain]. -.TP -.IR \-r " | " \-revert -ricostruzione: converte (o mette una patch) a partire dall'immagine -esadecimale, creando [o modificando] il file binario. -Se non diretto allo "standard output", xxd scrive nel suo file di output -in maniera continua, senza interruzioni. Usare la combinazione -.I \-r \-p -per leggere dump in stile esadecimale semplice [plain], senza l'informazione -di numero di linea e senza un particolare tracciato di colonna. Degli spazi -o delle linee vuote possono essere inserite a piacere [e vengono ignorate]. -.TP -.I \-seek distanza -Usato con l'opzione -.IR \-r : -(ricostruzione), -.RI < distanza > -viene aggiunta alla posizione nel file trovata nella immagine -esadecimale. -.TP -.I \-s [+][\-]seek -Inizia a -.RI < seek > -byte assoluti (o relativi) di distanza all'interno di input_file. -\fI+ \fRindica che il "seek" Х relativo alla posizione corrente nel file -"standard input" (non significativa quando non si legge da "standard input"). -\fI\- \fRindica che il "seek" dovrebbe posizionarsi ad quel numero di -caratteri dalla fine dell'input (o se in combinazione con -\fI+ \fR: prime della posizione corrente nel file "standard input"). -Se non si specifica una opzione \-s, xxd inizia alla posizione -corrente all'interno del file. -.TP -.I \-u -usa lettere esadecimali maiuscole. Il valore di default Х di usare -lettere minuscole. -.TP -.IR \-v " | " \-version -visualizza la stringa contenente la versione del programma. -.SH ATTENZIONE -.PP -.I xxd \-r -Х capace di operare "magie" nell'utilizzare l'informazione "numero di linea". -Se sul file di output ci si puР posizionare usando la "seek", il numero di -linea all'inizio di ogni riga esadecimale puР essere non ordinato, delle -linee possono mancare delle linee, oppure esserci delle sovrapposizioni. -In simili casi xxd userЮ lseek(2) per raggiungere la posizione d'inizio. -Se il file di output non consente di usare "seek", sono permessi solo dei -"buchi", che saranno riempiti con zeri binari. -.PP -.I xxd \-r -non genera mai errori di specifica parametri. I parametri non riconosciuti -sono silenziosamente ignorati. -.PP -Nel modificare immagini esadecimali, tenete conto che -.I xxd \-r -salta il resto della linea, dopo aver letto abbastanza caratteri contenenti -dati esadecimali (vedere opzione \-c). CiР implica pure che le modifiche alle -colonne di caratteri stampabili ascii (o ebcdic) sono sempre ignorate. -La ricostruzione da un file immagine esadecimale in stile semplice -(postscript) con xxd \-r \-p non dipende dal numero corretto di colonne. -IN questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali -Х interpretata [e utilizzata]. -.PP -Notare la differenza fra -.br -\fI% xxd \-i file\fR -.br -e -.br -\fI% xxd \-i \< file\fR -.PP -.I xxd \-s \+seek -puР comportarsi in modo diverso da -.IR "xxd \-s seek" -, perchИ lseek(2) Х usata per tornare indietro nel file di input. Il '+' -fa differenza se il file di input Х lo "standard input", e se la posizione nel -file di "standard input" non Х all'inizio del file quando xxd Х eseguito, -con questo input. -I seguenti esempi possono contribuire a chiarire il concetto -(o ad oscurarlo!)... -.PP -Riavvolge lo "standard input" prima di leggere; necessario perchИ `cat' -ha giЮ letto lo stesso file ["file"] fino alla fine dello "standard input". -.br -\fI% sh \-c 'cat > copia_normale; xxd \-s 0 > copia_esadecimale' < file -.PP -Stampa immagine esadecimale dalla posizione file 0x480 (=1024+128) in poi. -Il segno `+' vuol dire "rispetto alla posizione corrente", quindi il `128' -si aggiunge a 1k (1024) dove `dd' si era fermato. -.br -\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +128 > esadecimale' < file -.PP -Immagine esadecimale dalla posizione 0x100 ( = 1024\-768 ) del file in avanti. -.br -\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale' < file -.PP -Comunque, questo capita raramente, e l'uso del `+' non serve quasi mai. -L'autore preferisce monitorare il comportamento di xxd con strace(1) o -truss(1), quando si usa l'opzione \-s. -.SH ESEMPI -.PP -.br -Stampa tutto tranne le prime tre linee (0x30 byte esadecimali) di -.B file -\. -.br -\fI% xxd \-s 0x30 file -.PP -.br -Stampa 3 linee (0x30 byte esadecimali) alla fine di -.B file -\. -.br -\fI% xxd \-s \-0x30 file -.PP -.br -Stampa 120 byte come immagine esadecimale continua con 20 byte per linea. -.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 -Stampa i primi 120 byte della pagina di manuale vim.1 a 12 byte per linea. -.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 -Visualizza la data dal file 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 -Copiare -.B input_file -su -.B output_file -premettendogli 100 byte a 0x00. -.br -\fI% xxd input_file | xxd \-r \-s 100 \> output_file\fR -.br - -.br -Modificare (patch) la data nel file 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 -Creare un file di 65537 byte tutto a 0x00, -tranne che l'ultimo carattere che Х una 'A' (esadecimale 0x41). -.br -\fI% echo '010000: 41' | xxd \-r \> file\fR -.PP -.br -Stampa una immagine esadecimale del file di cui sopra con opzione autoskip. -.br -\fI% xxd \-a \-c 12 file\fR -.br -0000000: 0000 0000 0000 0000 0000 0000 ............ -.br -* -.br -000fffc: 0000 0000 40 ....A -.PP -Crea un file di 1 byte che contiene il solo carattere 'A'. -Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file; -in pratica, i byte precedenti non sono stampati. -.br -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR -.PP -Usa xxd come filtro all'interno di un editor come -.B vim(1) -per ottenere una immagine esadecimale di una parte di file -delimitata dai marcatori `a' e `z'. -.br -\fI:'a,'z!xxd\fR -.PP -Usare xxd come filtro all'interno di un editor come -.B vim(1) -per ricostruire un pezzo di file binario da una immagine esadecimale -delimitata dai marcatori `a' e `z'. -.br -\fI:'a,'z!xxd \-r\fR -.PP -Usare xxd come filtro all'interno di un editor come -.B vim(1) -per ricostruire una sola linea di file binario da una immagine esadecimale, -Portare il cursore sopra la linea e battere: -.br -\fI!!xxd \-r\fR -.PP -Per leggere singoli caratteri da una linea seriale -.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 CODICI DI RITORNO -Il programma puР restituire questi codici di errore: -.TP -0 -nessun errore rilevato. -.TP -\-1 -operazione non supportata ( -.I xxd \-r \-i -non ancora possible). -.TP -1 -errore durante la scansione parametri. -.TP -2 -problemi con il file di input. -.TP -3 -problemi con il file di output. -.TP -4,5 -posizione "seek" specificata non raggiungibile all'interno del file. -.SH VEDERE ANCHE -uuencode(1), uudecode(1), patch(1) -.br -.SH AVVERTIMENTI -La stranezza dello strumento rispecchia la mente del suo creatore. -Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. -Diventate un mago. -.br -.SH VERSIONE -Questa pagina di manuale documenta la versione 1.7 di xxd. -.SH AUTORE -.br -(c) 1990-1997 Juergen Weigert -.br -<jnweiger@informatik.uni\-erlangen.de> -.LP -Distribuite liberamente ed attribuitemi il credito, -.br -fate soldi e condivideteli con me -.br -perdete soldi e non venite a chiederli a me. -.PP -Pagina di manuale messa in piedi da Tony Nugent -.br -<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> -.br -Piccole modifiche di Bram Moolenaar. -Modificato da Juergen Weigert. -.PP diff --git a/runtime/doc/xxd-pl.1 b/runtime/doc/xxd-pl.1 deleted file mode 100644 index d9fa9be203..0000000000 --- a/runtime/doc/xxd-pl.1 +++ /dev/null @@ -1,389 +0,0 @@ -.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 lub standardowego wej╤cia. -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 binarnego Ёatania plikСw. -.SH OPCJE -Je╤li nie podano -.I plik_we -xxd czyta ze standardowego wej╤cia. -Je╤li okre╤lono -.I plik_we -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 jako osiem cyfr 1 lub 0 zamiast normalnego -zrzutu heksowego. Ka©da linia jest poprzedzona przez -heksadecymalny numer linii a po nim jego reprezentacj╠ 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╠ wszЙdzie dozwolone. -.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 bezwglЙdnego (lub wzglЙdnego) offsetu 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: przed 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╠ po cichu 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 cokolwiek -co wygl╠da jak para znakСw 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. '+' stanowi -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\fR -.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\fR -.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\fR -.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\fR -.PP -.br -Wypisz trzy linie (heksowe 0x30 bajtСw) z koЯca -.B pliku -\. -.br -\fI% xxd \-s \-0x30 plik\fR -.PP -.br -Wypisz 120 bajtСw jako ci╠gЁy zrzut heksowy z 20 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-ru.1 b/runtime/doc/xxd-ru.1 deleted file mode 100644 index 111946ab52..0000000000 --- a/runtime/doc/xxd-ru.1 +++ /dev/null @@ -1,408 +0,0 @@ -.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 байтов в виде непрерывного шестнадцатеричного представления -по 20 октетов в строке: -.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.man b/runtime/doc/xxd.man deleted file mode 100644 index 057c8e911b..0000000000 --- a/runtime/doc/xxd.man +++ /dev/null @@ -1,262 +0,0 @@ -XXD(1) XXD(1) - - - -NAME - xxd - make a hexdump or do the reverse. - -SYNOPSIS - xxd -h[elp] - xxd [options] [infile [outfile]] - xxd -r[evert] [options] [infile [outfile]] - -DESCRIPTION - xxd creates a hex dump of a given file or standard input. It can also - convert a hex dump back to its original binary form. Like uuencode(1) - and uudecode(1) it allows the transmission of binary data in a `mail- - safe' ASCII representation, but has the advantage of decoding to stan- - dard output. Moreover, it can be used to perform binary file patching. - -OPTIONS - If no infile is given, standard input is read. If infile is specified - as a `-' character, then input is taken from standard input. If no - outfile is given (or a `-' character is in its place), results are sent - to standard output. - - Note that a "lazy" parser is used which does not check for more than - the first option letter, unless the option is followed by a parameter. - Spaces between a single option letter and its parameter are optional. - Parameters to options can be specified in decimal, hexadecimal or octal - notation. Thus -c8, -c 8, -c 010 and -cols 8 are all equivalent. - - - -a | -autoskip - toggle autoskip: A single '*' replaces nul-lines. Default off. - - -b | -bits - Switch to bits (binary digits) dump, rather than hexdump. This - option writes octets as eight digits "1"s and "0"s instead of a - normal hexadecimal dump. Each line is preceded by a line number - in hexadecimal and followed by an ascii (or ebcdic) representa- - tion. The command line switches -r, -p, -i do not work with this - mode. - - -c cols | -cols cols - format <cols> octets per line. Default 16 (-i: 12, -ps: 30, -b: - 6). Max 256. - - -E | -EBCDIC - Change the character encoding in the righthand column from ASCII - to EBCDIC. This does not change the hexadecimal representation. - The option is meaningless in combinations with -r, -p or -i. - - -g bytes | -groupsize bytes - separate the output of every <bytes> bytes (two hex characters - or eight bit-digits each) by a whitespace. Specify -g 0 to sup- - press grouping. <Bytes> defaults to 2 in normal mode and 1 in - bits mode. Grouping does not apply to postscript or include - style. - - -h | -help - print a summary of available commands and exit. No hex dumping - is performed. - - -i | -include - output in C include file style. A complete static array defini- - tion is written (named after the input file), unless xxd reads - from stdin. - - -l len | -len len - stop after writing <len> octets. - - -p | -ps | -postscript | -plain - output in postscript continuous hexdump style. Also known as - plain hexdump style. - - -r | -revert - reverse operation: convert (or patch) hexdump into binary. If - not writing to stdout, xxd writes into its output file without - truncating it. Use the combination -r -p to read plain hexadeci- - mal dumps without line number information and without a particu- - lar column layout. Additional Whitespace and line-breaks are - allowed anywhere. - - -seek offset - When used after -r: revert with <offset> added to file positions - found in hexdump. - - -s [+][-]seek - start at <seek> bytes abs. (or rel.) infile offset. + indicates - that the seek is relative to the current stdin file position - (meaningless when not reading from stdin). - indicates that the - seek should be that many characters from the end of the input - (or if combined with +: before the current stdin file position). - Without -s option, xxd starts at the current file position. - - -u use upper case hex letters. Default is lower case. - - -v | -version - show version string. - -CAVEATS - xxd -r has some builtin magic while evaluating line number information. - If the output file is seekable, then the linenumbers at the start of - each hexdump line may be out of order, lines may be missing, or over- - lapping. In these cases xxd will lseek(2) to the next position. If the - output file is not seekable, only gaps are allowed, which will be - filled by null-bytes. - - xxd -r never generates parse errors. Garbage is silently skipped. - - When editing hexdumps, please note that xxd -r skips everything on the - input line after reading enough columns of hexadecimal data (see option - -c). This also means, that changes to the printable ascii (or ebcdic) - columns are always ignored. Reverting a plain (or postscript) style - hexdump with xxd -r -p does not depend on the correct number of col- - umns. Here anything that looks like a pair of hex-digits is inter- - preted. - - Note the difference between - % xxd -i file - and - % xxd -i < file - - xxd -s +seek may be different from xxd -s seek, as lseek(2) is used to - "rewind" input. A '+' makes a difference if the input source is stdin, - and if stdin's file position is not at the start of the file by the - time xxd is started and given its input. The following examples may - help to clarify (or further confuse!)... - - Rewind stdin before reading; needed because the `cat' has already read - to the end of stdin. - % sh -c "cat > plain_copy; xxd -s 0 > hex_copy" < file - - Hexdump from file position 0x480 (=1024+128) onwards. The `+' sign - means "relative to the current position", thus the `128' adds to the 1k - where dd left off. - % sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +128 > hex_snippet" - < file - - Hexdump from file position 0x100 ( = 1024-768) on. - % sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +-768 > hex_snippet" - < file - - However, this is a rare situation and the use of `+' is rarely needed. - The author prefers to monitor the effect of xxd with strace(1) or - truss(1), whenever -s is used. - -EXAMPLES - Print everything but the first three lines (hex 0x30 bytes) of file. - % xxd -s 0x30 file - - Print 3 lines (hex 0x30 bytes) from the end of file. - % xxd -s -0x30 file - - Print 120 bytes as continuous hexdump with 20 octets per line. - % xxd -l 120 -ps -c 20 xxd.1 - 2e54482058584420312022417567757374203139 - 39362220224d616e75616c207061676520666f72 - 20787864220a2e5c220a2e5c222032317374204d - 617920313939360a2e5c22204d616e2070616765 - 20617574686f723a0a2e5c2220202020546f6e79 - 204e7567656e74203c746f6e79407363746e7567 - - Hexdump the first 120 bytes of this man page with 12 octets per line. - % xxd -l 120 -c 12 xxd.1 - 0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A - 000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" - 0000018: 224d 616e 7561 6c20 7061 6765 "Manual page - 0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\ - 0000030: 220a 2e5c 2220 3231 7374 204d "..\" 21st M - 000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\" - 0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut - 0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\" - 0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent - 000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug - - Display just the date from the file xxd.1 - % xxd -s 0x36 -l 13 -c 13 xxd.1 - 0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 - - Copy input_file to output_file and prepend 100 bytes of value 0x00. - % xxd input_file | xxd -r -s 100 > output_file - - Patch the date in the file xxd.1 - % echo "0000037: 3574 68" | xxd -r - xxd.1 - % xxd -s 0x36 -l 13 -c 13 xxd.1 - 0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 - - Create a 65537 byte file with all bytes 0x00, except for the last one - which is 'A' (hex 0x41). - % echo "010000: 41" | xxd -r > file - - Hexdump this file with autoskip. - % xxd -a -c 12 file - 0000000: 0000 0000 0000 0000 0000 0000 ............ - * - 000fffc: 0000 0000 40 ....A - - Create a 1 byte file containing a single 'A' character. The number - after '-r -s' adds to the linenumbers found in the file; in effect, the - leading bytes are suppressed. - % echo "010000: 41" | xxd -r -s -0x10000 > file - - Use xxd as a filter within an editor such as vim(1) to hexdump a region - marked between `a' and `z'. - :'a,'z!xxd - - Use xxd as a filter within an editor such as vim(1) to recover a binary - hexdump marked between `a' and `z'. - :'a,'z!xxd -r - - Use xxd as a filter within an editor such as vim(1) to recover one line - of a hexdump. Move the cursor over the line and type: - !!xxd -r - - Read single characters from a serial line - % xxd -c1 < /dev/term/b & - % stty < /dev/term/b -echo -opost -isig -icanon min 1 - % echo -n foo > /dev/term/b - - -RETURN VALUES - The following error values are returned: - - 0 no errors encountered. - - -1 operation not supported ( xxd -r -i still impossible). - - 1 error while parsing options. - - 2 problems with input file. - - 3 problems with output file. - - 4,5 desired seek position is unreachable. - -SEE ALSO - uuencode(1), uudecode(1), patch(1) - -WARNINGS - The tools weirdness matches its creators brain. Use entirely at your - own risk. Copy files. Trace it. Become a wizard. - -VERSION - This manual page documents xxd version 1.7 - -AUTHOR - (c) 1990-1997 by Juergen Weigert - <jnweiger@informatik.uni-erlangen.de> - - Distribute freely and credit me, - make money and share with me, - lose money and don't ask me. - - Manual page started by Tony Nugent - <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> - Small changes by Bram Moolenaar. Edited by Juergen Weigert. - - - - -Manual page for xxd August 1996 XXD(1) |