diff options
author | Yegappan Lakshmanan <yegappan@yahoo.com> | 2022-02-08 12:08:07 +0000 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2022-02-08 12:08:07 +0000 |
commit | 3908ef5017a6b4425727013588f72cc7343199b9 (patch) | |
tree | e70cbd04c972b1566a45e8536210e1334e1b0373 /runtime | |
parent | 3787f26c2ed33732a36f26ebe46faeebfe0151af (diff) |
patch 8.2.4325: 'wildmenu' only shows few matchesv8.2.4325
Problem: 'wildmenu' only shows few matches.
Solution: Add the "pum" option: use a popup menu to show the matches.
(Yegappan Lakshmanan et al., closes #9707)
Diffstat (limited to 'runtime')
-rw-r--r-- | runtime/doc/options.txt | 31 |
1 files changed, 25 insertions, 6 deletions
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 732e5a74dd..ee2caa7530 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -8974,7 +8974,8 @@ A jump table for the options with a short description can be found at |Q_op|. mode. On pressing 'wildchar' (usually <Tab>) to invoke completion, the possible matches are shown just above the command line, with the first match highlighted (overwriting the status line, if there is - one). Keys that show the previous/next match, such as <Tab> or + one). This is the behavior without "pum" in 'wildoptions. + Keys that show the previous/next match, such as <Tab> or CTRL-P/CTRL-N, cause the highlight to move to the appropriate match. When 'wildmode' is used, "wildmenu" mode is used where "full" is specified. "longest" and "list" do not start "wildmenu" mode. @@ -8982,10 +8983,12 @@ A jump table for the options with a short description can be found at |Q_op|. If there are more matches than can fit in the line, a ">" is shown on the right and/or a "<" is shown on the left. The status line scrolls as needed. + When 'wildoptions' contains "pum", then the completion matches are + shown in a popup menu. The "wildmenu" mode is abandoned when a key is hit that is not used for selecting a completion. - While the "wildmenu" is active the following keys have special - meanings: + While the "wildmenu" is active, not using the popup menu, the + following keys have special meanings: <Left> <Right> - select previous/next match (like CTRL-P/CTRL-N) <Down> - in filename/menu name completion: move into a @@ -8995,6 +8998,21 @@ A jump table for the options with a short description can be found at |Q_op|. <Up> - in filename/menu name completion: move up into parent directory or parent menu. + When using the popup menu for command line completion, the following + keys have special meanings: + <Down> - select next match (like CTRL-N) + <Left> - in filename/menu name completion: move up into + parent directory or parent menu. + <Right> - in filename/menu name completion: move into a + subdirectory or submenu. + <Up> - select previous match (like CTRL-P) + CTRL-E - end completion, go back to what was there before + selecting a match. + CTRL-N - go to the next entry + CTRL-P - go to the previous entry + CTRL-Y - accept the currently selected match and stop + completion. + This makes the menus accessible from the console |console-menus|. If you prefer the <Left> and <Right> keys to move the cursor instead @@ -9057,14 +9075,15 @@ A jump table for the options with a short description can be found at |Q_op|. global {not available when compiled without the |+wildignore| feature} - A list of words that change how command line completion is done. - Currently only one word is allowed: + A list of words that change how |cmdline-completion| is done. + The following values are supported: + pum Display the completion matches using the popupmenu + in the same style as the |ins-completion-menu|. 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 - Also see |cmdline-completion|. *'winaltkeys'* *'wak'* 'winaltkeys' 'wak' string (default "menu") |