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 <ilyagr@users.noreply.github.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
index 155eb8f..da028e8 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 @@
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 b504688..f4d2c26 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 @@
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 @@
'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 @@
d #define
f function
+ This option does not apply to |ins-completion|. See 'completeopt' for
+ that.
+
*'winaltkeys'* *'wak'*
'winaltkeys' 'wak' string (default "menu")
global