blob: 64e3658d5a23ba770e203ef8705ab09f9c06b5ba [file] [log] [blame]
Bram Moolenaar0b238792006-03-02 22:49:12 +00001.\" Traduction Lundi 7 août 2000 par Richard Hitier
2.\" (richard.hitier@dial.oleane.com)
3.\" Mise à jour de la traduction par David Blanchet
4.\" (david.blanchet@free.fr) 2005-01-17
5.\"
6.TH VIM 1 "22 Février 2002"
7.SH NOM
8vim \- Vi IMproved, éditeur de texte pour programmeurs
9.SH SYNOPSIS
10.br
11.B vim
12[options] [fichier ...]
13.br
14.B vim
15[options] \-
16.br
17.B vim
18[options] \-t marqueur
19.br
20.B vim
21[options] \-q [fichiererreurs]
22.PP
23.br
24.B ex
25.br
26.B view
27.br
28.B gvim
29.B gview
30.B evim
31.B eview
32.br
33.B rvim
34.B rview
35.B rgvim
36.B rgview
37.SH DESCRIPTION
38.B Vim
39est un éditeur de texte proposant une compatibilité ascendante
40avec Vi. Il permet d'éditer n'importe quel type de texte brut.
41Il est particulièrement adapté pour l'édition des programmes.
42.PP
43Il comporte de nombreuses améliorations par rapport à Vi : annulation sur
44plusieurs niveaux, fenêtres et tampons multiples, coloration syntaxique,
45édition en ligne de commande, complètement des noms de fichiers, aide en
46ligne, sélection visuelle, etc.
47Voir ":help vi_diff.txt" pour un résumé des différences entre
48.B Vim
49et Vi.
50.PP
51Pendant l'exécution de
52.B Vim
53\, une aide abondante est accessible au travers du système d'aide
54en ligne, grâce à la commande ":help".
55Voir la section AIDE EN LIGNE plus bas.
56.PP
57Le plus souvent
58.B Vim
59est démarré pour éditer un unique fichier avec la commande
60.PP
61 vim fichier
62.PP
63Plus généralement,
64.B Vim
65est lancé avec :
66.PP
67 vim [options] [listefichiers]
68.PP
69Si la listefichiers est omise, l'éditeur démarre avec un tampon vide.
70Autrement, l'une des quatre méthodes suivantes vous permettra de choisir
71un ou plusieurs fichiers à éditer.
72.TP 12
73fichier ...
74Une liste de noms de fichiers.
75Le premier sera le fichier courant et sera lu dans le tampon.
76Le curseur sera placé sur la première ligne du tampon.
77Vous pouvez passer aux autres fichiers avec la commande ":next".
78Pour éditer un fichier débutant par un tiret, faites précéder la
79liste de fichiers par "\-\-".
80.TP
81\-
82Le fichier à éditer est lu sur l'entrée standard (stdin). Les commandes sont
83lues depuis stderr, qui devrait être un terminal.
84.TP
85\-t {marqueur}
86Le fichier à éditer et la position initiale du curseur dépendent
87d'un "marqueur", qui est une sorte d'étiquette.
88{marqueur} est recherché dans le fichier des marqueurs, le fichier correspondant
89devient le fichier courant et la commande associée est exécutée.
90Principalement utile pour les programmes en C ; dans ce cas, {marqueur}
91peut être le nom d'une fonction.
92Au final, le fichier contenant cette fonction devient le fichier
93courant et le curseur est placé au début de la fonction.
94Voir ":help tag\-commands".
95.TP
96\-q [fichiererreurs]
97Démarre en mode Mise-au-point (QuickFix).
98Le fichier [fichiererreurs] est lu et la première erreur est affichée.
99Si [fichiererreurs] est omis, le nom du fichier est lu dans
100l'option 'errorfile' ("AztecC.Err" par défaut sur Amiga, "errors.err" sur les
101autres systèmes).
102La commande ":cn" permet de sauter aux erreurs suivantes.
103Voir ":help quickfix".
104.PP
105.B Vim
106se comporte différemment selon le nom de la commande (l'exécutable peut
107cependant être le même fichier).
108.TP 10
109vim
110La façon "normale", le comportement par défaut.
111.TP
112ex
113Démarre en mode Ex.
114La commande ":vi" permet de passer en mode Normal.
115Ce mode est également accessible avec l'argument "\-e".
116.TP
117view
118Démarre en mode Lecture-Seule. Vous êtes protégé de l'écriture accidentelle
119des fichiers. Ce mode est également accessible avec l'argument "\-R".
120.TP
121gvim gview
122La version graphique.
123Ouvre une nouvelle fenêtre.
124Également accessible avec l'argument "\-g".
125.TP
126evim eview
127La version graphique en mode Débutant (easy).
128Ouvre une nouvelle fenêtre.
129Également accessible avec l'argument "\-y".
130.TP
131rvim rview rgvim rgview
132Comme ci-dessus, mais avec des restrictions. Il vous sera impossible de
133lancer des commandes du shell, ou de suspendre
134.B Vim.
135Également accessible avec l'argument "\-Z".
136.SH OPTIONS
137Les options peuvent être spécifiées dans n'importe quel ordre,
138avant ou après les noms de fichiers. Les options sans arguments
139peuvent être combinées après un unique tiret.
140.TP 12
141+[num]
142Place le curseur sur la ligne "num" dans le premier fichier.
143Si "num" est omis, le curseur sera placé sur la dernière ligne.
144.TP
145+/{motif}
146Place le curseur sur la première occurence de {motif} dans le premier fichier.
147Voir ":help search\-pattern" pour connaître les motifs de recherches
148disponibles.
149.TP
150+{commande}
151.TP
152\-c {commande}
153Exécute {commande} après la lecture du premier fichier.
154{commande} est interprétée comme une commande Ex.
155Si la {commande} contient des espaces, elle doit être entourée
156de doubles-apostrophes (cela dépend du shell utilisé).
157Exemple: Vim "+set si" main.c
158.br
159Note : vous pouvez utiliser jusqu'à 10 commandes "+" ou "\-c".
160.TP
161\-S {fichier}
162Source {fichier} après la lecture du premier fichier.
163C'est équivalent à \-c "source {fichier}".
164{fichier} ne peut pas débuter par un '\-'.
165Si {fichier} est omis, "Session.vim" est utilisé (cela ne fonctionne que si
166\-S est le dernier argument).
167.TP
168\-\-cmd {commande}
169Comme "\-c", mais la commande est exécutée juste avant de traiter les fichiers
170vimrc.
171Vous pouvez utiliser jusqu'à 10 de ces commandes, indépendamment des
172commandes "\-c".
173.TP
174\-A
175Si
176.B Vim
177a été compilé avec le support de la fonctionnalité ARABIC pour l'édition de
178fichiers de droite à gauche et les claviers arabes, cette option lance
179.B Vim
180en mode Arabe, c.-à-d. que l'option 'arabic' est activée.
181Sinon, un message d'erreur est émis et
182.B Vim
183quitte.
184.TP
185\-b
186Mode Binaire.
187Active plusieurs options pour permettre l'édition
188d'un fichier binaire ou exécutable.
189.TP
190\-C
191Compatible. Active l'option 'compatible'.
192.B Vim
193se comportera alors quasiment comme Vi, même s'il existe un fichier .vimrc.
194.TP
195\-d
196Démarre en mode Diff.
197Deux ou trois noms de fichiers doivent être spécifiés.
198.B Vim
199ouvrira alors tous les fichiers et affichera leurs différences.
200Fonctionne comme vimdiff(1).
201.TP
202\-d {périph}
203Ouvre {périph} pour l'utiliser comme terminal.
204Uniquement sur Amiga.
205Exemple:
206"\-d con:20/30/600/150".
207.TP
208\-D
209Debogage. Passe en mode Débogage lors de l'exécution de la première commande
210d'un script.
211.TP
212\-e
213Démarre
214.B Vim
215en mode Ex, comme si l'exécutable s'appelait "ex".
216.TP
217\-E
218Démarre
219.B Vim
220en mode Ex amélioré, comme si l'exécutable "exim" avait été invoqué.
221.TP
222\-f
223Premier-plan (Foreground). Pour la version graphique,
224.B Vim
225ne forke pas et ne se détache pas du shell dans lequel il a été invoqué.
226Sur Amiga,
227.B Vim
228n'est pas relancé pour ouvrir une nouvelle fenêtre.
229Cette option est utile quand
230.B Vim
231est exécuté par un programme qui attend la fin de la session d'édition
232(par exemple mail).
233Sur Amiga, les commandes ":sh" et ":!" ne fonctionneront pas.
234.TP
235\-\-nofork
236Premier-plan (Foreground). Pour la version graphique,
237.B Vim
238ne forkera pas et ne se détachera pas du shell dans lequel il a été lancé.
239.TP
240\-F
241Si
242.B Vim
243a été compilé avec le support de la fonctionnalité FKMAP pour l'édition de
244fichiers de droite à gauche et les claviers farsi, cette option lance
245.B Vim
246en mode Farsi, c.-à-d. avec les options 'fkmap' et 'rightleft' activées.
247Sinon, un message d'erreur est émis et
248.B Vim
249quitte.
250.TP
251\-g
252Si
253.B Vim
254a été compilé avec le support de l'IHM graphique, cette option active
255l'IHM graphique. Si le support n'a pas été compilé, un message d'erreur
256est émis et
257.B Vim
258quitte.
259.TP
260\-h
261Donne une aide succinte sur les arguments et les options de la ligne de
262commande. Après cela,
263.B Vim
264quitte.
265.TP
266\-H
267Si
268.B Vim
269a été compilé avec le support de la fonctionnalité RIGHTLEFT pour l'édition de
270fichiers de droite à gauche et les claviers hébreu, cette option lance
271.B Vim
272en mode Hebreu, c.-à-d. avec les options 'hkmap' et 'rightleft' activées.
273Sinon, un message d'erreur est émis et
274.B Vim
275quitte.
276.TP
277\-i {viminfo}
278Lorsque l'utilisation d'un fichier viminfo est activée, cette option indique
279le nom de fichier à utiliser à la place de "~/.viminfo" par défaut.
280Il est possible d'empêcher l'utilisation d'un fichier ".viminfo", en
281spécifiant le nom de fichier "NONE".
282.TP
283\-L
284Comme \-r.
285.TP
286\-l
287Mode Lisp.
288Active les options 'lisp' et 'showmatch'.
289.TP
290\-m
291Empêche la modification des fichiers.
292Désactive l'option 'write'.
293Vous pouvez toujours modifier le tampon, mais il vous sera impossible
294d'écrire le fichier.
295.TP
296\-M
297N'autorise aucune modification. les options 'modifiable' et 'write' sont
298desactivées, de sorte que les changements ne sont pas autorisés et que les
299fichiers ne peuvent pas être écrits. Note : ces options peuvent être activées
300pour autoriser les modifications.
301.TP
302\-N
303Mode Non-compatible. Désactive l'option 'compatible'.
304Cela améliorera le comportement de
305.B Vim
306\, mais il sera moins conforme à celui de Vi, même s'il n'existe aucun
307fichier ".vimrc".
308.TP
309\-n
310N'utilise pas de fichier d'échange (swapfile).
311Le recouvrement après un plantage sera impossible.
312Utile pour éditer un fichier sur un support très lent (disquette par ex.).
313Également activable avec ":set uc=0".
314Il est possible de l'annuler avec ":set uc=200".
315.TP
316\-nb
317Devient un serveur d'édition pour NetBeans. Consulter la documentation à ce
318sujet pour davantage de détails.
319.TP
320\-o[N]
321Ouvre N fenêtres les unes au-dessus des autres.
322Quand N est omis, ouvre une fenêtre pour chaque fichier.
323.TP
324\-O[N]
325Ouvre N fenêtres côte à côte.
326Quand N est omis, ouvre une fenêtre pour chaque fichier fichier.
327.TP
328\-R
329Mode Lecture-Seule.
330Active l'option 'readonly'.
331Vous pouvez toujours éditer le tampon, mais il vous sera impossible de
332d'écraser accidentellement un fichier.
333Si vous voulez écraser un fichier, ajoutez un point d'exclamation à la commande
334Ex, comme dans ":w!".
335L'option \-R impose l'option \-n (voir ci-dessus).
336L'option 'readonly' peut être désactivée avec ":set noro".
337Voir ":help 'readonly'".
338.TP
339\-r
340Donne la liste des fichiers d'échange, avec des informations pour les utiliser
341à des fins de recouvrement.
342.TP
343\-r {file}
344Mode Recouvrement.
345Utilise le fichier d'échange pour récouvrer d'une session d'édition plantée.
346Le fichier d'échange est un fichier avec le même nom que le fichier texte,
347suivi du suffixe ".swp".
348Voir ":help recovery".
349.TP
350\-s
351Mode Silencieux. Disponible uniquement quand
352.B Vim
353est lancé en tant que "ex" ou quand l'option "\-e" a été spécifiée avant
354l'option "\-s".
355.TP
356\-s {scriptEntrée}
357Lit le fichier de script {scriptEntrée}.
358Les caractères du fichier sont interprétés comme si vous les tapiez.
359La commande ":source! {scriptEntrée}" donne le même résultat.
360Si la fin du fichier est atteinte avant que l'éditeur quitte, les caractères
361suivants sont lus depuis le clavier.
362.TP
363\-T {terminal}
364Indique à
365.B Vim
366le nom du terminal utilisé.
367Cela n'est requis que lorsque la détection automatique échoue.
368Le {terminal} devrait être connu de
369.B Vim
370(intégré) ou défini dans le fichier termcap ou terminfo.
371.TP
372\-u {vimrc}
373Utilise les commandes du fichier {vimrc} pour les initialisations.
374Toutes les autres initialisations sont omises.
375À utiliser pour éditer un type de fichiers particulier.
376Cela permet aussi d'omettre toute initialisation en spécifiant le nom de
377fichier "NONE".
378Voir ":help initialization" dans Vim pour davantage de détails.
379.TP
380\-U {gvimrc}
381Utilise les commandes du fichier {gvimrc} pour l'initialisation de l'IHM
382graphique.
383Toutes les autres initialisations graphiques sont omises.
384Cela permet aussi d'omettre toute initialisation graphique en spécifiant le nom
385de fichier "NONE".
386Voir ":help gui\-init" dans Vim pour davantage de détails.
387.TP
388\-V[N]
389Mode Verbeux.
390Donne des messages à propos des fichiers sourcés, ainsi que sur la lecture
391et les écritures dans le fichier viminfo. le nombre optionnel N précise la
392valeur de l'option 'verbose' (10 par défaut).
393.TP
394\-v
395Démarre
396.B Vim
397en mode Vi, comme si l'exécutable s'appelait "vi". Cela n'a d'effet que si
398l'exécutable invoqué est "ex".
399.TP
400\-w {scriptSortie}
401Tous les caractères que vous tapez sont enregistrés dans le fichier
402{scriptSortie}, jusqu'à ce que vous quittiez
403.B Vim.
404C'est utile quand vous voulez créer un fichier de script à utiliser avec
405"vim \-s" ou ":source!".
406Si le fichier {scriptSortie} existe, les caractères sont ajoutés à la fin.
407.TP
408\-W {scriptSortie}
409Comme \-w, mais un fichier existant sera écrasé.
410.TP
411\-x
412Chiffre les fichiers lors de l'écriture. Une clé de chiffrement sera demandée.
413.TP
414\-X
415Ne se connecte pas au serveur X. Accélère le temps de démarrage dans un
416terminal, mais le titre de la fenêtre et le presse-papier seront inaccessibles.
417.TP
418\-y
419Démarre
420.B Vim
421en mode Débutant (easy), comme si l'exécutable s'appelait "evim" ou "eview".
422Donne à
423.B Vim
424un comportement plus proche des éditeurs « cliquez-tapez ».
425.TP
426\-Z
427Mode restreint. Fonctionne comme si l'exécutable commençait par la lettre 'r'.
428.TP
429\-\-
430Délimite la fin des options.
431Les arguments qui suivent seront considérés comme des noms de fichiers.
432Cela permet d'éditer des fichier débutant par un '\-'.
433.TP
434\-\-echo\-wid
435IHM graphique GTK uniquement : retourne la Window ID sur stdout.
436.TP
437\-\-help
438Donne un message d'aide et quitte, comme "\-h".
439.TP
440\-\-literal
441Prend les arguments de noms de fichiers littéralement, sans étendre les
442jokers. N'a aucun effet sur Unix, où le shell étend les jokers.
443.TP
444\-\-noplugin
445Ne charge pas les greffons. Implicite avec \-u NONE.
446.TP
447\-\-remote
448Se connecte à un serveur Vim et lui fait éditer les fichiers spécifiés dans
449le reste des arguments. Si aucun serveur n'est trouvé, un avertissement est
450émis et les fichiers sont édités dans le Vim courant.
451.TP
452\-\-remote\-expr {expr}
453Se connecte à un serveur Vim, y évalue {expr} et affiche le résultat sur la
454sortie standard (stdout).
455.TP
456\-\-remote\-send {touches}
457Se connecte à un serveur Vim et y envoie {touches}.
458.TP
459\-\-remote\-silent
460Comme \-\-remote, mais sans émettre d'avertissement si aucun serveur n'est
461trouvé.
462.TP
463\-\-remote\-wait
464Comme \-\-remote, mais Vim ne quitte pas tant que le fichier est en cours
465d'édition.
466.TP
467\-\-remote\-wait\-silent
468Comme \-\-remote\-wait, mais sans émettre d'avertissement si aucun serveur n'est
469trouvé.
470.TP
471\-\-serverlist
472Donne la liste des noms de tous les serveurs Vim disponibles.
473.TP
474\-\-servername {nom}
475Utilise {nom} pour le nom de serveur. Ce nom est donné au Vim courant, à moins
476qu'il ne soit utilisé avec un argument \-\-remote. Dans ce cas, il s'agit du nom
477du serveur auquel se connecter.
478.TP
479\-\-socketid {id}
480IHM graphique GTK+ uniquement : utilise le mécanisme GtkPlug pour faire
481fonctionner gvim dans une autre fenêtre.
482.TP
483\-\-version
484Affiche les informations sur la version puis quitte.
485.SH AIDE EN LIGNE
486Taper ":help" dans
487.B Vim
488pour commencer.
489Taper ":help sujet" pour obtenir de l'aide sur un sujet précis.
490Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ".
491Utiliser <Tab> et CTRL\-D pour compléter les sujets (":help
492cmdline\-completion").
493Des marqueurs sont inclus dans l'aide et vous permettent de sauter d'un endroit
494à un autre (comme des liens hypertextes, voir ":help").
495L'ensemble des fichiers de la documentation peut être consulté de cette
496façon, par exemple ":help syntax.txt".
497.SH FICHIERS
498.TP 15
499/usr/local/lib/vim/doc/*.txt
500Les fichiers de la documentation de
501.B Vim.
502Utiliser ":help doc\-file\-list" pour obtenir la liste complète.
503.TP
504/usr/local/lib/vim/doc/tags
505Le fichier des marqueurs utilisé pour trouver les informations dans les
506fichiers de la documentation.
507.TP
508/usr/local/lib/vim/syntax/syntax.vim
509Initialisation de la syntaxe pour l'ensemble du système.
510.TP
511/usr/local/lib/vim/syntax/*.vim
512Fichiers de syntaxe pour différents langages.
513.TP
514/usr/local/lib/vim/vimrc
515Initialisation de
516.B Vim
517pour l'ensemble du système.
518.TP
519/usr/local/lib/vim/gvimrc
520Initialisation de gvim pour l'ensemble du système.
521.TP
522/usr/local/lib/vim/optwin.vim
523Script utilisé pour la commande ":options", une manière pratique de consulter
524et de modifier les options.
525.TP
526/usr/local/lib/vim/menu.vim
527Initialisation des menus de gvim pour l'ensemble du système.
528.TP
529/usr/local/lib/vim/bugreport.vim
530Script pour générer un rapport de bogue. Voir ":help bugs".
531.TP
532/usr/local/lib/vim/filetype.vim
533Script pour détecter le type d'un fichier d'après son nom.
534Voir ":help 'filetype'".
535.TP
536/usr/local/lib/vim/scripts.vim
537Script pour détecter le type d'un fichier d'après son contenu.
538Voir ":help 'filetype'".
539.TP
540/usr/local/lib/vim/*.ps
541Fichiers utilisés pour l'impression PostScript.
542.PP
543Pour disposer d'informations récentes, consulter le site Internet de VIM :
544.br
545<URL:http://www.vim.org/>
546.SH VOIR AUSSI
547vimtutor(1)
548.SH AUTEUR
549La majeure partie de
550.B Vim
551a été écrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs.
552Voir ":help credits" dans
553.B Vim.
554.br
555.B Vim
556est basé sur Stevie, réalisé par Tim Thompson,
557Tony Andrews et G.R. (Fred) Walter.
558Toutefois, pratiquement rien du code original ne subsiste.
559.SH BOGUES
560Probablement.
561Voir ":help todo" pour consulter la liste des problèmes connus.
562.PP
563NOTE : Remarquez que bon nombre de points, qui pourraient être considérés comme
564des bugs par certains, sont en fait dus à une reproduction trop fidèle
565du comportement de Vi. Et si vous pensez que d'autres points sont des
566bugs "parce que Vi le fait différemment", vous devriez jeter un oeil
567attentif au fichier vi_diff.txt (ou taper ":help vi_diff.txt" dans Vim).
568Regardez aussi les options 'compatible' et 'coptions'.
569.SH TRADUCTION
570Cette page de manuel a été traduite par Richard Hitier.
571<richard.hitier@dial.oleane.com> 2000-08-07.
572.br
573Cette page de manuel a été mise à jour par David Blanchet.
574<david.blanchet@free.fr> 2005-01-17.