vim/runtime/doc/vim-fr.1

.\" Traduction lundi 7 ao<61>t 2000 par Richard Hitier
.\" (richard.hitier@dial.oleane.com)
.\" Mise <20> jour de la traduction par David Blanchet
.\" (david.blanchet@free.fr) 2006-06-10
.\" Mise <20> jour de la traduction par Dominique Pell<6C>
.\" (dominique.pelle@gmail.com) 2013-05-10
.\"
.TH VIM 1 "22 f<>vrier 2002"
.SH NOM
vim \- Vi IMproved, <20>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 <20>diteur de texte proposant une compatibilit<69> ascendante
avec Vi. Il permet d'<27>diter n'importe quel type de texte brut.
Il est particuli<6C>rement adapt<70> pour l'<27>dition des programmes.
.PP
Il comporte de nombreuses am<61>liorations par rapport <20> Vi : annulation sur
plusieurs niveaux, fen<65>tres et tampons multiples, coloration syntaxique,
<EFBFBD>dition en ligne de commande, compl<70>tement des noms de fichiers, aide en
ligne, s<>lection visuelle, etc.
Voir ":help vi_diff.txt" pour un r<>sum<75> des diff<66>rences entre
.B Vim
et Vi.
.PP
Pendant l'ex<65>cution de
.B Vim
\, une aide abondante est accessible au travers du syst<73>me d'aide
en ligne, gr<67>ce <20> la commande ":help".
Voir la section AIDE EN LIGNE plus bas.
.PP
Le plus souvent
.B Vim
est d<>marr<72> pour <20>diter un unique fichier avec la commande
.PP
	vim fichier
.PP
Plus g<>n<EFBFBD>ralement,
.B Vim
est lanc<6E> avec :
.PP
	vim [options] [listefichiers]
.PP
Si la listefichiers est omise, l'<27>diteur d<>marre avec un tampon vide.
Autrement, l'une des quatre m<>thodes suivantes vous permettra de choisir
un ou plusieurs fichiers <20> <20>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<61> sur la premi<6D>re ligne du tampon.
Vous pouvez passer aux autres fichiers avec la commande ":next".
Pour <20>diter un fichier d<>butant par un tiret, faites pr<70>c<EFBFBD>der la
liste de fichiers par "\-\-".
.TP
\-
Le fichier <20> <20>diter est lu sur l'entr<74>e standard (stdin). Les commandes sont
lues depuis stderr, qui devrait <20>tre un terminal.
.TP
\-t {marqueur}
Le fichier <20> <20>diter et la position initiale du curseur d<>pendent
d'un "marqueur", qui est une sorte d'<27>tiquette.
{marqueur} est recherch<63> dans le fichier des marqueurs, le fichier correspondant
devient le fichier courant et la commande associ<63>e est ex<65>cut<75>e.
Principalement utile pour les programmes en C ; dans ce cas, {marqueur}
peut <20>tre le nom d'une fonction.
Au final, le fichier contenant cette fonction devient le fichier
courant et le curseur est plac<61> au d<>but de la fonction.
Voir ":help tag\-commands".
.TP
\-q [fichiererreurs]
D<EFBFBD>marre en mode Mise-au-point (QuickFix).
Le fichier [fichiererreurs] est lu et la premi<6D>re erreur est affich<63>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<73>mes).
La commande ":cn" permet de sauter aux erreurs suivantes.
Voir ":help quickfix".
.PP
.B Vim
se comporte diff<66>remment selon le nom de la commande (l'ex<65>cutable peut
cependant <20>tre le m<>me fichier).
.TP 10
vim
La fa<66>on "normale", le comportement par d<>faut.
.TP
ex
D<EFBFBD>marre en mode Ex.
La commande ":vi" permet de passer en mode Normal.
Ce mode est <20>galement accessible avec l'argument "\-e".
.TP
view
D<EFBFBD>marre en mode Lecture-Seule. Vous <20>tes prot<6F>g<EFBFBD> de l'<27>criture accidentelle
des fichiers. Ce mode est <20>galement accessible avec l'argument "\-R".
.TP
gvim gview
La version graphique.
Ouvre une nouvelle fen<65>tre.
<EFBFBD>galement accessible avec l'argument "\-g".
.TP
evim eview
La version graphique en mode D<>butant (easy).
Ouvre une nouvelle fen<65>tre.
<EFBFBD>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.
<EFBFBD>galement accessible avec l'argument "\-Z".
.SH OPTIONS
Les options peuvent <20>tre sp<73>cifi<66>es dans n'importe quel ordre,
avant ou apr<70>s les noms de fichiers. Les options sans arguments
peuvent <20>tre combin<69>es apr<70>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<61> sur la derni<6E>re ligne.
.TP
+/{motif}
Place le curseur sur la premi<6D>re occurrence de {motif} dans le premier fichier.
Voir ":help search\-pattern" pour conna<6E>tre les motifs de recherches
disponibles.
.TP
+{commande}
.TP
\-c {commande}
Ex<EFBFBD>cute {commande} apr<70>s la lecture du premier fichier.
{commande} est interpr<70>t<EFBFBD>e comme une commande Ex.
Si la {commande} contient des espaces, elle doit <20>tre entour<75>e
de doubles-apostrophes (cela d<>pend du shell utilis<69>).
Exemple : vim "+set si" main.c
.br
Note : vous pouvez utiliser jusqu'<27> 10 commandes "+" ou "\-c".
.TP
\-S {fichier}
Source {fichier} apr<70>s la lecture du premier fichier.
C'est <20>quivalent <20> \-c "source {fichier}".
{fichier} ne peut pas d<>buter par un '\-'.
Si {fichier} est omis, "Session.vim" est utilis<69> (cela ne fonctionne que si
\-S est le dernier argument).
.TP
\-\-cmd {commande}
Comme "\-c", mais la commande est ex<65>cut<75>e juste avant de traiter les fichiers
vimrc.
Vous pouvez utiliser jusqu'<27> 10 de ces commandes, ind<6E>pendamment des
commandes "\-c".
.TP
\-A
Si
.B Vim
a <20>t<EFBFBD> compil<69> avec le support de la fonctionnalit<69> ARABIC pour l'<27>dition de
fichiers de droite <20> gauche et les claviers arabes, cette option lance
.B Vim
en mode Arabe, c.-<2D>-d. que l'option 'arabic' est activ<69>e.
Sinon, un message d'erreur est <20>mis et
.B Vim
quitte.
.TP
\-b
Mode Binaire.
Active plusieurs options pour permettre l'<27>dition
d'un fichier binaire ou ex<65>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<EFBFBD>marre en mode Diff.
Deux, trois ou quatre noms de fichiers doivent <20>tre sp<73>cifi<66>s.
.B Vim
ouvrira alors tous les fichiers et affichera leurs diff<66>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<65>cution de la premi<6D>re commande
d'un script.
.TP
\-e
D<EFBFBD>marre
.B Vim
en mode Ex, comme si l'ex<65>cutable s'appelait "ex".
.TP
\-E
D<EFBFBD>marre
.B Vim
en mode Ex am<61>lior<6F>, comme si l'ex<65>cutable "exim" avait <20>t<EFBFBD> invoqu<71>.
.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 <20>t<EFBFBD> invoqu<71>.
Sur Amiga,
.B Vim
n'est pas relanc<6E> pour ouvrir une nouvelle fen<65>tre.
Cette option est utile quand
.B Vim
est ex<65>cut<75> par un programme qui attend la fin de la session d'<27>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 <20>t<EFBFBD> lanc<6E>.
.TP
\-F
Si
.B Vim
a <20>t<EFBFBD> compil<69> avec le support de la fonctionnalit<69> FKMAP pour l'<27>dition de
fichiers de droite <20> gauche et les claviers farsi, cette option lance
.B Vim
en mode Farsi, c.-<2D>-d. avec les options 'fkmap' et 'rightleft' activ<69>es.
Sinon, un message d'erreur est <20>mis et
.B Vim
quitte.
.TP
\-g
Si
.B Vim
a <20>t<EFBFBD> compil<69> avec le support de l'IHM graphique, cette option active
l'IHM graphique. Si le support n'a pas <20>t<EFBFBD> compil<69>, un message d'erreur
est <20>mis et
.B Vim
quitte.
.TP
\-h
Donne une aide succincte sur les arguments et les options de la ligne de
commande. Apr<70>s cela,
.B Vim
quitte.
.TP
\-H
Si
.B Vim
a <20>t<EFBFBD> compil<69> avec le support de la fonctionnalit<69> RIGHTLEFT pour l'<27>dition de
fichiers de droite <20> gauche et les claviers h<>breux, cette option lance
.B Vim
en mode H<>breu, c.-<2D>-d. avec les options 'hkmap' et 'rightleft' activ<69>es.
Sinon, un message d'erreur est <20>mis et
.B Vim
quitte.
.TP
\-i {viminfo}
Lorsque l'utilisation d'un fichier viminfo est activ<69>e, cette option indique
le nom de fichier <20> utiliser <20> la place de "~/.viminfo" par d<>faut.
Il est possible d'emp<6D>cher l'utilisation d'un fichier ".viminfo", en
sp<EFBFBD>cifiant le nom de fichier "NONE".
.TP
\-L
Comme \-r.
.TP
\-l
Mode Lisp.
Active les options 'lisp' et 'showmatch'.
.TP
\-m
Emp<EFBFBD>che la modification des fichiers.
D<EFBFBD>sactive l'option 'write'.
Vous pouvez toujours modifier le tampon, mais il vous sera impossible
d'<27>crire le fichier.
.TP
\-M
N'autorise aucune modification. les options 'modifiable' et 'write' sont
d<EFBFBD>sactiv<EFBFBD>es, de sorte que les changements ne sont pas autoris<69>s et que les
fichiers ne peuvent pas <20>tre <20>crits. Note : ces options peuvent <20>tre activ<69>es
pour autoriser les modifications.
.TP
\-N
Mode Non-compatible. D<>sactive l'option 'compatible'.
Cela am<61>liorera le comportement de
.B Vim
\, mais il sera moins conforme <20> celui de Vi, m<>me s'il n'existe aucun
fichier ".vimrc".
.TP
\-n
N'utilise pas de fichier d'<27>change (swapfile).
Le recouvrement apr<70>s un plantage sera impossible.
Utile pour <20>diter un fichier sur un support tr<74>s lent (disquette par ex.).
<EFBFBD>galement activable avec ":set uc=0".
Il est possible de l'annuler avec ":set uc=200".
.TP
\-nb
Devient un serveur d'<27>dition pour NetBeans. Consulter la documentation <20> ce
sujet pour davantage de d<>tails.
.TP
\-o[N]
Ouvre N fen<65>tres les unes au-dessus des autres.
Quand N est omis, ouvre une fen<65>tre pour chaque fichier.
.TP
\-O[N]
Ouvre N fen<65>tres c<>te <20> c<>te.
Quand N est omis, ouvre une fen<65>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 <20>diter le tampon, mais il vous sera impossible de
d'<27>craser accidentellement un fichier.
Si vous voulez <20>craser un fichier, ajoutez un point d'exclamation <20> la commande
Ex, comme dans ":w!".
L'option \-R impose l'option \-n (voir ci-dessus).
L'option 'readonly' peut <20>tre d<>sactiv<69>e avec ":set noro".
Voir ":help 'readonly'".
.TP
\-r
Donne la liste des fichiers d'<27>change, avec des informations pour les utiliser
<EFBFBD> des fins de recouvrement.
.TP
\-r {file}
Mode Recouvrement.
Utilise le fichier d'<27>change pour r<>couvrer d'une session d'<27>dition plant<6E>e.
Le fichier d'<27>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<6E> en tant que "ex" ou quand l'option "\-e" a <20>t<EFBFBD> sp<73>cifi<66>e avant
l'option "\-s".
.TP
\-s {scriptEntr<74>e}
Lit le fichier de script {scriptEntr<74>e}.
Les caract<63>res du fichier sont interpr<70>t<EFBFBD>s comme si vous les tapiez.
La commande ":source! {scriptEntr<74>e}" donne le m<>me r<>sultat.
Si la fin du fichier est atteinte avant que l'<27>diteur quitte, les caract<63>res
suivants sont lus depuis le clavier.
.TP
\-T {terminal}
Indique <20>
.B Vim
le nom du terminal utilis<69>.
Cela n'est requis que lorsque la d<>tection automatique <20>choue.
Le {terminal} devrait <20>tre connu de
.B Vim
(int<6E>gr<67>) 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.
<EFBFBD> utiliser pour <20>diter un type de fichiers particulier.
Cela permet aussi d'omettre toute initialisation en sp<73>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<73>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 <20> propos des fichiers sourc<72>s, ainsi que sur la lecture
et les <20>critures dans le fichier viminfo. le nombre optionnel N pr<70>cise la
valeur de l'option 'verbose' (10 par d<>faut).
.TP
\-v
D<EFBFBD>marre
.B Vim
en mode Vi, comme si l'ex<65>cutable s'appelait "vi". Cela n'a d'effet que si
l'ex<65>cutable invoqu<71> est "ex".
.TP
\-w {scriptSortie}
Tous les caract<63>res que vous tapez sont enregistr<74>s dans le fichier
{scriptSortie}, jusqu'<27> ce que vous quittiez
.B Vim.
C'est utile quand vous voulez cr<63>er un fichier de script <20> utiliser avec
"vim \-s" ou ":source!".
Si le fichier {scriptSortie} existe, les caract<63>res sont ajout<75>s <20> la fin.
.TP
\-W {scriptSortie}
Comme \-w, mais un fichier existant sera <20>cras<61>.
.TP
\-x
Chiffre les fichiers lors de l'<27>criture. Une cl<63> de chiffrement sera demand<6E>e.
.TP
\-X
Ne se connecte pas au serveur X. Acc<63>l<EFBFBD>re le temps de d<>marrage dans un
terminal, mais le titre de la fen<65>tre et le presse-papier seront inaccessibles.
.TP
\-y
D<EFBFBD>marre
.B Vim
en mode D<>butant (easy), comme si l'ex<65>cutable s'appelait "evim" ou "eview".
Donne <20>
.B Vim
un comportement plus proche des <20>diteurs <20> cliquez-tapez <20>.
.TP
\-Z
Mode restreint. Fonctionne comme si l'ex<65>cutable commen<65>ait par la lettre 'r'.
.TP
\-\-
D<EFBFBD>limite la fin des options.
Les arguments qui suivent seront consid<69>r<EFBFBD>s comme des noms de fichiers.
Cela permet d'<27>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<74>ralement, sans <20>tendre les
jokers. N'a aucun effet sur Unix, o<> le shell <20>tend les jokers.
.TP
\-\-noplugin
Ne charge pas les greffons. Implicite avec \-u NONE.
.TP
\-\-remote
Se connecte <20> un serveur Vim et lui fait <20>diter les fichiers sp<73>cifi<66>s dans
le reste des arguments. Si aucun serveur n'est trouv<75>, un avertissement est
<EFBFBD>mis et les fichiers sont <20>dit<69>s dans le Vim courant.
.TP
\-\-remote\-expr {expr}
Se connecte <20> un serveur Vim, y <20>value {expr} et affiche le r<>sultat sur la
sortie standard (stdout).
.TP
\-\-remote\-send {touches}
Se connecte <20> un serveur Vim et y envoie {touches}.
.TP
\-\-remote\-silent
Comme \-\-remote, mais sans <20>mettre d'avertissement si aucun serveur n'est
trouv<EFBFBD>.
.TP
\-\-remote\-wait
Comme \-\-remote, mais Vim ne quitte pas tant que le fichier est en cours
d'<27>dition.
.TP
\-\-remote\-wait\-silent
Comme \-\-remote\-wait, mais sans <20>mettre d'avertissement si aucun serveur n'est
trouv<EFBFBD>.
.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<6E> au Vim courant, <20> moins
qu'il ne soit utilis<69> 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<65>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<70>cis.
Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ".
Utiliser <Tab> et CTRL\-D pour compl<70>ter les sujets (":help
cmdline\-completion").
Des marqueurs sont inclus dans l'aide et vous permettent de sauter d'un endroit
<EFBFBD> un autre (comme des liens hypertextes, voir ":help").
L'ensemble des fichiers de la documentation peut <20>tre consult<6C> de cette
fa<EFBFBD>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<70>te.
.TP
/usr/local/lib/vim/doc/tags
Le fichier des marqueurs utilis<69> 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<73>me.
.TP
/usr/local/lib/vim/syntax/*.vim
Fichiers de syntaxe pour diff<66>rents langages.
.TP
/usr/local/lib/vim/vimrc
Initialisation de
.B Vim
pour l'ensemble du syst<73>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<73>me.
.TP
~/.gvimrc
Initialisation de gvim pour votre compte utilisateur.
.TP
/usr/local/lib/vim/optwin.vim
Script utilis<69> pour la commande ":options", une mani<6E>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<73>me.
.TP
/usr/local/lib/vim/bugreport.vim
Script pour g<>n<EFBFBD>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<70>s son nom.
Voir ":help 'filetype'".
.TP
/usr/local/lib/vim/scripts.vim
Script pour d<>tecter le type d'un fichier d'apr<70>s son contenu.
Voir ":help 'filetype'".
.TP
/usr/local/lib/vim/print/*.ps
Fichiers utilis<69>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 <20>t<EFBFBD> <20>crite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs.
Voir ":help credits" dans
.B Vim.
.br
.B Vim
est bas<61> sur Stevie, r<>alis<69> 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<62>mes connus.
.PP
NOTE : Remarquez que bon nombre de points, qui pourraient <20>tre consid<69>r<EFBFBD>s comme
des bugs par certains, sont en fait dus <20> une reproduction trop fid<69>le
du comportement de Vi. Et si vous pensez que d'autres points sont des
bugs "parce que Vi le fait diff<66>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 <20>t<EFBFBD> traduite par Richard Hitier.
<richard.hitier@dial.oleane.com> 2000-08-07.
.br
Cette page de manuel a <20>t<EFBFBD> mise <20> jour par David Blanchet.
<david.blanchet@free.fr> 2006-04-10.
Mise <20> jour 2013-05-10, Dominique Pell<6C> <dominique.pelle@gmail.com>