runtime(doc): add more pointers to 'completeopt'
Commit:
https://github.com/vim/vim/commit/053aee01f7374fc8c985300399b1ad3b3626e40f
Author: Ilya Grigoriev <ily...@users.noreply.github.com>
Date: Wed Jun 11 21:07:35 2025 +0200
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 <ily...@users.noreply.github.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>
diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
index 155eb8f13..da028e820 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 b50468863..f4d2c26b4 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
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to vim_dev+unsubscr...@googlegroups.com.
To view this discussion visit
https://groups.google.com/d/msgid/vim_dev/E1uPQud-00DqhS-1a%40256bit.org.
