VIM

NOM

SYNOPSIS

ex
view
gvim gview evim eview
rvim rview rgvim rgview  

DESCRIPTION

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.

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).

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".

OPTIONS

+[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.

AIDE EN LIGNE

FICHIERS

/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/>  

VOIR AUSSI

AUTEUR

BOGUES

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'.  

TRADUCTION

Index

NOM

SYNOPSIS

DESCRIPTION

OPTIONS

AIDE EN LIGNE

FICHIERS

VOIR AUSSI

AUTEUR

BOGUES

TRADUCTION