1- *options.txt* For Vim version 9.1. Last change: 2024 Dec 28
1+ *options.txt* For Vim version 9.1. Last change: 2025 Jan 31
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1033,7 +1033,7 @@ A jump table for the options with a short description can be found at |Q_op|.
10331033 When the | t_RB | option is set, Vim will use it to request the background
10341034 color from the terminal. If the returned RGB value is dark/light and
10351035 'background' is not dark/light, 'background' will be set and the
1036- screen is redrawn. This may have side effects, make t_BG empty in
1036+ screen is redrawn. This may have side effects, make | t_RB | empty in
10371037 your .vimrc if you suspect this problem. The response to | t_RB | can
10381038 be found in | v:termrbgresp | .
10391039
@@ -2164,6 +2164,16 @@ A jump table for the options with a short description can be found at |Q_op|.
21642164 characters can be skipped and matches can be found even
21652165 if the exact sequence is not typed.
21662166
2167+ nosort Disable sorting of completion candidates based on fuzzy
2168+ scores when "fuzzy" is enabled. Candidates will appear
2169+ in their original order.
2170+
2171+ preinsert
2172+ Preinsert the portion of the first candidate word that is
2173+ not part of the current completion leader and using the
2174+ | hl-ComplMatchIns | highlight group. Does not work when
2175+ "fuzzy" is also included.
2176+
21672177 *'completepopup'* *'cpp'*
21682178'completepopup' 'cpp' string (default empty)
21692179 global
@@ -2880,11 +2890,20 @@ A jump table for the options with a short description can be found at |Q_op|.
28802890 Option settings for diff mode. It can consist of the following items.
28812891 All are optional. Items must be separated by a comma.
28822892
2883- filler Show filler lines, to keep the text
2884- synchronized with a window that has inserted
2885- lines at the same position. Mostly useful
2886- when windows are side-by-side and 'scrollbind'
2887- is set.
2893+ algorithm:{text} Use the specified diff algorithm with the
2894+ internal diff engine. Currently supported
2895+ algorithms are:
2896+ myers the default algorithm
2897+ minimal spend extra time to generate the
2898+ smallest possible diff
2899+ patience patience diff algorithm
2900+ histogram histogram diff algorithm
2901+
2902+ closeoff When a window is closed where 'diff' is set
2903+ and there is only one window remaining in the
2904+ same tab page with 'diff' set, execute
2905+ `:diffoff ` in that window. This undoes a
2906+ `:diffsplit ` command.
28882907
28892908 context:{n} Use a context of {n} lines between a change
28902909 and a fold that contains unchanged lines.
@@ -2895,6 +2914,23 @@ A jump table for the options with a short description can be found at |Q_op|.
28952914 value (999999) to disable folding completely.
28962915 See | fold-diff | .
28972916
2917+ filler Show filler lines, to keep the text
2918+ synchronized with a window that has inserted
2919+ lines at the same position. Mostly useful
2920+ when windows are side-by-side and 'scrollbind'
2921+ is set.
2922+
2923+ foldcolumn:{n} Set the 'foldcolumn' option to {n} when
2924+ starting diff mode. Without this 2 is used.
2925+
2926+ followwrap Follow the 'wrap' option and leave as it is.
2927+
2928+ horizontal Start diff mode with horizontal splits (unless
2929+ explicitly specified otherwise).
2930+
2931+ hiddenoff Do not use diff mode for a buffer when it
2932+ becomes hidden.
2933+
28982934 iblank Ignore changes where lines are all blank. Adds
28992935 the "-B" flag to the "diff" command if
29002936 'diffexpr' is empty. Check the documentation
@@ -2908,6 +2944,17 @@ A jump table for the options with a short description can be found at |Q_op|.
29082944 are considered the same. Adds the "-i" flag
29092945 to the "diff" command if 'diffexpr' is empty.
29102946
2947+ indent-heuristic
2948+ Use the indent heuristic for the internal
2949+ diff library.
2950+
2951+ internal Use the internal diff library. This is
2952+ ignored when 'diffexpr' is set. *E960*
2953+ When running out of memory when writing a
2954+ buffer this item will be ignored for diffs
2955+ involving that buffer. Set the 'verbose'
2956+ option to see when this happens.
2957+
29112958 iwhite Ignore changes in amount of white space. Adds
29122959 the "-b" flag to the "diff" command if
29132960 'diffexpr' is empty. Check the documentation
@@ -2927,46 +2974,19 @@ A jump table for the options with a short description can be found at |Q_op|.
29272974 of the "diff" command for what this does
29282975 exactly.
29292976
2930- horizontal Start diff mode with horizontal splits (unless
2931- explicitly specified otherwise).
2977+ linematch:{n} Align and mark changes between the most
2978+ similar lines between the buffers. When the
2979+ total number of lines in the diff hunk exceeds
2980+ {n} , the lines will not be aligned because for
2981+ very large diff hunks there will be a
2982+ noticeable lag. A reasonable setting is
2983+ "linematch:60", as this will enable alignment
2984+ for a 2 buffer diff hunk of 30 lines each,
2985+ or a 3 buffer diff hunk of 20 lines each.
29322986
29332987 vertical Start diff mode with vertical splits (unless
29342988 explicitly specified otherwise).
29352989
2936- closeoff When a window is closed where 'diff' is set
2937- and there is only one window remaining in the
2938- same tab page with 'diff' set, execute
2939- `:diffoff ` in that window. This undoes a
2940- `:diffsplit ` command.
2941-
2942- hiddenoff Do not use diff mode for a buffer when it
2943- becomes hidden.
2944-
2945- foldcolumn:{n} Set the 'foldcolumn' option to {n} when
2946- starting diff mode. Without this 2 is used.
2947-
2948- followwrap Follow the 'wrap' option and leave as it is.
2949-
2950- internal Use the internal diff library. This is
2951- ignored when 'diffexpr' is set. *E960*
2952- When running out of memory when writing a
2953- buffer this item will be ignored for diffs
2954- involving that buffer. Set the 'verbose'
2955- option to see when this happens.
2956-
2957- indent-heuristic
2958- Use the indent heuristic for the internal
2959- diff library.
2960-
2961- algorithm:{text} Use the specified diff algorithm with the
2962- internal diff engine. Currently supported
2963- algorithms are:
2964- myers the default algorithm
2965- minimal spend extra time to generate the
2966- smallest possible diff
2967- patience patience diff algorithm
2968- histogram histogram diff algorithm
2969-
29702990 Examples: >
29712991 :set diffopt=internal,filler,context:4
29722992 :set diffopt=
@@ -4348,7 +4368,7 @@ A jump table for the options with a short description can be found at |Q_op|.
43484368 #:TabLineSel,_:TabLineFill,!:CursorColumn,
43494369 .:CursorLine,o:ColorColumn,q:QuickFixLine,
43504370 z:StatusLineTerm,Z:StatusLineTermNC,
4351- g:MsgArea")
4371+ g:MsgArea,h:ComplMatchIns ")
43524372 global
43534373 This option can be used to set highlighting mode for various
43544374 occasions. It is a comma-separated list of character pairs. The
@@ -4368,6 +4388,7 @@ A jump table for the options with a short description can be found at |Q_op|.
43684388 | hl-MoreMsg | m | more-prompt |
43694389 | hl-ModeMsg | M Mode (e.g., "-- INSERT --")
43704390 | hl-MsgArea | g | Command-line | and message area
4391+ | hl-ComplMatchIns | h matched text of currently inserted completion
43714392 | hl-LineNr | n line number for ":number" and ":#" commands, and
43724393 when 'number' or 'relativenumber' option is set.
43734394 | hl-LineNrAbove | a line number above the cursor for when the
@@ -8479,13 +8500,23 @@ A jump table for the options with a short description can be found at |Q_op|.
84798500< You need to do this when your system has no locale support for UTF-8.
84808501
84818502 *'termguicolors'* *'tgc'* *'notermguicolors'* *'notgc'* *E954*
8482- 'termguicolors' 'tgc' boolean (default off)
8503+ 'termguicolors' 'tgc' boolean (default off unless Vim detects that it runs
8504+ in a capable terminal)
84838505 global
84848506 {not available when compiled without the
84858507 | +termguicolors | feature}
84868508 When on, uses | highlight-guifg | and | highlight-guibg | attributes in
84878509 the terminal (thus using 24-bit color).
84888510
8511+ Will automatically be enabled, if Vim detects that it runs in a
8512+ capable terminal (when the terminal supports the RGB terminfo
8513+ capability or when the number of colors | t_Co | supported by the
8514+ terminal is 0x1000000, e.g. with $TERM=xterm-direct). Due to the async
8515+ nature of querying the terminal, enabling this automatically is
8516+ noticable. Use >
8517+ set notermguicolors
8518+ < to explicitly disable.
8519+
84898520 Requires a ISO-8613-3 compatible terminal. If setting this option
84908521 does not work (produces a colorless UI) reading | xterm-true-color |
84918522 might help.
0 commit comments