Update options.{txt,jax} #1930
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,4 @@ | ||
| *options.txt* For Vim version 9.1. Last change: 2025 Feb 01 | ||
|
|
||
|
|
||
| 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|. | |
| When the |t_RB| option is set, Vim will use it to request the background | ||
| color from the terminal. If the returned RGB value is dark/light and | ||
| 'background' is not dark/light, 'background' will be set and the | ||
| screen is redrawn. This may have side effects, make |t_RB| empty in | ||
| your .vimrc if you suspect this problem. The response to |t_RB| can | ||
| be found in |v:termrbgresp|. | ||
|
|
||
|
|
@@ -2164,6 +2164,16 @@ A jump table for the options with a short description can be found at |Q_op|. | |
| characters can be skipped and matches can be found even | ||
| if the exact sequence is not typed. | ||
|
|
||
| nosort Disable sorting of completion candidates based on fuzzy | ||
| scores when "fuzzy" is enabled. Candidates will appear | ||
| in their original order. | ||
|
|
||
| preinsert | ||
| Preinsert the portion of the first candidate word that is | ||
| not part of the current completion leader and using the | ||
| |hl-ComplMatchIns| highlight group. Does not work when | ||
| "fuzzy" is also included. | ||
|
|
||
| *'completepopup'* *'cpp'* | ||
| 'completepopup' 'cpp' string (default empty) | ||
| global | ||
|
|
@@ -2880,11 +2890,20 @@ A jump table for the options with a short description can be found at |Q_op|. | |
| Option settings for diff mode. It can consist of the following items. | ||
| All are optional. Items must be separated by a comma. | ||
|
|
||
| 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 | ||
| smallest possible diff | ||
| patience patience diff algorithm | ||
| histogram histogram diff algorithm | ||
|
|
||
| closeoff When a window is closed where 'diff' is set | ||
| and there is only one window remaining in the | ||
| same tab page with 'diff' set, execute | ||
| `:diffoff` in that window. This undoes a | ||
| `:diffsplit` command. | ||
|
|
||
| context:{n} Use a context of {n} lines between a change | ||
| 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|. | |
| value (999999) to disable folding completely. | ||
| See |fold-diff|. | ||
|
|
||
| filler Show filler lines, to keep the text | ||
| synchronized with a window that has inserted | ||
| lines at the same position. Mostly useful | ||
| when windows are side-by-side and 'scrollbind' | ||
| is set. | ||
|
|
||
| foldcolumn:{n} Set the 'foldcolumn' option to {n} when | ||
| starting diff mode. Without this 2 is used. | ||
|
|
||
| followwrap Follow the 'wrap' option and leave as it is. | ||
|
|
||
| horizontal Start diff mode with horizontal splits (unless | ||
| explicitly specified otherwise). | ||
|
|
||
| hiddenoff Do not use diff mode for a buffer when it | ||
| becomes hidden. | ||
|
|
||
| iblank Ignore changes where lines are all blank. Adds | ||
| the "-B" flag to the "diff" command if | ||
| '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|. | |
| are considered the same. Adds the "-i" flag | ||
| to the "diff" command if 'diffexpr' is empty. | ||
|
|
||
| indent-heuristic | ||
| Use the indent heuristic for the internal | ||
| diff library. | ||
|
|
||
| internal Use the internal diff library. This is | ||
| ignored when 'diffexpr' is set. *E960* | ||
| When running out of memory when writing a | ||
| buffer this item will be ignored for diffs | ||
| involving that buffer. Set the 'verbose' | ||
| option to see when this happens. | ||
|
|
||
| iwhite Ignore changes in amount of white space. Adds | ||
| the "-b" flag to the "diff" command if | ||
| '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|. | |
| of the "diff" command for what this does | ||
| exactly. | ||
|
|
||
| linematch:{n} Align and mark changes between the most | ||
| similar lines between the buffers. When the | ||
| total number of lines in the diff hunk exceeds | ||
| {n}, the lines will not be aligned because for | ||
| very large diff hunks there will be a | ||
| noticeable lag. A reasonable setting is | ||
| "linematch:60", as this will enable alignment | ||
| for a 2 buffer diff hunk of 30 lines each, | ||
| or a 3 buffer diff hunk of 20 lines each. | ||
|
|
||
| vertical Start diff mode with vertical splits (unless | ||
| explicitly specified otherwise). | ||
|
|
||
| Examples: > | ||
| :set diffopt=internal,filler,context:4 | ||
| :set diffopt= | ||
|
|
@@ -4348,7 +4368,7 @@ A jump table for the options with a short description can be found at |Q_op|. | |
| #:TabLineSel,_:TabLineFill,!:CursorColumn, | ||
| .:CursorLine,o:ColorColumn,q:QuickFixLine, | ||
| z:StatusLineTerm,Z:StatusLineTermNC, | ||
| g:MsgArea,h:ComplMatchIns") | ||
| global | ||
| This option can be used to set highlighting mode for various | ||
| 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|. | |
| |hl-MoreMsg| m |more-prompt| | ||
| |hl-ModeMsg| M Mode (e.g., "-- INSERT --") | ||
| |hl-MsgArea| g |Command-line| and message area | ||
| |hl-ComplMatchIns| h matched text of currently inserted completion | ||
| |hl-LineNr| n line number for ":number" and ":#" commands, and | ||
| when 'number' or 'relativenumber' option is set. | ||
| |hl-LineNrAbove| a line number above the cursor for when the | ||
|
|
@@ -5075,7 +5096,7 @@ A jump table for the options with a short description can be found at |Q_op|. | |
| set keyprotocol=kitty:kitty,foot:kitty,ghostty:kitty,wezterm:kitty | ||
| set keyprotocol+=xterm:mok2 | ||
|
|
||
| < This means that when 'term' contains "kitty, "foot", "ghostty" or | ||
| "wezterm" somewhere, then the "kitty" protocol is used. When 'term' | ||
| contains "xterm" somewhere, then the "mok2" protocol is used. | ||
|
|
||
|
|
@@ -8479,13 +8500,23 @@ A jump table for the options with a short description can be found at |Q_op|. | |
| < You need to do this when your system has no locale support for UTF-8. | ||
|
|
||
| *'termguicolors'* *'tgc'* *'notermguicolors'* *'notgc'* *E954* | ||
| 'termguicolors' 'tgc' boolean (default off unless Vim detects that it runs | ||
| in a capable terminal) | ||
| global | ||
| {not available when compiled without the | ||
| |+termguicolors| feature} | ||
| When on, uses |highlight-guifg| and |highlight-guibg| attributes in | ||
| the terminal (thus using 24-bit color). | ||
|
|
||
| Will automatically be enabled, if Vim detects that it runs in a | ||
| capable terminal (when the terminal supports the RGB terminfo | ||
| capability or when the number of colors |t_Co| supported by the | ||
| terminal is 0x1000000, e.g. with $TERM=xterm-direct). Due to the async | ||
| nature of querying the terminal, enabling this automatically is | ||
| noticable. Use > | ||
| set notermguicolors | ||
| < to explicitly disable. | ||
|
|
||
| Requires a ISO-8613-3 compatible terminal. If setting this option | ||
| does not work (produces a colorless UI) reading |xterm-true-color| | ||
| might help. | ||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.