diff options
Diffstat (limited to 'runtime/lua/vim/_meta')
| -rw-r--r-- | runtime/lua/vim/_meta/api.lua | 18 | ||||
| -rw-r--r-- | runtime/lua/vim/_meta/options.lua | 27 |
2 files changed, 20 insertions, 25 deletions
diff --git a/runtime/lua/vim/_meta/api.lua b/runtime/lua/vim/_meta/api.lua index 15cdd8fc79..b890b64174 100644 --- a/runtime/lua/vim/_meta/api.lua +++ b/runtime/lua/vim/_meta/api.lua @@ -9,19 +9,16 @@ error('Cannot require a meta file') vim.api = {} ---- @private --- @param buffer integer --- @param keys boolean --- @param dot boolean --- @return string function vim.api.nvim__buf_debug_extmarks(buffer, keys, dot) end ---- @private --- @param buffer integer --- @return table<string,any> function vim.api.nvim__buf_stats(buffer) end ---- @private --- EXPERIMENTAL: this API may change in the future. --- --- Sets info for the completion item at the given index. If the info text was shown in a window, @@ -35,11 +32,9 @@ function vim.api.nvim__buf_stats(buffer) end --- - bufnr: (number) buffer id in floating window function vim.api.nvim__complete_set(index, opts) end ---- @private --- @return string function vim.api.nvim__get_lib_dir() end ---- @private --- Find files in runtime directories --- --- @param pat any[] pattern of files to search for @@ -48,7 +43,6 @@ function vim.api.nvim__get_lib_dir() end --- @return string[] # list of absolute paths to the found files function vim.api.nvim__get_runtime(pat, all, opts) end ---- @private --- Returns object given as argument. --- --- This API function is used for testing. One should not rely on its presence @@ -58,7 +52,6 @@ function vim.api.nvim__get_runtime(pat, all, opts) end --- @return any # its argument. function vim.api.nvim__id(obj) end ---- @private --- Returns array given as argument. --- --- This API function is used for testing. One should not rely on its presence @@ -68,7 +61,6 @@ function vim.api.nvim__id(obj) end --- @return any[] # its argument. function vim.api.nvim__id_array(arr) end ---- @private --- Returns dict given as argument. --- --- This API function is used for testing. One should not rely on its presence @@ -78,7 +70,6 @@ function vim.api.nvim__id_array(arr) end --- @return table<string,any> # its argument. function vim.api.nvim__id_dict(dct) end ---- @private --- Returns floating-point value given as argument. --- --- This API function is used for testing. One should not rely on its presence @@ -88,7 +79,6 @@ function vim.api.nvim__id_dict(dct) end --- @return number # its argument. function vim.api.nvim__id_float(flt) end ---- @private --- NB: if your UI doesn't use hlstate, this will not return hlstate first time. --- @param grid integer --- @param row integer @@ -96,12 +86,10 @@ function vim.api.nvim__id_float(flt) end --- @return any[] function vim.api.nvim__inspect_cell(grid, row, col) end ---- @private --- For testing. The condition in schar_cache_clear_if_full is hard to --- reach, so this function can be used to force a cache clear in a test. function vim.api.nvim__invalidate_glyph_cache() end ---- @private --- EXPERIMENTAL: this API will change in the future. --- --- Get the properties for namespace @@ -110,7 +98,6 @@ function vim.api.nvim__invalidate_glyph_cache() end --- @return vim.api.keyset.ns_opts # Map defining the namespace properties, see |nvim__ns_set()| function vim.api.nvim__ns_get(ns_id) end ---- @private --- EXPERIMENTAL: this API will change in the future. --- --- Set some properties for namespace @@ -120,7 +107,6 @@ function vim.api.nvim__ns_get(ns_id) end --- - wins: a list of windows to be scoped in function vim.api.nvim__ns_set(ns_id, opts) end ---- @private --- EXPERIMENTAL: this API may change in the future. --- --- Instruct Nvim to redraw various components. @@ -148,21 +134,17 @@ function vim.api.nvim__ns_set(ns_id, opts) end --- - tabline: Redraw the 'tabline'. function vim.api.nvim__redraw(opts) end ---- @private --- @return any[] function vim.api.nvim__runtime_inspect() end ---- @private --- @param path string function vim.api.nvim__screenshot(path) end ---- @private --- Gets internal stats. --- --- @return table<string,any> # Map of various internal stats. function vim.api.nvim__stats() end ---- @private --- @param str string --- @return any function vim.api.nvim__unpack(str) end diff --git a/runtime/lua/vim/_meta/options.lua b/runtime/lua/vim/_meta/options.lua index 8df174a838..59e65b0585 100644 --- a/runtime/lua/vim/_meta/options.lua +++ b/runtime/lua/vim/_meta/options.lua @@ -1083,15 +1083,15 @@ vim.go.cia = vim.go.completeitemalign --- match, e.g., what file it comes from. --- --- noinsert Do not insert any text for a match until the user selects ---- a match from the menu. Only works in combination with +--- a match from the menu. Only works in combination with --- "menu" or "menuone". No effect if "longest" is present. --- --- noselect Same as "noinsert", except that no menu item is ---- pre-selected. If both "noinsert" and "noselect" are +--- pre-selected. If both "noinsert" and "noselect" are --- present, "noselect" has precedence. --- --- nosort Disable sorting of completion candidates based on fuzzy ---- scores when "fuzzy" is enabled. Candidates will appear +--- scores when "fuzzy" is enabled. Candidates will appear --- in their original order. --- --- popup Show extra information about the currently selected @@ -1102,7 +1102,7 @@ vim.go.cia = vim.go.completeitemalign --- Preinsert the portion of the first candidate word that is --- not part of the current completion leader and using the --- `hl-ComplMatchIns` highlight group. In order for it to ---- work, "fuzzy" must not bet set and "menuone" must be set. +--- work, "fuzzy" must not be set and "menuone" must be set. --- --- preview Show extra information about the currently selected --- completion in the preview window. Only works in @@ -4640,7 +4640,7 @@ vim.go.pm = vim.go.patchmode --- ``` --- - A directory name may end in a ':' or '/'. --- - Environment variables are expanded `:set_env`. ---- - When using `netrw.vim` URLs can be used. For example, adding +--- - When using `netrw` URLs can be used. For example, adding --- "https://www.vim.org" will make ":find index.html" work. --- - Search upwards and downwards in a directory tree using "*", "**" and --- ";". See `file-searching` for info and syntax. @@ -7691,7 +7691,10 @@ vim.go.wmnu = vim.go.wildmenu --- "lastused" When completing buffer names and more than one buffer --- matches, sort buffers by time last used (other than --- the current buffer). ---- When there is only a single match, it is fully completed in all cases. +--- "noselect" Do not pre-select first menu item and start 'wildmenu' +--- if it is enabled. +--- When there is only a single match, it is fully completed in all cases +--- except when "noselect" is present. --- --- Examples of useful colon-separated values: --- "longest:full" Like "longest", but also start 'wildmenu' if it is @@ -7729,7 +7732,17 @@ vim.go.wmnu = vim.go.wildmenu --- ```vim --- set wildmode=longest,list --- ``` ---- Complete longest common string, then list alternatives. +--- Complete longest common string, then list alternatives +--- +--- ```vim +--- set wildmode=noselect:full +--- ``` +--- Display 'wildmenu' without completing, then each full match +--- +--- ```vim +--- set wildmode=noselect:lastused,full +--- ``` +--- Same as above, but sort buffers by time last used. --- More info here: `cmdline-completion`. --- --- @type string |