mirror of
https://github.com/neovim/neovim.git
synced 2025-02-25 18:55:25 -06:00
doc: remove encoding conversion targets
this deletes the source files wich have an utf-8 generated file. in the next step the generated *UTF-8.1* files will be renamed.
This commit is contained in:
Stefan Hoffmann
parent
1f7289b407
commit
7860b09f65
@ -264,32 +264,10 @@ HTMLS = \
|
|||||||
windows.html \
|
windows.html \
|
||||||
workshop.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
|
|
||||||
|
|
||||||
.SUFFIXES:
|
.SUFFIXES:
|
||||||
.SUFFIXES: .c .o .txt .html
|
.SUFFIXES: .c .o .txt .html
|
||||||
|
|
||||||
all: tags vim.man evim.man vimdiff.man vimtutor.man xxd.man $(CONVERTED)
|
all: tags vim.man evim.man vimdiff.man vimtutor.man xxd.man
|
||||||
|
|
||||||
# Use Vim to generate the tags file. Can only be used when Vim has been
|
# Use Vim to generate the tags file. Can only be used when Vim has been
|
||||||
# compiled and installed. Supports multiple languages.
|
# compiled and installed. Supports multiple languages.
|
||||||
@ -322,6 +300,7 @@ xxd.man: xxd.1
|
|||||||
uganda.nsis.txt: uganda.txt
|
uganda.nsis.txt: uganda.txt
|
||||||
sed -e 's/[ ]*\*[-a-zA-Z0-9.]*\*//g' -e 's/vim:tw=78://' \
|
sed -e 's/[ ]*\*[-a-zA-Z0-9.]*\*//g' -e 's/vim:tw=78://' \
|
||||||
uganda.txt | uniq >uganda.nsis.txt
|
uganda.txt | uniq >uganda.nsis.txt
|
||||||
|
# TODO(stefan991): add targets for translated manpages
|
||||||
|
|
||||||
# Awk version of .txt to .html conversion.
|
# Awk version of .txt to .html conversion.
|
||||||
html: noerrors tags $(HTMLS)
|
html: noerrors tags $(HTMLS)
|
||||||
@ -355,64 +334,3 @@ perlhtml: tags $(DOCS)
|
|||||||
clean:
|
clean:
|
||||||
-rm doctags *.html tags.ref
|
-rm doctags *.html tags.ref
|
||||||
|
|
||||||
# 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 $< >$@
|
|
||||||
|
|
||||||
xxd-ru.UTF-8.1: xxd-ru.1
|
|
||||||
iconv -f KOI8-R -t utf-8 $< >$@
|
|
||||||
|
|||||||
@ -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>
|
|
||||||
@ -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".
|
|
||||||
@ -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.
|
|
||||||
@ -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), которому помогает огромное
|
|
||||||
количество людей. См. меню Справка/Благодарности.
|
|
||||||
@ -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.
|
|
||||||
@ -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>
|
|
||||||
@ -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.
|
|
||||||
@ -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'.
|
|
||||||
@ -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'.
|
|
||||||
@ -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>
|
|
||||||
@ -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.
|
|
||||||
@ -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.
|
|
||||||
@ -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.
|
|
||||||
@ -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>
|
|
||||||
@ -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)
|
|
||||||
@ -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)
|
|
||||||
@ -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)
|
|
||||||
@ -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>
|
|
||||||
@ -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
|
|
||||||
@ -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
|
|
||||||
@ -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
|
|
||||||
Loading…
Reference in New Issue
Block a user