Ubuntu Manpage: vim - Vi IMproved, éditeur de texte pour programmeurs

Provided by: vim-common_8.1.2269-1ubuntu5.29_all

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.

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