vim-fr.UTF-8.1 (18232B)
1 .\" Traduction lundi 7 août 2000 par Richard Hitier 2 .\" (richard.hitier@dial.oleane.com) 3 .\" Mise à jour de la traduction par David Blanchet 4 .\" (david.blanchet@free.fr) 2006-06-10 5 .\" Mise à jour de la traduction par Dominique Pellé 6 .\" (dominique.pelle@gmail.com) 2013-05-10 7 .\" 8 .TH VIM 1 "22 février 2002" 9 .SH NOM 10 vim \- Vi IMproved, éditeur de texte pour programmeurs 11 .SH SYNOPSIS 12 .br 13 .B vim 14 [options] [fichier ...] 15 .br 16 .B vim 17 [options] \- 18 .br 19 .B vim 20 [options] \-t marqueur 21 .br 22 .B vim 23 [options] \-q [fichiererreurs] 24 .PP 25 .br 26 .B ex 27 .br 28 .B view 29 .br 30 .B gvim 31 .B gview 32 .B evim 33 .B eview 34 .br 35 .B rvim 36 .B rview 37 .B rgvim 38 .B rgview 39 .SH DESCRIPTION 40 .B Vim 41 est un éditeur de texte proposant une compatibilité ascendante 42 avec Vi. Il permet d'éditer n'importe quel type de texte brut. 43 Il est particulièrement adapté pour l'édition des programmes. 44 .PP 45 Il comporte de nombreuses améliorations par rapport à Vi : annulation sur 46 plusieurs niveaux, fenêtres et tampons multiples, coloration syntaxique, 47 édition en ligne de commande, complètement des noms de fichiers, aide en 48 ligne, sélection visuelle, etc. 49 Voir ":help vi_diff.txt" pour un résumé des différences entre 50 .B Vim 51 et Vi. 52 .PP 53 Pendant l'exécution de 54 .B Vim 55 \, une aide abondante est accessible au travers du système d'aide 56 en ligne, grâce à la commande ":help". 57 Voir la section AIDE EN LIGNE plus bas. 58 .PP 59 Le plus souvent 60 .B Vim 61 est démarré pour éditer un unique fichier avec la commande 62 .PP 63 vim fichier 64 .PP 65 Plus généralement, 66 .B Vim 67 est lancé avec : 68 .PP 69 vim [options] [listefichiers] 70 .PP 71 Si la listefichiers est omise, l'éditeur démarre avec un tampon vide. 72 Autrement, l'une des quatre méthodes suivantes vous permettra de choisir 73 un ou plusieurs fichiers à éditer. 74 .TP 12 75 fichier ... 76 Une liste de noms de fichiers. 77 Le premier sera le fichier courant et sera lu dans le tampon. 78 Le curseur sera placé sur la première ligne du tampon. 79 Vous pouvez passer aux autres fichiers avec la commande ":next". 80 Pour éditer un fichier débutant par un tiret, faites précéder la 81 liste de fichiers par "\-\-". 82 .TP 83 \- 84 Le fichier à éditer est lu sur l'entrée standard (stdin). Les commandes sont 85 lues depuis stderr, qui devrait être un terminal. 86 .TP 87 \-t {marqueur} 88 Le fichier à éditer et la position initiale du curseur dépendent 89 d'un "marqueur", qui est une sorte d'étiquette. 90 {marqueur} est recherché dans le fichier des marqueurs, le fichier correspondant 91 devient le fichier courant et la commande associée est exécutée. 92 Principalement utile pour les programmes en C ; dans ce cas, {marqueur} 93 peut être le nom d'une fonction. 94 Au final, le fichier contenant cette fonction devient le fichier 95 courant et le curseur est placé au début de la fonction. 96 Voir ":help tag\-commands". 97 .TP 98 \-q [fichiererreurs] 99 Démarre en mode Mise-au-point (QuickFix). 100 Le fichier [fichiererreurs] est lu et la première erreur est affichée. 101 Si [fichiererreurs] est omis, le nom du fichier est lu dans 102 l'option 'errorfile' ("AztecC.Err" par défaut sur Amiga, "errors.err" sur les 103 autres systèmes). 104 La commande ":cn" permet de sauter aux erreurs suivantes. 105 Voir ":help quickfix". 106 .PP 107 .B Vim 108 se comporte différemment selon le nom de la commande (l'exécutable peut 109 cependant être le même fichier). 110 .TP 10 111 vim 112 La façon "normale", le comportement par défaut. 113 .TP 114 ex 115 Démarre en mode Ex. 116 La commande ":vi" permet de passer en mode Normal. 117 Ce mode est également accessible avec l'argument "\-e". 118 .TP 119 view 120 Démarre en mode Lecture-Seule. Vous êtes protégé de l'écriture accidentelle 121 des fichiers. Ce mode est également accessible avec l'argument "\-R". 122 .TP 123 gvim gview 124 La version graphique. 125 Ouvre une nouvelle fenêtre. 126 Également accessible avec l'argument "\-g". 127 .TP 128 evim eview 129 La version graphique en mode Débutant (easy). 130 Ouvre une nouvelle fenêtre. 131 Également accessible avec l'argument "\-y". 132 .TP 133 rvim rview rgvim rgview 134 Comme ci-dessus, mais avec des restrictions. Il vous sera impossible de 135 lancer des commandes du shell, ou de suspendre 136 .B Vim. 137 Également accessible avec l'argument "\-Z". 138 .SH OPTIONS 139 Les options peuvent être spécifiées dans n'importe quel ordre, 140 avant ou après les noms de fichiers. Les options sans arguments 141 peuvent être combinées après un unique tiret. 142 .TP 12 143 +[num] 144 Place le curseur sur la ligne "num" dans le premier fichier. 145 Si "num" est omis, le curseur sera placé sur la dernière ligne. 146 .TP 147 +/{motif} 148 Place le curseur sur la première occurrence de {motif} dans le premier fichier. 149 Voir ":help search\-pattern" pour connaître les motifs de recherches 150 disponibles. 151 .TP 152 +{commande} 153 .TP 154 \-c {commande} 155 Exécute {commande} après la lecture du premier fichier. 156 {commande} est interprétée comme une commande Ex. 157 Si la {commande} contient des espaces, elle doit être entourée 158 de doubles-apostrophes (cela dépend du shell utilisé). 159 Exemple : vim "+set si" main.c 160 .br 161 Note : vous pouvez utiliser jusqu'à 10 commandes "+" ou "\-c". 162 .TP 163 \-S {fichier} 164 Source {fichier} après la lecture du premier fichier. 165 C'est équivalent à \-c "source {fichier}". 166 {fichier} ne peut pas débuter par un '\-'. 167 Si {fichier} est omis, "Session.vim" est utilisé (cela ne fonctionne que si 168 \-S est le dernier argument). 169 .TP 170 \-\-cmd {commande} 171 Comme "\-c", mais la commande est exécutée juste avant de traiter les fichiers 172 vimrc. 173 Vous pouvez utiliser jusqu'à 10 de ces commandes, indépendamment des 174 commandes "\-c". 175 .TP 176 \-A 177 Si 178 .B Vim 179 a été compilé avec le support de la fonctionnalité ARABIC pour l'édition de 180 fichiers de droite à gauche et les claviers arabes, cette option lance 181 .B Vim 182 en mode Arabe, c.-à-d. que l'option 'arabic' est activée. 183 Sinon, un message d'erreur est émis et 184 .B Vim 185 quitte. 186 .TP 187 \-b 188 Mode Binaire. 189 Active plusieurs options pour permettre l'édition 190 d'un fichier binaire ou exécutable. 191 .TP 192 \-C 193 Compatible. Active l'option 'compatible'. 194 .B Vim 195 se comportera alors quasiment comme Vi, même s'il existe un fichier .vimrc. 196 .TP 197 \-d 198 Démarre en mode Diff. 199 Deux, trois ou quatre noms de fichiers doivent être spécifiés. 200 .B Vim 201 ouvrira alors tous les fichiers et affichera leurs différences. 202 Fonctionne comme vimdiff(1). 203 .TP 204 \-d {périph} 205 Ouvre {périph} pour l'utiliser comme terminal. 206 Uniquement sur Amiga. 207 Exemple : 208 "\-d con:20/30/600/150". 209 .TP 210 \-D 211 Debogage. Passe en mode Débogage lors de l'exécution de la première commande 212 d'un script. 213 .TP 214 \-e 215 Démarre 216 .B Vim 217 en mode Ex, comme si l'exécutable s'appelait "ex". 218 .TP 219 \-E 220 Démarre 221 .B Vim 222 en mode Ex amélioré, comme si l'exécutable "exim" avait été invoqué. 223 .TP 224 \-f 225 Premier-plan (Foreground). Pour la version graphique, 226 .B Vim 227 ne forke pas et ne se détache pas du shell dans lequel il a été invoqué. 228 Sur Amiga, 229 .B Vim 230 n'est pas relancé pour ouvrir une nouvelle fenêtre. 231 Cette option est utile quand 232 .B Vim 233 est exécuté par un programme qui attend la fin de la session d'édition 234 (par exemple mail). 235 Sur Amiga, les commandes ":sh" et ":!" ne fonctionneront pas. 236 .TP 237 \-\-nofork 238 Premier-plan (Foreground). Pour la version graphique, 239 .B Vim 240 ne forkera pas et ne se détachera pas du shell dans lequel il a été lancé. 241 .TP 242 \-F 243 Si 244 .B Vim 245 a été compilé avec le support de la fonctionnalité FKMAP pour l'édition de 246 fichiers de droite à gauche et les claviers farsi, cette option lance 247 .B Vim 248 en mode Farsi, c.-à-d. avec les options 'fkmap' et 'rightleft' activées. 249 Sinon, un message d'erreur est émis et 250 .B Vim 251 quitte. 252 .TP 253 \-g 254 Si 255 .B Vim 256 a été compilé avec le support de l'IHM graphique, cette option active 257 l'IHM graphique. Si le support n'a pas été compilé, un message d'erreur 258 est émis et 259 .B Vim 260 quitte. 261 .TP 262 \-h 263 Donne une aide succincte sur les arguments et les options de la ligne de 264 commande. Après cela, 265 .B Vim 266 quitte. 267 .TP 268 \-H 269 Si 270 .B Vim 271 a été compilé avec le support de la fonctionnalité RIGHTLEFT pour l'édition de 272 fichiers de droite à gauche et les claviers hébreux, cette option lance 273 .B Vim 274 en mode Hébreu, c.-à-d. avec les options 'hkmap' et 'rightleft' activées. 275 Sinon, un message d'erreur est émis et 276 .B Vim 277 quitte. 278 .TP 279 \-i {viminfo} 280 Lorsque l'utilisation d'un fichier viminfo est activée, cette option indique 281 le nom de fichier à utiliser à la place de "~/.viminfo" par défaut. 282 Il est possible d'empêcher l'utilisation d'un fichier ".viminfo", en 283 spécifiant le nom de fichier "NONE". 284 .TP 285 \-L 286 Comme \-r. 287 .TP 288 \-l 289 Mode Lisp. 290 Active les options 'lisp' et 'showmatch'. 291 .TP 292 \-m 293 Empêche la modification des fichiers. 294 Désactive l'option 'write'. 295 Vous pouvez toujours modifier le tampon, mais il vous sera impossible 296 d'écrire le fichier. 297 .TP 298 \-M 299 N'autorise aucune modification. les options 'modifiable' et 'write' sont 300 désactivées, de sorte que les changements ne sont pas autorisés et que les 301 fichiers ne peuvent pas être écrits. Note : ces options peuvent être activées 302 pour autoriser les modifications. 303 .TP 304 \-N 305 Mode Non-compatible. Désactive l'option 'compatible'. 306 Cela améliorera le comportement de 307 .B Vim 308 \, mais il sera moins conforme à celui de Vi, même s'il n'existe aucun 309 fichier ".vimrc". 310 .TP 311 \-n 312 N'utilise pas de fichier d'échange (swapfile). 313 Le recouvrement après un plantage sera impossible. 314 Utile pour éditer un fichier sur un support très lent (disquette par ex.). 315 Également activable avec ":set uc=0". 316 Il est possible de l'annuler avec ":set uc=200". 317 .TP 318 \-nb 319 Devient un serveur d'édition pour NetBeans. Consulter la documentation à ce 320 sujet pour davantage de détails. 321 .TP 322 \-o[N] 323 Ouvre N fenêtres les unes au-dessus des autres. 324 Quand N est omis, ouvre une fenêtre pour chaque fichier. 325 .TP 326 \-O[N] 327 Ouvre N fenêtres côte à côte. 328 Quand N est omis, ouvre une fenêtre pour chaque fichier fichier. 329 .TP 330 \-p[N] 331 Ouvre N onglets. 332 Quand N est omis, ouvre un onglet pour chaque fichier fichier. 333 .TP 334 \-R 335 Mode Lecture-Seule. 336 Active l'option 'readonly'. 337 Vous pouvez toujours éditer le tampon, mais il vous sera impossible de 338 d'écraser accidentellement un fichier. 339 Si vous voulez écraser un fichier, ajoutez un point d'exclamation à la commande 340 Ex, comme dans ":w!". 341 L'option \-R impose l'option \-n (voir ci-dessus). 342 L'option 'readonly' peut être désactivée avec ":set noro". 343 Voir ":help 'readonly'". 344 .TP 345 \-r 346 Donne la liste des fichiers d'échange, avec des informations pour les utiliser 347 à des fins de recouvrement. 348 .TP 349 \-r {file} 350 Mode Recouvrement. 351 Utilise le fichier d'échange pour récouvrer d'une session d'édition plantée. 352 Le fichier d'échange est un fichier avec le même nom que le fichier texte, 353 suivi du suffixe ".swp". 354 Voir ":help recovery". 355 .TP 356 \-s 357 Mode Silencieux. Disponible uniquement quand 358 .B Vim 359 est lancé en tant que "ex" ou quand l'option "\-e" a été spécifiée avant 360 l'option "\-s". 361 .TP 362 \-s {scriptEntrée} 363 Lit le fichier de script {scriptEntrée}. 364 Les caractères du fichier sont interprétés comme si vous les tapiez. 365 La commande ":source! {scriptEntrée}" donne le même résultat. 366 Si la fin du fichier est atteinte avant que l'éditeur quitte, les caractères 367 suivants sont lus depuis le clavier. 368 .TP 369 \-T {terminal} 370 Indique à 371 .B Vim 372 le nom du terminal utilisé. 373 Cela n'est requis que lorsque la détection automatique échoue. 374 Le {terminal} devrait être connu de 375 .B Vim 376 (intégré) ou défini dans le fichier termcap ou terminfo. 377 .TP 378 \-u {vimrc} 379 Utilise les commandes du fichier {vimrc} pour les initialisations. 380 Toutes les autres initialisations sont omises. 381 À utiliser pour éditer un type de fichiers particulier. 382 Cela permet aussi d'omettre toute initialisation en spécifiant le nom de 383 fichier "NONE". 384 Voir ":help initialization" dans Vim pour davantage de détails. 385 .TP 386 \-U {gvimrc} 387 Utilise les commandes du fichier {gvimrc} pour l'initialisation de l'IHM 388 graphique. 389 Toutes les autres initialisations graphiques sont omises. 390 Cela permet aussi d'omettre toute initialisation graphique en spécifiant le nom 391 de fichier "NONE". 392 Voir ":help gui\-init" dans Vim pour davantage de détails. 393 .TP 394 \-V[N] 395 Mode Verbeux. 396 Donne des messages à propos des fichiers sourcés, ainsi que sur la lecture 397 et les écritures dans le fichier viminfo. le nombre optionnel N précise la 398 valeur de l'option 'verbose' (10 par défaut). 399 .TP 400 \-v 401 Démarre 402 .B Vim 403 en mode Vi, comme si l'exécutable s'appelait "vi". Cela n'a d'effet que si 404 l'exécutable invoqué est "ex". 405 .TP 406 \-w {scriptSortie} 407 Tous les caractères que vous tapez sont enregistrés dans le fichier 408 {scriptSortie}, jusqu'à ce que vous quittiez 409 .B Vim. 410 C'est utile quand vous voulez créer un fichier de script à utiliser avec 411 "vim \-s" ou ":source!". 412 Si le fichier {scriptSortie} existe, les caractères sont ajoutés à la fin. 413 .TP 414 \-W {scriptSortie} 415 Comme \-w, mais un fichier existant sera écrasé. 416 .TP 417 \-x 418 Chiffre les fichiers lors de l'écriture. Une clé de chiffrement sera demandée. 419 .TP 420 \-X 421 Ne se connecte pas au serveur X. Accélère le temps de démarrage dans un 422 terminal, mais le titre de la fenêtre et le presse-papier seront inaccessibles. 423 .TP 424 \-y 425 Démarre 426 .B Vim 427 en mode Débutant (easy), comme si l'exécutable s'appelait "evim" ou "eview". 428 Donne à 429 .B Vim 430 un comportement plus proche des éditeurs « cliquez-tapez ». 431 .TP 432 \-Z 433 Mode restreint. Fonctionne comme si l'exécutable commençait par la lettre 'r'. 434 .TP 435 \-\- 436 Délimite la fin des options. 437 Les arguments qui suivent seront considérés comme des noms de fichiers. 438 Cela permet d'éditer des fichiers débutant par un '\-'. 439 .TP 440 \-\-echo\-wid 441 IHM graphique GTK uniquement : retourne la Window ID sur stdout. 442 .TP 443 \-\-help 444 Donne un message d'aide et quitte, comme "\-h". 445 .TP 446 \-\-literal 447 Prend les arguments de noms de fichiers littéralement, sans étendre les 448 jokers. N'a aucun effet sur Unix, où le shell étend les jokers. 449 .TP 450 \-\-noplugin 451 Ne charge pas les greffons. Implicite avec \-u NONE. 452 .TP 453 \-\-remote 454 Se connecte à un serveur Vim et lui fait éditer les fichiers spécifiés dans 455 le reste des arguments. Si aucun serveur n'est trouvé, un avertissement est 456 émis et les fichiers sont édités dans le Vim courant. 457 .TP 458 \-\-remote\-expr {expr} 459 Se connecte à un serveur Vim, y évalue {expr} et affiche le résultat sur la 460 sortie standard (stdout). 461 .TP 462 \-\-remote\-send {touches} 463 Se connecte à un serveur Vim et y envoie {touches}. 464 .TP 465 \-\-remote\-silent 466 Comme \-\-remote, mais sans émettre d'avertissement si aucun serveur n'est 467 trouvé. 468 .TP 469 \-\-remote\-wait 470 Comme \-\-remote, mais Vim ne quitte pas tant que le fichier est en cours 471 d'édition. 472 .TP 473 \-\-remote\-wait\-silent 474 Comme \-\-remote\-wait, mais sans émettre d'avertissement si aucun serveur n'est 475 trouvé. 476 .TP 477 \-\-serverlist 478 Donne la liste des noms de tous les serveurs Vim disponibles. 479 .TP 480 \-\-servername {nom} 481 Utilise {nom} pour le nom de serveur. Ce nom est donné au Vim courant, à moins 482 qu'il ne soit utilisé avec un argument \-\-remote. Dans ce cas, il s'agit du nom 483 du serveur auquel se connecter. 484 .TP 485 \-\-socketid {id} 486 IHM graphique GTK+ uniquement : utilise le mécanisme GtkPlug pour faire 487 fonctionner gvim dans une autre fenêtre. 488 .TP 489 \-\-version 490 Affiche les informations sur la version puis quitte. 491 .SH AIDE EN LIGNE 492 Taper ":help" dans 493 .B Vim 494 pour commencer. 495 Taper ":help sujet" pour obtenir de l'aide sur un sujet précis. 496 Par exemple : ":help ZZ" pour consulter l'aide sur la commande "ZZ". 497 Utiliser <Tab> et CTRL\-D pour compléter les sujets (":help 498 cmdline\-completion"). 499 Des marqueurs sont inclus dans l'aide et vous permettent de sauter d'un endroit 500 à un autre (comme des liens hypertextes, voir ":help"). 501 L'ensemble des fichiers de la documentation peut être consulté de cette 502 façon, par exemple ":help syntax.txt". 503 .SH FICHIERS 504 .TP 15 505 /usr/local/lib/vim/doc/*.txt 506 Les fichiers de la documentation de 507 .B Vim. 508 Utiliser ":help doc\-file\-list" pour obtenir la liste complète. 509 .TP 510 /usr/local/lib/vim/doc/tags 511 Le fichier des marqueurs utilisé pour trouver les informations dans les 512 fichiers de la documentation. 513 .TP 514 /usr/local/lib/vim/syntax/syntax.vim 515 Initialisation de la syntaxe pour l'ensemble du système. 516 .TP 517 /usr/local/lib/vim/syntax/*.vim 518 Fichiers de syntaxe pour différents langages. 519 .TP 520 /usr/local/lib/vim/vimrc 521 Initialisation de 522 .B Vim 523 pour l'ensemble du système. 524 .TP 525 ~/.vimrc 526 Initialisation de 527 .B Vim 528 de votre compte utilisateur. 529 .TP 530 /usr/local/lib/vim/gvimrc 531 Initialisation de gvim pour l'ensemble du système. 532 .TP 533 ~/.gvimrc 534 Initialisation de gvim pour votre compte utilisateur. 535 .TP 536 /usr/local/lib/vim/optwin.vim 537 Script utilisé pour la commande ":options", une manière pratique de consulter 538 et de modifier les options. 539 .TP 540 /usr/local/lib/vim/menu.vim 541 Initialisation des menus de gvim pour l'ensemble du système. 542 .TP 543 /usr/local/lib/vim/bugreport.vim 544 Script pour générer un rapport de bogue. Voir ":help bugs". 545 .TP 546 /usr/local/lib/vim/filetype.vim 547 Script pour détecter le type d'un fichier d'après son nom. 548 Voir ":help 'filetype'". 549 .TP 550 /usr/local/lib/vim/scripts.vim 551 Script pour détecter le type d'un fichier d'après son contenu. 552 Voir ":help 'filetype'". 553 .TP 554 /usr/local/lib/vim/print/*.ps 555 Fichiers utilisés pour l'impression PostScript. 556 .PP 557 Pour disposer d'informations récentes, consulter le site Internet de VIM : 558 .br 559 <URL:http://www.vim.org/> 560 .SH VOIR AUSSI 561 vimtutor(1) 562 .SH AUTEUR 563 La majeure partie de 564 .B Vim 565 a été écrite par Bram Moolenaar, avec l'aide de nombreux autres contributeurs. 566 Voir ":help credits" dans 567 .B Vim. 568 .br 569 .B Vim 570 est basé sur Stevie, réalisé par Tim Thompson, 571 Tony Andrews et G.R. (Fred) Walter. 572 Toutefois, pratiquement rien du code original ne subsiste. 573 .SH BOGUES 574 Probablement. 575 Voir ":help todo" pour consulter la liste des problèmes connus. 576 .PP 577 NOTE : Remarquez que bon nombre de points, qui pourraient être considérés comme 578 des bugs par certains, sont en fait dus à une reproduction trop fidèle 579 du comportement de Vi. Et si vous pensez que d'autres points sont des 580 bugs "parce que Vi le fait différemment", vous devriez jeter un oeil 581 attentif au fichier vi_diff.txt (ou taper ":help vi_diff.txt" dans Vim). 582 Regardez aussi les options 'compatible' et 'coptions'. 583 .SH TRADUCTION 584 Cette page de manuel a été traduite par Richard Hitier. 585 <richard.hitier@dial.oleane.com> 2000-08-07. 586 .br 587 Cette page de manuel a été mise à jour par David Blanchet. 588 <david.blanchet@free.fr> 2006-04-10. 589 Mise à jour 2013-05-10, Dominique Pellé <dominique.pelle@gmail.com>