diff options
Diffstat (limited to 'data/vim/patches/8.1.1226')
-rw-r--r-- | data/vim/patches/8.1.1226 | 4826 |
1 files changed, 0 insertions, 4826 deletions
diff --git a/data/vim/patches/8.1.1226 b/data/vim/patches/8.1.1226 deleted file mode 100644 index c72a00be3..000000000 --- a/data/vim/patches/8.1.1226 +++ /dev/null @@ -1,4826 +0,0 @@ -To: vim_dev@googlegroups.com -Subject: Patch 8.1.1226 -Fcc: outbox -From: Bram Moolenaar <Bram@moolenaar.net> -Mime-Version: 1.0 -Content-Type: text/plain; charset=UTF-8 -Content-Transfer-Encoding: 8bit ------------- - -Patch 8.1.1226 -Problem: {not in Vi} remarks get in the way of useful help text. -Solution: Make a list of all Vi options, instead of mentioning what Vi does - not have. Update the help text for options. -Files: runtime/doc/vi_diff.txt, runtime/doc/options.txt - - -*** ../vim-8.1.1225/runtime/doc/vi_diff.txt 2018-05-17 13:42:04.000000000 +0200 ---- runtime/doc/vi_diff.txt 2019-04-28 15:54:57.973028174 +0200 -*************** -*** 19,26 **** - 3. Limits |limits| - 4. The most interesting additions |vim-additions| - 5. Other vim features |other-features| -! 6. Command-line arguments |cmdline-arguments| -! 7. POSIX compliance |posix-compliance| - - ============================================================================== - 1. Simulated command *simulated-command* ---- 19,27 ---- - 3. Limits |limits| - 4. The most interesting additions |vim-additions| - 5. Other vim features |other-features| -! 6. Supported Vi features |vi-features| -! 7. Command-line arguments |cmdline-arguments| -! 8. POSIX compliance |posix-compliance| - - ============================================================================== - 1. Simulated command *simulated-command* -*************** -*** 787,793 **** - The AUX: device of the Amiga is supported. - - ============================================================================== -! 6. Command-line arguments *cmdline-arguments* - - Different versions of Vi have different command-line arguments. This can be - confusing. To help you, this section gives an overview of the differences. ---- 788,867 ---- - The AUX: device of the Amiga is supported. - - ============================================================================== -! 6. Supported Vi features *vi-features* -! -! Vim supports nearly all Vi commands and mostly in the same way. That is when -! the 'compatible' option is set and 'cpoptions' contains all flags. What the -! effect is of resetting 'compatible' and removing flags from 'cpoptions' can be -! found at the help for the specific command. -! -! Below is listed what features are present in Vi. Anything else has been added -! by Vim. -! -! The following Ex commands are supported by Vi: ~ -! -! TODO -! -! `:set` but not `:set inv{option}`, `:set option&`, `:set all&`, -! `:set option+=value`, -! `:set option^=value` -! `:set option-=value` -! `:set option<` -! -! -! The following Normal mode commands are supported by Vi: ~ -! -! TODO -! -! -! The following options are supported by Vi: ~ -! -! 'autoindent' 'ai' take indent for new line from previous line -! 'autowrite' 'aw' automatically write file if changed -! 'directory' 'dir' list of directory names for the swap file -! 'edcompatible' 'ed' toggle flags of ":substitute" command -! 'errorbells' 'eb' ring the bell for error messages -! 'ignorecase' 'ic' ignore case in search patterns -! 'lines' number of lines in the display -! 'lisp' automatic indenting for Lisp -! 'list' show <Tab> and <EOL> -! 'magic' changes special characters in search patterns -! 'modeline' 'ml' recognize 'modelines' at start or end of file -! {called modelines in some Vi versions} -! 'number' 'nu' print the line number in front of each line -! 'paragraphs' 'para' nroff macros that separate paragraphs -! 'prompt' 'prompt' enable prompt in Ex mode -! 'readonly' 'ro' disallow writing the buffer {Vim sets 'readonly' -! when editing a file with `:view`} -! 'remap' allow mappings to work recursively -! 'report' threshold for reporting nr. of lines changed -! 'scroll' 'scr' lines to scroll with CTRL-U and CTRL-D -! 'sections' 'sect' nroff macros that separate sections -! 'shell' 'sh' name of shell to use for external commands -! 'shiftwidth' 'sw' number of spaces to use for (auto)indent step -! 'showmatch' 'sm' briefly jump to matching bracket if insert one -! 'showmode' 'smd' message on status line to show current mode -! 'tabstop' 'ts' number of spaces that <Tab> in file uses -! 'taglength' 'tl' number of significant characters for a tag -! 'tags' 'tag' list of file names used by the tag command -! 'tagstack' 'tgst' push tags onto the tag stack {not in all versions -! of Vi} -! 'term' name of the terminal -! 'terse' shorten some messages -! 'timeout' 'to' time out on mappings and key codes -! 'ttytype' 'tty' alias for 'term' -! 'verbose' 'vbs' give informative messages {only in some Vi -! versions as a boolean option} -! 'warn' warn for shell command when buffer was changed -! 'window' 'wi' nr of lines to scroll for CTRL-F and CTRL-B -! 'wrapmargin' 'wm' chars from the right where wrapping starts -! 'wrapscan' 'ws' searches wrap around the end of the file -! 'writeany' 'wa' write to file with no need for "!" override -! -! Also see |missing-options|. -! -! ============================================================================== -! 7. Command-line arguments *cmdline-arguments* - - Different versions of Vi have different command-line arguments. This can be - confusing. To help you, this section gives an overview of the differences. -*************** -*** 967,973 **** - @{cmdfile} Vile: use {cmdfile} as startup file. - - ============================================================================== -! 7. POSIX compliance *posix* *posix-compliance* - - In 2005 the POSIX test suite was run to check the compatibility of Vim. Most - of the test was executed properly. There are the few things where Vim ---- 1041,1047 ---- - @{cmdfile} Vile: use {cmdfile} as startup file. - - ============================================================================== -! 8. POSIX compliance *posix* *posix-compliance* - - In 2005 the POSIX test suite was run to check the compatibility of Vim. Most - of the test was executed properly. There are the few things where Vim -*************** -*** 1021,1024 **** - - ex test 534 fails because .exrc isn't read in silent mode. - - -! vim:tw=78:ts=8:ft=help:norl: ---- 1095,1098 ---- - - ex test 534 fails because .exrc isn't read in silent mode. - - -! vim:tw=78:ts=8:noet:ft=help:norl: -*** ../vim-8.1.1225/runtime/doc/options.txt 2019-04-28 14:02:25.410687613 +0200 ---- runtime/doc/options.txt 2019-04-28 15:59:07.463883436 +0200 -*************** -*** 42,54 **** - - *:set-!* *:set-inv* - :se[t] {option}! or -! :se[t] inv{option} Toggle option: Invert value. {not in Vi} - - *:set-default* *:set-&* *:set-&vi* *:set-&vim* - :se[t] {option}& Reset option to its default value. May depend on the -! current value of 'compatible'. {not in Vi} -! :se[t] {option}&vi Reset option to its Vi default value. {not in Vi} -! :se[t] {option}&vim Reset option to its Vim default value. {not in Vi} - - :se[t] all& Set all options to their default value. The values of - these options are not changed: ---- 42,54 ---- - - *:set-!* *:set-inv* - :se[t] {option}! or -! :se[t] inv{option} Toggle option: Invert value. - - *:set-default* *:set-&* *:set-&vi* *:set-&vim* - :se[t] {option}& Reset option to its default value. May depend on the -! current value of 'compatible'. -! :se[t] {option}&vi Reset option to its Vi default value. -! :se[t] {option}&vim Reset option to its Vim default value. - - :se[t] all& Set all options to their default value. The values of - these options are not changed: -*************** -*** 62,68 **** - 'ttymouse' - 'ttytype' - Warning: This may have a lot of side effects. -- {not in Vi} - - *:set-args* *E487* *E521* - :se[t] {option}={value} or ---- 62,67 ---- -*************** -*** 88,94 **** - are removed. When adding a flag that was already - present the option value doesn't change. - Also see |:set-args| above. -- {not in Vi} - - :se[t] {option}^={value} *:set^=* - Multiply the {value} to a number option, or prepend ---- 87,92 ---- -*************** -*** 96,102 **** - comma separated list, a comma is added, unless the - value was empty. - Also see |:set-args| above. -- {not in Vi} - - :se[t] {option}-={value} *:set-=* - Subtract the {value} from a number option, or remove ---- 94,99 ---- -*************** -*** 109,115 **** - exactly as they appear in the option. Remove flags - one by one to avoid problems. - Also see |:set-args| above. -- {not in Vi} - - The {option} arguments to ":set" may be repeated. For example: > - :set ai nosi sw=3 ts=3 ---- 106,111 ---- -*************** -*** 120,129 **** - When 'verbose' is non-zero, displaying an option value will also tell where it - was last set. Example: > - :verbose set shiftwidth cindent? -! < shiftwidth=4 ~ -! Last set from modeline ~ -! cindent ~ -! Last set from /usr/local/share/vim/vim60/ftplugin/c.vim ~ - This is only done when specific option values are requested, not for ":verbose - set all" or ":verbose set" without an argument. - When the option was set by hand there is no "Last set" message. ---- 116,125 ---- - When 'verbose' is non-zero, displaying an option value will also tell where it - was last set. Example: > - :verbose set shiftwidth cindent? -! < shiftwidth=4 ~ -! Last set from modeline line 1 ~ -! cindent ~ -! Last set from /usr/local/share/vim/vim60/ftplugin/c.vim line 30 ~ - This is only done when specific option values are requested, not for ":verbose - set all" or ":verbose set" without an argument. - When the option was set by hand there is no "Last set" message. -*************** -*** 132,138 **** - Note that an option may also have been set as a side effect of setting - 'compatible'. - A few special texts: -! Last set from modeline ~ - Option was set in a |modeline|. - Last set from --cmd argument ~ - Option was set with command line argument |--cmd| or +. ---- 128,134 ---- - Note that an option may also have been set as a side effect of setting - 'compatible'. - A few special texts: -! Last set from modeline line 1 ~ - Option was set in a |modeline|. - Last set from --cmd argument ~ - Option was set with command line argument |--cmd| or +. -*************** -*** 305,319 **** - before the option name. - For a global option the global value is - shown (but that might change in the future). -- {not in Vi} - - :setl[ocal] {option}< Set the local value of {option} to its global value by - copying the value. -- {not in Vi} - - :se[t] {option}< For |global-local| options: Remove the local value of - {option}, so that the global value will be used. -- {not in Vi} - - *:setg* *:setglobal* - :setg[lobal] ... Like ":set" but set only the global value for a local ---- 301,312 ---- -*************** -*** 323,329 **** - local options. - Without argument: display global values for all local - options which are different from the default. -- {not in Vi} - - For buffer-local and window-local options: - Command global value local value ~ ---- 316,321 ---- -*************** -*** 354,365 **** - :setlocal makeprg=perlmake - You can switch back to using the global value by making the local value empty: > - :setlocal makeprg= -! This only works for a string option. For a boolean option you need to use the -! "<" flag, like this: > - :setlocal autoread< -! Note that for non-boolean options using "<" copies the global value to the -! local value, it doesn't switch back to using the global value (that matters -! when the global value changes later). You can also use: > - :set path< - This will make the local value of 'path' empty, so that the global value is - used. Thus it does the same as: > ---- 346,357 ---- - :setlocal makeprg=perlmake - You can switch back to using the global value by making the local value empty: > - :setlocal makeprg= -! This only works for a string option. For a number or boolean option you need -! to use the "<" flag, like this: > - :setlocal autoread< -! Note that for non-boolean and non-number options using "<" copies the global -! value to the local value, it doesn't switch back to using the global value -! (that matters when the global value changes later). You can also use: > - :set path< - This will make the local value of 'path' empty, so that the global value is - used. Thus it does the same as: > -*************** -*** 383,393 **** - - When the optional FALLBACK argument is present, a - later :setfiletype command will override the -! 'filetype'. This is to used for filetype detections -! that are just a guess. |did_filetype()| will return -! false after this command. -! -! {not in Vi} - - *option-window* *optwin* - :bro[wse] se[t] *:set-browse* *:browse-set* *:opt* *:options* ---- 375,383 ---- - - When the optional FALLBACK argument is present, a - later :setfiletype command will override the -! 'filetype'. This is to be used for filetype -! detections that are just a guess. |did_filetype()| -! will return false after this command. - - *option-window* *optwin* - :bro[wse] se[t] *:set-browse* *:browse-set* *:opt* *:options* -*************** -*** 444,450 **** - CTRL-? CTRL-H - not CTRL-? CTRL-? - -! (CTRL-? is 0177 octal, 0x7f hex) {not in Vi} - - If your delete key terminal code is wrong, but the - code for backspace is alright, you can put this in ---- 434,440 ---- - CTRL-? CTRL-H - not CTRL-? CTRL-? - -! (CTRL-? is 0177 octal, 0x7f hex) - - If your delete key terminal code is wrong, but the - code for backspace is alright, you can put this in -*************** -*** 660,666 **** - *'aleph'* *'al'* *aleph* *Aleph* - 'aleph' 'al' number (default 128 for MS-DOS, 224 otherwise) - global -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - The ASCII code for the first letter of the Hebrew alphabet. The ---- 650,655 ---- -*************** -*** 673,679 **** - *'allowrevins'* *'ari'* *'noallowrevins'* *'noari'* - 'allowrevins' 'ari' boolean (default off) - global -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - Allow CTRL-_ in Insert and Command-line mode. This is default off, to ---- 662,667 ---- -*************** -*** 685,691 **** - *'altkeymap'* *'akm'* *'noaltkeymap'* *'noakm'* - 'altkeymap' 'akm' boolean (default off) - global -- {not in Vi} - {only available when compiled with the |+farsi| - feature} - This option was for using Farsi, which has been removed. See ---- 673,678 ---- -*************** -*** 694,702 **** - *'ambiwidth'* *'ambw'* - 'ambiwidth' 'ambw' string (default: "single") - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - Only effective when 'encoding' is "utf-8" or another Unicode encoding. - Tells Vim what to do with characters with East Asian Width Class - Ambiguous (such as Euro, Registered Sign, Copyright Sign, Greek ---- 681,686 ---- -*************** -*** 733,739 **** - *'antialias'* *'anti'* *'noantialias'* *'noanti'* - 'antialias' 'anti' boolean (default: off) - global -- {not in Vi} - {only available when compiled with GUI enabled - on Mac OS X} - This option only has an effect in the GUI version of Vim on Mac OS X ---- 717,722 ---- -*************** -*** 746,752 **** - *'autochdir'* *'acd'* *'noautochdir'* *'noacd'* - 'autochdir' 'acd' boolean (default off) - global -- {not in Vi} - {only available when compiled with it, use - exists("+autochdir") to check} - When on, Vim will change the current working directory whenever you ---- 729,734 ---- -*************** -*** 758,764 **** - *'arabic'* *'arab'* *'noarabic'* *'noarab'* - 'arabic' 'arab' boolean (default off) - local to window -- {not in Vi} - {only available when compiled with the |+arabic| - feature} - This option can be set to start editing Arabic text. ---- 740,745 ---- -*************** -*** 782,788 **** - *'noarabicshape'* *'noarshape'* - 'arabicshape' 'arshape' boolean (default on) - global -- {not in Vi} - {only available when compiled with the |+arabic| - feature} - When on and 'termbidi' is off, the required visual character ---- 763,768 ---- -*************** -*** 822,831 **** - *'autoread'* *'ar'* *'noautoread'* *'noar'* - 'autoread' 'ar' boolean (default off) - global or local to buffer |global-local| -- {not in Vi} - When a file has been detected to have been changed outside of Vim and - it has not been changed inside of Vim, automatically read it again. -! When the file has been deleted this is not done. |timestamp| - If this option has a local value, use this command to switch back to - using the global value: > - :set autoread< ---- 802,812 ---- - *'autoread'* *'ar'* *'noautoread'* *'noar'* - 'autoread' 'ar' boolean (default off) - global or local to buffer |global-local| - When a file has been detected to have been changed outside of Vim and - it has not been changed inside of Vim, automatically read it again. -! When the file has been deleted this is not done, so you have the text -! from before it was deleted. When it appears again then it is read. -! |timestamp| - If this option has a local value, use this command to switch back to - using the global value: > - :set autoread< -*************** -*** 839,849 **** - '{A-Z0-9}, or `{A-Z0-9} command takes one to another file. - Note that for some commands the 'autowrite' option is not used, see - 'autowriteall' for that. - - *'autowriteall'* *'awa'* *'noautowriteall'* *'noawa'* - 'autowriteall' 'awa' boolean (default off) - global -- {not in Vi} - Like 'autowrite', but also used for commands ":edit", ":enew", ":quit", - ":qall", ":exit", ":xit", ":recover" and closing the Vim window. - Setting this option also implies that Vim behaves like 'autowrite' has ---- 820,831 ---- - '{A-Z0-9}, or `{A-Z0-9} command takes one to another file. - Note that for some commands the 'autowrite' option is not used, see - 'autowriteall' for that. -+ Some buffers will not be written, specifically when 'buftype' is -+ "nowrite", "nofile", "terminal" or "prompt". - - *'autowriteall'* *'awa'* *'noautowriteall'* *'noawa'* - 'autowriteall' 'awa' boolean (default off) - global - Like 'autowrite', but also used for commands ":edit", ":enew", ":quit", - ":qall", ":exit", ":xit", ":recover" and closing the Vim window. - Setting this option also implies that Vim behaves like 'autowrite' has -*************** -*** 852,858 **** - *'background'* *'bg'* - 'background' 'bg' string (default "dark" or "light", see below) - global -- {not in Vi} - When set to "dark", Vim will try to use colors that look good on a - dark background. When set to "light", Vim will try to use colors that - look good on a light background. Any other value is illegal. ---- 834,839 ---- -*************** -*** 918,924 **** - 'backspace' 'bs' string (default "", set to "indent,eol,start" - in |defaults.vim|) - global -- {not in Vi} - Influences the working of <BS>, <Del>, CTRL-W and CTRL-U in Insert - mode. This is a list of items, separated by commas. Each item allows - a way to backspace over something: ---- 899,904 ---- -*************** -*** 942,948 **** - *'backup'* *'bk'* *'nobackup'* *'nobk'* - 'backup' 'bk' boolean (default off) - global -- {not in Vi} - Make a backup before overwriting a file. Leave it around after the - file has been successfully written. If you do not want to keep the - backup file, but you do want a backup while the file is being ---- 922,927 ---- -*************** -*** 958,964 **** - *'backupcopy'* *'bkc'* - 'backupcopy' 'bkc' string (Vi default for Unix: "yes", otherwise: "auto") - global or local to buffer |global-local| -- {not in Vi} - When writing a file and a backup is made, this option tells how it's - done. This is a comma separated list of words. - ---- 937,942 ---- -*************** -*** 1029,1035 **** - for MS-DOS and Win32: ".,$TEMP,c:/tmp,c:/temp" - for Unix: ".,~/tmp,~/") - global -- {not in Vi} - List of directories for the backup file, separated with commas. - - The backup file will be created in the first directory in the list - where this is possible. The directory must exist, Vim will not ---- 1007,1012 ---- -*************** -*** 1048,1056 **** - - To include a comma in a directory name precede it with a backslash. - - A directory name may end in an '/'. - - For Unix and Win32, if a directory ends in two path separators "//", -! the swap file name will be built from the complete path to the file -! with all path separators changed to percent '%' signs. This will -! ensure file name uniqueness in the backup directory. - On Win32, it is also possible to end with "\\". However, When a - separating comma is following, you must use "//", since "\\" will - include the comma in the file name. Therefore it is recommended to ---- 1025,1033 ---- - - To include a comma in a directory name precede it with a backslash. - - A directory name may end in an '/'. - - For Unix and Win32, if a directory ends in two path separators "//", -! the backup file name will be built from the complete path to the -! file with all path separators changed to percent '%' signs. This -! will ensure file name uniqueness in the backup directory. - On Win32, it is also possible to end with "\\". However, When a - separating comma is following, you must use "//", since "\\" will - include the comma in the file name. Therefore it is recommended to -*************** -*** 1075,1081 **** - *'backupext'* *'bex'* *E589* - 'backupext' 'bex' string (default "~", for VMS: "_") - global -- {not in Vi} - String which is appended to a file name to make the name of the - backup file. The default is quite unusual, because this avoids - accidentally overwriting existing files with a backup file. You might ---- 1052,1057 ---- -*************** -*** 1094,1100 **** - Unix: "/tmp/*,$TMPDIR/*,$TMP/*,$TEMP/*" - Mac: "/private/tmp/*,$TMPDIR/*,$TMP/*,$TEMP/*") - global -- {not in Vi} - {not available when compiled without the |+wildignore| - feature} - A list of file patterns. When one of the patterns matches with the ---- 1070,1075 ---- -*************** -*** 1121,1127 **** - *'balloondelay'* *'bdlay'* - 'balloondelay' 'bdlay' number (default: 600) - global -- {not in Vi} - {only available when compiled with the |+balloon_eval| - feature} - Delay in milliseconds before a balloon may pop up. See |balloon-eval|. ---- 1096,1101 ---- -*************** -*** 1129,1135 **** - *'ballooneval'* *'beval'* *'noballooneval'* *'nobeval'* - 'ballooneval' 'beval' boolean (default off) - global -- {not in Vi} - {only available when compiled with the |+balloon_eval| - feature} - Switch on the |balloon-eval| functionality for the GUI. ---- 1103,1108 ---- -*************** -*** 1138,1144 **** - *'nobevalterm'* - 'balloonevalterm' 'bevalterm' boolean (default off) - global -- {not in Vi} - {only available when compiled with the - |+balloon_eval_term| feature} - Switch on the |balloon-eval| functionality for the terminal. ---- 1111,1116 ---- -*************** -*** 1146,1152 **** - *'balloonexpr'* *'bexpr'* - 'balloonexpr' 'bexpr' string (default "") - global or local to buffer |global-local| -- {not in Vi} - {only available when compiled with the |+balloon_eval| - feature} - Expression for text to show in evaluation balloon. It is only used ---- 1118,1123 ---- -*************** -*** 1194,1200 **** - *'belloff'* *'bo'* - 'belloff' 'bo' string (default "") - global -- {not in Vi} - Specifies for which events the bell will not be rung. It is a comma - separated list of items. For each item that is present, the bell - will be silenced. This is most useful to specify specific events in ---- 1165,1170 ---- -*************** -*** 1235,1241 **** - *'binary'* *'bin'* *'nobinary'* *'nobin'* - 'binary' 'bin' boolean (default off) - local to buffer -- {not in Vi} - This option should be set before editing a binary file. You can also - use the |-b| Vim argument. When this option is switched on a few - options will be changed (also when it already was on): ---- 1205,1210 ---- -*************** -*** 1266,1280 **** - *'bioskey'* *'biosk'* *'nobioskey'* *'nobiosk'* - 'bioskey' 'biosk' boolean (default on) - global -! {not in Vi} {only for MS-DOS} - This was for MS-DOS and is no longer supported. - - *'bomb'* *'nobomb'* - 'bomb' boolean (default off) - local to buffer -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - When writing a file and the following conditions are met, a BOM (Byte - Order Mark) is prepended to the file: - - this option is on ---- 1235,1246 ---- - *'bioskey'* *'biosk'* *'nobioskey'* *'nobiosk'* - 'bioskey' 'biosk' boolean (default on) - global -! {only for MS-DOS} - This was for MS-DOS and is no longer supported. - - *'bomb'* *'nobomb'* - 'bomb' boolean (default off) - local to buffer - When writing a file and the following conditions are met, a BOM (Byte - Order Mark) is prepended to the file: - - this option is on -*************** -*** 1294,1300 **** - *'breakat'* *'brk'* - 'breakat' 'brk' string (default " ^I!@*-+;:,./?") - global -- {not in Vi} - {not available when compiled without the |+linebreak| - feature} - This option lets you choose which characters might cause a line ---- 1260,1265 ---- -*************** -*** 1304,1310 **** - *'breakindent'* *'bri'* *'nobreakindent'* *'nobri'* - 'breakindent' 'bri' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+linebreak| - feature} - Every wrapped line will continue visually indented (same amount of ---- 1269,1274 ---- -*************** -*** 1315,1321 **** - *'breakindentopt'* *'briopt'* - 'breakindentopt' 'briopt' string (default empty) - local to window -- {not in Vi} - {not available when compiled without the |+linebreak| - feature} - Settings for 'breakindent'. It can consist of the following optional ---- 1279,1284 ---- -*************** -*** 1337,1344 **** - *'browsedir'* *'bsdir'* - 'browsedir' 'bsdir' string (default: "last") - global -! {not in Vi} {only for Motif, Athena, GTK, Mac and -! Win32 GUI} - Which directory to use for the file browser: - last Use same directory as with last file browser, where a - file was opened or saved. ---- 1300,1306 ---- - *'browsedir'* *'bsdir'* - 'browsedir' 'bsdir' string (default: "last") - global -! {only for Motif, Athena, GTK, Mac and Win32 GUI} - Which directory to use for the file browser: - last Use same directory as with last file browser, where a - file was opened or saved. -*************** -*** 1349,1355 **** - *'bufhidden'* *'bh'* - 'bufhidden' 'bh' string (default: "") - local to buffer -- {not in Vi} - This option specifies what happens when a buffer is no longer - displayed in a window: - <empty> follow the global 'hidden' option ---- 1311,1316 ---- -*************** -*** 1373,1379 **** - *'buflisted'* *'bl'* *'nobuflisted'* *'nobl'* *E85* - 'buflisted' 'bl' boolean (default: on) - local to buffer -- {not in Vi} - When this option is set, the buffer shows up in the buffer list. If - it is reset it is not used for ":bnext", "ls", the Buffers menu, etc. - This option is reset by Vim for buffers that are only used to remember ---- 1334,1339 ---- -*************** -*** 1383,1389 **** - *'buftype'* *'bt'* *E382* - 'buftype' 'bt' string (default: "") - local to buffer -- {not in Vi} - The value of this option specifies the type of a buffer: - <empty> normal buffer - nofile buffer which is not related to a file and will not be ---- 1343,1348 ---- -*************** -*** 1435,1443 **** - *'casemap'* *'cmp'* - 'casemap' 'cmp' string (default: "internal,keepascii") - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - Specifies details about changing the case of letters. It may contain - these words, separated by a comma: - internal Use internal case mapping functions, the current ---- 1394,1399 ---- -*************** -*** 1453,1459 **** - *'cdpath'* *'cd'* *E344* *E346* - 'cdpath' 'cd' string (default: equivalent to $CDPATH or ",,") - global -- {not in Vi} - {not available when compiled without the - |+file_in_path| feature} - This is a list of directories which will be searched when using the ---- 1409,1414 ---- -*************** -*** 1475,1481 **** - *'cedit'* - 'cedit' string (Vi default: "", Vim default: CTRL-F) - global -- {not in Vi} - {not available when compiled without the |+vertsplit| - feature} - The key used in Command-line Mode to open the command-line window. ---- 1430,1435 ---- -*************** -*** 1493,1501 **** - *'charconvert'* *'ccv'* *E202* *E214* *E513* - 'charconvert' 'ccv' string (default "") - global -! {only available when compiled with the |+multi_byte| -! and |+eval| features} -! {not in Vi} - An expression that is used for character encoding conversion. It is - evaluated when a file that is to be read or has been written has a - different encoding from what is desired. ---- 1447,1453 ---- - *'charconvert'* *'ccv'* *E202* *E214* *E513* - 'charconvert' 'ccv' string (default "") - global -! {only available when compiled with the |+eval| feature} - An expression that is used for character encoding conversion. It is - evaluated when a file that is to be read or has been written has a - different encoding from what is desired. -*************** -*** 1538,1544 **** - *'cindent'* *'cin'* *'nocindent'* *'nocin'* - 'cindent' 'cin' boolean (default off) - local to buffer -- {not in Vi} - {not available when compiled without the |+cindent| - feature} - Enables automatic C program indenting. See 'cinkeys' to set the keys ---- 1490,1495 ---- -*************** -*** 1557,1563 **** - *'cinkeys'* *'cink'* - 'cinkeys' 'cink' string (default "0{,0},0),0],:,0#,!^F,o,O,e") - local to buffer -- {not in Vi} - {not available when compiled without the |+cindent| - feature} - A list of keys that, when typed in Insert mode, cause reindenting of ---- 1508,1513 ---- -*************** -*** 1569,1575 **** - *'cinoptions'* *'cino'* - 'cinoptions' 'cino' string (default "") - local to buffer -- {not in Vi} - {not available when compiled without the |+cindent| - feature} - The 'cinoptions' affect the way 'cindent' reindents lines in a C ---- 1519,1524 ---- -*************** -*** 1580,1586 **** - *'cinwords'* *'cinw'* - 'cinwords' 'cinw' string (default "if,else,while,do,for,switch") - local to buffer -- {not in Vi} - {not available when compiled without both the - |+cindent| and the |+smartindent| features} - These keywords start an extra indent in the next line when ---- 1529,1534 ---- -*************** -*** 1594,1600 **** - 'clipboard' 'cb' string (default "autoselect,exclude:cons\|linux" - for X-windows, "" otherwise) - global -- {not in Vi} - {only in GUI versions or when the |+xterm_clipboard| - feature is included} - This option is a list of comma separated names. ---- 1542,1547 ---- -*************** -*** 1629,1638 **** - area extended, Vim tries to become the owner of the - windowing system's global selection or put the - selected text on the clipboard used by the selection -! register "*. See |guioptions_a| and |quotestar| for -! details. When the GUI is active, the 'a' flag in -! 'guioptions' is used, when the GUI is not active, this -! "autoselect" flag is used. - Also applies to the modeless selection. - - *clipboard-autoselectplus* ---- 1576,1585 ---- - area extended, Vim tries to become the owner of the - windowing system's global selection or put the - selected text on the clipboard used by the selection -! register "*. See |'go-a'| and |quotestar| for details. -! When the GUI is active, the 'a' flag in 'guioptions' -! is used, when the GUI is not active, this "autoselect" -! flag is used. - Also applies to the modeless selection. - - *clipboard-autoselectplus* -*************** -*** 1653,1659 **** - You probably want to add this only temporarily, - possibly use BufEnter autocommands. - Only supported for GTK version 2 and later. -- Only available with the |+multi_byte| feature. - - *clipboard-exclude* - exclude:{pattern} ---- 1600,1605 ---- -*************** -*** 1680,1686 **** - *'cmdheight'* *'ch'* - 'cmdheight' 'ch' number (default 1) - global -- {not in Vi} - Number of screen lines to use for the command-line. Helps avoiding - |hit-enter| prompts. - The value of this option is stored with the tab page, so that each tab ---- 1626,1631 ---- -*************** -*** 1689,1695 **** - *'cmdwinheight'* *'cwh'* - 'cmdwinheight' 'cwh' number (default 7) - global -- {not in Vi} - {not available when compiled without the |+vertsplit| - feature} - Number of screen lines to use for the command-line window. |cmdwin| ---- 1634,1639 ---- -*************** -*** 1697,1703 **** - *'colorcolumn'* *'cc'* - 'colorcolumn' 'cc' string (default "") - local to window -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - 'colorcolumn' is a comma separated list of screen columns that are ---- 1641,1646 ---- -*************** -*** 1716,1722 **** - *'columns'* *'co'* *E594* - 'columns' 'co' number (default 80 or terminal width) - global -- {not in Vi} - Number of columns of the screen. Normally this is set by the terminal - initialization and does not have to be set by hand. Also see - |posix-screen-size|. ---- 1659,1664 ---- -*************** -*** 1735,1741 **** - 'comments' 'com' string (default - "s1:/*,mb:*,ex:*/,://,b:#,:%,:XCOMM,n:>,fb:-") - local to buffer -- {not in Vi} - {not available when compiled without the |+comments| - feature} - A comma separated list of strings that can start a comment line. See ---- 1677,1682 ---- -*************** -*** 1745,1751 **** - *'commentstring'* *'cms'* *E537* - 'commentstring' 'cms' string (default "/*%s*/") - local to buffer -- {not in Vi} - {not available when compiled without the |+folding| - feature} - A template for a comment. The "%s" in the value is replaced with the ---- 1686,1691 ---- -*************** -*** 1756,1762 **** - 'compatible' 'cp' boolean (default on, off when a |vimrc| or |gvimrc| - file is found, reset in |defaults.vim|) - global -- {not in Vi} - This option has the effect of making Vim either more Vi-compatible, or - make Vim behave in a more useful way. - ---- 1696,1701 ---- -*************** -*** 1877,1883 **** - *'complete'* *'cpt'* *E535* - 'complete' 'cpt' string (default: ".,w,b,u,t,i") - local to buffer -- {not in Vi} - This option specifies how keyword completion |ins-completion| works - when CTRL-P or CTRL-N are used. It is also used for whole-line - completion |i_CTRL-X_CTRL-L|. It indicates the type of completion ---- 1816,1821 ---- -*************** -*** 1921,1927 **** - *'completefunc'* *'cfu'* - 'completefunc' 'cfu' string (default: empty) - local to buffer -- {not in Vi} - {not available when compiled without the |+eval| - or |+insert_expand| features} - This option specifies a function to be used for Insert mode completion ---- 1859,1864 ---- -*************** -*** 1936,1942 **** - global - {not available when compiled without the - |+insert_expand| feature} -- {not in Vi} - A comma separated list of options for Insert mode completion - |ins-completion|. The supported values are: - ---- 1873,1878 ---- -*************** -*** 1970,1976 **** - *'concealcursor'* *'cocu'* - 'concealcursor' 'cocu' string (default: "") - local to window -- {not in Vi} - {not available when compiled without the |+conceal| - feature} - Sets the modes in which text in the cursor line can also be concealed. ---- 1906,1911 ---- -*************** -*** 1990,1999 **** - displayed. E.g., when moving vertically it may change column. - - -! 'conceallevel' 'cole' *'conceallevel'* *'cole'* -! number (default 0) - local to window -- {not in Vi} - {not available when compiled without the |+conceal| - feature} - Determine how text with the "conceal" syntax attribute |:syn-conceal| ---- 1925,1933 ---- - displayed. E.g., when moving vertically it may change column. - - -! *'conceallevel'* *'cole'* -! 'conceallevel' 'cole' number (default 0) - local to window - {not available when compiled without the |+conceal| - feature} - Determine how text with the "conceal" syntax attribute |:syn-conceal| -*************** -*** 2019,2025 **** - *'confirm'* *'cf'* *'noconfirm'* *'nocf'* - 'confirm' 'cf' boolean (default off) - global -- {not in Vi} - When 'confirm' is on, certain operations that would normally - fail because of unsaved changes to a buffer, e.g. ":q" and ":e", - instead raise a |dialog| asking if you wish to save the current ---- 1953,1958 ---- -*************** -*** 2032,2044 **** - *'conskey'* *'consk'* *'noconskey'* *'noconsk'* - 'conskey' 'consk' boolean (default off) - global -- {not in Vi} {only for MS-DOS} - This was for MS-DOS and is no longer supported. - - *'copyindent'* *'ci'* *'nocopyindent'* *'noci'* - 'copyindent' 'ci' boolean (default off) - local to buffer -- {not in Vi} - Copy the structure of the existing lines indent when autoindenting a - new line. Normally the new indent is reconstructed by a series of - tabs followed by spaces as required (unless |'expandtab'| is enabled, ---- 1965,1975 ---- -*************** -*** 2054,2060 **** - 'cpoptions' 'cpo' string (Vim default: "aABceFs", - Vi default: all flags) - global -- {not in Vi} - A sequence of single character flags. When a character is present - this indicates Vi-compatible behavior. This is used for things where - not being Vi-compatible is mostly or sometimes preferred. ---- 1985,1990 ---- -*************** -*** 2088,2097 **** - See also |map_bar|. - *cpo-B* - B A backslash has no special meaning in mappings, -! abbreviations and the "to" part of the menu commands. -! Remove this flag to be able to use a backslash like a -! CTRL-V. For example, the command ":map X \<Esc>" -! results in X being mapped to: - 'B' included: "\^[" (^[ is a real <Esc>) - 'B' excluded: "<Esc>" (5 characters) - ('<' excluded in both cases) ---- 2018,2027 ---- - See also |map_bar|. - *cpo-B* - B A backslash has no special meaning in mappings, -! abbreviations, user commands and the "to" part of the -! menu commands. Remove this flag to be able to use a -! backslash like a CTRL-V. For example, the command -! ":map X \<Esc>" results in X being mapped to: - 'B' included: "\^[" (^[ is a real <Esc>) - 'B' excluded: "<Esc>" (5 characters) - ('<' excluded in both cases) -*************** -*** 2264,2270 **** - deleted only once. Also when repeating "R" with "." - and a count. - *cpo-y* -! y A yank command can be redone with ".". - *cpo-Z* - Z When using "w!" while the 'readonly' option is set, - don't reset 'readonly'. ---- 2194,2203 ---- - deleted only once. Also when repeating "R" with "." - and a count. - *cpo-y* -! y A yank command can be redone with ".". Think twice if -! you really want to use this, it may break some -! plugins, since most people expect "." to only repeat a -! change. - *cpo-Z* - Z When using "w!" while the 'readonly' option is set, - don't reset 'readonly'. -*************** -*** 2363,2369 **** - *'cryptmethod'* *'cm'* - 'cryptmethod' 'cm' string (default "blowfish2") - global or local to buffer |global-local| -- {not in Vi} - Method used for encryption when the buffer is written to a file: - *pkzip* - zip PkZip compatible method. A weak kind of encryption. ---- 2296,2301 ---- -*************** -*** 2405,2411 **** - global - {not available when compiled without the |+cscope| - feature} -- {not in Vi} - Determines how many components of the path to show in a list of tags. - See |cscopepathcomp|. - NOTE: This option is set to 0 when 'compatible' is set. ---- 2337,2342 ---- -*************** -*** 2415,2421 **** - global - {not available when compiled without the |+cscope| - feature} -- {not in Vi} - Specifies the command to execute cscope. See |cscopeprg|. - This option cannot be set from a |modeline| or in the |sandbox|, for - security reasons. ---- 2346,2351 ---- -*************** -*** 2425,2431 **** - global - {not available when compiled without the |+cscope| - or |+quickfix| features} -- {not in Vi} - Specifies whether to use quickfix window to show cscope results. - See |cscopequickfix|. - ---- 2355,2360 ---- -*************** -*** 2434,2440 **** - global - {not available when compiled without the |+cscope| - feature} -- {not in Vi} - In the absence of a prefix (-P) for cscope. setting this option enables - to use the basename of cscope.out path as the prefix. - See |cscoperelative|. ---- 2363,2368 ---- -*************** -*** 2445,2451 **** - global - {not available when compiled without the |+cscope| - feature} -- {not in Vi} - Use cscope for tag commands. See |cscope-options|. - NOTE: This option is reset when 'compatible' is set. - ---- 2373,2378 ---- -*************** -*** 2454,2460 **** - global - {not available when compiled without the |+cscope| - feature} -- {not in Vi} - Determines the order in which ":cstag" performs a search. See - |cscopetagorder|. - NOTE: This option is set to 0 when 'compatible' is set. ---- 2381,2386 ---- -*************** -*** 2465,2478 **** - global - {not available when compiled without the |+cscope| - feature} -- {not in Vi} - Give messages when adding a cscope database. See |cscopeverbose|. - NOTE: This option is reset when 'compatible' is set. - - *'cursorbind'* *'crb'* *'nocursorbind'* *'nocrb'* - 'cursorbind' 'crb' boolean (default off) - local to window -- {not in Vi} - When this option is set, as the cursor in the current - window moves other cursorbound windows (windows that also have - this option set) move their cursors to the corresponding line and ---- 2391,2402 ---- -*************** -*** 2485,2491 **** - *'cursorcolumn'* *'cuc'* *'nocursorcolumn'* *'nocuc'* - 'cursorcolumn' 'cuc' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Highlight the screen column of the cursor with CursorColumn ---- 2409,2414 ---- -*************** -*** 2500,2506 **** - *'cursorline'* *'cul'* *'nocursorline'* *'nocul'* - 'cursorline' 'cul' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Highlight the screen line of the cursor with CursorLine ---- 2423,2428 ---- -*************** -*** 2513,2519 **** - *'debug'* - 'debug' string (default "") - global -- {not in Vi} - These values can be used: - msg Error messages that would otherwise be omitted will be given - anyway. ---- 2435,2440 ---- -*************** -*** 2528,2534 **** - *'define'* *'def'* - 'define' 'def' string (default "^\s*#\s*define") - global or local to buffer |global-local| -- {not in Vi} - Pattern to be used to find a macro definition. It is a search - pattern, just like for the "/" command. This option is used for the - commands like "[i" and "[d" |include-search|. The 'isident' option is ---- 2449,2454 ---- -*************** -*** 2539,2552 **** - The default value is for C programs. For C++ this value would be - useful, to include const type declarations: > - ^\(#\s*define\|[a-z]*\s*const\s*[a-z]*\) - < When using the ":set" command, you need to double the backslashes! - - *'delcombine'* *'deco'* *'nodelcombine'* *'nodeco'* - 'delcombine' 'deco' boolean (default off) - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - If editing Unicode and this option is set, backspace and Normal mode - "x" delete each combining character on its own. When it is off (the - default) the character along with its combining characters are ---- 2459,2478 ---- - The default value is for C programs. For C++ this value would be - useful, to include const type declarations: > - ^\(#\s*define\|[a-z]*\s*const\s*[a-z]*\) -+ < You can also use "\ze" just before the name and continue the pattern -+ to check what is following. E.g. for Javascript, if a function is -+ defined with "func_name = function(args)": > -+ ^\s*\ze\i\+\s*=\s*function( -+ < If the function is defined with "func_name : function() {...": > -+ ^\s*\ze\i\+\s*[:]\s*(*function\s*( - < When using the ":set" command, you need to double the backslashes! -+ To avoid that use `:let` with a single quote string: > -+ let &l:define = '^\s*\ze\k\+\s*=\s*function(' -+ < - - *'delcombine'* *'deco'* *'nodelcombine'* *'nodeco'* - 'delcombine' 'deco' boolean (default off) - global - If editing Unicode and this option is set, backspace and Normal mode - "x" delete each combining character on its own. When it is off (the - default) the character along with its combining characters are -*************** -*** 2561,2567 **** - *'dictionary'* *'dict'* - 'dictionary' 'dict' string (default "") - global or local to buffer |global-local| -- {not in Vi} - List of file names, separated by commas, that are used to lookup words - for keyword completion commands |i_CTRL-X_CTRL-K|. Each file should - contain a list of words. This can be one word per line, or several ---- 2487,2492 ---- -*************** -*** 2588,2594 **** - *'diff'* *'nodiff'* - 'diff' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+diff| - feature} - Join the current window in the group of windows that shows differences ---- 2513,2518 ---- -*************** -*** 2597,2603 **** - *'dex'* *'diffexpr'* - 'diffexpr' 'dex' string (default "") - global -- {not in Vi} - {not available when compiled without the |+diff| - feature} - Expression which is evaluated to obtain a diff file (either ed-style ---- 2521,2526 ---- -*************** -*** 2608,2614 **** - *'dip'* *'diffopt'* - 'diffopt' 'dip' string (default "internal,filler") - global -- {not in Vi} - {not available when compiled without the |+diff| - feature} - Option settings for diff mode. It can consist of the following items. ---- 2531,2536 ---- -*************** -*** 2623,2630 **** ---- 2545,2564 ---- - context:{n} Use a context of {n} lines between a change - and a fold that contains unchanged lines. - When omitted a context of six lines is used. -+ When using zero the context is actually one, -+ since folds require a line in between, also -+ for a deleted line. - See |fold-diff|. - -+ iblank Ignore changes where lines are all blank. Adds -+ the "-B" flag to the "diff" command if -+ 'diffexpr' is empty. Check the documentation -+ of the "diff" command for what this does -+ exactly. -+ NOTE: the diff windows will get out of sync, -+ because no differences between blank lines are -+ taken into account. -+ - icase Ignore changes in case of text. "a" and "A" - are considered the same. Adds the "-i" flag - to the "diff" command if 'diffexpr' is empty. -*************** -*** 2636,2641 **** ---- 2570,2587 ---- - exactly. It should ignore adding trailing - white space, but not leading white space. - -+ iwhiteall Ignore all white space changes. Adds -+ the "-w" flag to the "diff" command if -+ 'diffexpr' is empty. Check the documentation -+ of the "diff" command for what this does -+ exactly. -+ -+ iwhiteeol Ignore white space changes at end of line. -+ Adds the "-Z" flag to the "diff" command if -+ 'diffexpr' is empty. Check the documentation -+ of the "diff" command for what this does -+ exactly. -+ - horizontal Start diff mode with horizontal splits (unless - explicitly specified otherwise). - -*************** -*** 2656,2666 **** - option to see when this happens. - - indent-heuristic -! Use the indent heuristic for the internal -! diff library. - - algorithm:{text} Use the specified diff algorithm with the -! internal diff engine. Currently supported - algorithms are: - myers the default algorithm - minimal spend extra time to generate the ---- 2602,2612 ---- - option to see when this happens. - - indent-heuristic -! Use the indent heuristic for the internal -! diff library. - - algorithm:{text} Use the specified diff algorithm with the -! internal diff engine. Currently supported - algorithms are: - myers the default algorithm - minimal spend extra time to generate the -*************** -*** 2677,2683 **** - *'digraph'* *'dg'* *'nodigraph'* *'nodg'* - 'digraph' 'dg' boolean (default off) - global -- {not in Vi} - {not available when compiled without the |+digraphs| - feature} - Enable the entering of digraphs in Insert mode with {char1} <BS> ---- 2623,2628 ---- -*************** -*** 2738,2744 **** - 'display' 'dy' string (default "", set to "truncate" in - |defaults.vim|) - global -- {not in Vi} - Change the way text is displayed. This is comma separated list of - flags: - lastline When included, as much as possible of the last line ---- 2683,2688 ---- -*************** -*** 2756,2762 **** - *'eadirection'* *'ead'* - 'eadirection' 'ead' string (default "both") - global -- {not in Vi} - {not available when compiled without the |+vertsplit| - feature} - Tells when the 'equalalways' option applies: ---- 2700,2705 ---- -*************** -*** 2775,2792 **** - *'emoji'* *'emo'* *'noemoji'* *'noemo'* - 'emoji' 'emo' boolean (default: on) - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - When on all Unicode emoji characters are considered to be full width. - - - *'encoding'* *'enc'* *E543* - 'encoding' 'enc' string (default: "latin1" or value from $LANG) - global -- {only available when compiled with the |+multi_byte| -- feature} -- {not in Vi} - Sets the character encoding used inside Vim. It applies to text in - the buffers, registers, Strings in expressions, text stored in the - viminfo file, etc. It sets the kind of characters which Vim can work ---- 2718,2729 ---- -*************** -*** 2849,2855 **** - *'endofline'* *'eol'* *'noendofline'* *'noeol'* - 'endofline' 'eol' boolean (default on) - local to buffer -- {not in Vi} - When writing a file and this option is off and the 'binary' option - is on, or 'fixeol' option is off, no <EOL> will be written for the - last line in the file. This option is automatically set or reset when ---- 2786,2791 ---- -*************** -*** 2865,2871 **** - *'equalalways'* *'ea'* *'noequalalways'* *'noea'* - 'equalalways' 'ea' boolean (default on) - global -- {not in Vi} - When on, all the windows are automatically made the same size after - splitting or closing a window. This also happens the moment the - option is switched on. When off, splitting a window will reduce the ---- 2801,2806 ---- -*************** -*** 2884,2890 **** - *'equalprg'* *'ep'* - 'equalprg' 'ep' string (default "") - global or local to buffer |global-local| -- {not in Vi} - External program to use for "=" command. When this option is empty - the internal formatting functions are used; either 'lisp', 'cindent' - or 'indentexpr'. When Vim was compiled without internal formatting, ---- 2819,2824 ---- -*************** -*** 2908,2914 **** - 'errorfile' 'ef' string (Amiga default: "AztecC.Err", - others: "errors.err") - global -- {not in Vi} - {not available when compiled without the |+quickfix| - feature} - Name of the errorfile for the QuickFix mode (see |:cf|). ---- 2842,2847 ---- -*************** -*** 2923,2929 **** - *'errorformat'* *'efm'* - 'errorformat' 'efm' string (default is very long) - global or local to buffer |global-local| -- {not in Vi} - {not available when compiled without the |+quickfix| - feature} - Scanf-like description of the format for the lines in the error file ---- 2856,2861 ---- -*************** -*** 2932,2938 **** - *'esckeys'* *'ek'* *'noesckeys'* *'noek'* - 'esckeys' 'ek' boolean (Vim default: on, Vi default: off) - global -- {not in Vi} - Function keys that start with an <Esc> are recognized in Insert - mode. When this option is off, the cursor and function keys cannot be - used in Insert mode if they start with an <Esc>. The advantage of ---- 2864,2869 ---- -*************** -*** 2947,2953 **** - *'eventignore'* *'ei'* - 'eventignore' 'ei' string (default "") - global -- {not in Vi} - A list of autocommand event names, which are to be ignored. - When set to "all" or when "all" is one of the items, all autocommand - events are ignored, autocommands will not be executed. ---- 2878,2883 ---- -*************** -*** 2957,2963 **** - *'expandtab'* *'et'* *'noexpandtab'* *'noet'* - 'expandtab' 'et' boolean (default off) - local to buffer -- {not in Vi} - In Insert mode: Use the appropriate number of spaces to insert a - <Tab>. Spaces are used in indents with the '>' and '<' commands and - when 'autoindent' is on. To insert a real tab when 'expandtab' is ---- 2887,2892 ---- -*************** -*** 2969,2975 **** - *'exrc'* *'ex'* *'noexrc'* *'noex'* - 'exrc' 'ex' boolean (default off) - global -- {not in Vi} - Enables the reading of .vimrc, .exrc and .gvimrc in the current - directory. - ---- 2898,2903 ---- -*************** -*** 2988,2996 **** - *'fileencoding'* *'fenc'* *E213* - 'fileencoding' 'fenc' string (default: "") - local to buffer -- {only available when compiled with the |+multi_byte| -- feature} -- {not in Vi} - Sets the character encoding for the file of this buffer. - - When 'fileencoding' is different from 'encoding', conversion will be ---- 2916,2921 ---- -*************** -*** 3045,3053 **** - "ucs-bom,utf-8,default,latin1" when - 'encoding' is set to a Unicode value) - global -- {only available when compiled with the |+multi_byte| -- feature} -- {not in Vi} - This is a list of character encodings considered when starting to edit - an existing file. When a file is read, Vim tries to use the first - mentioned character encoding. If an error is detected, the next one ---- 2970,2975 ---- -*************** -*** 3104,3110 **** - 'fileformat' 'ff' string (MS-Windows default: "dos", - Unix, macOS default: "unix") - local to buffer -- {not in Vi} - This gives the <EOL> of the current buffer, which is used for - reading/writing the buffer from/to a file: - dos <CR> <NL> ---- 3026,3031 ---- -*************** -*** 3130,3136 **** - Vi Cygwin: "unix,dos", - Vi others: "") - global -- {not in Vi} - This gives the end-of-line (<EOL>) formats that will be tried when - starting to edit a new buffer and when reading a file into an existing - buffer: ---- 3051,3056 ---- -*************** -*** 3186,3199 **** - 'fileignorecase' 'fic' boolean (default on for systems where case in file - names is normally ignored) - global -- {not in Vi} - When set case is ignored when using file names and directories. - See 'wildignorecase' for only ignoring case when doing completion. - - *'filetype'* *'ft'* - 'filetype' 'ft' string (default: "") - local to buffer -- {not in Vi} - When this option is set, the FileType autocommand event is triggered. - All autocommands that match with the value of this option will be - executed. Thus the value of 'filetype' is used in place of the file ---- 3106,3117 ---- -*************** -*** 3219,3225 **** - *'fillchars'* *'fcs'* - 'fillchars' 'fcs' string (default "vert:|,fold:-") - global -- {not in Vi} - {not available when compiled without the |+windows| - and |+folding| features} - Characters to fill the statuslines and vertical separators. ---- 3137,3142 ---- -*************** -*** 3254,3260 **** - *'fixendofline'* *'fixeol'* *'nofixendofline'* *'nofixeol'* - 'fixendofline' 'fixeol' boolean (default on) - local to buffer -- {not in Vi} - When writing a file and this option is on, <EOL> at the end of file - will be restored if missing. Turn this option off if you want to - preserve the situation from the original file. ---- 3171,3176 ---- -*************** -*** 3265,3271 **** - *'fkmap'* *'fk'* *'nofkmap'* *'nofk'* - 'fkmap' 'fk' boolean (default off) *E198* - global -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - This option was for using Farsi, which has been removed. See ---- 3181,3186 ---- -*************** -*** 3274,3280 **** - *'foldclose'* *'fcl'* - 'foldclose' 'fcl' string (default "") - global -- {not in Vi} - {not available when compiled without the |+folding| - feature} - When set to "all", a fold is closed when the cursor isn't in it and ---- 3189,3194 ---- -*************** -*** 3284,3290 **** - *'foldcolumn'* *'fdc'* - 'foldcolumn' 'fdc' number (default 0) - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - When non-zero, a column with the specified width is shown at the side ---- 3198,3203 ---- -*************** -*** 3295,3301 **** - *'foldenable'* *'fen'* *'nofoldenable'* *'nofen'* - 'foldenable' 'fen' boolean (default on) - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - When off, all folds are open. This option can be used to quickly ---- 3208,3213 ---- -*************** -*** 3309,3315 **** - *'foldexpr'* *'fde'* - 'foldexpr' 'fde' string (default: "0") - local to window -- {not in Vi} - {not available when compiled without the |+folding| - or |+eval| features} - The expression used for when 'foldmethod' is "expr". It is evaluated ---- 3221,3226 ---- -*************** -*** 3326,3332 **** - *'foldignore'* *'fdi'* - 'foldignore' 'fdi' string (default: "#") - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - Used only when 'foldmethod' is "indent". Lines starting with ---- 3237,3242 ---- -*************** -*** 3337,3343 **** - *'foldlevel'* *'fdl'* - 'foldlevel' 'fdl' number (default: 0) - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - Sets the fold level: Folds with a higher level will be closed. ---- 3247,3252 ---- -*************** -*** 3349,3355 **** - *'foldlevelstart'* *'fdls'* - 'foldlevelstart' 'fdls' number (default: -1) - global -- {not in Vi} - {not available when compiled without the |+folding| - feature} - Sets 'foldlevel' when starting to edit another buffer in a window. ---- 3258,3263 ---- -*************** -*** 3365,3371 **** - *'foldmarker'* *'fmr'* *E536* - 'foldmarker' 'fmr' string (default: "{{{,}}}") - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - The start and end marker used when 'foldmethod' is "marker". There ---- 3273,3278 ---- -*************** -*** 3376,3382 **** - *'foldmethod'* *'fdm'* - 'foldmethod' 'fdm' string (default: "manual") - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - The kind of folding used for the current window. Possible values: ---- 3283,3288 ---- -*************** -*** 3390,3396 **** - *'foldminlines'* *'fml'* - 'foldminlines' 'fml' number (default: 1) - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - Sets the number of screen lines above which a fold can be displayed ---- 3296,3301 ---- -*************** -*** 3404,3410 **** - *'foldnestmax'* *'fdn'* - 'foldnestmax' 'fdn' number (default: 20) - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - Sets the maximum nesting of folds for the "indent" and "syntax" ---- 3309,3314 ---- -*************** -*** 3415,3421 **** - 'foldopen' 'fdo' string (default: "block,hor,mark,percent,quickfix, - search,tag,undo") - global -- {not in Vi} - {not available when compiled without the |+folding| - feature} - Specifies for which type of commands folds will be opened, if the ---- 3319,3324 ---- -*************** -*** 3452,3458 **** - *'foldtext'* *'fdt'* - 'foldtext' 'fdt' string (default: "foldtext()") - local to window -- {not in Vi} - {not available when compiled without the |+folding| - feature} - An expression which is used to specify the text displayed for a closed ---- 3355,3360 ---- -*************** -*** 3467,3473 **** - *'formatexpr'* *'fex'* - 'formatexpr' 'fex' string (default "") - local to buffer -- {not in Vi} - {not available when compiled without the |+eval| - feature} - Expression which is evaluated to format a range of lines for the |gq| ---- 3369,3374 ---- -*************** -*** 3500,3522 **** - since changing the buffer text is not allowed. - NOTE: This option is set to "" when 'compatible' is set. - -- *'formatoptions'* *'fo'* -- 'formatoptions' 'fo' string (Vim default: "tcq", Vi default: "vt") -- local to buffer -- {not in Vi} -- This is a sequence of letters which describes how automatic -- formatting is to be done. See |fo-table|. When the 'paste' option is -- on, no formatting is done (like 'formatoptions' is empty). Commas can -- be inserted for readability. -- To avoid problems with flags that are added in the future, use the -- "+=" and "-=" feature of ":set" |add-option-flags|. -- NOTE: This option is set to the Vi default value when 'compatible' is -- set and to the Vim default value when 'compatible' is reset. -- - *'formatlistpat'* *'flp'* - 'formatlistpat' 'flp' string (default: "^\s*\d\+[\]:.)}\t ]\s*") - local to buffer -- {not in Vi} - A pattern that is used to recognize a list header. This is used for - the "n" flag in 'formatoptions'. - The pattern must match exactly the text that will be the indent for ---- 3401,3409 ---- -*************** -*** 3527,3536 **** - The default recognizes a number, followed by an optional punctuation - character and white space. - - *'formatprg'* *'fp'* - 'formatprg' 'fp' string (default "") - global or local to buffer |global-local| -- {not in Vi} - The name of an external program that will be used to format the lines - selected with the |gq| operator. The program must take the input on - stdin and produce the output on stdout. The Unix program "fmt" is ---- 3414,3434 ---- - The default recognizes a number, followed by an optional punctuation - character and white space. - -+ *'formatoptions'* *'fo'* -+ 'formatoptions' 'fo' string (Vim default: "tcq", Vi default: "vt") -+ local to buffer -+ This is a sequence of letters which describes how automatic -+ formatting is to be done. See |fo-table|. When the 'paste' option is -+ on, no formatting is done (like 'formatoptions' is empty). Commas can -+ be inserted for readability. -+ To avoid problems with flags that are added in the future, use the -+ "+=" and "-=" feature of ":set" |add-option-flags|. -+ NOTE: This option is set to the Vi default value when 'compatible' is -+ set and to the Vim default value when 'compatible' is reset. -+ - *'formatprg'* *'fp'* - 'formatprg' 'fp' string (default "") - global or local to buffer |global-local| - The name of an external program that will be used to format the lines - selected with the |gq| operator. The program must take the input on - stdin and produce the output on stdout. The Unix program "fmt" is -*************** -*** 3546,3552 **** - *'fsync'* *'fs'* *'nofsync'* *'nofs'* - 'fsync' 'fs' boolean (default on) - global -- {not in Vi} - When on, the library function fsync() will be called after writing a - file. This will flush a file to disk, ensuring that it is safely - written even on filesystems which do metadata-only journaling. This ---- 3444,3449 ---- -*************** -*** 3562,3568 **** - *'gdefault'* *'gd'* *'nogdefault'* *'nogd'* - 'gdefault' 'gd' boolean (default off) - global -- {not in Vi} - When on, the ":substitute" flag 'g' is default on. This means that - all matches in a line are substituted instead of one. When a 'g' flag - is given to a ":substitute" command, this will toggle the substitution ---- 3459,3464 ---- -*************** -*** 3581,3587 **** - *'grepformat'* *'gfm'* - 'grepformat' 'gfm' string (default "%f:%l:%m,%f:%l%m,%f %l%m") - global -- {not in Vi} - Format to recognize for the ":grep" command output. - This is a scanf-like string that uses the same format as the - 'errorformat' option: see |errorformat|. ---- 3477,3482 ---- -*************** -*** 3592,3598 **** - Win32: "findstr /n" or "grep -n", - VMS: "SEARCH/NUMBERS ") - global or local to buffer |global-local| -- {not in Vi} - Program to use for the |:grep| command. This option may contain '%' - and '#' characters, which are expanded like when used in a command- - line. The placeholder "$*" is allowed to specify where the arguments ---- 3487,3492 ---- -*************** -*** 3623,3629 **** - "n-v-c:block,o:hor50,i-ci:hor15, - r-cr:hor30,sm:block") - global -- {not in Vi} - {only available when compiled with GUI enabled, and - for MS-DOS and Win32 console} - This option tells Vim what the cursor should look like in different ---- 3517,3522 ---- -*************** -*** 3702,3708 **** - *E235* *E596* - 'guifont' 'gfn' string (default "") - global -- {not in Vi} - {only available when compiled with GUI enabled} - This is a list of fonts which will be used for the GUI version of Vim. - In its simplest form the value is just one font name. ---- 3595,3600 ---- -*************** -*** 3712,3718 **** - *E250* *E252* *E234* *E597* *E598* - 'guifontset' 'gfs' string (default "") - global -- {not in Vi} - {only available when compiled with GUI enabled and - with the |+xfontset| feature} - {not available in the GTK+ GUI} ---- 3604,3609 ---- -*************** -*** 3723,3729 **** - *'guifontwide'* *'gfw'* *E231* *E533* *E534* - 'guifontwide' 'gfw' string (default "") - global -- {not in Vi} - {only available when compiled with GUI enabled} - When not empty, specifies a comma-separated list of fonts to be used - for double-width characters. The first font that can be loaded is ---- 3614,3619 ---- -*************** -*** 3732,3738 **** - *'guiheadroom'* *'ghr'* - 'guiheadroom' 'ghr' number (default 50) - global -! {not in Vi} {only for GTK and X11 GUI} - The number of pixels subtracted from the screen height when fitting - the GUI window on the screen. Set this before the GUI is started, - e.g., in your |gvimrc| file. When zero, the whole screen height will ---- 3622,3628 ---- - *'guiheadroom'* *'ghr'* - 'guiheadroom' 'ghr' number (default 50) - global -! - {only for GTK and X11 GUI} - The number of pixels subtracted from the screen height when fitting - the GUI window on the screen. Set this before the GUI is started, - e.g., in your |gvimrc| file. When zero, the whole screen height will -*************** -*** 3742,3753 **** - screen. - - *'guioptions'* *'go'* -! 'guioptions' 'go' string (default "egmrLtT" (MS-Windows, "t" is -! removed in |defaults.vim|), - "aegimrLtT" (GTK, Motif and Athena), - ) - global -- {not in Vi} - {only available when compiled with GUI enabled} - This option only has an effect in the GUI version of Vim. It is a - sequence of letters which describes what components and options of the ---- 3632,3642 ---- - screen. - - *'guioptions'* *'go'* -! 'guioptions' 'go' string (default "egmrLtT" (MS-Windows, -! "t" is removed in |defaults.vim|), - "aegimrLtT" (GTK, Motif and Athena), - ) - global - {only available when compiled with GUI enabled} - This option only has an effect in the GUI version of Vim. It is a - sequence of letters which describes what components and options of the -*************** -*** 3763,3769 **** - terminal to list the command output. - The terminal window will be positioned at the bottom, and grow - upwards as needed. -! *guioptions_a* *'go-a'* - 'a' Autoselect: If present, then whenever VISUAL mode is started, - or the Visual area extended, Vim tries to become the owner of - the windowing system's global selection. This means that the ---- 3652,3658 ---- - terminal to list the command output. - The terminal window will be positioned at the bottom, and grow - upwards as needed. -! *'go-a'* - 'a' Autoselect: If present, then whenever VISUAL mode is started, - or the Visual area extended, Vim tries to become the owner of - the windowing system's global selection. This means that the -*************** -*** 3874,3880 **** - *'guipty'* *'noguipty'* - 'guipty' boolean (default on) - global -- {not in Vi} - {only available when compiled with GUI enabled} - Only in the GUI: If on, an attempt is made to open a pseudo-tty for - I/O to/from shell commands. See |gui-pty|. ---- 3763,3768 ---- -*************** -*** 3882,3888 **** - *'guitablabel'* *'gtl'* - 'guitablabel' 'gtl' string (default empty) - global -- {not in Vi} - {only available when compiled with GUI enabled and - with the |+windows| feature} - When nonempty describes the text to use in a label of the GUI tab ---- 3770,3775 ---- -*************** -*** 3901,3907 **** - *'guitabtooltip'* *'gtt'* - 'guitabtooltip' 'gtt' string (default empty) - global -- {not in Vi} - {only available when compiled with GUI enabled and - with the |+windows| feature} - When nonempty describes the text to use in a tooltip for the GUI tab ---- 3788,3793 ---- -*************** -*** 3915,3921 **** - 'helpfile' 'hf' string (default (MSDOS) "$VIMRUNTIME\doc\help.txt" - (others) "$VIMRUNTIME/doc/help.txt") - global -- {not in Vi} - Name of the main help file. All distributed help files should be - placed together in one directory. Additionally, all "doc" directories - in 'runtimepath' will be used. ---- 3801,3806 ---- -*************** -*** 3929,3935 **** - *'helpheight'* *'hh'* - 'helpheight' 'hh' number (default 20) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - Minimal initial height of the help window when it is opened with the ---- 3814,3819 ---- -*************** -*** 3943,3949 **** - global - {only available when compiled with the |+multi_lang| - feature} -- {not in Vi} - Comma separated list of languages. Vim will use the first language - for which the desired help can be found. The English help will always - be used as a last resort. You can add "en" to prefer English over ---- 3827,3832 ---- -*************** -*** 3960,3966 **** - *'hidden'* *'hid'* *'nohidden'* *'nohid'* - 'hidden' 'hid' boolean (default off) - global -- {not in Vi} - When off a buffer is unloaded when it is |abandon|ed. When on a - buffer becomes hidden when it is |abandon|ed. If the buffer is still - displayed in another window, it does not become hidden, of course. ---- 3843,3848 ---- -*************** -*** 3980,3996 **** - l:Search,m:MoreMsg,M:ModeMsg,n:LineNr, - N:CursorLineNr,r:Question,s:StatusLine, - S:StatusLineNC,c:VertSplit,t:Title, -! v:Visual,w:WarningMsg,W:WildMenu,f:Folded, -! F:FoldColumn,A:DiffAdd,C:DiffChange, -! D:DiffDelete,T:DiffText,>:SignColumn, - B:SpellBad,P:SpellCap,R:SpellRare, -! L:SpellLocal,-:Conceal,+:Pmenu,=:PmenuSel, - x:PmenuSbar,X:PmenuThumb,*:TabLine, - #:TabLineSel,_:TabLineFill,!:CursorColumn, - .:CursorLine,o:ColorColumn,q:QuickFixLine, - z:StatusLineTerm,Z:StatusLineTermNC") - global -- {not in Vi} - This option can be used to set highlighting mode for various - occasions. It is a comma separated list of character pairs. The - first character in a pair gives the occasion, the second the mode to ---- 3862,3878 ---- - l:Search,m:MoreMsg,M:ModeMsg,n:LineNr, - N:CursorLineNr,r:Question,s:StatusLine, - S:StatusLineNC,c:VertSplit,t:Title, -! v:Visual,V:VisualNOS,w:WarningMsg, -! W:WildMenu,f:Folded,F:FoldColumn, -! A:DiffAdd,C:DiffChange,D:DiffDelete, -! T:DiffText,>:SignColumn,-:Conceal, - B:SpellBad,P:SpellCap,R:SpellRare, -! L:SpellLocal,+:Pmenu,=:PmenuSel, - x:PmenuSbar,X:PmenuThumb,*:TabLine, - #:TabLineSel,_:TabLineFill,!:CursorColumn, - .:CursorLine,o:ColorColumn,q:QuickFixLine, - z:StatusLineTerm,Z:StatusLineTermNC") - global - This option can be used to set highlighting mode for various - occasions. It is a comma separated list of character pairs. The - first character in a pair gives the occasion, the second the mode to -*************** -*** 4029,4044 **** - |hl-DiffDelete| D deleted line in diff mode - |hl-DiffText| T inserted text in diff mode - |hl-SignColumn| > column used for |signs| - |hl-SpellBad| B misspelled word |spell| - |hl-SpellCap| P word that should start with capital |spell| - |hl-SpellRare| R rare word |spell| - |hl-SpellLocal| L word from other region |spell| -! |hl-Conceal| - the placeholders used for concealed characters -! (see 'conceallevel') -! |hl-Pmenu| + popup menu normal line -! |hl-PmenuSel| = popup menu normal line -! |hl-PmenuSbar| x popup menu scrollbar -! |hl-PmenuThumb| X popup menu scrollbar thumb - - The display modes are: - r reverse (termcap entry "mr" and "me") ---- 3911,3926 ---- - |hl-DiffDelete| D deleted line in diff mode - |hl-DiffText| T inserted text in diff mode - |hl-SignColumn| > column used for |signs| -+ |hl-Conceal| - the placeholders used for concealed characters -+ (see 'conceallevel') - |hl-SpellBad| B misspelled word |spell| - |hl-SpellCap| P word that should start with capital |spell| - |hl-SpellRare| R rare word |spell| - |hl-SpellLocal| L word from other region |spell| -! |hl-Pmenu| + popup menu normal line -! |hl-PmenuSel| = popup menu selected line -! |hl-PmenuSbar| x popup menu scrollbar -! |hl-PmenuThumb| X popup menu scrollbar thumb - - The display modes are: - r reverse (termcap entry "mr" and "me") -*************** -*** 4064,4070 **** - 'history' 'hi' number (Vim default: 50, Vi default: 0, - set to 200 in |defaults.vim|) - global -- {not in Vi} - A history of ":" commands, and a history of previous search patterns - is remembered. This option decides how many entries may be stored in - each of these histories (see |cmdline-editing|). ---- 3946,3951 ---- -*************** -*** 4075,4081 **** - *'hkmap'* *'hk'* *'nohkmap'* *'nohk'* - 'hkmap' 'hk' boolean (default off) - global -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - When on, the keyboard is mapped for the Hebrew character set. ---- 3956,3961 ---- -*************** -*** 4086,4092 **** - *'hkmapp'* *'hkp'* *'nohkmapp'* *'nohkp'* - 'hkmapp' 'hkp' boolean (default off) - global -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - When on, phonetic keyboard mapping is used. 'hkmap' must also be on. ---- 3966,3971 ---- -*************** -*** 4097,4103 **** - *'hlsearch'* *'hls'* *'nohlsearch'* *'nohls'* - 'hlsearch' 'hls' boolean (default off) - global -- {not in Vi} - {not available when compiled without the - |+extra_search| feature} - When there is a previous search pattern, highlight all its matches. ---- 3976,3981 ---- -*************** -*** 4122,4128 **** - *'icon'* *'noicon'* - 'icon' boolean (default off, on when title can be restored) - global -- {not in Vi} - {not available when compiled without the |+title| - feature} - When on, the icon text of the window will be set to the value of ---- 4000,4005 ---- -*************** -*** 4141,4147 **** - *'iconstring'* - 'iconstring' string (default "") - global -- {not in Vi} - {not available when compiled without the |+title| - feature} - When this option is not empty, it will be used for the icon text of ---- 4018,4023 ---- -*************** -*** 4168,4176 **** - *'imactivatefunc'* *'imaf'* - 'imactivatefunc' 'imaf' string (default "") - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - This option specifies a function that will be called to - activate or deactivate the Input Method. - It is not used in the GUI. ---- 4044,4049 ---- -*************** -*** 4189,4195 **** - *'imactivatekey'* *'imak'* - 'imactivatekey' 'imak' string (default "") - global -- {not in Vi} - {only available when compiled with |+xim| and - |+GUI_GTK|} *E599* - Specifies the key that your Input Method in X-Windows uses for ---- 4062,4067 ---- -*************** -*** 4221,4229 **** - *'imcmdline'* *'imc'* *'noimcmdline'* *'noimc'* - 'imcmdline' 'imc' boolean (default off) - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - When set the Input Method is always on when starting to edit a command - line, unless entering a search pattern (see 'imsearch' for that). - Setting this option is useful when your input method allows entering ---- 4093,4098 ---- -*************** -*** 4233,4241 **** - *'imdisable'* *'imd'* *'noimdisable'* *'noimd'* - 'imdisable' 'imd' boolean (default off, on for some systems (SGI)) - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - When set the Input Method is never used. This is useful to disable - the IM when it doesn't work properly. - Currently this option is on by default for SGI/IRIX machines. This ---- 4102,4107 ---- -*************** -*** 4244,4250 **** - *'iminsert'* *'imi'* - 'iminsert' 'imi' number (default 0) - local to buffer -- {not in Vi} - Specifies whether :lmap or an Input Method (IM) is to be used in - Insert mode. Valid values: - 0 :lmap is off and IM is off ---- 4110,4115 ---- -*************** -*** 4263,4275 **** - methods. Use 'imdisable' to disable XIM then. - - You can set 'imactivatefunc' and 'imstatusfunc' to handle IME/XIM -! via external command if vim is not compiled with the |+xim|, - |+multi_byte_ime| or |global-ime|. - - *'imsearch'* *'ims'* - 'imsearch' 'ims' number (default -1) - local to buffer -- {not in Vi} - Specifies whether :lmap or an Input Method (IM) is to be used when - entering a search pattern. Valid values: - -1 the value of 'iminsert' is used, makes it look like ---- 4128,4139 ---- - methods. Use 'imdisable' to disable XIM then. - - You can set 'imactivatefunc' and 'imstatusfunc' to handle IME/XIM -! via external command if Vim is not compiled with the |+xim|, - |+multi_byte_ime| or |global-ime|. - - *'imsearch'* *'ims'* - 'imsearch' 'ims' number (default -1) - local to buffer - Specifies whether :lmap or an Input Method (IM) is to be used when - entering a search pattern. Valid values: - -1 the value of 'iminsert' is used, makes it look like -*************** -*** 4287,4295 **** - *'imstatusfunc'* *'imsf'* - 'imstatusfunc' 'imsf' string (default "") - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - This option specifies a function that is called to obtain the status - of Input Method. It must return a positive number when IME is active. - It is not used in the GUI. ---- 4151,4156 ---- -*************** -*** 4306,4312 **** - *'imstyle'* *'imst'* - 'imstyle' 'imst' number (default 1) - global -- {not in Vi} - {only available when compiled with |+xim| and - |+GUI_GTK|} - This option specifies the input style of Input Method: ---- 4167,4172 ---- -*************** -*** 4323,4329 **** - *'include'* *'inc'* - 'include' 'inc' string (default "^\s*#\s*include") - global or local to buffer |global-local| -- {not in Vi} - {not available when compiled without the - |+find_in_path| feature} - Pattern to be used to find an include command. It is a search ---- 4183,4188 ---- -*************** -*** 4341,4347 **** - *'includeexpr'* *'inex'* - 'includeexpr' 'inex' string (default "") - local to buffer -- {not in Vi} - {not available when compiled without the - |+find_in_path| or |+eval| features} - Expression to be used to transform the string found with the 'include' ---- 4200,4205 ---- -*************** -*** 4363,4376 **** - 'incsearch' 'is' boolean (default off, set in |defaults.vim| if the - +reltime feature is supported) - global -- {not in Vi} - {not available when compiled without the - |+extra_search| features} - While typing a search command, show where the pattern, as it was typed - so far, matches. The matched string is highlighted. If the pattern - is invalid or not found, nothing is shown. The screen will be updated - often, this is only useful on fast terminals. -! Note that the match will be shown, but the cursor will return to its - original position when no match is found and when pressing <Esc>. You - still need to finish the search command with <Enter> to move the - cursor to the match. ---- 4221,4244 ---- - 'incsearch' 'is' boolean (default off, set in |defaults.vim| if the - +reltime feature is supported) - global - {not available when compiled without the - |+extra_search| features} - While typing a search command, show where the pattern, as it was typed - so far, matches. The matched string is highlighted. If the pattern - is invalid or not found, nothing is shown. The screen will be updated - often, this is only useful on fast terminals. -! Also applies to the pattern in commands: > -! :global -! :lvimgrep -! :lvimgrepadd -! :smagic -! :snomagic -! :sort -! :substitute -! :vglobal -! :vimgrep -! :vimgrepadd -! < Note that the match will be shown, but the cursor will return to its - original position when no match is found and when pressing <Esc>. You - still need to finish the search command with <Enter> to move the - cursor to the match. -*************** -*** 4383,4391 **** - The highlighting can be set with the 'i' flag in 'highlight'. - When 'hlsearch' is on, all matched strings are highlighted too while - typing a search command. See also: 'hlsearch'. -! If you don't want turn 'hlsearch' on, but want to highlight all matches -! while searching, you can turn on and off 'hlsearch' with autocmd. -! Example: > - augroup vimrc-incsearch-highlight - autocmd! - autocmd CmdlineEnter /,\? :set hlsearch ---- 4251,4259 ---- - The highlighting can be set with the 'i' flag in 'highlight'. - When 'hlsearch' is on, all matched strings are highlighted too while - typing a search command. See also: 'hlsearch'. -! If you don't want to turn 'hlsearch' on, but want to highlight all -! matches while searching, you can turn on and off 'hlsearch' with -! autocmd. Example: > - augroup vimrc-incsearch-highlight - autocmd! - autocmd CmdlineEnter /,\? :set hlsearch -*************** -*** 4403,4409 **** - *'indentexpr'* *'inde'* - 'indentexpr' 'inde' string (default "") - local to buffer -- {not in Vi} - {not available when compiled without the |+cindent| - or |+eval| features} - Expression which is evaluated to obtain the proper indent for a line. ---- 4271,4276 ---- -*************** -*** 4441,4447 **** - *'indentkeys'* *'indk'* - 'indentkeys' 'indk' string (default "0{,0},0),0],:,0#,!^F,o,O,e") - local to buffer -- {not in Vi} - {not available when compiled without the |+cindent| - feature} - A list of keys that, when typed in Insert mode, cause reindenting of ---- 4308,4313 ---- -*************** -*** 4452,4458 **** - *'infercase'* *'inf'* *'noinfercase'* *'noinf'* - 'infercase' 'inf' boolean (default off) - local to buffer -- {not in Vi} - When doing keyword completion in insert mode |ins-completion|, and - 'ignorecase' is also on, the case of the match is adjusted depending - on the typed text. If the typed text contains a lowercase letter ---- 4318,4323 ---- -*************** -*** 4465,4471 **** - *'insertmode'* *'im'* *'noinsertmode'* *'noim'* - 'insertmode' 'im' boolean (default off) - global -- {not in Vi} - Makes Vim work in a way that Insert mode is the default mode. Useful - if you want to use Vim as a modeless editor. Used for |evim|. - These Insert mode commands will be useful: ---- 4330,4335 ---- -*************** -*** 4498,4504 **** - for OS/390: "@,240-249,/,.,-,_,+,,,#,$,%,~,=" - otherwise: "@,48-57,/,.,-,_,+,,,#,$,%,~,=") - global -- {not in Vi} - The characters specified by this option are included in file names and - path names. Filenames are used for commands like "gf", "[i" and in - the tags file. It is also used for "\f" in a |pattern|. ---- 4362,4367 ---- -*************** -*** 4550,4561 **** - "@,48-57,_,128-167,224-235" - otherwise: "@,48-57,_,192-255") - global -- {not in Vi} - The characters given by this option are included in identifiers. - Identifiers are used in recognizing environment variables and after a - match of the 'define' option. It is also used for "\i" in a - |pattern|. See 'isfname' for a description of the format of this -! option. - Careful: If you change this option, it might break expanding - environment variables. E.g., when '/' is included and Vim tries to - expand "$HOME/.viminfo". Maybe you should change 'iskeyword' instead. ---- 4413,4423 ---- - "@,48-57,_,128-167,224-235" - otherwise: "@,48-57,_,192-255") - global - The characters given by this option are included in identifiers. - Identifiers are used in recognizing environment variables and after a - match of the 'define' option. It is also used for "\i" in a - |pattern|. See 'isfname' for a description of the format of this -! option. For '@' only characters up to 255 are used. - Careful: If you change this option, it might break expanding - environment variables. E.g., when '/' is included and Vim tries to - expand "$HOME/.viminfo". Maybe you should change 'iskeyword' instead. -*************** -*** 4566,4576 **** - otherwise: "@,48-57,_,192-255" - Vi default: "@,48-57,_") - local to buffer -- {not in Vi} - Keywords are used in searching and recognizing with many commands: - "w", "*", "[i", etc. It is also used for "\k" in a |pattern|. See -! 'isfname' for a description of the format of this option. For C -! programs you could use "a-z,A-Z,48-57,_,.,-,>". - For a help file it is set to all non-blank printable characters except - '*', '"' and '|' (so that CTRL-] on a command finds the help for that - command). ---- 4428,4438 ---- - otherwise: "@,48-57,_,192-255" - Vi default: "@,48-57,_") - local to buffer - Keywords are used in searching and recognizing with many commands: - "w", "*", "[i", etc. It is also used for "\k" in a |pattern|. See -! 'isfname' for a description of the format of this option. For '@' -! characters above 255 check the "word" character class. -! For C programs you could use "a-z,A-Z,48-57,_,.,-,>". - For a help file it is set to all non-blank printable characters except - '*', '"' and '|' (so that CTRL-] on a command finds the help for that - command). -*************** -*** 4584,4590 **** - 'isprint' 'isp' string (default for MS-DOS, Win32, OS/2 and Macintosh: - "@,~-255"; otherwise: "@,161-255") - global -- {not in Vi} - The characters given by this option are displayed directly on the - screen. It is also used for "\p" in a |pattern|. The characters from - space (ASCII 32) to '~' (ASCII 126) are always displayed directly, ---- 4446,4451 ---- -*************** -*** 4615,4621 **** - *'joinspaces'* *'js'* *'nojoinspaces'* *'nojs'* - 'joinspaces' 'js' boolean (default on) - global -- {not in Vi} - Insert two spaces after a '.', '?' and '!' with a join command. - When 'cpoptions' includes the 'j' flag, only do this after a '.'. - Otherwise only one space is inserted. ---- 4476,4481 ---- -*************** -*** 4624,4630 **** - *'key'* - 'key' string (default "") - local to buffer -- {not in Vi} - {only available when compiled with the |+cryptv| - feature} - The key that is used for encrypting and decrypting the current buffer. ---- 4484,4489 ---- -*************** -*** 4642,4648 **** - *'keymap'* *'kmp'* *E544* - 'keymap' 'kmp' string (default "") - local to buffer -- {not in Vi} - {only available when compiled with the |+keymap| - feature} - Name of a keyboard mapping. See |mbyte-keymap|. ---- 4501,4506 ---- -*************** -*** 4654,4660 **** - *'keymodel'* *'km'* - 'keymodel' 'km' string (default "") - global -- {not in Vi} - List of comma separated words, which enable special things that keys - can do. These values can be used: - startsel Using a shifted special key starts selection (either ---- 4512,4517 ---- -*************** -*** 4669,4675 **** - 'keywordprg' 'kp' string (default "man" or "man -s", DOS: ":help", - VMS: "help") - global or local to buffer |global-local| -- {not in Vi} - Program to use for the |K| command. Environment variables are - expanded |:set_env|. ":help" may be used to access the Vim internal - help. (Note that previously setting the global option to the empty ---- 4526,4531 ---- -*************** -*** 4688,4694 **** - *'langmap'* *'lmap'* *E357* *E358* - 'langmap' 'lmap' string (default "") - global -- {not in Vi} - {only available when compiled with the |+langmap| - feature} - This option allows switching your keyboard into a special language ---- 4544,4549 ---- -*************** -*** 4734,4740 **** - *'langmenu'* *'lm'* - 'langmenu' 'lm' string (default "") - global -- {not in Vi} - {only available when compiled with the |+menu| and - |+multi_lang| features} - Language to use for menu translation. Tells which file is loaded ---- 4589,4594 ---- -*************** -*** 4759,4765 **** - *'langnoremap'* *'lnr'* *'nolangnoremap'* *'nolnr'* - 'langnoremap' 'lnr' boolean (default off, set in |defaults.vim|) - global -- {not in Vi} - {only available when compiled with the |+langmap| - feature} - This is just like 'langremap' but with the value inverted. It only ---- 4613,4618 ---- -*************** -*** 4769,4775 **** - *'langremap'* *'lrm'* *'nolangremap'* *'nolrm'* - 'langremap' 'lrm' boolean (default on, reset in |defaults.vim|) - global -- {not in Vi} - {only available when compiled with the |+langmap| - feature} - When off, setting 'langmap' does not apply to characters resulting from ---- 4622,4627 ---- -*************** -*** 4781,4787 **** - *'laststatus'* *'ls'* - 'laststatus' 'ls' number (default 1) - global -- {not in Vi} - The value of this option influences when the last window will have a - status line: - 0: never ---- 4633,4638 ---- -*************** -*** 4793,4799 **** - *'lazyredraw'* *'lz'* *'nolazyredraw'* *'nolz'* - 'lazyredraw' 'lz' boolean (default off) - global -- {not in Vi} - When this option is set, the screen will not be redrawn while - executing macros, registers and other commands that have not been - typed. Also, updating the window title is postponed. To force an ---- 4644,4649 ---- -*************** -*** 4802,4808 **** - *'linebreak'* *'lbr'* *'nolinebreak'* *'nolbr'* - 'linebreak' 'lbr' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+linebreak| - feature} - If on, Vim will wrap long lines at a character in 'breakat' rather ---- 4652,4657 ---- -*************** -*** 4835,4841 **** - *'linespace'* *'lsp'* - 'linespace' 'lsp' number (default 0, 1 for Win32 GUI) - global -- {not in Vi} - {only in the GUI} - Number of pixel lines inserted between characters. Useful if the font - uses the full character cell height, making lines touch each other. ---- 4684,4689 ---- -*************** -*** 4864,4870 **** - *'lispwords'* *'lw'* - 'lispwords' 'lw' string (default is very long) - global or local to buffer |global-local| -- {not in Vi} - {not available when compiled without the |+lispindent| - feature} - Comma separated list of words that influence the Lisp indenting. ---- 4712,4717 ---- -*************** -*** 4889,4895 **** - *'listchars'* *'lcs'* - 'listchars' 'lcs' string (default "eol:$") - global -- {not in Vi} - Strings to use in 'list' mode and for the |:list| command. It is a - comma separated list of string settings. - *lcs-eol* ---- 4736,4741 ---- -*************** -*** 4955,4961 **** - *'lpl'* *'nolpl'* *'loadplugins'* *'noloadplugins'* - 'loadplugins' 'lpl' boolean (default on) - global -- {not in Vi} - When on the plugin scripts are loaded when starting up |load-plugins|. - This option can be reset in your |vimrc| file to disable the loading - of plugins. ---- 4801,4806 ---- -*************** -*** 4965,4971 **** - *'luadll'* - 'luadll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+lua/dyn| - feature} - Specifies the name of the Lua shared library. The default is ---- 4810,4815 ---- -*************** -*** 5004,5010 **** - *'makeef'* *'mef'* - 'makeef' 'mef' string (default: "") - global -- {not in Vi} - {not available when compiled without the |+quickfix| - feature} - Name of the errorfile for the |:make| command (see |:make_makeprg|) ---- 4848,4853 ---- -*************** -*** 5022,5030 **** - *'makeencoding'* *'menc'* - 'makeencoding' 'menc' string (default "") - global or local to buffer |global-local| -- {only available when compiled with the |+multi_byte| -- feature} -- {not in Vi} - Encoding used for reading the output of external commands. When empty, - encoding is not converted. - This is used for `:make`, `:lmake`, `:grep`, `:lgrep`, `:grepadd`, ---- 4865,4870 ---- -*************** -*** 5041,5047 **** - *'makeprg'* *'mp'* - 'makeprg' 'mp' string (default "make", VMS: "MMS") - global or local to buffer |global-local| -- {not in Vi} - Program to use for the ":make" command. See |:make_makeprg|. - This option may contain '%' and '#' characters (see |:_%| and |:_#|), - which are expanded to the current and alternate file name. Use |::S| ---- 4881,4886 ---- -*************** -*** 5061,5067 **** - *'matchpairs'* *'mps'* - 'matchpairs' 'mps' string (default "(:),{:},[:]") - local to buffer -- {not in Vi} - Characters that form pairs. The |%| command jumps from one to the - other. - Only character pairs are allowed that are different, thus you cannot ---- 4900,4905 ---- -*************** -*** 5081,5087 **** - *'matchtime'* *'mat'* - 'matchtime' 'mat' number (default 5) - global -! {not in Vi}{in Nvi} - Tenths of a second to show the matching paren, when 'showmatch' is - set. Note that this is not in milliseconds, like other options that - set a time. This is to be compatible with Nvi. ---- 4919,4925 ---- - *'matchtime'* *'mat'* - 'matchtime' 'mat' number (default 5) - global -! {in Nvi} - Tenths of a second to show the matching paren, when 'showmatch' is - set. Note that this is not in milliseconds, like other options that - set a time. This is to be compatible with Nvi. -*************** -*** 5089,5097 **** - *'maxcombine'* *'mco'* - 'maxcombine' 'mco' number (default 2) - global -- {not in Vi} -- {only available when compiled with the |+multi_byte| -- feature} - The maximum number of combining characters supported for displaying. - Only used when 'encoding' is "utf-8". - The default is OK for most languages. Hebrew may require 4. ---- 4927,4932 ---- -*************** -*** 5103,5109 **** - *'maxfuncdepth'* *'mfd'* - 'maxfuncdepth' 'mfd' number (default 100) - global -- {not in Vi} - {not available when compiled without the |+eval| - feature} - Maximum depth of function calls for user functions. This normally ---- 4938,4943 ---- -*************** -*** 5117,5123 **** - *'maxmapdepth'* *'mmd'* *E223* - 'maxmapdepth' 'mmd' number (default 1000) - global -- {not in Vi} - Maximum number of times a mapping is done without resulting in a - character to be used. This normally catches endless mappings, like - ":map x y" with ":map y x". It still does not catch ":map g wg", ---- 4951,4956 ---- -*************** -*** 5129,5135 **** - dependent) or half the amount of memory - available) - global -- {not in Vi} - Maximum amount of memory (in Kbyte) to use for one buffer. When this - limit is reached allocating extra memory for a buffer will cause - other memory to be freed. ---- 4962,4967 ---- -*************** -*** 5141,5147 **** - *'maxmempattern'* *'mmp'* - 'maxmempattern' 'mmp' number (default 1000) - global -- {not in Vi} - Maximum amount of memory (in Kbyte) to use for pattern matching. - The maximum value is about 2000000. Use this to work without a limit. - *E363* ---- 4973,4978 ---- -*************** -*** 5150,5163 **** - Running into the limit often means that the pattern is very - inefficient or too complex. This may already happen with the pattern - "\(.\)*" on a very long line. ".*" works much better. -! Vim may run out of memory before hitting the 'maxmempattern' limit. - - *'maxmemtot'* *'mmt'* - 'maxmemtot' 'mmt' number (default between 2048 and 10240 (system - dependent) or half the amount of memory - available) - global -- {not in Vi} - Maximum amount of memory in Kbyte to use for all buffers together. - The maximum usable value is about 2000000 (2 Gbyte). Use this to work - without a limit. ---- 4981,4996 ---- - Running into the limit often means that the pattern is very - inefficient or too complex. This may already happen with the pattern - "\(.\)*" on a very long line. ".*" works much better. -! Might also happen on redraw, when syntax rules try to match a complex -! text structure. -! Vim may run out of memory before hitting the 'maxmempattern' limit, in -! which case you get an "Out of memory" error instead. - - *'maxmemtot'* *'mmt'* - 'maxmemtot' 'mmt' number (default between 2048 and 10240 (system - dependent) or half the amount of memory - available) - global - Maximum amount of memory in Kbyte to use for all buffers together. - The maximum usable value is about 2000000 (2 Gbyte). Use this to work - without a limit. -*************** -*** 5172,5178 **** - *'menuitems'* *'mis'* - 'menuitems' 'mis' number (default 25) - global -- {not in Vi} - {not available when compiled without the |+menu| - feature} - Maximum number of items to use in a menu. Used for menus that are ---- 5005,5010 ---- -*************** -*** 5182,5188 **** - *'mkspellmem'* *'msm'* - 'mkspellmem' 'msm' string (default "460000,2000,500") - global -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Parameters for |:mkspell|. This tunes when to start compressing the ---- 5014,5019 ---- -*************** -*** 5225,5231 **** - *'modelines'* *'mls'* - 'modelines' 'mls' number (default 5) - global -- {not in Vi} - If 'modeline' is on 'modelines' gives the number of lines that is - checked for set commands. If 'modeline' is off or 'modelines' is zero - no lines are checked. See |modeline|. ---- 5056,5061 ---- -*************** -*** 5235,5241 **** - *'modifiable'* *'ma'* *'nomodifiable'* *'noma'* - 'modifiable' 'ma' boolean (default on) - local to buffer -! {not in Vi} *E21* - When off the buffer contents cannot be changed. The 'fileformat' and - 'fileencoding' options also can't be changed. - Can be reset on startup with the |-M| command line argument. ---- 5065,5071 ---- - *'modifiable'* *'ma'* *'nomodifiable'* *'noma'* - 'modifiable' 'ma' boolean (default on) - local to buffer -! *E21* - When off the buffer contents cannot be changed. The 'fileformat' and - 'fileencoding' options also can't be changed. - Can be reset on startup with the |-M| command line argument. -*************** -*** 5243,5249 **** - *'modified'* *'mod'* *'nomodified'* *'nomod'* - 'modified' 'mod' boolean (default off) - local to buffer -- {not in Vi} - When on, the buffer is considered to be modified. This option is set - when: - 1. A change was made to the text since it was last written. Using the ---- 5073,5078 ---- -*************** -*** 5269,5275 **** - *'more'* *'nomore'* - 'more' boolean (Vim default: on, Vi default: off) - global -- {not in Vi} - When on, listings pause when the whole screen is filled. You will get - the |more-prompt|. When this option is off there are no pauses, the - listing continues until finished. ---- 5098,5103 ---- -*************** -*** 5280,5286 **** - 'mouse' string (default "", "a" for GUI, MS-DOS and Win32, - set to "a" in |defaults.vim|) - global -- {not in Vi} - Enable the use of the mouse. Only works for certain terminals - (xterm, MS-DOS, Win32 |win32-mouse|, QNX pterm, *BSD console with - sysmouse and Linux console with gpm). For using the mouse in the ---- 5108,5113 ---- -*************** -*** 5293,5299 **** - h all previous modes when editing a help file - a all previous modes - r for |hit-enter| and |more-prompt| prompt -! Normally you would enable the mouse in all four modes with: > - :set mouse=a - < When the mouse is not enabled, the GUI will still use the mouse for - modeless selection. This doesn't move the text cursor. ---- 5120,5126 ---- - h all previous modes when editing a help file - a all previous modes - r for |hit-enter| and |more-prompt| prompt -! Normally you would enable the mouse in all five modes with: > - :set mouse=a - < When the mouse is not enabled, the GUI will still use the mouse for - modeless selection. This doesn't move the text cursor. -*************** -*** 5308,5314 **** - *'mousefocus'* *'mousef'* *'nomousefocus'* *'nomousef'* - 'mousefocus' 'mousef' boolean (default off) - global -- {not in Vi} - {only works in the GUI} - The window that the mouse pointer is on is automatically activated. - When changing the window layout or window focus in another way, the ---- 5135,5140 ---- -*************** -*** 5319,5325 **** - *'mousehide'* *'mh'* *'nomousehide'* *'nomh'* - 'mousehide' 'mh' boolean (default on) - global -- {not in Vi} - {only works in the GUI} - When on, the mouse pointer is hidden when characters are typed. - The mouse pointer is restored when the mouse is moved. ---- 5145,5150 ---- -*************** -*** 5327,5333 **** - *'mousemodel'* *'mousem'* - 'mousemodel' 'mousem' string (default "extend", "popup" for MS-DOS and Win32) - global -- {not in Vi} - Sets the model to use for the mouse. The name mostly specifies what - the right mouse button is used for: - extend Right mouse button extends a selection. This works ---- 5152,5157 ---- -*************** -*** 5363,5372 **** - The 'mousemodel' option is set by the |:behave| command. - - *'mouseshape'* *'mouses'* *E547* -! 'mouseshape' 'mouses' string (default "i:beam,r:beam,s:updown,sd:cross, -! m:no,ml:up-arrow,v:rightup-arrow") - global -- {not in Vi} - {only available when compiled with the |+mouseshape| - feature} - This option tells Vim what the mouse pointer should look like in ---- 5187,5196 ---- - The 'mousemodel' option is set by the |:behave| command. - - *'mouseshape'* *'mouses'* *E547* -! 'mouseshape' 'mouses' string (default "i-r:beam,s:updown,sd:udsizing, -! vs:leftright,vd:lrsizing,m:no, -! ml:up-arrow,v:rightup-arrow") - global - {only available when compiled with the |+mouseshape| - feature} - This option tells Vim what the mouse pointer should look like in -*************** -*** 5431,5437 **** - *'mousetime'* *'mouset'* - 'mousetime' 'mouset' number (default 500) - global -- {not in Vi} - Only for GUI, MS-DOS, Win32 and Unix with xterm. Defines the maximum - time in msec between two mouse clicks for the second click to be - recognized as a multi click. ---- 5255,5260 ---- -*************** -*** 5439,5445 **** - *'mzschemedll'* - 'mzschemedll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+mzscheme/dyn| - feature} - Specifies the name of the MzScheme shared library. The default is ---- 5262,5267 ---- -*************** -*** 5453,5459 **** - *'mzschemegcdll'* - 'mzschemegcdll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+mzscheme/dyn| - feature} - Specifies the name of the MzScheme GC shared library. The default is ---- 5275,5280 ---- -*************** -*** 5466,5472 **** - *'mzquantum'* *'mzq'* - 'mzquantum' 'mzq' number (default 100) - global -- {not in Vi} - {not available when compiled without the |+mzscheme| - feature} - The number of milliseconds between polls for MzScheme threads. ---- 5287,5292 ---- -*************** -*** 5478,5484 **** - 'nrformats' 'nf' string (default "bin,octal,hex", - set to "bin,hex" in |defaults.vim|) - local to buffer -- {not in Vi} - This defines what bases Vim will consider for numbers when using the - CTRL-A and CTRL-X commands for adding to and subtracting from a number - respectively; see |CTRL-A| for more info on these commands. ---- 5298,5303 ---- -*************** -*** 5525,5531 **** - *'numberwidth'* *'nuw'* - 'numberwidth' 'nuw' number (Vim default: 4 Vi default: 8) - local to window -- {not in Vi} - {only available when compiled with the |+linebreak| - feature} - Minimal number of columns to use for the line number. Only relevant ---- 5344,5349 ---- -*************** -*** 5544,5550 **** - *'omnifunc'* *'ofu'* - 'omnifunc' 'ofu' string (default: empty) - local to buffer -- {not in Vi} - {not available when compiled without the |+eval| - or |+insert_expand| features} - This option specifies a function to be used for Insert mode omni ---- 5362,5367 ---- -*************** -*** 5560,5566 **** - *'opendevice'* *'odev'* *'noopendevice'* *'noodev'* - 'opendevice' 'odev' boolean (default off) - global -- {not in Vi} - {only for MS-DOS, MS-Windows and OS/2} - Enable reading and writing from devices. This may get Vim stuck on a - device that can be opened but doesn't actually do the I/O. Therefore ---- 5377,5382 ---- -*************** -*** 5572,5578 **** - *'operatorfunc'* *'opfunc'* - 'operatorfunc' 'opfunc' string (default: empty) - global -- {not in Vi} - This option specifies a function to be called by the |g@| operator. - See |:map-operator| for more info and an example. - ---- 5388,5393 ---- -*************** -*** 5583,5595 **** - *'osfiletype'* *'oft'* - 'osfiletype' 'oft' string (default: "") - local to buffer -- {not in Vi} - This option was supported on RISC OS, which has been removed. - - - *'packpath'* *'pp'* - 'packpath' 'pp' string (default: see 'runtimepath') -- {not in Vi} - Directories used to find packages. See |packages|. - - ---- 5398,5408 ---- -*************** -*** 5602,5608 **** - *'paste'* *'nopaste'* - 'paste' boolean (default off) - global -- {not in Vi} - Put Vim in Paste mode. This is useful if you want to cut or copy - some text from one window and paste it in Vim. This will avoid - unexpected effects. ---- 5415,5420 ---- -*************** -*** 5646,5652 **** - *'pastetoggle'* *'pt'* - 'pastetoggle' 'pt' string (default "") - global -- {not in Vi} - When non-empty, specifies the key sequence that toggles the 'paste' - option. This is like specifying a mapping: > - :map {keys} :set invpaste<CR> ---- 5458,5463 ---- -*************** -*** 5671,5677 **** - *'pex'* *'patchexpr'* - 'patchexpr' 'pex' string (default "") - global -- {not in Vi} - {not available when compiled without the |+diff| - feature} - Expression which is evaluated to apply a patch to a file and generate ---- 5482,5487 ---- -*************** -*** 5680,5686 **** - *'patchmode'* *'pm'* *E205* *E206* - 'patchmode' 'pm' string (default "") - global -- {not in Vi} - When non-empty the oldest version of a file is kept. This can be used - to keep the original version of a file if you are changing files in a - source distribution. Only the first time that a file is written a ---- 5490,5495 ---- -*************** -*** 5703,5709 **** - on OS/2: ".,/emx/include,," - other systems: ".,,") - global or local to buffer |global-local| -- {not in Vi} - This is a list of directories which will be searched when using the - |gf|, [f, ]f, ^Wf, |:find|, |:sfind|, |:tabfind| and other commands, - provided that the file being searched for has a relative path (not ---- 5512,5517 ---- -*************** -*** 5756,5762 **** - *'perldll'* - 'perldll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+perl/dyn| - feature} - Specifies the name of the Perl shared library. The default is ---- 5564,5569 ---- -*************** -*** 5768,5774 **** - *'preserveindent'* *'pi'* *'nopreserveindent'* *'nopi'* - 'preserveindent' 'pi' boolean (default off) - local to buffer -- {not in Vi} - When changing the indent of the current line, preserve as much of the - indent structure as possible. Normally the indent is replaced by a - series of tabs followed by spaces as required (unless |'expandtab'| is ---- 5575,5580 ---- -*************** -*** 5786,5792 **** - *'previewheight'* *'pvh'* - 'previewheight' 'pvh' number (default 12) - global -- {not in Vi} - {not available when compiled without the |+windows| or - |+quickfix| features} - Default height for a preview window. Used for |:ptag| and associated ---- 5592,5597 ---- -*************** -*** 5796,5802 **** - *'pvw'* *'nopvw'* *E590* - 'previewwindow' 'pvw' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+windows| or - |+quickfix| features} - Identifies the preview window. Only one window can have this option ---- 5601,5606 ---- -*************** -*** 5806,5812 **** - *'printdevice'* *'pdev'* - 'printdevice' 'pdev' string (default empty) - global -- {not in Vi} - {only available when compiled with the |+printer| - feature} - The name of the printer to be used for |:hardcopy|. ---- 5610,5615 ---- -*************** -*** 5815,5832 **** - security reasons. - - *'printencoding'* *'penc'* -! 'printencoding' 'penc' String (default empty, except for some systems) - global -- {not in Vi} - {only available when compiled with the |+printer| - and |+postscript| features} - Sets the character encoding used when printing. - See |penc-option|. - - *'printexpr'* *'pexpr'* -! 'printexpr' 'pexpr' String (default: see below) - global -- {not in Vi} - {only available when compiled with the |+printer| - and |+postscript| features} - Expression used to print the PostScript produced with |:hardcopy|. ---- 5618,5633 ---- - security reasons. - - *'printencoding'* *'penc'* -! 'printencoding' 'penc' string (default empty, except for some systems) - global - {only available when compiled with the |+printer| - and |+postscript| features} - Sets the character encoding used when printing. - See |penc-option|. - - *'printexpr'* *'pexpr'* -! 'printexpr' 'pexpr' string (default: see below) - global - {only available when compiled with the |+printer| - and |+postscript| features} - Expression used to print the PostScript produced with |:hardcopy|. -*************** -*** 5837,5843 **** - *'printfont'* *'pfn'* - 'printfont' 'pfn' string (default "courier") - global -- {not in Vi} - {only available when compiled with the |+printer| - feature} - The name of the font that will be used for |:hardcopy|. ---- 5638,5643 ---- -*************** -*** 5846,5852 **** - *'printheader'* *'pheader'* - 'printheader' 'pheader' string (default "%<%f%h%m%=Page %N") - global -- {not in Vi} - {only available when compiled with the |+printer| - feature} - The format of the header produced in |:hardcopy| output. ---- 5646,5651 ---- -*************** -*** 5855,5879 **** - *'printmbcharset'* *'pmbcs'* - 'printmbcharset' 'pmbcs' string (default "") - global -! {not in Vi} -! {only available when compiled with the |+printer|, -! |+postscript| and |+multi_byte| features} - The CJK character set to be used for CJK output from |:hardcopy|. - See |pmbcs-option|. - - *'printmbfont'* *'pmbfn'* - 'printmbfont' 'pmbfn' string (default "") - global -! {not in Vi} -! {only available when compiled with the |+printer|, -! |+postscript| and |+multi_byte| features} - List of font names to be used for CJK output from |:hardcopy|. - See |pmbfn-option|. - - *'printoptions'* *'popt'* - 'printoptions' 'popt' string (default "") - global -- {not in Vi} - {only available when compiled with |+printer| feature} - List of items that control the format of the output of |:hardcopy|. - See |popt-option|. ---- 5654,5675 ---- - *'printmbcharset'* *'pmbcs'* - 'printmbcharset' 'pmbcs' string (default "") - global -! {only available when compiled with the |+printer| -! and |+postscript| features} - The CJK character set to be used for CJK output from |:hardcopy|. - See |pmbcs-option|. - - *'printmbfont'* *'pmbfn'* - 'printmbfont' 'pmbfn' string (default "") - global -! {only available when compiled with the |+printer| -! and |+postscript| features} - List of font names to be used for CJK output from |:hardcopy|. - See |pmbfn-option|. - - *'printoptions'* *'popt'* - 'printoptions' 'popt' string (default "") - global - {only available when compiled with |+printer| feature} - List of items that control the format of the output of |:hardcopy|. - See |popt-option|. -*************** -*** 5888,5894 **** - global - {not available when compiled without the - |+insert_expand| feature} -- {not in Vi} - Determines the maximum number of items to show in the popup menu for - Insert mode completion. When zero as much space as available is used. - |ins-completion-menu|. ---- 5684,5689 ---- -*************** -*** 5898,5911 **** - global - {not available when compiled without the - |+insert_expand| feature} -- {not in Vi} - Determines the minimum width to use for the popup menu for Insert mode - completion. |ins-completion-menu|. - - *'pythondll'* - 'pythondll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+python/dyn| - feature} - Specifies the name of the Python 2.x shared library. The default is ---- 5693,5704 ---- -*************** -*** 5917,5923 **** - *'pythonhome'* - 'pythonhome' string (default "") - global -- {not in Vi} - {only available when compiled with the |+python/dyn| - feature} - Specifies the name of the Python 2.x home directory. When 'pythonhome' ---- 5710,5715 ---- -*************** -*** 5931,5937 **** - *'pythonthreedll'* - 'pythonthreedll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+python3/dyn| - feature} - Specifies the name of the Python 3 shared library. The default is ---- 5723,5728 ---- -*************** -*** 5943,5949 **** - *'pythonthreehome'* - 'pythonthreehome' string (default "") - global -- {not in Vi} - {only available when compiled with the |+python3/dyn| - feature} - Specifies the name of the Python 3 home directory. When ---- 5734,5739 ---- -*************** -*** 5957,5963 **** - *'pyxversion'* *'pyx'* - 'pyxversion' 'pyx' number (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+python| or - the |+python3| feature} - Specifies the python version used for pyx* functions and commands ---- 5747,5752 ---- -*************** -*** 5985,5991 **** - *'quoteescape'* *'qe'* - 'quoteescape' 'qe' string (default "\") - local to buffer -- {not in Vi} - The characters that are used to escape quotes in a string. Used for - objects like a', a" and a` |a'|. - When one of the characters in this option is found inside a string, ---- 5774,5779 ---- -*************** -*** 6000,6013 **** - in read-only mode ("vim -R") or when the executable is called "view". - When using ":w!" the 'readonly' option is reset for the current - buffer, unless the 'Z' flag is in 'cpoptions'. -! {not in Vi:} When using the ":view" command the 'readonly' option is -! set for the newly edited buffer. - See 'modifiable' for disallowing changes to the buffer. - - *'redrawtime'* *'rdt'* - 'redrawtime' 'rdt' number (default 2000) - global -- {not in Vi} - {only available when compiled with the |+reltime| - feature} - The time in milliseconds for redrawing the display. This applies to ---- 5788,5800 ---- - in read-only mode ("vim -R") or when the executable is called "view". - When using ":w!" the 'readonly' option is reset for the current - buffer, unless the 'Z' flag is in 'cpoptions'. -! When using the ":view" command the 'readonly' option is set for the -! newly edited buffer. - See 'modifiable' for disallowing changes to the buffer. - - *'redrawtime'* *'rdt'* - 'redrawtime' 'rdt' number (default 2000) - global - {only available when compiled with the |+reltime| - feature} - The time in milliseconds for redrawing the display. This applies to -*************** -*** 6023,6029 **** - *'regexpengine'* *'re'* - 'regexpengine' 're' number (default 0) - global -- {not in Vi} - This selects the default regexp engine. |two-engines| - The possible values are: - 0 automatic selection ---- 5810,5815 ---- -*************** -*** 6040,6046 **** - *'relativenumber'* *'rnu'* *'norelativenumber'* *'nornu'* - 'relativenumber' 'rnu' boolean (default off) - local to window -- {not in Vi} - Show the line number relative to the line with the cursor in front of - each line. Relative line numbers help you use the |count| you can - precede some vertical motion commands (e.g. j k + -) with, without ---- 5826,5831 ---- -*************** -*** 6072,6078 **** - *'renderoptions'* *'rop'* - 'renderoptions' 'rop' string (default: empty) - global -- {not in Vi} - {only available when compiled with GUI and DIRECTX on - MS-Windows} - Select a text renderer and set its options. The options depend on the ---- 5857,5862 ---- -*************** -*** 6179,6185 **** - *'restorescreen'* *'rs'* *'norestorescreen'* *'nors'* - 'restorescreen' 'rs' boolean (default on) - global -! {not in Vi} {only in Windows 95/NT console version} - When set, the screen contents is restored when exiting Vim. This also - happens when executing external commands. - ---- 5963,5969 ---- - *'restorescreen'* *'rs'* *'norestorescreen'* *'nors'* - 'restorescreen' 'rs' boolean (default on) - global -! {only in Windows 95/NT console version} - When set, the screen contents is restored when exiting Vim. This also - happens when executing external commands. - -*************** -*** 6193,6199 **** - *'revins'* *'ri'* *'norevins'* *'nori'* - 'revins' 'ri' boolean (default off) - global -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - Inserting characters in Insert mode will work backwards. See "typing ---- 5977,5982 ---- -*************** -*** 6206,6212 **** - *'rightleft'* *'rl'* *'norightleft'* *'norl'* - 'rightleft' 'rl' boolean (default off) - local to window -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - When on, display orientation becomes right-to-left, i.e., characters ---- 5989,5994 ---- -*************** -*** 6222,6228 **** - *'rightleftcmd'* *'rlc'* - 'rightleftcmd' 'rlc' string (default "search") - local to window -- {not in Vi} - {only available when compiled with the |+rightleft| - feature} - Each word in this option enables the command line editing to work in ---- 6004,6009 ---- -*************** -*** 6236,6242 **** - *'rubydll'* - 'rubydll' string (default: depends on the build) - global -- {not in Vi} - {only available when compiled with the |+ruby/dyn| - feature} - Specifies the name of the Ruby shared library. The default is ---- 6017,6022 ---- -*************** -*** 6248,6254 **** - *'ruler'* *'ru'* *'noruler'* *'noru'* - 'ruler' 'ru' boolean (default off, set in |defaults.vim|) - global -- {not in Vi} - {not available when compiled without the - |+cmdline_info| feature} - Show the line and column number of the cursor position, separated by a ---- 6028,6033 ---- -*************** -*** 6278,6284 **** - *'rulerformat'* *'ruf'* - 'rulerformat' 'ruf' string (default empty) - global -- {not in Vi} - {not available when compiled without the |+statusline| - feature} - When this option is not empty, it determines the content of the ruler ---- 6057,6062 ---- -*************** -*** 6318,6324 **** - $VIM/vimfiles/after, - sys$login:vimfiles/after") - global -- {not in Vi} - This is a list of directories which will be searched for runtime - files: - filetype.vim filetypes by file name |new-filetype| ---- 6096,6101 ---- -*************** -*** 6393,6399 **** - *'scrollbind'* *'scb'* *'noscrollbind'* *'noscb'* - 'scrollbind' 'scb' boolean (default off) - local to window -- {not in Vi} - See also |scroll-binding|. When this option is set, the current - window scrolls as other scrollbind windows (windows that also have - this option set) scroll. This option is useful for viewing the ---- 6170,6175 ---- -*************** -*** 6407,6413 **** - *'scrolljump'* *'sj'* - 'scrolljump' 'sj' number (default 1) - global -- {not in Vi} - Minimal number of lines to scroll when the cursor gets off the - screen (e.g., with "j"). Not used for scroll commands (e.g., CTRL-E, - CTRL-D). Useful if your terminal scrolls very slowly. ---- 6183,6188 ---- -*************** -*** 6419,6425 **** - *'scrolloff'* *'so'* - 'scrolloff' 'so' number (default 0, set to 5 in |defaults.vim|) - global or local to window |global-local| -- {not in Vi} - Minimal number of screen lines to keep above and below the cursor. - This will make some context visible around where you are working. If - you set it to a very large value (999) the cursor line will always be ---- 6194,6199 ---- -*************** -*** 6435,6441 **** - *'scrollopt'* *'sbo'* - 'scrollopt' 'sbo' string (default "ver,jump") - global -- {not in Vi} - This is a comma-separated list of words that specifies how - 'scrollbind' windows should behave. 'sbo' stands for ScrollBind - Options. ---- 6209,6214 ---- -*************** -*** 6474,6480 **** - *'secure'* *'nosecure'* *E523* - 'secure' boolean (default off) - global -- {not in Vi} - When on, ":autocmd", shell and write commands are not allowed in - ".vimrc" and ".exrc" in the current directory and map commands are - displayed. Switch it off only if you know that you will not run into ---- 6247,6252 ---- -*************** -*** 6488,6494 **** - *'selection'* *'sel'* - 'selection' 'sel' string (default "inclusive") - global -- {not in Vi} - This option defines the behavior of the selection. It is only used - in Visual and Select mode. - Possible values: ---- 6260,6265 ---- -*************** -*** 6512,6518 **** - *'selectmode'* *'slm'* - 'selectmode' 'slm' string (default "") - global -- {not in Vi} - This is a comma separated list of words, which specifies when to start - Select mode instead of Visual mode, when a selection is started. - Possible values: ---- 6283,6288 ---- -*************** -*** 6526,6532 **** - 'sessionoptions' 'ssop' string (default: "blank,buffers,curdir,folds, - help,options,tabpages,winsize,terminal") - global -- {not in Vi} - {not available when compiled without the |+mksession| - feature} - Changes the effect of the |:mksession| command. It is a comma ---- 6296,6301 ---- -*************** -*** 6556,6562 **** - tabpages all tab pages; without this only the current tab page - is restored, so that you can make a session for each - tab page separately -! terminal include terminal windows where the command can be restored - unix with Unix end-of-line format (single <NL>), even when - on Windows or DOS - winpos position of the whole Vim window ---- 6325,6332 ---- - tabpages all tab pages; without this only the current tab page - is restored, so that you can make a session for each - tab page separately -! terminal include terminal windows where the command can be -! restored - unix with Unix end-of-line format (single <NL>), even when - on Windows or DOS - winpos position of the whole Vim window -*************** -*** 6592,6598 **** - Example with escaped space (Vim will do this when initializing the - option from $SHELL): > - :set shell=/bin/with\\\ space/sh -! < The resulting value of 'shell' is "/bin/with\ space/sh", two - backslashes are consumed by `:set`. - - Under MS-Windows, when the executable ends in ".com" it must be ---- 6362,6368 ---- - Example with escaped space (Vim will do this when initializing the - option from $SHELL): > - :set shell=/bin/with\\\ space/sh -! < The resulting value of 'shell' is "/bin/with\ space/sh", two - backslashes are consumed by `:set`. - - Under MS-Windows, when the executable ends in ".com" it must be -*************** -*** 6610,6616 **** - MS-DOS and Win32, when 'shell' does not - contain "sh" somewhere: "/c") - global -- {not in Vi} - Flag passed to the shell to execute "!" and ":!" commands; e.g., - "bash.exe -c ls" or "command.com /c dir". For the MS-DOS-like - systems, the default is set according to the value of 'shell', to ---- 6380,6385 ---- -*************** -*** 6625,6631 **** - *'shellpipe'* *'sp'* - 'shellpipe' 'sp' string (default ">", "| tee", "|& tee" or "2>&1| tee") - global -- {not in Vi} - {not available when compiled without the |+quickfix| - feature} - String to be used to put the output of the ":make" command in the ---- 6394,6399 ---- -*************** -*** 6661,6667 **** - 'shellquote' 'shq' string (default: ""; MS-DOS and Win32, when 'shell' - contains "sh" somewhere: "\"") - global -- {not in Vi} - Quoting character(s), put around the command passed to the shell, for - the "!" and ":!" commands. The redirection is kept outside of the - quoting. See 'shellxquote' to include the redirection. It's ---- 6429,6434 ---- -*************** -*** 6677,6683 **** - *'shellredir'* *'srr'* - 'shellredir' 'srr' string (default ">", ">&" or ">%s 2>&1") - global -- {not in Vi} - String to be used to put the output of a filter command in a temporary - file. See also |:!|. See |option-backslash| about including spaces - and backslashes. ---- 6444,6449 ---- -*************** -*** 6703,6709 **** - *'shellslash'* *'ssl'* *'noshellslash'* *'nossl'* - 'shellslash' 'ssl' boolean (default off) - global -! {not in Vi} {only for MSDOS, MS-Windows and OS/2} - When set, a forward slash is used when expanding file names. This is - useful when a Unix-like shell is used instead of command.com or - cmd.exe. Backward slashes can still be typed, but they are changed to ---- 6469,6475 ---- - *'shellslash'* *'ssl'* *'noshellslash'* *'nossl'* - 'shellslash' 'ssl' boolean (default off) - global -! {only for MSDOS, MS-Windows and OS/2} - When set, a forward slash is used when expanding file names. This is - useful when a Unix-like shell is used instead of command.com or - cmd.exe. Backward slashes can still be typed, but they are changed to -*************** -*** 6718,6724 **** - *'shelltemp'* *'stmp'* *'noshelltemp'* *'nostmp'* - 'shelltemp' 'stmp' boolean (Vi default off, Vim default on) - global -- {not in Vi} - When on, use temp files for shell commands. When off use a pipe. - When using a pipe is not possible temp files are used anyway. - Currently a pipe is only supported on Unix and MS-Windows 2K and ---- 6484,6489 ---- -*************** -*** 6739,6745 **** - *'shelltype'* *'st'* - 'shelltype' 'st' number (default 0) - global -! {not in Vi} {only for the Amiga} - On the Amiga this option influences the way how the commands work - which use a shell. - 0 and 1: always use the shell ---- 6504,6510 ---- - *'shelltype'* *'st'* - 'shelltype' 'st' number (default 0) - global -! {only for the Amiga} - On the Amiga this option influences the way how the commands work - which use a shell. - 0 and 1: always use the shell -*************** -*** 6754,6760 **** - 'shellxescape' 'sxe' string (default: ""; - for MS-DOS and MS-Windows: "\"&|<>()@^") - global -- {not in Vi} - When 'shellxquote' is set to "(" then the characters listed in this - option will be escaped with a '^' character. This makes it possible - to execute most external commands with cmd.exe. ---- 6519,6524 ---- -*************** -*** 6766,6772 **** - somewhere: "\"" - for Unix, when using system(): "\"") - global -- {not in Vi} - Quoting character(s), put around the command passed to the shell, for - the "!" and ":!" commands. Includes the redirection. See - 'shellquote' to exclude the redirection. It's probably not useful ---- 6530,6535 ---- -*************** -*** 6786,6792 **** - *'shiftround'* *'sr'* *'noshiftround'* *'nosr'* - 'shiftround' 'sr' boolean (default off) - global -- {not in Vi} - Round indent to multiple of 'shiftwidth'. Applies to > and < - commands. CTRL-T and CTRL-D in Insert mode always round the indent to - a multiple of 'shiftwidth' (this is Vi compatible). ---- 6549,6554 ---- -*************** -*** 6804,6810 **** - 'shortmess' 'shm' string (Vim default "filnxtToO", Vi default: "", - POSIX default: "A") - global -- {not in Vi} - This option helps to avoid all the |hit-enter| prompts caused by file - messages, for example with CTRL-G, and to avoid some other messages. - It is a list of flags: ---- 6566,6571 ---- -*************** -*** 6859,6865 **** - *'shortname'* *'sn'* *'noshortname'* *'nosn'* - 'shortname' 'sn' boolean (default off) - local to buffer -- {not in Vi, not in MS-DOS versions} - Filenames are assumed to be 8 characters plus one extension of 3 - characters. Multiple dots in file names are not allowed. When this - option is on, dots in file names are replaced with underscores when ---- 6620,6625 ---- -*************** -*** 6872,6878 **** - *'showbreak'* *'sbr'* *E595* - 'showbreak' 'sbr' string (default "") - global -- {not in Vi} - {not available when compiled without the |+linebreak| - feature} - String to put at the start of lines that have been wrapped. Useful ---- 6632,6637 ---- -*************** -*** 6894,6900 **** - 'showcmd' 'sc' boolean (Vim default: on, off for Unix, - Vi default: off, set in |defaults.vim|) - global -- {not in Vi} - {not available when compiled without the - |+cmdline_info| feature} - Show (partial) command in the last line of the screen. Set this ---- 6653,6658 ---- -*************** -*** 6912,6918 **** - *'showfulltag'* *'sft'* *'noshowfulltag'* *'nosft'* - 'showfulltag' 'sft' boolean (default off) - global -- {not in Vi} - When completing a word in insert mode (see |ins-completion|) from the - tags file, show both the tag name and a tidied-up form of the search - pattern (if there is one) as possible matches. Thus, if you have ---- 6670,6675 ---- -*************** -*** 6958,6964 **** - *'showtabline'* *'stal'* - 'showtabline' 'stal' number (default 1) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - The value of this option specifies when the line with tab page labels ---- 6715,6720 ---- -*************** -*** 6973,6979 **** - *'sidescroll'* *'ss'* - 'sidescroll' 'ss' number (default 0) - global -- {not in Vi} - The minimal number of columns to scroll horizontally. Used only when - the 'wrap' option is off and the cursor is moved off of the screen. - When it is zero the cursor will be put in the middle of the screen. ---- 6729,6734 ---- -*************** -*** 6984,6990 **** - *'sidescrolloff'* *'siso'* - 'sidescrolloff' 'siso' number (default 0) - global or local to window |global-local| -- {not in Vi} - The minimal number of screen columns to keep to the left and to the - right of the cursor if 'nowrap' is set. Setting this option to a - value greater than 0 while having |'sidescroll'| also at a non-zero ---- 6739,6744 ---- -*************** -*** 7009,7015 **** - *'signcolumn'* *'scl'* - 'signcolumn' 'scl' string (default "auto") - local to window -- {not in Vi} - {not available when compiled without the |+signs| - feature} - Whether or not to draw the signcolumn. Valid values are: ---- 6763,6768 ---- -*************** -*** 7021,7027 **** - *'smartcase'* *'scs'* *'nosmartcase'* *'noscs'* - 'smartcase' 'scs' boolean (default off) - global -- {not in Vi} - Override the 'ignorecase' option if the search pattern contains upper - case characters. Only used when the search pattern is typed and - 'ignorecase' option is on. Used for the commands "/", "?", "n", "N", ---- 6774,6779 ---- -*************** -*** 7033,7039 **** - *'smartindent'* *'si'* *'nosmartindent'* *'nosi'* - 'smartindent' 'si' boolean (default off) - local to buffer -- {not in Vi} - {not available when compiled without the - |+smartindent| feature} - Do smart autoindenting when starting a new line. Works for C-like ---- 6785,6790 ---- -*************** -*** 7062,7068 **** - *'smarttab'* *'sta'* *'nosmarttab'* *'nosta'* - 'smarttab' 'sta' boolean (default off) - global -- {not in Vi} - When on, a <Tab> in front of a line inserts blanks according to - 'shiftwidth'. 'tabstop' or 'softtabstop' is used in other places. A - <BS> will delete a 'shiftwidth' worth of space at the start of the ---- 6813,6818 ---- -*************** -*** 7080,7086 **** - *'softtabstop'* *'sts'* - 'softtabstop' 'sts' number (default 0) - local to buffer -- {not in Vi} - Number of spaces that a <Tab> counts for while performing editing - operations, like inserting a <Tab> or using <BS>. It "feels" like - <Tab>s are being inserted, while in fact a mix of spaces and <Tab>s is ---- 6830,6835 ---- -*************** -*** 7104,7110 **** - *'spell'* *'nospell'* - 'spell' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - When on spell checking will be done. See |spell|. ---- 6853,6858 ---- -*************** -*** 7113,7119 **** - *'spellcapcheck'* *'spc'* - 'spellcapcheck' 'spc' string (default "[.?!]\_[\])'" \t]\+") - local to buffer -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Pattern to locate the end of a sentence. The following word will be ---- 6861,6866 ---- -*************** -*** 7129,7135 **** - *'spellfile'* *'spf'* - 'spellfile' 'spf' string (default empty) - local to buffer -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Name of the word list file where words are added for the |zg| and |zw| ---- 6876,6881 ---- -*************** -*** 7156,7162 **** - *'spelllang'* *'spl'* - 'spelllang' 'spl' string (default "en") - local to buffer -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - A comma separated list of word list names. When the 'spell' option is ---- 6902,6907 ---- -*************** -*** 7164,7170 **** - set spelllang=en_us,nl,medical - < This means US English, Dutch and medical words are recognized. Words - that are not recognized will be highlighted. -! The word list name must not include a comma or dot. Using a dash is - recommended to separate the two letter language name from a - specification. Thus "en-rare" is used for rare English words. - A region name must come last and have the form "_xx", where "xx" is ---- 6909,6916 ---- - set spelllang=en_us,nl,medical - < This means US English, Dutch and medical words are recognized. Words - that are not recognized will be highlighted. -! The word list name must consist of alphanumeric characters, a dash or -! an underscore. It should not include a comma or dot. Using a dash is - recommended to separate the two letter language name from a - specification. Thus "en-rare" is used for rare English words. - A region name must come last and have the form "_xx", where "xx" is -*************** -*** 7193,7206 **** - - After this option has been set successfully, Vim will source the files - "spell/LANG.vim" in 'runtimepath'. "LANG" is the value of 'spelllang' -! up to the first character that is not an ASCII letter and not a dash. -! Also see |set-spc-auto|. - - - *'spellsuggest'* *'sps'* - 'spellsuggest' 'sps' string (default "best") - global -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Methods used for spelling suggestions. Both for the |z=| command and ---- 6939,6951 ---- - - After this option has been set successfully, Vim will source the files - "spell/LANG.vim" in 'runtimepath'. "LANG" is the value of 'spelllang' -! up to the first character that is not an ASCII letter or number and -! not a dash. Also see |set-spc-auto|. - - - *'spellsuggest'* *'sps'* - 'spellsuggest' 'sps' string (default "best") - global - {not available when compiled without the |+syntax| - feature} - Methods used for spelling suggestions. Both for the |z=| command and -*************** -*** 7266,7272 **** - *'splitbelow'* *'sb'* *'nosplitbelow'* *'nosb'* - 'splitbelow' 'sb' boolean (default off) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - When on, splitting a window will put the new window below the current ---- 7011,7016 ---- -*************** -*** 7275,7281 **** - *'splitright'* *'spr'* *'nosplitright'* *'nospr'* - 'splitright' 'spr' boolean (default off) - global -- {not in Vi} - {not available when compiled without the |+vertsplit| - feature} - When on, splitting a window will put the new window right of the ---- 7019,7024 ---- -*************** -*** 7284,7290 **** - *'startofline'* *'sol'* *'nostartofline'* *'nosol'* - 'startofline' 'sol' boolean (default on) - global -- {not in Vi} - When "on" the commands listed below move the cursor to the first - non-blank of the line. When off the cursor is kept in the same column - (if possible). This applies to the commands: CTRL-D, CTRL-U, CTRL-B, ---- 7027,7032 ---- -*************** -*** 7299,7305 **** - *'statusline'* *'stl'* *E540* *E542* - 'statusline' 'stl' string (default empty) - global or local to window |global-local| -- {not in Vi} - {not available when compiled without the |+statusline| - feature} - When nonempty, this option determines the content of the status line. ---- 7041,7046 ---- -*************** -*** 7422,7428 **** - line is displayed. The current buffer and current window will be set - temporarily to that of the window (and buffer) whose statusline is - currently being drawn. The expression will evaluate in this context. -! The variable "actual_curbuf" is set to the 'bufnr()' number of the - real current buffer. - - The 'statusline' option will be evaluated in the |sandbox| if set from ---- 7163,7169 ---- - line is displayed. The current buffer and current window will be set - temporarily to that of the window (and buffer) whose statusline is - currently being drawn. The expression will evaluate in this context. -! The variable "g:actual_curbuf" is set to the `bufnr()` number of the - real current buffer. - - The 'statusline' option will be evaluated in the |sandbox| if set from -*************** -*** 7466,7472 **** - *'suffixes'* *'su'* - 'suffixes' 'su' string (default ".bak,~,.o,.h,.info,.swp,.obj") - global -- {not in Vi} - Files with these suffixes get a lower priority when multiple files - match a wildcard. See |suffixes|. Commas can be used to separate the - suffixes. Spaces after the comma are ignored. A dot is also seen as ---- 7207,7212 ---- -*************** -*** 7481,7487 **** - *'suffixesadd'* *'sua'* - 'suffixesadd' 'sua' string (default "") - local to buffer -- {not in Vi} - {not available when compiled without the - |+file_in_path| feature} - Comma separated list of suffixes, which are used when searching for a ---- 7221,7226 ---- -*************** -*** 7491,7497 **** - *'swapfile'* *'swf'* *'noswapfile'* *'noswf'* - 'swapfile' 'swf' boolean (default on) - local to buffer -- {not in Vi} - Use a swapfile for the buffer. This option can be reset when a - swapfile is not wanted for a specific buffer. For example, with - confidential information that even root must not be able to access. ---- 7230,7235 ---- -*************** -*** 7514,7520 **** - *'swapsync'* *'sws'* - 'swapsync' 'sws' string (default "fsync") - global -- {not in Vi} - When this option is not empty a swap file is synced to disk after - writing to it. This takes some time, especially on busy unix systems. - When this option is empty parts of the swap file may be in memory and ---- 7252,7257 ---- -*************** -*** 7529,7535 **** - *'switchbuf'* *'swb'* - 'switchbuf' 'swb' string (default "") - global -- {not in Vi} - This option controls the behavior when switching between buffers. - Possible values (comma separated list): - useopen If included, jump to the first open window that ---- 7266,7271 ---- -*************** -*** 7543,7549 **** - pages. - split If included, split the current window before loading - a buffer for a |quickfix| command that display errors. -! Otherwise: do not split, use current window. - vsplit Just like "split" but split vertically. - newtab Like "split", but open a new tab page. Overrules - "split" when both are present. ---- 7279,7287 ---- - pages. - split If included, split the current window before loading - a buffer for a |quickfix| command that display errors. -! Otherwise: do not split, use current window (when used -! in the quickfix window: the previously used window or -! split if there is no other window). - vsplit Just like "split" but split vertically. - newtab Like "split", but open a new tab page. Overrules - "split" when both are present. -*************** -*** 7551,7557 **** - *'synmaxcol'* *'smc'* - 'synmaxcol' 'smc' number (default 3000) - local to buffer -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - Maximum column in which to search for syntax items. In long lines the ---- 7289,7294 ---- -*************** -*** 7564,7570 **** - *'syntax'* *'syn'* - 'syntax' 'syn' string (default empty) - local to buffer -- {not in Vi} - {not available when compiled without the |+syntax| - feature} - When this option is set, the syntax with this name is loaded, unless ---- 7301,7306 ---- -*************** -*** 7594,7600 **** - *'tabline'* *'tal'* - 'tabline' 'tal' string (default empty) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - When nonempty, this option determines the content of the tab pages ---- 7330,7335 ---- -*************** -*** 7621,7627 **** - *'tabpagemax'* *'tpm'* - 'tabpagemax' 'tpm' number (default 10) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - Maximum number of tab pages to be opened by the |-p| command line ---- 7356,7361 ---- -*************** -*** 7662,7668 **** - *'tagbsearch'* *'tbs'* *'notagbsearch'* *'notbs'* - 'tagbsearch' 'tbs' boolean (default on) - global -- {not in Vi} - When searching for a tag (e.g., for the |:ta| command), Vim can either - use a binary search or a linear search in a tags file. Binary - searching makes searching for a tag a LOT faster, but a linear search ---- 7396,7401 ---- -*************** -*** 7715,7721 **** - *'tagcase'* *'tc'* - 'tagcase' 'tc' string (default "followic") - global or local to buffer |global-local| -- {not in Vi} - This option specifies how case is handled when searching the tags - file: - followic Follow the 'ignorecase' option ---- 7448,7453 ---- -*************** -*** 7734,7740 **** - *'tagrelative'* *'tr'* *'notagrelative'* *'notr'* - 'tagrelative' 'tr' boolean (Vim default: on, Vi default: off) - global -- {not in Vi} - If on and using a tags file in another directory, file names in that - tags file are relative to the directory where the tags file is. - NOTE: This option is set to the Vi default value when 'compatible' is ---- 7466,7471 ---- -*************** -*** 7771,7777 **** - *'tagstack'* *'tgst'* *'notagstack'* *'notgst'* - 'tagstack' 'tgst' boolean (default on) - global -- {not in all versions of Vi} - When on, the |tagstack| is used normally. When off, a ":tag" or - ":tselect" command with an argument will not push the tag onto the - tagstack. A following ":tag" without an argument, a ":pop" command or ---- 7502,7507 ---- -*************** -*** 7783,7789 **** - *'tcldll'* - 'tcldll' string (default depends on the build) - global -- {not in Vi} - {only available when compiled with the |+tcl/dyn| - feature} - Specifies the name of the Tcl shared library. The default is ---- 7513,7518 ---- -*************** -*** 7815,7821 **** - *'notermbidi'* *'notbidi'* - 'termbidi' 'tbidi' boolean (default off, on for "mlterm") - global -- {not in Vi} - {only available when compiled with the |+arabic| - feature} - The terminal is in charge of Bi-directionality of text (as specified ---- 7544,7549 ---- -*************** -*** 7832,7840 **** - 'termencoding' 'tenc' string (default ""; with GTK+ GUI: "utf-8"; with - Macintosh GUI: "macroman") - global -- {only available when compiled with the |+multi_byte| -- feature} -- {not in Vi} - Encoding used for the terminal. This specifies what character - encoding the keyboard produces and the display will understand. For - the GUI it only applies to the keyboard ('encoding' is used for the ---- 7560,7565 ---- -*************** -*** 7863,7869 **** - *'termguicolors'* *'tgc'* *E954* - 'termguicolors' 'tgc' boolean (default off) - global -- {not in Vi} - {not available when compiled without the - |+termguicolors| feature} - When on, uses |highlight-guifg| and |highlight-guibg| attributes in ---- 7588,7593 ---- -*************** -*** 7881,7900 **** - Note that the "cterm" attributes are still used, not the "gui" ones. - NOTE: This option is reset when 'compatible' is set. - -- *'termwinscroll'* *'twsl'* -- 'termwinscroll' 'twsl' number (default 10000) -- local to buffer -- {not in Vi} -- {not available when compiled without the -- |+terminal| feature} -- Number of scrollback lines to keep. When going over this limit the -- first 10% of the scrollback lines are deleted. This is just to reduce -- the memory usage. See |Terminal-Normal|. -- - *'termwinkey'* *'twk'* - 'termwinkey' 'twk' string (default "") - local to window -- {not in Vi} - The key that starts a CTRL-W command in a terminal window. Other keys - are sent to the job running in the window. - The <> notation can be used, e.g.: > ---- 7605,7613 ---- -*************** -*** 7904,7913 **** - line. If 'termwinkey' is set to CTRL-L then CTRL-L : gets you to the - command line. - - *'termwinsize'* *'tws'* - 'termwinsize' 'tws' string (default "") - local to window -- {not in Vi} - Size of the |terminal| window. Format: {rows}x{columns} or - {rows}*{columns}. - - When empty the terminal gets the size from the window. ---- 7617,7634 ---- - line. If 'termwinkey' is set to CTRL-L then CTRL-L : gets you to the - command line. - -+ *'termwinscroll'* *'twsl'* -+ 'termwinscroll' 'twsl' number (default 10000) -+ local to buffer -+ {not available when compiled without the -+ |+terminal| feature} -+ Number of scrollback lines to keep. When going over this limit the -+ first 10% of the scrollback lines are deleted. This is just to reduce -+ the memory usage. See |Terminal-Normal|. -+ - *'termwinsize'* *'tws'* - 'termwinsize' 'tws' string (default "") - local to window - Size of the |terminal| window. Format: {rows}x{columns} or - {rows}*{columns}. - - When empty the terminal gets the size from the window. -*************** -*** 7932,7938 **** - *'termwintype'* *'twt'* - 'termwintype' 'twt' string (default "") - global -- {not in Vi} - {only available when compiled with the |terminal| - feature on MS-Windows} - Specify the virtual console (pty) used when opening the terminal ---- 7653,7658 ---- -*************** -*** 7960,7966 **** - *'textauto'* *'ta'* *'notextauto'* *'nota'* - 'textauto' 'ta' boolean (Vim default: on, Vi default: off) - global -- {not in Vi} - This option is obsolete. Use 'fileformats'. - For backwards compatibility, when 'textauto' is set, 'fileformats' is - set to the default value for the current system. When 'textauto' is ---- 7680,7685 ---- -*************** -*** 7972,7978 **** - 'textmode' 'tx' boolean (MS-DOS, Win32 and OS/2: default on, - others: default off) - local to buffer -- {not in Vi} - This option is obsolete. Use 'fileformat'. - For backwards compatibility, when 'textmode' is set, 'fileformat' is - set to "dos". When 'textmode' is reset, 'fileformat' is set to ---- 7691,7696 ---- -*************** -*** 7981,7987 **** - *'textwidth'* *'tw'* - 'textwidth' 'tw' number (default 0) - local to buffer -- {not in Vi} - Maximum width of text that is being inserted. A longer line will be - broken after white space to get this width. A zero value disables - this. ---- 7699,7704 ---- -*************** -*** 7995,8009 **** - *'thesaurus'* *'tsr'* - 'thesaurus' 'tsr' string (default "") - global or local to buffer |global-local| -- {not in Vi} - List of file names, separated by commas, that are used to lookup words -! for thesaurus completion commands |i_CTRL-X_CTRL-T|. Each line in -! the file should contain words with similar meaning, separated by -! non-keyword characters (white space is preferred). Maximum line -! length is 510 bytes. -! To obtain a file to be used here, check out this ftp site: -! [Sorry this link doesn't work anymore, do you know the right one?] -! ftp://ftp.ox.ac.uk/pub/wordlists/ First get the README file. - To include a comma in a file name precede it with a backslash. Spaces - after a comma are ignored, otherwise spaces are included in the file - name. See |option-backslash| about using backslashes. ---- 7712,7730 ---- - *'thesaurus'* *'tsr'* - 'thesaurus' 'tsr' string (default "") - global or local to buffer |global-local| - List of file names, separated by commas, that are used to lookup words -! for thesaurus completion commands |i_CTRL-X_CTRL-T|. -! -! Each line in the file should contain words with similar meaning, -! separated by non-keyword characters (white space is preferred). -! Maximum line length is 510 bytes. -! -! An English word list was added to this github issue: -! https://github.com/vim/vim/issues/629#issuecomment-443293282 -! Unpack thesaurus_pkg.zip, put the thesaurus.txt file somewhere, e.g. -! ~/.vim/thesaurus/english.txt, and the 'thesaurus' option to this file -! name. -! - To include a comma in a file name precede it with a backslash. Spaces - after a comma are ignored, otherwise spaces are included in the file - name. See |option-backslash| about using backslashes. -*************** -*** 8015,8021 **** - *'tildeop'* *'top'* *'notildeop'* *'notop'* - 'tildeop' 'top' boolean (default off) - global -- {not in Vi} - When on: The tilde command "~" behaves like an operator. - NOTE: This option is reset when 'compatible' is set. - ---- 7736,7741 ---- -*************** -*** 8025,8031 **** - *'ttimeout'* *'nottimeout'* - 'ttimeout' boolean (default off, set in |defaults.vim|) - global -- {not in Vi} - These two options together determine the behavior when part of a - mapped key sequence or keyboard code has been received: - ---- 7745,7750 ---- -*************** -*** 8060,8066 **** - *'ttimeoutlen'* *'ttm'* - 'ttimeoutlen' 'ttm' number (default -1, set to 100 in |defaults.vim|) - global -- {not in Vi} - The time in milliseconds that is waited for a key code or mapped key - sequence to complete. Also used for CTRL-\ CTRL-N and CTRL-\ CTRL-G - when part of a command has been typed. ---- 7779,7784 ---- -*************** -*** 8081,8087 **** - *'title'* *'notitle'* - 'title' boolean (default off, on when title can be restored) - global -- {not in Vi} - {not available when compiled without the |+title| - feature} - When on, the title of the window will be set to the value of ---- 7799,7804 ---- -*************** -*** 8117,8123 **** - *'titlelen'* - 'titlelen' number (default 85) - global -- {not in Vi} - {not available when compiled without the |+title| - feature} - Gives the percentage of 'columns' to use for the length of the window ---- 7834,7839 ---- -*************** -*** 8133,8139 **** - *'titleold'* - 'titleold' string (default "Thanks for flying Vim") - global -- {not in Vi} - {only available when compiled with the |+title| - feature} - This option will be used for the window title when exiting Vim if the ---- 7849,7854 ---- -*************** -*** 8144,8150 **** - *'titlestring'* - 'titlestring' string (default "") - global -- {not in Vi} - {not available when compiled without the |+title| - feature} - When this option is not empty, it will be used for the title of the ---- 7859,7864 ---- -*************** -*** 8200,8206 **** - *'toolbariconsize'* *'tbis'* - 'toolbariconsize' 'tbis' string (default "small") - global -- {not in Vi} - {only in the GTK+ GUI} - Controls the size of toolbar icons. The possible values are: - tiny Use tiny icons. ---- 7914,7919 ---- -*************** -*** 8219,8225 **** - *'ttybuiltin'* *'tbi'* *'nottybuiltin'* *'notbi'* - 'ttybuiltin' 'tbi' boolean (default on) - global -- {not in Vi} - When on, the builtin termcaps are searched before the external ones. - When off the builtin termcaps are searched after the external ones. - When this option is changed, you should set the 'term' option next for ---- 7932,7937 ---- -*************** -*** 8236,8242 **** - iris-ansi; also on when running Vim in - a DOS console) - global -- {not in Vi} - Indicates a fast terminal connection. More characters will be sent to - the screen for redrawing, instead of using insert/delete line - commands. Improves smoothness of redrawing when there are multiple ---- 7948,7953 ---- -*************** -*** 8248,8254 **** - *'ttymouse'* *'ttym'* - 'ttymouse' 'ttym' string (default depends on 'term') - global -- {not in Vi} - {only in Unix and VMS, doesn't work in the GUI; not - available when compiled without |+mouse|} - Name of the terminal type for which mouse codes are to be recognized. ---- 7959,7964 ---- -*************** -*** 8308,8315 **** - |t_RV| is set to the escape sequence to request the xterm version - number, more intelligent detection process runs. - The "xterm2" value will be set if the xterm version is reported to be -! from 95 to 276. The "sgr" value will be set if the xterm version is -! 277 or higher and when Vim detects Mac Terminal.app or iTerm2. - If you do not want 'ttymouse' to be set to "xterm2" or "sgr" - automatically, set t_RV to an empty string: > - :set t_RV= ---- 8018,8026 ---- - |t_RV| is set to the escape sequence to request the xterm version - number, more intelligent detection process runs. - The "xterm2" value will be set if the xterm version is reported to be -! from 95 to 276. The "sgr" value will be set if Vim detects Mac -! Terminal.app, iTerm2 or mintty, and when the xterm version is 277 or -! higher. - If you do not want 'ttymouse' to be set to "xterm2" or "sgr" - automatically, set t_RV to an empty string: > - :set t_RV= -*************** -*** 8330,8336 **** - *'undodir'* *'udir'* - 'undodir' 'udir' string (default ".") - global -- {not in Vi} - {only when compiled with the |+persistent_undo| feature} - List of directory names for undo files, separated with commas. - See |'backupdir'| for details of the format. ---- 8041,8046 ---- -*************** -*** 8348,8354 **** - *'undofile'* *'noundofile'* *'udf'* *'noudf'* - 'undofile' 'udf' boolean (default off) - local to buffer -- {not in Vi} - {only when compiled with the |+persistent_undo| feature} - When on, Vim automatically saves undo history to an undo file when - writing a buffer to a file, and restores undo history from the same ---- 8058,8063 ---- -*************** -*** 8364,8370 **** - 'undolevels' 'ul' number (default 100, 1000 for Unix, VMS, - Win32 and OS/2) - global or local to buffer |global-local| -- {not in Vi} - Maximum number of changes that can be undone. Since undo information - is kept in memory, higher numbers will cause more memory to be used - (nevertheless, a single change can use an unlimited amount of memory). ---- 8073,8078 ---- -*************** -*** 8386,8392 **** - *'undoreload'* *'ur'* - 'undoreload' 'ur' number (default 10000) - global -- {not in Vi} - Save the whole buffer for undo when reloading it. This applies to the - ":e!" command and reloading for when the buffer changed outside of - Vim. |FileChangedShell| ---- 8094,8099 ---- -*************** -*** 8402,8408 **** - *'updatecount'* *'uc'* - 'updatecount' 'uc' number (default: 200) - global -- {not in Vi} - After typing this many characters the swap file will be written to - disk. When zero, no swap file will be created at all (see chapter on - recovery |crash-recovery|). 'updatecount' is set to zero by starting ---- 8109,8114 ---- -*************** -*** 8419,8425 **** - *'updatetime'* *'ut'* - 'updatetime' 'ut' number (default 4000) - global -- {not in Vi} - If this many milliseconds nothing is typed the swap file will be - written to disk (see |crash-recovery|). Also used for the - |CursorHold| autocommand event. ---- 8125,8130 ---- -*************** -*** 8429,8435 **** - local to buffer - {only available when compiled with the |+vartabs| - feature} -- {not in Vi} - A list of the number of spaces that a <Tab> counts for while editing, - such as inserting a <Tab> or using <BS>. It "feels" like variable- - width <Tab>s are being inserted, while in fact a mixture of spaces ---- 8134,8139 ---- -*************** -*** 8437,8447 **** - final value applying to all subsequent tabs. - - For example, when editing assembly language files where statements -! start in the 8th column and comments in the 40th, it may be useful - to use the following: > - :set varsofttabstop=8,32,8 -! < This will set soft tabstops at the 8th and 40th columns, and at every -! 8th column thereafter. - - Note that the value of |'softtabstop'| will be ignored while - 'varsofttabstop' is set. ---- 8141,8151 ---- - final value applying to all subsequent tabs. - - For example, when editing assembly language files where statements -! start in the 9th column and comments in the 41st, it may be useful - to use the following: > - :set varsofttabstop=8,32,8 -! < This will set soft tabstops with 8 and 8 + 32 spaces, and 8 more -! for every column thereafter. - - Note that the value of |'softtabstop'| will be ignored while - 'varsofttabstop' is set. -*************** -*** 8451,8457 **** - local to buffer - {only available when compiled with the |+vartabs| - feature} -- {not in Vi} - A list of the number of spaces that a <Tab> in the file counts for, - separated by commas. Each value corresponds to one tab, with the - final value applying to all subsequent tabs. For example: > ---- 8155,8160 ---- -*************** -*** 8465,8472 **** - *'verbose'* *'vbs'* - 'verbose' 'vbs' number (default 0) - global -- {not in Vi, although some versions have a boolean -- verbose option} - When bigger than zero, Vim will give messages about what it is doing. - Currently, these messages are given: - >= 1 When the viminfo file is read or written. ---- 8168,8173 ---- -*************** -*** 8488,8494 **** - *'verbosefile'* *'vfile'* - 'verbosefile' 'vfile' string (default empty) - global -- {not in Vi} - When not empty all messages are written in a file with this name. - When the file exists messages are appended. - Writing to the file ends when Vim exits or when 'verbosefile' is made ---- 8189,8194 ---- -*************** -*** 8505,8511 **** - for VMS: "sys$login:vimfiles/view" - for RiscOS: "Choices:vimfiles/view") - global -- {not in Vi} - {not available when compiled without the |+mksession| - feature} - Name of the directory where to store files for |:mkview|. ---- 8205,8210 ---- -*************** -*** 8515,8521 **** - *'viewoptions'* *'vop'* - 'viewoptions' 'vop' string (default: "folds,options,cursor,curdir") - global -- {not in Vi} - {not available when compiled without the |+mksession| - feature} - Changes the effect of the |:mkview| command. It is a comma separated ---- 8214,8219 ---- -*************** -*** 8543,8549 **** - for Amiga: '100,<50,s10,h,rdf0:,rdf1:,rdf2: - for others: '100,<50,s10,h) - global -- {not in Vi} - {not available when compiled without the |+viminfo| - feature} - When non-empty, the viminfo file is read upon startup and written ---- 8241,8246 ---- -*************** -*** 8660,8666 **** - *'viminfofile'* *'vif'* - 'viminfofile' 'vif' string (default: "") - global -- {not in Vi} - {not available when compiled without the |+viminfo| - feature} - When non-empty, overrides the file name used for viminfo. ---- 8357,8362 ---- -*************** -*** 8671,8677 **** - *'virtualedit'* *'ve'* - 'virtualedit' 've' string (default "") - global -- {not in Vi} - {not available when compiled without the - |+virtualedit| feature} - A comma separated list of these words: ---- 8367,8372 ---- -*************** -*** 8700,8706 **** - *'visualbell'* *'vb'* *'novisualbell'* *'novb'* *beep* - 'visualbell' 'vb' boolean (default off) - global -- {not in Vi} - Use a visual bell instead of beeping. The terminal code to display the - visual bell is given with 't_vb'. When no beep or flash is wanted, - use: > ---- 8395,8400 ---- -*************** -*** 8734,8740 **** - *'weirdinvert'* *'wiv'* *'noweirdinvert'* *'nowiv'* - 'weirdinvert' 'wiv' boolean (default off) - global -- {not in Vi} - This option has the same effect as the 't_xs' terminal option. - It is provided for backwards compatibility with version 4.x. - Setting 'weirdinvert' has the effect of making 't_xs' non-empty, and ---- 8428,8433 ---- -*************** -*** 8743,8749 **** - *'whichwrap'* *'ww'* - 'whichwrap' 'ww' string (Vim default: "b,s", Vi default: "") - global -- {not in Vi} - Allow specified keys that move the cursor left/right to move to the - previous/next line when the cursor is on the first/last character in - the line. Concatenate characters to allow this for these keys: ---- 8436,8441 ---- -*************** -*** 8776,8782 **** - *'wildchar'* *'wc'* - 'wildchar' 'wc' number (Vim default: <Tab>, Vi default: CTRL-E) - global -- {not in Vi} - Character you have to type to start wildcard expansion in the - command-line, as specified with 'wildmode'. - More info here: |cmdline-completion|. ---- 8468,8473 ---- -*************** -*** 8790,8796 **** - *'wildcharm'* *'wcm'* - 'wildcharm' 'wcm' number (default: none (0)) - global -- {not in Vi} - 'wildcharm' works exactly like 'wildchar', except that it is - recognized when used inside a macro. You can find "spare" command-line - keys suitable for this option by looking at |ex-edit-index|. Normally ---- 8481,8486 ---- -*************** -*** 8803,8809 **** - *'wildignore'* *'wig'* - 'wildignore' 'wig' string (default "") - global -- {not in Vi} - {not available when compiled without the |+wildignore| - feature} - A list of file patterns. A file that matches with one of these ---- 8493,8498 ---- -*************** -*** 8822,8828 **** - *'wildignorecase'* *'wic'* *'nowildignorecase'* *'nowic'* - 'wildignorecase' 'wic' boolean (default off) - global -- {not in Vi} - When set case is ignored when completing file names and directories. - Has no effect when 'fileignorecase' is set. - Does not apply when the shell is used to expand wildcards, which ---- 8511,8516 ---- -*************** -*** 8832,8838 **** - *'wildmenu'* *'wmnu'* *'nowildmenu'* *'nowmnu'* - 'wildmenu' 'wmnu' boolean (default off, set in |defaults.vim|) - global -- {not in Vi} - {not available if compiled without the |+wildmenu| - feature} - When 'wildmenu' is on, command-line completion operates in an enhanced ---- 8520,8525 ---- -*************** -*** 8873,8879 **** - *'wildmode'* *'wim'* - 'wildmode' 'wim' string (Vim default: "full") - global -- {not in Vi} - Completion mode that is used for the character specified with - 'wildchar'. It is a comma separated list of up to four parts. Each - part specifies what to do for each consecutive use of 'wildchar'. The ---- 8560,8565 ---- -*************** -*** 8911,8917 **** - *'wildoptions'* *'wop'* - 'wildoptions' 'wop' string (default "") - global -- {not in Vi} - {not available when compiled without the |+wildignore| - feature} - A list of words that change how command line completion is done. ---- 8597,8602 ---- -*************** -*** 8926,8932 **** - *'winaltkeys'* *'wak'* - 'winaltkeys' 'wak' string (default "menu") - global -- {not in Vi} - {only used in Win32, Motif, GTK and Photon GUI} - Some GUI versions allow the access to menu entries by using the ALT - key in combination with a character that appears underlined in the ---- 8611,8616 ---- -*************** -*** 8962,8968 **** - *'winheight'* *'wh'* *E591* - 'winheight' 'wh' number (default 1) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - Minimal number of lines for the current window. This is not a hard ---- 8646,8651 ---- -*************** -*** 8985,8991 **** - *'winfixheight'* *'wfh'* *'nowinfixheight'* *'nowfh'* - 'winfixheight' 'wfh' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+windows| - feature} - Keep the window height when windows are opened or closed and ---- 8668,8673 ---- -*************** -*** 8996,9002 **** - *'winfixwidth'* *'wfw'* *'nowinfixwidth'* *'nowfw'* - 'winfixwidth' 'wfw' boolean (default off) - local to window -- {not in Vi} - {not available when compiled without the |+windows| - feature} - Keep the window width when windows are opened or closed and ---- 8678,8683 ---- -*************** -*** 9006,9012 **** - *'winminheight'* *'wmh'* - 'winminheight' 'wmh' number (default 1) - global -- {not in Vi} - {not available when compiled without the |+windows| - feature} - The minimal height of a window, when it's not the current window. ---- 8687,8692 ---- -*************** -*** 9022,9028 **** - *'winminwidth'* *'wmw'* - 'winminwidth' 'wmw' number (default 1) - global -- {not in Vi} - {not available when compiled without the |+vertsplit| - feature} - The minimal width of a window, when it's not the current window. ---- 8702,8707 ---- -*************** -*** 9039,9045 **** - *'winptydll'* - 'winptydll' string (default "winpty32.dll" or "winpty64.dll") - global -- {not in Vi} - {only available when compiled with the |terminal| - feature on MS-Windows} - Specifies the name of the winpty shared library, used for the ---- 8718,8723 ---- -*************** -*** 9053,9059 **** - *'winwidth'* *'wiw'* *E592* - 'winwidth' 'wiw' number (default 20) - global -- {not in Vi} - {not available when compiled without the |+vertsplit| - feature} - Minimal number of columns for the current window. This is not a hard ---- 8731,8736 ---- -*************** -*** 9069,9075 **** - *'wrap'* *'nowrap'* - 'wrap' boolean (default on) - local to window -- {not in Vi} - This option changes how text is displayed. It doesn't change the text - in the buffer, see 'textwidth' for that. - When on, lines longer than the width of the window will wrap and ---- 8746,8751 ---- -*************** -*** 9109,9115 **** - *'write'* *'nowrite'* - 'write' boolean (default on) - global -- {not in Vi} - Allows writing files. When not set, writing a file is not allowed. - Can be used for a view-only mode, where modifications to the text are - still allowed. Can be reset with the |-m| or |-M| command line ---- 8785,8790 ---- -*************** -*** 9125,9131 **** - 'writebackup' 'wb' boolean (default on with |+writebackup| feature, off - otherwise) - global -- {not in Vi} - Make a backup before overwriting a file. The backup is removed after - the file was successfully written, unless the 'backup' option is - also on. ---- 8800,8805 ---- -*************** -*** 9142,9150 **** - *'writedelay'* *'wd'* - 'writedelay' 'wd' number (default 0) - global -- {not in Vi} - The number of milliseconds to wait for each character sent to the - screen. When non-zero, characters are sent to the terminal one by - one. For MS-DOS pcterm this does not work. For debugging purposes. - -! vim:tw=78:ts=8:ft=help:norl: ---- 8816,8823 ---- - *'writedelay'* *'wd'* - 'writedelay' 'wd' number (default 0) - global - The number of milliseconds to wait for each character sent to the - screen. When non-zero, characters are sent to the terminal one by - one. For MS-DOS pcterm this does not work. For debugging purposes. - -! vim:tw=78:ts=8:noet:ft=help:norl: -*** ../vim-8.1.1225/src/version.c 2019-04-28 14:59:55.845503790 +0200 ---- src/version.c 2019-04-28 15:55:46.832806798 +0200 -*************** -*** 769,770 **** ---- 769,772 ---- - { /* Add new patch number below this line */ -+ /**/ -+ 1226, - /**/ - --- -WOMAN: Well, 'ow did you become king then? -ARTHUR: The Lady of the Lake, [angels sing] her arm clad in the purest - shimmering samite, held aloft Excalibur from the bosom of the water - signifying by Divine Providence that I, Arthur, was to carry - Excalibur. [singing stops] That is why I am your king! - The Quest for the Holy Grail (Monty Python) - - /// Bram Moolenaar -- Bram@Moolenaar.net -- http://www.Moolenaar.net \\\ -/// sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\ -\\\ an exciting new programming language -- http://www.Zimbu.org /// - \\\ help me help AIDS victims -- http://ICCF-Holland.org /// |