1- *options.txt* For Vim version 9.1. Last change: 2025 Feb 16
1+ *options.txt* For Vim version 9.1. Last change: 2025 Mar 02
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2107,10 +2107,10 @@ A jump table for the options with a short description can be found at |Q_op|.
21072107 *'completeitemalign'* *'cia'*
21082108'completeitemalign' 'cia' string (default: "abbr,kind,menu")
21092109 global
2110- A comma-separated list of | complete-items | that controls the alignment
2111- and display order of items in the popup menu during Insert mode
2112- completion. The supported values are abbr, kind, and menu. These
2113- options allow to customize how the completion items are shown in the
2110+ A comma-separated list of strings that controls the alignment and
2111+ display order of items in the popup menu during Insert mode
2112+ completion. The supported values are " abbr", " kind" , and " menu".
2113+ These values allow customizing how | complete- items| are shown in the
21142114 popup menu. Note: must always contain those three values in any
21152115 order.
21162116
@@ -2120,6 +2120,17 @@ A jump table for the options with a short description can be found at |Q_op|.
21202120 A comma-separated list of options for Insert mode completion
21212121 | ins-completion | . The supported values are:
21222122
2123+ fuzzy Enable | fuzzy-matching | for completion candidates. This
2124+ allows for more flexible and intuitive matching, where
2125+ characters can be skipped and matches can be found even
2126+ if the exact sequence is not typed.
2127+
2128+ longest Only insert the longest common text of the matches. If
2129+ the menu is displayed you can use CTRL-L to add more
2130+ characters. Whether case is ignored depends on the kind
2131+ of completion. For buffer text the 'ignorecase' option is
2132+ used.
2133+
21232134 menu Use a popup menu to show the possible completions. The
21242135 menu is only shown when there is more than one match and
21252136 sufficient colors are available. | ins-completion-menu |
@@ -2128,15 +2139,17 @@ A jump table for the options with a short description can be found at |Q_op|.
21282139 Useful when there is additional information about the
21292140 match, e.g., what file it comes from.
21302141
2131- longest Only insert the longest common text of the matches. If
2132- the menu is displayed you can use CTRL-L to add more
2133- characters. Whether case is ignored depends on the kind
2134- of completion. For buffer text the 'ignorecase' option is
2135- used.
2142+ noinsert Do not insert any text for a match until the user selects
2143+ a match from the menu. Only works in combination with
2144+ "menu" or "menuone". No effect if "longest" is present.
21362145
2137- preview Show extra information about the currently selected
2138- completion in the preview window. Only works in
2139- combination with "menu" or "menuone".
2146+ noselect Same as "noinsert", except that no menu item is
2147+ pre-selected. If both "noinsert" and "noselect" are
2148+ present, "noselect" has precedence.
2149+
2150+ nosort Disable sorting of completion candidates based on fuzzy
2151+ scores when "fuzzy" is enabled. Candidates will appear
2152+ in their original order.
21402153
21412154 popup Show extra information about the currently selected
21422155 completion in a popup window. Only works in combination
@@ -2151,28 +2164,15 @@ A jump table for the options with a short description can be found at |Q_op|.
21512164 See the example at | complete-popuphidden | .
21522165 {only works when compiled with the | +textprop | feature}
21532166
2154- noinsert Do not insert any text for a match until the user selects
2155- a match from the menu. Only works in combination with
2156- "menu" or "menuone". No effect if "longest" is present.
2157-
2158- noselect Same as "noinsert", except that no menu item is
2159- pre-selected. If both "noinsert" and "noselect" are
2160- present, "noselect" has precedence.
2161-
2162- fuzzy Enable | fuzzy-matching | for completion candidates. This
2163- allows for more flexible and intuitive matching, where
2164- characters can be skipped and matches can be found even
2165- if the exact sequence is not typed.
2166-
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-
21712167 preinsert
21722168 Preinsert the portion of the first candidate word that is
21732169 not part of the current completion leader and using the
2174- | hl-ComplMatchIns | highlight group. Does not work when
2175- "fuzzy" is also included.
2170+ | hl-ComplMatchIns | highlight group. In order for it to
2171+ work, "fuzzy" must not bet set and "menuone" must be set.
2172+
2173+ preview Show extra information about the currently selected
2174+ completion in the preview window. Only works in
2175+ combination with "menu" or "menuone".
21762176
21772177 *'completepopup'* *'cpp'*
21782178'completepopup' 'cpp' string (default empty)
@@ -9566,7 +9566,10 @@ A jump table for the options with a short description can be found at |Q_op|.
95669566 "lastused" When completing buffer names and more than one buffer
95679567 matches, sort buffers by time last used (other than
95689568 the current buffer).
9569- When there is only a single match, it is fully completed in all cases.
9569+ "noselect" Do not pre-select first menu item and start 'wildmenu'
9570+ if it is enabled.
9571+ When there is only a single match, it is fully completed in all cases
9572+ except when "noselect" is present.
95709573
95719574 Examples of useful colon-separated values:
95729575 "longest:full" Like "longest", but also start 'wildmenu' if it is
@@ -9589,7 +9592,11 @@ A jump table for the options with a short description can be found at |Q_op|.
95899592 :set wildmode=list,full
95909593< List all matches without completing, then each full match >
95919594 :set wildmode=longest,list
9592- < Complete longest common string, then list alternatives.
9595+ < Complete longest common string, then list alternatives >
9596+ :set wildmode=noselect:full
9597+ < Display 'wildmenu' without completing, then each full match >
9598+ :set wildmode=noselect:lastused,full
9599+ < Same as above, but sort buffers by time last used.
95939600 More info here: | cmdline-completion | .
95949601
95959602 *'wildoptions'* *'wop'*
0 commit comments