|
1 |
| -*options.txt* For Vim version 9.1. Last change: 2025 Aug 21 |
| 1 | +*options.txt* For Vim version 9.1. Last change: 2025 Sep 02 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar
|
@@ -925,6 +925,20 @@ A jump table for the options with a short description can be found at |Q_op|.
|
925 | 925 | typing. If you prefer it not to open too quickly, set this value
|
926 | 926 | slightly above your typing speed. See |ins-autocompletion|.
|
927 | 927 |
|
| 928 | + *'autocompletetimeout'* *'act'* |
| 929 | +'autocompletetimeout' 'act' number (default 80) |
| 930 | + global |
| 931 | + Initial timeout (in milliseconds) for the decaying time-sliced |
| 932 | + completion algorithm. Starts at this value, halves for each slower |
| 933 | + source until a minimum is reached. All sources run, but slower ones |
| 934 | + are quickly de-prioritized. The default is tuned so the popup menu |
| 935 | + opens within ~200ms even with multiple slow sources on a slow system. |
| 936 | + Changing this value is rarely needed. Only 80 or higher is valid. |
| 937 | + Special case: when 'complete' contains "F" or "o" (function sources), |
| 938 | + a longer timeout is used, allowing up to ~1s for sources such as LSP |
| 939 | + servers that may sometimes take longer (e.g., while loading modules). |
| 940 | + See |ins-autocompletion|. |
| 941 | + |
928 | 942 | *'autoindent'* *'ai'* *'noautoindent'* *'noai'*
|
929 | 943 | 'autoindent' 'ai' boolean (default off)
|
930 | 944 | local to buffer
|
@@ -1732,6 +1746,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
1732 | 1746 | security reasons.
|
1733 | 1747 |
|
1734 | 1748 | *'chistory'* *'chi'*
|
| 1749 | + *E1542* *E1543* *E1544* |
1735 | 1750 | 'chistory' 'chi' number (default: 10)
|
1736 | 1751 | global
|
1737 | 1752 | {only available when compiled with the |+quickfix|
|
@@ -1891,30 +1906,30 @@ A jump table for the options with a short description can be found at |Q_op|.
|
1891 | 1906 | {pattern}, this must be the last entry.
|
1892 | 1907 |
|
1893 | 1908 | *'clipmethod'* *'cpm'*
|
1894 |
| -'clipmethod' 'cpm' string (default for Unix: "wayland,x11", |
1895 |
| - for VMS: "x11", |
1896 |
| - otherwise: "") |
| 1909 | +'clipmethod' 'cpm' string (default for Unix: "wayland,x11,gui,other", |
| 1910 | + for VMS: "x11,gui,other", |
| 1911 | + otherwise: "gui,other") |
1897 | 1912 | global
|
1898 |
| - {only when the |+xterm_clipboard| or |
1899 |
| - |+wayland_clipboard| features are included} |
| 1913 | + {only when the |+clipboard| feature is included} |
1900 | 1914 | Specifies which method of accessing the system clipboard is used,
|
1901 | 1915 | depending on which method works first or is available. Supported
|
1902 | 1916 | methods are:
|
1903 | 1917 | wayland Wayland selections
|
1904 | 1918 | x11 X11 selections
|
| 1919 | + gui GUI specific method |
| 1920 | + other Some other method |
1905 | 1921 |
|
1906 |
| - Note: This option is ignored when either the GUI is running or if Vim |
1907 |
| - is run on a system without Wayland or X11 support, such as Windows or |
1908 |
| - macOS. The GUI or system way of accessing the clipboard is always |
1909 |
| - used instead. |
| 1922 | + Note: "other" is used on systems without X11/Wayland, such as |
| 1923 | + MS-Windows or MacOS, when running Vim without the GUI. |
1910 | 1924 |
|
1911 | 1925 | The option value is a list of comma separated items. The list is
|
1912 | 1926 | parsed left to right in order, and the first method that Vim
|
1913 | 1927 | determines is available or is working is used as the actual method for
|
1914 |
| - accessing the clipboard. |
| 1928 | + accessing the clipboard. Setting this option to an empty value |
| 1929 | + disables the clipboard functionality on all systems. |
1915 | 1930 |
|
1916 |
| - The current method that is being used can be found in the |v:clipmethod| |
1917 |
| - variable. |
| 1931 | + The current method that is being used can be found in the |
| 1932 | + |v:clipmethod| variable. |
1918 | 1933 |
|
1919 | 1934 | *'cmdheight'* *'ch'*
|
1920 | 1935 | 'cmdheight' 'ch' number (default 1)
|
@@ -2325,6 +2340,12 @@ A jump table for the options with a short description can be found at |Q_op|.
|
2325 | 2340 | For Insert mode completion the buffer-local value is used. For
|
2326 | 2341 | command line completion the global value is used.
|
2327 | 2342 |
|
| 2343 | + *'completetimeout'* *'cto'* |
| 2344 | +'completetimeout' 'cto' number (default 0) |
| 2345 | + global |
| 2346 | + Like 'autocompletetimeout', but applies to |i_CTRL-N| and |i_CTRL-P| |
| 2347 | + completion. Value of 0 disables the timeout; positive values allowed. |
| 2348 | + |
2328 | 2349 | *'concealcursor'* *'cocu'*
|
2329 | 2350 | 'concealcursor' 'cocu' string (default: "")
|
2330 | 2351 | local to window
|
@@ -6427,6 +6448,14 @@ A jump table for the options with a short description can be found at |Q_op|.
|
6427 | 6448 | This option cannot be set from a |modeline| or in the |sandbox|, for
|
6428 | 6449 | security reasons.
|
6429 | 6450 |
|
| 6451 | + *'osctimeoutlen'* *'ost'* *E1568* |
| 6452 | +'osctimeoutlen' 'ost' number (default 1000) |
| 6453 | + global |
| 6454 | + This option specifies the timeout in milliseconds Vim should wait |
| 6455 | + until it receives an OSC terminator after receiving the beginning of |
| 6456 | + an OSC command response. See the |TermResponseAll| autocommand event |
| 6457 | + and |v:termosc| for more information. |
| 6458 | + |
6430 | 6459 | *'osfiletype'* *'oft'*
|
6431 | 6460 | 'osfiletype' 'oft' string (default: "")
|
6432 | 6461 | local to buffer
|
@@ -8867,8 +8896,7 @@ A jump table for the options with a short description can be found at |Q_op|.
|
8867 | 8896 | < You need to do this when your system has no locale support for UTF-8.
|
8868 | 8897 |
|
8869 | 8898 | *'termguicolors'* *'tgc'* *'notermguicolors'* *'notgc'* *E954*
|
8870 |
| -'termguicolors' 'tgc' boolean (default off unless Vim detects that it runs |
8871 |
| - in a capable terminal) |
| 8899 | +'termguicolors' 'tgc' boolean (default off) |
8872 | 8900 | global
|
8873 | 8901 | {not available when compiled without the
|
8874 | 8902 | |+termguicolors| feature}
|
|
0 commit comments