Merge pull request #2490 from h-east/update-map

Update map.{txt,jax}

Author: h-east

doc/map.jax

@@ -1,4 +1,4 @@
-*map.txt*	For Vim バージョン 9.1.  Last change: 2025 Nov 09
+*map.txt*	For Vim バージョン 9.1.  Last change: 2026 Feb 04
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -1640,7 +1640,9 @@ script2.vimを実行すると "None" が表示されます。期待した結果
 	-complete=scriptnames	読み込まれたスクリプト
 	-complete=shellcmd	シェルコマンド
 	-complete=shellcmdline	最初はシェルコマンドで、後続はファイル名。
-				|:!cmd| と同じ動作である
+				|:!cmd| と同じ動作である。正しい補完を得るに
+				は、|:command-nargs| は '*' または '+' である
+				必要がある
 	-complete=sign		|:sign| サブオプション
 	-complete=syntax	シンタックスファイル名 'syntax'
 	-complete=syntime       |:syntime| サブオプション
@@ -1673,7 +1675,9 @@ Note: いくつかの補完方法は環境変数を展開します。
 ト中の文字列以外の変数は無視されます。
 
 引数には次の意味があります:
-	ArgLead		すでに入力されている補完対象の文字列
+	ArgLead		すでに入力されている補完対象の文字列。note "-nargs=1"
+			を使用している場合でも、これは現在のスペースで区切られ
+			た単語のみをキャプチャすることに注意。
 	CmdLine		コマンドライン全体
 	CursorPos	カーソル位置 (バイト単位のインデックス)
 これらの引数を使えば文脈を判断することができるでしょう。"custom" を使った場合、

en/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 04
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -1659,7 +1659,9 @@ completion can be enabled:
 	-complete=scriptnames	sourced script names
 	-complete=shellcmd	Shell command
 	-complete=shellcmdline	First is a shell command and subsequent ones
-				are filenames.  The same behavior as |:!cmd|
+				are filenames.  The same behavior as |:!cmd|.
+				To get correct completion, |:command-nargs|
+				should be '*' or '+'
 	-complete=sign		|:sign| suboptions
 	-complete=syntax	syntax file names 'syntax'
 	-complete=syntime	|:syntime| suboptions
@@ -1695,7 +1697,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"