rgvim

VIM(1)                      General Commands Manual                     VIM(1)



NOM
       vim - Vi IMproved, éditeur 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 éditeur de texte proposant une compatibilité ascendante
       avec Vi. Il permet d'éditer n'importe quel type de texte brut.  Il est
       particulièrement adapté pour l'édition des programmes.

       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
       Les options peuvent être spécifiées dans n'importe quel ordre, avant
       ou après les noms de fichiers. Les options sans arguments peuvent
       être combinées après un unique tiret.

       +[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ébreux, 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 fichiers 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
       Taper ":help" dans Vim pour commencer.  Taper ":help sujet" pour
       obtenir de l'aide sur un sujet précis.  Par exemple : ":help ZZ" pour
       consulter l'aide sur la commande "ZZ".  Utiliser <Tab> et CTRL-D pour
       compléter 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 façon, par
       exemple ":help syntax.txt".

FICHIERS
       /usr/share/vim/vim81/doc/*.txt
                      Les fichiers de la documentation de Vim.  Utiliser
                      ":help doc-file-list" pour obtenir la liste complète.

       /usr/share/vim/vim81/doc/tags
                      Le fichier des marqueurs utilisé pour trouver les
                      informations dans les fichiers de la documentation.

       /usr/share/vim/vim81/syntax/syntax.vim
                      Initialisation de la syntaxe pour l'ensemble du
                      système.

       /usr/share/vim/vim81/syntax/*.vim
                      Fichiers de syntaxe pour différents langages.

       /etc/vimrc     Initialisation de Vim pour l'ensemble du système.

       ~/.vimrc       Initialisation de Vim de votre compte utilisateur.

       /etc/gvimrc    Initialisation de gvim pour l'ensemble du système.

       ~/.gvimrc      Initialisation de gvim pour votre compte utilisateur.

       /usr/share/vim/vim81/optwin.vim
                      Script utilisé pour la commande ":options", une
                      manière pratique de consulter et de modifier les
                      options.

       /usr/share/vim/vim81/menu.vim
                      Initialisation des menus de gvim pour l'ensemble du
                      système.

       /usr/share/vim/vim81/bugreport.vim
                      Script pour générer un rapport de bogue. Voir ":help
                      bugs".

       /usr/share/vim/vim81/filetype.vim
                      Script pour détecter le type d'un fichier d'après son
                      nom.  Voir ":help 'filetype'".

       /usr/share/vim/vim81/scripts.vim
                      Script pour détecter le type d'un fichier d'après son
                      contenu.  Voir ":help 'filetype'".

       /usr/share/vim/vim81/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
       vimtutor(1)

AUTEUR
       La majeure partie de Vim a été écrite par Bram Moolenaar, avec
       l'aide de nombreux autres contributeurs.  Voir ":help credits" dans
       Vim.
       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.

BOGUES
       Probablement.  Voir ":help todo" pour consulter la liste des problèmes
       connus.

       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
       Cette page de manuel a été traduite par Richard Hitier.
       <richard.hitier@dial.oleane.com> 2000-08-07.
       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>



                               22 février 2002                         VIM(1)