|
1 | | -*options.txt* For Vim version 9.1. Last change: 2025 Sep 15 |
| 1 | +*options.txt* For Vim version 9.1. Last change: 2025 Sep 29 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar |
@@ -913,7 +913,7 @@ A jump table for the options with a short description can be found at |Q_op|. |
913 | 913 |
|
914 | 914 | *'autocomplete'* *'ac'* *'noautocomplete'* *'noac'* |
915 | 915 | 'autocomplete' 'ac' boolean (default off) |
916 | | - global |
| 916 | + global or local to buffer |global-local| |
917 | 917 | {only available on platforms with timing support} |
918 | 918 | When on, Vim shows a completion menu as you type, similar to using |
919 | 919 | |i_CTRL-N|, but triggered automatically. See |ins-autocompletion|. |
@@ -2256,11 +2256,22 @@ A jump table for the options with a short description can be found at |Q_op|. |
2256 | 2256 | to gather more alternatives for your candidate list, |
2257 | 2257 | see 'completefuzzycollect'. |
2258 | 2258 |
|
2259 | | - longest Only insert the longest common text of the matches. If |
2260 | | - the menu is displayed you can use CTRL-L to add more |
2261 | | - characters. Whether case is ignored depends on the kind |
2262 | | - of completion. For buffer text the 'ignorecase' option is |
2263 | | - used. |
| 2259 | + longest |
| 2260 | + When 'autocomplete' is not active, only the longest |
| 2261 | + common prefix of the matches is inserted. If the popup |
| 2262 | + menu is displayed, you can use CTRL-L to add more |
| 2263 | + characters. Whether case is ignored depends on the type |
| 2264 | + of completion. For buffer text the 'ignorecase' option |
| 2265 | + applies. |
| 2266 | + |
| 2267 | + When 'autocomplete' is active and no completion item is |
| 2268 | + selected, the longest common prefix of the matches is |
| 2269 | + inserted after the cursor. The prefix is taken either |
| 2270 | + from all displayed items or only from items in the current |
| 2271 | + buffer. The inserted text is highlighted with |
| 2272 | + |hl-PreInsert|, and the cursor position does not change |
| 2273 | + (similar to `"preinsert"`). Press CTRL-Y to accept. |
| 2274 | + See also |preinserted()|. |
2264 | 2275 |
|
2265 | 2276 | menu Use a popup menu to show the possible completions. The |
2266 | 2277 | menu is only shown when there is more than one match and |
@@ -2302,22 +2313,21 @@ A jump table for the options with a short description can be found at |Q_op|. |
2302 | 2313 | {only works when compiled with the |+textprop| feature} |
2303 | 2314 |
|
2304 | 2315 | preinsert |
2305 | | - When 'autocomplete' is not active, inserts the part of the |
2306 | | - first candidate word beyond the current completion leader, |
2307 | | - highlighted with |hl-PreInsert|. The cursor doesn't move. |
2308 | | - Requires "fuzzy" unset and "menuone" in 'completeopt'. |
2309 | | - |
2310 | | - When 'autocomplete' is active, inserts the longest common |
2311 | | - prefix of matches (from all shown items or from the |
2312 | | - current buffer items). This occurs only when no menu item |
2313 | | - is selected. Press CTRL-Y to accept. |
| 2316 | + Inserts the text of the first completion candidate |
| 2317 | + beyond the current leader, highlighted with |hl-PreInsert|. |
| 2318 | + The cursor does not move. |
| 2319 | + Requires "fuzzy" to be unset, and either "menuone" in |
| 2320 | + 'completeopt' or 'autocomplete' enabled. When |
| 2321 | + 'autocomplete' is enabled, this does not work if |
| 2322 | + 'ignorecase' is set without 'infercase'. |
| 2323 | + See also |preinserted()|. |
2314 | 2324 |
|
2315 | 2325 | preview Show extra information about the currently selected |
2316 | 2326 | completion in the preview window. Only works in |
2317 | 2327 | combination with "menu" or "menuone". |
2318 | 2328 |
|
2319 | | - Only "fuzzy", "popup", "popuphidden", "preinsert" and "preview" have |
2320 | | - an effect when 'autocomplete' is enabled. |
| 2329 | + Only "fuzzy", "longest", "popup", "popuphidden", "preinsert" and |
| 2330 | + "preview" have an effect when 'autocomplete' is enabled. |
2321 | 2331 |
|
2322 | 2332 | This option does not apply to |cmdline-completion|. See 'wildoptions' |
2323 | 2333 | for that. |
@@ -3699,7 +3709,7 @@ A jump table for the options with a short description can be found at |Q_op|. |
3699 | 3709 | command to find the illegal byte sequence. |
3700 | 3710 | WRONG VALUES: WHAT'S WRONG: |
3701 | 3711 | latin1,utf-8 "latin1" will always be used |
3702 | | - utf-8,ucs-bom,latin1 BOM won't be recognized in an utf-8 |
| 3712 | + utf-8,ucs-bom,latin1 BOM won't be recognized in a utf-8 |
3703 | 3713 | file |
3704 | 3714 | cp1250,latin1 "cp1250" will always be used |
3705 | 3715 | If 'fileencodings' is empty, 'fileencoding' is not modified. |
@@ -3791,7 +3801,13 @@ A jump table for the options with a short description can be found at |Q_op|. |
3791 | 3801 | 'fileignorecase' 'fic' boolean (default on for systems where case in file |
3792 | 3802 | names is normally ignored) |
3793 | 3803 | global |
3794 | | - When set case is ignored when using file names and directories. |
| 3804 | + When set, case is ignored when using file and directory names. |
| 3805 | + |
| 3806 | + This option is on by default on systems where the filesystem is |
| 3807 | + traditionally case-insensitive (for example MS-Windows and macOS). |
| 3808 | + However, Vim cannot determine at runtime whether a particular |
| 3809 | + filesystem is case-sensitive or case-insensitive. |
| 3810 | + |
3795 | 3811 | See 'wildignorecase' for only ignoring case when doing completion. |
3796 | 3812 |
|
3797 | 3813 | *'filetype'* *'ft'* |
@@ -8913,14 +8929,15 @@ A jump table for the options with a short description can be found at |Q_op|. |
8913 | 8929 | When on, uses |highlight-guifg| and |highlight-guibg| attributes in |
8914 | 8930 | the terminal (thus using 24-bit color). |
8915 | 8931 |
|
8916 | | - Requires a ISO-8613-3 compatible terminal. If setting this option |
| 8932 | + Requires an ISO-8613-3 compatible terminal. If setting this option |
8917 | 8933 | does not work (produces a colorless UI) reading |xterm-true-color| |
8918 | 8934 | might help. |
8919 | 8935 |
|
8920 | 8936 | For Win32 console, Windows 10 version 1703 (Creators Update) or later |
8921 | 8937 | is required. Use this check to find out: > |
8922 | 8938 | if has('vcon') |
8923 | | -< This requires Vim to be built with the |+vtp| feature. |
| 8939 | +< This requires Vim to be built with the |+vtp| feature, see also |
| 8940 | + |win32-term-colors|. |
8924 | 8941 |
|
8925 | 8942 | Note that the "cterm" attributes are still used, not the "gui" ones. |
8926 | 8943 |
|
@@ -10204,7 +10221,8 @@ A jump table for the options with a short description can be found at |Q_op|. |
10204 | 10221 | *'wlsteal'* *'wst'* *'nowlsteal'* *'nowst'* |
10205 | 10222 | 'wlsteal' 'wst' boolean (default off) |
10206 | 10223 | global |
10207 | | - {only when the |+wayland_clipboard| feature is included} |
| 10224 | + {only when the |+wayland_focus_steal| feature is |
| 10225 | + included} |
10208 | 10226 | When enabled, then allow Vim to steal focus by creating a temporary |
10209 | 10227 | surface, in order to access the clipboard. For more information see |
10210 | 10228 | |wayland-focus-steal|. |
@@ -10241,6 +10259,11 @@ A jump table for the options with a short description can be found at |Q_op|. |
10241 | 10259 | < See 'sidescroll', 'listchars' and |wrap-off|. |
10242 | 10260 | This option can't be set from a |modeline| when the 'diff' option is |
10243 | 10261 | on. |
| 10262 | + If 'nowrap' was set from a |modeline| or in the |sandbox|, '>' is used |
| 10263 | + as the |lcs-extends| character regardless of the value of the 'list' |
| 10264 | + and 'listchars' options. This is to prevent malicious code outside |
| 10265 | + the viewport from going unnoticed. Use `:setlocal nowrap` manually |
| 10266 | + afterwards to disable this behavior. |
10244 | 10267 |
|
10245 | 10268 | *'wrapmargin'* *'wm'* |
10246 | 10269 | 'wrapmargin' 'wm' number (default 0) |
|
0 commit comments