From 3908ef5017a6b4425727013588f72cc7343199b9 Mon Sep 17 00:00:00 2001 From: Yegappan Lakshmanan Date: Tue, 8 Feb 2022 12:08:07 +0000 Subject: patch 8.2.4325: 'wildmenu' only shows few matches 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) --- runtime/doc/options.txt | 31 +++++++++++++++++++++++++------ 1 file changed, 25 insertions(+), 6 deletions(-) (limited to 'runtime/doc/options.txt') 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 ) 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 or + one). This is the behavior without "pum" in 'wildoptions. + Keys that show the previous/next match, such as 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: - select previous/next match (like CTRL-P/CTRL-N) - 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|. - 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: + - select next match (like CTRL-N) + - in filename/menu name completion: move up into + parent directory or parent menu. + - in filename/menu name completion: move into a + subdirectory or submenu. + - 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 and 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") -- cgit v1.2.3