1- *options.txt* For Vim version 9.1. Last change: 2025 Nov 09
1+ *options.txt* For Vim version 9.1. Last change: 2025 Nov 27
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1675,7 +1675,8 @@ A jump table for the options with a short description can be found at |Q_op|.
16751675 a modified version of the following command in your vimrc file to
16761676 override it: >
16771677 :let &cdpath = ',' .. substitute(substitute($CDPATH, '[, ]', '\\\0', 'g'), ':', ',', 'g')
1678- < This option cannot be set from a | modeline | or in the | sandbox | , for
1678+ < Environment variables are expanded | :set_env | .
1679+ This option cannot be set from a | modeline | or in the | sandbox | , for
16791680 security reasons.
16801681 (parts of 'cdpath' can be passed to the shell to expand file names).
16811682
@@ -1847,9 +1848,9 @@ A jump table for the options with a short description can be found at |Q_op|.
18471848 option, yank operations (but not delete, change or
18481849 put) will additionally copy the text into register
18491850 '*'. If Wayland is being used and the compositor does
1850- not support the primary- selection-unstable-v1
1851- protocol, then the regular selection is used in its
1852- place. Only available with the | +X11 | or
1851+ not support the primary selection then the regular
1852+ selection is used in its place. Only available with
1853+ the | +X11 | or
18531854 | +wayland_clipboard | feature. Availability can be
18541855 checked with: >
18551856 if has('unnamedplus')
@@ -2006,8 +2007,6 @@ A jump table for the options with a short description can be found at |Q_op|.
20062007 *'commentstring'* *'cms'* *E537*
20072008'commentstring' 'cms' string (default "/* %s */")
20082009 local to buffer
2009- {not available when compiled without the | +folding |
2010- feature}
20112010 A template for a comment. The "%s" in the value is replaced with the
20122011 comment text, and should be padded with a space when possible.
20132012 Currently used to add markers for folding, see | fold-marker | . Also
@@ -2227,11 +2226,13 @@ A jump table for the options with a short description can be found at |Q_op|.
22272226 *'completefuzzycollect'* *'cfc'*
22282227'completefuzzycollect' 'cfc' string (default: empty)
22292228 global
2230- A comma-separated list of strings to enable fuzzy collection for
2231- specific | ins-completion | modes, affecting how matches are gathered
2232- during completion. For specified modes, fuzzy matching is used to
2233- find completion candidates instead of the standard prefix-based
2234- matching. This option can contain the following values:
2229+ DEPRECATED: This option is no longer used; changing it has no effect.
2230+ When 'completeopt' contains "fuzzy", Vim will internally use the
2231+ equivalent of:
2232+ "keyword,files,whole_line"
2233+
2234+ The values below are kept for compatibility and for scripts that
2235+ may read this option:
22352236
22362237 keyword keywords in the current file | i_CTRL-X_CTRL-N |
22372238 keywords with flags ".", "w", | i_CTRL-N | | i_CTRL-P |
@@ -2242,10 +2243,6 @@ A jump table for the options with a short description can be found at |Q_op|.
22422243
22432244 whole_line whole lines | i_CTRL-X_CTRL-L |
22442245
2245- When using the 'completeopt' "longest" option value, fuzzy collection
2246- can identify the longest common string among the best fuzzy matches
2247- and insert it automatically.
2248-
22492246 *'completeitemalign'* *'cia'*
22502247'completeitemalign' 'cia' string (default: "abbr,kind,menu")
22512248 global
@@ -2265,12 +2262,7 @@ A jump table for the options with a short description can be found at |Q_op|.
22652262 fuzzy Enable | fuzzy-matching | for completion candidates. This
22662263 allows for more flexible and intuitive matching, where
22672264 characters can be skipped and matches can be found even
2268- if the exact sequence is not typed. Note: This option
2269- does not affect the collection of candidate list, it only
2270- controls how completion candidates are reduced from the
2271- list of alternatives. If you want to use | fuzzy-matching |
2272- to gather more alternatives for your candidate list,
2273- see 'completefuzzycollect' .
2265+ if the exact sequence is not typed.
22742266
22752267 longest
22762268 When 'autocomplete' is not active, only the longest common
@@ -3081,6 +3073,7 @@ A jump table for the options with a short description can be found at |Q_op|.
30813073 To include a comma in a file name precede it with a backslash. Spaces
30823074 after a comma are ignored, otherwise spaces are included in the file
30833075 name. See | option-backslash | about using backslashes.
3076+ Environment variables are expanded | :set_env | .
30843077 This has nothing to do with the | Dictionary | variable type.
30853078 Where to find a list of words?
30863079 - On FreeBSD, there is the file "/usr/share/dict/words".
@@ -6254,7 +6247,7 @@ A jump table for the options with a short description can be found at |Q_op|.
62546247 :set mkspellmem=900000,3000,800
62556248< If you have less than 512 Mbyte | :mkspell | may fail for some
62566249 languages, no matter what you set 'mkspellmem' to.
6257-
6250+ Environment variables are expanded | :set_env | .
62586251 This option cannot be set from a | modeline | or in the | sandbox | , for
62596252 security reasons.
62606253
@@ -6677,6 +6670,7 @@ A jump table for the options with a short description can be found at |Q_op|.
66776670 *'packpath'* *'pp'*
66786671'packpath' 'pp' string (default: see 'runtimepath' )
66796672 Directories used to find packages. See | packages | .
6673+ Environment variables are expanded | :set_env | .
66806674 This option cannot be set from a | modeline | or in the | sandbox | , for
66816675 security reasons.
66826676
@@ -7501,6 +7495,7 @@ A jump table for the options with a short description can be found at |Q_op|.
75017495 runtime files.
75027496 When Vim is started with | --clean | the home directory entries are not
75037497 included.
7498+ Environment variables are expanded | :set_env | .
75047499 This option cannot be set from a | modeline | or in the | sandbox | , for
75057500 security reasons.
75067501
@@ -8333,6 +8328,7 @@ A jump table for the options with a short description can be found at |Q_op|.
83338328 name if you want to. However, it will then only be used when
83348329 'spellfile' is set to it, for entries in 'spelllang' only files
83358330 without region name will be found.
8331+ Environment variables are expanded | :set_env | .
83368332 This option cannot be set from a | modeline | or in the | sandbox | , for
83378333 security reasons.
83388334
@@ -8460,7 +8456,7 @@ A jump table for the options with a short description can be found at |Q_op|.
84608456 Only one of "best", "double" or "fast" may be used. The others may
84618457 appear several times in any order. Example: >
84628458 :set sps=file:~/.vim/sugg,best,expr:MySuggest()
8463- <
8459+ < Environment variables are expanded | :set_env | .
84648460 This option cannot be set from a | modeline | or in the | sandbox | , for
84658461 security reasons.
84668462
@@ -9298,8 +9294,9 @@ A jump table for the options with a short description can be found at |Q_op|.
92989294 name. See | option-backslash | about using backslashes. The use of
92999295 | :set+= | and | :set-= | is preferred when adding or removing directories
93009296 from the list. This avoids problems when a future version uses
9301- another default. Backticks cannot be used in this option for security
9302- reasons.
9297+ another default.
9298+ Environment variables are expanded | :set_env | .
9299+ Backticks cannot be used in this option for security reasons.
93039300
93049301 *'thesaurusfunc'* *'tsrfu'*
93059302'thesaurusfunc' 'tsrfu' string (default: empty)
@@ -9639,6 +9636,7 @@ A jump table for the options with a short description can be found at |Q_op|.
96399636'ttytype' 'tty' string (default from $TERM)
96409637 global
96419638 Alias for 'term' , see above.
9639+ Environment variables are expanded | :set_env | .
96429640
96439641 *'undodir'* *'udir'*
96449642'undodir' 'udir' string (default ".")
@@ -9656,6 +9654,7 @@ A jump table for the options with a short description can be found at |Q_op|.
96569654 undo file that exists is used. When it cannot be read an error is
96579655 given, no further entry is used.
96589656 See | undo-persistence | .
9657+ Environment variables are expanded | :set_env | .
96599658 This option cannot be set from a | modeline | or in the | sandbox | , for
96609659 security reasons.
96619660
@@ -9807,6 +9806,7 @@ A jump table for the options with a short description can be found at |Q_op|.
98079806 Setting 'verbosefile' to a new value is like making it empty first.
98089807 The difference with | :redir | is that verbose messages are not
98099808 displayed when 'verbosefile' is set.
9809+ Environment variables are expanded | :set_env | .
98109810 This option cannot be set from a | modeline | or in the | sandbox | , for
98119811 security reasons.
98129812
@@ -9821,6 +9821,7 @@ A jump table for the options with a short description can be found at |Q_op|.
98219821 feature}
98229822 Name of the directory where to store files for | :mkview | .
98239823 For $XDG_CONFIG_HOME see | xdg-base-dir | .
9824+ Environment variables are expanded | :set_env | .
98249825 This option cannot be set from a | modeline | or in the | sandbox | , for
98259826 security reasons.
98269827
@@ -9976,6 +9977,7 @@ A jump table for the options with a short description can be found at |Q_op|.
99769977 When equal to "NONE" no viminfo file will be read or written.
99779978 This option can be set with the | -i | command line flag. The | --clean |
99789979 command line flag sets it to "NONE".
9980+ Environment variables are expanded | :set_env | .
99799981 This option cannot be set from a | modeline | or in the | sandbox | , for
99809982 security reasons.
99819983
0 commit comments