blob: f79e622a7469f3e33af818b960f85fa1a65ff3c9 [file] [log] [blame]
Bram Moolenaar30b65812012-07-12 22:01:11 +02001.\"*******************************************************************
2.\"
3.\" This file was generated with po4a. Translate the source file.
4.\"
5.\"*******************************************************************
6.\" Translated by bw1 (2008) and Florian Rehnisch <fm-r@gmx.de> (2012)
7.\" Kudos to the folks on vim-dev and debian-l10n-german
8.TH VIM 1 "2006 Apr 11"
9.SH BEZEICHNUNG
10vim \- Vi IMproved, ein Text\-Editor für Programmierer
11.SH ÜBERSICHT
12.br
13\fBvim\fP [Optionen] [Datei …]
14.br
15\fBvim\fP [Optionen] \-
16.br
17\fBvim\fP [Optionen] \-t Tag
18.br
19\fBvim\fP [Optionen] \-q [Fehlerdatei]
20.PP
21.br
22\fBex\fP
23.br
24\fBview\fP
25.br
26\fBgvim\fP \fBgview\fP \fBevim\fP \fBeview\fP
27.br
28\fBrvim\fP \fBrview\fP \fBrgvim\fP \fBrgview\fP
29.SH BESCHREIBUNG
30\fBVim\fP ist ein Text\-Editor, der aufwärtskompatibel zu Vi ist. Er kann
31verwendet werden, um alle Arten von Klartext zu bearbeiten. Er ist besonders
32nützlich, um Programme zu bearbeiten.
33.PP
34Vim hat einige Erweiterungen gegenüber Vi, z.B.: Rückgängigmachen in
35mehreren Schritten, mehrere Fenster und Puffer, Syntax\-Hervorhebung,
36Bearbeiten der Befehlszeile, Dateinamenergänzung, eingebaute Hilfe, visuelle
37Auswahl, usw. Siehe »:help vi_diff.txt« für eine Übersicht der
38Unterschiede zwischen \fBVim\fP und Vi.
39.PP
40Im laufenden \fBVim\fP kann mit dem Befehl »:help« viel Hilfe durch das
41eingebaute Hilfesystem erlangt werden. Siehe den Abschnitt EINGEBAUTE HILFE
42weiter unten.
43.PP
44Meistens wird \fBVim\fP zum Editieren einer einzigen Datei mit dem folgende
45Befehl gestartet:
46.PP
47 vim Datei
48.PP
49Allgemeiner betrachtet, wird \fBVim\fP folgendermaßen gestartet:
50.PP
51 vim [Optionen] [Dateiliste]
52.PP
53Bei einer fehlenden Dateiliste startet der Editor mit einem leeren
54Puffer. Andernfalls werden nach den folgenden vier Möglichkeiten eine oder
55mehrere Dateien bearbeitet:
56.TP 12
57Datei
58Eine Liste von Dateinamen. Die erste Datei wird in den Puffer geladen und
59zur aktuellen. Der Cursor wird auf der ersten Zeile des Puffers
60platziert. Zu den anderen Dateien kann mit dem Befehl »:next« gelangt
61werden. Falls einer der Dateinamen mit einem Bindestrich beginnt, stellen
62Sie der Dateiliste »\-\-« voran.
63.TP
64\-
65Die zu bearbeitende Datei wird von der Standardeingabe gelesen. Befehle
66werden von der Standardfehlerausgabe gelesen, die ein Text\-Terminal sein
67sollte.
68.TP
69\-t {Tag}
70Die zu editierende Datei und die anfängliche Cursor\-Position hängen von
71einem »Tag« ab, einer Art Sprungmarke. {Tag} wird in der Tag\-Datei
72nachgeschlagen, die zugehörige Datei wird zur aktuellen und der zugehörige
73Befehl wird ausgeführt. Dies wird meistens für Programme in der Sprache »C«
74benutzt, wobei {Tag} ein Funktionsname sein könnte. Die Wirkung dieses
75Befehls ist, dass die Datei, die die Funktion enthält, als aktuelle im
76Editor geöffnet und angezeigt wird und der Cursor auf dem Beginn der
77Funktion positioniert wird. Siehe »:help tag\-commands«.
78.TP
79\-q [Fehlerdatei]
80Startet im QuickFix\-Modus. Die Datei [Fehlerdatei] wird gelesen und der
81erste Fehler wird angezeigt. Falls [Fehlerdatei] ausgelassen wird, wird der
82Dateiname aus der Option 'errorfile' verwendet (bei AmigaOS ist dies
83vorgabemäßig »AztecC.Err«, sowie errors.err« bei anderen). Weitere Fehler
84können mit dem »:cn«\-Befehl angesprungen werden. Siehe „:help quickfix«.
85.PP
86\fBVim\fP reagiert unterschiedlich auf den Namen, der verwendet wird, um Vim zu
87starten (die ausführbare Datei kann dieselbe sein).
88.TP 10
89vim
90der »normale« Weg, alles ist standardmäßig
91.TP
92ex
93Startet im Ex\-Modus. Mit dem Befehl »:vi« gelangt man in den normalen
94Modus. Funktioniert auch mit dem Argument »\-e«.
95.TP
96view
97Startet im Nur\-Lesen\-Modus. Die Datei wird vor dem Überschreiben
98geschützt. Dasselbe wird mit dem Parameter »\-R« erreicht.
99.TP
100gvim gview
101Die grafische Version: Öffnet ein neues Fenster. Dasselbe wird mit dem
102Parameter »\-g« erreicht.
103.TP
104evim eview
105Die grafische Version im einfachen Modus: Öffnet ein neues Fenster. Dasselbe
106wird mit dem Parameter »\-y« erreicht.
107.TP
108rvim rview rgvim rgview
109Wie die obigen, aber mit Beschränkungen: Es ist nicht möglich, Shell\-Befehle
110aufzurufen oder mit Unterbrechung in eine Shell zurückzuspringen. Dasselbe
111wird mit dem Parameter »\-Z« erreicht.
112.SH OPTIONEN
113Die Optionen können in beliebiger Reihenfolge vor oder nach den Dateinamen
114angegeben werden. Optionen ohne Parameter können hinter einem einzigen
115Bindestrich gruppiert werden.
116.TP 12
117+[Nummer]
118In der ersten Datei wird der Cursor auf die Zeile [Nummer] gesetzt. Falls
119[Nummer] nicht angegeben wird, wird der Cursor in die letzte Zeile der Datei
120gesetzt.
121.TP
122+/{Suchmuster}
123In der ersten Datei wird der Cursor auf das erste Auftreten von {Suchmuster}
124gesetzt. Siehe »:help search\-pattern«.
125.TP
126+{Befehl}
127.TP
128\-c {Befehl}
129{Befehl} wird nach dem Lesen der ersten Datei ausgeführt. Als {Befehl} wird
130ein Ex\-Befehl erwartet. Sind in {Befehl} Leerzeichen vorhanden, muss alles
131in Anführungszeichen gesetzt werden (hängt von der verwendeten Shell
132ab). Beispiel: vim "+set si" main.c
133.br
134Anmerkung: Sie können bis zu 10 »+«\- oder \-c«\-Befehle verwenden.
135.TP
136\-S {Datei}
137{Datei} wird nach dem Lesen der ersten Datei ausgeführt. Dies entspricht »\-c
138"source {Datei}"«. {Datei} darf nicht mit einem Bindestrich (\-)
139anfangen. Wenn kein Dateiname angegeben wird, wird »Session.vim« verwendet
140(Funktioniert nur, wenn »\-S« als letzter Parameter steht).
141.TP
142\-\-cmd {Befehl}
143Wie »\-c«, aber dieser Befehl wird vor allen VimRC\-Dateien ausgeführt. Sie
144können unabhängig von den »\-c«\-Befehlen bis zu 10 dieser Befehle verwenden.
145.TP
146\-A
147Falls \fBVim\fP mit Unterstützung für das Schreiben von rechts nach links und
148arabischer Tastaturbelegung compiliert wurde (ARABIC), startet dieser
149Parameter den Modus fürs Arabische (:set arabic). Anderenfalls beendet sich
150\fBVim\fP mit einer Fehlermeldung.
151.TP
152b
153Binärer Modus: Es werden einige Variablen gesetzt, sodass es möglich ist,
154eine binäre oder ausführbare Datei zu bearbeiten.
155.TP
156\-C
157Kompatibel: Setzt die Option 'compatible'. Das macht \fBVim\fP im Verhalten
158sehr ähnlich zu Vi, selbst wenn eine VimRC\-Datei existiert.
159.TP
160\-d
161Startet im diff\-Modus. Es sollten zwei, drei oder vier Dateinamen als
162Parameter übergeben werden. \fBVim\fP öffnet sie alle und zeigt die
163Unterschiede an. Arbeitet wie vimdiff(1).
164.TP
165\-d {Gerät}
166Öffnet das {Gerät}, um es als Terminal zu nutzen. Nur für AmigaOS. Beispiel:
167"\-d con:20/30/600/150".
168.TP
169D
170Debug\-Modus: \fBVim\fP geht in den Debug\-Modus, wenn der erste Befehl in einem
171Skript ausgeführt wird.
172.TP
173\-e
174Startet \fBVim\fP im Ex\-Modus, als würde als ausführbare Datei »ex« aufgerufen.
175.TP
176\-E
177Startet \fBVim\fP im erweiterten Ex\-Modus, als würde die ausführbare Datei als
178»exim« aufgerufen.
179.TP
180\-f
181Vordergrund: Bei der GUI\-Version erzeugt \fBVim\fP keinen neuen Prozess und
182löst sich nicht von der Shell, in der er aufgerufen wurde. Bei AmigaOS wird
183kein neues Fenster geöffnet. Dieser Parameter wird benutzt, damit das
184aufrufende Programm auf das Beenden des Bearbeitungssitzung wartet (z.B.:
185mail). Bei AmigaOS funktionieren die Befehle »:sh« und „:!« nicht.
186.TP
187\-\-nofork
188Vordergrund: Bei der GUI\-Version erzeugt \fBVim\fP keinen neuen Prozess und
189löst sich nicht von der Shell, in der er aufgerufen wurde.
190.TP
191\-F
192Wenn \fBVim\fP mit FKMAP\-Unterstützung für das Schreiben von rechts nach links
193und Farsi\-Tastatur\-Belegung kompiliert wurde, startet Vim im Farsi\-Modus,
194d.h. die Optionen 'fkmap' und 'rightleft' werden gesetzt. Andernfalls bricht
195\fBVim\fP mit einer Fehlermeldung ab.
196.TP
197\-g
198Falls \fBVim\fP mit GUI\-Unterstützung kompiliert wurde, wird die GUI
199aktiviert. Falls keine GUI\-Unterstützung einkompiliert wurde, wird mit einer
200Fehlermeldung abgebrochen.
201.TP
202\-h
203Gibt eine kleine Hilfe für die Befehlszeilenparameter aus. Danach beendet
204sich \fBVim.\fP
205.TP
206\-H
207Hebräisch\-Modus, falls \fBVim\fP mit RIGHTLEFT\-Unterstützung für das Schreiben
208von rechts nach links und hebräischer Tastaturbelegung kompiliert wurde,
209werden die Optionen 'hkmap' und 'rightleft' gesetzt. Andernfalls beendet
210sich \fBVim\fP mit einer Fehlermeldung.
211.TP
212\-i {VimInfo}
213Wenn eine VimInfo\-Datei verwendet wird: Verwendet statt »~/.viminfo« die
214angegebene Datei. Es ist auch möglich die Verwendung einer VimInfo\-Datei
215durch Angabe des Dateinamen »NONE« zu verhindern,
216.TP
217\-L
218dasselbe wie »\-r«
219.TP
220\-l
221Lisp\-Modus. Aktiviert die Optionen 'lisp' und 'showmatch'.
222.TP
223\-m
224Deaktiviert das Verändern von Dateien, indem die Option 'write' gelöscht
225wird. Der Puffer kann verändert werden, nur das Schreiben einer Datei ist
226nicht möglich.
227.TP
228\-M
229Keine Veränderungen erlaubt: Die Optionen 'modifiable' und 'write' werden
230gelöscht, so dass Änderungen nicht erlaubt sind und Dateien nicht
231geschrieben werden können. Man beachte, dass diese Optionen ('modifiable',
232\&'write') dennnoch nachträglich zum Erlauben von Änderungen gesetzt werden
233können.
234.TP
235\-N
236Nicht\-kompatibler Modus: Löscht die Option 'compatible'. Dies veranlasst
237\fBVim\fP, sich ein wenig besser, aber weniger Vi\-kompatibel zu verhalten,
238selbst wenn es keine VimRC\-Datei gibt.
239.TP
240\-n
241Verwendet keine Auslagerungsdatei: Eine Wiederherstellung nach einem Absturz
242ist nicht möglich. Auf einem langsamen Medium (Diskette) kann diese
243Einstellung nützlich sein. Kann auch mit »set uc=0« erreicht werden; kann
244mit »set uc=200« aufgehoben werden.
245.TP
246\-nb
247\fBVim\fP fungiert als Server für NetBeans. Details siehe Dokumentation.
248.TP
249\-o[N]
250Öffnet [N] Fenster übereinander. Wenn keine Zahl angegeben wird, öffne ein
251Fenster pro Datei.
252.TP
253\-O[N]
254Öffnet [N] Fenster nebeneinander. Wenn keine Zahl angegeben wird, öffne ein
255Fenster pro Datei.
256.TP
257\-p[N]
258Öffnet [N] Reiterseiten. Wenn keine Zahl angegeben wird, öffne eine
259Reiterseite pro Datei.
260.TP
261\-R
262Nur\-Lesen\-Modus: Die Option 'readonly' wird gesetzt. Der Puffer kann noch
263bearbeitet werden, aber es wird verhindert, eine Datei aus Versehen zu
264überschreiben. Wenn Sie wirklich eine Datei überschreiben wollen, fügen Sie
265dem Ex\-Befehl ein Ausrufezeichen hinzu (wie in »:w!«). Die Option \-R«
266bedingt die Option »\-n« (siehe oben). Die Option 'readonly' kann durch „:set
267noro« gelöscht werden. Siehe »:help 'readonly'«.
268.TP
269\-r
270Listet die Auslagerungsdateien und gibt Informationen zu ihrer
271Verwendbarkeit zur Wiederherstellung.
272.TP
273\-r {Datei}
274Wiederherstellungsmodus: Die Auslagerungsdatei wird zur Wiederherstellung
275verwendet und hat denselben Dateinamen wie die Text\-Datei + ».swp«. Siehe
276„:help recovery«.
277.TP
278\-s
279Der stille Modus: Nur wenn die ausführbare Datei als »ex« aufgerufen wird
280oder vor »\-s« die Option \-e« gegeben wird.
281.TP
282\-s {Eingabeskript}
283Die Datei {Eingabeskript} wird gelesen und ausgeführt, als würden Sie die
284Zeichen in ihr tippen. Dasselbe kann mit dem Befehl »:source!
285{Eingabeskript erreicht werden. Wird das Ende der Datei vor dem Beenden
286des Editors erreicht, werden weitere Zeichen von der Tastatur gelesen.
287.TP
288\-T {Terminal}
289Setzt den Namen des benutzten Terminals. Nur erforderlich, wenn die
290Automatik nicht funktioniert. Sollte ein \fBVim\fP bekanntes Terminal sein:
291(builtin) oder in einer termcap\- oder terminfo\-Datei definiert.
292.TP
293\-u {VimRC}
294Verwendet zur Initialisierung die Befehle in der Datei {VimRC}. Alle anderen
295Initialisierungen werden übersprungen. Benutzen Sie dies, um eine besondere
296Art von Dateien zu bearbeiten. Dies kann auch benutzt werden, um alle
297Initialisierungen zu überspringen, indem der Name »NONE« angegeben wird. Für
298weitere Einzelheiten siehe »:help initialisation« innerhalb von Vim.
299.TP
300\-U {GvimRC}
301Benutzt die Befehle in der Datei {GvimRC} für die Initialisierung der
302grafischen Oberfläche. Alle anderen Initialisierungen werden
303übersprungen. Dies kann ebenfalls benutzt werden, um alle
304GUI\-Initialisierungen zu überspringen, indem der Name »NONE« angegeben
305wird. Siehe »:help gui\-init« innerhalb von Vim für weitere Einzelheiten.
306.TP
307\-V[N]
308Ausführlich (verbose): Gibt Meldungen darüber, welche Befehlsdateien
309eingelesen werden, und über das Lesen und Schreiben einer VimInfo\-Datei. Die
310optionale Zahl N ist der Wert für 'verbose'. Vorgabe ist 10.
311.TP
312\-v
313Startet \fBVim\fP im Vi\-Modus, so als würde die ausführbare Datei mit »vi«
314aufgerufen. Dies wirkt sich nur aus, wenn die ausführbare Datei als »ex«
315aufgerufen wird.
316.TP
317\-w {Ausgabeskript}
318Alle Zeichen, die eingetippt werden, werden in der Datei {Ausgabeskript}
319aufgezeichnet, solange bis Sie \fBVim\fP beenden. Dies ist nützlich, falls Sie
320eine Skript\-Datei zum Benutzen mit »vim \-s« oder „:source erzeugen
321wollen. Falls die Datei {Ausgabeskript} vorhanden ist, werden die Zeichen
322angehängt.
323.TP
324\-W {Ausgabeskript}
325Wie \-w, aber eine bereits vorhandene Datei wird überschrieben.
326.TP
327\-x
328Benutzt beim Schreiben von Dateien eine Verschlüsselung. Fragt nach dem
329Schlüssel.
330.TP
331\-X
332Führt keine Verbindung zum X\-Server durch. Dadurch verkürzt sich die
333Startzeit, aber der Fenstertitel und die Zwischenablage werden nicht
334verwendet.
335.TP
336\-y
337Startet \fBVim\fP im einfachen Modus, als würde die ausführbare Datei mit
338»evim« oder »eview« aufgerufen. \fBVim\fP verhält sich dann wie ein Editor zum
339Klicken und Tippen.
340.TP
341\-Z
342Eingeschränkter Modus: Funktioniert, als würde der Name der ausführbaren
343Datei mit »r« beginnen.
344.TP
345\-\-
346Markiert das Ende der Optionen. Argumente, die folgen, werden als Dateinamen
347behandelt. Dies kann benutzt werden, um einen Dateinamen mit »\-« am Anfang
348zu verwenden.
349.TP
350\-\-echo\-wid
351Nur GTK\-GUI: Schreibe die Fenster\-ID auf die Standardausgabe.
352.TP
353\-\-help
354Gibt eine Hilfe\-Nachricht aus und beendet, wie »\-h«.
355.TP
356\-\-literal
357Nimmt die Dateinamen so wie sie sind und vervollständigt sie nicht nach
358Metazeichen (*,?). Dies wirkt sich nicht unter Unix aus, wo die Shell die
359Metazeichen expandiert.
360.TP
361\-\-noplugin
362Lade keine Plugins. Impliziert durch »\-u NONE«.
363.TP
364\-\-remote
365Verbindet mit einem Vim\-Server und lässt ihn die in den restlichen
366Argumenten angegeben Dateien editieren. Wenn kein Server gefunden wird,
367führt dies zu einer Warnmeldung und die Dateien werden im gegenwärtigen Vim
368zum Bearbeiten geöffnet.
369.TP
370\-\-remote\-expr {Ausdruck}
371Verbindet mit einem Vim\-Server, führt {Ausdruck} aus und zeigt das Ergebnis
372auf der Standardausgabe an.
373.TP
374\-\-remote\-send {Zeichen}
375Verbindet mit einem Vim\-Server und sendet ihm {Zeichen}.
376.TP
377\-\-remote\-silent
378Wie »\-\-remote«, aber ohne Warnung, wenn kein Server gefunden wird.
379.TP
380\-\-remote\-wait
381Wie »\-\-remote«, aber Vim beendet sich nicht, bis die Dateien bearbeitet
382wurden.
383.TP
384\-\-remote\-wait\-silent
385Wie »\-\-remote\-wait«, aber ohne Warnung, wenn kein Server gefunden wird.
386.TP
387\-\-serverlist
388Listet die Namen aller gefundenen Vim\-Server auf.
389.TP
390\-\-servername {Name}
391Benutzt {Name} als Server\-Namen. Wird für den gegenwärtigen Vim benutzt,
392außer es wird mit dem Argument »\-\-remote« benutzt, dann ist es der Name des
393zu kontaktierenden Servers.
394.TP
395\-\-socketid {id}
396Nur GTK\-GUI: Benutzt den GtkPlug\-Mechanismus, um GVim in einem anderen
397Fenster laufen zu lassen.
398.TP
399\-\-version
400Versionsinformation anzeigen und beenden
401.SH "EINGEBAUTE HILFE"
402Tippen Sie in \fBVim\fP »:help«, um zu beginnen. Geben Sie „:help begriff« ein,
403um Hilfe über ein bestimmtes Thema zu bekommen. Zum Beispiel »:help ZZ« für
404Hilfe über den Befehl »ZZ«. Benutzen Sie <Tab> und CTRL\-D, um
405Begriffe zu vervollständigen (»:help cmdline\-completion«). Tags sind
406vorhanden, um von einem Ort zum anderen zu springen (eine Art
407Hypertext\-Verknüpfungen, siehe »:help«). Auf diese Weise können alle
408Dokumentations\-Dateien aufgerufen werden, zum Beispiel »:help syntax.txt«.
409.SH DATEIEN
410.TP 15
411/usr/local/lib/vim/doc/*.txt
412Dokumentations\-Dateien für \fBVim\fP. Verwenden Sie »:help doc\-file\-list«, um
413die gesamte Liste zu bekommen.
414.TP
415/usr/local/lib/vim/doc/tags
416Die »Tag«\-Datei, die verwendet wird, um Informationen in der Dokumentation
417zu finden.
418.TP
419/usr/local/lib/vim/syntax/syntax.vim
420Die systemweite Einrichtung der Syntaxhervorhebung.
421.TP
422/usr/local/lib/vim/syntax/*.vim
423Syntaxdateien für die verschiedenen Sprachen.
424.TP
425/usr/local/lib/vim/vimrc
426Systemweite Einstellungsdatei für \fBVim\fP
427.TP
428~/.vimrc
429Persönliche Einstellungsdatei für \fBVim\fP
430.TP
431/usr/local/lib/vim/gvimrc
432Systemweite Einstellungsdatei für GVim
433.TP
434~/.gvimrc
435Persönliche Einstellungsdatei für GVim
436.TP
437/usr/local/lib/vim/optwin.vim
438Das Script, das von dem Befehl »:options« verwendet wird, eine schöne
439Möglichkeit, um Optionen zu betrachten und zu setzen.
440.TP
441/usr/local/lib/vim/menu.vim
442Systemweite Einstellungsdatei für das Menü von GVim
443.TP
444/usr/local/lib/vim/bugreport.vim
445Das Script zum Generieren eines Fehlerberichts. Siehe »:help bugs«.
446.TP
447/usr/local/lib/vim/filetype.vim
448Mit diesem Script erkennt Vim den Typ einer Datei anhand ihres
449Dateinamens. Siehe »:help 'filetype'«.
450.TP
451/usr/local/lib/vim/scripts.vim
452Mit diesem Script erkennt Vim den Typ einer Datei anhand ihres
453Inhaltes. Siehe »:help 'filetype'«.
454.TP
455/usr/local/lib/vim/print/*.ps
456Diese Dateien werden zum Drucken von PostScript verwendet.
457.PP
458Für die neuesten Informationen lesen Sie die Vim\-Homepage:
459.br
460<URL:http://www.vim.org/>
461.SH "SIEHE AUCH"
462vimtutor(1)
463.SH AUTOR
464\fBVim\fP wurde größtenteils von Bram Moolenaar erstellt, mit viel Hilfe von
465anderen Leuten. Siehe »:help credits« in \fBVim.\fP
466.br
467\fBVim\fP basiert auf Stevie, der von Tim Thompson, Tony Andrews und
468G.R. (Fred) Walter geschrieben wurde. Es ist jedoch kaum etwas vom
469ursprünglichen Code übrig geblieben.
470.SH FEHLER
471Die sind möglich. Siehe »:help todo« für eine Liste bekannter Probleme.
472.PP
473Beachten Sie, dass gewisse Dinge, die manche Leute als Fehler betrachten
474mögen, in Wirklichkeit durch zu getreue Nachbildung des Vi\-Verhaltens
475verursacht werden. Und falls Sie denken, dass andere Dinge Fehler sind,
476»weil Vi es anders tut«, sollten Sie einen genaueren Blick auf die Datei
477vi_diff.txt werfen (oder in Vim »:help vi_diff.txt« tippen). Sehen Sie sich
478auch die Optionen 'compatible' und 'cpoptions' an.