diff options
Diffstat (limited to 'runtime')
| -rw-r--r-- | runtime/doc/options.txt | 3 | ||||
| -rw-r--r-- | runtime/doc/ui.txt | 18 | ||||
| -rw-r--r-- | runtime/doc/vim_diff.txt | 1 |
3 files changed, 17 insertions, 5 deletions
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 505c0c5ea0..7bb9ae68bc 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -6599,12 +6599,13 @@ A jump table for the options with a short description can be found at |Q_op|. 'wildoptions' 'wop' string (default "") global A list of words that change how command line completion is done. - Currently only one word is allowed: tagfile When using CTRL-D to list matching tags, the kind of tag and the file of the tag is listed. Only one match is displayed per line. Often used tag kinds are: d #define f function + pum Display the completion matches using the popupmenu + in the same style as the |ins-completion-menu|. Also see |cmdline-completion|. *'winaltkeys'* *'wak'* diff --git a/runtime/doc/ui.txt b/runtime/doc/ui.txt index 270c4fb556..6976efe60a 100644 --- a/runtime/doc/ui.txt +++ b/runtime/doc/ui.txt @@ -31,7 +31,7 @@ a dictionary with these (optional) keys: `ext_popupmenu` Externalize the popupmenu. |ui-popupmenu| `ext_tabline` Externalize the tabline. |ui-tabline| `ext_cmdline` Externalize the cmdline. |ui-cmdline| - `ext_wildmenu` Externalize the wildmenu. |ui-wildmenu| + `ext_wildmenu` Externalize the wildmenu (deprecated). |ui-wildmenu| `ext_messages` Externalize messages. |ui-messages| `ext_linegrid` Use new revision of the grid events. |ui-linegrid| `ext_multigrid` Use per-window grid based events. |ui-multigrid| @@ -554,7 +554,7 @@ See |nvim_input_mouse| for sending mouse events to Nvim. ============================================================================== Popupmenu Events *ui-popupmenu* -Only sent if `ext_popupmenu` option is set in |ui-options| +Only sent if `ext_popupmenu` option is set in |ui-options|. ["popupmenu_show", items, selected, row, col, grid] Show |popupmenu-completion|. `items` is an array of completion items @@ -564,7 +564,9 @@ Only sent if `ext_popupmenu` option is set in |ui-options| index into the array of items (-1 if no item is selected). `row` and `col` give the anchor position, where the first character of the completed word will be. When |ui-multigrid| is used, `grid` is the - grid for the anchor position. + grid for the anchor position. When `ext_cmdline` is active, `grid` is + set to -1 to indicate the popupmenu should be anchored to the external + cmdline. Then `col` will be a byte position in the cmdline text. ["popupmenu_select", selected] Select an item in the current popupmenu. `selected` is a zero-based @@ -588,7 +590,10 @@ Only sent if `ext_tabline` option is set in |ui-options| ============================================================================== Cmdline Events *ui-cmdline* -Only sent if `ext_cmdline` option is set in |ui-options|. +Only sent if `ext_cmdline` option is set in |ui-options|. To handle +command-line completion (wildmenu), use |ui-popupmenu| events activated by +|ext_popupmenu| option. (The `ext_wildmenu` option only exists for backwards +compatibility). ["cmdline_show", content, pos, firstc, prompt, indent, level] content: List of [attrs, string] @@ -648,6 +653,11 @@ Wildmenu Events *ui-wildmenu* Only sent if `ext_wildmenu` option is set in |ui-options| +Deprecated. When `ext_cmdline` and `ext_popupmenu` are both set, +|ui-popupmenu| events will be used for command-line completion. But if +`ext_wildmenu` is also set, these events are still used for backwards +compatibility. New clients should use `ext_popupmenu` instead. + ["wildmenu_show", items] Activate the wildmenu (command-line completion). `items` is an array with the completion items. diff --git a/runtime/doc/vim_diff.txt b/runtime/doc/vim_diff.txt index 55c3be9a57..d3ac0ba613 100644 --- a/runtime/doc/vim_diff.txt +++ b/runtime/doc/vim_diff.txt @@ -195,6 +195,7 @@ Options: 'scrollback' 'statusline' supports unlimited alignment sections 'tabline' %@Func@foo%X can call any function on mouse-click + 'wildoptions' `pum` flag to use popupmenu for wildmode completion 'winhighlight' window-local highlights Variables: |