Commit: runtime(doc): Clarify the behaviour of command completion functions

[Christian Brabandt]

runtime(doc): Clarify the behaviour of command completion functions

Commit: https://github.com/vim/vim/commit/093d0cb1cf10fac5b7cf2be389c89f3978f9cb3e
Author: Christian Brabandt <c...@256bit.org>
Date: Mon Feb 2 16:55:41 2026 +0000

runtime(doc): Clarify the behaviour of command completion functions

closes: https://github.com/vim/vim/issues/19294

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

diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt
index ee46180a6..7ff9cfc07 100644
--- a/runtime/doc/map.txt
+++ b/runtime/doc/map.txt
@@ -1,4 +1,4 @@
-*map.txt* For Vim version 9.1. Last change: 2025 Nov 09
+*map.txt* For Vim version 9.1. Last change: 2026 Feb 02


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1695,7 +1695,8 @@ candidates as a Vim List. Non-string items in the list are ignored.

The function arguments are:
ArgLead the leading portion of the argument currently being
- completed on
+ completed on; note that this only captures the current
+ space-separated word, even when using "-nargs=1"
CmdLine the entire command line
CursorPos the cursor position in it (byte index)
The function may use these for determining context. For the "custom"