.\" Traduction lundi 7 aot 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 fvrier 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 particulirement adapt pour l'dition des programmes.
.PP
Il comporte de nombreuses amliorations par rapport  Vi : annulation sur
plusieurs niveaux, fentres et tampons multiples, coloration syntaxique,
dition en ligne de commande, compltement des noms de fichiers, aide en
ligne, slection visuelle, etc.
Voir ":help vi_diff.txt" pour un rsum des diffrences entre
.B Vim
et Vi.
.PP
Pendant l'excution de
.B Vim
\, une aide abondante est accessible au travers du systme d'aide
en ligne, grce  la commande ":help".
Voir la section AIDE EN LIGNE plus bas.
.PP
Le plus souvent
.B Vim
est dmarr pour diter un unique fichier avec la commande
.PP
	vim fichier
.PP
Plus gnralement,
.B Vim
est lanc avec :
.PP
	vim [options] [listefichiers]
.PP
Si la listefichiers est omise, l'diteur dmarre avec un tampon vide.
Autrement, l'une des quatre mthodes 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 premire ligne du tampon.
Vous pouvez passer aux autres fichiers avec la commande ":next".
Pour diter un fichier dbutant par un tiret, faites prcder la
liste de fichiers par "\-\-".
.TP
\-
Le fichier  diter est lu sur l'entre 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 dpendent
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 associe est excute.
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 dbut de la fonction.
Voir ":help tag\-commands".
.TP
\-q [fichiererreurs]
Dmarre en mode Mise-au-point (QuickFix).
Le fichier [fichiererreurs] est lu et la premire erreur est affiche.
Si [fichiererreurs] est omis, le nom du fichier est lu dans
l'option 'errorfile' ("AztecC.Err" par dfaut sur Amiga, "errors.err" sur les
autres systmes).
La commande ":cn" permet de sauter aux erreurs suivantes.
Voir ":help quickfix".
.PP
.B Vim
se comporte diffremment selon le nom de la commande (l'excutable peut
cependant tre le mme fichier).
.TP 10
vim
La faon "normale", le comportement par dfaut.
.TP
ex
Dmarre en mode Ex.
La commande ":vi" permet de passer en mode Normal.
Ce mode est galement accessible avec l'argument "\-e".
.TP
view
Dmarre en mode Lecture-Seule. Vous tes protg de l'criture accidentelle
des fichiers. Ce mode est galement accessible avec l'argument "\-R".
.TP
gvim gview
La version graphique.
Ouvre une nouvelle fentre.
galement accessible avec l'argument "\-g".
.TP
evim eview
La version graphique en mode Dbutant (easy).
Ouvre une nouvelle fentre.
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 spcifies dans n'importe quel ordre,
avant ou aprs les noms de fichiers. Les options sans arguments
peuvent tre combines aprs 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 dernire ligne.
.TP
+/{motif}
Place le curseur sur la premire occurrence de {motif} dans le premier fichier.
Voir ":help search\-pattern" pour connatre les motifs de recherches
disponibles.
.TP
+{commande}
.TP
\-c {commande}
Excute {commande} aprs la lecture du premier fichier.
{commande} est interprte comme une commande Ex.
Si la {commande} contient des espaces, elle doit tre entoure
de doubles-apostrophes (cela dpend du shell utilis).
Exemple : Vim "+set si" main.c
.br
Note : vous pouvez utiliser jusqu' 10 commandes "+" ou "\-c".
.TP
\-S {fichier}
Source {fichier} aprs la lecture du premier fichier.
C'est quivalent  \-c "source {fichier}".
{fichier} ne peut pas dbuter 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 excute juste avant de traiter les fichiers
vimrc.
Vous pouvez utiliser jusqu' 10 de ces commandes, indpendamment 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 active.
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 excutable.
.TP
\-C
Compatible. Active l'option 'compatible'.
.B Vim
se comportera alors quasiment comme Vi, mme s'il existe un fichier .vimrc.
.TP
\-d
Dmarre en mode Diff.
Deux, trois ou quatre noms de fichiers doivent tre spcifis.
.B Vim
ouvrira alors tous les fichiers et affichera leurs diffrences.
Fonctionne comme vimdiff(1).
.TP
\-d {priph}
Ouvre {priph} pour l'utiliser comme terminal.
Uniquement sur Amiga.
Exemple :
"\-d con:20/30/600/150".
.TP
\-D
Debogage. Passe en mode Dbogage lors de l'excution de la premire commande
d'un script.
.TP
\-e
Dmarre
.B Vim
en mode Ex, comme si l'excutable s'appelait "ex".
.TP
\-E
Dmarre
.B Vim
en mode Ex amlior, comme si l'excutable "exim" avait t invoqu.
.TP
\-f
Premier-plan (Foreground). Pour la version graphique,
.B Vim
ne forke pas et ne se dtache pas du shell dans lequel il a t invoqu.
Sur Amiga,
.B Vim
n'est pas relanc pour ouvrir une nouvelle fentre.
Cette option est utile quand
.B Vim
est excut 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 dtachera 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' actives.
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. Aprs 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 hbreux, cette option lance
.B Vim
en mode Hbreu, c.--d. avec les options 'hkmap' et 'rightleft' actives.
Sinon, un message d'erreur est mis et
.B Vim
quitte.
.TP
\-i {viminfo}
Lorsque l'utilisation d'un fichier viminfo est active, cette option indique
le nom de fichier  utiliser  la place de "~/.viminfo" par dfaut.
Il est possible d'empcher l'utilisation d'un fichier ".viminfo", en
spcifiant le nom de fichier "NONE".
.TP
\-L
Comme \-r.
.TP
\-l
Mode Lisp.
Active les options 'lisp' et 'showmatch'.
.TP
\-m
Empche la modification des fichiers.
Dsactive 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
dsactives, de sorte que les changements ne sont pas autoriss et que les
fichiers ne peuvent pas tre crits. Note : ces options peuvent tre actives
pour autoriser les modifications.
.TP
\-N
Mode Non-compatible. Dsactive l'option 'compatible'.
Cela amliorera le comportement de
.B Vim
\, mais il sera moins conforme  celui de Vi, mme s'il n'existe aucun
fichier ".vimrc".
.TP
\-n
N'utilise pas de fichier d'change (swapfile).
Le recouvrement aprs un plantage sera impossible.
Utile pour diter un fichier sur un support trs 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 dtails.
.TP
\-o[N]
Ouvre N fentres les unes au-dessus des autres.
Quand N est omis, ouvre une fentre pour chaque fichier.
.TP
\-O[N]
Ouvre N fentres cte  cte.
Quand N est omis, ouvre une fentre 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 dsactive 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 rcouvrer d'une session d'dition plante.
Le fichier d'change est un fichier avec le mme 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 spcifie avant
l'option "\-s".
.TP
\-s {scriptEntre}
Lit le fichier de script {scriptEntre}.
Les caractres du fichier sont interprts comme si vous les tapiez.
La commande ":source! {scriptEntre}" donne le mme rsultat.
Si la fin du fichier est atteinte avant que l'diteur quitte, les caractres
suivants sont lus depuis le clavier.
.TP
\-T {terminal}
Indique 
.B Vim
le nom du terminal utilis.
Cela n'est requis que lorsque la dtection automatique choue.
Le {terminal} devrait tre connu de
.B Vim
(intgr) ou dfini 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 spcifiant le nom de
fichier "NONE".
Voir ":help initialization" dans Vim pour davantage de dtails.
.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 spcifiant le nom
de fichier "NONE".
Voir ":help gui\-init" dans Vim pour davantage de dtails.
.TP
\-V[N]
Mode Verbeux.
Donne des messages  propos des fichiers sourcs, ainsi que sur la lecture
et les critures dans le fichier viminfo. le nombre optionnel N prcise la
valeur de l'option 'verbose' (10 par dfaut).
.TP
\-v
Dmarre
.B Vim
en mode Vi, comme si l'excutable s'appelait "vi". Cela n'a d'effet que si
l'excutable invoqu est "ex".
.TP
\-w {scriptSortie}
Tous les caractres que vous tapez sont enregistrs dans le fichier
{scriptSortie}, jusqu' ce que vous quittiez
.B Vim.
C'est utile quand vous voulez crer un fichier de script  utiliser avec
"vim \-s" ou ":source!".
Si le fichier {scriptSortie} existe, les caractres sont ajouts  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 demande.
.TP
\-X
Ne se connecte pas au serveur X. Acclre le temps de dmarrage dans un
terminal, mais le titre de la fentre et le presse-papier seront inaccessibles.
.TP
\-y
Dmarre
.B Vim
en mode Dbutant (easy), comme si l'excutable s'appelait "evim" ou "eview".
Donne 
.B Vim
un comportement plus proche des diteurs  cliquez-tapez .
.TP
\-Z
Mode restreint. Fonctionne comme si l'excutable commenait par la lettre 'r'.
.TP
\-\-
Dlimite la fin des options.
Les arguments qui suivent seront considrs comme des noms de fichiers.
Cela permet d'diter des fichiers dbutant 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 littralement, 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 spcifis dans
le reste des arguments. Si aucun serveur n'est trouv, un avertissement est
mis et les fichiers sont dits dans le Vim courant.
.TP
\-\-remote\-expr {expr}
Se connecte  un serveur Vim, y value {expr} et affiche le rsultat 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 mcanisme GtkPlug pour faire
fonctionner gvim dans une autre fentre.
.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 prcis.
Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ".
Utiliser <Tab> et CTRL\-D pour complter 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
faon, 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 complte.
.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 systme.
.TP
/usr/local/lib/vim/syntax/*.vim
Fichiers de syntaxe pour diffrents langages.
.TP
/usr/local/lib/vim/vimrc
Initialisation de
.B Vim
pour l'ensemble du systme.
.TP
~/.vimrc
Initialisation de
.B Vim
de votre compte utilisateur.
.TP
/usr/local/lib/vim/gvimrc
Initialisation de gvim pour l'ensemble du systme.
.TP
~/.gvimrc
Initialisation de gvim pour votre compte utilisateur.
.TP
/usr/local/lib/vim/optwin.vim
Script utilis pour la commande ":options", une manire pratique de consulter
et de modifier les options.
.TP
/usr/local/lib/vim/menu.vim
Initialisation des menus de gvim pour l'ensemble du systme.
.TP
/usr/local/lib/vim/bugreport.vim
Script pour gnrer un rapport de bogue. Voir ":help bugs".
.TP
/usr/local/lib/vim/filetype.vim
Script pour dtecter le type d'un fichier d'aprs son nom.
Voir ":help 'filetype'".
.TP
/usr/local/lib/vim/scripts.vim
Script pour dtecter le type d'un fichier d'aprs son contenu.
Voir ":help 'filetype'".
.TP
/usr/local/lib/vim/print/*.ps
Fichiers utiliss pour l'impression PostScript.
.PP
Pour disposer d'informations rcentes, 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, ralis 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 problmes connus.
.PP
NOTE : Remarquez que bon nombre de points, qui pourraient tre considrs comme
des bugs par certains, sont en fait dus  une reproduction trop fidle
du comportement de Vi. Et si vous pensez que d'autres points sont des
bugs "parce que Vi le fait diffremment", 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>