(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) 2008-11-29
vim [options] [fichier ...]
vim [options] -
vim [options] -t marqueur
vim [options] -q [fichiererreurs]
ex
view
gvim gview evim eview
rvim rview rgvim rgview
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 Vim et Vi.
Pendant l'ex�cution de 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.
Le plus souvent Vim est d�marr� pour �diter un unique fichier avec la commande
vim fichier
Plus g�n�ralement, Vim est lanc� avec :
vim [options] [listefichiers]
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.
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 "--".
- Le fichier � �diter est lu sur l'entr�e standard (stdin). Les commandes sont lues depuis stderr, qui devrait �tre un terminal.
-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".
-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".
Vim se comporte diff�remment selon le nom de la commande (l'ex�cutable peut cependant �tre le m�me fichier).
10 vim La fa�on "normale", le comportement par d�faut.
ex D�marre en mode Ex. La commande ":vi" permet de passer en mode Normal. Ce mode est �galement accessible avec l'argument "-e".
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".
gvim gview La version graphique. Ouvre une nouvelle fen�tre. �galement accessible avec l'argument "-g".
evim eview La version graphique en mode D�butant (easy). Ouvre une nouvelle fen�tre. �galement accessible avec l'argument "-y".
rvim rview rgvim rgview Comme ci-dessus, mais avec des restrictions. Il vous sera impossible de lancer des commandes du shell, ou de suspendre Vim. �galement accessible avec l'argument "-Z".
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.
+/{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.
+{commande}
-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
Note : vous pouvez utiliser jusqu'� 10 commandes "+" ou "-c".
-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).
--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".
-A Si 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 Vim en mode Arabe, c.-�-d. que l'option 'arabic' est activ�e. Sinon, un message d'erreur est �mis et Vim quitte.
-b Mode Binaire. Active plusieurs options pour permettre l'�dition d'un fichier binaire ou ex�cutable.
-C Compatible. Active l'option 'compatible'. Vim se comportera alors quasiment comme Vi, m�me s'il existe un fichier .vimrc.
-d D�marre en mode Diff. Deux, trois ou quatre noms de fichiers doivent �tre sp�cifi�s. Vim ouvrira alors tous les fichiers et affichera leurs diff�rences. Fonctionne comme vimdiff(1).
-d {p�riph} Ouvre {p�riph} pour l'utiliser comme terminal. Uniquement sur Amiga. Exemple: "-d con:20/30/600/150".
-D Debogage. Passe en mode D�bogage lors de l'ex�cution de la premi�re commande d'un script.
-e D�marre Vim en mode Ex, comme si l'ex�cutable s'appelait "ex".
-E D�marre Vim en mode Ex am�lior�, comme si l'ex�cutable "exim" avait �t� invoqu�.
-f Premier-plan (Foreground). Pour la version graphique, Vim ne forke pas et ne se d�tache pas du shell dans lequel il a �t� invoqu�. Sur Amiga, Vim n'est pas relanc� pour ouvrir une nouvelle fen�tre. Cette option est utile quand 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.
--nofork Premier-plan (Foreground). Pour la version graphique, Vim ne forkera pas et ne se d�tachera pas du shell dans lequel il a �t� lanc�.
-F Si 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 Vim en mode Farsi, c.-�-d. avec les options 'fkmap' et 'rightleft' activ�es. Sinon, un message d'erreur est �mis et Vim quitte.
-g Si 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 Vim quitte.
-h Donne une aide succincte sur les arguments et les options de la ligne de commande. Apr�s cela, Vim quitte.
-H Si Vim a �t� compil� avec le support de la fonctionnalit� RIGHTLEFT pour l'�dition de fichiers de droite � gauche et les claviers h�breu, cette option lance Vim en mode H�breu, c.-�-d. avec les options 'hkmap' et 'rightleft' activ�es. Sinon, un message d'erreur est �mis et Vim quitte.
-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".
-L Comme -r.
-l Mode Lisp. Active les options 'lisp' et 'showmatch'.
-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.
-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.
-N Mode Non-compatible. D�sactive l'option 'compatible'. Cela am�liorera le comportement de Vim \, mais il sera moins conforme � celui de Vi, m�me s'il n'existe aucun fichier ".vimrc".
-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".
-nb Devient un serveur d'�dition pour NetBeans. Consulter la documentation � ce sujet pour davantage de d�tails.
-o[N] Ouvre N fen�tres les unes au-dessus des autres. Quand N est omis, ouvre une fen�tre pour chaque fichier.
-O[N] Ouvre N fen�tres c�te � c�te. Quand N est omis, ouvre une fen�tre pour chaque fichier fichier.
-p[N] Ouvre N onglets. Quand N est omis, ouvre un onglet pour chaque fichier fichier.
-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'".
-r Donne la liste des fichiers d'�change, avec des informations pour les utiliser � des fins de recouvrement.
-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".
-s Mode Silencieux. Disponible uniquement quand Vim est lanc� en tant que "ex" ou quand l'option "-e" a �t� sp�cifi�e avant l'option "-s".
-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.
-T {terminal} Indique � Vim le nom du terminal utilis�. Cela n'est requis que lorsque la d�tection automatique �choue. Le {terminal} devrait �tre connu de Vim (int�gr�) ou d�fini dans le fichier termcap ou terminfo.
-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.
-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.
-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).
-v D�marre 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".
-w {scriptSortie} Tous les caract�res que vous tapez sont enregistr�s dans le fichier {scriptSortie}, jusqu'� ce que vous quittiez 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.
-W {scriptSortie} Comme -w, mais un fichier existant sera �cras�.
-x Chiffre les fichiers lors de l'�criture. Une cl� de chiffrement sera demand�e.
-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.
-y D�marre Vim en mode D�butant (easy), comme si l'ex�cutable s'appelait "evim" ou "eview". Donne � Vim un comportement plus proche des �diteurs � cliquez-tapez �.
-Z Mode restreint. Fonctionne comme si l'ex�cutable commen�ait par la lettre 'r'.
-- D�limite la fin des options. Les arguments qui suivent seront consid�r�s comme des noms de fichiers. Cela permet d'�diter des fichier d�butant par un '-'.
--echo-wid IHM graphique GTK uniquement : retourne la Window ID sur stdout.
--help Donne un message d'aide et quitte, comme "-h".
--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.
--noplugin Ne charge pas les greffons. Implicite avec -u NONE.
--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.
--remote-expr {expr} Se connecte � un serveur Vim, y �value {expr} et affiche le r�sultat sur la sortie standard (stdout).
--remote-send {touches} Se connecte � un serveur Vim et y envoie {touches}.
--remote-silent Comme --remote, mais sans �mettre d'avertissement si aucun serveur n'est trouv�.
--remote-wait Comme --remote, mais Vim ne quitte pas tant que le fichier est en cours d'�dition.
--remote-wait-silent Comme --remote-wait, mais sans �mettre d'avertissement si aucun serveur n'est trouv�.
--serverlist Donne la liste des noms de tous les serveurs Vim disponibles.
--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.
--socketid {id} IHM graphique GTK+ uniquement : utilise le m�canisme GtkPlug pour faire fonctionner gvim dans une autre fen�tre.
--version Affiche les informations sur la version puis quitte.
15 /usr/local/lib/vim/doc/*.txt Les fichiers de la documentation de Vim. Utiliser ":help doc-file-list" pour obtenir la liste compl�te.
/usr/local/lib/vim/doc/tags Le fichier des marqueurs utilis� pour trouver les informations dans les fichiers de la documentation.
/usr/local/lib/vim/syntax/syntax.vim Initialisation de la syntaxe pour l'ensemble du syst�me.
/usr/local/lib/vim/syntax/*.vim Fichiers de syntaxe pour diff�rents langages.
/usr/local/lib/vim/vimrc Initialisation de Vim pour l'ensemble du syst�me.
~/.vimrc Initialisation de Vim de votre compte utilisateur.
/usr/local/lib/vim/gvimrc Initialisation de gvim pour l'ensemble du syst�me.
~/.gvimrc Initialisation de gvim pour votre compte utilisateur.
/usr/local/lib/vim/optwin.vim Script utilis� pour la commande ":options", une mani�re pratique de consulter et de modifier les options.
/usr/local/lib/vim/menu.vim Initialisation des menus de gvim pour l'ensemble du syst�me.
/usr/local/lib/vim/bugreport.vim Script pour g�n�rer un rapport de bogue. Voir ":help bugs".
/usr/local/lib/vim/filetype.vim Script pour d�tecter le type d'un fichier d'apr�s son nom. Voir ":help 'filetype'".
/usr/local/lib/vim/scripts.vim Script pour d�tecter le type d'un fichier d'apr�s son contenu. Voir ":help 'filetype'".
/usr/local/lib/vim/print/*.ps Fichiers utilis�s pour l'impression PostScript.
Pour disposer d'informations r�centes, consulter le site Internet de VIM :
<URL:http://www.vim.org/>
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.
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'.
Cette page de manuel a �t� mise � jour par David Blanchet. <david.blanchet@free.fr> 2006-04-10.