|
1 |
| -*options.txt* For Vim version 9.1. Last change: 2024 Jul 09 |
| 1 | +*options.txt* For Vim version 9.1. Last change: 2024 Jul 28 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar
|
@@ -76,7 +76,8 @@ achieve special effects. These options come in three forms:
|
76 | 76 | :se[t] {option}:{value}
|
77 | 77 | Set string or number option to {value}.
|
78 | 78 | For numeric options the value can be given in decimal,
|
79 |
| - hex (preceded with 0x) or octal (preceded with '0'). |
| 79 | + hex (preceded with 0x) or octal (preceded with '0' or |
| 80 | + '0o'). |
80 | 81 | The old value can be inserted by typing 'wildchar' (by
|
81 | 82 | default this is a <Tab> or CTRL-E if 'compatible' is
|
82 | 83 | set). Many string options with fixed syntax and names
|
@@ -1476,7 +1477,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
1476 | 1477 | applying 'breakindent', even if the resulting
|
1477 | 1478 | text should normally be narrower. This prevents
|
1478 | 1479 | text indented almost to the right window border
|
1479 |
| - occupying lot of vertical space when broken. |
| 1480 | + occupying lots of vertical space when broken. |
1480 | 1481 | (default: 20)
|
1481 | 1482 | shift:{n} After applying 'breakindent', the wrapped line's
|
1482 | 1483 | beginning will be shifted by the given number of
|
@@ -2257,8 +2258,9 @@ A jump table for the options with a short description can be found at |Q_op|.
|
2257 | 2258 | Also see 'preserveindent'.
|
2258 | 2259 |
|
2259 | 2260 | *'cpoptions'* *'cpo'* *cpo*
|
2260 |
| -'cpoptions' 'cpo' string (Vim default: "aABceFs", |
2261 |
| - Vi default: all flags) |
| 2261 | +'cpoptions' 'cpo' string (Vim default: "aABceFsz", |
| 2262 | + Vi default: all flags, except "#{|&/\." |
| 2263 | + |$VIM_POSIX|: all flags) |
2262 | 2264 | global
|
2263 | 2265 | A sequence of single character flags. When a character is present
|
2264 | 2266 | this indicates Vi-compatible behavior. This is used for things where
|
@@ -2486,6 +2488,9 @@ A jump table for the options with a short description can be found at |Q_op|.
|
2486 | 2488 | *cpo-Z*
|
2487 | 2489 | Z When using "w!" while the 'readonly' option is set,
|
2488 | 2490 | don't reset 'readonly'.
|
| 2491 | + *cpo-z* |
| 2492 | + z Special casing the "cw" and "d" command (see |cw| and |
| 2493 | + |d-special|). |
2489 | 2494 | *cpo-!*
|
2490 | 2495 | ! When redoing a filter command, use the last used
|
2491 | 2496 | external command, whatever it was. Otherwise the last
|
@@ -4727,7 +4732,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
4727 | 4732 | in Insert mode as specified with the 'indentkeys' option.
|
4728 | 4733 | When this option is not empty, it overrules the 'cindent' and
|
4729 | 4734 | 'smartindent' indenting. When 'lisp' is set, this option is
|
4730 |
| - is only used when 'lispoptions' contains "expr:1". |
| 4735 | + only used when 'lispoptions' contains "expr:1". |
4731 | 4736 | When 'paste' is set this option is not used for indenting.
|
4732 | 4737 | The expression is evaluated with |v:lnum| set to the line number for
|
4733 | 4738 | which the indent is to be computed. The cursor is also in this line
|
@@ -5090,7 +5095,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
5090 | 5095 | part can be in one of two forms:
|
5091 | 5096 | 1. A list of pairs. Each pair is a "from" character immediately
|
5092 | 5097 | followed by the "to" character. Examples: "aA", "aAbBcC".
|
5093 |
| - 2. A list of "from" characters, a semi-colon and a list of "to" |
| 5098 | + 2. A list of "from" characters, a semicolon and a list of "to" |
5094 | 5099 | characters. Example: "abc;ABC"
|
5095 | 5100 | Example: "aA,fgh;FGH,cCdDeE"
|
5096 | 5101 | Special characters need to be preceded with a backslash. These are
|
@@ -5172,7 +5177,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
5172 | 5177 | update use |:redraw|.
|
5173 | 5178 | This may occasionally cause display errors. It is only meant to be set
|
5174 | 5179 | temporarily when performing an operation where redrawing may cause
|
5175 |
| - flickering or cause a slow down. |
| 5180 | + flickering or cause a slowdown. |
5176 | 5181 |
|
5177 | 5182 | *'linebreak'* *'lbr'* *'nolinebreak'* *'nolbr'*
|
5178 | 5183 | 'linebreak' 'lbr' boolean (default off)
|
@@ -5914,17 +5919,17 @@ A jump table for the options with a short description can be found at |Q_op|.
|
5914 | 5919 | Using CTRL-X on "0" or CTRL-A on "18446744073709551615"
|
5915 | 5920 | (2^64 - 1) has no effect, overflow is prevented.
|
5916 | 5921 | blank If included, treat numbers as signed or unsigned based on
|
5917 |
| - preceding whitespace. If a number with a leading dash has its |
| 5922 | + preceding whitespace. If a number with a leading dash has its |
5918 | 5923 | dash immediately preceded by a non-whitespace character (i.e.,
|
5919 | 5924 | not a tab or a " "), the negative sign won't be considered as
|
5920 | 5925 | part of the number. For example:
|
5921 | 5926 | Using CTRL-A on "14" in "Carbon-14" results in "Carbon-15"
|
5922 | 5927 | (without "blank" it would become "Carbon-13").
|
5923 | 5928 | Using CTRL-X on "8" in "Carbon -8" results in "Carbon -9"
|
5924 |
| - (because -8 is preceded by whitespace. If "unsigned" was |
| 5929 | + (because -8 is preceded by whitespace. If "unsigned" was |
5925 | 5930 | set, it would result in "Carbon -7").
|
5926 | 5931 | If this format is included, overflow is prevented as if
|
5927 |
| - "unsigned" were set. If both this format and "unsigned" are |
| 5932 | + "unsigned" were set. If both this format and "unsigned" are |
5928 | 5933 | included, "unsigned" will take precedence.
|
5929 | 5934 |
|
5930 | 5935 | Numbers which simply begin with a digit in the range 1-9 are always
|
@@ -6174,7 +6179,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
6174 | 6179 | :set path+=
|
6175 | 6180 | < To use an environment variable, you probably need to replace the
|
6176 | 6181 | separator. Here is an example to append $INCL, in which directory
|
6177 |
| - names are separated with a semi-colon: > |
| 6182 | + names are separated with a semicolon: > |
6178 | 6183 | :let &path = &path .. "," .. substitute($INCL, ';', ',', 'g')
|
6179 | 6184 | < Replace the ';' with a ':' or whatever separator is used. Note that
|
6180 | 6185 | this doesn't work when $INCL contains a comma or white space.
|
@@ -6753,7 +6758,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
6753 | 6758 | import/ files that are found by `:import`
|
6754 | 6759 | indent/ indent scripts |indent-expression|
|
6755 | 6760 | keymap/ key mapping files |mbyte-keymap|
|
6756 |
| - lang/ menu translations |:menutrans| |
| 6761 | + lang/ message translations |:menutrans| and |multi-lang| |
6757 | 6762 | menu.vim GUI menus |menu.vim|
|
6758 | 6763 | pack/ packages |:packadd|
|
6759 | 6764 | plugin/ plugin scripts |write-plugin|
|
@@ -7241,7 +7246,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
7241 | 7246 | POSIX default: "AS")
|
7242 | 7247 | global *E1336*
|
7243 | 7248 | This option helps to avoid all the |hit-enter| prompts caused by file
|
7244 |
| - messages, for example with CTRL-G, and to avoid some other messages. |
| 7249 | + messages, for example with CTRL-G, and to avoid some other messages. |
7245 | 7250 | It is a list of flags:
|
7246 | 7251 | flag meaning when present ~
|
7247 | 7252 | f use "(3 of 5)" instead of "(file 3 of 5)" *shm-f*
|
@@ -7698,7 +7703,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
7698 | 7703 | minus two.
|
7699 | 7704 |
|
7700 | 7705 | timeout:{millisec} Limit the time searching for suggestions to
|
7701 |
| - {millisec} milli seconds. Applies to the following |
| 7706 | + {millisec} milliseconds. Applies to the following |
7702 | 7707 | methods. When omitted the limit is 5000. When
|
7703 | 7708 | negative there is no limit. {only works when built
|
7704 | 7709 | with the |+reltime| feature}
|
@@ -8100,6 +8105,19 @@ A jump table for the options with a short description can be found at |Q_op|.
|
8100 | 8105 | 'S' flag in 'cpoptions'.
|
8101 | 8106 | Only normal file name characters can be used, "/\*?[|<>" are illegal.
|
8102 | 8107 |
|
| 8108 | + *'tabclose'* *'tcl'* |
| 8109 | +'tabclose' 'tcl' string (default "") |
| 8110 | + global |
| 8111 | + This option controls the behavior when closing tab pages (e.g., using |
| 8112 | + |:tabclose|). When empty Vim goes to the next (right) tab page. |
| 8113 | + |
| 8114 | + Possible values (comma-separated list): |
| 8115 | + left If included, go to the previous tab page instead of |
| 8116 | + the next one. |
| 8117 | + uselast If included, go to the previously used tab page if |
| 8118 | + possible. This option takes precedence over the |
| 8119 | + others. |
| 8120 | + |
8103 | 8121 | *'tabline'* *'tal'*
|
8104 | 8122 | 'tabline' 'tal' string (default empty)
|
8105 | 8123 | global
|
|
0 commit comments