From: Ilya Grigoriev Date: Wed, 11 Jun 2025 19:07:35 +0000 (+0200) Subject: runtime(doc): add more pointers to 'completeopt' X-Git-Tag: v9.1.1454~2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=053aee01f7374fc8c985300399b1ad3b3626e40f;p=thirdparty%2Fvim.git runtime(doc): add more pointers to 'completeopt' Before this commit, I had trouble finding information about configuring the insert mode completion. In particular, it was not clear that the 'wildopt' config that I already had in my vimrc does not apply here. Also, `insert.txt` barely mentioned 'completeopt' except when describing popups (I was more interested in bash-like behavior where the unique prefix of all completions is completed first). I'm hoping these edits will make the relevant docs easier to find. closes: #17515 Signed-off-by: Ilya Grigoriev Signed-off-by: Christian Brabandt --- diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt index 155eb8f13a..da028e820b 100644 --- a/runtime/doc/insert.txt +++ b/runtime/doc/insert.txt @@ -1,4 +1,4 @@ -*insert.txt* For Vim version 9.1. Last change: 2025 Jun 04 +*insert.txt* For Vim version 9.1. Last change: 2025 Jun 11 VIM REFERENCE MANUAL by Bram Moolenaar @@ -659,6 +659,9 @@ and one of the CTRL-X commands. You exit CTRL-X mode by typing a key that is not a valid CTRL-X mode command. Valid keys are the CTRL-X command itself, CTRL-N (next), and CTRL-P (previous). +By default, the possible completions are showed in a menu and the first +completion is inserted into the text. This can be adjusted with 'completeopt'. + To get the current completion information, |complete_info()| can be used. Also see the 'infercase' option if you want to adjust the case of the match. diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index b504688633..f4d2c26b48 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 9.1. Last change: 2025 Jun 10 +*options.txt* For Vim version 9.1. Last change: 2025 Jun 11 VIM REFERENCE MANUAL by Bram Moolenaar @@ -2249,6 +2249,9 @@ A jump table for the options with a short description can be found at |Q_op|. completion in the preview window. Only works in combination with "menu" or "menuone". + This option does not apply to |cmdline-completion|. See 'wildoptions' + for that. + *'completepopup'* *'cpp'* 'completepopup' 'cpp' string (default empty) global @@ -9809,6 +9812,7 @@ 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 |cmdline-completion| is done. + The following values are supported: fuzzy Use |fuzzy-matching| to find completion matches. When this value is specified, wildcard expansion will not @@ -9826,6 +9830,9 @@ A jump table for the options with a short description can be found at |Q_op|. d #define f function + This option does not apply to |ins-completion|. See 'completeopt' for + that. + *'winaltkeys'* *'wak'* 'winaltkeys' 'wak' string (default "menu") global