vim

Fork of vim, an acceptable text editor
git clone git://git.laack.co/vim.git
Log | Files | Refs | README | LICENSE

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: