Provided by: vim-common_8.2.3995-1ubuntu2.22_all bug

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/vim82/doc/*.txt
                      Les fichiers de la documentation de Vim. Utiliser ":help doc-file-list"  pour  obtenir  la
                      liste complète.

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

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

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

       /usr/share/vim/vimrc
                      Initialisation de Vim pour l'ensemble du système.

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

       /usr/share/vim/gvimrc
                      Initialisation de gvim pour l'ensemble du système.

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

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

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

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

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

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

       /usr/share/vim/vim82/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)