runtime(doc): Improve doc for cmdline-autocomplete

Maybe this was unnecessary, but saw this:
https://github.com/vim/vim/issues/17854

Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 02264ea4e559073b812ab32aa2a1c944bd491c45..2c18290f91802dd273af76aef23681182991782c 100644 (file)
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt*  For Vim version 9.1.  Last change: 2025 Aug 06
+*builtin.txt*  For Vim version 9.1.  Last change: 2025 Aug 08
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -12353,6 +12353,11 @@ wildtrigger()                                          *wildtrigger()*
                To retain normal history navigation (up/down keys): >
                        cnoremap <Up>   <C-U><Up>
                        cnoremap <Down> <C-U><Down>
+<
+               To set an option specifically when performing a search, e.g.
+               to set 'pumheight': >
+                       autocmd CmdlineEnter [/\?] set pumheight=8
+                       autocmd CmdlineLeave [/\?] set pumheight&
 <
                Return value is always 0.
 

diff --git a/runtime/doc/cmdline.txt b/runtime/doc/cmdline.txt
index edc0f0fc36a08e0685eede668988db7fed2dcda6..e5d932a9da355296af61196f32cefb3ba933aff0 100644 (file)
--- a/runtime/doc/cmdline.txt
+++ b/runtime/doc/cmdline.txt
@@ -1,4 +1,4 @@
-*cmdline.txt*   For Vim version 9.1.  Last change: 2025 Jul 21
+*cmdline.txt*   For Vim version 9.1.  Last change: 2025 Aug 08
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -927,7 +927,7 @@ to insert special things while typing you can use the CTRL-R command.  For
 example, "%" stands for the current file name, while CTRL-R % inserts the
 current file name right away.  See |c_CTRL-R|.
 
-Note:  If you want to avoid the effects of special characters in a Vim script
+Note: If you want to avoid the effects of special characters in a Vim script
 you may want to use |fnameescape()|.  Also see |`=|.
 
 
@@ -1325,8 +1325,10 @@ Example: >
        :au CmdwinLeave :  let &cpt = b:cpt_save
 This sets 'complete' to use completion in the current window for |i_CTRL-N|.
 Another example: >
-       :au CmdwinEnter [/?]  startinsert
+       :au CmdwinEnter [/\?]  startinsert
 This will make Vim start in Insert mode in the command-line window.
+Note: The "?" needs to be escaped, as this is a |file-pattern|.  See also
+|cmdline-autocompletion|.
 
                                                *cmdwin-char*
 The character used for the pattern indicates the type of command-line: