VIM(1) General Commands Manual VIM(1) NOM vim - Vi IMproved, editeur de texte pour programmeurs SYNOPSIS vim [options] [fichier ...] vim [options] - vim [options] -t marqueur vim [options] -q [fichiererreurs] ex view gvim gview evim eview rvim rview rgvim rgview DESCRIPTION Vim est un editeur de texte proposant une compatibilite ascendante avec Vi. Il permet d'editer n'importe quel type de texte brut. Il est particulierement adapte pour l'edition des programmes. Il comporte de nombreuses ameliorations par rapport a Vi : annulation sur plusieurs niveaux, fenetres et tampons multiples, coloration syntaxique, edition en ligne de commande, completement des noms de fichiers, aide en ligne, selection visuelle, etc. Voir ":help vi_diff.txt" pour un resume des differences entre Vim et Vi. Pendant l'execution de Vim une aide abondante est accessible au travers du systeme d'aide en ligne, grace a la commande ":help". Voir la section AIDE EN LIGNE plus bas. Le plus souvent Vim est demarre pour editer un unique fichier avec la commande vim fichier Plus generalement, Vim est lance avec : vim [options] [listefichiers] Si la listefichiers est omise, l'editeur demarre avec un tampon vide. Autrement, l'une des quatre methodes suivantes vous permettra de choisir un ou plusieurs fichiers a editer. fichier ... Une liste de noms de fichiers. Le premier sera le fichier courant et sera lu dans le tampon. Le curseur sera place sur la premiere ligne du tampon. Vous pouvez passer aux autres fichiers avec la commande ":next". Pour editer un fichier debutant par un tiret, faites preceder la liste de fichiers par "--". - Le fichier a editer est lu sur l'entree standard (stdin). Les commandes sont lues depuis stderr, qui devrait etre un terminal. -t {marqueur} Le fichier a editer et la position initiale du curseur dependent d'un "marqueur", qui est une sorte d'etiquette. {marqueur} est recherche dans le fichier des marqueurs, le fichier correspondant devient le fichier courant et la commande associee est executee. Principalement utile pour les programmes en C ; dans ce cas, {marqueur} peut etre le nom d'une fonction. Au final, le fichier contenant cette fonction devient le fichier courant et le curseur est place au debut de la fonction. Voir ":help tag-commands". -q [fichiererreurs] Demarre en mode Mise-au-point (QuickFix). Le fichier [fichiererreurs] est lu et la premiere erreur est affichee. Si [fichiererreurs] est omis, le nom du fichier est lu dans l'option 'errorfile' ("AztecC.Err" par defaut sur Amiga, "errors.err" sur les autres systemes). La commande ":cn" permet de sauter aux erreurs suivantes. Voir ":help quickfix". Vim se comporte differemment selon le nom de la commande (l'executable peut cependant etre le meme fichier). vim La facon "normale", le comportement par defaut. ex Demarre en mode Ex. La commande ":vi" permet de passer en mode Normal. Ce mode est egalement accessible avec l'argument "-e". view Demarre en mode Lecture-Seule. Vous etes protege de l'ecriture accidentelle des fichiers. Ce mode est egalement accessible avec l'argument "-R". gvim gview La version graphique. Ouvre une nouvelle fenetre. Egalement accessible avec l'argument "-g". evim eview La version graphique en mode Debutant (easy). Ouvre une nouvelle fenetre. Egalement 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. Egalement accessible avec l'argument "-Z". OPTIONS Les options peuvent etre specifiees dans n'importe quel ordre, avant ou apres les noms de fichiers. Les options sans arguments peuvent etre combinees apres un unique tiret. +[num] Place le curseur sur la ligne "num" dans le premier fichier. Si "num" est omis, le curseur sera place sur la derniere ligne. +/{motif} Place le curseur sur la premiere occurrence de {motif} dans le premier fichier. Voir ":help search-pattern" pour connaitre les motifs de recherches disponibles. +{commande} -c {commande} Execute {commande} apres la lecture du premier fichier. {commande} est interpretee comme une commande Ex. Si la {commande} contient des espaces, elle doit etre entouree de doubles-apostrophes (cela depend du shell utilise). Exemple : vim "+set si" main.c Note : vous pouvez utiliser jusqu'a 10 commandes "+" ou "-c". -S {fichier} Source {fichier} apres la lecture du premier fichier. C'est equivalent a -c "source {fichier}". {fichier} ne peut pas debuter par un '-'. Si {fichier} est omis, "Session.vim" est utilise (cela ne fonctionne que si -S est le dernier argument). --cmd {commande} Comme "-c", mais la commande est executee juste avant de traiter les fichiers vimrc. Vous pouvez utiliser jusqu'a 10 de ces commandes, independamment des commandes "-c". -A Si Vim a ete compile avec le support de la fonctionnalite ARABIC pour l'edition de fichiers de droite a gauche et les claviers arabes, cette option lance Vim en mode Arabe, c.-a-d. que l'option 'arabic' est activee. Sinon, un message d'erreur est emis et Vim quitte. -b Mode Binaire. Active plusieurs options pour permettre l'edition d'un fichier binaire ou executable. -C Compatible. Active l'option 'compatible'. Vim se comportera alors quasiment comme Vi, meme s'il existe un fichier .vimrc. -d Demarre en mode Diff. Deux, trois ou quatre noms de fichiers doivent etre specifies. Vim ouvrira alors tous les fichiers et affichera leurs differences. Fonctionne comme vimdiff(1). -d {periph} Ouvre {periph} pour l'utiliser comme terminal. Uniquement sur Amiga. Exemple : "-d con:20/30/600/150". -D Debogage. Passe en mode Debogage lors de l'execution de la premiere commande d'un script. -e Demarre Vim en mode Ex, comme si l'executable s'appelait "ex". -E Demarre Vim en mode Ex ameliore, comme si l'executable "exim" avait ete invoque. -f Premier-plan (Foreground). Pour la version graphique, Vim ne forke pas et ne se detache pas du shell dans lequel il a ete invoque. Sur Amiga, Vim n'est pas relance pour ouvrir une nouvelle fenetre. Cette option est utile quand Vim est execute par un programme qui attend la fin de la session d'edition (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 detachera pas du shell dans lequel il a ete lance. -F Si Vim a ete compile avec le support de la fonctionnalite FKMAP pour l'edition de fichiers de droite a gauche et les claviers farsi, cette option lance Vim en mode Farsi, c.-a-d. avec les options 'fkmap' et 'rightleft' activees. Sinon, un message d'erreur est emis et Vim quitte. -g Si Vim a ete compile avec le support de l'IHM graphique, cette option active l'IHM graphique. Si le support n'a pas ete compile, un message d'erreur est emis et Vim quitte. -h Donne une aide succincte sur les arguments et les options de la ligne de commande. Apres cela, Vim quitte. -H Si Vim a ete compile avec le support de la fonctionnalite RIGHTLEFT pour l'edition de fichiers de droite a gauche et les claviers hebreux, cette option lance Vim en mode Hebreu, c.-a-d. avec les options 'hkmap' et 'rightleft' activees. Sinon, un message d'erreur est emis et Vim quitte. -i {viminfo} Lorsque l'utilisation d'un fichier viminfo est activee, cette option indique le nom de fichier a utiliser a la place de "~/.viminfo" par defaut. Il est possible d'empecher l'utilisation d'un fichier ".viminfo", en specifiant le nom de fichier "NONE". -L Comme -r. -l Mode Lisp. Active les options 'lisp' et 'showmatch'. -m Empeche la modification des fichiers. Desactive l'option 'write'. Vous pouvez toujours modifier le tampon, mais il vous sera impossible d'ecrire le fichier. -M N'autorise aucune modification. les options 'modifiable' et 'write' sont desactivees, de sorte que les changements ne sont pas autorises et que les fichiers ne peuvent pas etre ecrits. Note : ces options peuvent etre activees pour autoriser les modifications. -N Mode Non-compatible. Desactive l'option 'compatible'. Cela ameliorera le comportement de Vim mais il sera moins conforme a celui de Vi, meme s'il n'existe aucun fichier ".vimrc". -n N'utilise pas de fichier d'echange (swapfile). Le recouvrement apres un plantage sera impossible. Utile pour editer un fichier sur un support tres lent (disquette par ex.). Egalement activable avec ":set uc=0". Il est possible de l'annuler avec ":set uc=200". -nb Devient un serveur d'edition pour NetBeans. Consulter la documentation a ce sujet pour davantage de details. -o[N] Ouvre N fenetres les unes au-dessus des autres. Quand N est omis, ouvre une fenetre pour chaque fichier. -O[N] Ouvre N fenetres cote a cote. Quand N est omis, ouvre une fenetre 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 editer le tampon, mais il vous sera impossible de d'ecraser accidentellement un fichier. Si vous voulez ecraser un fichier, ajoutez un point d'exclamation a la commande Ex, comme dans ":w!". L'option -R impose l'option -n (voir ci-dessus). L'option 'readonly' peut etre desactivee avec ":set noro". Voir ":help 'readonly'". -r Donne la liste des fichiers d'echange, avec des informations pour les utiliser a des fins de recouvrement. -r {file} Mode Recouvrement. Utilise le fichier d'echange pour recouvrer d'une session d'edition plantee. Le fichier d'echange est un fichier avec le meme nom que le fichier texte, suivi du suffixe ".swp". Voir ":help recovery". -s Mode Silencieux. Disponible uniquement quand Vim est lance en tant que "ex" ou quand l'option "-e" a ete specifiee avant l'option "-s". -s {scriptEntree} Lit le fichier de script {scriptEntree}. Les caracteres du fichier sont interpretes comme si vous les tapiez. La commande ":source! {scriptEntree}" donne le meme resultat. Si la fin du fichier est atteinte avant que l'editeur quitte, les caracteres suivants sont lus depuis le clavier. -T {terminal} Indique a Vim le nom du terminal utilise. Cela n'est requis que lorsque la detection automatique echoue. Le {terminal} devrait etre connu de Vim (integre) ou defini dans le fichier termcap ou terminfo. -u {vimrc} Utilise les commandes du fichier {vimrc} pour les initialisations. Toutes les autres initialisations sont omises. A utiliser pour editer un type de fichiers particulier. Cela permet aussi d'omettre toute initialisation en specifiant le nom de fichier "NONE". Voir ":help initialization" dans Vim pour davantage de details. -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 specifiant le nom de fichier "NONE". Voir ":help gui-init" dans Vim pour davantage de details. -V[N] Mode Verbeux. Donne des messages a propos des fichiers sources, ainsi que sur la lecture et les ecritures dans le fichier viminfo. le nombre optionnel N precise la valeur de l'option 'verbose' (10 par defaut). -v Demarre Vim en mode Vi, comme si l'executable s'appelait "vi". Cela n'a d'effet que si l'executable invoque est "ex". -w {scriptSortie} Tous les caracteres que vous tapez sont enregistres dans le fichier {scriptSortie}, jusqu'a ce que vous quittiez Vim. C'est utile quand vous voulez creer un fichier de script a utiliser avec "vim -s" ou ":source!". Si le fichier {scriptSortie} existe, les caracteres sont ajoutes a la fin. -W {scriptSortie} Comme -w, mais un fichier existant sera ecrase. -x Chiffre les fichiers lors de l'ecriture. Une cle de chiffrement sera demandee. -X Ne se connecte pas au serveur X. Accelere le temps de demarrage dans un terminal, mais le titre de la fenetre et le presse-papier seront inaccessibles. -y Demarre Vim en mode Debutant (easy), comme si l'executable s'appelait "evim" ou "eview". Donne a Vim un comportement plus proche des editeurs << cliquez-tapez >>. -Z Mode restreint. Fonctionne comme si l'executable commencait par la lettre 'r'. -- Delimite la fin des options. Les arguments qui suivent seront consideres comme des noms de fichiers. Cela permet d'editer des fichiers debutant 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 litteralement, sans etendre les jokers. N'a aucun effet sur Unix, ou le shell etend les jokers. --noplugin Ne charge pas les greffons. Implicite avec -u NONE. --remote Se connecte a un serveur Vim et lui fait editer les fichiers specifies dans le reste des arguments. Si aucun serveur n'est trouve, un avertissement est emis et les fichiers sont edites dans le Vim courant. --remote-expr {expr} Se connecte a un serveur Vim, y evalue {expr} et affiche le resultat sur la sortie standard (stdout). --remote-send {touches} Se connecte a un serveur Vim et y envoie {touches}. --remote-silent Comme --remote, mais sans emettre d'avertissement si aucun serveur n'est trouve. --remote-wait Comme --remote, mais Vim ne quitte pas tant que le fichier est en cours d'edition. --remote-wait-silent Comme --remote-wait, mais sans emettre d'avertissement si aucun serveur n'est trouve. --serverlist Donne la liste des noms de tous les serveurs Vim disponibles. --servername {nom} Utilise {nom} pour le nom de serveur. Ce nom est donne au Vim courant, a moins qu'il ne soit utilise 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 mecanisme GtkPlug pour faire fonctionner gvim dans une autre fenetre. --version Affiche les informations sur la version puis quitte. AIDE EN LIGNE Taper ":help" dans Vim pour commencer. Taper ":help sujet" pour obtenir de l'aide sur un sujet precis. Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ". Utiliser et CTRL-D pour completer les sujets (":help cmdline-completion"). Des marqueurs sont inclus dans l'aide et vous permettent de sauter d'un endroit a un autre (comme des liens hypertextes, voir ":help"). L'ensemble des fichiers de la documentation peut etre consulte de cette facon, par exemple ":help syntax.txt". FICHIERS /usr/share/vim/vim91/doc/*.txt Les fichiers de la documentation de Vim. Utiliser ":help doc-file-list" pour obtenir la liste complete. /usr/share/vim/vim91/doc/tags Le fichier des marqueurs utilise pour trouver les informations dans les fichiers de la documentation. /usr/share/vim/vim91/syntax/syntax.vim Initialisation de la syntaxe pour l'ensemble du systeme. /usr/share/vim/vim91/syntax/*.vim Fichiers de syntaxe pour differents langages. /etc/vimrc Initialisation de Vim pour l'ensemble du systeme. ~/.vimrc Initialisation de Vim de votre compte utilisateur. /etc/gvimrc Initialisation de gvim pour l'ensemble du systeme. ~/.gvimrc Initialisation de gvim pour votre compte utilisateur. /usr/share/vim/vim91/optwin.vim Script utilise pour la commande ":options", une maniere pratique de consulter et de modifier les options. /usr/share/vim/vim91/menu.vim Initialisation des menus de gvim pour l'ensemble du systeme. /usr/share/vim/vim91/bugreport.vim Script pour generer un rapport de bogue. Voir ":help bugs". /usr/share/vim/vim91/filetype.vim Script pour detecter le type d'un fichier d'apres son nom. Voir ":help 'filetype'". /usr/share/vim/vim91/scripts.vim Script pour detecter le type d'un fichier d'apres son contenu. Voir ":help 'filetype'". /usr/share/vim/vim91/print/*.ps Fichiers utilises pour l'impression PostScript. Pour disposer d'informations recentes, consulter le site Internet de VIM : VOIR AUSSI vimtutor(1) AUTEUR La majeure partie de Vim a ete ecrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. Voir ":help credits" dans Vim. Vim est base sur Stevie, realise par Tim Thompson, Tony Andrews et G.R. (Fred) Walter. Toutefois, pratiquement rien du code original ne subsiste. BOGUES Probablement. Voir ":help todo" pour consulter la liste des problemes connus. NOTE : Remarquez que bon nombre de points, qui pourraient etre consideres comme des bugs par certains, sont en fait dus a une reproduction trop fidele du comportement de Vi. Et si vous pensez que d'autres points sont des bugs "parce que Vi le fait differemment", 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 Cette page de manuel a ete traduite par Richard Hitier. 2000-08-07. Cette page de manuel a ete mise a jour par David Blanchet. 2006-04-10. Mise a jour 2013-05-10, Dominique Pelle 22 fevrier 2002 VIM(1)