diff options
Diffstat (limited to 'runtime/doc/manpages')
31 files changed, 6998 insertions, 0 deletions
diff --git a/runtime/doc/manpages/de/vim-de.1 b/runtime/doc/manpages/de/vim-de.1 new file mode 100644 index 0000000000..f79e622a74 --- /dev/null +++ b/runtime/doc/manpages/de/vim-de.1 @@ -0,0 +1,478 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" Translated by bw1 (2008) and Florian Rehnisch <fm-r@gmx.de> (2012) +.\" Kudos to the folks on vim-dev and debian-l10n-german +.TH VIM 1 "2006 Apr 11" +.SH BEZEICHNUNG +vim \- Vi IMproved, ein Text\-Editor für Programmierer +.SH ÜBERSICHT +.br +\fBvim\fP [Optionen] [Datei …] +.br +\fBvim\fP [Optionen] \- +.br +\fBvim\fP [Optionen] \-t Tag +.br +\fBvim\fP [Optionen] \-q [Fehlerdatei] +.PP +.br +\fBex\fP +.br +\fBview\fP +.br +\fBgvim\fP \fBgview\fP \fBevim\fP \fBeview\fP +.br +\fBrvim\fP \fBrview\fP \fBrgvim\fP \fBrgview\fP +.SH BESCHREIBUNG +\fBVim\fP ist ein Text\-Editor, der aufwärtskompatibel zu Vi ist. Er kann +verwendet werden, um alle Arten von Klartext zu bearbeiten. Er ist besonders +nützlich, um Programme zu bearbeiten. +.PP +Vim hat einige Erweiterungen gegenüber Vi, z.B.: Rückgängigmachen in +mehreren Schritten, mehrere Fenster und Puffer, Syntax\-Hervorhebung, +Bearbeiten der Befehlszeile, Dateinamenergänzung, eingebaute Hilfe, visuelle +Auswahl, usw. … Siehe »:help vi_diff.txt« für eine Übersicht der +Unterschiede zwischen \fBVim\fP und Vi. +.PP +Im laufenden \fBVim\fP kann mit dem Befehl »:help« viel Hilfe durch das +eingebaute Hilfesystem erlangt werden. Siehe den Abschnitt EINGEBAUTE HILFE +weiter unten. +.PP +Meistens wird \fBVim\fP zum Editieren einer einzigen Datei mit dem folgende +Befehl gestartet: +.PP + vim Datei +.PP +Allgemeiner betrachtet, wird \fBVim\fP folgendermaßen gestartet: +.PP + vim [Optionen] [Dateiliste] +.PP +Bei einer fehlenden Dateiliste startet der Editor mit einem leeren +Puffer. Andernfalls werden nach den folgenden vier Möglichkeiten eine oder +mehrere Dateien bearbeitet: +.TP 12 +Datei … +Eine Liste von Dateinamen. Die erste Datei wird in den Puffer geladen und +zur aktuellen. Der Cursor wird auf der ersten Zeile des Puffers +platziert. Zu den anderen Dateien kann mit dem Befehl »:next« gelangt +werden. Falls einer der Dateinamen mit einem Bindestrich beginnt, stellen +Sie der Dateiliste »\-\-« voran. +.TP +\- +Die zu bearbeitende Datei wird von der Standardeingabe gelesen. Befehle +werden von der Standardfehlerausgabe gelesen, die ein Text\-Terminal sein +sollte. +.TP +\-t {Tag} +Die zu editierende Datei und die anfängliche Cursor\-Position hängen von +einem »Tag« ab, einer Art Sprungmarke. {Tag} wird in der Tag\-Datei +nachgeschlagen, die zugehörige Datei wird zur aktuellen und der zugehörige +Befehl wird ausgeführt. Dies wird meistens für Programme in der Sprache »C« +benutzt, wobei {Tag} ein Funktionsname sein könnte. Die Wirkung dieses +Befehls ist, dass die Datei, die die Funktion enthält, als aktuelle im +Editor geöffnet und angezeigt wird und der Cursor auf dem Beginn der +Funktion positioniert wird. Siehe »:help tag\-commands«. +.TP +\-q [Fehlerdatei] +Startet im QuickFix\-Modus. Die Datei [Fehlerdatei] wird gelesen und der +erste Fehler wird angezeigt. Falls [Fehlerdatei] ausgelassen wird, wird der +Dateiname aus der Option 'errorfile' verwendet (bei AmigaOS ist dies +vorgabemäßig »AztecC.Err«, sowie „errors.err« bei anderen). Weitere Fehler +können mit dem »:cn«\-Befehl angesprungen werden. Siehe „:help quickfix«. +.PP +\fBVim\fP reagiert unterschiedlich auf den Namen, der verwendet wird, um Vim zu +starten (die ausführbare Datei kann dieselbe sein). +.TP 10 +vim +der »normale« Weg, alles ist standardmäßig +.TP +ex +Startet im Ex\-Modus. Mit dem Befehl »:vi« gelangt man in den normalen +Modus. Funktioniert auch mit dem Argument »\-e«. +.TP +view +Startet im Nur\-Lesen\-Modus. Die Datei wird vor dem Überschreiben +geschützt. Dasselbe wird mit dem Parameter »\-R« erreicht. +.TP +gvim gview +Die grafische Version: Öffnet ein neues Fenster. Dasselbe wird mit dem +Parameter »\-g« erreicht. +.TP +evim eview +Die grafische Version im einfachen Modus: Öffnet ein neues Fenster. Dasselbe +wird mit dem Parameter »\-y« erreicht. +.TP +rvim rview rgvim rgview +Wie die obigen, aber mit Beschränkungen: Es ist nicht möglich, Shell\-Befehle +aufzurufen oder mit Unterbrechung in eine Shell zurückzuspringen. Dasselbe +wird mit dem Parameter »\-Z« erreicht. +.SH OPTIONEN +Die Optionen können in beliebiger Reihenfolge vor oder nach den Dateinamen +angegeben werden. Optionen ohne Parameter können hinter einem einzigen +Bindestrich gruppiert werden. +.TP 12 ++[Nummer] +In der ersten Datei wird der Cursor auf die Zeile [Nummer] gesetzt. Falls +[Nummer] nicht angegeben wird, wird der Cursor in die letzte Zeile der Datei +gesetzt. +.TP ++/{Suchmuster} +In der ersten Datei wird der Cursor auf das erste Auftreten von {Suchmuster} +gesetzt. Siehe »:help search\-pattern«. +.TP ++{Befehl} +.TP +\-c {Befehl} +{Befehl} wird nach dem Lesen der ersten Datei ausgeführt. Als {Befehl} wird +ein Ex\-Befehl erwartet. Sind in {Befehl} Leerzeichen vorhanden, muss alles +in Anführungszeichen gesetzt werden (hängt von der verwendeten Shell +ab). Beispiel: vim "+set si" main.c +.br +Anmerkung: Sie können bis zu 10 »+«\- oder „\-c«\-Befehle verwenden. +.TP +\-S {Datei} +{Datei} wird nach dem Lesen der ersten Datei ausgeführt. Dies entspricht »\-c +"source {Datei}"«. {Datei} darf nicht mit einem Bindestrich (\-) +anfangen. Wenn kein Dateiname angegeben wird, wird »Session.vim« verwendet +(Funktioniert nur, wenn »\-S« als letzter Parameter steht). +.TP +\-\-cmd {Befehl} +Wie »\-c«, aber dieser Befehl wird vor allen VimRC\-Dateien ausgeführt. Sie +können unabhängig von den »\-c«\-Befehlen bis zu 10 dieser Befehle verwenden. +.TP +\-A +Falls \fBVim\fP mit Unterstützung für das Schreiben von rechts nach links und +arabischer Tastaturbelegung compiliert wurde (ARABIC), startet dieser +Parameter den Modus fürs Arabische (:set arabic). Anderenfalls beendet sich +\fBVim\fP mit einer Fehlermeldung. +.TP +b +Binärer Modus: Es werden einige Variablen gesetzt, sodass es möglich ist, +eine binäre oder ausführbare Datei zu bearbeiten. +.TP +\-C +Kompatibel: Setzt die Option 'compatible'. Das macht \fBVim\fP im Verhalten +sehr ähnlich zu Vi, selbst wenn eine VimRC\-Datei existiert. +.TP +\-d +Startet im diff\-Modus. Es sollten zwei, drei oder vier Dateinamen als +Parameter übergeben werden. \fBVim\fP öffnet sie alle und zeigt die +Unterschiede an. Arbeitet wie vimdiff(1). +.TP +\-d {Gerät} +Öffnet das {Gerät}, um es als Terminal zu nutzen. Nur für AmigaOS. Beispiel: +"\-d con:20/30/600/150". +.TP +D +Debug\-Modus: \fBVim\fP geht in den Debug\-Modus, wenn der erste Befehl in einem +Skript ausgeführt wird. +.TP +\-e +Startet \fBVim\fP im Ex\-Modus, als würde als ausführbare Datei »ex« aufgerufen. +.TP +\-E +Startet \fBVim\fP im erweiterten Ex\-Modus, als würde die ausführbare Datei als +»exim« aufgerufen. +.TP +\-f +Vordergrund: Bei der GUI\-Version erzeugt \fBVim\fP keinen neuen Prozess und +löst sich nicht von der Shell, in der er aufgerufen wurde. Bei AmigaOS wird +kein neues Fenster geöffnet. Dieser Parameter wird benutzt, damit das +aufrufende Programm auf das Beenden des Bearbeitungssitzung wartet (z.B.: +mail). Bei AmigaOS funktionieren die Befehle »:sh« und „:!« nicht. +.TP +\-\-nofork +Vordergrund: Bei der GUI\-Version erzeugt \fBVim\fP keinen neuen Prozess und +löst sich nicht von der Shell, in der er aufgerufen wurde. +.TP +\-F +Wenn \fBVim\fP mit FKMAP\-Unterstützung für das Schreiben von rechts nach links +und Farsi\-Tastatur\-Belegung kompiliert wurde, startet Vim im Farsi\-Modus, +d.h. die Optionen 'fkmap' und 'rightleft' werden gesetzt. Andernfalls bricht +\fBVim\fP mit einer Fehlermeldung ab. +.TP +\-g +Falls \fBVim\fP mit GUI\-Unterstützung kompiliert wurde, wird die GUI +aktiviert. Falls keine GUI\-Unterstützung einkompiliert wurde, wird mit einer +Fehlermeldung abgebrochen. +.TP +\-h +Gibt eine kleine Hilfe für die Befehlszeilenparameter aus. Danach beendet +sich \fBVim.\fP +.TP +\-H +Hebräisch\-Modus, falls \fBVim\fP mit RIGHTLEFT\-Unterstützung für das Schreiben +von rechts nach links und hebräischer Tastaturbelegung kompiliert wurde, +werden die Optionen 'hkmap' und 'rightleft' gesetzt. Andernfalls beendet +sich \fBVim\fP mit einer Fehlermeldung. +.TP +\-i {VimInfo} +Wenn eine VimInfo\-Datei verwendet wird: Verwendet statt »~/.viminfo« die +angegebene Datei. Es ist auch möglich die Verwendung einer VimInfo\-Datei +durch Angabe des Dateinamen »NONE« zu verhindern, +.TP +\-L +dasselbe wie »\-r« +.TP +\-l +Lisp\-Modus. Aktiviert die Optionen 'lisp' und 'showmatch'. +.TP +\-m +Deaktiviert das Verändern von Dateien, indem die Option 'write' gelöscht +wird. Der Puffer kann verändert werden, nur das Schreiben einer Datei ist +nicht möglich. +.TP +\-M +Keine Veränderungen erlaubt: Die Optionen 'modifiable' und 'write' werden +gelöscht, so dass Änderungen nicht erlaubt sind und Dateien nicht +geschrieben werden können. Man beachte, dass diese Optionen ('modifiable', +\&'write') dennnoch nachträglich zum Erlauben von Änderungen gesetzt werden +können. +.TP +\-N +Nicht\-kompatibler Modus: Löscht die Option 'compatible'. Dies veranlasst +\fBVim\fP, sich ein wenig besser, aber weniger Vi\-kompatibel zu verhalten, +selbst wenn es keine VimRC\-Datei gibt. +.TP +\-n +Verwendet keine Auslagerungsdatei: Eine Wiederherstellung nach einem Absturz +ist nicht möglich. Auf einem langsamen Medium (Diskette) kann diese +Einstellung nützlich sein. Kann auch mit »set uc=0« erreicht werden; kann +mit »set uc=200« aufgehoben werden. +.TP +\-nb +\fBVim\fP fungiert als Server für NetBeans. Details siehe Dokumentation. +.TP +\-o[N] +Öffnet [N] Fenster übereinander. Wenn keine Zahl angegeben wird, öffne ein +Fenster pro Datei. +.TP +\-O[N] +Öffnet [N] Fenster nebeneinander. Wenn keine Zahl angegeben wird, öffne ein +Fenster pro Datei. +.TP +\-p[N] +Öffnet [N] Reiterseiten. Wenn keine Zahl angegeben wird, öffne eine +Reiterseite pro Datei. +.TP +\-R +Nur\-Lesen\-Modus: Die Option 'readonly' wird gesetzt. Der Puffer kann noch +bearbeitet werden, aber es wird verhindert, eine Datei aus Versehen zu +überschreiben. Wenn Sie wirklich eine Datei überschreiben wollen, fügen Sie +dem Ex\-Befehl ein Ausrufezeichen hinzu (wie in »:w!«). Die Option „\-R« +bedingt die Option »\-n« (siehe oben). Die Option 'readonly' kann durch „:set +noro« gelöscht werden. Siehe »:help 'readonly'«. +.TP +\-r +Listet die Auslagerungsdateien und gibt Informationen zu ihrer +Verwendbarkeit zur Wiederherstellung. +.TP +\-r {Datei} +Wiederherstellungsmodus: Die Auslagerungsdatei wird zur Wiederherstellung +verwendet und hat denselben Dateinamen wie die Text\-Datei + ».swp«. Siehe +„:help recovery«. +.TP +\-s +Der stille Modus: Nur wenn die ausführbare Datei als »ex« aufgerufen wird +oder vor »\-s« die Option „\-e« gegeben wird. +.TP +\-s {Eingabeskript} +Die Datei {Eingabeskript} wird gelesen und ausgeführt, als würden Sie die +Zeichen in ihr tippen. Dasselbe kann mit dem Befehl »:source! +{Eingabeskript}« erreicht werden. Wird das Ende der Datei vor dem Beenden +des Editors erreicht, werden weitere Zeichen von der Tastatur gelesen. +.TP +\-T {Terminal} +Setzt den Namen des benutzten Terminals. Nur erforderlich, wenn die +Automatik nicht funktioniert. Sollte ein \fBVim\fP bekanntes Terminal sein: +(builtin) oder in einer termcap\- oder terminfo\-Datei definiert. +.TP +\-u {VimRC} +Verwendet zur Initialisierung die Befehle in der Datei {VimRC}. Alle anderen +Initialisierungen werden übersprungen. Benutzen Sie dies, um eine besondere +Art von Dateien zu bearbeiten. Dies kann auch benutzt werden, um alle +Initialisierungen zu überspringen, indem der Name »NONE« angegeben wird. Für +weitere Einzelheiten siehe »:help initialisation« innerhalb von Vim. +.TP +\-U {GvimRC} +Benutzt die Befehle in der Datei {GvimRC} für die Initialisierung der +grafischen Oberfläche. Alle anderen Initialisierungen werden +übersprungen. Dies kann ebenfalls benutzt werden, um alle +GUI\-Initialisierungen zu überspringen, indem der Name »NONE« angegeben +wird. Siehe »:help gui\-init« innerhalb von Vim für weitere Einzelheiten. +.TP +\-V[N] +Ausführlich (verbose): Gibt Meldungen darüber, welche Befehlsdateien +eingelesen werden, und über das Lesen und Schreiben einer VimInfo\-Datei. Die +optionale Zahl N ist der Wert für 'verbose'. Vorgabe ist 10. +.TP +\-v +Startet \fBVim\fP im Vi\-Modus, so als würde die ausführbare Datei mit »vi« +aufgerufen. Dies wirkt sich nur aus, wenn die ausführbare Datei als »ex« +aufgerufen wird. +.TP +\-w {Ausgabeskript} +Alle Zeichen, die eingetippt werden, werden in der Datei {Ausgabeskript} +aufgezeichnet, solange bis Sie \fBVim\fP beenden. Dies ist nützlich, falls Sie +eine Skript\-Datei zum Benutzen mit »vim \-s« oder „:source!« erzeugen +wollen. Falls die Datei {Ausgabeskript} vorhanden ist, werden die Zeichen +angehängt. +.TP +\-W {Ausgabeskript} +Wie \-w, aber eine bereits vorhandene Datei wird überschrieben. +.TP +\-x +Benutzt beim Schreiben von Dateien eine Verschlüsselung. Fragt nach dem +Schlüssel. +.TP +\-X +Führt keine Verbindung zum X\-Server durch. Dadurch verkürzt sich die +Startzeit, aber der Fenstertitel und die Zwischenablage werden nicht +verwendet. +.TP +\-y +Startet \fBVim\fP im einfachen Modus, als würde die ausführbare Datei mit +»evim« oder »eview« aufgerufen. \fBVim\fP verhält sich dann wie ein Editor zum +Klicken und Tippen. +.TP +\-Z +Eingeschränkter Modus: Funktioniert, als würde der Name der ausführbaren +Datei mit »r« beginnen. +.TP +\-\- +Markiert das Ende der Optionen. Argumente, die folgen, werden als Dateinamen +behandelt. Dies kann benutzt werden, um einen Dateinamen mit »\-« am Anfang +zu verwenden. +.TP +\-\-echo\-wid +Nur GTK\-GUI: Schreibe die Fenster\-ID auf die Standardausgabe. +.TP +\-\-help +Gibt eine Hilfe\-Nachricht aus und beendet, wie »\-h«. +.TP +\-\-literal +Nimmt die Dateinamen so wie sie sind und vervollständigt sie nicht nach +Metazeichen (*,?). Dies wirkt sich nicht unter Unix aus, wo die Shell die +Metazeichen expandiert. +.TP +\-\-noplugin +Lade keine Plugins. Impliziert durch »\-u NONE«. +.TP +\-\-remote +Verbindet mit einem Vim\-Server und lässt ihn die in den restlichen +Argumenten angegeben Dateien editieren. Wenn kein Server gefunden wird, +führt dies zu einer Warnmeldung und die Dateien werden im gegenwärtigen Vim +zum Bearbeiten geöffnet. +.TP +\-\-remote\-expr {Ausdruck} +Verbindet mit einem Vim\-Server, führt {Ausdruck} aus und zeigt das Ergebnis +auf der Standardausgabe an. +.TP +\-\-remote\-send {Zeichen} +Verbindet mit einem Vim\-Server und sendet ihm {Zeichen}. +.TP +\-\-remote\-silent +Wie »\-\-remote«, aber ohne Warnung, wenn kein Server gefunden wird. +.TP +\-\-remote\-wait +Wie »\-\-remote«, aber Vim beendet sich nicht, bis die Dateien bearbeitet +wurden. +.TP +\-\-remote\-wait\-silent +Wie »\-\-remote\-wait«, aber ohne Warnung, wenn kein Server gefunden wird. +.TP +\-\-serverlist +Listet die Namen aller gefundenen Vim\-Server auf. +.TP +\-\-servername {Name} +Benutzt {Name} als Server\-Namen. Wird für den gegenwärtigen Vim benutzt, +außer es wird mit dem Argument »\-\-remote« benutzt, dann ist es der Name des +zu kontaktierenden Servers. +.TP +\-\-socketid {id} +Nur GTK\-GUI: Benutzt den GtkPlug\-Mechanismus, um GVim in einem anderen +Fenster laufen zu lassen. +.TP +\-\-version +Versionsinformation anzeigen und beenden +.SH "EINGEBAUTE HILFE" +Tippen Sie in \fBVim\fP »:help«, um zu beginnen. Geben Sie „:help begriff« ein, +um Hilfe über ein bestimmtes Thema zu bekommen. Zum Beispiel »:help ZZ« für +Hilfe über den Befehl »ZZ«. Benutzen Sie <Tab> und CTRL\-D, um +Begriffe zu vervollständigen (»:help cmdline\-completion«). Tags sind +vorhanden, um von einem Ort zum anderen zu springen (eine Art +Hypertext\-Verknüpfungen, siehe »:help«). Auf diese Weise können alle +Dokumentations\-Dateien aufgerufen werden, zum Beispiel »:help syntax.txt«. +.SH DATEIEN +.TP 15 +/usr/local/lib/vim/doc/*.txt +Dokumentations\-Dateien für \fBVim\fP. Verwenden Sie »:help doc\-file\-list«, um +die gesamte Liste zu bekommen. +.TP +/usr/local/lib/vim/doc/tags +Die »Tag«\-Datei, die verwendet wird, um Informationen in der Dokumentation +zu finden. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Die systemweite Einrichtung der Syntaxhervorhebung. +.TP +/usr/local/lib/vim/syntax/*.vim +Syntaxdateien für die verschiedenen Sprachen. +.TP +/usr/local/lib/vim/vimrc +Systemweite Einstellungsdatei für \fBVim\fP +.TP +~/.vimrc +Persönliche Einstellungsdatei für \fBVim\fP +.TP +/usr/local/lib/vim/gvimrc +Systemweite Einstellungsdatei für GVim +.TP +~/.gvimrc +Persönliche Einstellungsdatei für GVim +.TP +/usr/local/lib/vim/optwin.vim +Das Script, das von dem Befehl »:options« verwendet wird, eine schöne +Möglichkeit, um Optionen zu betrachten und zu setzen. +.TP +/usr/local/lib/vim/menu.vim +Systemweite Einstellungsdatei für das Menü von GVim +.TP +/usr/local/lib/vim/bugreport.vim +Das Script zum Generieren eines Fehlerberichts. Siehe »:help bugs«. +.TP +/usr/local/lib/vim/filetype.vim +Mit diesem Script erkennt Vim den Typ einer Datei anhand ihres +Dateinamens. Siehe »:help 'filetype'«. +.TP +/usr/local/lib/vim/scripts.vim +Mit diesem Script erkennt Vim den Typ einer Datei anhand ihres +Inhaltes. Siehe »:help 'filetype'«. +.TP +/usr/local/lib/vim/print/*.ps +Diese Dateien werden zum Drucken von PostScript verwendet. +.PP +Für die neuesten Informationen lesen Sie die Vim\-Homepage: +.br +<URL:http://www.vim.org/> +.SH "SIEHE AUCH" +vimtutor(1) +.SH AUTOR +\fBVim\fP wurde größtenteils von Bram Moolenaar erstellt, mit viel Hilfe von +anderen Leuten. Siehe »:help credits« in \fBVim.\fP +.br +\fBVim\fP basiert auf Stevie, der von Tim Thompson, Tony Andrews und +G.R. (Fred) Walter geschrieben wurde. Es ist jedoch kaum etwas vom +ursprünglichen Code übrig geblieben. +.SH FEHLER +Die sind möglich. Siehe »:help todo« für eine Liste bekannter Probleme. +.PP +Beachten Sie, dass gewisse Dinge, die manche Leute als Fehler betrachten +mögen, in Wirklichkeit durch zu getreue Nachbildung des Vi\-Verhaltens +verursacht werden. Und falls Sie denken, dass andere Dinge Fehler sind, +»weil Vi es anders tut«, sollten Sie einen genaueren Blick auf die Datei +vi_diff.txt werfen (oder in Vim »:help vi_diff.txt« tippen). Sehen Sie sich +auch die Optionen 'compatible' und 'cpoptions' an. diff --git a/runtime/doc/manpages/evim.1 b/runtime/doc/manpages/evim.1 new file mode 100644 index 0000000000..bb859ceada --- /dev/null +++ b/runtime/doc/manpages/evim.1 @@ -0,0 +1,49 @@ +.TH EVIM 1 "2002 February 16" +.SH NAME +evim \- easy Vim, edit a file with Vim and setup for modeless editing +.SH SYNOPSIS +.br +.B evim +[options] [file ..] +.br +.B eview +.SH DESCRIPTION +.B eVim +starts +.B Vim +and sets options to make it behave like a modeless editor. +This is still Vim but used as a point-and-click editor. +This feels a lot like using Notepad on MS-Windows. +.B eVim +will always run in the GUI, to enable the use of menus and toolbar. +.PP +Only to be used for people who really can't work with Vim in the normal way. +Editing will be much less efficient. +.PP +.B eview +is the same, but starts in read-only mode. It works just like evim \-R. +.PP +See vim(1) for details about Vim, options, etc. +.PP +The 'insertmode' option is set to be able to type text directly. +.br +Mappings are setup to make Copy and Paste work with the MS-Windows keys. +CTRL-X cuts text, CTRL-C copies text and CTRL-V pastes text. +Use CTRL-Q to obtain the original meaning of CTRL-V. +.SH OPTIONS +See vim(1). +.SH FILES +.TP 15 +/usr/local/lib/vim/evim.vim +The script loaded to initialize eVim. +.SH AKA +Also Known As "Vim for gumbies". +When using evim you are expected to take a handkerchief, +make a knot in each corner and wear it on your head. +.SH SEE ALSO +vim(1) +.SH AUTHOR +Most of +.B Vim +was made by Bram Moolenaar, with a lot of help from others. +See the Help/Credits menu. diff --git a/runtime/doc/manpages/fr/evim-fr.1 b/runtime/doc/manpages/fr/evim-fr.1 new file mode 100644 index 0000000000..2b38e66cb5 --- /dev/null +++ b/runtime/doc/manpages/fr/evim-fr.1 @@ -0,0 +1,57 @@ +.TH EVIM 1 "16 février 2002" +.SH NAME +evim \- « Easy Vim », édite un fichier avec Vim sans utiliser les modes +.SH SYNOPSIS +.br +.B evim +[options] [fichier ...] +.br +.B eview +.SH DESCRIPTION +.B eVim +lance +.B Vim +et configure ses options afin qu'il se comporte comme un éditeur sans mode. +Cela reste Vim, mais vous pouvez l'utiliser comme un éditeur « cliquer-taper ». +Cela ressemble beaucoup à l'édition avec Notepad sur MS-Windows. +.B eVim +ne fonctionne qu'avec l'interface graphique, qui est nécessaire pour permettre +l'utilisation des menus et de la barre d'outils. +.PP +Il n'est utile qu'aux personnes qui ne parviennent vraiment pas à utiliser Vim +de façon traditionnelle. L'édition est alors bien moins efficace. +.PP +.B eview +fait la même chose, mais démarre Vim en mode Lecture-seule. +Cela revient à lancer evim \-R. +.PP +Voir vim(1) pour davantage d'informations sur Vim, les options, etc. +.PP +L'option 'insertmode' est activée pour permettre de taper directement du texte. +.br +Les mappages sont configurés pour que Copier et Coller fonctionnent avec les +raccourcis habituels de MS-Windows. CTRL-X coupe le texte, CTRL-C copie le +texte et CTRL-V colle le texte. +Vous pouvez utiliser CTRL-Q pour obtenir la fonction originale de CTRL-V. +.SH OPTIONS +Voir vim(1). +.SH FICHIERS +.TP 15 +/usr/local/lib/vim/evim.vim +Le script chargé pour initialiser eVim. +.SH AUSSI CONNU SOUS +Également connu sous le nom « Vim pour gumbies » [N.D.T. : Flying Circus...]. +Quand vous utilisez eVim, vous êtes censé prendre un mouchoir de poche, +faire un noeud à chaque coin et le porter sur votre tête. +.SH VOIR AUSSI +vim(1) +.SH AUTEUR +La majeure partie de +.B Vim +a été écrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. +Voir le menu Aide/Remerciements ou ":help credits" dans +.B Vim. +.SH TRADUCTION +Cette page de manuel a été traduite David Blanchet. +<david.blanchet@free.fr> 2005-03-26. +Mise à jour 2013-05-10, Dominique Pellé <dominique.pelle@gmail.com> diff --git a/runtime/doc/manpages/fr/vim-fr.1 b/runtime/doc/manpages/fr/vim-fr.1 new file mode 100644 index 0000000000..67be106673 --- /dev/null +++ b/runtime/doc/manpages/fr/vim-fr.1 @@ -0,0 +1,589 @@ +.\" Traduction lundi 7 août 2000 par Richard Hitier +.\" (richard.hitier@dial.oleane.com) +.\" Mise à jour de la traduction par David Blanchet +.\" (david.blanchet@free.fr) 2006-06-10 +.\" Mise à jour de la traduction par Dominique Pellé +.\" (dominique.pelle@gmail.com) 2013-05-10 +.\" +.TH VIM 1 "22 février 2002" +.SH NOM +vim \- Vi IMproved, éditeur de texte pour programmeurs +.SH SYNOPSIS +.br +.B vim +[options] [fichier ...] +.br +.B vim +[options] \- +.br +.B vim +[options] \-t marqueur +.br +.B vim +[options] \-q [fichiererreurs] +.PP +.br +.B ex +.br +.B view +.br +.B gvim +.B gview +.B evim +.B eview +.br +.B rvim +.B rview +.B rgvim +.B rgview +.SH DESCRIPTION +.B Vim +est un éditeur de texte proposant une compatibilité ascendante +avec Vi. Il permet d'éditer n'importe quel type de texte brut. +Il est particulièrement adapté pour l'édition des programmes. +.PP +Il comporte de nombreuses améliorations par rapport à Vi : annulation sur +plusieurs niveaux, fenêtres et tampons multiples, coloration syntaxique, +édition en ligne de commande, complètement des noms de fichiers, aide en +ligne, sélection visuelle, etc. +Voir ":help vi_diff.txt" pour un résumé des différences entre +.B Vim +et Vi. +.PP +Pendant l'exécution de +.B Vim +\, une aide abondante est accessible au travers du système d'aide +en ligne, grâce à la commande ":help". +Voir la section AIDE EN LIGNE plus bas. +.PP +Le plus souvent +.B Vim +est démarré pour éditer un unique fichier avec la commande +.PP + vim fichier +.PP +Plus généralement, +.B Vim +est lancé avec : +.PP + vim [options] [listefichiers] +.PP +Si la listefichiers est omise, l'éditeur démarre avec un tampon vide. +Autrement, l'une des quatre méthodes suivantes vous permettra de choisir +un ou plusieurs fichiers à éditer. +.TP 12 +fichier ... +Une liste de noms de fichiers. +Le premier sera le fichier courant et sera lu dans le tampon. +Le curseur sera placé sur la première ligne du tampon. +Vous pouvez passer aux autres fichiers avec la commande ":next". +Pour éditer un fichier débutant par un tiret, faites précéder la +liste de fichiers par "\-\-". +.TP +\- +Le fichier à éditer est lu sur l'entrée standard (stdin). Les commandes sont +lues depuis stderr, qui devrait être un terminal. +.TP +\-t {marqueur} +Le fichier à éditer et la position initiale du curseur dépendent +d'un "marqueur", qui est une sorte d'étiquette. +{marqueur} est recherché dans le fichier des marqueurs, le fichier correspondant +devient le fichier courant et la commande associée est exécutée. +Principalement utile pour les programmes en C ; dans ce cas, {marqueur} +peut être le nom d'une fonction. +Au final, le fichier contenant cette fonction devient le fichier +courant et le curseur est placé au début de la fonction. +Voir ":help tag\-commands". +.TP +\-q [fichiererreurs] +Démarre en mode Mise-au-point (QuickFix). +Le fichier [fichiererreurs] est lu et la première erreur est affichée. +Si [fichiererreurs] est omis, le nom du fichier est lu dans +l'option 'errorfile' ("AztecC.Err" par défaut sur Amiga, "errors.err" sur les +autres systèmes). +La commande ":cn" permet de sauter aux erreurs suivantes. +Voir ":help quickfix". +.PP +.B Vim +se comporte différemment selon le nom de la commande (l'exécutable peut +cependant être le même fichier). +.TP 10 +vim +La façon "normale", le comportement par défaut. +.TP +ex +Démarre en mode Ex. +La commande ":vi" permet de passer en mode Normal. +Ce mode est également accessible avec l'argument "\-e". +.TP +view +Démarre en mode Lecture-Seule. Vous êtes protégé de l'écriture accidentelle +des fichiers. Ce mode est également accessible avec l'argument "\-R". +.TP +gvim gview +La version graphique. +Ouvre une nouvelle fenêtre. +Également accessible avec l'argument "\-g". +.TP +evim eview +La version graphique en mode Débutant (easy). +Ouvre une nouvelle fenêtre. +Également accessible avec l'argument "\-y". +.TP +rvim rview rgvim rgview +Comme ci-dessus, mais avec des restrictions. Il vous sera impossible de +lancer des commandes du shell, ou de suspendre +.B Vim. +Également accessible avec l'argument "\-Z". +.SH OPTIONS +Les options peuvent être spécifiées dans n'importe quel ordre, +avant ou après les noms de fichiers. Les options sans arguments +peuvent être combinées après un unique tiret. +.TP 12 ++[num] +Place le curseur sur la ligne "num" dans le premier fichier. +Si "num" est omis, le curseur sera placé sur la dernière ligne. +.TP ++/{motif} +Place le curseur sur la première occurrence de {motif} dans le premier fichier. +Voir ":help search\-pattern" pour connaître les motifs de recherches +disponibles. +.TP ++{commande} +.TP +\-c {commande} +Exécute {commande} après la lecture du premier fichier. +{commande} est interprétée comme une commande Ex. +Si la {commande} contient des espaces, elle doit être entourée +de doubles-apostrophes (cela dépend du shell utilisé). +Exemple : Vim "+set si" main.c +.br +Note : vous pouvez utiliser jusqu'à 10 commandes "+" ou "\-c". +.TP +\-S {fichier} +Source {fichier} après la lecture du premier fichier. +C'est équivalent à \-c "source {fichier}". +{fichier} ne peut pas débuter par un '\-'. +Si {fichier} est omis, "Session.vim" est utilisé (cela ne fonctionne que si +\-S est le dernier argument). +.TP +\-\-cmd {commande} +Comme "\-c", mais la commande est exécutée juste avant de traiter les fichiers +vimrc. +Vous pouvez utiliser jusqu'à 10 de ces commandes, indépendamment des +commandes "\-c". +.TP +\-A +Si +.B Vim +a été compilé avec le support de la fonctionnalité ARABIC pour l'édition de +fichiers de droite à gauche et les claviers arabes, cette option lance +.B Vim +en mode Arabe, c.-à-d. que l'option 'arabic' est activée. +Sinon, un message d'erreur est émis et +.B Vim +quitte. +.TP +\-b +Mode Binaire. +Active plusieurs options pour permettre l'édition +d'un fichier binaire ou exécutable. +.TP +\-C +Compatible. Active l'option 'compatible'. +.B Vim +se comportera alors quasiment comme Vi, même s'il existe un fichier .vimrc. +.TP +\-d +Démarre en mode Diff. +Deux, trois ou quatre noms de fichiers doivent être spécifiés. +.B Vim +ouvrira alors tous les fichiers et affichera leurs différences. +Fonctionne comme vimdiff(1). +.TP +\-d {périph} +Ouvre {périph} pour l'utiliser comme terminal. +Uniquement sur Amiga. +Exemple : +"\-d con:20/30/600/150". +.TP +\-D +Debogage. Passe en mode Débogage lors de l'exécution de la première commande +d'un script. +.TP +\-e +Démarre +.B Vim +en mode Ex, comme si l'exécutable s'appelait "ex". +.TP +\-E +Démarre +.B Vim +en mode Ex amélioré, comme si l'exécutable "exim" avait été invoqué. +.TP +\-f +Premier-plan (Foreground). Pour la version graphique, +.B Vim +ne forke pas et ne se détache pas du shell dans lequel il a été invoqué. +Sur Amiga, +.B Vim +n'est pas relancé pour ouvrir une nouvelle fenêtre. +Cette option est utile quand +.B Vim +est exécuté par un programme qui attend la fin de la session d'édition +(par exemple mail). +Sur Amiga, les commandes ":sh" et ":!" ne fonctionneront pas. +.TP +\-\-nofork +Premier-plan (Foreground). Pour la version graphique, +.B Vim +ne forkera pas et ne se détachera pas du shell dans lequel il a été lancé. +.TP +\-F +Si +.B Vim +a été compilé avec le support de la fonctionnalité FKMAP pour l'édition de +fichiers de droite à gauche et les claviers farsi, cette option lance +.B Vim +en mode Farsi, c.-à-d. avec les options 'fkmap' et 'rightleft' activées. +Sinon, un message d'erreur est émis et +.B Vim +quitte. +.TP +\-g +Si +.B Vim +a été compilé avec le support de l'IHM graphique, cette option active +l'IHM graphique. Si le support n'a pas été compilé, un message d'erreur +est émis et +.B Vim +quitte. +.TP +\-h +Donne une aide succincte sur les arguments et les options de la ligne de +commande. Après cela, +.B Vim +quitte. +.TP +\-H +Si +.B Vim +a été compilé avec le support de la fonctionnalité RIGHTLEFT pour l'édition de +fichiers de droite à gauche et les claviers hébreux, cette option lance +.B Vim +en mode Hébreu, c.-à-d. avec les options 'hkmap' et 'rightleft' activées. +Sinon, un message d'erreur est émis et +.B Vim +quitte. +.TP +\-i {viminfo} +Lorsque l'utilisation d'un fichier viminfo est activée, cette option indique +le nom de fichier à utiliser à la place de "~/.viminfo" par défaut. +Il est possible d'empêcher l'utilisation d'un fichier ".viminfo", en +spécifiant le nom de fichier "NONE". +.TP +\-L +Comme \-r. +.TP +\-l +Mode Lisp. +Active les options 'lisp' et 'showmatch'. +.TP +\-m +Empêche la modification des fichiers. +Désactive l'option 'write'. +Vous pouvez toujours modifier le tampon, mais il vous sera impossible +d'écrire le fichier. +.TP +\-M +N'autorise aucune modification. les options 'modifiable' et 'write' sont +désactivées, de sorte que les changements ne sont pas autorisés et que les +fichiers ne peuvent pas être écrits. Note : ces options peuvent être activées +pour autoriser les modifications. +.TP +\-N +Mode Non-compatible. Désactive l'option 'compatible'. +Cela améliorera le comportement de +.B Vim +\, mais il sera moins conforme à celui de Vi, même s'il n'existe aucun +fichier ".vimrc". +.TP +\-n +N'utilise pas de fichier d'échange (swapfile). +Le recouvrement après un plantage sera impossible. +Utile pour éditer un fichier sur un support très lent (disquette par ex.). +Également activable avec ":set uc=0". +Il est possible de l'annuler avec ":set uc=200". +.TP +\-nb +Devient un serveur d'édition pour NetBeans. Consulter la documentation à ce +sujet pour davantage de détails. +.TP +\-o[N] +Ouvre N fenêtres les unes au-dessus des autres. +Quand N est omis, ouvre une fenêtre pour chaque fichier. +.TP +\-O[N] +Ouvre N fenêtres côte à côte. +Quand N est omis, ouvre une fenêtre pour chaque fichier fichier. +.TP +\-p[N] +Ouvre N onglets. +Quand N est omis, ouvre un onglet pour chaque fichier fichier. +.TP +\-R +Mode Lecture-Seule. +Active l'option 'readonly'. +Vous pouvez toujours éditer le tampon, mais il vous sera impossible de +d'écraser accidentellement un fichier. +Si vous voulez écraser un fichier, ajoutez un point d'exclamation à la commande +Ex, comme dans ":w!". +L'option \-R impose l'option \-n (voir ci-dessus). +L'option 'readonly' peut être désactivée avec ":set noro". +Voir ":help 'readonly'". +.TP +\-r +Donne la liste des fichiers d'échange, avec des informations pour les utiliser +à des fins de recouvrement. +.TP +\-r {file} +Mode Recouvrement. +Utilise le fichier d'échange pour récouvrer d'une session d'édition plantée. +Le fichier d'échange est un fichier avec le même nom que le fichier texte, +suivi du suffixe ".swp". +Voir ":help recovery". +.TP +\-s +Mode Silencieux. Disponible uniquement quand +.B Vim +est lancé en tant que "ex" ou quand l'option "\-e" a été spécifiée avant +l'option "\-s". +.TP +\-s {scriptEntrée} +Lit le fichier de script {scriptEntrée}. +Les caractères du fichier sont interprétés comme si vous les tapiez. +La commande ":source! {scriptEntrée}" donne le même résultat. +Si la fin du fichier est atteinte avant que l'éditeur quitte, les caractères +suivants sont lus depuis le clavier. +.TP +\-T {terminal} +Indique à +.B Vim +le nom du terminal utilisé. +Cela n'est requis que lorsque la détection automatique échoue. +Le {terminal} devrait être connu de +.B Vim +(intégré) ou défini dans le fichier termcap ou terminfo. +.TP +\-u {vimrc} +Utilise les commandes du fichier {vimrc} pour les initialisations. +Toutes les autres initialisations sont omises. +À utiliser pour éditer un type de fichiers particulier. +Cela permet aussi d'omettre toute initialisation en spécifiant le nom de +fichier "NONE". +Voir ":help initialization" dans Vim pour davantage de détails. +.TP +\-U {gvimrc} +Utilise les commandes du fichier {gvimrc} pour l'initialisation de l'IHM +graphique. +Toutes les autres initialisations graphiques sont omises. +Cela permet aussi d'omettre toute initialisation graphique en spécifiant le nom +de fichier "NONE". +Voir ":help gui\-init" dans Vim pour davantage de détails. +.TP +\-V[N] +Mode Verbeux. +Donne des messages à propos des fichiers sourcés, ainsi que sur la lecture +et les écritures dans le fichier viminfo. le nombre optionnel N précise la +valeur de l'option 'verbose' (10 par défaut). +.TP +\-v +Démarre +.B Vim +en mode Vi, comme si l'exécutable s'appelait "vi". Cela n'a d'effet que si +l'exécutable invoqué est "ex". +.TP +\-w {scriptSortie} +Tous les caractères que vous tapez sont enregistrés dans le fichier +{scriptSortie}, jusqu'à ce que vous quittiez +.B Vim. +C'est utile quand vous voulez créer un fichier de script à utiliser avec +"vim \-s" ou ":source!". +Si le fichier {scriptSortie} existe, les caractères sont ajoutés à la fin. +.TP +\-W {scriptSortie} +Comme \-w, mais un fichier existant sera écrasé. +.TP +\-x +Chiffre les fichiers lors de l'écriture. Une clé de chiffrement sera demandée. +.TP +\-X +Ne se connecte pas au serveur X. Accélère le temps de démarrage dans un +terminal, mais le titre de la fenêtre et le presse-papier seront inaccessibles. +.TP +\-y +Démarre +.B Vim +en mode Débutant (easy), comme si l'exécutable s'appelait "evim" ou "eview". +Donne à +.B Vim +un comportement plus proche des éditeurs « cliquez-tapez ». +.TP +\-Z +Mode restreint. Fonctionne comme si l'exécutable commençait par la lettre 'r'. +.TP +\-\- +Délimite la fin des options. +Les arguments qui suivent seront considérés comme des noms de fichiers. +Cela permet d'éditer des fichiers débutant par un '\-'. +.TP +\-\-echo\-wid +IHM graphique GTK uniquement : retourne la Window ID sur stdout. +.TP +\-\-help +Donne un message d'aide et quitte, comme "\-h". +.TP +\-\-literal +Prend les arguments de noms de fichiers littéralement, sans étendre les +jokers. N'a aucun effet sur Unix, où le shell étend les jokers. +.TP +\-\-noplugin +Ne charge pas les greffons. Implicite avec \-u NONE. +.TP +\-\-remote +Se connecte à un serveur Vim et lui fait éditer les fichiers spécifiés dans +le reste des arguments. Si aucun serveur n'est trouvé, un avertissement est +émis et les fichiers sont édités dans le Vim courant. +.TP +\-\-remote\-expr {expr} +Se connecte à un serveur Vim, y évalue {expr} et affiche le résultat sur la +sortie standard (stdout). +.TP +\-\-remote\-send {touches} +Se connecte à un serveur Vim et y envoie {touches}. +.TP +\-\-remote\-silent +Comme \-\-remote, mais sans émettre d'avertissement si aucun serveur n'est +trouvé. +.TP +\-\-remote\-wait +Comme \-\-remote, mais Vim ne quitte pas tant que le fichier est en cours +d'édition. +.TP +\-\-remote\-wait\-silent +Comme \-\-remote\-wait, mais sans émettre d'avertissement si aucun serveur n'est +trouvé. +.TP +\-\-serverlist +Donne la liste des noms de tous les serveurs Vim disponibles. +.TP +\-\-servername {nom} +Utilise {nom} pour le nom de serveur. Ce nom est donné au Vim courant, à moins +qu'il ne soit utilisé avec un argument \-\-remote. Dans ce cas, il s'agit du nom +du serveur auquel se connecter. +.TP +\-\-socketid {id} +IHM graphique GTK+ uniquement : utilise le mécanisme GtkPlug pour faire +fonctionner gvim dans une autre fenêtre. +.TP +\-\-version +Affiche les informations sur la version puis quitte. +.SH AIDE EN LIGNE +Taper ":help" dans +.B Vim +pour commencer. +Taper ":help sujet" pour obtenir de l'aide sur un sujet précis. +Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ". +Utiliser <Tab> et CTRL\-D pour compléter les sujets (":help +cmdline\-completion"). +Des marqueurs sont inclus dans l'aide et vous permettent de sauter d'un endroit +à un autre (comme des liens hypertextes, voir ":help"). +L'ensemble des fichiers de la documentation peut être consulté de cette +façon, par exemple ":help syntax.txt". +.SH FICHIERS +.TP 15 +/usr/local/lib/vim/doc/*.txt +Les fichiers de la documentation de +.B Vim. +Utiliser ":help doc\-file\-list" pour obtenir la liste complète. +.TP +/usr/local/lib/vim/doc/tags +Le fichier des marqueurs utilisé pour trouver les informations dans les +fichiers de la documentation. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Initialisation de la syntaxe pour l'ensemble du système. +.TP +/usr/local/lib/vim/syntax/*.vim +Fichiers de syntaxe pour différents langages. +.TP +/usr/local/lib/vim/vimrc +Initialisation de +.B Vim +pour l'ensemble du système. +.TP +~/.vimrc +Initialisation de +.B Vim +de votre compte utilisateur. +.TP +/usr/local/lib/vim/gvimrc +Initialisation de gvim pour l'ensemble du système. +.TP +~/.gvimrc +Initialisation de gvim pour votre compte utilisateur. +.TP +/usr/local/lib/vim/optwin.vim +Script utilisé pour la commande ":options", une manière pratique de consulter +et de modifier les options. +.TP +/usr/local/lib/vim/menu.vim +Initialisation des menus de gvim pour l'ensemble du système. +.TP +/usr/local/lib/vim/bugreport.vim +Script pour générer un rapport de bogue. Voir ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Script pour détecter le type d'un fichier d'après son nom. +Voir ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Script pour détecter le type d'un fichier d'après son contenu. +Voir ":help 'filetype'". +.TP +/usr/local/lib/vim/print/*.ps +Fichiers utilisés pour l'impression PostScript. +.PP +Pour disposer d'informations récentes, consulter le site Internet de VIM : +.br +<URL:http://www.vim.org/> +.SH VOIR AUSSI +vimtutor(1) +.SH AUTEUR +La majeure partie de +.B Vim +a été écrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. +Voir ":help credits" dans +.B Vim. +.br +.B Vim +est basé sur Stevie, réalisé par Tim Thompson, +Tony Andrews et G.R. (Fred) Walter. +Toutefois, pratiquement rien du code original ne subsiste. +.SH BOGUES +Probablement. +Voir ":help todo" pour consulter la liste des problèmes connus. +.PP +NOTE : Remarquez que bon nombre de points, qui pourraient être considérés comme +des bugs par certains, sont en fait dus à une reproduction trop fidèle +du comportement de Vi. Et si vous pensez que d'autres points sont des +bugs "parce que Vi le fait différemment", vous devriez jeter un oeil +attentif au fichier vi_diff.txt (ou taper ":help vi_diff.txt" dans Vim). +Regardez aussi les options 'compatible' et 'coptions'. +.SH TRADUCTION +Cette page de manuel a été traduite par Richard Hitier. +<richard.hitier@dial.oleane.com> 2000-08-07. +.br +Cette page de manuel a été mise à jour par David Blanchet. +<david.blanchet@free.fr> 2006-04-10. +Mise à jour 2013-05-10, Dominique Pellé <dominique.pelle@gmail.com> diff --git a/runtime/doc/manpages/fr/vimdiff-fr.1 b/runtime/doc/manpages/fr/vimdiff-fr.1 new file mode 100644 index 0000000000..3b44a3dd58 --- /dev/null +++ b/runtime/doc/manpages/fr/vimdiff-fr.1 @@ -0,0 +1,54 @@ +.TH VIMDIFF 1 "30 mars 2001" +.SH NOM +vimdiff \- ouvre deux, trois ou quatre versions d'un fichier dans Vim et +affiche leurs différences +.SH SYNOPSIS +.br +.B vimdiff +[options] fichier1 fichier2 [fichier3 [fichier4]] +.PP +.B gvimdiff +.SH DESCRIPTION +.B Vimdiff +démarre +.B Vim +avec deux (ou trois ou quatre) fichiers. +Chaque fichier est ouvert dans sa propre fenêtre. +Les différences entre ces fichiers sont mises en surbrillance. +C'est un outil très pratique pour visualiser et reporter les +changements entre deux versions d'un même fichier. +.PP +Consulter vim(1) pour des informations sur l'éditeur Vim lui-même. +.PP +Si +.B gvimdiff +est invoqué, l'IHM graphique est démarrée quand elle est disponible. +.PP +L'option 'diff' est activée dans chacune des fenêtres, ce qui provoque la mise +en surbrillance des différences. +.br +Les options 'wrap' et 'scrollbind' sont activées pour donner un aspect +agréable au texte. +.br +L'option 'foldmethod' est fixée à "diff", ce qui replie les lignes consécutives +identiques. 'foldcolumn' est fixé à 2 pour trouver les replis rapidement et +les ouvrir ou les fermer facilement. +.SH ARGUMENTS +La fenêtre de Vim est partagée verticalement afin d'afficher les lignes +correspondantes les unes en face des autres, comme si l'argument "\-O" était +spécifié. Utilisez l'argument "\-o" pour obtenir un partage horizontal à la +place. +.PP +Pour connaître les autres arguments disponibles, consultez vim(1). +.SH VOIR AUSSI +vim(1) +.SH AUTEUR +La majeure partie de +.B Vim +a été écrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. +Voir ":help credits" dans +.B Vim. +.SH TRADUCTION +Cette page de manuel a été traduite par David Blanchet +<david.blanchet@free.fr> 2005-03-12. +Mise à jour 2012-05-06, Dominique Pellé <dominique.pelle@gmail.com> diff --git a/runtime/doc/manpages/fr/vimtutor-fr.1 b/runtime/doc/manpages/fr/vimtutor-fr.1 new file mode 100644 index 0000000000..f47f840ec1 --- /dev/null +++ b/runtime/doc/manpages/fr/vimtutor-fr.1 @@ -0,0 +1,60 @@ +.TH VIMTUTOR 1 "2 avril 2001" +.SH NAME +vimtutor \- tutoriel Vim +.SH SYNOPSIS +.br +.B vimtutor [\-g] [langue] +.SH DESCRIPTION +.B Vimtutor +lance le tutoriel +.B Vim +\. +Il copie d'abord le fichier du tutoriel, afin que vous puissiez le modifier +sans altérer le fichier original. +.PP +.B Vimtutor +est utile pour les personnes souhaitant apprendre leurs premières commandes +.B Vim +\. +.PP +L'argument optionnel \-g lance vimtutor avec gvim plutôt qu'avec vim, si l'IHM +graphique de vim est disponible, ou le lance avec vim si gvim n'est pas +disponible. +.PP +L'argument optionnel [langue] est le nom d'une langue, spécifiée par son +symbole à deux lettres, tels que "it" ou "es". Si l'argument [langue] est omis, +la langue de la région linguistique actuelle sera retenue. Si le tutoriel est +disponible dans cette langue, il est proposé. Sinon, c'est la version anglaise +qui est proposée. +.PP +.B Vim +est toujours lancé en mode Compatible Vi. +.SH FICHIERS +.TP 15 +/usr/local/lib/vim/tutor/tutor[.langue] +Les fichiers textes de +.B Vimtutor +\. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Le script Vim utilisé pour copier les fichiers texte de +.B Vimtutor +\. +.SH AUTEUR +.B Vimtutor +a été écrit à l'origine pour Vi par Michael C. Pierce et Robert K. Ware, de la +Colorado School of Mines, en reprenant des idées émises par Charles Smith, de +la Colorado State University. +E-mail : bware@mines.colorado.edu. +.br +Il a été modifié pour +.B Vim +par Bram Moolenaar. +Pour connaître le nom des traducteurs, consultez les fichiers textes du +tutoriel. +.SH VOIR AUSSI +vim(1) +.SH TRADUCTION +Cette page de manuel a été traduite par David Blanchet +<david.blanchet@free.fr> 2004-12-27. +Mise à jour 2012-05-06, Dominique Pellé <dominique.pelle@gmail.com> diff --git a/runtime/doc/manpages/fr/xxd-fr.1 b/runtime/doc/manpages/fr/xxd-fr.1 new file mode 100644 index 0000000000..7956b3ba2a --- /dev/null +++ b/runtime/doc/manpages/fr/xxd-fr.1 @@ -0,0 +1,396 @@ +.TH XXD 1 "août 1996" "Page de manuel pour xxd" +.\" +.\" 21st May 1996 +.\" Man page author: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Changes by Bram Moolenaar <Bram@vim.org> +.\" French translation by David Blanchet <david.blanchet@free.fr> 2005-03 +.SH NOM +.I xxd +\- convertit en représentation hexadécimale et inversement. +.SH SYNOPSIS +.B xxd +\-h[elp] +.br +.B xxd +[options] [fichier_entree [fichier_sortie]] +.br +.B xxd +\-r[evert] [options] [fichier_entree [fichier_sortie]] +.SH DESCRIPTION +.I xxd +crée un fichier contenant la représentation hexadécimale d'un fichier +binaire ou de l'entrée standard. +Il peut également convertir un fichier de codes hexadécimaux en un fichier +binaire. +Comme +.BR uuencode (1) +et +.BR uudecode (1) +il permet la transmission de données binaires dans une représentation ASCII +compatible avec le courrier électronique, mais a l'avantage de décoder la +sortie standard. +De plus, il peut être utilisé pour appliquer des rustines à des fichiers +binaires. +.SH OPTIONS +Si aucun +.I fichier_entree +n'est spécifié, l'entrée standard est utilisée. +Si +.I fichier_entree +correspond au caractère +.RB '\-' +\, l'entrée standard est employée comme source des données en entrée. +Si aucun +.I fichier_sortie +n'est spécifié (ou qu'un caractère +.RB '\-' +est donné à sa place), le résultat est envoyé sur la sortie standard. +.PP +NOTE : un analyseur paresseux est utilisé. Il ne vérifie pas au-delà de la +première lettre de l'option, à moins que cette dernière ne requiert un +paramètre. +L'espace entre l'option et son paramètre est optionnel. +Les paramètres des options peuvent être spécifiés en notation décimale, +hexadécimale ou octale. +Ainsi +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +et +.B \-cols 8 +sont tous équivalents. +.TP +.IR \-a " | " \-autoskip +active la fonctionnalité "autoskip" : le caractère '*' remplace les lignes +d'octets nuls. Désactivée par défaut. +.TP +.IR \-b " | " \-bits +Convertit en binaires plutôt qu'en hexadécimal. +Cette option écrit les octets comme une séquence de "1" et de "0" au lieu +d'une conversion en hexadécimal traditionnel. Chaque ligne est précédée par un +numéro de ligne en hexadécimal et suivie de la représentation ASCII (ou +EBCDIC) correspondante. Les options \-r, \-p, \-i ne fonctionnent pas dans ce +mode. +.TP +.IR "\-c cols " | " \-cols cols" +place +.RI < cols > +octets par ligne. 16 par défaut (\-i : 12, \-ps : 30, \-b : 6). Maximum 256. +.TP +.IR \-E " | " \-EBCDIC +Passe le codage des caractères de la colonne de droite de ASCII à EBCDIC. +Cela ne change pas la représentation hexadécimale. Cette option est sans effet +quand elle est utilisée avec \-r, \-p or \-i. +.TP +.IR "\-g octets " | " \-groupsize octets" +Regroupe les octets (deux chiffres hexadécimaux ou huit chiffres binaires) +par groupe de +.RI < octets > +\, séparés par des espaces blancs. Spécifiez +.I \-g 0 +pour supprimer le regroupement. +.RI < octets > +vaut 2 par défaut dans le mode normal et \fI1\fP en +représentation binaire. Le regroupement ne s'applique pas aux styles +Postscript et Include. +.TP +.IR \-h " | " \-help +Affiche un résumé des commandes disponibles et quitte. Aucune conversion n'est +effectuée. +.TP +.IR \-i " | " \-include +produit une sortie dans le style #include (fichier C à inclure). La définition +complète d'un tableau statique est écrite et est nommée d'après le fichier +d'origine, à moins que xxd lise depuis l'entrée standard. +.TP +.IR "\-l long " | " \-len long" +Arrête après l'écriture de +.RI < long > +octets. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +Produit une conversion continue dans le style Postscript (postscript continuous +hexdumd style). +Également connu sous le nom de « conversion brute » (plain hexdump style). +.TP +.IR \-r " | " \-revert +Opération inverse : convertit un fichier hexadécimal en un fichier binaire (ou +applique une rustine à un fichier binaire). +Si l'écriture n'a pas lieu sur la sortie standard, xxd écrit dans le fichier +qu'il produit sans le tronquer. Utilisez la combinaison +.I \-r \-p +pour lire de l'hexadécimal brut sans information sur le numéro des lignes et +sans format de colonnes particulier. Des espaces blancs et coupures de lignes +supplémentaires sont autorisés à n'importe quel endroit. +.TP +.I \-seek décalage +Utilisé après l'option +.IR \-r : +inverse la conversion en ajoutant +.RI < décalage > +aux positions dans le fichier données dans le code hexadécimal. +.TP +.I \-s [+][\-]décalage +Débute au +.RI < décalage > +absolu ou relatif dans fichier_entree. +\fI+ \fRindique que le décalage est relatif à la position courante dans +l'entrée standard (sans effet si la lecture n'a pas lieu sur l'entrée +standard). \fI\- \fRindique un décalage en caractères depuis la fin de +l'entrée (utilisé avec \fI+\fR, désigne la position avant la position +actuelle de l'entrée standard). +Sans l'option \-s, xxd démarre à la position courante du fichier. +.TP +.I \-u +Utilise des chiffres hexadécimaux majuscules. La casse par défaut est +minuscule. +.TP +.IR \-v " | " \-version +Affiche la version de xxd. +.SH MISE EN GARDE +.I xxd \-r +effectue des opérations internes un peu obscures lors de l'évaluation +des informations sur les numéros de lignes. Si le fichier de sortie est +adressable, alors les numéros de lignes au début de chaque ligne d'hexadécimal +peuvent être désordonnées, des lignes peuvent manquer ou se chevaucher. Dans +ces cas, xxd utilisera lseek(2) pour déterminer la prochaine position. Si le +fichier n'est pas adressable, seuls les vides sont autorisés, et ils seront +comblés par des octets nuls. +.PP +.I xxd \-r +ne génère aucune erreur lors de l'analyse. Les problèmes sont passés +silencieusement. +.PP +Lors de l'édition de la représentation hexadécimale, veuillez noter que +.I xxd \-r +ignore tout ce qui se trouve sur la ligne après avoir lu suffisamment de +données hexadécimales (voir l'option \-c). Cela signifie également que les +modifications dans la colonne ASCII (ou EBCDIC) sont toujours ignorées. La +conversion inverse de données hexadécimales brutes (postscript) avec xxd \-r +\-p ne dépend pas d'un nombre correct de colonnes. Dans ce cas, tout ce qui +ressemble à une paire de chiffres hexadécimaux est interprété. +.PP +Remarquez la différence entre +.br +\fI% xxd \-i fichier\fR +.br +et +.br +\fI% xxd \-i < fichier\fR +.PP +.I xxd \-s \+seek +peut différer de +.IR "xxd \-s seek" , +car lseek(2) est utilisé pour « revenir en arrière ». Le '+' fait une +différence quand la source des données est l'entrée standard et si la position +dans le fichier de l'entrée standard n'est pas au début du fichier lorsque xxd +est démarré et qu'il reçoit ses données. +L'exemple suivant peut vous aider à comprendre (ou bien vous perdre davantage +encore !)... +.PP +Remettre l'entrée standard au départ avant de lire ; nécessaire car 'cat' a +déjà lu jusqu'à la fin de l'entrée standard. +.br +\fI% sh \-c 'cat > donnees_binaires; xxd \-s 0 > donnees_hexa' < fichier\fR +.PP +Convertir à partir de la position 0x480 (= 1024 + 128) du fichier. +Le symbole '+' signifie "relativement à la position actuelle', ainsi 128 est +ajouté aux 1024 octets comptabilisés pour dd. +.br +\fI% sh \-c 'dd of=donnees_binaires bs=1k count=1; xxd \-s +128 > +donnees_hexa' < fichier\fR +.PP +Convertir de fichier depuis la position 0x100 (= 1024 \- 768) du fichier. +.br +\fI% sh \-c 'dd of=donnees_binaires bs=1k count=1; xxd \-s +\-768 > +donnees_hexa' < fichier\fR +.PP +Toutefois, cette situation est peu fréquente et l'utilisation de '+' est +rarement requise. L'auteur préfère surveiller les effets de xxd avec strace(1) +ou truss(1) quand \-s est employé. +.SH EXEMPLES +Afficher la totalité du +.B fichier +sauf les trois premières lignes (0x30 octets en hexadécimal). +.br +\fI% xxd \-s 0x30 fichier\fR +.PP +afficher les trois dernières lignes (0x30 octets en hexadécimal) du +.B fichier +\. +.br +\fI% xxd \-s \-0x30 fichier\fR +.PP +.br +Afficher 120 octets convertis en continu, avec 20 octets par ligne. +.br +\fI% xxd \-l 120 \-ps \-c 20 xxd\-fr.1\fR +.br +2e54482058584420312022616ffb742031393936 +.br +22202250616765206465206d616e75656c20706f +.br +757220787864220a2e5c220a2e5c222032317374 +.br +204d617920313939360a2e5c22204d616e207061 +.br +676520617574686f723a0a2e5c2220202020546f +.br +6e79204e7567656e74203c746f6e79407363746e +.br +204e7567656e74203c746f6e79407363746e7567 +.br +2e54482058584420312022417567757374203139 +.PP +Convertir les 120 premiers octets de cette page de manuel avec 12 octets par +ligne. +.br +\fI% xxd \-l 120 \-c 12 xxd\-fr.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 2261 .TH XXD 1 "a +.br +000000c: 6ffb 7420 3139 3936 2220 2250 o.t 1996" "P +.br +0000018: 6167 6520 6465 206d 616e 7565 age de manue +.br +0000024: 6c20 706f 7572 2078 7864 220a l pour xxd". +.br +0000030: 2e5c 220a 2e5c 2220 3231 7374 .\"..\" 21st +.br +000003c: 204d 6179 2031 3939 360a 2e5c May 1996..\ +.br +0000048: 2220 4d61 6e20 7061 6765 2061 " Man page a +.br +0000054: 7574 686f 723a 0a2e 5c22 2020 uthor:..\" +.br +0000060: 2020 546f 6e79 204e 7567 656e Tony Nugen +.br +000006c: 7420 3c74 6f6e 7940 7363 746e t <tony@sctn +.PP +Afficher la date écrite au début du fichier xxd\-fr.1. +.br +\fI% xxd \-s 0x38 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +.PP +Copier +.B fichier_entree +vers +.B fichier_sortie +en ajoutant 100 octets de valeur 0x00 avant. +.br +\fI% xxd fichier_entree | xxd \-r \-s 100 \> fichier_sortie\fR +.PP +Patcher la date dans le fichier xxd.1 +.br +\fI% echo '0000037: 3574 68' | xxd \-r \- xxd\-fr.1\fR +.br +\fI% xxd \-s 0x38 \-l 13 \-c 13 xxd\-fr.1\fR +.br +0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +.PP +Créer un fichier de 65537 octets tous nuls (0x00), +sauf le dernier qui vaut 'A' (0x41 en hexadécimal). +.br +\fI% echo '010000: 41' | xxd \-r \> fichier\fR +.PP +.br +Convertir le fichier de l'exemple précédent avec la fonctionnalité "autoskip". +.br +\fI% xxd \-a \-c 12 fichier\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Créer un fichier d'un octet, contenant seulement le caractère 'A'. +Le nombre après '\-r \-s' s'ajoute aux numéros de lignes trouvées dans le +fichier ; les octets initiaux sont supprimés. +.br +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> fichier\fR +.PP +Utiliser xxd comme filtre dans un éditeur tel que +.B vim(1) +pour convertir une zone comprise entre les marques 'a' et 'z'. +.br +\fI:'a,'z!xxd\fR +.PP +Utiliser xxd comme filtre dans un éditeur tel que +.B vim(1) +pour récupérer une conversion binaire comprise entre les marques 'a' et 'z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +Utiliser xxd comme filtre dans un éditeur tel que +.B vim(1) +pour récupérer une ligne convertie. Placez le curseur sur la ligne et tapez : +.br +\fI!!xxd \-r\fR +.PP +Lire des caractères depuis une connexion série : +.br +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.SH VALEURS DE RETOUR +Les erreurs suivantes sont rapportées : +.TP +0 +aucune erreur ne s'est produit. +.TP +\-1 +opération non supportée ( +.I xxd \-r \-i +reste impossible). +.TP +1 +erreur lors de l'analyse des options. +.TP +2 +problème avec le fichier d'entrée. +.TP +3 +problème avec le fichier de sortie. +.TP +4, 5 +la position spécifiée n'est pas atteignable. +.SH VOIR AUSSI +uuencode(1), uudecode(1), patch(1) +.SH AVERTISSEMENTS +L'étrangeté de cet outil reflète celle du cerveau de ses créateurs. +Utilisez cet outil à vos risques et périls. Dupliquez vos fichiers. +Surveillez l'outil. Devenez un gourou. +.SH VERSION +Cette page de manuel documente la version 1.7 de xxd. +.SH AUTEUR +(c) 1990-1997 par Juergen Weigert +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +"Distribute freely and credit me, +.br +make money and share with me, +.br +lose money and don't ask me." +.PP +Distribution libre en citant l'auteur, +.br +gagnez de l'argent, pensez à moi, +.br +perdez de l'argent, oubliez-moi. +.PP +Page de manuel débutée par Tony Nugent +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Modifications mineures par Bram Moolenaar. +Édité par Juergen Weigert. +.SH TRADUCTION +Cette page de manuel a été traduite par David Blanchet +<david.blanchet@free.fr> 2004-12-24. +Mise à jour 2013-05-10, Dominique Pellé <dominique.pelle@gmail.com> diff --git a/runtime/doc/manpages/it/evim-it.1 b/runtime/doc/manpages/it/evim-it.1 new file mode 100644 index 0000000000..f96d0cb42c --- /dev/null +++ b/runtime/doc/manpages/it/evim-it.1 @@ -0,0 +1,54 @@ +.TH EVIM 1 "16 febbraio 2002 " +.SH NOME +evim \- Vim "facile", Vim impostato in modo da poter essere usato +facilmente per modificare file, anche da chi non abbia familiarità +con i comandi. +.SH SINTASSI +.br +.B evim +[opzioni] [file ..] +.br +.B eview +.SH DESCRIZIONE +.B evim +Inizia +.B Vim +e imposta le opzioni per farlo comportare come un editore "modeless". +State sempre usando Vim, ma come un editore "posizionati-e-clicca". +Simile all'uso di Notepad in MS-Windows. +.B evim +richiede la presenza della GUI, per avere a disposizione menù e barra +strumenti. +.PP +Da usarsi soltanto se non si è in grado di lavorare con Vim nella +maniera usuale. +La modifica file sarà molto meno efficiente. +.PP +.B eview +come sopra, ma parte in modalità "Sola Lettura". Funziona come evim \-R. +.PP +Vedere vim(1) per dettagli riguardo a Vim, opzioni, etc. +.PP +L'opzione 'insertmode' è impostata per poter immettere del testo direttamente. +.br +Sono definite delle mappature che consentono di usare COPIA e INCOLLA con i +familiari tasti usati sotto MS-Windows. +CTRL-X taglia testo, CTRL-C copia testo e CTRL-V incolla testo. +Usate CTRL-Q per ottenere quello che si otterrebbe con CTRL-V in Vim nativo. +.SH OPZIONI +Vedere vim(1). +.SH FILE +.TP 15 +/usr/local/lib/vim/evim.vim +Lo script caricato per inizializzare eVim. +.SH NAC [NOTO ANCHE COME] +Noto Anche Come "Vim per semplici". +Quando usate evim si suppone che prendiate un fazzoletto, +facciate un nodo ad ogni angolo e ve lo mettiate in testa. +.SH VEDERE ANCHE +vim(1) +.SH AUTORE +Buona parte di +.B Vim +è stato scritto da Bram Moolenaar, con molto aiuto da altri. +Vedere il menù "Aiuto/Crediti". diff --git a/runtime/doc/manpages/it/vim-it.1 b/runtime/doc/manpages/it/vim-it.1 new file mode 100644 index 0000000000..51e7e043da --- /dev/null +++ b/runtime/doc/manpages/it/vim-it.1 @@ -0,0 +1,566 @@ +.TH VIM 1 "22 febbraio 2002" +.SH NOME +vim \- VI Migliorato, un editor di testi per programmatori +.SH SINTASSI +.br +.B vim +[opzioni] [file ..] +.br +.B vim +[opzioni] \- +.br +.B vim +[opzioni] \-t tag +.br +.B vim +[opzioni] \-q [file_errori] +.PP +.br +.B ex +.br +.B view +.br +.B gvim +.B gview +.B evim +.B eview +.br +.B rvim +.B rview +.B rgvim +.B rgview +.SH DESCRIZIONE +.B Vim +Un editore di testi, compatibile con, e migliore di, Vi. +Può essere usato per editare qualsiasi file di testo. +Particolarmente utile per editare programmi. +.PP +Ci sono parecchi miglioramenti rispetto a Vi: undo multipli, +finestre e buffer multipli, evidenziazione sintattica, possibilità +di modificare la linea di comando, completamento nomi file, help +in linea, selezione testi in Modo Visual, etc.. +Vedere ":help vi_diff.txt" per un sommario delle differenze fra +.B Vim +e Vi. +.PP +Mentre usate +.B Vim +potete ricevere molto aiuto dal sistema di help online, col comando ":help". +Vedere qui sotto la sezione AIUTO ONLINE. +.PP +Quasi sempre +.B Vim +viene invocato, per modificare un file, col comando +.PP + vim nome_file +.PP +Più in generale +.B Vim +viene invocato con: +.PP + vim [opzioni] [lista_file] +.PP +Se lista_file non è presente, l'editor inizia aprendo un buffer vuoto. +Altrimenti, una e una sola delle quattro maniere indicate qui sotto può +essere usata per scegliere uno o più file da modificare. +.TP 12 +nome_file .. +Una lista di nomi di file. +Il primo di questi sarà il file corrente, e verrà letto nel buffer. +Il cursore sarà posizionato sulla prima linea del buffer. +Potete arrivare agli altri file col comando ":next". +Per editare un file il cui nome inizia per "\-" premettete "\-\-" alla +lista_file. +.TP +\- +Il file da editare è letto dallo "stdin" [di solito, ma non +necessariamente, il terminale \- NdT]. I comandi sono letti da "stderr", +che dovrebbe essere un terminale [tty]. +.TP +\-t {tag} +Il file da editare e la posizione iniziale del cursore dipendono da "tag", +una specie di "etichetta" a cui saltare. +{tag} viene cercata nel file "tags", ed il file ad essa associato diventa +quello corrente, ed il comando ad essa associato viene eseguito. +Di solito si usa per programmi C, nel qual caso {tag} potrebbe essere un +nome di funzione. +L'effetto è che il file contenente quella funzione diventa il file corrente +e il cursore è posizionato all'inizio della funzione. +Vedere ":help tag\-commands". +.TP +\-q [file_errori] +Inizia in Modo QuickFix [correzione veloce]. +Il file [file_errori] è letto e il primo errore è visualizzato. +Se [file_errori] non è indicato, il suo nome è ottenuto dal valore +dell'opzione 'errorfile' (che, se non specificata, vale "AztecC.Err" +per l'Amiga, "errors.err" su altri sistemi). +Si può saltare all'errore successivo col comando ":cn". +Vedere ":help quickfix". +.PP +.B Vim +si comporta in modo diverso se invocato con nomi differenti (il programma +eseguibile "sottostante" può essere sempre lo stesso). +.TP 10 +vim +Modo Normal, comportamento normale. +.TP +ex +Inizia in Modo "Ex". +Si può passare in Modo Normal col comando ":vi". +Si può invocare il Modo "Ex" anche con l'argomento "\-e". +.TP +view +Inizia in Modo Read-only (Sola Lettura). Non potete modificare i file. +Si può invocare il Modo Read-only anche con l'argomento "\-R". +.TP +gvim gview +La versione GUI [Graphical User Interface]. +Apre una nuova finestra. +Si può invocare il Modo GUI anche con l'argomento "\-g". +.TP +evim eview +La versione GUI in Modo Easy (semplificata). +Apre una nuova finestra. +Si può invocare il Modo Easy anche con l'argomento "\-y". +.TP +rvim rview rgvim rgview +Come sopra, ma con restrizioni ai comandi. Non si potranno eseguire comandi +della shell o sospendere +.B Vim. +Si può chiedere la stessa cosa anche con l'argomento "\-Z". +.SH OPZIONI +Le opzioni possono essere in un ordine qualsiasi, prima o dopo i nomi di +file. Opzioni che non necessitano un argomento possono essere specificate +dietro a un solo "\-". +.TP 12 ++[numero] +Per il primo file il cursore sarà posizionato sulla linea "numero". +Se "numero" manca, il cursore sarà posizionato sull'ultima linea del file. +.TP ++/{espressione} +Per il primo file il cursore sarà posizionato alla +prima occorrenza di {espressione}. +Vedere ":help search\-pattern" per come specificare l'espressione. +.TP ++{comando} +.TP +\-c {comando} +{comando} sarà eseguito dopo che il +primo file è stato letto. +{comando} è interpretato come un comando Ex. +Se il {comando} contiene spazi deve essere incluso fra doppi apici +(o altro delimitatore, a seconda della shell che si sta usando). +Esempio: Vim "+set si" main.c +.br +Note: Si possono avere fino a 10 comandi "+" o "\-c". +.TP +\-S {file} +I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. +Equivalente a \-c "source {file}". +{file} non può avere un nome che inizia per '\-'. +Se {file} è omesso si usa "Session.vim" (funziona solo se \-S è l'ultimo +argomento specificato). +.TP +\-\-cmd {comando} +Come "\-c", ma il comando è eseguito PRIMA +di eseguire qualsiasi file vimrc. +Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi +"\-c". +.TP +\-A +Se +.B Vim +è stato compilato con supporto Arabic per editare file con orientamento +destra-sinistra e tastiera con mappatura Araba, questa opzione inizia +.B Vim +in Modo Arabic, cioè impostando 'arabic'. +Altrimenti viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +\-b +Modo Binary (binario). +Vengono impostate alcune opzioni che permettono di modificare un file +binario o un programma eseguibile. +.TP +\-C +Compatibile. Imposta l'opzione 'compatible'. +In questo modo +.B Vim +ha quasi lo stesso comportamento di Vi, anche in presenza di un file +di configurazione .vimrc [proprio di Vim, vi usa .exrc \- Ndt]. +.TP +\-d +Inizia in Modo Diff [differenze]. +Dovrebbero esserci come argomenti due o tre o quattro nomi di file. +.B Vim +aprirà tutti i file evidenziando le differenze fra gli stessi. +Funziona come vimdiff(1). +.TP +\-d {dispositivo} +Apre {dispositivo} per usarlo come terminale. +Solo per l'Amiga. +Esempio: +"\-d con:20/30/600/150". +.TP +\-D +Debugging. Vim si mette in Modo "debugging" a partire +dall'esecuzione del primo comando da uno script. +.TP +\-e +Eseguire +.B Vim +in Modo Ex, come se il programma eseguito sia "ex". +.TP +\-E +Eseguire +.B Vim +in Modo Ex migliorato, come se il programma eseguito sia "exim". +.TP +\-f +Direttamente [Foreground]. Per la versione GUI, +.B Vim +non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. +Per l'Amiga, +.B Vim +non è fatto ripartire per aprire una nuova finestra. +Opzione da usare quando +.B Vim +è eseguito da un programma che attende la fine della +sessione di edit (ad es. mail). +Sull'Amiga i comandi ":sh" e ":!" non sono disponibili. +.TP +\-\-nofork +Direttamente [Foreground]. Per la versione GUI, +.B Vim +non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. +.TP +\-F +Se +.B Vim +è stato compilato con supporto FKMAP per editare file con orientamento +destra-sinistra e tastiera con mappatura Farsi, questa opzione inizia +.B Vim +in Modo Farsi, cioè impostando 'fkmap' e 'rightleft'. +Altrimenti viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +\-g +Se +.B Vim +è stato compilato con supporto GUI, questa opzione chiede di usarla. +Se Vim è stato compilato senza supporto GUI viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +\-h +Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. +Subito dopo +.B Vim +esce. +.TP +\-H +Se +.B Vim +è stato compilato col supporto RIGHTLEFT per editare file con orientamento +destra-sinistra e tastiera con mappatura Ebraica, questa opzione inizia +.B Vim +in Modo Ebraico, cioè impostando 'hkmap' e 'rightleft'. +Altrimenti viene dato un messaggio di errore e +.B Vim +termina in modo anormale. +.TP +\-i {viminfo} +Se è abilitato l'uso di un file viminfo, questa opzione indica il nome +del file da usare invece di quello predefinito "~/.viminfo". +Si può anche evitare l'uso di un file .viminfo, dando come nome "NONE". +.TP +\-L +Equivalente a \-r. +.TP +\-l +Modo Lisp. +Imposta le opzioni 'lisp' e 'showmatch'. +.TP +\-m +Inibisce modifica file. +Annulla l'opzione 'write'. +È ancora possibile modificare un buffer [in memoria \- Ndt], ma non scriverlo. +.TP +\-M +Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate, +in modo da impedire sia modifiche che riscritture. Da notare che queste +opzioni possono essere abilitate in seguito, permettendo così modifiche. +.TP +\-N +Modo "Non-compatibile". Annulla l'opzione 'compatible'. +Così +.B Vim +va un po' meglio, ma è meno compatibile con Vi, anche in assenza di un +file .vimrc. +.TP +\-n +Inibisce l'uso di un file di swap. +Il recupero dopo una caduta di macchina diventa impossibile. +Utile per editare un file su un supporto molto lento (ad es. floppy). +Il comando ":set uc=0" ha lo stesso effetto. +Per abilitare il recupero usare ":set uc=200". +.TP +\-nb +Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli. +.TP +\-o[N] +Apri N finestre in orizzontale. +Se N manca, apri una finestra per ciascun file. +.TP +\-O[N] +Apri N finestre, in verticale. +Se N manca, apri una finestra per ciascun file. +.TP +\-R +Modo Read-only (Sola Lettura). +Imposta l'opzione 'readonly'. +Si può ancora modificare il buffer, ma siete protetti da una riscrittura +involontaria. +Se volete davvero riscrivere il file, aggiungete un punto esclamativo +al comando Ex, come in ":w!". +L'opzione \-R implica anche l'opzione \-n (vedere sotto). +L'opzione 'readonly' può essere annullata con ":set noro". +Vedere ":help 'readonly'". +.TP +\-r +Lista file di swap, assieme a dati utili per un recupero. +.TP +\-r {file} +Modo Recovery (ripristino). +Il file di swap è usato per recuperare una sessione di edit finita male. +Il file di swap è un file con lo stesso nome file del file di testo +editato, col suffisso ".swp". +Vedere ":help recovery". +.TP +\-s +Modo silenzioso. Solo quando invocato come "Ex" o quando l'opzione +"\-e" è stata data prima dell'opzione "\-s". +.TP +\-s {scriptin} +Lo script file {scriptin} è letto. +I caratteri nel file sono interpretati come se immessi da voi. +Lo stesso si può ottenere col comando ":source! {scriptin}". +Se la fine del file di input viene raggiunta prima che Vim termini, +l'ulteriore input viene preso dalla tastiera. +.TP +\-T {terminale} +Dice a +.B Vim +quale tipo di terminale state usando. +Utile solo se il terminale non viene riconosciuto correttamente da Vim. +Dovrebbe essere un terminale noto a +.B Vim +(internamente) o definito nel file termcap o terminfo. +.TP +\-u {vimrc} +Usa i comandi nel file {vimrc} per inizializzazioni. +Tutte le altre inizializzazioni non sono eseguite. +Usate questa opzione per editare qualche file di tipo speciale. +Può anche essere usato per non fare alcuna inizializzazione dando +come nome "NONE". +Vedere ":help initialization" da vim per ulteriori dettagli. +.TP +\-U {gvimrc} +Usa i comandi nel file {gvimrc} per inizializzazioni GUI. +Tutte le altre inizializzazioni GUI non sono eseguite. +Può anche essere usata per non fare alcuna inizializzazione GUI dando +come nome "NONE". +Vedere ":help gui-init" da vim per ulteriori dettagli. +.TP +\-V[N] +Verboso. Vim manda messaggi relativi agli script file che esegue +e quando legge o scrive un file viminfo. Il numero opzionale N è il valore +dell'opzione 'verbose'. +Il valore predefinito è 10. +.TP +\-v +Inizia +.B Vim +in Modo Vi, come se il programma eseguibile fosse "vi". Questo ha +effetto solo quando Vim viene invocato con il nome "ex". +.TP +\-w {scriptout} +Ogni carattere immesso viene registrato nel file {scriptout}, +finché non uscite da +.B Vim. +Utile se si vuole creare uno script file da usare con "vim \-s" o +":source!". +Se il file {scriptout} esiste, quel che immettete viene aggiunto in fondo. +.TP +\-W {scriptout} +Come \-w, ma uno script file esistente viene sovrascritto. +.TP +\-x +Uso di cifratura nella scrittura dei file. E' necessario immettere +una chiave di cifratura. +.TP +\-X +Non connetterti al server X. Vim parte più rapidamente, +ma il titolo della finestra e la clipboard non sono disponibili. +.TP +\-y +Eseguire +.B Vim +in Modo Easy (semplificata), come se l'eseguibile invocato +sia "evim" o "eview". +Fa sì che +.B Vim +si comporti come un editor che usa solo il mouse e i caratteri. +.TP +\-Z +Modo ristretto. Vim si comporta come se invocato con un nome +che inizia per "r". +.TP +\-\- +Specifica la fine delle opzioni. +Argomenti specificati dopo questo sono considerati nomi file. +Si può usare per editare un file il cui nome inizi per '-'. +.TP +\-\-echo\-wid +Solo con GUI GTK: Visualizza Window ID su "stdout". +.TP +\-\-help +Vim dà un messaggio ed esce, come con l'argomento "\-h". +.TP +\-\-literal +Considera i nomi passati come argomenti letterali, senza espandere +metacaratteri. Non necessario in Unix, la shell espande i metacaratteri. +.TP +\-\-noplugin +Non caricare plugin. Implicito se si specifica \-u NONE. +.TP +\-\-remote +Connettersi a un server Vim e chiedere di editare i file elencati come altri +argomenti. Se non si trova un server viene dato un messaggio e i file sono +editati nel Vim corrente. +.TP +\-\-remote\-expr {expr} +Connettersi a un server Vim, valutare ivi {expr} e stampare il risultato +su "stdout". +.TP +\-\-remote\-send {chiavi} +Connettersi a un server Vim e spedirgli {chiavi}. +.TP +\-\-remote\-silent +Come \-\-remote, ma senza avvisare se non si trova un server. +.TP +\-\-remote-wait +Come \-\-remote, ma Vim non termina finché i file non sono stati editati. +.TP +\-\-remote\-wait\-silent +Come \-\-remote\-wait, ma senza avvisare se non si trova un server. +.TP +\-\-serverlist +Lista i nomi di tutti i server Vim disponibili. +.TP +\-\-servername {nome} +Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia +usato con l'argomento \-\-remote, nel qual caso indica il server a cui +connettersi. +.TP +\-\-socketid {id} +Solo con GUI GTK: Usa il meccanismo GtkPlug per eseguire gvim in un'altra +finestra. +.TP +\-\-version +Stampa la versione di Vim ed esci. +.SH AIUTO ONLINE +Battere ":help" in +.B Vim +per iniziare. +Battere ":help argomento" per ricevere aiuto su uno specifico argomento. +Per esempio: ":help ZZ" per ricevere aiuto sul comando "ZZ". +Usare <Tab> e CTRL\-D per completare gli argomenti +(":help cmdline\-completion"). +Ci sono "tag" nei file di help per saltare da un argomento a un altro +(simili a legami ipertestuali, vedere ":help"). +Tutti i file di documentazione possono essere navigati così. Ad es.: +":help syntax.txt". +.SH FILE +.TP 15 +/usr/local/lib/vim/doc/*.txt +I file di documentazione di +.B Vim +. +Usate ":help doc\-file\-list" per avere la lista completa. +.TP +/usr/local/lib/vim/doc/tags +Il file di tags usato per trovare informazioni nei file di documentazione. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Inizializzazioni sintattiche a livello di sistema. +.TP +/usr/local/lib/vim/syntax/*.vim +File di colorazione sintattica per vari linguaggi. +.TP +/usr/local/lib/vim/vimrc +Inizializzazioni +.B Vim +a livello di sistema. +.TP +~/.vimrc +Le vostre personali inizializzazioni di +.B Vim +. +.TP +/usr/local/lib/vim/gvimrc +Inizializzazioni gvim a livello di sistema. +.TP +~/.gvimrc +Le vostre personali inizializzazioni di gvim. +.TP +/usr/local/lib/vim/optwin.vim +Script Vim usato dal comando ":options", un modo semplice +per visualizzare e impostare opzioni. +.TP +/usr/local/lib/vim/menu.vim +Inizializzazioni del menù gvim a livello di sistema. +.TP +/usr/local/lib/vim/bugreport.vim +Script Vim per generare una segnalazione di errore. Vedere ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Script Vim per determinare il tipo di un file a partire dal suo nome. +Vedere ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Script Vim per determinare il tipo di un file a partire dal suo contenuto. +Vedere ":help 'filetype'". +.TP +/usr/local/lib/vim/print/*.ps +File usati per stampa PostScript. +.PP +Per informazioni aggiornate [in inglese \- NdT] vedere la home page di Vim: +.br +<URL:http://www.vim.org/> +.SH VEDERE ANCHE +vimtutor(1) +.SH AUTORE +Buona parte di +.B Vim +è stato scritto da Bram Moolenaar, con molto aiuto da altri. +Vedere ":help credits" in +.B Vim. +.br +.B Vim +è basato su Stevie, scritto da: Tim Thompson, +Tony Andrews e G.R. (Fred) Walter. +In verità, poco o nulla è rimasto del loro codice originale. +.SH BACHI +Probabili. +Vedere ":help todo" per una lista di problemi noti. +.PP +Si noti che un certo numero di comportamenti che possono essere considerati +errori da qualcuno, sono in effetti causati da una riproduzione fin troppo +fedele del comportamento di Vi. +Se ritenete che altre cose siano errori "perché Vi si comporta diversamente", +date prima un'occhiata al file vi_diff.txt +(o battere :help vi_diff.txt da Vim). +Date anche un'occhiata alle opzioni 'compatible' e 'cpoptions. diff --git a/runtime/doc/manpages/it/vimdiff-it.1 b/runtime/doc/manpages/it/vimdiff-it.1 new file mode 100644 index 0000000000..090892fa93 --- /dev/null +++ b/runtime/doc/manpages/it/vimdiff-it.1 @@ -0,0 +1,48 @@ +.TH VIMDIFF 1 "30 marzo 2001" +.SH NOME +vimdiff \- modifica due, tre o quattro versioni di un file con Vim, +visualizzando le differenze +.SH SINTASSI +.br +.B vimdiff +[opzioni] file1 file2 [file3 [file4]] +.PP +.B gvimdiff +.SH DESCRIZIONE +.B Vimdiff +inizia +.B Vim +per due (o tre o quattro) file. +Ogni file ha una sua finestra. +Le differenze fra file sono evidenziate. +È una maniera elegante per controllare modifiche e portare modifiche +verso un'altra versione dello stesso file. +.PP +Vedere vim(1) per dettagli su Vim in generale. +.PP +Se iniziato con +.B gvimdiff +la GUI sarà utilizzata, se disponibile. +.PP +In ogni finestra l'opzione 'diff' è impostata, evidenziando così le +differenze. +.br +Le opzioni 'wrap' e 'scrollbind' sono impostate per migliorare la +visibilità del testo. +.br +L'opzione 'foldmethod' è impostata al valore "diff", che mette gruppi di +linee uguali fra i diversi file in una piegatura. 'foldcolumn' è impostato +a due per poter facilmente visualizzare le piegature, aprirle e chiuderle. +.SH OPZIONI +Lo schermo è diviso verticalmente, come se aveste usato l'opzione "\-O". +Per dividerlo orizzontalmente, usare l'opzione "\-o". +.PP +Per tutte le altre opzioni, vedere vim(1). +.SH VEDERE ANCHE +vim(1) +.SH AUTORE +Buona parte di +.B Vim +è stato scritto da Bram Moolenaar, con molto aiuto da altri. +Vedere ":help credits" in +.B Vim. diff --git a/runtime/doc/manpages/it/vimtutor-it.1 b/runtime/doc/manpages/it/vimtutor-it.1 new file mode 100644 index 0000000000..a33dcb00b0 --- /dev/null +++ b/runtime/doc/manpages/it/vimtutor-it.1 @@ -0,0 +1,58 @@ +.TH VIMTUTOR 1 "2 aprile 2001" +.SH NOME +vimtutor \- Un breve corso per imparare Vim +.SH SINTASSI +.br +.B vimtutor [\-g] [lingua] +.SH DESCRIZIONE +.B Vimtutor +inizia il +.B Vim +tutor (una breve corso per imparare Vim). +Per prima cosa viene creata una copia del file di lavoro, che può così essere +modificato senza alterare il file usato come modello. +.PP +Il comando +.B Vimtutor +è utile a chi voglia imparare i primi comandi +.B Vim +. +.PP +L'argomento opzionale \-g inizia vimtutor usando gvim invece che vim, se la +versione GUI di vim è disponibile. oppure utilizza vim, se gvim non è +disponibile. +.PP +L'arogmento opzionale [lingua] è l'abbreviazione di due lettere del nome +di una lingua, per esempio "it" oppure "es". +se L'argomento [lingua] non viene specificato, si utilizza la lingua "locale" +del computer. +Se la versione in quella lingua del "tutor" è disponibile, sarà usata. +Altrimenti sarà usata la versione inglese. +.PP +.B Vim +è sempre iniziato in Modo compatibile con vi. +.SH FILE +.TP 15 +/usr/local/lib/vim/tutor/tutor[.language] +Il/I file di testo per +.B Vimtutor + +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Lo script di Vim usato per copiare il file di testo +.B Vimtutor +. +.SH AUTORE +The +.B Vimtutor +è stato scritto in origine per Vi da Michael C. Pierce e Robert K. Ware, +Colorado School of Mines, usando idee fornite da Charles Smith, +Colorado State University. +E\-mail: bware@mines.colorado.edu. +.br +È stato modificato per +.B Vim +da Bram Moolenaar. +Per i nomi dei traduttori, vedere i file usati nelle rispettive lingue. +.SH VEDERE ANCHE +vim(1) diff --git a/runtime/doc/manpages/it/xxd-it.1 b/runtime/doc/manpages/it/xxd-it.1 new file mode 100644 index 0000000000..b6ccabd2e3 --- /dev/null +++ b/runtime/doc/manpages/it/xxd-it.1 @@ -0,0 +1,402 @@ +.TH XXD 1 "Agosto 1996" "Pagina di manuale per xxd" +.\" +.\" 21 Maggio 1996 +.\" Autore della pagina di manuale: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Modificato da Bram Moolenaar <Bram@vim.org> +.SH NOME +.I xxd +\- Produce esadecimale da un file binario o viceversa. +.SH SINTASSI +.B xxd +\-h[elp] +.br +.B xxd +[opzioni] [input_file [output_file]] +.br +.B xxd +\-r[evert] [opzioni] [input_file [output_file]] +.SH DESCRIZIONE +.I xxd +crea un'immagine esadecimale di un dato file o dello "standard input". +Può anche ottenere da un'immagine esadecimale il file binario originale. +Come +.BR uuencode (1) +e +.BR uudecode (1) +permette di trasmettere dati binari in una rappresentazione ASCII "a prova +di email", ma ha anche il vantaggio di poter decodificare sullo "standard +output". Inoltre, può essere usato per effettuare delle modifiche (patch) +a file binari. +.SH OPZIONI +Se non si specifica un +.I input_file +il programma legge dallo "standard input". +Se +.I input_file +è specificato come il carattere +.RB \` \- ' +, l'input è letto dallo "standard input". +Se non si specifica un +.I output_file +(o si mette al suo posto il carattere +.RB \` \- ' +), i risultati sono inviati allo "standard output". +.PP +Si noti che la scansione dei caratteri è "pigra", e non controlla oltre +la prima lettera dell'opzione, a meno che l'opzione sia seguita da un +parametro. +Gli spazi fra una singola lettera di opzione e il corrispondente parametro +dopo di essa sono facoltativi. +I parametri delle opzioni possono essere specificati usando la notazione +decimale, esadecimale oppure ottale. +Pertanto +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +e +.B \-cols 8 +sono notazioni equivalenti fra loro. +.PP +.TP +.IR \-a " | " \-autoskip +Richiesta di autoskip: Un singolo '*' rimpiazza linee di zeri binari. +Valore di default: off. +.TP +.IR \-b " | " \-bits +Richiesta di una immagine binaria (cifre binarie), invece che esadecimale. +Questa opzione scrive un byte come otto cifre "1" e "0" invece di usare i +numeri esadecimali. Ogni linea è preceduta da un indirizzo in esadecimale e +seguita da una decodifica ascii (o ebcdic). Le opzioni specificabili dalla +linea comando \-r, \-p, \-i non funzionano in questo modo. +.TP +.IR "\-c colonne " | " \-cols colonne" +.IR "\-c colonne " | " \-cols colonne" +In ogni linea sono formattate +.RI < colonne > +colonne. Valore di default 16 (\-i: 12, \-ps: 30, \-b: 6). +Valore massimo 256. +.TP +.IR \-E " | " \-EBCDIC +Cambia la codifica della colonna di destra da ASCII a EBCDIC. +Questo non modifica la rappresentazione esadecimale. Non ha senso +specificare questa opzione in combinazione con \-r, \-p o \-i. +.TP +.IR "\-g numero_byte " | " \-groupsize numero_byte" +Inserisci ogni +.RI < numero_byte > +byte di output (di due caratteri esadecimali o otto numeri binari ognuno) +uno spazio bianco. +Specificando +.I \-g 0 +i byte di output non sono separati da alcuno spazio. +.RI < numero_byte > ha come valore di default " 2 +in modalità normale [esadecimale] e \fI1\fP in modalità binaria. +Il raggruppamento non si applica agli stili "PostScript" e "include". +.TP +.IR \-h " | " \-help +stampa un sommario dei comandi disponibili ed esce. Non viene fatto +null'altro. +.TP +.IR \-i " | " \-include +L'output è nello stile dei file "include" in C. Viene preparata la +definizione completa di un "array" [vettore], dandogli il nome del +file di input), tranne che nel caso in cui xxd legga dallo "standard input". +.TP +.IR "\-l numero " | " \-len numero" +Il programma esce dopo aver scritto +.RI < numero > +byte. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +L'output è nello stile di un dump continuo sotto postscript. +Noto anche come stile esadecimale semplice [plain]. +.TP +.IR \-r " | " \-revert +ricostruzione: converte (o mette una patch) a partire dall'immagine +esadecimale, creando [o modificando] il file binario. +Se non diretto allo "standard output", xxd scrive nel suo file di output +in maniera continua, senza interruzioni. Usare la combinazione +.I \-r \-p +per leggere dump in stile esadecimale semplice [plain], senza l'informazione +di numero di linea e senza un particolare tracciato di colonna. Degli spazi +o delle linee vuote possono essere inserite a piacere [e vengono ignorate]. +.TP +.I \-seek distanza +Usato con l'opzione +.IR \-r : +(ricostruzione), +.RI < distanza > +viene aggiunta alla posizione nel file trovata nella immagine +esadecimale. +.TP +.I \-s [+][\-]seek +Inizia a +.RI < seek > +byte assoluti (o relativi) di distanza all'interno di input_file. +\fI+ \fRindica che il "seek" è relativo alla posizione corrente nel file +"standard input" (non significativa quando non si legge da "standard input"). +\fI\- \fRindica che il "seek" dovrebbe posizionarsi ad quel numero di +caratteri dalla fine dell'input (o se in combinazione con +\fI+ \fR: prime della posizione corrente nel file "standard input"). +Se non si specifica una opzione \-s, xxd inizia alla posizione +corrente all'interno del file. +.TP +.I \-u +usa lettere esadecimali maiuscole. Il valore di default è di usare +lettere minuscole. +.TP +.IR \-v " | " \-version +visualizza la stringa contenente la versione del programma. +.SH ATTENZIONE +.PP +.I xxd \-r +è capace di operare "magie" nell'utilizzare l'informazione "numero di linea". +Se sul file di output ci si può posizionare usando la "seek", il numero di +linea all'inizio di ogni riga esadecimale può essere non ordinato, delle +linee possono mancare delle linee, oppure esserci delle sovrapposizioni. +In simili casi xxd userà lseek(2) per raggiungere la posizione d'inizio. +Se il file di output non consente di usare "seek", sono permessi solo dei +"buchi", che saranno riempiti con zeri binari. +.PP +.I xxd \-r +non genera mai errori di specifica parametri. I parametri non riconosciuti +sono silenziosamente ignorati. +.PP +Nel modificare immagini esadecimali, tenete conto che +.I xxd \-r +salta il resto della linea, dopo aver letto abbastanza caratteri contenenti +dati esadecimali (vedere opzione \-c). Ciò implica pure che le modifiche alle +colonne di caratteri stampabili ascii (o ebcdic) sono sempre ignorate. +La ricostruzione da un file immagine esadecimale in stile semplice +(postscript) con xxd \-r \-p non dipende dal numero corretto di colonne. +IN questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali +è interpretata [e utilizzata]. +.PP +Notare la differenza fra +.br +\fI% xxd \-i file\fR +.br +e +.br +\fI% xxd \-i \< file\fR +.PP +.I xxd \-s \+seek +può comportarsi in modo diverso da +.IR "xxd \-s seek" +, perché lseek(2) è usata per tornare indietro nel file di input. Il '+' +fa differenza se il file di input è lo "standard input", e se la posizione nel +file di "standard input" non è all'inizio del file quando xxd è eseguito, +con questo input. +I seguenti esempi possono contribuire a chiarire il concetto +(o ad oscurarlo!)... +.PP +Riavvolge lo "standard input" prima di leggere; necessario perché `cat' +ha già letto lo stesso file ["file"] fino alla fine dello "standard input". +.br +\fI% sh \-c 'cat > copia_normale; xxd \-s 0 > copia_esadecimale' < file +.PP +Stampa immagine esadecimale dalla posizione file 0x480 (=1024+128) in poi. +Il segno `+' vuol dire "rispetto alla posizione corrente", quindi il `128' +si aggiunge a 1k (1024) dove `dd' si era fermato. +.br +\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +128 > esadecimale' < file +.PP +Immagine esadecimale dalla posizione 0x100 ( = 1024\-768 ) del file in avanti. +.br +\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale' < file +.PP +Comunque, questo capita raramente, e l'uso del `+' non serve quasi mai. +L'autore preferisce monitorare il comportamento di xxd con strace(1) o +truss(1), quando si usa l'opzione \-s. +.SH ESEMPI +.PP +.br +Stampa tutto tranne le prime tre linee (0x30 byte esadecimali) di +.B file +\. +.br +\fI% xxd \-s 0x30 file +.PP +.br +Stampa 3 linee (0x30 byte esadecimali) alla fine di +.B file +\. +.br +\fI% xxd \-s \-0x30 file +.PP +.br +Stampa 120 byte come immagine esadecimale continua con 20 byte per linea. +.br +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR + +.br +2e54482058584420312022417567757374203139 +.br +39362220224d616e75616c207061676520666f72 +.br +20787864220a2e5c220a2e5c222032317374204d +.br +617920313939360a2e5c22204d616e2070616765 +.br +20617574686f723a0a2e5c2220202020546f6e79 +.br +204e7567656e74203c746f6e79407363746e7567 +.br + +.br +Stampa i primi 120 byte della pagina di manuale vim.1 a 12 byte per linea. +.br +\fI% xxd \-l 120 \-c 12 xxd.1\fR + + +.br +0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +.br +000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +.br +0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +.br +0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\ +.br +0000030: 220a 2e5c 2220 3231 7374 204d "..\" 21st M +.br +000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\" +.br +0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +.br +0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\" +.br +0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +.br +000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +.PP +.br +Visualizza la data dal file xxd.1 +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +.PP +.br +Copiare +.B input_file +su +.B output_file +premettendogli 100 byte a 0x00. +.br +\fI% xxd input_file | xxd \-r \-s 100 \> output_file\fR +.br + +.br +Modificare (patch) la data nel file xxd.1 +.br +\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +.PP +.br +Creare un file di 65537 byte tutto a 0x00, +tranne che l'ultimo carattere che è una 'A' (esadecimale 0x41). +.br +\fI% echo '010000: 41' | xxd \-r \> file\fR +.PP +.br +Stampa una immagine esadecimale del file di cui sopra con opzione autoskip. +.br +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Crea un file di 1 byte che contiene il solo carattere 'A'. +Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file; +in pratica, i byte precedenti non sono stampati. +.br +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +.PP +Usa xxd come filtro all'interno di un editor come +.B vim(1) +per ottenere una immagine esadecimale di una parte di file +delimitata dai marcatori `a' e `z'. +.br +\fI:'a,'z!xxd\fR +.PP +Usare xxd come filtro all'interno di un editor come +.B vim(1) +per ricostruire un pezzo di file binario da una immagine esadecimale +delimitata dai marcatori `a' e `z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +Usare xxd come filtro all'interno di un editor come +.B vim(1) +per ricostruire una sola linea di file binario da una immagine esadecimale, +Portare il cursore sopra la linea e battere: +.br +\fI!!xxd \-r\fR +.PP +Per leggere singoli caratteri da una linea seriale +.br +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.PP +.SH CODICI DI RITORNO +Il programma può restituire questi codici di errore: +.TP +0 +nessun errore rilevato. +.TP +\-1 +operazione non supportata ( +.I xxd \-r \-i +non ancora possible). +.TP +1 +errore durante la scansione parametri. +.TP +2 +problemi con il file di input. +.TP +3 +problemi con il file di output. +.TP +4,5 +posizione "seek" specificata non raggiungibile all'interno del file. +.SH VEDERE ANCHE +uuencode(1), uudecode(1), patch(1) +.br +.SH AVVERTIMENTI +La stranezza dello strumento rispecchia la mente del suo creatore. +Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. +Diventate un mago. +.br +.SH VERSIONE +Questa pagina di manuale documenta la versione 1.7 di xxd. +.SH AUTORE +.br +(c) 1990-1997 Juergen Weigert +.br +<jnweiger@informatik.uni\-erlangen.de> +.LP +Distribuite liberamente ed attribuitemi il credito, +.br +fate soldi e condivideteli con me +.br +perdete soldi e non venite a chiederli a me. +.PP +Pagina di manuale messa in piedi da Tony Nugent +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Piccole modifiche di Bram Moolenaar. +Modificato da Juergen Weigert. +.PP diff --git a/runtime/doc/manpages/ja/evim-ja.1 b/runtime/doc/manpages/ja/evim-ja.1 new file mode 100644 index 0000000000..1b7a657ebc --- /dev/null +++ b/runtime/doc/manpages/ja/evim-ja.1 @@ -0,0 +1,51 @@ +.TH EVIM 1 "2002 February 16" +.SH 名前 +evim \- easy Vim, モードレスエディタ Vim +.SH 書式 +.br +.B evim +[options] [file ..] +.br +.B eview +.SH 説明 +.B eVim +は +.B Vim +を起動して、モードレスエディタとして動作するためのオプションを設定します。 +Vim の動作が point-and-click エディタのような動作になります。 +MS-Windows のメモ帳のような動作です。 +.B eVim +は常に GUI で起動し、メニューとツールバーを表示します。 +.PP +どうしても Vim の操作に馴染めない場合に使ってください。 +編集効率は下がります。 +.PP +.B eview +は同様に、読み込み専用モードで起動します。evim \-R と同じです。 +.PP +引数や Vim についての詳細は vim(1) を参照してください。 +.PP +オプション '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 別名 +evim は "gumbies のための Vim" とも呼ばれています。 +evim を使っているあなたはきっと、頭にハンカチをかぶっているのです。 +(訳注: gumbies は Monty Python に登場するおもしろ集団。ハンカチをかぶっ +ている。) +.SH 関連項目 +vim(1) +.SH 著者 +.B Vim +のほとんどの機能は Bram Moolenaar が開発し、多くの人が協力しました。 +メニューの Help/Credits を参照してください。 diff --git a/runtime/doc/manpages/ja/vim-ja.1 b/runtime/doc/manpages/ja/vim-ja.1 new file mode 100644 index 0000000000..a4788b3c48 --- /dev/null +++ b/runtime/doc/manpages/ja/vim-ja.1 @@ -0,0 +1,501 @@ +.TH VIM 1 "2006 Apr 11" +.SH 名前 +vim \- Vi IMproved, プログラマのテキストエディタ +.SH 書式 +.br +.B vim +[options] [file ..] +.br +.B vim +[options] \- +.br +.B vim +[options] \-t tag +.br +.B vim +[options] \-q [errorfile] +.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 説明 +.B Vim +は Vi 互換のテキストエディタです。 +どのような種類のプレインテキストでも編集できます。 +特に、プログラムの編集に力を発揮します。 +.PP +Vi に多くの改良が加えられています: +多段アンドゥ、マルチウィンドウ、マルチバッファ、構文強調表示、 +コマンドライン編集、ファイル名補完、ヘルプ、ビジュアル選択、などなど。 +.B Vim +と Vi の違いについての要約は ":help vi_diff.txt" を参照してください。 +.PP +.B Vim +の実行中は ":help" コマンドでヘルプを引くことができます。 +下記、オンラインヘルプの項を参照してください。 +.PP +.B Vim +は次のようなコマンドで起動できます。 +.PP + vim file +.PP +正確な書式は次の通りです: +.PP + vim [options] [filelist] +.PP +filelist を省略した場合は、空のバッファが開かれます。 +指定した場合は、以下の四つのうちどれか一つの方法でファイルが開かれます。 +.TP 12 +file .. +ファイルのリスト。 +一番目のファイルがカレントファイルになり、バッファに読み込まれます。 +カーソルは、バッファの一行目に置かれます。 +他のファイルを表示するには ":next" コマンドを使ってください。 +ファイル名がダッシュで始まるファイルを開く場合は、 +filelist の前に "\-\-" を指定してください。 +.TP +\- +ファイルは標準入力から読み込まれます。コマンドは標準エラー (ttyからの入 +力になっているはず) から読み込まれます。 +.TP +\-t {tag} +開くファイルとカーソルの初期位置は "tag" に依存します。goto label の一種です。 +tags ファイルから {tag} が検索され、関連したファイルがカレントファイルになり +ます。そして、関連したコマンドが実行されます。 +これは主に C 言語のファイルを開くときに使われます。その場合 {tag} に関数など +を指定して使います。 +関数を含んでいるファイルが開かれ、その関数の先頭にカーソルが移動する、 +という動作になります。 +詳しくは ":help tag\-commands" を参照してください。 +.TP +\-q [errorfile] +クイックフィックスモードで起動します。 +[errorfile] に指定したファイルが読み込まれ、最初のエラーが表示されます。 +[errorfile] を省略した場合は、オプション 'errorfile' が使われます (初期設定 +は、Amiga では "AztecC.Err"、その他のシステムでは "errors.err" です)。 +":cn" コマンドで次のエラーにジャンプできます。 +詳しくは ":help quickfix" を参照してください。 +.PP +.B Vim +は、起動されたときの実行ファイルの名前によって動作を変えます +(実行ファイルの実体が同じであっても)。 +.TP 10 +vim +"普通" に起動します。標準の状態です。 +.TP +ex +Ex モードで起動します。 +ノーマルモードに切り替えるには ":vi" コマンドを使ってください。 +引数に "\-e" を指定した場合と同じです。 +.TP +view +読み込み専用モードで起動します。ファイルの保存が制限されます。 +引数に "\-R" を指定した場合と同じです。 +.TP +gvim gview +GUI バージョン。 +新しいウィンドウを開いて起動します。 +引数に "\-g" を指定した場合と同じです。 +.TP +evim eview +簡易モードの GUI バージョン。 +新しいウィンドウを開いて起動します。 +引数に "\-y" を指定した場合と同じです。 +.TP +rvim rview rgvim rgview +上記と同じですが、制限モードで起動します。シェルコマンドを実行したり、 +.B Vim +をサスペンドしたりできなくなります。 +引数に "\-Z" を指定した場合と同じです。 +.SH オプション +ファイル名の前でも後ろでも、好きな順番でオプションを指定できます。 +パラメータを必要としない引数は、一つのダッシュにまとめて指定できます。 +.TP 12 ++[num] +一番目のファイルの "num" 行目にカーソルを移動します。 +"num" を省略した場合は、一行目にカーソルが移動します。 +.TP ++/{pat} +一番目のファイルの、最初に {pat} が見つかった行にカーソルが移動します。 +検索パターンについては ":help search\-pattern" を参照してください。 +.TP ++{command} +.TP +\-c {command} +一番目のファイルが読み込まれた後に {command} が実行されます。 +{command} は Ex コマンドとして解釈されます。 +{command} に空白を含める場合は、ダブルクォートで囲んでください (シェルに依存)。 +例: vim "+set si" main.c +.br +Note: "+" と "\-c" は合わせて 10 個まで指定できます。 +.TP +\-S {file} +一番目のファイルが読み込まれた後に {file} が実行されます。 +これは \-c "source {file}" と同じ動作です。 +{file} の先頭が '\-' の場合は使えません。 +{file} が省略された場合は、"Session.vim" が使われます (ただし \-S が最後の引 +数だった場合のみ)。 +.TP +\-\-cmd {command} +"\-c" と同じですが、vimrc を処理する前にコマンドが実行されます。 +これらのコマンドは "\-c" コマンドとは別に、10 個まで指定できます。 +.TP +\-A +アラビア語がサポートされていて、アラビア語キーマップがある場合は、 +アラビア語モードで起動します ('arabic' がオンになります)。 +右横書きのファイルを編集できます。 +サポートされていない場合はエラーメッセージを表示して終了します。 +.TP +\-b +バイナリモード。 +バイナリファイルを編集ためのオプションがいくつか設定されます。 +.TP +\-C +互換モード。'compatible' オプションがオンになります。 + .vimrc ファイルの有無に関わらず、 +.B Vim +の動作が Vi 互換になります。 +.TP +\-d +差分モードで起動します。 +二つか三つの四つのファイルを引数に指定してください。 +指定されたファイルが開かれ、それらのファイルの差分が表示されます。 +vimdiff(1) と同様の動作です。 +.TP +\-d {device} +{device} を端末として開きます。 +Amiga でのみ使います。 +例: +"\-d con:20/30/600/150". +.TP +\-D +デバッグ。スクリプトの最初のコマンドが実行されるところからデバッグモードを開 +始します。 +.TP +\-e +Ex モードで起動します。 +実行ファイルの名前が "ex" の場合と同じです。 +.TP +\-E +改良版 Ex モードで起動します。 +実行ファイルの名前が "exim" の場合と同じです。 +.TP +\-f +フォアグラウンド。GUI バージョンで、プロセスをフォークしなくなります。 +Amiga の場合は、新しいウィンドウで再起動しなくなります。 +メールソフトなどから +.B Vim +を起動して、編集が終わるまで待機したいような場合に使ってください。 +Amiga では、":sh" と "!" コマンドは機能しなくなります。 +.TP +\-\-nofork +フォアグラウンド。GUI バージョンで、プロセスをフォークしなくなります。 +.TP +\-F +ペルシア語がサポートされていて、ペルシア語キーマップがある場合は、 +ペルシア語モードで起動します ('fkmap' と 'rightleft' がオンになります)。 +右横書きのファイルを編集できます。 +サポートされていない場合はエラーメッセージを表示して終了します。 +.TP +\-g +GUI がサポートされている場合は、GUI で起動します。 +サポートされていない場合はエラーメッセージを表示して終了します。 +.TP +\-h +コマンドライン引数やオプションのヘルプを表示して終了します。 +.TP +\-H +ヘブライ語がサポートされていて、ヘブライ語キーマップがある場合は、 +ヘブライ語モードで起動します ('hkmap' と 'rightleft' がオンになります)。 +右横書きのファイルを編集できます。 +サポートされていない場合はエラーメッセージを表示して終了します。 +.TP +\-i {viminfo} +viminfo ファイルを使う設定になっている場合は、初期設定の "~/.viminfo" の代わ +りに、指定されたファイルを設定します。 +"NONE" を指定すると、.viminfo ファイルを使わないように設定できます。 +.TP +\-L +\-r と同じです。 +.TP +\-l +lisp モード。 +オプションの 'lisp' と 'showmatch' がオンになります。 +.TP +\-m +ファイルの変更を不可能にします。 +オプション 'write' がオフになります。 +バッファを変更することはできますが、ファイルを保存することはできません。 +.TP +\-M +変更を不可能にします。オプションの 'modifiable' と 'write' がオフになり、 +ファイルの変更と保存ができなくなります。 +Note: それらのオプションを設定すれば変更できるようになります。 +.TP +\-N +非互換モード。'compatible' オプションがオフになります。 + .vimrc ファイルの有無に関わらず、 +.B Vim +の改良された機能が有効になります。Vi との互換性が少し失われます。 +.TP +\-n +スワップファイルを使用しません。 +クラッシュしてもリカバリできなくなります。 +フロッピーディスクのような非常に低速なメディアのファイルを読み書きするときに +便利です。 +":set uc=0" と設定しても同じです。 +戻すには ":set uc=200" と設定してください。 +.TP +\-nb +NetBeans と接続し、エディタサーバーになります。 +詳しくはヘルプを参照してください。 +.TP +\-o[N] +N 個のウィンドウを水平分割で開きます。 +N を省略した場合は、引数のファイルを個別のウィンドウで開きます。 +.TP +\-O[N] +N 個のウィンドウを垂直分割で開きます。 +N を省略した場合は、引数のファイルを個別のウィンドウで開きます。 +.TP +\-p[N] +N 個のタブページを開きます。 +N を省略した場合は、引数のファイルを個別のタブページで開きます。 +.TP +\-R +読み込み専用モード。 +オプション 'readonly' がオンになります。 +バッファを変更することはできますが、間違ってファイルを上書きしてしまうのを防 +ぐことができます。 +ファイルを保存したい場合は、":w!" のように、Ex コマンドに感嘆符を付けてくだ +さい。 +\-R オプションは \-n オプションの効果も含んでいます (下記参照)。 +オプション 'readonly' は ":set noro" でオフにできます。 +詳しくは ":help 'readonly'" を参照してください。 +.TP +\-r +スワップファイルの一覧を表示します。リカバリに関する情報も表示されます。 +.TP +\-r {file} +リカバリモード。 +スワップファイルを使って、クラッシュした編集セッションを復活させます。 +スワップファイルは、ファイル名に ".swp" を加えた名前のファイルです。 +詳しくは ":help recovery" を参照してください。 +.TP +\-s +サイレントモード。"ex" という名前で起動するか、"\-e" オプションの後で +"\-s" オプションが指定された場合のみ。 +.TP +\-s {scriptin} +{scriptin} をスクリプトファイルとして読み込まれます。 +ファイル中の文字列は、手で入力したときと同じように処理されます。 +これは ":source! {scriptin}" と同じ動作です。 +エディタが終了する前にファイルの終わりまで読み込んだ場合、 +それ以降はキーボードから入力を読み込みます。 +.TP +\-T {terminal} +端末の名前を指定します。 +端末が自動的に認識されない場合に使ってください。 +Vim が組み込みでサポートしている名前か、 +termcap または terminfo ファイルで定義されている名前を指定してください。 +.TP +\-u {vimrc} +{vimrc} ファイルを使って初期化します。 +他の初期化処理はスキップされます。 +特殊なファイルを編集する場合などに使ってください。 +すべての初期化をスキップするには "NONE" を指定してください。 +詳しくは ":help initialization" を参照してください。 +.TP +\-U {gvimrc} +{gvimrc} ファイルを使って GUI を初期化します。 +他の GUI の初期化はスキップされます。 +すべての GUI の初期化をスキップするには "NONE" を指定してください。 +詳しくは ":help gui\-init" を参照してください。 +.TP +\-V[N] +冗長モード。スクリプトファイルを実行したり viminfo ファイルを読み書きするた +びにメッセージを表示します。N に指定した数値が 'verbose' に設定されます。 +省略した場合は 10 になります。 +.TP +\-v +Vi モードで起動します。 +実行ファイルの名前が "vi" の場合と同じです。 +実行ファイルの名前が "ex" の場合だけ効果があります。 +.TP +\-w {scriptout} +入力した文字を {scriptout} に記録します。 +"vim \-s" や "source!" で実行するためのスクリプトファイルを作成するのに便利 +です。 +{scriptout} ファイルがすでに存在した場合は追加保存されます。 +.TP +\-W {scriptout} +\-w と同じですが、ファイルがすでに存在した場合は上書きされます。 +.TP +\-x +ファイルを暗号化して書き込みます。暗号化キーの入力プロンプトが表示されます。 +.TP +\-X +X サーバーと通信しません。端末での起動時間を短くできます。 +しかし、ウィンドウタイトルの変更やクリップボードは使えなくなります。 +.TP +\-y +簡易モードで起動します。 +実行ファイルの名前が "evim" や "eview" の場合と同じです。 +.B Vim +の動作がモードレスエディタ (click-and-type editor) のようになります。 +.TP +\-Z +制限モード。 +実行ファイルの名前が "r" で始まっている場合と同じです。 +.TP +\-\- +オプション指定の末尾を示す記号です。 +これ以降の引数はすべてファイル名として扱われます。 +ファイル名が '\-' で始まっているファイルを開くときに使ってください。 +.TP +\-\-echo\-wid +GTK GUI のみ: Window ID を標準出力に出力します。 +.TP +\-\-help +ヘルプを表示して終了します。"\-h" と同じです。 +.TP +\-\-literal +引数のファイル名をリテラル文字列として扱います。ワイルドカードを展開しませ +ん。Unix のように、シェルがワイルドカードを展開する場合は機能しません。 +.TP +\-\-noplugin +プラグインをロードしません。\-u NONE はこの動作を含んでいます。 +.TP +\-\-remote +Vim サーバーと通信し、引数に指定されたファイルを Vim サーバーで開きます。 +サーバーが存在しない場合は、エラーメッセージを表示され、起動中の Vim でファ +イルが開かれます。 +.TP +\-\-remote\-expr {expr} +Vim サーバーと通信し、{expr} に与えられた式を Vim サーバーで実行し、結果を標 +準出力に出力します。 +.TP +\-\-remote\-send {keys} +Vim サーバーと通信し、{keys} に与えられたキーを Vim サーバーに送信します。 +.TP +\-\-remote\-silent +\-\-remote と同じですが、サーバーが存在しなくてもエラーメッセージを表示しま +せん。 +.TP +\-\-remote\-wait +\-\-remote と同じですが、ファイルが開かれるのを確認できるまで待機します。 +.TP +\-\-remote\-wait\-silent +\-\-remote\-wait と同じですが、サーバーが存在しなくてもエラーメッセージを表 +示しません。 +.TP +\-\-serverlist +Vim サーバーの一覧を表示します。 +.TP +\-\-servername {name} +サーバーの名前を {name} に設定します。\-\-remote 引数を指定しなかった場合 +は、起動中の Vim の名前として使われるので、後からその名前を使ってサーバー通 +信できます。 +.TP +\-\-socketid {id} +GTK GUI のみ: GtkPlug メカニズムを使って gvim を別のウィンドウの中で実行しま +す。 +.TP +\-\-version +バージョン情報を表示して終了します。 +.SH オンラインヘルプ +ヘルプを開くには、 +.B Vim +の中で ":help" と入力してください。 +":help 調べたい項目" と入力すれば、指定した項目のヘルプが表示されます。 +例: "ZZ" コマンドのヘルプを表示するには ":help 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 +ヘルプを検索するための 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 +~/.vimrc +ユーザーの +.B Vim +初期化ファイル。 +.TP +/usr/local/lib/vim/gvimrc +システムの gvim 初期化ファイル。 +.TP +~/.gvimrc +ユーザーの gvim 初期化ファイル。 +.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" を参照してください。 +.br +.B Vim +は Stevie を基にしています。Stevie は Tim Thompson、Tony Andrews、 +G.R. (Fred) Walter によって開発されました。 +ただし、オリジナルのコードはもうほとんど残っていません。 +.SH バグ +既知のバグは ":help todo" に記載されています。 +.PP +Vi の動作を忠実に再現した結果、多くの人がバグだと思うような機能もいくつかあ +ります。 +"この動作は Vi と違う" からバグだと思った場合は、vi_diff.txtを確認してみてく +ださい (ファイルを開くか、Vim から ":help vi_diff.txt" と入力)。 +オプションの 'compatible' と 'cpoptions' も確認してください。 diff --git a/runtime/doc/manpages/ja/vimdiff-ja.1 b/runtime/doc/manpages/ja/vimdiff-ja.1 new file mode 100644 index 0000000000..56fadfef6e --- /dev/null +++ b/runtime/doc/manpages/ja/vimdiff-ja.1 @@ -0,0 +1,44 @@ +.TH VIMDIFF 1 "2001 March 30" +.SH 名前 +vimdiff \- 二つか三つか四つのファイルを Vim で開いて、その差分を表示する +.SH 書式 +.br +.B vimdiff +[options] file1 file2 [file3 [file4]] +.PP +.B gvimdiff +.SH 説明 +.B Vimdiff +は、二つ (か三つか四つ) のファイルを +.B Vim +で開きます。 +ファイルは個別のウィンドウで開かれ、差分が強調表示されます。 +同じファイルの別のバージョン間で、変更を確認したり、変更を移動したりするのが +簡単になります。 +.PP +Vim についての詳細は vim(1) を参照してください。 +.PP +.B gvimdiff +という名前で起動された場合は GUI で起動します。 +.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" を参照してください。 diff --git a/runtime/doc/manpages/ja/vimtutor-ja.1 b/runtime/doc/manpages/ja/vimtutor-ja.1 new file mode 100644 index 0000000000..29b9b48f2c --- /dev/null +++ b/runtime/doc/manpages/ja/vimtutor-ja.1 @@ -0,0 +1,45 @@ +.TH VIMTUTOR 1 "2001 April 2" +.SH 名前 +vimtutor \- Vim チュートリアル +.SH 書式 +.br +.B vimtutor [\-g] [language] +.SH 説明 +.B Vim +のチュートリアルを起動します。 +演習ファイルのコピーを使って実施するので、オリジナルの演習ファイルを壊してし +まう心配はありません。 +.PP +.B Vim +を初めて学ぶ人向けのチュートリアルです。 +.PP +引数に \-g を指定すると GUI 版の vim が利用可能であれば vim ではなく gvim を +使って vimtutor が開始します。gvim が見つからないときは Vim が使用されます。 +.PP +[language] 引数は "ja" や "es" などの二文字の言語名です。 +[language] 引数を省略した場合はロケールの言語が使われます。 +翻訳された演習ファイルがある場合は、そのファイルが使われます。 +ない場合は英語のファイルが使われます。 +.PP +.B Vim +は Vi 互換モードで起動されます。 +.SH ファイル +.TP 15 +/usr/local/lib/vim/tutor/tutor[.language] +.B Vimtutor +の演習ファイル。 +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +演習ファイルをコピーするための Vim スクリプト。 +.SH 著者 +.B Vimtutor +は、Colorado State University の Charles Smith のアイデアを基に、 +Colorado School of Mines の Michael C. Pierce と Robert K. Ware の両名 +によって Vi 向けに作成されたものを基にしています。 +E-mail: bware@mines.colorado.edu. +.br +.B Vim +に合わせて Bram Moolenaar が変更を加えました。 +翻訳者の名前は演習ファイルを参照してください。 +.SH 関連項目 +vim(1) diff --git a/runtime/doc/manpages/ja/xxd-ja.1 b/runtime/doc/manpages/ja/xxd-ja.1 new file mode 100644 index 0000000000..8a8d54b021 --- /dev/null +++ b/runtime/doc/manpages/ja/xxd-ja.1 @@ -0,0 +1,366 @@ +.TH XXD 1 "August 1996" "Manual page for 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 +\- 16 進ダンプを作成したり、元に戻したり。 +.SH 書式 +.B xxd +\-h[elp] +.br +.B xxd +[options] [infile [outfile]] +.br +.B xxd +\-r[evert] [options] [infile [outfile]] +.SH 説明 +ファイルや標準入力から 16 進ダンプを作成します。 +16 進ダンプから元のバイナリに戻すこともできます。 +.BR uuencode (1) +や +.BR uudecode (1) +のように、バイナリデータを、メールに貼り付け可能な ASCII 形式に変換できた +り、標準出力に出力することもできます。 +さらに、バイナリファイルにパッチを当てるという使い方もできます。 +.SH オプション +.I infile +を指定しなかった場合は、標準入力が読み込まれます。 +.I infile +に +.RB \` \- ' +を指定した場合も、標準入力から読み込まれます。 +.I outfile +を指定しなかった (または +.RB \` \- ' +を指定した) 場合は、標準出力に出力されます。 +.PP +引数の解釈処理は適当なので注意してください。パラメータを取らない引数は +最初の一文字だけチェックされます。 +引数の文字とパラメータの間のスペースは省略可能です。 +パラメータは 10 進数、16 進数、8 進数で指定できます。 +.BR \-c8 +、 +.BR "\-c 8" +、 +.B \-c 010 +、 +.B \-cols 8 +はすべて同じ意味です。 +.PP +.TP +.IR \-a " | " \-autoskip +オートスキップ: 連続した nul 行を一つの '*' で置き換える。 +.TP +.IR \-b " | " \-bits +ビット (2進数) ダンプ。 +1 オクテットが "1" と "0" の 8 文字で出力されます。 +各行の行頭には 16 進数の行番号が表示されます。 +行末には ascii (または ebcdic) で表した場合の文字が表示されます。 +このモードでは \-r、\-p、\-i は機能しません。 +.TP +.IR "\-c cols " | " \-cols cols" +一行 +.RI < cols > +オクテットで出力する。標準設定は 16 (\-i: 12, \-ps: 30, \-b: 6)。最大 256。 +.TP +.IR \-E " | " \-EBCDIC +右端に出力される文字のエンコーディングを ASCII から EBCDIC に変更する。 +16 進ダンプの出力形式は変更されません。 +\-r、\-p、\-i が同時に指定された場合は何の効果もありません。 +.TP +.IR "\-g bytes " | " \-groupsize bytes" +出力を +.RI < bytes > +バイト (2 文字の 16 進数、または 8 文字の 2 進数) ごとにスペースで区切りま +す。 +区切らずに出力するには +.I \-g 0 +を指定してください。 +.RI < Bytes > +の標準設定は \fI2\fP です。2 進ダンプの場合は \fI1\fP です。 +ポストスクリプト形式やインクルード形式で出力するときは、このオプションは使わ +れません。 +.TP +.IR \-h " | " \-help +コマンドの説明を出力して終了する。変換は実行されません。 +.TP +.IR \-i " | " \-include +C インクルードファイル形式で出力します。入力ファイルの名前が付けられた静的配 +列の定義が出力されます。標準入力の場合は定義の中身だけ出力されます。 +.TP +.IR "\-l len " | " \-len len" +.RI < len > +オクテットだけ出力する。 +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +ポストスクリプト形式の 16 進ダンプを出力する。別名 プレーン 16 進ダンプ。 +.TP +.IR \-r " | " \-revert +元に戻す: 16 進ダンプからバイナリ形式に変換 (またはパッチ) します。 +ファイルへ出力する場合、出力先のファイルは切り詰めされません。 +行番号や特定の書式がないプレーン 16 進ダンプを読み込む場合は、 +.I \-r \-p +を指定してください。空白と改行は無視されます。 +.TP +.I \-seek offset +.IR \-r +の後で使われた場合: 16 進ダンプを出力するファイルの位置に +.RI < offset > +を加える。 +.TP +.I \-s [+][\-]seek +infile の +.RI < seek > +バイト目 (絶対位置、または相対位置) から開始する。 +\fI+ \fRは、現在の標準入力の位置から相対的な位置を示します +(標準入力から読み込むときのみ意味があります)。\fI\- \fRは、入力の終わりから +の文字数を示します (\fI+\fR と同時に指定した場合は、現在の標準入力の位置から +手前の位置を示します)。 +\-s 引数を指定しなかった場合は、現在のファイル位置から開始されます。 +.TP +.I \-u +16 進数の表記に大文字を使います。指定がない場合は小文字で出力されます。 +.TP +.IR \-v " | " \-version +バージョンを表示します。 +.SH 警告 +.PP +.I xxd \-r +では行番号の評価に関しての暗黙のルールがいくつかあります。 +出力ファイルがシーク可能なら、各行の行番号が順番通りに並んでなくても構いませ +ん。位置が飛んでいても重なっていても大丈夫です。その場合、次の位置に移動する +ために lseek(2) が使われます。 +出力ファイルがシーク不可なら、「隙間」だけが処理可能です。隙間は null バイト +で埋められます。 +.PP +.I xxd \-r +は不正な入力をエラーにしません。ゴミは静かに読み飛ばされます。 +.PP +16 進ダンプを編集するときは注意が必要です。 +.I xxd \-r +は必要な桁 (\-c 引数参照) だけ 16 進データを読み込んで、行の残りを無視しま +す。つまり、ascii (または ebcdic) を示している列への変更は無視されます。 +xxd \-r \-p でプレーン形式 (ポストスクリプト形式) の 16 進ダンプを元に戻す場 +合は、列の数は影響しません。 +2 桁の 16 進数と認識できるものはすべて変換されます。 +.PP +\fI% xxd \-i file\fR +.br +と +.br +\fI% xxd \-i < file\fR +.br +の結果は違います。注意してください。 +.PP +.I xxd \-s +seek +と +.IR "xxd \-s seek" , +の違いは、lseek(2) を使って入力を "巻き戻す" かどうかです。'+' が意味を持つ +のは、入力が標準入力で、xxd が起動されたときに標準入力のファイル位置がファイ +ルの先頭ではなかった場合です。 +以下の例が分かりやすいかもしれません (もっと混乱するかも!)... +.PP +`cat' が既に標準入力を終わりまで読んでいるので、読む前に標準入力を巻き戻す必 +要がある。 +.br +\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR +.PP +ファイル位置 0x480 (=1024+128) 前方から 16 進ダンプする。 +`+' は 「現在地からの相対位置」を意味するので、dd が 1k 処理した後から、さら +に `128' 進めます。 +.br +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fR +.PP +ファイル位置 0x100 ( = 1024\-768) から 16 進ダンプする。 +.br +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR +.PP +このような使い方はあまりしませんし、`+' を使うこともほとんどないでしょう。 +\-s を使うときはいつでも、strace(1) や truss(1) を使って、xxd の働きをチェッ +クすることをお勧めします。 +.SH 例 +.PP +.br +.BR ファイル +の最初の三行 (16 進数で 0x30 バイト) 以降を出力する。 +.br +\fI% xxd \-s 0x30 file\fR +.PP +.br +.BR ファイル +の最後から三行 (16 進数で 0x30 バイト) を出力する。 +.br +\fI% xxd \-s \-0x30 file\fR +.PP +.br +120 バイトを、平文 16 進ダンプ形式で一行に 20 オクテットずつ出力する。 +.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 +この man ページの先頭から 120 バイトを一行に 12 オクテットずつ 16 進ダンプす +る。 +.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 +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 +.B input_file +を +.B output_file +にコピーし、先頭に 0x00 を 100 バイト分付け加える。 +.br +\fI% xxd input_file | xxd \-r \-s 100 > output_file\fR +.br + +.br +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 +中身がすべて 0x00 の 65537 バイトのファイルを作成する。 +ただし、最後のバイトだけは 'A' (hex 0x41)。 +.br +\fI% echo "010000: 41" | xxd \-r > file\fR +.PP +.br +作成したファイルをオートスキップを使って 16 進ダンプする。 +.br +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +一文字の 'A' からなる 1 バイトのファイルを作成する。 + '\-r \-s' の後に指定した数値がファイル中の行番号に加算され、結果、余計なバ +イトが飛ばされる。 +.br +\fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR +.PP +.B vim(1) +の中から xxd をフィルタとして実行し、 +マークされた `a' から `z' までの領域を 16 進ダンプする。 +.br +\fI:'a,'z!xxd\fR +.PP +.B vim(1) +の中から xxd をフィルタとして実行し、 +マークされた `a' から `z' までの領域をバイナリに戻す。 +.br +\fI:'a,'z!xxd \-r\fR +.PP +.B vim(1) +の中から xxd をフィルタとして実行し、 +16 進ダンプされた行を元に戻す。戻したい行にカーソルを移動して: +.br +\fI!!xxd \-r\fR +.PP +シリアル行から一文字読み込む +.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 返り値 +以下のエラー値が返ります: +.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 by Juergen Weigert +.br +<jnweiger@informatik.uni\-erlangen.de> +.LP +私の功績として自由に配布してください。 +.br +儲かったら教えてください。 +.br +損しても知りません。 +.PP +マニュアルは Tony Nugent +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +によって書かれ、 +Bram Moolenaar が少し変更を加え、 +Juergen Weigert が編集しました。 +.PP diff --git a/runtime/doc/manpages/pl/evim-pl.1 b/runtime/doc/manpages/pl/evim-pl.1 new file mode 100644 index 0000000000..096a12add2 --- /dev/null +++ b/runtime/doc/manpages/pl/evim-pl.1 @@ -0,0 +1,53 @@ +.TH EVIM 1 "2002 Lut 16" +.SH NAZWA +evim \- łatwy Vim, edytuj plik w Vimie z ustawieniami dla edycji bez +trybów +.SH SYNOPSIS +.br +.B evim +[opcje] [plik ...] +.br +.B eview +.SH OPIS +.B eVim +uruchamia +.B Vima +i ustawia opcje tak by zachowywał się jak edytor bez trybów. +To jest cały czas Vim ale używany jako edytor wskaż-i-kliknij. +Zachowanie w stylu Notepada dla MS-Windows. +.B eVim +będzie zawsze uruchomiony w GUI by włączyć menu i pasek narzędzi. +.PP +Przeznaczony tylko dla ludzi, którzy naprawdę nie mogą pracować +z Vimem w normalny sposób. Edycja będzie o wiele mniej efektywna. +.PP +.B eview +działa tak samo, ale zaczyna w trybie tylko do odczytu. Działa tak +samo jak evim \-R. +.PP +Zobacz vim(1) by poznać więcej szczegółów o Vimie, opcjach, itd. +.PP +Opcja 'insertmode' jest ustawiona by można było od razu wpisywać +tekst. +.br +Mapowania są ustawione tak by Kopiowanie i Wklejanie działało +z klawiszami MS-Windows. CTRL-X wycina, CTRL-C kopiuje a CTRL-V +wkleja tekst. Użyj CTRL-Q by uzyskać oryginalne przeznaczenie +CTRL-V. +.SH OPCJE +Zobacz vim(1). +.SH PLIKI +.TP 15 +/usr/local/lib/vim/evim.vim +Skrypt uruchamiania dla eVima. +.SH ZNANY JAKO +Znany jako "Vim dla frajerów". +Jeśli używasz eVima oczekuje się, że wyjmiesz chusteczkę do nosa, +zrobisz węzęł w każdym rogu i będziesz to nosił na głowie. +.SH ZOBACZ TAKŻE +vim(1) +.SH AUTOR +Większość +.B Vima +została napisana przez Brama Moolenaara z dużą pomocą innych osób. +Zobacz menu Help/Credits. diff --git a/runtime/doc/manpages/pl/vim-pl.1 b/runtime/doc/manpages/pl/vim-pl.1 new file mode 100644 index 0000000000..f3551d2f63 --- /dev/null +++ b/runtime/doc/manpages/pl/vim-pl.1 @@ -0,0 +1,558 @@ +.TH VIM 1 "2006 kwi 11" +.SH NAME +vim \- Vi rozbudowany, edytor tekstu dla programisty +.SH SYNOPSIS +.br +.B vim +[opcje] [plik ..] +.br +.B vim +[opcje] \- +.br +.B vim +[opcje] \-t znacznik +.br +.B vim +[opcje] \-q [plik_błędu] +.PP +.br +.B ex +.br +.B view +.br +.B gvim +.B gview +.B evim +.B eview +.br +.B rvim +.B rview +.B rgvim +.B rgview +.SH OPIS +.B Vim +jest edytorem tekstu kompatybilnym z Vi. Może być +używany do edycji wszelkiego rodzaju plików tekstowych. +Użyteczny zwłaszcza przy edycji programów. +.PP +Posiada wiele usprawnień w porównaniu z Vi: wielopoziomowe cofanie zmian, +wiele okien i buforów, podświetlanie składni, edycja linii poleceń, +uzupełnianie nazw plików, pomoc on-line, wizualna selekcja, itd. +Zobacz ":help vi_diff.txt" dla podsumowania różnic pomiędzy +.B Vimem +i Vi. +.PP +W czasie korzystania z +.B Vima +można uzyskać obszerną pomoc z systemu pomocy on-line dzięki poleceniu ":help". +Zobacz rozdział POMOC ON-LINE poniżej. +.PP +Najczęściej +.B Vim +jest uruchamiany do edycji pojedynczego pliku poleceniem +.PP + vim plik +.PP +Bardziej ogólnie +.B Vim +jest uruchamiany poprzez: +.PP + vim [opcje] [lista plików] +.PP +Jeśli brak listy plików edytor rozpocznie z pustym buforem. W innym +wypadku istnieje dokładnie jedna z czterech możliwości by wybrać jeden +lub więcej plików do edycji. +.TP 12 +plik .. +Lista nazw plików. +Pierwsza nazwa będzie nazwą bieżącego pliku, który zostanie wczytany +do bufora. Kursor zostanie umieszczony w pierwszym wierszu. Do +kolejnych plików można przejść dzięki poleceniu ":next". By otworzyć +plik, którego nazwa zaczyna się od myślnika należy listę plików +poprzedzić "\-\-". +.TP +\- +Plik do edycji jest wczytany ze standardowego wejścia. Polecenia są +odczytywane ze standardowego wyjścia błędów, którym powinien być +terminal (tty). +.TP +\-t {znacznik} +Plik do edycji i początkowa pozycja kursora zależy od "znacznika", +rodzaju etykiety goto. +{znacznika} szuka się w pliku tags, związany z nim plik staje się +plikiem bieżącym i wykonuje się powiązane polecenie. +Zazwyczaj używa się tego sposobu dla programów w C, w których wypadku +{znacznik} może być nazwą funkcji. +W efekcie plik zawierający określoną funkcję staje się plikiem +bieżącym a kursor jest umieszczony na początku funkcji. +Zobacz ":help tag-commands". +.TP +\-q [plik_błędów] +Zacznij w trybie quickFix. +Plik [plik_błędów] zostaje zinterpretowany i pokaże się pierwszy błąd. +Jeśli brak opcji [plik_błędów] nazwa pliku zostanie pobrana z opcji +\&'errorfile' (domyślnie "AztecC.Err" dla Amigi, "errros.err" dla innych +systemów. +Do kolejnych błędów można przeskoczyć dzięki poleceniu ":cn". +Zobacz ":help quickfix". +.PP +W zależności od wywołania +.B Vim +zachowuje się inaczej (program może być cały czas tym samym +plikiem). +.TP 10 +vim +"Normalny" sposób, wszystko jest domyślne. +.TP +ex +Zacznij w trybie Ex. +Przejdź do trybu Normalnego poleceniem ":vi". +Można także uruchomić poprzez argument "\-e". +.TP +view +Zacznij w trybie tylko do odczytu. W ten sposób będziesz chroniony +przed zapisywaniem pliku. Można także uruchomić poprzez argument +"\-R". +.TP +gvim gview +Wersja GUI. +Uruchamia nowe okno. +Można także uruchomić poprzez argument "\-g". +.TP +evim eview +Wersja GUI w łatwym trybie. +Uruchamia nowe okno. +Można także uruchomić poprzez argument "\-y". +.TP +rvim rview rgvim rgview +Podobnie jak powyżej, ale z ograniczeniami. Nie będzie można uruchomić +poleceń powłoki lub zawiesić +.B Vima. +Można także uruchomić poprzez argument "\-Z". +.SH OPCJE +Opcje można podać w dowolnej kolejności, przed lub po nazwach plików. +Opcje bez argumentów można łączyć po pojedynczym myślniku. +.TP 12 ++[num] +W pierwszym pliku kursor zostanie umieszczony w wierszu "num". +Jeśli brak "num" kursor zostanie umieszczony w ostatnim wierszu. +.TP ++/{wzór} +W pierwszym pliku kursor zostanie umieszczony na pierwszym wystąpieniu +{wzór}. +Zobacz ":help search-pattern" by dowiedzieć się jakie są możliwe +wzorce wyszukiwania. +.TP ++{polecenie} +.TP +\-c {polecenie} +{polecenie} zostanie wykonane po tym jak wczyta się pierwszy plik. +{polecenie} jest interpretowane jako polecenie Ex. +Jeśli {poleceni} zawiera białe znaki musi być umieszczone w podwójnych +cudzysłowach (zależy to od używanej powłoki). +Przykład: Vim "+set si" main.c +.br +Uwaga: Można użyć do 10 poleceń "+" lub "\-c". +.TP +\-S {plik} +{plik} zostanie zinterpretowany po wczytaniu pierwszego pliku. +Jest równoważne \-c "source {plik}". +{plik} nie może zaczynać się '\-'. +Jeśli nie podano {plik} zostanie użyty "Session.vim" (działa tylko +wtedy jeśli \-S jest ostatnim argumentem). +.TP +\-\-cmd {polecenie} +Podobne do "\-c", ale polecenie jest wykonywane tuż przed +interpretacją jakiegokolwiek pliku vimrc. +Można użyć do 10 takich poleceń, niezależnie od poleceń od "\-c" +.TP +\-A +Jeśli +.B Vim +został skompilowany ze wsparciem dla języków arabskich (edycja od +prawej do lewej i arabska mapa klawiatury) ta opcja uruchamia +.B Vima +w trybie arabskim, np. ustawia się opcja 'arabic'. W innym wypadku +pojawi się komunikat błędu i +.B Vim +zakończy działanie. +.TP +\-b +Tryb binarny. +Ustawi się kilka opcji, które umożliwią edycję plików binarnych lub +wykonywalnych. +.TP +\-C +Kompatybilny. Ustawia opcję 'compatible'. +W ten sposób +.B Vim +będzie zachowywał się jak Vi, nawet jeśli istnieje plik .vimrc. +.TP +\-d +Uruchom w trybie diff. +Powinno się użyć dwóch, trzech lub czterech nazwy plików jako argumentów. +.B Vim +otworzy wszystkie te pliki i pokaże różnice między nimi. +Działa jak vimdiff(1). +.TP +\-d {urządzenie} +Otwórz {urządzenie} by używać jako terminal. +Tylko na Amidze. +Przykład: +"\-d con:20/30/600/150". +.TP +\-D +Debugowanie. Przejdź do trybu debugowanie wykonując pierwsze polecenie +ze skryptu. +.TP +\-e +Uruchom +.B Vima +w trybie Ex, działa tak samo jakby wywołano program jako "ex". +.TP +\-E +Uruchom +.B Vima +w ulepszonym trybie Ex, działa tak samo jakby wywołano program jako +"exim". +.TP +\-f +Pierszy plan. Dla wersji GUI. +.B Vim +nie nie oddzieli się od powłoki w jakiej został uruchomiony. Na Amidze +.B Vim +nie jest uruchomiony ponownie by otworzyć nowe okno. +Opcja powinna być użyta kiedy +.B Vim +jest wywoływany przez program, który ma zaczekać na koniec sesji (np. +mail). +Na Amidze polecenia ":sh" i ":!" nie będą działać. +.TP +\-\-nofork +Pierwszy plan. Dla wersji GUI. +.B Vim +nie oddzieli się od powłoki w jakiej został uruchomiony. +.TP +\-F +Jeśli Vim został skompilowany ze wsparciem FKMAP dla edycji tekstów od +prawej do lewej i mapowania klawiatury Farsi, ta opcja uruchomi +.B Vima +w trybie Farsi, np. zostawią ustawione opcje 'fkmap' i 'rightleft'. +W innym wypadku pojawi się komunikat błędu i +.B Vim +zakończy działanie. +.TP +\-g +Jeśli +.B Vim +został skompilowany ze wsparciem dla GUI ta opcja uruchomi GUI. +W innym wypadku pojawi się komunikat błędu i +.B Vim +zakończy działanie. +.TP +\-h +Wyświetli krótką pomoc o argumentach linii poleceń i opcjach. Potem +.B Vim +zakończy działanie. +.TP +\-H +Jeśli +.B Vim +został skompilowany ze wsparciem RIGHTLEFT dla edycji od prawej do +lewej oraz ma mapowanie klawiatury dla hebrajskiego, ta opcja uruchomi +.B Vima +w trybie hebrajskim, np. ustawi opcje 'hkmap' i 'rightleft'. +W innym wypadku pojawi się komunikat błędu i +.B Vim +zakończy działanie. +.TP +\-i {viminfo} +Kiedy +.B Vim +używa pliku viminfo ta opcja wskaże jakiego pliku użyć zamiast +domyślnego "~/.viminfo". +Można też ominąć użycie pliku .viminfo przez podanie nazwy "NONE". +.TP +\-L +To samo co \-r. +.TP +\-l +Tryb Lisp. +Ustawia opcje 'lisp' i 'showmatch'. +.TP +\-m +Zmiana pliku jest niemożliwa. +Przestawia opcję 'write'. +Można zmieniać zawartość bufora, ale zapisanie pliku nie jest +możliwe. +.TP +\-M +Opcje 'modifiable' i 'write' zostaną wyłączone, tak więc zmiany +w pliku oraz ich zapisanie nie są możliwe. Wartość tych opcji można +zmienić. +.TP +\-N +Tryb niekompatybilny. Przestawia opcję 'compatible'. Dzięki temu +.B Vim +będzie zachowywał się odrobinę lepiej, ale mniej zgodnie z Vi nawet +jeśli nie istnieje plik .vimrc. +.TP +\-n +Nie powstanie plik wymiany. Odzyskanie pliku po wypadku nie będzie +możliwe. +Wygodne jeśli instnieje potrzeba edycji na bardzo wolnym medium (np. +dyskietce). Ten cel można osiągnąć także przez ":set uc=0". Można +odwrócić przez ":set uc=200". +.TP +\-nb +Uruchom jako serwer edytora dla NetBeans. Zobacz dokumentację by +dowiedzieć się więcej. +.TP +\-o[N] +Otwórz N okien w stosie. +Kiedy brak N, otwórz jedno okno dla każdego pliku. +.TP +\-O[N] +Otwórz N okien obok siebie. +Kiedy brak N, otwórz jedno okno dla każdego pliku. +.TP +\-p[N] +Otwórz N kart. +Kiedy brak N, otwórz jedną kartę dla każdego pliku. +.TP +\-R +Tryb tylko do odczytu. +Zostanie ustawiona opcja 'readonly'. +Cały czas można zmieniać bufor, ale będzie istniała blokada by chronić +przed przypadkowym zapisaniem pliku. +Jeśli chcesz zapisać plik dodaj wykrzyknik do polecenia Ex, np. ":w!". +Opcja \-R implikuje opcję \-n (zobacz poniżej). +Opcja 'readonly' może zostać przestawiona poprzez ":set noro". +Zobacz ":help 'readonly'". +.TP +\-r +Wypisz listę plików wymiany razem z informacjami o nich. +.TP +\-r {plik} +Tryb odzyskiwania danych. +Plik wymiany zostanie wykorzystany do odzyskania gwałtownie przerwanej sesji. +Plik wymiany to plik z taką samą nazwą co plik oryginalny z dodanym ".swp". +Zobacz ":help recovery". +.TP +\-s +Tryb cichy. Rozpoczęty tylko kiedy uruchomiony jako "Ex" lub opcja +"\-e" została podana przed opcją "\-s". +.TP +\-s {skrypt} +Zostanie wczytany plik {skrypt}. +Znaki w pliku zostaną zinterpretowane jakby były wpisywane. +To samo można osiągnąć poprzez polecenie ":source! {skrypt}". +Jeśli osiągnięto koniec pliku zanim edytor zakończył działanie, dalsze +znaki odczytywane są z klawiatury. +.TP +\-T {terminal} +Przekazuje +.B Vimowi +nazwę terminalu jakiego używasz. +Wymagane tylko wtedy jeśli nie działa automatycznie. +Powinien być to terminal znany +.B Vimowi +(builtin) lub zdefiniowany w plikach termcap lub terminfo. +.TP +\-u {vimrc} +Użyj poleceń z pliku {vimrc} w czasie uruchamiania. +Wszystkie inne możliwe pliki uruchamiania zostaną pominięte. +Używaj do edytowania plików specjalnych. +Można pominąć także wszystkie możliwe pliki uruchamiania poprzez +podanie nazwy "NONE". +Zobacz ":help initialization" by poznać więcej szczegółów. +.TP +\-U {gvimrc} +Użyj poleceń z pliku {gvimrc} w czasie uruchamiania GUI. +Wszystkie inne możliwe pliki uruchamiania GUI zostaną pominięte. +Można pominąć także wszystkie możliwe pliki uruchamiania GUI poprzez +podanie nazwy "NONE". +Zobacz ":help gui-init" by poznać więcej szczegółów. +.TP +\-V[N] +Tryb gadatliwy. Wypisz wiadomości o tym jaki pliki są wczytywane +i o informacjach pobieranych i dodawanych do pliku viminfo. Opcjonalny +argument N jest wartością 'verbose'. Domyślnie 10. +.TP +\-v +Uruchom +.B Vima +w trybie Vi, tak jakby program był nazwany "vi". Ma znaczenie +tylko wtedy jeśli program nazwany jest "ex". +.TP +\-w {plik} +Wszystkie wciśnięcia klawiszy, aż do zakończenia działania programu, +są zapisywane w {plik} . +Użyteczne jeśli chce się stworzyć skrypt do użycia z "vim \-s" lub +":source!". +Jeśli {plik} istnieje, znaki są dopisywane. +.TP +\-W {plik} +Podobnie do \-w, ale istniejący plik jest nadpisywany. +.TP +\-x +Użyj szyfrowania podczas zapisywania plików. Zostaniesz poproszony +o podanie klucza. +.TP +\-X +Nie łącz z serwerem X. Skraca czas uruchamiania w terminalu, ale tytuł +okna i schowek nie będą wykorzystywane. +.TP +\-y +Uruchom +.B Vima +w łatwym trybie, tak jakby program został wywołany "evim" lub "eview". +.B Vim +będzie zachowywał się bardziej jak edytor kliknij-i-wpisz. +.TP +\-Z +Tryb ograniczony. Zachowuje się jakby nazwa programu zaczynała się od +"r". +.TP +\-\- +Oznacza koniec opcji. +Argumenty po tej opcji będą traktowane jak nazwy plików. Używa się do +otwierania plików, których nazwy zaczynają się od '\-'. +.TP +\-\-echo\-wid +Wyłącznie GTK GUI: wypisz ID okna na standardowe wyjście. +.TP +\-\-help +Wyświetl informację o pomocy i zakończy, to samo co"\-h". +.TP +\-\-literal +Potraktuj nazwy plików dosłownie i nie rozwiązuj kwantyfikatorów. Nie +ma znaczenia na Uniksach gdzie powłoka rozwiązuje kwantyfikatory. +.TP +\-\-noplugin +Pomiń ładowanie wtyczek. Implikowane przy \-u NONE. +.TP +\-\-remote +Połącz się z serwerem Vima i edytuj w nim resztę plików podanych jako +argumenty. Jeśli nie znaleziono serwera zostanie zgłoszony błąd a pliki zostaną +otwarte w bieżącym Vimie. +.TP +\-\-remote\-expr {wyrażenie} +Połącz z serwerem Vima, rozwiąż w nim {wyrażenie} i wypisz rozwiązanie +na standardowe wyjście. +.TP +\-\-remote\-send {klawisze} +Połącz z serwerem Vima i wyślij do niego {klawisze}. +.TP +\-\-remote\-silent +Tak samo jak \-remote, ale bez ostrzeżenia kiedy nie znaleziono +serwera. +.TP +\-\-remote\-wait +Tak samo jak \-remote, ale Vim nie zakończy dopóki pliki pozostaną +otwarte. +.TP +\-\-remote\-wait\-silent +Tak samo jak \-\-remote\-wait, ale bez ostrzeżenie kiedy nie +znaleziono serwera. +.TP +\-\-serverlist +Wypisz nazwy wszystkich serwerów Vima jakie można znaleźć. +.TP +\-\-servername {nazwa} +Użyj {nazwa} jako nazwy serwera. Wykorzystane dla bieżącego Vima o ile +nie połączone z argumentem \-\-remote, wtedy jest to nazwa serwera do +połączenia. +.TP +\-\-socketid {id} +Wyłącznie GTK GUI: Użyj mechanizmu GtkPlug by uruchomić gvima w innym +oknie. +.TP +\-\-version +Wypisz informację o wersji i zakończ. +.SH POMOC ON-LINE +By rozpocząć wpisz ":help" w +.B Vimie +Wpisz ":help temat" by uzyskać pomoc na określony temat. +Przykład: ":help ZZ" by uzyskać pomoc na temat polecenia "ZZ". +Użyj <Tab> i CTRL\-D aby uzupełnić tematy (":help +cmdline\-completion"). W plikach pomocy istnieją znaczniki by ułatwić +skakanie z jednego miejsca do innego (rodzaj linków hipertekstowych, +zobacz ":help"). +Można w ten sposób zobaczyć całą dokumentację, np. ":help syntax.txt". +.SH PLIKI +.TP 15 +/usr/local/lib/vim/doc/*.txt +Dokumentacja +.B Vima +Użyj ":help doc\-file\-list" aby uzyskać pełną listę. +.TP +/usr/local/lib/vim/doc/tags +Plik znaczników służy do znajdowania informacji w plikach dokumentacji. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Globalne uruchamianie podświetlania składni. +.TP +/usr/local/lib/vim/syntax/*.vim +Pliki składni dla różnych języków. +.TP +/usr/local/lib/vim/vimrc +Globalny plik uruchamiania +.B Vima +.TP +~/.vimrc +Osobiste parametry uruchamiania +.B Vima +.TP +/usr/local/lib/vim/gvimrc +Globalne uruchamianie gvima. +.TP +~/.gvimrc +Osobiste parametry uruchamiania gvima. +.TP +/usr/local/lib/vim/optwin.vim +Skrypt używany w poleceniu ":options", dobry sposób do przeglądania +i ustawiania opcji. +.TP +/usr/local/lib/vim/menu.vim +Globalne uruchamianie menu gvima. +.TP +/usr/local/lib/vim/bugreport.vim +Skrypt służący do tworzenia raportów o błędach. Zobacz ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Skrypt do wykrywania typu pliku według jego nazwy. Zobacz ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Skrypt do wykrywania typu pliku według jego zawartości. Zobacz ":help 'filetype'". +.TP +/usr/local/lib/vim/print/*.ps +Pliku używane do drukowania PostScriptu. +.PP +Najświeższe wiadomości na stronie +.B Vima: +.br +<URL:http://www.vim.org/> +.SH ZOBACZ TAKŻE +vimtutor(1) +.SH AUTOR +.B Vim +został napisany przez Brama Moolenaara z dużą pomocą innych osób. +Zobacz ":help credits" w +.B Vimie. +.br +.B Vim +bazuje na Steviem, nad którym pracowali: Tim Thompson, Tony Andrews +i G.R. (Fred) Walter. +Mało już zostało z oryginalnego kodu. +.SH BŁĘDY +Prawdopodobne. +Zobacz ":help todo" by poznać listę znanych problemów. +.PP +Pamiętaj że pewna ilość problemów, które mogą być uznawane przez +niektórych ludzi za błędy są w rzeczywistości spowodowane wiernością +w odtwarzaniu zachowania Vi. +Jeśli sądzisz, że inne rzeczy są błędami "ponieważ Vi robi to +inaczej", powinieneś przyjrzeć się bliżej plikowi vi_diff.txt (lub +wpisać ":help vi_diff.txt" w Vimie). +Sprawdź także opis opcji 'compatible' i 'cpoptions'. diff --git a/runtime/doc/manpages/pl/vimdiff-pl.1 b/runtime/doc/manpages/pl/vimdiff-pl.1 new file mode 100644 index 0000000000..d66fdc9c03 --- /dev/null +++ b/runtime/doc/manpages/pl/vimdiff-pl.1 @@ -0,0 +1,46 @@ +.TH VIMDIFF 1 "2001 Mar 30" +.SH NAZWA +vimdiff \- edytuj dwie, trzy lub cztery wersje pliku w Vimie i zobacz różnice +.SH SYNOPSIS +.br +.B vimdiff +[opcje] plik1 plik2 [plik3 [plik4]] +.PP +.B gvimdiff +.SH OPIS +.B Vimdiff +uruchomi +.B Vima +z dwoma (trzema lub czterema plikami), każdy z nich we własnym oknie. +Różnice między plikami zostaną podświetlone. +Jest to dobry sposób by przeanalizować różnice i przenieść zmiany z jednej +wersji pliku do innej. +.PP +Zobacz vim(1) by poznać więcej szczegółów o samym Vimie. +.PP +Kiedy uruchomiony jako +.B gvimdiff +zostanie uruchomione GUI (jeśli dostępne). +.PP +W każdym oknie zostanie ustawiona opcja 'diff', która spowoduje +podświetlenie różnic. +.br +Opcje 'wrap' i 'scrollbind' zostaną ustawione by tekst się +wygodnie przeglądało. +.br +Opcja 'foldmethod' zostanie ustawiona na "diff", dzięki czemu +niezmienione linie zostaną zwinięte. 'foldcolumn' będzie równe 2 aby +łatwo wyszukiwać, otwierać i zamykać zwinięcia. +.SH OPCJE +Pionowy podział zostanie użyty do wyrównania linii, tak jakby użyto +opcji "\-O". Aby uzyskać poziomy podział użyj opcji "\-o". +.PP +Aby poznać inne opcje zobacz vim(1). +.SH ZOBACZ TAKŻE +vim(1) +.SH AUTOR +Większość +.B Vima +została napisana przez Brama Moolenaara przy pomocy wielu innych osób. +Zobacz ":help credits w +.B Vimie. diff --git a/runtime/doc/manpages/pl/vimtutor-pl.1 b/runtime/doc/manpages/pl/vimtutor-pl.1 new file mode 100644 index 0000000000..199fcd0e8f --- /dev/null +++ b/runtime/doc/manpages/pl/vimtutor-pl.1 @@ -0,0 +1,51 @@ +.TH VIMTUTOR 1 "2001 Kwi 2" +.SH NAZWA +vimtutor \- nauczyciel Vima +.SH SYNOPSIS +.br +.B vimtutor -g [język] +.SH OPIS +.B Vimtutor +uruchamia nauczyciela +.B Vima. +Najpierw kopiuje właściwy plik, dzięki temu można go zmieniać bez obaw +utraty treści. +.PP +.B Vimtutor +przyda się ludziom, którzy chcą się nauczyć pierwszych poleceń +.B Vima +.PP +Opcjonalny argument \-g uruchamia vimtutor w gvimie a nie w Vimie jeśli +graficzna wersja Vima jest dostępna, jeśli nie zostanie uruchomiony Vim. +.PP +Opcjonalny argument [język] jest dwu literowym kodem języka, tak jak +"it" lub "es". +Jeśli brak argumentu [język] zostanie użyty język bieżącej +lokalizacji. +Jeśli nauczyciel w tym języku jest dostępny, zostanie użyty \- w innym +wypadku zostanie wykorzystana wersja angielska. +.PP +.B Vim +jest uruchamiany zawsze w trybie kompatybilności z Vi +.SH PLIKI +.TP 15 +/usr/local/lib/vim/tutor/tutor[.język] +Tekstowe pliki +.B Vimtutora. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Skrypt Vima używany do kopiowania pliku +.B Vimtutora. +.SH AUTOR +.B Vimtutor +został początkowo napisany dla Vi przez Michaela C. Pierce'a +i Roberta K. Ware'a z Colorado School of Mines zainspirowani przez +Charlesa Smitha z Colorado State University. +E-mail: bware@mines.colorado.edu +.br +Zmodyfikowany na potrzeby +.B Vima +przez Brama Moolenaara. +Nazwiska tłumaczy w plikach. +.SH ZOBACZ TAKŻE +vim(1) diff --git a/runtime/doc/manpages/pl/xxd-pl.1 b/runtime/doc/manpages/pl/xxd-pl.1 new file mode 100644 index 0000000000..e63ce64b74 --- /dev/null +++ b/runtime/doc/manpages/pl/xxd-pl.1 @@ -0,0 +1,389 @@ +.TH XXD 1 "Sierpień 1996" "Strona podręcznika dla xxd" +.\" +.\" 21st May 1996 +.\" Man page author: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Changes by Bram Moolenaar <Bram@vim.org> +.SH NAZWA +.I xxd +\- zrzut pliku do hex lub odwrotnie +.SH SYNOPSIS +.B xxd +\-h[elp] +.br +.B xxd +[opcje] [plik_we [plik_wy]] +.br +.B xxd +\-r[evert] [opcje] [plik_we [plik_wy]] +.SH OPIS +.I xxd +tworzy zrzut heksowy podanego pliku lub standardowego wejścia. +Może także przetworzyć zrzut heksowy z powrotem do oryginalnej, +binarnej formy. +Podobnie jak +.BR uuencode (1) +i +.BR uudecode (1) +pozwala na przekazanie danych binarnych w bezpiecznej w poczcie formie +ASCII, ale ma zalety dekodowania na standardowe wyjście. +Ponadto można go użyć do binarnego łatania plików. +.SH OPCJE +Jeśli nie podano +.I plik_we +xxd czyta ze standardowego wejścia. +Jeśli określono +.I plik_we +jako znak +.RB \` \- ' +wtedy dane wejściowe czytane są ze standardowego wejścia. +Jeśli nie podano +.I plik_wy +(lub podano jako +.RB \` \- ' +), wyniki są wysyłane na standardowe wyjście. +.PP +Pamiętaj, że użyty został "leniwy" parser, który nie sprawdza więcej +niż pierwszej litery opcji (o ile ta nie została obdarzona +parametrem). Spacje między jedno literowymi opcjami i ich parametrami +są opcjonalne. Parametry opcji mogą być określone w notacji dziesiętnej, +heksadecymalej lub oktalnej. +Stąd +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +i +.B \-cols 8 +są sobie równoważne. +.PP +.TP +.IR \-a " | " \-autoskip +przełącza autoskip: pojedyncza '*' zastępuje linie nul. Domyślnie +wyłączone. +.TP +.IR \-b " | " \-bits +Przełącza do zrzutu bitowego (cyfr binarnych) zamiast heksowego. +Opcja ta zapisuje oktety jako osiem cyfr 1 lub 0 zamiast normalnego +zrzutu heksowego. Każda linia jest poprzedzona przez +heksadecymalny numer linii a po nim jego reprezentacją w ascii (lub +ebcdic). Opcje linii poleceń \-r, \-p, \-i nie działają w tym +trybie. +.TP +.IR "\-c cols " | " \-cols cols" +formatuje liczbę +.RI < cols > +oktetów na wiersz. Domyślnie 16 (\-i: 12, \-ps: 30, \-b: 6). Maks. +256. +.TP +.IR \-E " | "\-EBCDIC +zmienia kodowanie znaków w prawej kolumnie z ASCII na EBCDIC. +Nie zmienia prezentacji heksadecymalej. Opcja nie działa w połączeniu +z \-r, \-p lub \-i. +.TP +.IR "\-g bajtów " | " \-groupsize bajtów" +oddziela wyjście każdych +.RI < bajtów > +bajtów (dwa heksowe znaki lub osiem cyfr binarnych każde) przez biały +znak. +Określ +.I \-g 0 +by wyłączyć grupowanie. +.RI < Bajtów "> domyślnie jest " 2 +w trybie normalnym i \fI1\fP w trybie bitów. +Grupowanie nie działa w trybie postscriptu lub włączania. +.TP +.IR \-h " | " \-help +wypisuje podsumowanie dostępnych poleceń i kończy działanie. Nie +zostaje przeprowadzony żaden zrzut. +.TP +.IR \-i " | " \-include +wyjście w stylu włączania pliku w C. Zostaje zapisana kompletna +statyczna tablica definicji (nazwana według pliku wejścia), o ile xxd +nie czyta ze standardowego wejścia. +.TP +.IR "\-l len " | "\-len len" +zakończ po wypisaniu +.RI < len > +oktetów. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +wyjście w postcriptowym ciągłym stylu zrzutu heksowego. Znany także +jako zwykły zrzut heksowy. +.TP +.IR \-r " | " \-revert +odwróć operację: przekonwertuj (lub załataj) zrzut heksowy w binarkę. +Jeśli nie zapisuje na standardowe wyjście, xxd zapisze plik wyjściowy +bez obcinania go. Użyj kombinacji +.I \-r \-p +by odczytać zwykły zrzut heksadecymalny bez numerów linii +i określonego układu kolumn. Dodatkowe białe znaki i łamanie wierszy +są wszędzie dozwolone. +.TP +.I \-seek offset +Kiedy użyty po +.IR \-r : +odwraca z +.RI < offset > +dodanym do pozycji w pliku odnalezionym w zrzucie heksowym. +.TP +.I \-s [+][\-]seek +zaczyna na +.RI < seek > +bajtów bezwględnego (lub względnego) offsetu pliku wejściowego. +\fI+ \fRwskazuje, że seek jest względne do bieżącej pozycji pliku (bez +znaczenia jeśli nie wczytuje ze standardowego wejścia). \fI\- \fRwskazuje +że seek powinno być o tyle znaków od końca wejścia (lub jeśli +połączone z \fI+\fR: przed bieżącą pozycją pliku na standardowym +wejściu). +Bez opcji \-s xxd zaczyna od bieżącej pozycji w pliku. +.TP +.I \-u +użyj wielkich liter w znakach heksowych. Domyślnie są małe znaki. +.TP +.IR \-v " | " \-version +pokazuje wersję programu. +.SH OSTRZEŻENIA +.PP +.I xxd \-r +potrafi określić numery linii. Jeśli plik wyjścia jest możliwy do +przeszukania wtedy numery linii na początku wiersza zrzutu heksowego +mogą być nie po kolei, może brakować wierszy lub nakładać się na +siebie. W takich wypadkach xxd użyje lseek(2) by znaleźć następną +pozycję. Jeśli plik wyjściowy nie jest możliwy do przeszukania możliwe +są tylko przerwy, które zostaną wypełnione bajtami null. +.PP +.I xxd \-r +nigdy nie podaje błędów analizy. Śmieci są po cichu ignorowane. +.PP +W czasie edycji zrzutów heksowych, proszę zauważyć że +.I xxd \-r +pomija wszystko w linii wejścia po odczytaniu wystarczającej ilości +kolumn danych heksadecymalnych (zobacz opcję \-c). Oznacza to także, +że zmiany w drukowanych kolumnach ascii (lub ebcdic) są zawsze +ignorowane. Odwrócenie zwykłego (lub postscriptowego) stylu zrzutu +poprzez xxd \-r \-p nie zależy od kolejności kolumn. Tutaj cokolwiek +co wygląda jak para znaków heks jest interpretowane. +.PP +Zauważ różnicę między +.br +\fI% xxd \-i plik\fR +.br +i +.br +\fI% xxd \-i < plik\fR +.PP +.I xxd \-s \+seek +może być różne od +.IR "xxd \-s seek" , +ponieważ lseek(2) jest użyty do "przewinięcie" wejścia. '+' stanowi +różnicę jeśli źródłem wejścia jest standardowe wejście i jeśli pozycja +w pliku ze standardowego wejścia nie jest początkiem pliku w chwili +uruchomienia xxd. Następujące przykłady mogą wyjaśnić (lub bardziej +zmylić!)... +.PP +Przewiń standardowe wejście przed przeczytaniem; potrzebne ponieważ +`cat' już odczytał do końca standardowego wejścia. +.br +\fI% sh \-c 'cat > zwykła_kopia; xxd \-s 0 > hex_kopia' < plik\fR +.PP +Zrzut heksowy od pozycji pliku 0x480 (=1024+128) w przód. +Znak `+' oznacza "względny wobec bieżącej pozycji", stąd `128' dodaje +do 1k gdzie zakończył dd. +.br +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file\fR +.PP +Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej. +.br +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file\fR +.PP +Jakkolwiek, jest to rzadka sytuacja i użycie `+' jest rzadko +potrzebne. +Autor woli monitorować działanie xxd przy pomocy strace(1) lub truss(1) kiedy \-s jest użyte. +.SH PRZYKŁADY +.PP +.br +Wypisz wszystko z wyjątkiem pierwszych trzech linii (heksowe 0x30 bajtów) +.B pliku +\. +.br +\fI% xxd \-s 0x30 plik\fR +.PP +.br +Wypisz trzy linie (heksowe 0x30 bajtów) z końca +.B pliku +\. +.br +\fI% xxd \-s \-0x30 plik\fR +.PP +.br +Wypisz 120 bajtów jako ciągły zrzut heksowy z 20 oktetami na linię. +.br +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e54482058584420312022417567757374203139 +.br +39362220224d616e75616c207061676520666f72 +.br +20787864220a2e5c220a2e5c222032317374204d +.br +617920313939360a2e5c22204d616e2070616765 +.br +20617574686f723a0a2e5c2220202020546f6e79 +.br +204e7567656e74203c746f6e79407363746e7567 +.br + +.br +Zrzut heksowy z pierwszymi 120 bajtami tej strony podręcznika z 12 +oktetami na linię. +.br +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +.br +000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +.br +0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +.br +0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\ +.br +0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M +.br +000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\" +.br +0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +.br +0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\" +.br +0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +.br +000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +.PP +.br +Pokaż tylko datę z pliku xxd.1 +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +.PP +.br +Kopiuj +.B plik_we +do +.B plik_wy +i poprzedź 100 bajtami o wartości 0x00. +.br +\fI% xxd plik_we | xxd \-r \-s 100 \> plik_wy\fR +.br + +.br +Podmień datę w pliku xxd.1 +.br +\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +.PP +.br +Utwórz plik o 65537 bajtach, wszystkich równych 0x00, +z wyjątkiem ostatniego, który ma być 'A' (hex 0x41). +.br +\fI% echo '010000: 41' | xxd \-r \> plik\fR +.PP +.br +Zrzut heksowy tego pliku z autoskipem. +.br +\fI% xxd \-a \-c 12 plik\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Utwórz jedno bajtowy plik zawierający pojednczą literę 'A'. +Liczba po '\-r \-s' dodaje numery linii znalezione w pliku; +w efekcie poprzedzające bajty są ukryte. +.br +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR +.PP +Użyj xxd jako filtra wewnątrz edytora takiego jak +.B vim(1) +aby uzyskać zrzut heksowy zakresu między markerami `a' i `z'. +.br +\fI:'a,'z!xxd\fR +.PP +Użyj xxd jako filtra wewnątrz edytora takiego jak +.B vim(1) +by odzyskać binarny zrzut heksowy zakresu pomiędzy markerami `a' +i `z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +Użyj xxd jako filtra wewnątrz edytora takiego jak +.B vim(1) +by odzyskać jedną linię zrzutu heksowego. Przejdź z kursorem na linię +i wpisz: +.br +\fI!!xxd \-r\fR +.PP +Odczytaj pojednycze znaki z portu szeregowego +.br +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.PP +.SH "ZWRACANE WARTOŚCI" +Zwracane są następujące wartości błędów: +.TP +0 +nie znaleziono błędów. +.TP +\-1 +operacja nie jest wspierana ( +.I xxd \-r \-i +cały czas niemożliwa). +.TP +1 +błąd w czasie analizowania opcji. +.TP +2 +problemy z plikiem wejściowym. +.TP +3 +problemy z plikiem wyjściowym. +.TP +4,5 +żądana pozycja jest nieosiągalna. +.SH "ZOBACZ TAKŻE" +uuencode(1), uudecode(1), patch(1) +.br +.SH OSTRZEŻENIA +Dziwaczność narzędzi dorównuje dziwaczności mózgu twórcy. +Używaj wyłącznie na własną odpowiedzialność. Kopiuj pliki. Analizuj +je. Stań się czarodziejem. +.br +.SH WERSJA +Strona podręcznika opisuje xxd w wersji 1.7 +.SH AUTOR +.br +(c) 1990-1997 by Juergen Weigert +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Kopiuj do woli i podaj moje dane, +.br +zarabiaj pieniądze i dziel się ze mną, +.br +trać pieniądze i nie miej do mnie pretensji. +.PP +Strona podręcznika zapoczątkowana przez Tony'ego Nugenta +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Małe zmiany: Bram Moolenaar. +Redakcja: Juergen Weigert. +.PP diff --git a/runtime/doc/manpages/ru/evim-ru.1 b/runtime/doc/manpages/ru/evim-ru.1 new file mode 100644 index 0000000000..581c364c22 --- /dev/null +++ b/runtime/doc/manpages/ru/evim-ru.1 @@ -0,0 +1,59 @@ +.TH EVIM 1 "2002 February 16" +.SH ИМЯ +evim \- простой Vim, позволяет редактировать файл с помощью Vim в безрежимном режиме +.SH КОМАНДНАЯ СТРОКА +.br +.B evim +[ключи] [файл ..] +.br +.B eview +.SH ОПИСАНИЕ +Команда +.B evim +запускает +.B Vim +и настраивает ряд опций таким образом, что он начинает вести себя +как обычный безрежимный редактор. В этом режиме Vim напоминает +Notepad из MS-Windows. +.B eVim +всегда запускается с поддержкой графического интерфейса, чтобы обеспечить +использование меню и инструментальной панели. +.PP +Эта команда создана для тех, кто по каким-то причинам не в состоянии +работать с Vim в обычном режиме. Редактирование файлов при этом происходит +гораздо менее эффективно, чем при использовании обычного Vim. +.PP +Команда +.B eview +выполняет почти ту же самую задачу, но файл открывается в режиме "только +для чтения". Использование этой команды полностью идентично использованию +evim \-R. +.PP +Подробнее о Vim, ключах запуска и т.п. смотрите на странице справочника +vim(1). +.PP +При использовании +.B evim +включается опция 'insertmode', что позволяет вводить текст напрямую. +.br +Кроме того, настраиваются привязки, позволяющие использовать кнопки MS-Windows +для выполнения команд копирования и вклейки. CTRL-X используется для вырезания +текста, CTRL-C для копирования и CTRL-V для вклейки. Чтобы воспользоваться +изначальным значением кнопки CTRL-V, используйте CTRL-Q. +.SH ПАРАМЕТРЫ ЗАПУСКА +См. vim(1). +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/evim.vim +Сценарий, который загружается для инициализации eVim. +.SH AKA +eVim также известен как "Vim для чайников". +Для наилучшего эффекта рекомендуется во время использования повязать +на голове платок, предварительно завязав на каждом конце по узелку. +.SH СМОТРИ ТАКЖЕ +vim(1) +.SH АВТОРЫ +Большая часть +.B Vim +создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное +количество людей. См. меню Справка/Благодарности. diff --git a/runtime/doc/manpages/ru/vim-ru.1 b/runtime/doc/manpages/ru/vim-ru.1 new file mode 100644 index 0000000000..ef527213e3 --- /dev/null +++ b/runtime/doc/manpages/ru/vim-ru.1 @@ -0,0 +1,489 @@ +.TH VIM 1 "2002 Feb 22" +.SH ИМЯ +vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов +.SH КОМАНДНАЯ СТРОКА +.br +.B vim +[ключи] [файл ..] +.br +.B vim +[ключи] \- +.br +.B vim +[ключи] \-t метка +.br +.B vim +[ключи] \-q [файл ошибок] +.PP +.br +.B ex +.br +.B view +.br +.B gvim +.B gview +.br +.B rvim +.B rview +.B rgvim +.B rgview +.SH ОПИСАНИЕ +.B Vim +-- текстовый редактор, обратно-совместимый с Vi. +Он может быть использован для правки всех видов простого текста. +Особенно он хорош для правки исходных текстов программ. +.PP +По сравнению с Vi, +.B Vim +имеет много усовершенствований: многократная отмена операций, +множественность окон и буферов, подсветка синтаксиса, правка командной строки, +автодополнение имён файлов, встроенная справка, визуальное выделение и т.п. +См. ":help vi_diff.txt" для получения полного списка различий между +.B Vim +и Vi. +.PP +Во время работы в +.B Vim +можно получить справку с помощью системы встроенной справки (команда ":help"). +См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту. +.PP +Чаще всего +.B Vim +запускают для правки одного файла при помощи команды +.PP + vim файл +.PP +В общем виде команда запуска +.B Vim +выглядит так: +.PP + vim [ключи] [список файлов] +.PP +Если список файлов отсутствует, редактор начнёт работу с пустым буфером. +В противном случае имя файла должно быть указано одним из следующих четырёх способов: +.TP 12 +файл .. +Список имён файлов. +Первый файл будет объявлен активным и загружен в буфер. Курсор будет помещён +в первой строке буфера. Доступ к другим файлам может быть осуществлён при +помощи команды ":next". Чтобы править файл, имя которого начинается с символа +"дефис" (-), перед списком файлов необходимо поставить "--". +.TP +\- +Файл будет прочитан из потока стандартного ввода. Команды будут считываться +из стандартного потока диагностики (stderr), который должен быть +терминалом. +.TP +\-t {метка} +Имя файла и начальная позиция курсора зависят от "метки", похожей на метку goto. +{метка} ищется в файле меток, соответствующий файл становится активным, а +соответствующая команда исполняется. +Чаще всего используется в программах на языке Си, где {метка} может быть именем +функции. +Файл, содержащий функцию, становится активным, а курсор помещается в начало функции. +См. ":help tag-commands". +.TP +\-q [файл ошибок] +Начать работу в режиме быстрого исправления. +При этом считывается [файл ошибок] и первая ошибка выводится на экран. +Если [файл ошибок] не указан, имя файла берётся из значения опции 'errorfile' +(по умолчанию: "AztecC.Err" для Amiga, "errors.err" для других систем). +К следующим ошибкам можно перейти по команде ":cn". +См. ":help quickfix". +.PP +.B Vim +ведёт себя по-разному в зависимости от имени команды (исполняемый файл может +быть одним и тем же). +.TP 10 +vim +"Нормальный" запуск, всё по умолчанию. +.TP +ex +Запуск в режиме Ex. Для перехода в нормальный режим +необходимо выполнить команду ":vi". Режим Ex включает +также ключ "\-e". +.TP +view +Запуск в режиме "только для чтения". Вы будете защищены от случайной записи +файла. То же самое можно сделать ключом "\-R". +.TP +gvim gview +Версия с графическим интерфейсом. Запускается в новом окне. +То же самое можно сделать при запуске с ключом "\-g". +.TP +rvim rview rgvim rgview +Как и предыдущие команды, но с ограничениями. Нельзя запускать команды оболочки +или приостанавливать работу +.B Vim. +Вместо приставки "r" можно использовать ключ "\-Z". +.SH КЛЮЧИ +Ключи могут быть указаны в любом порядке, до или после имён +файлов. Ключи без аргументов могут быть объединены под одним +дефисом. +.TP 12 ++[номер] +В первом файле курсор будет помещён на строку с указанным номером. +Если "номер" не указан, курсор будет помещён на последнюю строку. +.TP ++/{шаблон} +В первом файле курсор будет помещён на место первого совпадения +с указанным шаблоном. См. ":help search-pattern" для получения +списка допустимых шаблонов. +.TP ++{команда} +.TP +\-c {команда} +{команда} исполняется после загрузки первого файла как команда Ex. +Если {команда} содержит пробелы, то она должна быть заключена в +двойные кавычки (в зависимости от используемой оболочки). +Пример: vim "+set si" main.c +.br +Примечание: Можно указывать до десяти команд "+" или "\-c". +.TP +\-\-cmd {команда} +Как "\-c", но команда исполняется перед обработкой любого файла +настроек (vimrc). +Можно указывать до десяти таких команд, независимо от количества +команд "\-c". +.TP +\-A +Если +.B Vim +был собран с поддержкой арабского языка для правки файлов, +набранных справа налево, и с поддержкой арабской клавиатуры, +этот ключ запускает +.B Vim +в арабском режиме, с включенной опцией 'arabic'. В противном +случае +.B Vim +завершает работу с ошибкой. +.TP +\-b +Двоичный режим. +Производится настройка некоторых опций, делающих возможной правку +двоичного или исполняемого файла. +.TP +\-C +Режим совместимости. Включает опцию 'compatible'. +.B Vim +будет работать почти как Vi, даже если существует файл .vimrc. +.TP +\-d +Режим поиска различий. +Должно быть указано два или три имени файла. +.B Vim +откроет все файлы и покажет различия между ними +(как vimdiff(1)). +.TP +\-d {устройство} +Открыть {устройство} для использования в качестве терминала (только на Amiga). +Пример: +"\-d con:20/30/600/150". +.TP +\-e +Запустить +.B Vim +в режиме Ex, как будто исполняемый файл имеет имя "ex". +.TP +\-f +Режим активного приложения. Версия +.B Vim +с графическим интерфейсом не будет ветвиться и отключаться +от запустившей её оболочки. На платформе Amiga +.B Vim +не будет создавать новое окно. Этот ключ нужно использовать, +когда +.B Vim +запускается программой, которая должна ждать завершения +сеанса правки (например, программа для работы с электронной почтой). +На платформе Amiga команды ":sh" и ":!" не будут работать. +.TP +\-\-nofork +Режим активного приложения. Версия +.B Vim +с графическим интерфейсом не будет ветвиться и отключаться +от запустившей её оболочки. +.TP +\-F +Если +.B Vim +был собран с поддержкой FKMAP для правки текста справа налево +и настроек клавиатуры для языка фарси, этот ключ запускает +.B Vim +в режиме фарси, иначе говоря, с включёнными опциями +\&'fkmap' и 'rightleft'. +В противном случае +.B Vim +завершает работу с сообщением об ошибке. +.TP +\-g +Если +.B Vim +был собран с поддержкой графического интерфейса, этот ключ +включает графический интерфейс. В противном случае +.B Vim +завершает работу с сообщением об ошибке. +.TP +\-h +Выводит краткую информацию об аргументах и ключах командной строки. +После этого +.B Vim +завершает работу. +.TP +\-H +Если +.B Vim +был собран с поддержкой правки текста справа налево +и настроек клавиатуры для иврита, этот ключ запускает +.B Vim +в режиме иврита, иначе говоря, с включёнными опциями 'hkmap' и 'rightleft'. +В противном случае +.B Vim +завершает работу с сообщением об ошибке. +.TP +\-i {viminfo} +Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо +"~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo +путём указания имени "NONE". +.TP +\-L +То же, что и \-r. +.TP +\-l +Режим Lisp. Включаются опции 'lisp' и 'showmatch'. +.TP +\-m +Изменение файлов запрещено. При этом отключается опция 'write', поэтому +запись файлов становится невозможной. +.TP +\-N +Режим неполной совместимости. Отключается 'compatible'. +.B Vim +будет работать лучше, но не будет полностью совместим с Vi, даже если +отсутствует файл сценария настроек (.vimrc). +.TP +\-n +Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. +Удобно для правки файла на очень медленном носителе (например, гибком диске). +То же самое можно сделать командой ":set uc=0". Отмена -- ":set uc=200". +.TP +\-o[N] +Открыть N окон, разделённых по горизонтали. Если N не указано, то открывается +по одному окну на каждый файл. +.TP +\-O[N] +Открыть N окон, разделённых по вертикали. Если N не указано, то открывается +по одному окну на каждый файл. +.TP +\-R +Режим "только для чтения". Включается опция 'readonly'. +Файл в буфере доступен для редактирования, но его копию на диске нельзя +случайно перезаписать. Для сохранения файла необходимо добавить восклицательный +знак к соответствующей команде Ex (например, ":w!"). +Ключ "\-R" подразумевает также, что используется и ключ "\-n" (см. выше). +Опция 'readonly' может быть выключена по команде ":set noro". +См. ":help 'readonly'". +.TP +\-r +Вывести список своп-файлов и информацию об их использовании для восстановления после сбоя. +.TP +\-r {файл} +Режим восстановления. +Для восстановления после сбоя будет использован своп-файл. +Своп-файл имеет то же имя, что и текстовый файл, но с добавлением расширения ".swp". +См. ":help recovery". +.TP +\-s +Тихий режим. Только при запуске как "Ex" или если перед "\-s" указан ключ "\-e". +.TP +\-s {scriptin} +Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается +в виде команд, как если бы они были набраны на консоли. +То же самое достигается командой ":source! {scriptin}". +Если конец файла считывается до завершения работы редактора, то в дальнейшем +ввод осуществляется с клавиатуры. +.TP +\-T {terminal} +Сообщает +.B Vim +тип используемого терминала. Необходимо только в тех ситуациях, когда +автоматическое определение терминала не работает. Имя терминала должно быть +известно +.B Vim +(встроено в него) или определено в файлах termcap или terminfo. +.TP +\-u {vimrc} +Использовать команды из файла сценария {vimrc} для настройки. +Все остальные файлы настроек пропускаются. +Удобно для редактирования специальных типов файлов. +Чтобы избежать использования сценариев настроек вообще, можно использовать +имя "NONE". См. ":help initialization". +.TP +\-U {gvimrc} +Использовать команды из файла сценария {gvimrc} для настройки графического +интерфейса. +Все остальные файлы настроек для графического интерфейса пропускаются. +Чтобы избежать использования сценариев настроек графического интерфейса вообще, +можно использовать имя "NONE". См. ":help gui-init". +.TP +\-V +"Болтливый" режим. Выводить сообщения о том, какие файлы читаются, и о +чтении-записи файла viminfo. +.TP +\-v +Запустить +.B Vim +в режиме Vi, как будто исполняемый файл имеет имя "vi". Имеет смысл только если +исполняемый файл имеет имя "ex". +.TP +\-w {scriptout} +Все символы, введённые с клавиатуры вплоть до момента завершения работы, +записываются в файл {scriptout}. +Удобно в том случае, когда вы хотите создать файл сценария для последующего +использования с "vim \-s" или ":source!". Если файл {scriptout} уже существует, +то новые символы будут добавляются в конец файла. +.TP +\-W {scriptout} +Как "\-w", но уже существующий файл будет перезаписан. +.TP +\-x +Шифровать записываемые файлы. Будет выдано приглашение ввести пароль. +.TP +\-X +Не подключаться к X-серверу. Ускоряет загрузку на консоли, но делает невозможным +использование заголовка окна и буфера обмена. +.TP +\-Z +Ограниченный режим. Работает так же, как и программы, начинающиеся с "r". +.TP +\-\- +Конец ключей. Все остальные аргументы рассматриваются как имена файлов. +Может быть использовано для правки файлов, имена которых начинаются с дефиса. +.TP +\-\-help +Вывести краткую справку и завершить работу. То же, что и "\-h". +.TP +\-\-version +Вывести информацию о версии программы и завершить работу. +.TP +\-\-remote +Подключиться к серверу Vim и заставить его править файлы, указанные в +последующих аргументах. Если сервер не найден, выводится предупреждение, +а файлы правятся в местной копии Vim. +.TP +\-\-remote\-expr {выражение} +Подключиться к серверу Vim и вычислить на нём указанное {выражение}. +Результат вычисления будет выведен в поток стандартного вывода (stdout). +.TP +\-\-remote\-send {ключи} +Подключиться к серверу Vim и передать ему указанные {ключи}. +.TP +\-\-remote\-silent +Как "\-\-remote", но без вывода предупреждения, если сервер не найден. +.TP +\-\-remote\-wait +Как "\-\-remote", но Vim не будет завершать работу до тех пор, пока не будет +выполнена правка всех файлов. +.TP +\-\-remote\-wait\-silent +Как "\-\-remote\-wait", но без вывода предупреждения, если сервер не найден. +.TP +\-\-serverlist +Вывести список всех доступных серверов Vim. +.TP +\-\-servername {имя} +Использовать указанное {имя} в качестве имени сервера. Если ключ +"\-\-remote" не указан, то {имя} присваивается данной копии Vim, +в противном случае указывает на имя сервера, к которому следует +подключиться. +.TP +\-\-socketid {id} +Только для графического интерфейса GTK: использовать механизм GtkPlug для +запуска gvim в отдельном окне. +.TP +\-\-echo\-wid +Только для графического интерфейса GTK: вывести идентификатор окна (Window ID) +в поток стандартного вывода (stdout). +.SH ВСТРОЕННАЯ СПРАВКА +Для начала, наберите команду ":help". +Введите ":help тема", чтобы получить справку по конкретной теме. +Например, команда ":help ZZ" выведет информацию о команде "ZZ". +Используйте <Tab> и CTRL-D для автоматического дополнения +названий тем (":help cmdline-completion"). +Для быстрого перемещения по справочнику используются метки (что-то +вроде гипертекстовых ссылок, см. ":help"). Таким образом можно +просматривать все файлы справки, например ":help syntax.txt". +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/doc/*.txt +Файлы справочника +.B Vim. +См. ":help doc-file-list" для получения полного списка. +.TP +/usr/local/lib/vim/doc/tags +Файл меток, используемый для поиска информации в файлах справки. +.TP +/usr/local/lib/vim/syntax/syntax.vim +Системные настройки синтаксиса. +.TP +/usr/local/lib/vim/syntax/*.vim +Файлы синтаксиса для разных языков. +.TP +/usr/local/lib/vim/vimrc +Системные настройки +.B Vim. +.TP +/usr/local/lib/vim/gvimrc +Системный настройки графического интерфейса. +.TP +/usr/local/lib/vim/optwin.vim +Сценарий, используемый при выполнении команды ":options". +Хороший способ просматривать и изменять настройки. +.TP +/usr/local/lib/vim/menu.vim +Системные настройки меню для gvim. +.TP +/usr/local/lib/vim/bugreport.vim +Сценарий для создания отчёта об обнаруженных глюках. См. ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Сценарий для определения типа файла по имени. См. ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Сценарий для определения типа файла по содержимому. См. ":help 'filetype'". +.TP +/usr/local/lib/vim/print/*.ps +Файлы для печати PostScript. +.PP +Более свежая информация -- на сайте VIM: +.br +<URL:http://www.vim.org/> +.SH СМОТРИ ТАКЖЕ +vimtutor(1) +.SH АВТОРЫ +Большая часть +.B Vim +создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное +количество людей. См. ":help credits" в +.B Vim. +.br +.B Vim +базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson), +Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). +Однако, в настоящее время в Vim почти не осталось ничего от исторического кода +его предшественника. +.br +Русская локализация +.B Vim +выполняется в рамках проекта "РуВим", +см. <URL:http://sourceforge.net/projects/ruvim/>. +.SH ГЛЮКИ +Скорее всего есть. +См. ":help todo" -- список известных проблем. +.PP +Заметим, что многие вещи, которые считаются глюками, на самом деле +являются результатом слишком полного воспроизведения поведения Vi. +Если вы думаете, что что-то является ошибкой только потому, что +"Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt +(или наберите ":help vi_diff.txt" в Vim) и используйте опции 'compatible' +и 'cpoptions'. diff --git a/runtime/doc/manpages/ru/vimdiff-ru.1 b/runtime/doc/manpages/ru/vimdiff-ru.1 new file mode 100644 index 0000000000..2f17e9c2e5 --- /dev/null +++ b/runtime/doc/manpages/ru/vimdiff-ru.1 @@ -0,0 +1,50 @@ +.TH VIMDIFF 1 "2001 March 30" +.SH ИМЯ +vimdiff \- позволяет редактировать две или три версии файла с помощью Vim +с отображением различий. +.SH КОМАНДНАЯ СТРОКА +.br +.B vimdiff +[ключи] файл1 файл2 [файл3] +.PP +.B gvimdiff +.SH ОПИСАНИЕ +Команда +.B vimdiff +загружает в +.B Vim +два (или три) файла. Каждый файл открывается в собственном окне. +Различия между файлами отображаются с помощью подсветки синтаксиса. +Эта команда позволяет наглядно отображать внесённые изменения и переносить +различающиеся фрагменты из одной версии файла в другую. +.PP +Подробнее о Vim см. на странице справочника vim(1). +.PP +При запуске с помощью команды +.B gvimdiff +редактор запускается в режиме графического интерфейса, если это возможно. +.PP +В каждом окне включается опция 'diff', что позволяет использовать подсветку +синтаксиса для отображения различий между файлами. +.br +Для улучшения работы с файлами в режиме отображения отличий также включаются +опции 'wrap' и 'scrollbind'. +.br +Значение опции 'foldmethod' устанавливается равным "diff", что позволяет +прятать в складку области текста, которые не отличаются в различных версиях файла. +Значение опции 'foldcolumn' устанавливается равным 2, чтобы было проще +находить, открывать и закрывать такие складки. +.SH КЛЮЧИ ЗАПУСКА +Для выравнивания строк между окнами используется вертикальное разделение окон, +как если бы использовался ключ "\-O". Для того, чтобы использовать разделение +окон по горизонтали, следует указать в командной строке ключ "\-o". +.PP +Остальные ключи командной строки рассматриваются на странице справочника vim(1). +.SH СМОТРИ ТАКЖЕ +vim(1) +.SH АВТОРЫ +Большая часть +.B Vim +создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное +количество людей. См. ":help credits" в +.B Vim. diff --git a/runtime/doc/manpages/ru/vimtutor-ru.1 b/runtime/doc/manpages/ru/vimtutor-ru.1 new file mode 100644 index 0000000000..6b1ba90df0 --- /dev/null +++ b/runtime/doc/manpages/ru/vimtutor-ru.1 @@ -0,0 +1,51 @@ +.TH VIMTUTOR 1 "2001 April 2" +.SH ИМЯ +vimtutor \- учебник по Vim +.SH КОМАНДНАЯ СТРОКА +.br +.B vimtutor [язык] +.SH ОПИСАНИЕ +Команда +.B vimtutor +запускает учебник по +.B Vim. +При этом сначала происходит создание копии файла учебника, +чтобы его можно было редактировать без опасения потерять исходный файл. +.PP +Программа +.B vimtutor +полезна для новичков, желающих научиться самым основным командам +.B Vim. +.PP +Необязательный параметр [язык] представляет собой двухсимвольный код языка, +например "ru" или "it". +Если параметр [язык] не указан, то используется язык активной в настоящий +момент локали. Если учебник на этом языке не существует, то по умолчанию +используется учебник на английском языке. +.PP +При работе с учебником +.B Vim +всегда запускается в режиме совместимости с Vi. +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/tutor/tutor[.язык] +Текст учебника +.B vimtutor. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Сценарий Vim, который используется для создания рабочей +копии текста учебника +.B vimtutor. +.SH АВТОРЫ +.B Vimtutor +был впервые написан для Vi Майклом К. Пирсом (Michael C. Pierce) и +Робертом К. Уэа (Robert K. Ware) из Colorado School of Mines по +идее Чарльза Смита (Charles Smith) из Colorado State University. +E-mail: bware@mines.colorado.edu. +.br +Впоследствии учебник был доработан для использования в +.B Vim +Брамом Мооленааром (Bram Moolenaar). +Имена переводчиков учебника упоминаются в соответствующих файлах. +.SH СМОТРИ ТАКЖЕ +vim(1) diff --git a/runtime/doc/manpages/ru/xxd-ru.1 b/runtime/doc/manpages/ru/xxd-ru.1 new file mode 100644 index 0000000000..647845bab4 --- /dev/null +++ b/runtime/doc/manpages/ru/xxd-ru.1 @@ -0,0 +1,408 @@ +.TH XXD 1 "August 1996" "Страница man для xxd" +.\" +.\" 21st May 1996 +.\" Man page author: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Changes by Bram Moolenaar <Bram@vim.org> +.SH ИМЯ +.I xxd +\- создаёт представление файла в виде шестнадцатеричных кодов или выполняет +обратное преобразование. +.SH КОМАНДНАЯ СТРОКА +.B xxd +\-h[elp] +.br +.B xxd +[ключи] [входной_файл [выходной_файл]] +.br +.B xxd +\-r[evert] [ключи] [входной_файл [выходной_файл]] +.SH ОПИСАНИЕ +.I xxd +создаёт представление указанного файла или данных, прочитанных из потока +стандартного ввода, в виде шестнадцатеричных кодов. Эта команда также может +выполнить обратное преобразование заданных шестнадцатеричными кодами данных +в исходный бинарный формат. +Подобно командам +.BR uuencode(1) +и +.BR uudecode(1), +она позволяет выполнять преобразование бинарных данных в ASCII-код, +который можно передавать по электронной почте, однако, помимо этого, программа +xxd позволяет выполнять декодирование в поток стандартного вывода, +а также может применяться для создания заплаток для бинарных файлов. +.SH КЛЮЧИ ЗАПУСКА +Если +.I входной_файл +не задан, то соответствующие данные читаются из потока стандартного ввода. +В случае, если в качестве +.I входного_файла +используется символ +.RB \` \- ', +источником данных также выступает поток стандартного ввода. +В том случае, если не указан +.I выходной_файл +(или вместо него используется символ +.RB \` \- ' +), результат преобразования направляется в поток стандартного вывода. +.PP +Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не +проверяет более одной буквы ключа, если в этом ключе не используется параметр. +Пробелы между единственным символом ключа и соответствующим параметром не являются +обязательными. Параметры ключей могут быть заданы с использованием десятичного, +шестнадцатеричного или восьмеричного формата. +Таким образом, ключи +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +и +.B \-cols 8 +являются равнозначными. +.PP +.TP +.IR \-a " | " \-autoskip +Включает автоматический пропуск: вместо последовательности +нулевых строк используется одиночный символ '*'. По умолчанию +не применяется. +.TP +.IR \-b " | " \-bits +Вместо шестнадцатеричного кода используются биты (двоичные цифры). +При использовании этого ключа вместо обычного шестнадцатеричного представления +октетов используются наборы из восьми символов "1" и "0". Каждая строка +предваряется номером строки в шестнадцатеричном виде, а завершается символьным +представлением (в виде ascii или ebcdic). Ключи \-r, \-p, \-i в этом режиме +не работают. +.TP +.IR "\-c кол " | " \-cols кол" +Задаёт количество октетов +.RI < кол >, +которое выводится на каждой строке. По умолчанию используется значение 16 +(\-i: 12, \-ps: 30, \-b: 6). +Максимально допустимое значение: 256. +.TP +.IR \-E " | " \-EBCDIC +Изменяет способ кодирования символов в правой колонке с ASCII на EBCDIC. Этот ключ +не изменяет шестнадцатеричное представление. Данный ключ не имеет смысла, +если используются ключи \-r, \-p или \-i. +.TP +.IR "\-g байт " | " \-groupsize байт" +Позволяет выполнять группировку указанного количества +.RI < байтов > +(две шестнадцатеричные цифры или восемь битов), отделяя группы друг от друга пробелами. +Значение +.I \-g 0 +применяется для отказа от использования группировки. +По умолчанию используется значение +.RI < байт "> равное " 2 +в обычном режиме и \fI1\fP в битовом режиме. Группировка не применяется +в режимах postscript и include. +.TP +.IR \-h " | " \-help +Выводит справку по доступным ключам командной строки и завершает работу программы. +Создание шестнадцатеричного представления не выполняется. +.TP +.IR \-i " | " \-include +Позволяет создавать вывод в стиле подключаемых заголовочных файлов языка C. +Вывод содержит полноценное определение статического массива данных, имя которого +соответствует имени входного файла, если xxd не считывает данные из потока стандартного +ввода. +.TP +.IR "\-l длина " | " \-len длина" +Завершает работу после записи заданного в параметре +.RI < длина > +количества октетов. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +Использует непрерывный формат вывода шестнадцатеричного кода, +известный как "простой" стиль или стиль "postscript". +.TP +.IR \-r " | " \-revert +Изменяет смысл операции на противоположный: позволяет выполнять преобразование +шестнадцатеричного представления в бинарный код (или применять результат в качестве заплаты). +Если вывод происходит не в поток стандартного вывода, то xxd выполняет добавление кода +к соответствующему файлу. При использовании комбинации ключей +.I \-r \-p +происходит чтение "простого" шестнадцатеричного представления без использования +информации о номерах строк и какого-либо специального раскроя колонок. Пробелы +и символы новой строки могут встречаться в любом месте исходных данных. +.TP +.I \-seek смещение +При использовании после ключа +.I \-r +: добавлять указанное +.RI < смещение > +к файловым позициям, обнаруженным в исходных данных. +.TP +.I \-s [\+][\-]seek +Начинает работу с указанного абсолютного (или относительного) +.RI < смещения > +в байтах во входном_файле. +\fI\+ \fRуказывает, что смещение является относительным по отношению +к текущей файловой позиции в потоке стандартного ввода (бессмысленно, если чтение +происходит не из потока стандартного ввода). \fI\- \fRуказывает, что должно быть прочитано +указанное количество символов от конца ввода (либо, если сочетается с \fI \+ \fR: +перед текущей позиции файла в потоке стандартного ввода). +Если ключ \-s не используется, то xxd начинает работу от текущей позиции в файле. +.TP +.I \-u +Использует шестнадцатеричные цифры в верхнем регистре. По умолчанию используются цифры в +нижнем регистре символов. +.TP +.IR \-v " | " \-version +Отображает информацию о версии программы. +.SH ПОДВОДНЫЕ КАМНИ +.PP +.I xxd \-r +обладает встроенным интеллектом для распознавания информации о номерах строк. +Если возможен поиск по входному файлу, то номера строк в начале каждой строки +шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут +быть пропущены или пересекаться друг с другом. В этих случаях xxd использует +lseek(2) для перехода к следующей позиции. Если поиск по входному файлу +невозможен, то допустимы только пропуски строк, которые заполняются нулевыми +байтами. +.PP +.I xxd \-r +никогда не выводит сообщений об ошибках. Мусор пропускается молча. +.PP +При редактировании шестнадцатеричных представлений бинарных файлов обращайте +внимание, что +.I xxd \-r +пропускает в строке ввода любые данные после прочтения достаточного количества +колонок шестнадцатеричных данных (см. ключ \-c). Это означает, что изменения, +внесенные в колонки с печатными символами ascii (или ebcdic), всегда игнорируются. +При обратном преобразовании шестнадцатеричного представления в стиле +postscript с помощью команды xxd \-r \-p количество колонок не учитывается. +В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр. +.PP +Обратите внимание на различие между командами +.PP +\fI% xxd \-i файл\fR +.PP +и +.PP +\fI% xxd \-i \< файл\fR +.PP +Команда +.I xxd \-s \+seek +может отличаться от +.I xxd \-s seek, +поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов lseek(2). +При использовании `+' поведение будет отличаться, если входные данные +поступают с потока стандартного ввода, а позиция в файле стандартного ввода не находится +в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода. +Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию... +.PP +Отмотка назад потока стандартного ввода; необходимо, поскольку 'cat' уже выполнила +чтение до конца потока стандартного ввода: +.PP +\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x480 +(= 1024+128). +Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется +к первому килобайту, где завершает работу dd: +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x100 +(= 1024-768): +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +.PP +В то же время, следует заметить, что подобные ситуации встречаются довольно редко, +так что символ `+' обычно не используется. Автор предпочитает наблюдать за работой +xxd с помощью strace(1) или truss(1) в тех случаях, когда применяется ключ +\-s. +.SH ПРИМЕРЫ +.PP +.br +Вывести всё, кроме первых трёх строк (0x30 байтов) файла +.B file +: +.PP +\fI% xxd \-s 0x30 file +.PP +.br +Вывести три строки (0x30 байтов) от конца файла +.B file +: +.PP +\fI% xxd \-s \-0x30 file +.PP +.br +Вывести 120 байтов в виде непрерывного шестнадцатеричного представления +по 20 октетов в строке: +.PP +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e544820585844203120224d616e75616c207061 +.br +676520666f7220787864220a2e5c220a2e5c2220 +.br +32317374204d617920313939360a2e5c22204d61 +.br +6e207061676520617574686f723a0a2e5c222020 +.br +2020546f6e79204e7567656e74203c746f6e7940 +.br +7363746e7567656e2e7070702e67752e6564752e +.br +.PP +.br +Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке: +.PP +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +.br +000000c: 616e 7561 6c20 7061 6765 2066 anual page f +.br +0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +.br +0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +.br +0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +.br +000003c: 6e20 7061 6765 2061 7574 686f n page autho +.br +0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +.br +0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +.br +0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +.br +000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +.PP +.br +Показать дату из файла xxd.1: +.PP +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +.PP +.br +Скопировать +.B входной_файл +в +.B выходной_файл +с добавлением 100 байтов со значением 0x00 в начало файла: +.PP +\fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR +.br +.PP +.br +Заменить дату в файле xxd.1: +.PP +\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3235 7468 204d 6179 2031 3939 25th May 199 +.PP +.br +Создать 65537-байтный файл, все байты которого имеют значение +0x00, кроме последнего байта, который должен иметь значение 'A' +(0x41): +.PP +\fI% echo '010000: 41' | xxd \-r \> file\fR +.PP +.br +Создать шестнадцатеричное представление этого файла с +использованием автоматического пропуска: +.PP +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Создать 1-байтный файл, содержащий символ 'A'. +Число после '\-r \-s' добавляется к номерам строк, найденным в файле; +иначе говоря, предшествующие байты пропускаются: +.PP +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +.PP +xxd можно использовать в качестве фильтра в редакторе, например в +.B vim(1), +чтобы создать шестнадцатеричное представление области между +отметками `a' и `z': +.PP +\fI:'a,'z!xxd\fR +.PP +Вы можете использовать xxd в качестве фильтра в редакторе, например в +.B vim(1), +для восстановления данных из шестнадцатеричного представления +между отметками `a' и `z': +.PP +\fI:'a,'z!xxd \-r\fR +.PP +Вы можете использовать xxd в качестве фильтра в редакторе, например в +.B vim(1), +для восстановления данных из единственной строки +шестнадцатеричного представления. Поместите курсор в соответствующую строку +и наберите +.PP +\fI!!xxd \-r\fR +.PP +Чтобы прочитать единственный символ из канала связи: +.PP +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.PP +.SH ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ +Программа xxd завершает работу со следующими значениями: +.TP +0 +Ошибки не обнаружены. +.TP +\-1 +Операция не поддерживается (выполнение +.I xxd \-r \-i +пока невозможно). +.TP +1 +Ошибка при разборе ключей командной строки. +.TP +2 +Проблемы во входном файле. +.TP +3 +Проблемы в выходном файле. +.TP +4,5 +Желательная позиция поиска недостижима. +.SH СМОТРИ ТАКЖЕ +uuencode(1), uudecode(1), patch(1) +.br +.SH ПРЕДУПРЕЖДЕНИЕ +Странность этой программы соответствует особенностям мозга её создателя. +Используйте её на свой страх и риск. Копируйте файлы, отслеживайте +вызовы, становитесь волшебником. +.br +.SH ВЕРСИЯ +Эта страница справочника документирует xxd версии 1.7. +.SH АВТОР +.br +(c) 1990-1997 Юрген Вайгерт (Juergen Weigert) +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Вы можете свободно распространять программу со ссылкой на меня. +.br +Если использование этой программы принесло вам какой-то доход, +поделитесь со мной. +.br +Если вы потеряли деньги, то я тут не причём. +.PP +Первый вариант страницы справочника написан Тони Наджентом (Tony Nugent) +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Небольшие изменения внесены Брамом Мооленааром (Bram Moolenaar). +Страница отредактирована Юргеном Вайгертом (Juergen Weigert). +.PP diff --git a/runtime/doc/manpages/vim.1 b/runtime/doc/manpages/vim.1 new file mode 100644 index 0000000000..820caa24f5 --- /dev/null +++ b/runtime/doc/manpages/vim.1 @@ -0,0 +1,553 @@ +.TH VIM 1 "2006 Apr 11" +.SH NAME +vim \- Vi IMproved, a programmers text editor +.SH SYNOPSIS +.br +.B vim +[options] [file ..] +.br +.B vim +[options] \- +.br +.B vim +[options] \-t tag +.br +.B vim +[options] \-q [errorfile] +.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 +is a text editor that is upwards compatible to Vi. +It can be used to edit all kinds of plain text. +It is especially useful for editing programs. +.PP +There are a lot of enhancements above Vi: multi level undo, +multi windows and buffers, syntax highlighting, command line +editing, filename completion, on-line help, visual selection, etc.. +See ":help vi_diff.txt" for a summary of the differences between +.B Vim +and Vi. +.PP +While running +.B Vim +a lot of help can be obtained from the on-line help system, with the ":help" +command. +See the ON-LINE HELP section below. +.PP +Most often +.B Vim +is started to edit a single file with the command +.PP + vim file +.PP +More generally +.B Vim +is started with: +.PP + vim [options] [filelist] +.PP +If the filelist is missing, the editor will start with an empty buffer. +Otherwise exactly one out of the following four may be used to choose one or +more files to be edited. +.TP 12 +file .. +A list of filenames. +The first one will be the current file and read into the buffer. +The cursor will be positioned on the first line of the buffer. +You can get to the other files with the ":next" command. +To edit a file that starts with a dash, precede the filelist with "\-\-". +.TP +\- +The file to edit is read from stdin. Commands are read from stderr, which +should be a tty. +.TP +\-t {tag} +The file to edit and the initial cursor position depends on a "tag", a sort +of goto label. +{tag} is looked up in the tags file, the associated file becomes the current +file and the associated command is executed. +Mostly this is used for C programs, in which case {tag} could be a function +name. +The effect is that the file containing that function becomes the current file +and the cursor is positioned on the start of the function. +See ":help tag\-commands". +.TP +\-q [errorfile] +Start in quickFix mode. +The file [errorfile] is read and the first error is displayed. +If [errorfile] is omitted, the filename is obtained from the 'errorfile' +option (defaults to "AztecC.Err" for the Amiga, "errors.err" on other +systems). +Further errors can be jumped to with the ":cn" command. +See ":help quickfix". +.PP +.B Vim +behaves differently, depending on the name of the command (the executable may +still be the same file). +.TP 10 +vim +The "normal" way, everything is default. +.TP +ex +Start in Ex mode. +Go to Normal mode with the ":vi" command. +Can also be done with the "\-e" argument. +.TP +view +Start in read-only mode. You will be protected from writing the files. Can +also be done with the "\-R" argument. +.TP +gvim gview +The GUI version. +Starts a new window. +Can also be done with the "\-g" argument. +.TP +evim eview +The GUI version in easy mode. +Starts a new window. +Can also be done with the "\-y" argument. +.TP +rvim rview rgvim rgview +Like the above, but with restrictions. It will not be possible to start shell +commands, or suspend +.B Vim. +Can also be done with the "\-Z" argument. +.SH OPTIONS +The options may be given in any order, before or after filenames. +Options without an argument can be combined after a single dash. +.TP 12 ++[num] +For the first file the cursor will be positioned on line "num". +If "num" is missing, the cursor will be positioned on the last line. +.TP ++/{pat} +For the first file the cursor will be positioned on the +first occurrence of {pat}. +See ":help search\-pattern" for the available search patterns. +.TP ++{command} +.TP +\-c {command} +{command} will be executed after the +first file has been read. +{command} is interpreted as an Ex command. +If the {command} contains spaces it must be enclosed in double quotes (this +depends on the shell that is used). +Example: Vim "+set si" main.c +.br +Note: You can use up to 10 "+" or "\-c" commands. +.TP +\-S {file} +{file} will be sourced after the first file has been read. +This is equivalent to \-c "source {file}". +{file} cannot start with '\-'. +If {file} is omitted "Session.vim" is used (only works when \-S is the last +argument). +.TP +\-\-cmd {command} +Like using "\-c", but the command is executed just before +processing any vimrc file. +You can use up to 10 of these commands, independently from "\-c" commands. +.TP +\-A +If +.B Vim +has been compiled with ARABIC support for editing right-to-left +oriented files and Arabic keyboard mapping, this option starts +.B Vim +in Arabic mode, i.e. 'arabic' is set. Otherwise an error +message is given and +.B Vim +aborts. +.TP +\-b +Binary mode. +A few options will be set that makes it possible to edit a binary or +executable file. +.TP +\-C +Compatible. Set the 'compatible' option. +This will make +.B Vim +behave mostly like Vi, even though a .vimrc file exists. +.TP +\-d +Start in diff mode. +There should be two, three or four file name arguments. +.B Vim +will open all the files and show differences between them. +Works like vimdiff(1). +.TP +\-d {device} +Open {device} for use as a terminal. +Only on the Amiga. +Example: +"\-d con:20/30/600/150". +.TP +\-D +Debugging. Go to debugging mode when executing the first command from a +script. +.TP +\-e +Start +.B Vim +in Ex mode, just like the executable was called "ex". +.TP +\-E +Start +.B Vim +in improved Ex mode, just like the executable was called "exim". +.TP +\-f +Foreground. For the GUI version, +.B Vim +will not fork and detach from the shell it was started in. +On the Amiga, +.B Vim +is not restarted to open a new window. +This option should be used when +.B Vim +is executed by a program that will wait for the edit +session to finish (e.g. mail). +On the Amiga the ":sh" and ":!" commands will not work. +.TP +\-\-nofork +Foreground. For the GUI version, +.B Vim +will not fork and detach from the shell it was started in. +.TP +\-F +If +.B Vim +has been compiled with FKMAP support for editing right-to-left +oriented files and Farsi keyboard mapping, this option starts +.B Vim +in Farsi mode, i.e. 'fkmap' and 'rightleft' are set. +Otherwise an error message is given and +.B Vim +aborts. +.TP +\-g +If +.B Vim +has been compiled with GUI support, this option enables the GUI. +If no GUI support was compiled in, an error message is given and +.B Vim +aborts. +.TP +\-h +Give a bit of help about the command line arguments and options. +After this +.B Vim +exits. +.TP +\-H +If +.B Vim +has been compiled with RIGHTLEFT support for editing right-to-left +oriented files and Hebrew keyboard mapping, this option starts +.B Vim +in Hebrew mode, i.e. 'hkmap' and 'rightleft' are set. +Otherwise an error message is given and +.B Vim +aborts. +.TP +\-i {viminfo} +When using the viminfo file is enabled, this option sets the filename to use, +instead of the default "~/.viminfo". +This can also be used to skip the use of the .viminfo file, by giving the name +"NONE". +.TP +\-L +Same as \-r. +.TP +\-l +Lisp mode. +Sets the 'lisp' and 'showmatch' options on. +.TP +\-m +Modifying files is disabled. +Resets the 'write' option. +You can still modify the buffer, but writing a file is not possible. +.TP +\-M +Modifications not allowed. The 'modifiable' and 'write' options will be unset, +so that changes are not allowed and files can not be written. Note that these +options can be set to enable making modifications. +.TP +\-N +No-compatible mode. Reset the 'compatible' option. +This will make +.B Vim +behave a bit better, but less Vi compatible, even though a .vimrc file does +not exist. +.TP +\-n +No swap file will be used. +Recovery after a crash will be impossible. +Handy if you want to edit a file on a very slow medium (e.g. floppy). +Can also be done with ":set uc=0". +Can be undone with ":set uc=200". +.TP +\-nb +Become an editor server for NetBeans. See the docs for details. +.TP +\-o[N] +Open N windows stacked. +When N is omitted, open one window for each file. +.TP +\-O[N] +Open N windows side by side. +When N is omitted, open one window for each file. +.TP +\-p[N] +Open N tab pages. +When N is omitted, open one tab page for each file. +.TP +\-R +Read-only mode. +The 'readonly' option will be set. +You can still edit the buffer, but will be prevented from accidently +overwriting a file. +If you do want to overwrite a file, add an exclamation mark to the Ex command, +as in ":w!". +The \-R option also implies the \-n option (see below). +The 'readonly' option can be reset with ":set noro". +See ":help 'readonly'". +.TP +\-r +List swap files, with information about using them for recovery. +.TP +\-r {file} +Recovery mode. +The swap file is used to recover a crashed editing session. +The swap file is a file with the same filename as the text file with ".swp" +appended. +See ":help recovery". +.TP +\-s +Silent mode. Only when started as "Ex" or when the "\-e" option was given +before the "\-s" option. +.TP +\-s {scriptin} +The script file {scriptin} is read. +The characters in the file are interpreted as if you had typed them. +The same can be done with the command ":source! {scriptin}". +If the end of the file is reached before the editor exits, further characters +are read from the keyboard. +.TP +\-T {terminal} +Tells +.B Vim +the name of the terminal you are using. +Only required when the automatic way doesn't work. +Should be a terminal known +to +.B Vim +(builtin) or defined in the termcap or terminfo file. +.TP +\-u {vimrc} +Use the commands in the file {vimrc} for initializations. +All the other initializations are skipped. +Use this to edit a special kind of files. +It can also be used to skip all initializations by giving the name "NONE". +See ":help initialization" within vim for more details. +.TP +\-U {gvimrc} +Use the commands in the file {gvimrc} for GUI initializations. +All the other GUI initializations are skipped. +It can also be used to skip all GUI initializations by giving the name "NONE". +See ":help gui\-init" within vim for more details. +.TP +\-V[N] +Verbose. Give messages about which files are sourced and for reading and +writing a viminfo file. The optional number N is the value for 'verbose'. +Default is 10. +.TP +\-v +Start +.B Vim +in Vi mode, just like the executable was called "vi". This only has effect +when the executable is called "ex". +.TP +\-w {scriptout} +All the characters that you type are recorded in the file +{scriptout}, until you exit +.B Vim. +This is useful if you want to create a script file to be used with "vim \-s" or +":source!". +If the {scriptout} file exists, characters are appended. +.TP +\-W {scriptout} +Like \-w, but an existing file is overwritten. +.TP +\-x +Use encryption when writing files. Will prompt for a crypt key. +.TP +\-X +Don't connect to the X server. Shortens startup time in a terminal, but the +window title and clipboard will not be used. +.TP +\-y +Start +.B Vim +in easy mode, just like the executable was called "evim" or "eview". +Makes +.B Vim +behave like a click-and-type editor. +.TP +\-Z +Restricted mode. Works like the executable starts with "r". +.TP +\-\- +Denotes the end of the options. +Arguments after this will be handled as a file name. +This can be used to edit a filename that starts with a '\-'. +.TP +\-\-echo\-wid +GTK GUI only: Echo the Window ID on stdout. +.TP +\-\-help +Give a help message and exit, just like "\-h". +.TP +\-\-literal +Take file name arguments literally, do not expand wildcards. This has no +effect on Unix where the shell expands wildcards. +.TP +\-\-noplugin +Skip loading plugins. Implied by \-u NONE. +.TP +\-\-remote +Connect to a Vim server and make it edit the files given in the rest of the +arguments. If no server is found a warning is given and the files are edited +in the current Vim. +.TP +\-\-remote\-expr {expr} +Connect to a Vim server, evaluate {expr} in it and print the result on stdout. +.TP +\-\-remote\-send {keys} +Connect to a Vim server and send {keys} to it. +.TP +\-\-remote\-silent +As \-\-remote, but without the warning when no server is found. +.TP +\-\-remote\-wait +As \-\-remote, but Vim does not exit until the files have been edited. +.TP +\-\-remote\-wait\-silent +As \-\-remote\-wait, but without the warning when no server is found. +.TP +\-\-serverlist +List the names of all Vim servers that can be found. +.TP +\-\-servername {name} +Use {name} as the server name. Used for the current Vim, unless used with a +\-\-remote argument, then it's the name of the server to connect to. +.TP +\-\-socketid {id} +GTK GUI only: Use the GtkPlug mechanism to run gvim in another window. +.TP +\-\-version +Print version information and exit. +.SH ON-LINE HELP +Type ":help" in +.B Vim +to get started. +Type ":help subject" to get help on a specific subject. +For example: ":help ZZ" to get help for the "ZZ" command. +Use <Tab> and CTRL-D to complete subjects (":help cmdline\-completion"). +Tags are present to jump from one place to another (sort of hypertext links, +see ":help"). +All documentation files can be viewed in this way, for example +":help syntax.txt". +.SH FILES +.TP 15 +/usr/local/lib/vim/doc/*.txt +The +.B Vim +documentation files. +Use ":help doc\-file\-list" to get the complete list. +.TP +/usr/local/lib/vim/doc/tags +The tags file used for finding information in the documentation files. +.TP +/usr/local/lib/vim/syntax/syntax.vim +System wide syntax initializations. +.TP +/usr/local/lib/vim/syntax/*.vim +Syntax files for various languages. +.TP +/usr/local/lib/vim/vimrc +System wide +.B Vim +initializations. +.TP +~/.vimrc +Your personal +.B Vim +initializations. +.TP +/usr/local/lib/vim/gvimrc +System wide gvim initializations. +.TP +~/.gvimrc +Your personal gvim initializations. +.TP +/usr/local/lib/vim/optwin.vim +Script used for the ":options" command, a nice way to view and set options. +.TP +/usr/local/lib/vim/menu.vim +System wide menu initializations for gvim. +.TP +/usr/local/lib/vim/bugreport.vim +Script to generate a bug report. See ":help bugs". +.TP +/usr/local/lib/vim/filetype.vim +Script to detect the type of a file by its name. See ":help 'filetype'". +.TP +/usr/local/lib/vim/scripts.vim +Script to detect the type of a file by its contents. See ":help 'filetype'". +.TP +/usr/local/lib/vim/print/*.ps +Files used for PostScript printing. +.PP +For recent info read the VIM home page: +.br +<URL:http://www.vim.org/> +.SH SEE ALSO +vimtutor(1) +.SH AUTHOR +Most of +.B Vim +was made by Bram Moolenaar, with a lot of help from others. +See ":help credits" in +.B Vim. +.br +.B Vim +is based on Stevie, worked on by: Tim Thompson, +Tony Andrews and G.R. (Fred) Walter. +Although hardly any of the original code remains. +.SH BUGS +Probably. +See ":help todo" for a list of known problems. +.PP +Note that a number of things that may be regarded as bugs by some, are in fact +caused by a too-faithful reproduction of Vi's behaviour. +And if you think other things are bugs "because Vi does it differently", +you should take a closer look at the vi_diff.txt file (or type :help +vi_diff.txt when in Vim). +Also have a look at the 'compatible' and 'cpoptions' options. diff --git a/runtime/doc/manpages/vimdiff.1 b/runtime/doc/manpages/vimdiff.1 new file mode 100644 index 0000000000..bed2b32889 --- /dev/null +++ b/runtime/doc/manpages/vimdiff.1 @@ -0,0 +1,46 @@ +.TH VIMDIFF 1 "2001 March 30" +.SH NAME +vimdiff \- edit two, three or four versions of a file with Vim and show differences +.SH SYNOPSIS +.br +.B vimdiff +[options] file1 file2 [file3 [file4]] +.PP +.B gvimdiff +.SH DESCRIPTION +.B Vimdiff +starts +.B Vim +on two (or three or four) files. +Each file gets its own window. +The differences between the files are highlighted. +This is a nice way to inspect changes and to move changes from one version +to another version of the same file. +.PP +See vim(1) for details about Vim itself. +.PP +When started as +.B gvimdiff +the GUI will be started, if available. +.PP +In each window the 'diff' option will be set, which causes the differences +to be highlighted. +.br +The 'wrap' and 'scrollbind' options are set to make the text look good. +.br +The 'foldmethod' option is set to "diff", which puts ranges of lines without +changes in a fold. 'foldcolumn' is set to two to make it easy to spot the +folds and open or close them. +.SH OPTIONS +Vertical splits are used to align the lines, as if the "\-O" argument was used. +To use horizontal splits instead, use the "\-o" argument. +.PP +For all other arguments see vim(1). +.SH SEE ALSO +vim(1) +.SH AUTHOR +Most of +.B Vim +was made by Bram Moolenaar, with a lot of help from others. +See ":help credits" in +.B Vim. diff --git a/runtime/doc/manpages/vimtutor.1 b/runtime/doc/manpages/vimtutor.1 new file mode 100644 index 0000000000..0aa7e8d8d9 --- /dev/null +++ b/runtime/doc/manpages/vimtutor.1 @@ -0,0 +1,57 @@ +.TH VIMTUTOR 1 "2001 April 2" +.SH NAME +vimtutor \- the Vim tutor +.SH SYNOPSIS +.br +.B vimtutor [\-g] [language] +.SH DESCRIPTION +.B Vimtutor +starts the +.B Vim +tutor. +It copies the tutor file first, so that it can be modified without changing +the original file. +.PP +The +.B Vimtutor +is useful for people that want to learn their first +.B Vim +commands. +.PP +The optional argument \-g starts vimtutor with gvim rather than vim, if the +GUI version of vim is available, or falls back to Vim if gvim is not found. +.PP +The optional [language] argument is the two-letter name of a language, like +"it" or "es". +If the [language] argument is missing, the language of the current locale will +be used. +If a tutor in this language is available, it will be used. +Otherwise the English version will be used. +.PP +.B Vim +is always started in Vi compatible mode. +.SH FILES +.TP 15 +/usr/local/lib/vim/tutor/tutor[.language] +The +.B Vimtutor +text file(s). +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +The Vim script used to copy the +.B Vimtutor +text file. +.SH AUTHOR +The +.B Vimtutor +was originally written for Vi by Michael C. Pierce and Robert K. Ware, +Colorado School of Mines using ideas supplied by Charles Smith, +Colorado State University. +E-mail: bware@mines.colorado.edu. +.br +It was modified for +.B Vim +by Bram Moolenaar. +For the names of the translators see the tutor files. +.SH SEE ALSO +vim(1) diff --git a/runtime/doc/manpages/xxd.1 b/runtime/doc/manpages/xxd.1 new file mode 100644 index 0000000000..e8f7358591 --- /dev/null +++ b/runtime/doc/manpages/xxd.1 @@ -0,0 +1,370 @@ +.TH XXD 1 "August 1996" "Manual page for 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 NAME +.I xxd +\- make a hexdump or do the reverse. +.SH SYNOPSIS +.B xxd +\-h[elp] +.br +.B xxd +[options] [infile [outfile]] +.br +.B xxd +\-r[evert] [options] [infile [outfile]] +.SH DESCRIPTION +.I xxd +creates a hex dump of a given file or standard input. +It can also convert a hex dump back to its original binary form. +Like +.BR uuencode (1) +and +.BR uudecode (1) +it allows the transmission of binary data in a `mail-safe' ASCII representation, +but has the advantage of decoding to standard output. +Moreover, it can be used to perform binary file patching. +.SH OPTIONS +If no +.I infile +is given, standard input is read. +If +.I infile +is specified as a +.RB \` \- ' +character, then input is taken from standard input. +If no +.I outfile +is given (or a +.RB \` \- ' +character is in its place), results are sent to standard output. +.PP +Note that a "lazy" parser is used which does not check for more than the first +option letter, unless the option is followed by a parameter. +Spaces between a single option letter and its parameter are optional. +Parameters to options can be specified in decimal, hexadecimal or octal +notation. +Thus +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +and +.B \-cols 8 +are all equivalent. +.PP +.TP +.IR \-a " | " \-autoskip +toggle autoskip: A single '*' replaces nul-lines. Default off. +.TP +.IR \-b " | " \-bits +Switch to bits (binary digits) dump, rather than hexdump. +This option writes octets as eight digits "1"s and "0"s instead of a normal +hexadecimal dump. Each line is preceded by a line number in hexadecimal and +followed by an ascii (or ebcdic) representation. The command line switches +\-r, \-p, \-i do not work with this mode. +.TP +.IR "\-c cols " | " \-cols cols" +format +.RI < cols > +octets per line. Default 16 (\-i: 12, \-ps: 30, \-b: 6). Max 256. +.TP +.IR \-E " | " \-EBCDIC +Change the character encoding in the righthand column from ASCII to EBCDIC. +This does not change the hexadecimal representation. The option is +meaningless in combinations with \-r, \-p or \-i. +.TP +.IR "\-g bytes " | " \-groupsize bytes" +separate the output of every +.RI < bytes > +bytes (two hex characters or eight bit-digits each) by a whitespace. +Specify +.I \-g 0 +to suppress grouping. +.RI < Bytes "> defaults to " 2 +in normal mode and \fI1\fP in bits mode. +Grouping does not apply to postscript or include style. +.TP +.IR \-h " | " \-help +print a summary of available commands and exit. No hex dumping is performed. +.TP +.IR \-i " | " \-include +output in C include file style. A complete static array definition is written +(named after the input file), unless xxd reads from stdin. +.TP +.IR "\-l len " | " \-len len" +stop after writing +.RI < len > +octets. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +output in postscript continuous hexdump style. Also known as plain hexdump +style. +.TP +.IR \-r " | " \-revert +reverse operation: convert (or patch) hexdump into binary. +If not writing to stdout, xxd writes into its output file without truncating +it. Use the combination +.I \-r \-p +to read plain hexadecimal dumps without line number information and without a +particular column layout. Additional Whitespace and line-breaks are allowed +anywhere. +.TP +.I \-seek offset +When used after +.IR \-r : +revert with +.RI < offset > +added to file positions found in hexdump. +.TP +.I \-s [+][\-]seek +start at +.RI < seek > +bytes abs. (or rel.) infile offset. +\fI+ \fRindicates that the seek is relative to the current stdin file position +(meaningless when not reading from stdin). \fI\- \fRindicates that the seek +should be that many characters from the end of the input (or if combined with +\fI+\fR: before the current stdin file position). +Without \-s option, xxd starts at the current file position. +.TP +.I \-u +use upper case hex letters. Default is lower case. +.TP +.IR \-v " | " \-version +show version string. +.SH CAVEATS +.PP +.I xxd \-r +has some builtin magic while evaluating line number information. +If the output file is seekable, then the linenumbers at the start of each +hexdump line may be out of order, lines may be missing, or overlapping. In +these cases xxd will lseek(2) to the next position. If the output file is not +seekable, only gaps are allowed, which will be filled by null-bytes. +.PP +.I xxd \-r +never generates parse errors. Garbage is silently skipped. +.PP +When editing hexdumps, please note that +.I xxd \-r +skips everything on the input line after reading enough columns of hexadecimal +data (see option \-c). This also means, that changes to the printable ascii (or +ebcdic) columns are always ignored. Reverting a plain (or postscript) style +hexdump with xxd \-r \-p does not depend on the correct number of columns. Here anything that looks like a pair of hex-digits is interpreted. +.PP +Note the difference between +.br +\fI% xxd \-i file\fR +.br +and +.br +\fI% xxd \-i < file\fR +.PP +.I xxd \-s +seek +may be different from +.IR "xxd \-s seek" , +as lseek(2) is used to "rewind" input. A '+' +makes a difference if the input source is stdin, and if stdin's file position +is not at the start of the file by the time xxd is started and given its input. +The following examples may help to clarify (or further confuse!)... +.PP +Rewind stdin before reading; needed because the `cat' has already read to the +end of stdin. +.br +\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR +.PP +Hexdump from file position 0x480 (=1024+128) onwards. +The `+' sign means "relative to the current position", thus the `128' adds to +the 1k where dd left off. +.br +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fR +.PP +Hexdump from file position 0x100 ( = 1024\-768) on. +.br +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR +.PP +However, this is a rare situation and the use of `+' is rarely needed. +The author prefers to monitor the effect of xxd with strace(1) or truss(1), whenever \-s is used. +.SH EXAMPLES +.PP +.br +Print everything but the first three lines (hex 0x30 bytes) of +.BR file . +.br +\fI% xxd \-s 0x30 file\fR +.PP +.br +Print 3 lines (hex 0x30 bytes) from the end of +.BR file . +.br +\fI% xxd \-s \-0x30 file\fR +.PP +.br +Print 120 bytes as continuous hexdump with 20 octets per line. +.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 +Hexdump the first 120 bytes of this man page with 12 octets per line. +.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 +Display just the date from the 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 +Copy +.B input_file +to +.B output_file +and prepend 100 bytes of value 0x00. +.br +\fI% xxd input_file | xxd \-r \-s 100 > output_file\fR +.br + +.br +Patch the date in the 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 +Create a 65537 byte file with all bytes 0x00, +except for the last one which is 'A' (hex 0x41). +.br +\fI% echo "010000: 41" | xxd \-r > file\fR +.PP +.br +Hexdump this file with 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 +Create a 1 byte file containing a single 'A' character. +The number after '\-r \-s' adds to the linenumbers found in the file; +in effect, the leading bytes are suppressed. +.br +\fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR +.PP +Use xxd as a filter within an editor such as +.B vim(1) +to hexdump a region marked between `a' and `z'. +.br +\fI:'a,'z!xxd\fR +.PP +Use xxd as a filter within an editor such as +.B vim(1) +to recover a binary hexdump marked between `a' and `z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +Use xxd as a filter within an editor such as +.B vim(1) +to recover one line of a hexdump. Move the cursor over the line and type: +.br +\fI!!xxd \-r\fR +.PP +Read single characters from a serial line +.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 "RETURN VALUES" +The following error values are returned: +.TP +0 +no errors encountered. +.TP +\-1 +operation not supported ( +.I xxd \-r \-i +still impossible). +.TP +1 +error while parsing options. +.TP +2 +problems with input file. +.TP +3 +problems with output file. +.TP +4,5 +desired seek position is unreachable. +.SH "SEE ALSO" +uuencode(1), uudecode(1), patch(1) +.br +.SH WARNINGS +The tools weirdness matches its creators brain. +Use entirely at your own risk. Copy files. Trace it. Become a wizard. +.br +.SH VERSION +This manual page documents xxd version 1.7 +.SH AUTHOR +.br +(c) 1990-1997 by 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 +Manual page started by Tony Nugent +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Small changes by Bram Moolenaar. +Edited by Juergen Weigert. +.PP |