vi_diff.txt (59046B)
1 *vi_diff.txt* For Vim version 9.2. Last change: 2026 Jun 22 2 3 4 VIM REFERENCE MANUAL by Bram Moolenaar 5 6 7 Differences between Vim and Vi *vi-differences* 8 9 This file lists the differences between Vim and Vi/Ex and gives an overview of 10 what is in Vim that is not in Vi. 11 12 Vim is mostly POSIX 1003.2-1 compliant. The only command known to be missing 13 is ":open". There are probably a lot of small differences (either because Vim 14 is missing something or because Posix is beside the mark). 15 16 1. Simulated command |simulated-command| 17 2. Missing options |missing-options| 18 3. Limits |limits| 19 4. The most interesting additions |vim-additions| 20 5. Other vim features |other-features| 21 6. Supported Vi features |vi-features| 22 7. Command-line arguments |cmdline-arguments| 23 8. POSIX compliance |posix-compliance| 24 9. Supported Operating Systems |os-support| 25 26 ============================================================================== 27 1. Simulated command *simulated-command* 28 29 This command is in Vi, but Vim only simulates it: 30 31 *:o* *:op* *:open* 32 :[range]o[pen] Works like |:visual|: end Ex mode. 33 {Vi: start editing in open mode} 34 35 :[range]o[pen] /pattern/ As above, additionally move the cursor to the 36 column where "pattern" matches in the cursor 37 line. 38 39 Vim does not support open mode, since it's not really useful. For those 40 situations where ":open" would start open mode Vim will leave Ex mode, which 41 allows executing the same commands, but updates the whole screen instead of 42 only one line. 43 44 ============================================================================== 45 2. Missing options *missing-options* 46 47 These options are in the Unix Vi, but not in Vim. If you try to set one of 48 them you won't get an error message, but the value is not used and cannot be 49 printed. 50 51 autoprint (ap) boolean (default on) *'autoprint'* *'ap'* 52 beautify (bf) boolean (default off) *'beautify'* *'bf'* 53 flash (fl) boolean (default on) *'flash'* *'fl'* 54 graphic (gr) boolean (default off) *'graphic'* *'gr'* 55 hardtabs (ht) number (default 8) *'hardtabs'* *'ht'* 56 number of spaces that a <Tab> moves on the display 57 mesg boolean (default on) *'mesg'* 58 novice boolean (default off) *'novice'* 59 open boolean (default on) *'open'* 60 optimize (op) boolean (default off) *'optimize'* *'op'* 61 redraw boolean (default off) *'redraw'* 62 slowopen (slow) boolean (default off) *'slowopen'* *'slow'* 63 sourceany boolean (default off) *'sourceany'* 64 w300 number (default 23) *'w300'* 65 w1200 number (default 23) *'w1200'* 66 w9600 number (default 23) *'w9600'* 67 68 Vi did not allow for changing the termcap entries, you would have to exit Vi, 69 edit the termcap entry and try again. Vim has the |terminal-options|. 70 71 ============================================================================== 72 3. Limits *limits* 73 74 Vim has only a few limits for the files that can be edited {Vi: can not handle 75 <Nul> characters and characters above 128, has limited line length, many other 76 limits}. 77 78 Maximum line length 2147483647 characters. Longer lines are split. 79 Maximum number of lines 2147483647 lines. 80 Maximum file size 2147483647 bytes (2 Gbyte) when a long integer is 81 32 bits. Much more for 64 bit longs. Also limited 82 by available disk space for the |swap-file|. 83 *E75* 84 Length of a file path Unix and Win32: 1024 characters, otherwise 256 85 characters (or as much as the system supports). 86 Length of an expanded string option 87 Unix and Win32: 1024 characters, otherwise 256 88 characters 89 Maximum display width Unix and Win32: 1024 characters, otherwise 255 90 characters 91 Maximum lhs of a mapping 50 characters. 92 Number of different highlighting types: over 30000 93 Range of a Number variable: -2147483648 to 2147483647 (might be more on 64 94 bit systems) See also: |v:numbermax|, 95 |v:numbermin| and |v:numbersize| 96 Maximum length of a line in a tags file: 512 bytes. 97 *E1541* 98 Maximum value for |/\U| and |/\%U|: 2147483647 (for 32bit integer). 99 100 Information for undo and text in registers is kept in memory, thus when making 101 (big) changes the amount of (virtual) memory available limits the number of 102 undo levels and the text that can be kept in registers. Other things are also 103 kept in memory: Command-line history, error messages for Quickfix mode, etc. 104 105 Memory usage limits 106 ------------------- 107 108 The option 'maxmem' ('mm') is used to set the maximum memory used for one 109 buffer (in kilobytes). 'maxmemtot' is used to set the maximum memory used for 110 all buffers (in kilobytes). The defaults depend on the system used. For the 111 Amiga, 'maxmemtot' is set depending on the amount of memory available. 112 These are not hard limits, but tell Vim when to move text into a swap file. 113 If you don't like Vim to swap to a file, set 'maxmem' and 'maxmemtot' to a 114 very large value. The swap file will then only be used for recovery. If you 115 don't want a swap file at all, set 'updatecount' to 0, or use the "-n" 116 argument when starting Vim. 117 118 ============================================================================== 119 4. The most interesting additions *vim-additions* 120 121 Vi compatibility. 'compatible' 122 Although Vim is 99% Vi compatible, some things in Vi can be 123 considered to be a bug, or at least need improvement. But still, Vim 124 starts in a mode which behaves like the "real" Vi as much as possible. 125 To make Vim behave a little bit better, try resetting the 'compatible' 126 option: > 127 :set nocompatible 128 < Or start Vim with the "-N" argument: > 129 vim -N 130 < Vim starts with 'nocompatible' automatically if you have a .vimrc 131 file. See |startup|. 132 The 'cpoptions' option can be used to set Vi compatibility on/off for 133 a number of specific items. 134 135 Support for different systems. 136 Vim can be used on: 137 - All Unix systems (it works on all systems it was tested on, although 138 the GUI and Perl interface may not work everywhere). 139 - Amiga (500, 1000, 1200, 2000, 3000, 4000, ...). 140 - MS-Windows 141 - VMS 142 - Macintosh 143 - IBM OS/390 144 Note that on some systems features need to be disabled to reduce 145 resource usage. For some outdated systems you need to use an older 146 Vim version. 147 148 Multi level persistent undo. |undo| 149 'u' goes backward in time, 'CTRL-R' goes forward again. Set option 150 'undolevels' to the number of changes to be remembered (default 1000). 151 Set 'undolevels' to 0 for a Vi-compatible one level undo. Set it to 152 -1 for no undo at all. 153 When all changes in a buffer have been undone, the buffer is not 154 considered changed anymore. You can exit it with :q, without <!>. 155 When undoing a few changes and then making a new change Vim will 156 create a branch in the undo tree. This means you can go back to any 157 state of the text, there is no risk of a change causing text to be 158 lost forever. |undo-tree| 159 The undo information is stored in a file when the 'undofile' option is 160 set. This means you can exit Vim, start Vim on a previously edited 161 file and undo changes that were made before exiting Vim. 162 163 Graphical User Interface (GUI). |gui| 164 Included support for GUI: menu's, mouse, scrollbars, etc. You can 165 define your own menus. Better support for CTRL/SHIFT/ALT keys in 166 combination with special keys and mouse. Supported for various 167 platforms, such as X11 with Motif, GTK, Win32 (Windows XP and later), 168 Amiga and Macintosh. 169 170 Multiple windows and buffers. |windows.txt| 171 Vim can split the screen into several windows, each editing a 172 different buffer or the same buffer at a different location. Buffers 173 can still be loaded (and changed) but not displayed in a window. This 174 is called a hidden buffer. Many commands and options have been added 175 for this facility. 176 Vim can also use multiple tab pages, each with one or more windows. A 177 line with tab labels can be used to quickly switch between these 178 pages. 179 |tab-page| 180 181 Terminal window. |:terminal| 182 Vim can create a window in which a terminal emulator runs. This can 183 be used to execute an arbitrary command, a shell or a debugger. 184 185 Syntax highlighting. |:syntax| 186 Vim can highlight keywords, patterns and other things. This is 187 defined by a number of |:syntax| commands, and can be made to 188 highlight most languages and file types. A number of files are 189 included for highlighting the most common languages, like C, C++, 190 Java, Pascal, Makefiles, shell scripts, etc. The colors used for 191 highlighting can be defined for ordinary terminals, color terminals 192 and the GUI with the |:highlight| command. A convenient way to do 193 this is using a |:colorscheme| command. 194 The highlighted text can be exported as HTML. |convert-to-HTML| 195 Other items that can be highlighted are matches with the search string 196 'hlsearch', matching parens |matchparen| and the cursor line and 197 column 'cursorline' 'cursorcolumn'. 198 199 Text properties |textprop.txt| 200 Vim supports highlighting text by a plugin. Property types can be 201 specified with |prop_type_add()| and properties can be placed with 202 |prop_add()|. 203 204 Spell checking. |spell| 205 When the 'spell' option is set Vim will highlight spelling mistakes. 206 About 50 languages are currently supported, selected with the 207 'spelllang' option. In source code only comments and strings are 208 checked for spelling. 209 210 Folding. |folding| 211 A range of lines can be shown as one "folded" line. This allows 212 overviewing a file and moving blocks of text around quickly. 213 Folds can be created manually, from the syntax of the file, by indent, 214 etc. 215 216 Diff mode. |diff| 217 Vim can show two versions of a file with the differences highlighted. 218 Parts of the text that are equal are folded away. Commands can be 219 used to move text from one version to the other. 220 221 Plugins. |add-plugin| 222 The functionality can be extended by dropping a plugin file in the 223 right directory. That's an easy way to start using Vim scripts 224 written by others. Plugins can be for all kind of files, or 225 specifically for a filetype. 226 Packages make this even easier. |packages| 227 228 Asynchronous communication and timers. |channel| |job| |timer| 229 Vim can exchange messages with other processes in the background. 230 This makes it possible to have servers do work and send back the 231 results to Vim. |channel| 232 Vim can start a job, communicate with it and stop it. |job| 233 Timers can fire once or repeatedly and invoke a function to do any 234 work. |timer| 235 236 Repeat a series of commands. |q| 237 "q{c}" starts recording typed characters into named register {c}. 238 A subsequent "q" stops recording. The register can then be executed 239 with the "@{c}" command. This is very useful to repeat a complex 240 action. 241 242 Flexible insert mode. |ins-special-special| 243 The arrow keys can be used in insert mode to move around in the file. 244 This breaks the insert in two parts as far as undo and redo is 245 concerned. 246 247 CTRL-O can be used to execute a single Normal mode command. This is 248 almost the same as hitting <Esc>, typing the command and doing |a|. 249 250 Visual mode. |Visual-mode| 251 Visual mode can be used to first highlight a piece of text and then 252 give a command to do something with it. This is an (easy to use) 253 alternative to first giving the operator and then moving to the end of 254 the text to be operated upon. 255 |v| and |V| are used to start Visual mode. |v| works on characters 256 and |V| on lines. Move the cursor to extend the Visual area. It is 257 shown highlighted on the screen. By typing "o" the other end of the 258 Visual area can be moved. The Visual area can be affected by an 259 operator: 260 d delete 261 c change 262 y yank 263 > or < insert or delete indent 264 ! filter through external program 265 = filter through indent 266 : start |:| command for the Visual lines. 267 gq format text to 'textwidth' columns 268 J join lines 269 ~ swap case 270 u make lowercase 271 U make uppercase 272 {Vi has no Visual mode, the name "visual" is used for Normal mode, to 273 distinguish it from Ex mode} 274 275 Block operators. |visual-block| 276 With Visual mode a rectangular block of text can be selected. Start 277 Visual mode with CTRL-V. The block can be deleted ("d"), yanked ("y") 278 or its case can be changed ("~", "u" and "U"). A deleted or yanked 279 block can be put into the text with the "p" and "P" commands. 280 281 Help system. |:help| 282 Help is displayed in a window. The usual commands can be used to 283 move around, search for a string, etc. Tags can be used to jump 284 around in the help files, just like hypertext links. The |:help| 285 command takes an argument to quickly jump to the info on a subject. 286 <F1> is the quick access to the help system. The name of the help 287 index file can be set with the 'helpfile' option. 288 289 Command-line editing and history. |cmdline-editing| 290 You can insert or delete at any place in the command-line using the 291 cursor keys. The right/left cursor keys can be used to move 292 forward/backward one character. The shifted right/left cursor keys 293 can be used to move forward/backward one word. CTRL-B/CTRL-E can be 294 used to go to the begin/end of the command-line. 295 {Vi: can only alter the last character in the line} 296 {Vi: when hitting <Esc> the command-line is executed. This is 297 unexpected for most people; therefore it was changed in Vim. But when 298 the <Esc> is part of a mapping, the command-line is executed. If you 299 want the Vi behaviour also when typing <Esc>, use ":cmap ^V<Esc> 300 ^V^M"} 301 |cmdline-history| 302 The command-lines are remembered. The up/down cursor keys can be used 303 to recall previous command-lines. The 'history' option can be set to 304 the number of lines that will be remembered. There is a separate 305 history for commands and for search patterns. 306 307 Command-line completion. |cmdline-completion| 308 While entering a command-line (on the bottom line of the screen) 309 <Tab> can be typed to complete 310 what example ~ 311 - command :e<Tab> 312 - tag :ta scr<Tab> 313 - option :set sc<Tab> 314 - option value :set hf=<Tab> 315 - file name :e ve<Tab> 316 - etc. 317 318 If there are multiple matches, CTRL-N (next) and CTRL-P (previous) 319 will walk through the matches. <Tab> works like CTRL-N, but wraps 320 around to the first match. 321 322 The 'wildchar' option can be set to the character for command-line 323 completion, <Tab> is the default. CTRL-D can be typed after an 324 (incomplete) wildcard; all matches will be listed. CTRL-A will insert 325 all matches. CTRL-L will insert the longest common part of the 326 matches. 327 328 Insert-mode completion. |ins-completion| 329 In Insert mode the CTRL-N and CTRL-P keys can be used to complete a 330 word that appears elsewhere. |i_CTRL-N| 331 With CTRL-X another mode is entered, through which completion can be 332 done for: 333 |i_CTRL-X_CTRL-F| file names 334 |i_CTRL-X_CTRL-K| words from 'dictionary' files 335 |i_CTRL-X_CTRL-T| words from 'thesaurus' files 336 |i_CTRL-X_CTRL-I| words from included files 337 |i_CTRL-X_CTRL-L| whole lines 338 |i_CTRL-X_CTRL-]| words from the tags file 339 |i_CTRL-X_CTRL-D| definitions or macros 340 |i_CTRL-X_CTRL-O| Omni completion: clever completion 341 specifically for a file type 342 |i_CTRL-X_CTRL-R| contents from registers 343 etc. 344 345 Long line support. 'wrap' 'linebreak' 346 If the 'wrap' option is off, long lines will not wrap and only part 347 of them will be shown. When the cursor is moved to a part that is not 348 shown, the screen will scroll horizontally. The minimum number of 349 columns to scroll can be set with the 'sidescroll' option. The |zh| 350 and |zl| commands can be used to scroll sideways. 351 Alternatively, long lines are broken in between words when the 352 'linebreak' option is set. This allows editing a single-line 353 paragraph conveniently (e.g. when the text is later read into a DTP 354 program). Move the cursor up/down with the |gk| and |gj| commands. 355 356 Text formatting. |formatting| 357 The 'textwidth' option can be used to automatically limit the line 358 length. This supplements the 'wrapmargin' option of Vi, which was not 359 very useful. The |gq| operator can be used to format a piece of text 360 (for example, |gqap| formats the current paragraph). Commands for 361 text alignment: |:center|, |:left| and |:right|. 362 363 Extended search patterns. |pattern| 364 There are many extra items to match various text items. Examples: 365 A "\n" can be used in a search pattern to match a line break. 366 "x\{2,4}" matches "x" 2 to 4 times. 367 "\s" matches a white space character. 368 369 Directory, remote and archive browsing. |netrw| 370 Vim can browse the file system. Simply edit a directory. Move around 371 in the list with the usual commands and press <Enter> to go to the 372 directory or file under the cursor. 373 This also works for remote files over ftp, http, ssh, etc. 374 Zip and tar archives can also be browsed. |tar| |zip| 375 376 Edit-compile-edit speedup. |quickfix| 377 The |:make| command can be used to run the compilation and jump to the 378 first error. A file with compiler error messages is interpreted. Vim 379 jumps to the first error. 380 381 Each line in the error file is scanned for the name of a file, line 382 number and error message. The 'errorformat' option can be set to a 383 list of scanf-like strings to handle output from many compilers. 384 385 The |:cn| command can be used to jump to the next error. 386 |:cl| lists all the error messages. Other commands are available. 387 The 'makeef' option has the name of the file with error messages. 388 The 'makeprg' option contains the name of the program to be executed 389 with the |:make| command. 390 The 'shellpipe' option contains the string to be used to put the 391 output of the compiler into the errorfile. 392 393 Finding matches in files. |:vimgrep| 394 Vim can search for a pattern in multiple files. This uses the 395 advanced Vim regexp pattern, works on all systems and also works to 396 search in compressed files. 397 398 Improved indenting for programs. 'cindent' 399 When the 'cindent' option is on the indent of each line is 400 automatically adjusted. C syntax is mostly recognized. The indent 401 for various styles can be set with 'cinoptions'. The keys to trigger 402 indenting can be set with 'cinkeys'. 403 404 Comments can be automatically formatted. The 'comments' option can be 405 set to the characters that start and end a comment. This works best 406 for C code, but also works for e-mail (">" at start of the line) and 407 other types of text. The |=| operator can be used to re-indent 408 lines. 409 410 For many other languages an indent plugin is present to support 411 automatic indenting. |30.3| 412 413 Searching for words in included files. |include-search| 414 The |[i| command can be used to search for a match of the word under 415 the cursor in the current and included files. The 'include' option 416 can be set to a pattern that describes a command to include a file 417 (the default is for C programs). 418 The |[I| command lists all matches, the |[_CTRL-I| command jumps to 419 a match. 420 The |[d|, |[D| and |[_CTRL-D| commands do the same, but only for 421 lines where the pattern given with the 'define' option matches. 422 423 Automatic commands. |autocommand| 424 Commands can be automatically executed when reading a file, writing a 425 file, jumping to another buffer, etc., depending on the file name. 426 This is useful to set options and mappings for C programs, 427 documentation, plain text, e-mail, etc. This also makes it possible 428 to edit compressed files. 429 430 Scripts and Expressions. |expression| 431 Commands have been added to form up a powerful script language. 432 |:if| Conditional execution, which can be used for example 433 to set options depending on the value of $TERM. 434 |:while| Repeat a number of commands. 435 |:for| Loop over a list. 436 |:echo| Print the result of an expression. 437 |:let| Assign a value to an internal variable, option, etc. 438 Variable types are Number, String, List and Dictionary. 439 |:execute| Execute a command formed by an expression. 440 |:try| Catch exceptions. 441 etc., etc. See |eval|. 442 Debugging and profiling are supported. |debug-scripts| |profile| 443 If this is not enough, an interface is provided to |Python|, |Ruby|, 444 |Tcl|, |Lua|, |Perl| and |MzScheme|. 445 446 Viminfo. |viminfo-file| 447 The command-line history, marks and registers can be stored in a file 448 that is read on startup. This can be used to repeat a search command 449 or command-line command after exiting and restarting Vim. It is also 450 possible to jump right back to where the last edit stopped with |'0|. 451 The 'viminfo' option can be set to select which items to store in the 452 .viminfo file. This is off by default. 453 454 Printing. |printing| 455 The |:hardcopy| command sends text to the printer. This can include 456 syntax highlighting. 457 458 Mouse support. |mouse-using| 459 The mouse is supported in the GUI version, in an xterm for Unix, for 460 BSDs with sysmouse, for Linux with gpm, and Win32. It can be used to 461 position the cursor, select the visual area, paste a register, etc. 462 463 Usage of key names. |<>| |key-notation| 464 Special keys now all have a name like <Up>, <End>, etc. 465 This name can be used in mappings, to make it easy to edit them. 466 467 Editing binary files. |edit-binary| 468 Vim can edit binary files. You can change a few characters in an 469 executable file, without corrupting it. Vim doesn't remove NUL 470 characters (they are represented as <NL> internally). 471 |-b| command-line argument to start editing a binary file 472 'binary' Option set by |-b|. Prevents adding an <EOL> for the 473 last line in the file. 474 475 Multi-language support. |multi-lang| 476 Files in double-byte or multibyte encodings can be edited. There is 477 UTF-8 support to be able to edit various languages at the same time, 478 without switching fonts. |UTF-8| 479 Messages and menus are available in different languages. 480 481 Move cursor beyond lines. 482 When the 'virtualedit' option is set the cursor can move all over the 483 screen, also where there is no text. This is useful to edit tables 484 and figures easily. 485 486 ============================================================================== 487 5. Other vim features *other-features* 488 489 A random collection of nice extra features. 490 491 492 When Vim is started with "-s scriptfile", the characters read from 493 "scriptfile" are treated as if you typed them. If end of file is reached 494 before the editor exits, further characters are read from the console. 495 496 The "-w" option can be used to record all typed characters in a script file. 497 This file can then be used to redo the editing, possibly on another file or 498 after changing some commands in the script file. 499 500 The "-o" option opens a window for each argument. "-o4" opens four windows. 501 502 Vi requires several termcap entries to be able to work full-screen. Vim only 503 requires the "cm" entry (cursor motion). 504 505 506 In command mode: 507 508 When the 'showcmd' option is set, the command characters are shown in the last 509 line of the screen. They are removed when the command is finished. 510 511 If the 'ruler' option is set, the current cursor position is shown in the 512 last line of the screen. 513 514 "U" still works after having moved off the last changed line and after "u". 515 516 Characters with the 8th bit set are displayed. The characters between '~' and 517 0xa0 are displayed as "~?", "~@", "~A", etc., unless they are included in the 518 'isprint' option. 519 520 "][" goes to the next ending of a C function ('}' in column 1). 521 "[]" goes to the previous ending of a C function ('}' in column 1). 522 523 "]f", "[f" and "gf" start editing the file whose name is under the cursor. 524 CTRL-W f splits the window and starts editing the file whose name is under 525 the cursor. 526 527 "*" searches forward for the identifier under the cursor, "#" backward. 528 "K" runs the program defined by the 'keywordprg' option, with the identifier 529 under the cursor as argument. 530 531 "%" can be preceded with a count. The cursor jumps to the line that 532 percentage down in the file. The normal "%" function to jump to the matching 533 brace skips braces inside quotes. 534 535 With the CTRL-] command, the cursor may be in the middle of the identifier. 536 537 The used tags are remembered. Commands that can be used with the tag stack 538 are CTRL-T, ":pop" and ":tag". ":tags" lists the tag stack. 539 540 Vi uses 'wrapscan' when searching for a tag. When jumping to a tag Vi starts 541 searching in line 2 of another file. It does not find a tag in line 1 of 542 another file when 'wrapscan' is not set. 543 544 The 'tags' option can be set to a list of tag file names. Thus multiple 545 tag files can be used. For file names that start with "./", the "./" is 546 replaced with the path of the current file. This makes it possible to use a 547 tags file in the same directory as the file being edited. 548 {Vi: always uses binary search in some versions} 549 {Vi does not have the security prevention for commands in tag files} 550 551 Previously used file names are remembered in the alternate file name list. 552 CTRL-^ accepts a count, which is an index in this list. 553 ":files" command shows the list of alternate file names. 554 "#<N>" is replaced with the <N>th alternate file name in the list. 555 "#<" is replaced with the current file name without extension. 556 557 Search patterns have more features. The <NL> character is seen as part of the 558 search pattern and the substitute string of ":s". Vi sees it as the end of 559 the command. 560 561 Searches can put the cursor on the end of a match and may include a character 562 offset. 563 564 Count added to "~", ":next", ":Next", "n" and "N". 565 566 The command ":next!" with 'autowrite' set does not write the file. In vi the 567 file was written, but this is considered to be a bug, because one does not 568 expect it and the file is not written with ":rewind!". 569 570 In Vi when entering a <CR> in replace mode deletes a character only when 'ai' 571 is set (but does not show it until you hit <Esc>). Vim always deletes a 572 character (and shows it immediately). 573 574 Added :wnext command. Same as ":write" followed by ":next". 575 576 The ":w!" command always writes, also when the file is write protected. In Vi 577 you would have to do ":!chmod +w %:S" and ":set noro". 578 579 When 'tildeop' has been set, "~" is an operator (must be followed by a 580 movement command). 581 582 With the "J" (join) command you can reset the 'joinspaces' option to have only 583 one space after a period (Vi inserts two spaces). 584 585 "cw" can be used to change white space formed by several characters (Vi is 586 confusing: "cw" only changes one space, while "dw" deletes all white space). 587 {Vi: "cw" when on a blank followed by other blanks changes only the first 588 blank; this is probably a bug, because "dw" deletes all the blanks} 589 590 "o" and "O" accept a count for repeating the insert (Vi clears a part of 591 display). 592 593 Flags after Ex commands not supported (no plans to include it). 594 595 On non-UNIX systems ":cd" command shows current directory instead of going to 596 the home directory (there isn't one). ":pwd" prints the current directory on 597 all systems. 598 599 After a ":cd" command the file names (in the argument list, opened files) 600 still point to the same files. In Vi ":cd" is not allowed in a changed file; 601 otherwise the meaning of file names change. 602 603 ":source!" command reads Vi commands from a file. 604 605 ":mkexrc" command writes current modified options and mappings to a ".exrc" 606 file. ":mkvimrc" writes to a ".vimrc" file. 607 608 No check for "tail recursion" with mappings. This allows things like 609 ":map! foo ^]foo". 610 611 When a mapping starts with number, vi loses the count typed before it (e.g. 612 when using the mapping ":map g 4G" the command "7g" goes to line 4). This is 613 considered a vi bug. Vim concatenates the counts (in the example it becomes 614 "74G"), as most people would expect. 615 616 The :put! command inserts the contents of a register above the current line. 617 618 The "p" and "P" commands of vi cannot be repeated with "." when the putted 619 text is less than a line. In Vim they can always be repeated. 620 621 ":noremap" command can be used to enter a mapping that will not be remapped. 622 This is useful to exchange the meaning of two keys. ":cmap", ":cunmap" and 623 ":cnoremap" can be used for mapping in command-line editing only. ":imap", 624 ":iunmap" and ":inoremap" can be used for mapping in insert mode only. 625 Similar commands exist for abbreviations: ":noreabbrev", ":iabbrev" 626 ":cabbrev", ":iunabbrev", ":cunabbrev", ":inoreabbrev", ":cnoreabbrev". 627 628 In Vi the command ":map foo bar" would remove a previous mapping 629 ":map bug foo". This is considered a bug, so it is not included in Vim. 630 ":unmap! foo" does remove ":map! bug foo", because unmapping would be very 631 difficult otherwise (this is vi compatible). 632 633 The ':' register contains the last command-line. 634 The '%' register contains the current file name. 635 The '.' register contains the last inserted text. 636 637 ":dis" command shows the contents of the yank registers. 638 639 CTRL-O/CTRL-I can be used to jump to older/newer positions. These are the 640 same positions as used with the '' command, but may be in another file. The 641 ":jumps" command lists the older positions. 642 643 If the 'shiftround' option is set, an indent is rounded to a multiple of 644 'shiftwidth' with ">" and "<" commands. 645 646 The 'scrolljump' option can be set to the minimum number of lines to scroll 647 when the cursor gets off the screen. Use this when scrolling is slow. 648 649 The 'scrolloff' option can be set to the minimum number of lines to keep 650 above and below the cursor. This gives some context to where you are 651 editing. When set to a large number the cursor line is always in the middle 652 of the window. 653 654 Uppercase marks can be used to jump between files. The ":marks" command lists 655 all currently set marks. The commands "']" and "`]" jump to the end of the 656 previous operator or end of the text inserted with the put command. "'[" and 657 "`[" do jump to the start. {Vi: no uppercase marks} 658 659 The 'shelltype' option can be set to reflect the type of shell used on the 660 Amiga. 661 662 The 'highlight' option can be set for the highlight mode to be used for 663 several commands. 664 665 The CTRL-A (add) and CTRL-X (subtract) commands are new. The count to the 666 command (default 1) is added to/subtracted from the number at or after the 667 cursor. That number may be decimal, octal (starts with a '0') or hexadecimal 668 (starts with '0x'). Very useful in macros. 669 670 With the :set command the prefix "inv" can be used to invert boolean options. 671 672 In both Vi and Vim you can create a line break with the ":substitute" command 673 by using a CTRL-M. For Vi this means you cannot insert a real CTRL-M in the 674 text. With Vim you can put a real CTRL-M in the text by preceding it with a 675 CTRL-V. 676 677 678 In Insert mode: 679 680 If the 'revins' option is set, insert happens backwards. This is for typing 681 Hebrew. When inserting normal characters the cursor will not be shifted and 682 the text moves rightwards. Backspace, CTRL-W and CTRL-U will also work in 683 the opposite direction. CTRL-B toggles the 'revins' option. In replace mode 684 'revins' has no effect. Only when enabled at compile time. 685 686 The backspace key can be used just like CTRL-D to remove auto-indents. 687 688 You can backspace, CTRL-U and CTRL-W over line breaks if the 'backspace' (bs) 689 option includes "eol". You can backspace over the start of insert if the 690 'backspace' option includes "start". 691 692 When the 'paste' option is set, a few options are reset and mapping in insert 693 mode and abbreviation are disabled. This allows for pasting text in windowing 694 systems without unexpected results. When the 'paste' option is reset, the old 695 option values are restored. 696 697 CTRL-T/CTRL-D always insert/delete an indent in the current line, no matter 698 what column the cursor is in. 699 700 CTRL-@ (insert previously inserted text) works always (Vi: only when typed as 701 first character). 702 703 CTRL-A works like CTRL-@ but does not leave insert mode. 704 705 CTRL-R {register} can be used to insert the contents of a register. 706 707 When the 'smartindent' option is set, C programs will be better auto-indented. 708 With 'cindent' even more. 709 710 CTRL-Y and CTRL-E can be used to copy a character from above/below the 711 current cursor position. 712 713 After CTRL-V you can enter a three digit decimal number. This byte value is 714 inserted in the text as a single character. Useful for international 715 characters that are not on your keyboard. 716 717 When the 'expandtab' (et) option is set, a <Tab> is expanded to the 718 appropriate number of spaces. 719 720 The window always reflects the contents of the buffer (Vi does not do this 721 when changing text and in some other cases). 722 723 If Vim is compiled with DIGRAPHS defined, digraphs are supported. A set of 724 normal digraphs is included. They are shown with the ":digraph" command. 725 More can be added with ":digraph {char1}{char2} {number}". A digraph is 726 entered with "CTRL-K {char1} {char2}" or "{char1} BS {char2}" (only when 727 'digraph' option is set). 728 729 When repeating an insert, e.g. "10atest <Esc>" vi would only handle wrapmargin 730 for the first insert. Vim does it for all. 731 732 A count to the "i" or "a" command is used for all the text. Vi uses the count 733 only for one line. "3iabc<NL>def<Esc>" would insert "abcabcabc<NL>def" in Vi 734 but "abc<NL>defabc<NL>defabc<NL>def" in Vim. 735 736 737 In Command-line mode: 738 739 <Esc> terminates the command-line without executing it. In vi the command 740 line would be executed, which is not what most people expect (hitting <Esc> 741 should always get you back to command mode). To avoid problems with some 742 obscure macros, an <Esc> in a macro will execute the command. If you want a 743 typed <Esc> to execute the command like vi does you can fix this with 744 ":cmap ^V<Esc> ^V<CR>" 745 746 General: 747 748 The 'ttimeout' option is like 'timeout', but only works for cursor and 749 function keys, not for ordinary mapped characters. The 'timeoutlen' option 750 gives the number of milliseconds that is waited for. If the 'esckeys' option 751 is not set, cursor and function keys that start with <Esc> are not recognized 752 in insert mode. 753 754 There is an option for each terminal string. Can be used when termcap is not 755 supported or to change individual strings. 756 757 The 'fileformat' option can be set to select the <EOL>: "dos" <CR><NL>, "unix" 758 <NL> or "mac" <CR>. 759 When the 'fileformats' option is not empty, Vim tries to detect the type of 760 <EOL> automatically. The 'fileformat' option is set accordingly. 761 762 On systems that have no job control (older Unix systems and non-Unix systems) 763 the CTRL-Z, ":stop" or ":suspend" command starts a new shell. 764 765 If Vim is started on the Amiga without an interactive window for output, a 766 window is opened (and :sh still works). You can give a device to use for 767 editing with the |-d| argument, e.g. "-d con:20/20/600/150". 768 769 The 'columns' and 'lines' options are used to set or get the width and height 770 of the display. 771 772 Option settings are read from the first and last few lines of the file. 773 Option 'modelines' determines how many lines are tried (default is 5). Note 774 that this is different from the Vi versions that can execute any Ex command 775 in a modeline (a major security problem). |trojan-horse| 776 777 If the 'insertmode' option is set (e.g. in .exrc), Vim starts in insert mode. 778 And it comes back there, when pressing <Esc>. 779 780 Undo information is kept in memory. Available memory limits the number and 781 size of change that can be undone. This is hardly a problem on the Amiga and 782 almost never with Unix and Win32. 783 784 If the 'backup' or 'writebackup' option is set: Before a file is overwritten, 785 a backup file (.bak) is made. If the "backup" option is set it is left 786 behind. 787 788 Vim creates a file ending in ".swp" to store parts of the file that have been 789 changed or that do not fit in memory. This file can be used to recover from 790 an aborted editing session with "vim -r file". Using the swap file can be 791 switched off by setting the 'updatecount' option to 0 or starting Vim with 792 the "-n" option. Use the 'directory' option for placing the .swp file 793 somewhere else. 794 795 Vim is able to work correctly on filesystems with 8.3 file names, also when 796 using messydos or crossdos filesystems on the Amiga, or any 8.3 mounted 797 filesystem under Unix. See 'shortname'. 798 799 Error messages are shown at least one second (Vi overwrites error messages). 800 801 If Vim gives the |hit-enter| prompt, you can hit any key. Characters other 802 than <CR>, <NL> and <Space> are interpreted as the (start of) a command. 803 {Vi: only ":" commands are interpreted} 804 805 The contents of the numbered and unnamed registers is remembered when 806 changing files. 807 808 The "No lines in buffer" message is a normal message instead of an error 809 message, since that may cause a mapping to be aborted. 810 {Vi: error messages may be overwritten with other messages before you have a 811 chance to read them} 812 813 The AUX: device of the Amiga is supported. 814 815 ============================================================================== 816 6. Supported Vi features *vi-features* 817 818 Vim supports nearly all Vi commands and mostly in the same way. That is when 819 the 'compatible' option is set and 'cpoptions' contains all flags. What the 820 effect is of resetting 'compatible' and removing flags from 'cpoptions' can be 821 found at the help for the specific command. 822 823 The help files used to mark features that are in Vim but not in Vi with {not 824 in Vi}. However, since these remarks cluttered the help files we now do it 825 the other way around: Below is listed what Vi already supported. Anything 826 else has been added by Vim. 827 828 829 The following Ex commands are supported by Vi: ~ 830 831 `:abbreviate` enter abbreviation 832 `:append` append text 833 `:args` print the argument list 834 `:cd` change directory; Vi: no "cd -" 835 `:change` replace a line or series of lines 836 `:chdir` change directory 837 `:copy` copy lines 838 `:delete` delete lines 839 `:edit` edit a file 840 `:exit` same as `:xit` 841 `:file` show or set the current file name; Vi: without the column 842 number 843 `:global` execute commands for matching lines 844 `:insert` insert text 845 `:join` join lines; Vi: not :join! 846 `:k` set a mark 847 `:list` print lines 848 `:map` show or enter a mapping 849 `:mark` set a mark 850 `:move` move lines 851 `:Next` go to previous file in the argument list {Vi: no count} 852 `:next` go to next file in the argument list {Vi: no count} 853 `:number` print lines with line number 854 `:open` start open mode (not implemented in Vim) 855 `:pop` jump to older entry in tag stack (only in some versions) 856 `:preserve` write all text to swap file {Vi: might also exit} 857 `:previous` same as `:Next` {Vi: only in some versions} 858 `:print` print lines 859 `:put` insert contents of register in the text 860 `:quit` quit Vi 861 `:read` read file into the text 862 `:recover` recover a file from a swap file {Vi: recovers in another way 863 and sends mail if there is something to recover} 864 `:rewind` go to the first file in the argument list; no ++opt 865 `:set` set option; but not `:set inv{option}`, `:set option&`, 866 `:set all&`, `:set option+=value`, `:set option^=value` 867 `:set option-=value` `:set option<` 868 `:shell` escape to a shell 869 `:source` read Vi or Ex commands from a file 870 `:stop` suspend the editor or escape to a shell 871 `:substitute` find and replace text; Vi: no '&', 'i', 's', 'r' or 'I' flag, 872 confirm prompt only supports 'y' and 'n', no highlighting 873 `:suspend` same as ":stop" 874 `:t` same as ":copy" 875 `:tag` jump to tag 876 `:unabbreviate` remove abbreviation 877 `:undo` undo last change {Vi: only one level} 878 `:unmap` remove mapping 879 `:vglobal` execute commands for not matching lines 880 `:version` print version number and other info 881 `:visual` same as ":edit", but turns off "Ex" mode 882 `:wq` write to a file and quit Vi 883 `:write` write to a file 884 `:xit` write if buffer changed and quit Vi 885 `:yank` yank lines into a register 886 `:z` print some lines {not in all versions of Vi} 887 `:!` filter lines or execute an external command 888 `:"` comment 889 `:#` same as ":number" 890 `:*` execute contents of a register 891 `:&` repeat last ":substitute" 892 `:<` shift lines one 'shiftwidth' left 893 `:=` print the cursor line number 894 `:>` shift lines one 'shiftwidth' right 895 `:@` execute contents of a register; but not `:@`; `:@@` only in 896 some versions 897 898 Common for these commands is that Vi doesn't support the ++opt argument on 899 `:edit` and other commands that open a file. 900 901 902 The following Normal mode commands are supported by Vi: ~ 903 904 note: See the beginning of |normal-index| for the meaning of WORD, N, Nmove 905 and etc in the description text. 906 907 |CTRL-B| scroll N screens Backwards 908 |CTRL-C| interrupt current (search) command 909 |CTRL-D| scroll Down N lines (default: half a screen); Vim scrolls 910 'scroll' screen lines, Vi scrolls file lines; makes a 911 difference when lines wrap 912 |CTRL-E| scroll N lines upwards (N lines Extra) 913 |CTRL-F| scroll N screens Forward 914 |CTRL-G| display current file name and position 915 |<BS>| same as "h" 916 |CTRL-H| same as "h" 917 |<NL>| same as "j" 918 |CTRL-J| same as "j" 919 |CTRL-L| redraw screen 920 |<CR>| cursor to the first CHAR N lines lower 921 |CTRL-M| same as <CR> 922 |CTRL-N| same as "j" 923 |CTRL-P| same as "k" 924 |CTRL-R| in some Vi versions: same as CTRL-L 925 |CTRL-T| jump to N older Tag in tag list 926 |CTRL-U| N lines Upwards (default: half a screen) {Vi used file lines 927 while Vim scrolls 'scroll' screen lines; makes a difference 928 when lines wrap} 929 |CTRL-Y| scroll N lines downwards 930 |CTRL-Z| suspend program (or start new shell) 931 |CTRL-]| :ta to ident under cursor {Vi: identifier after the cursor} 932 |CTRL-^| edit alternate file {Vi: no count} 933 |<Space>| same as "l" 934 |!| filter Nmove text through the {filter} command 935 |!!| filter N lines through the {filter} command 936 " use register {a-zA-Z0-9.%#:-"} for next delete, yank or put 937 (uppercase to append) ({.%#:} only work with put) 938 |$| cursor to the end of Nth next line 939 |%| find the next (curly/square) bracket on this line and go to 940 its match, or go to matching comment bracket, or go to 941 matching preprocessor directive (Vi: no count supported) 942 |&| repeat last :s 943 |'| jump to mark (Vi: only lowercase marks) 944 |(| cursor N sentences backward 945 |)| cursor N sentences forward 946 |+| same as <CR> 947 |,| repeat latest f, t, F or T in opposite direction N times 948 |-| cursor to the first CHAR N lines higher 949 |.| repeat last change with count replaced with N 950 |/| search forward for the Nth occurrence of {pattern} 951 |0| cursor to the first char of the line 952 |:| start entering an Ex command 953 |;| repeat latest f, t, F or T N times 954 |<| shift Nmove lines one 'shiftwidth' leftwards 955 |<<| shift N lines one 'shiftwidth' leftwards 956 |=| filter Nmove lines through "indent" 957 |==| filter N lines through "indent" 958 |>| shift Nmove lines one 'shiftwidth' rightwards 959 |>>| shift N lines one 'shiftwidth' rightwards 960 |?| search backward for the Nth previous occurrence of {pattern} 961 |@| execute the contents of register {a-z} N times 962 {Vi: only named registers} 963 |@@| repeat the previous @{a-z} N times 964 |A| append text after the end of the line N times 965 |B| cursor N WORDS backward 966 |C| change from the cursor position to the end of the line 967 |D| delete the characters under the cursor until the end of the 968 line and N-1 more lines [into register x]; synonym for "d$" 969 |E| cursor forward to the end of WORD N 970 |F| cursor to the Nth occurrence of {char} to the left 971 |G| cursor to line N, default last line 972 |H| cursor to line N from top of screen 973 |I| insert text before the first CHAR on the line N times 974 |J| Join N lines; default is 2 975 |L| cursor to line N from bottom of screen 976 |M| cursor to middle line of screen 977 |N| repeat the latest '/' or '?' N times in opposite direction 978 |O| begin a new line above the cursor and insert text, repeat N 979 times {Vi: blank [count] screen lines} 980 |P| put the text [from register x] before the cursor N times 981 {Vi: no count} 982 |Q| switch to "Ex" mode 983 |R| enter replace mode: overtype existing characters, repeat the 984 entered text N-1 times 985 |S| delete N lines [into register x] and start insert; synonym for 986 "cc". 987 |T| cursor till after Nth occurrence of {char} to the left 988 |U| undo all latest changes on one line 989 {Vi: while not moved off of the last modified line} 990 |W| cursor N WORDS forward 991 |X| delete N characters before the cursor [into register x] 992 |Y| yank N lines [into register x]; synonym for "yy" 993 |ZZ| store current file if modified, and exit 994 |[[| cursor N sections backward 995 |]]| cursor N sections forward 996 |^| cursor to the first CHAR of the line 997 |_| cursor to the first CHAR N - 1 lines lower 998 |`| cursor to the mark {a-zA-Z0-9} 999 |a| append text after the cursor N times 1000 |b| cursor N words backward 1001 |c| delete Nmove text [into register x] and start insert 1002 |cc| delete N lines [into register x] and start insert 1003 |d| delete Nmove text [into register x] 1004 |dd| delete N lines [into register x] 1005 |e| cursor forward to the end of word N 1006 |f| cursor to Nth occurrence of {char} to the right 1007 |h| cursor N chars to the left 1008 |i| insert text before the cursor N times 1009 |j| cursor N lines downward 1010 |k| cursor N lines upward 1011 |l| cursor N chars to the right 1012 |m| set mark {A-Za-z} at cursor position 1013 |n| repeat the latest '/' or '?' N times 1014 |o| begin a new line below the cursor and insert text 1015 {Vi: blank [count] screen lines} 1016 |p| put the text [from register x] after the cursor N times 1017 {Vi: no count} 1018 |r| replace N chars with {char} {Vi: CTRL-V <CR> still replaces 1019 with a line break, cannot replace something with a <CR>} 1020 |s| (substitute) delete N characters [into register x] and start 1021 insert 1022 |t| cursor till before Nth occurrence of {char} to the right 1023 |u| undo changes {Vi: only one level} 1024 |w| cursor N words forward 1025 |x| delete N characters under and after the cursor [into register 1026 x] 1027 |y| yank Nmove text [into register x] 1028 |yy| yank N lines [into register x] 1029 |z<CR>| current line to the top 1030 |z-| current line to the bottom 1031 |z+| cursor on line N 1032 |z^| cursor on line N 1033 |{| cursor N paragraphs backward 1034 | cursor to column N 1035 |}| cursor N paragraphs forward 1036 |~| switch case of N characters under the cursor; Vim: depends on 1037 'tildeop' {Vi: no count, no 'tildeop'} 1038 |<Del>| same as "x" 1039 1040 1041 The following commands are supported in Insert mode by Vi: ~ 1042 1043 CTRL-@ insert previously inserted text and stop insert 1044 {Vi: only when typed as first char, only up to 128 chars} 1045 CTRL-C quit insert mode, without checking for abbreviation, unless 1046 'insertmode' set. 1047 CTRL-D delete one shiftwidth of indent in the current line 1048 {Vi: CTRL-D works only when used after autoindent} 1049 <BS> delete character before the cursor {Vi: does not delete 1050 autoindents, does not cross lines, does not delete past start 1051 position of insert} 1052 CTRL-H same as <BS> 1053 <Tab> insert a <Tab> character 1054 CTRL-I same as <Tab> 1055 <NL> same as <CR> 1056 CTRL-J same as <CR> 1057 <CR> begin new line 1058 CTRL-M same as <CR> 1059 CTRL-T insert one shiftwidth of indent in current line {Vi: only when 1060 in indent} 1061 CTRL-V {char} insert next non-digit literally {Vi: no decimal byte entry} 1062 CTRL-W delete word before the cursor 1063 CTRL-Z when 'insertmode' set: suspend Vi 1064 <Esc> end insert mode (unless 'insertmode' set) 1065 CTRL-[ same as <Esc> 1066 0 CTRL-D delete all indent in the current line 1067 ^ CTRL-D delete all indent in the current line, restore it in the next 1068 line 1069 <Del> delete character under the cursor 1070 1071 1072 The following options are supported by Vi: ~ 1073 1074 'autoindent' 'ai' take indent for new line from previous line 1075 {Vi does this slightly differently: After the 1076 indent is deleted when typing <Esc> or <CR>, the 1077 cursor position when moving up or down is after 1078 the deleted indent; Vi puts the cursor somewhere 1079 in the deleted indent}. 1080 'autowrite' 'aw' automatically write file if changed 1081 'directory' 'dir' list of directory names for the swap file 1082 {Vi: directory to put temp file in, defaults to 1083 "/tmp"} 1084 'edcompatible' 'ed' toggle flags of ":substitute" command 1085 'errorbells' 'eb' ring the bell for error messages 1086 'ignorecase' 'ic' ignore case in search patterns 1087 'lines' number of lines in the display 1088 'lisp' automatic indenting for Lisp {Vi: Does it a little 1089 bit differently} 1090 'list' show <Tab> and <EOL> 1091 'magic' changes special characters in search patterns 1092 'modeline' 'ml' recognize 'modelines' at start or end of file 1093 {called modelines in some Vi versions} 1094 'number' 'nu' print the line number in front of each line 1095 'paragraphs' 'para' nroff macros that separate paragraphs 1096 'prompt' 'prompt' enable prompt in Ex mode 1097 'readonly' 'ro' disallow writing the buffer {Vim sets 'readonly' 1098 when editing a file with `:view`} 1099 'remap' allow mappings to work recursively 1100 'report' threshold for reporting nr. of lines changed 1101 'scroll' 'scr' lines to scroll with CTRL-U and CTRL-D 1102 'sections' 'sect' nroff macros that separate sections 1103 'shell' 'sh' name of shell to use for external commands 1104 'shiftwidth' 'sw' number of spaces to use for (auto)indent step 1105 'showmatch' 'sm' briefly jump to matching bracket if insert one 1106 'showmode' 'smd' message on status line to show current mode 1107 'tabstop' 'ts' number of columns between two tab stops 1108 'taglength' 'tl' number of significant characters for a tag 1109 'tags' 'tag' list of file names used by the tag command 1110 {Vi: default is "tags /usr/lib/tags"} 1111 'tagstack' 'tgst' push tags onto the tag stack {not in all versions 1112 of Vi} 1113 'term' name of the terminal 1114 'terse' shorten some messages 1115 'timeout' 'to' time out on mappings and key codes 1116 'timeoutlen' 'tm' time for 'timeout' {only in some Vi versions} 1117 'ttytype' 'tty' alias for 'term' 1118 'verbose' 'vbs' give informative messages {only in some Vi 1119 versions as a boolean option} 1120 'warn' warn for shell command when buffer was changed 1121 'window' 'wi' nr of lines to scroll for CTRL-F and CTRL-B 1122 {Vi also uses the option to specify the number of 1123 displayed lines} 1124 'wrapmargin' 'wm' chars from the right where wrapping starts 1125 {Vi: works differently and less usefully} 1126 'wrapscan' 'ws' searches wrap around the end of the file 1127 'writeany' 'wa' write to file with no need for "!" override 1128 1129 Also see |missing-options|. 1130 1131 ============================================================================== 1132 7. Command-line arguments *cmdline-arguments* 1133 1134 Different versions of Vi have different command-line arguments. This can be 1135 confusing. To help you, this section gives an overview of the differences. 1136 1137 Five variants of Vi will be considered here: 1138 Elvis Elvis version 2.1b 1139 Nvi Nvi version 1.79 1140 Posix Posix 1003.2 1141 Vi Vi version 3.7 (for Sun 4.1.x) 1142 Vile Vile version 7.4 (incomplete) 1143 Vim Vim version 5.2 1144 1145 Only Vim is able to accept options in between and after the file names. 1146 1147 +{command} Elvis, Nvi, Posix, Vi, Vim: Same as "-c {command}". 1148 1149 - Nvi, Posix, Vi: Run Ex in batch mode. 1150 Vim: Read file from stdin (use -s for batch mode). 1151 1152 -- Vim: End of options, only file names are following. 1153 1154 --cmd {command} Vim: execute {command} before sourcing vimrc files. 1155 1156 --echo-wid Vim: GTK+ echoes the Window ID on stdout 1157 1158 --help Vim: show help message and exit. 1159 1160 --literal Vim: take file names literally, don't expand wildcards. 1161 1162 --nofork Vim: same as |-f| 1163 1164 --noplugin[s] Vim: Skip loading plugins. 1165 1166 --remote Vim: edit the files in another Vim server 1167 1168 --remote-expr {expr} Vim: evaluate {expr} in another Vim server 1169 1170 --remote-send {keys} Vim: send {keys} to a Vim server and exit 1171 1172 --remote-silent {file} Vim: edit the files in another Vim server if possible 1173 1174 --remote-wait Vim: edit the files in another Vim server and wait for it 1175 1176 --remote-wait-silent Vim: like --remote-wait, no complaints if not possible 1177 1178 --role {role} Vim: GTK+ 2: set role of main window 1179 1180 --serverlist Vim: Output a list of Vim servers and exit 1181 1182 --servername {name} Vim: Specify Vim server name 1183 1184 --socketid {id} Vim: GTK window socket to run Vim in 1185 1186 --windowid {id} Vim: Win32 window ID to run Vim in 1187 1188 --version Vim: show version message and exit. 1189 1190 -? Vile: print usage summary and exit. 1191 1192 -a Elvis: Load all specified file names into a window (use -o for 1193 Vim). 1194 1195 -A Vim: Start in Arabic mode (when compiled with Arabic). 1196 1197 -b {blksize} Elvis: Use {blksize} blocksize for the session file. 1198 -b Vim: set 'binary' mode. 1199 1200 -C Vim: Compatible mode. 1201 1202 -c {command} Elvis, Nvi, Posix, Vim: run {command} as an Ex command after 1203 loading the edit buffer. 1204 Vim: allow up to 10 "-c" arguments 1205 1206 -d {device} Vim: Use {device} for I/O (Amiga only). {only when compiled 1207 without the |+diff| feature} 1208 -d Vim: start with 'diff' set. |vimdiff| 1209 1210 -dev {device} Vim: Use {device} for I/O (Amiga only). 1211 1212 -D Vim: debug mode. 1213 1214 -e Elvis, Nvi, Vim: Start in Ex mode, as if the executable is 1215 called "ex". 1216 1217 -E Vim: Start in improved Ex mode |gQ|, like "exim". 1218 1219 -f Vim: Run GUI in foreground (Amiga: don't open new window). 1220 -f {session} Elvis: Use {session} as the session file. 1221 1222 -F Vim: Start in Farsi mode (when compiled with Farsi). 1223 Nvi: Fast start, don't read the entire file when editing 1224 starts. 1225 1226 -G {gui} Elvis: Use the {gui} as user interface. 1227 1228 -g Vim: Start GUI. 1229 -g N Vile: start editing at line N 1230 1231 -h Vim: Give help message. 1232 Vile: edit the help file 1233 1234 -H Vim: start Hebrew mode (when compiled with it). 1235 1236 -i Elvis: Start each window in Insert mode. 1237 -i {viminfo} Vim: Use {viminfo} for viminfo file. 1238 1239 -L Vim: Same as "-r" {only in some versions of Vi: "List 1240 recoverable edit sessions"}. 1241 1242 -l Nvi, Vi, Vim: Set 'lisp' and 'showmatch' options. 1243 1244 -m Vim: Modifications not allowed to be written, resets 'write' 1245 option. 1246 1247 -M Vim: Modifications not allowed, resets 'modifiable' and the 1248 'write' option. 1249 1250 -N Vim: No-compatible mode. 1251 1252 -n Vim: No swap file used. 1253 1254 -nb[args] Vim: open a NetBeans interface connection 1255 1256 -O[N] Vim: Like -o, but use vertically split windows. 1257 1258 -o[N] Vim: Open [N] windows, or one for each file. 1259 1260 -p[N] Vim: Open [N] tab pages, or one for each file. 1261 1262 -P {parent-title} Win32 Vim: open Vim inside a parent application window 1263 1264 -q {name} Vim: Use {name} for quickfix error file. 1265 -q{name} Vim: Idem. 1266 1267 -R Elvis, Nvi, Posix, Vile, Vim: Set the 'readonly' option. 1268 1269 -r Elvis, Nvi, Posix, Vi, Vim: Recovery mode. 1270 1271 -S Nvi: Set 'secure' option. 1272 -S {script} Vim: source script after starting up. 1273 1274 -s Nvi, Posix, Vim: Same as "-" (silent mode), when in Ex mode. 1275 Elvis: Sets the 'safer' option. 1276 -s {scriptin} Vim: Read from script file {scriptin}; only when not in Ex 1277 mode. 1278 -s {pattern} Vile: search for {pattern} 1279 1280 -t {tag} Elvis, Nvi, Posix, Vi, Vim: Edit the file containing {tag}. 1281 -t{tag} Vim: Idem. 1282 1283 -T {term} Vim: Set terminal name to {term}. 1284 1285 -u {vimrc} Vim: Read initializations from {vimrc} file. 1286 1287 -U {gvimrc} Vim: Read GUI initializations from {gvimrc} file. 1288 1289 -v Nvi, Posix, Vi, Vim: Begin in Normal mode (visual mode, in Vi 1290 terms). 1291 Vile: View mode, no changes possible. 1292 1293 -V Elvis, Vim: Verbose mode. 1294 -V{nr} Vim: Verbose mode with specified level. 1295 1296 -w {size} Elvis, Posix, Nvi, Vi, Vim: Set value of 'window' to {size}. 1297 -w{size} Nvi, Vi: Same as "-w {size}". 1298 -w {name} Vim: Write to script file {name} (must start with non-digit). 1299 1300 -W {name} Vim: Append to script file {name}. 1301 1302 -x Vi, Vim: Ask for encryption key. See |encryption|. 1303 1304 -X Vim: Don't connect to the X server. 1305 1306 -y Vim: Start in easy mode, like |evim|. 1307 1308 -Z Vim: restricted mode 1309 1310 @{cmdfile} Vile: use {cmdfile} as startup file. 1311 1312 ============================================================================== 1313 8. POSIX compliance *posix* *posix-compliance* 1314 1315 In 2005 the POSIX test suite was run to check the compatibility of Vim. Most 1316 of the test was executed properly. There are the few things where Vim 1317 is not POSIX compliant, even when run in Vi compatibility mode. 1318 *$VIM_POSIX* 1319 Set the $VIM_POSIX environment variable to have 'cpoptions' include the POSIX 1320 flags when Vim starts up. This makes Vim run as POSIX as it can. That's 1321 a bit different from being Vi compatible. 1322 1323 You can find the Posix specification for Vi here: 1324 https://pubs.opengroup.org/onlinepubs/9699919799/utilities/vi.html 1325 And the related Ex specification: 1326 https://pubs.opengroup.org/onlinepubs/9699919799/utilities/ex.html 1327 1328 This is where Vim does not behave as POSIX specifies and why: 1329 1330 *posix-screen-size* 1331 The $COLUMNS and $LINES environment variables are ignored by Vim if 1332 the size can be obtained from the terminal in a more reliable way. 1333 Add the '|' flag to 'cpoptions' to have $COLUMNS and $LINES overrule 1334 sizes obtained in another way. 1335 1336 The "{" and "}" commands don't stop at a "{" in the original Vi, but 1337 POSIX specifies it does. Add the '{' flag to 'cpoptions' if you want 1338 it the POSIX way. 1339 1340 The "D", "o" and "O" commands accept a count. Also when repeated. 1341 Add the '#' flag to 'cpoptions' if you want to ignore the count. 1342 1343 The ":cd" command fails if the current buffer is modified when the '.' 1344 flag is present in 'cpoptions'. 1345 1346 There is no ATTENTION message, the "A" flag is added to 'shortmess'. 1347 1348 These are remarks about running the POSIX test suite: 1349 - vi test 33 sometimes fails for unknown reasons 1350 - vi test 250 fails; behavior will be changed in a new revision 1351 (dead link) opengroup.org/austin/mailarchives/ag-review/msg01710.html 1352 (link no longer works, perhaps it's now: 1353 https://www.opengroup.org/sophocles/show_mail.tpl?CALLER=show_archive.tpl&source=L&listname=austin-review-l&id=1711) 1354 - vi test 310 fails; exit code non-zero when any error occurred? 1355 - ex test 24 fails because test is wrong. Changed between SUSv2 and SUSv3. 1356 - ex tests 47, 48, 49, 72, 73 fail because .exrc file isn't read in silent 1357 mode and $EXINIT isn't used. 1358 - ex tests 76, 78 fail because echo is used instead of printf. (fixed) 1359 Also: problem with \s not changed to space. 1360 - ex test 355 fails because 'window' isn't used for "30z". 1361 - ex test 368 fails because shell command isn't echoed in silent mode. 1362 - ex test 394 fails because "=" command output isn't visible in silent mode. 1363 - ex test 411 fails because test file is wrong, contains stray ':'. 1364 - ex test 475 and 476 fail because reprint output isn't visible in silent 1365 mode. 1366 - ex test 480 and 481 fail because the tags file has spaces instead of a tab. 1367 - ex test 502 fails because .exrc isn't read in silent mode. 1368 - ex test 509 fails because .exrc isn't read in silent mode. and exit code is 1369 1 instead of 2. 1370 - ex test 534 fails because .exrc isn't read in silent mode. 1371 1372 ============================================================================== 1373 9. Supported Operating systems *os-support* 1374 1375 Vim tries to support some old operating systems, however support for older 1376 operating systems might be dropped if maintenance becomes a burden or can no 1377 longer be verified. 1378 1379 Here is the status of some operating systems. Note fully supported means, 1380 support is verified as part of the CI test suite. 1381 1382 System | Status:~ 1383 --------------------------------+----------------------------------------- 1384 Amiga (OS4, AROS & MorphOS): | supported 1385 Haiku: | supported 1386 Linux: | fully supported (on maintained versions) 1387 macOS: | fully supported up until v10.6 (?) 1388 MS-Windows 7, 8, 10, 11: | fully supported 1389 OpenVMS: | supported 1390 QNX: | still supported (?) 1391 Solaris: | supported (on maintained versions) 1392 UNIX: | supported (on maintained versions) 1393 zOS/OS390: | still supported (?) 1394 1395 The following operating systems are no longer supported: 1396 1397 System | Status:~ 1398 --------------------------------+----------------------------------------- 1399 Atari MiNT: | support was dropped with v8.2.1215 1400 BeOS: | support was dropped with v8.2.0849 1401 MS-DOS: | support was dropped with v7.4.1399 1402 MS-Windows XP and Vista: | support was dropped with v9.0.0496 1403 OS/2: | support was dropped with v7.4.1008 1404 RISC OS: | support was dropped with v7.3.0187 1405 NeXTSTEP: | support was dropped with v9.2.0122 1406 1407 vim:tw=78:ts=8:noet:ft=help:norl: