Update builtin.{txt,jax}

Author: h-east

doc/builtin.jax

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 17
+*builtin.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 25
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -6333,6 +6333,8 @@ js_decode({string})					*js_decode()*
 		- 文字列はシングルクォートでくくることができる。
 		- 配列内の(2つのコンマで区切られた)空アイテムが許可され結果と
 		  して v:none のアイテムとなる。
+		- キーワード true、false、null、NaN、Infinity、-Infinity では
+		  大文字と小文字は区別されない。
 
 		|method| としても使用できる: >
 			ReadObject()->js_decode()
@@ -6370,12 +6372,9 @@ json_decode({string})					*json_decode()* *E491*
 		  {"1":2} と同じである。
 		- 多くの浮動小数点数を認識する。例えば "1." は "1.0" となり、
 		  "001.2" は "1.2" となる。特別な浮動小数点の値、"Infinity",
-		  "-Infinity" および "NaN" (大文字は無視される) は受け付けられ
-		  る。
+		  "-Infinity" および "NaN" は受け付けられる。
 		- 整数値の先頭に付く 0 は無視される、例えば "012" は "12" とな
 		  り、"-012" は "-12" となる。
-		- null、true および false の大文字は無視される、例えば "NULL"
-		  は "null" となり、"True" は "true" となる。
 		- 文字列中でエスケープされない U+0000 から U+001F の制御文字は
 		  受け付けられる、例えば "	" (文字列中のタブ文字) は "\t"
 		  となる。
@@ -6387,6 +6386,10 @@ json_decode({string})					*json_decode()* *E491*
 		  のような連続した 12 文字でなければならないが、json_decode()
 		  は、"\uD834" や "\uD834\u" のような途切れたサロゲートペアを
 		  黙って受け付ける。
+		- JSON 文字列におけるサロゲートペアは、"\uD834\uDD1E" のような
+		  12文字のシーケンスである。単独のサロゲート、または無効なサロ
+		  ゲートペア (例: "\uD800" または "\uD800\uD800") はエラーにな
+		  る。
 							*E938*
 		結果は Vim の有効な型でなければならないため、rfc7159 では有効
 		なオブジェクト内の重複キーは、json_decode() では受け付けられな
@@ -11418,6 +11421,29 @@ system({expr} [, {input}])				*system()* *E677*
 		シェルコマンド {expr} の実行結果を文字列 |String| として得る。
 		リスト |List| として受け取るには |systemlist()| を参照。
 
+		{expr} は |String|または |List| である。
+		{expr} が |String| の場合、コマンドはシェルを介して実行される
+		(コマンドの構築方法については下記を参照)。
+
+								*E1575*
+		{expr} が |List| の場合、最初の項目が実行可能ファイルであり、
+		残りの項目は引数として直接渡される。コマンドは |job_start()|
+		と同様に、シェルを使用せずに実行される。シェルが関与しないた
+		め、リダイレクト、パイプ、グロビング、環境変数展開、バック
+		クォート展開などのシェル機能は動作しない。">" のような文字は、
+		リダイレクトとして解釈されず、コマンドへのリテラル引数として渡
+		される。引数にシェルで解釈されるべきではない特殊文字が含まれる
+		可能性がある場合は、この形式を使用する。例: >
+		    :let out = system(['grep', '-r', 'pattern', '.'])
+<		文字列形式の場合、">" はシェルリダイレクトになるが、リストの場
+		合はリテラル引数として渡される: >
+		    :let out = system(['echo', 'hello', '>', 'world'])
+<		これは "hello > world" を出力し、ファイルへのリダイレクトは行
+		わない。
+
+		リストを明示的にシェルで使用するには: >
+		    :let out = system(['/bin/sh', '-c', 'echo $HOME'])
+<
 		{input} に文字列 |String| が指定された場合、その文字列はファイ
 		ルに書き出され、コマンドの標準入力として渡される。この文字列は
 		そのまま (as-is) 書き出されるので、正しい改行文字を使うよう自
@@ -11443,10 +11469,11 @@ system({expr} [, {input}])				*system()* *E677*
 		ある。 >
 			:silent let f = system('ls *.vim')
 <
-		Note: コマンドの引数をエスケープするには、 |shellescape()|、
-		|expand()| の |::S|、または |fnamemodify()| を使用する。{expr}
-		内に改行文字があるとコマンドは失敗するだろう。'shellquote' や
-		'shellxquote' 内にある文字も問題を起こすかもしれない。
+		Note: {expr} が文字列の場合、コマンドの引数をエスケープするに
+		は、 |shellescape()|、|expand()| の |::S|、または
+		|fnamemodify()| を使用する。{expr}内に改行文字があるとコマンド
+		は失敗するだろう。'shellquote' や'shellxquote' 内にある文字も
+		問題を起こすかもしれない。
 		対話的なコマンドを使用することはできない。
 
 		戻り値は文字列。例: >
@@ -11459,7 +11486,8 @@ system({expr} [, {input}])				*system()* *E677*
 		文字列が NUL 文字で切れるのを防ぐため、すべての NUL 文字は SOH
 		(0x01) に置換される。
 
-		実行されるコマンドはいくつかのオプションを適用して構成される:
+		{expr} は文字列の場合、実行されるコマンドはいくつかのオプショ
+		ンを適用して構成される:
 	'shell' 'shellcmdflag' 'shellxquote' {expr} 'shellredir' {tmp} 'shellxquote'
 		({tmp}は自動的に生成されるファイル名)
 		Unixではコマンドの連結ができるように{expr}の両側に波括弧が置か
@@ -11486,9 +11514,12 @@ system({expr} [, {input}])				*system()* *E677*
 
 systemlist({expr} [, {input}])				*systemlist()*
 		|system()| と同じだが行のリスト (|List|) を返す。行は NL 文字
-		で区切られ、NUL 文字は NL 文字に変換される。出力は
-		|readfile()| の {binary} 引数に "b" を指定したのと同様である。
-		ただし、結果が NL で終わる場合、余分な空の項目はない。
+		で区切られ、NUL 文字は NL 文字に変換される。
+		|system()| と同様に、{expr} は |String| (シェルを介して実行さ
+		れる) または |List| (シェルを介さずに直接実行される) のいずれ
+		かになる。詳細は |system()| を参照。
+		出力は |readfile()| の {binary} 引数に "b" を指定したのと同様
+		である。ただし、結果が NL で終わる場合、余分な空の項目はない。
 		Note MS-Windows では末尾の CR 文字がつくかもしれないことに注
 		意。
 

en/builtin.txt

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim version 9.2.  Last change: 2026 Mar 17
+*builtin.txt*	For Vim version 9.2.  Last change: 2026 Mar 25
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -699,7 +699,8 @@ synconcealed({lnum}, {col})	List	info about concealing
 synstack({lnum}, {col})		List	stack of syntax IDs at {lnum} and
 					{col}
 system({expr} [, {input}])	String	output of shell command/filter {expr}
-systemlist({expr} [, {input}])	List	output of shell command/filter {expr}
+systemlist({expr} [, {input}])
+				List	output of shell command/filter {expr}
 tabpagebuflist([{arg}])		List	list of buffer numbers in tab page
 tabpagenr([{arg}])		Number	number of current or last tab page
 tabpagewinnr({tabarg} [, {arg}])
@@ -6432,6 +6433,8 @@ js_decode({string})					*js_decode()*
 		- Strings can be in single quotes.
 		- Empty items in an array (between two commas) are allowed and
 		  result in v:none items.
+		- Capitalization is ignored in keywords: true, false, null,
+		  NaN, Infinity and -Infinity.
 
 		Can also be used as a |method|: >
 			ReadObject()->js_decode()
@@ -6470,23 +6473,20 @@ json_decode({string})					*json_decode()* *E491*
 		  same as {"1":2}.
 		- More floating point numbers are recognized, e.g. "1." for
 		  "1.0", or "001.2" for "1.2".  Special floating point values
-		  "Infinity", "-Infinity" and "NaN" (capitalization ignored)
-		  are accepted.
+		  "Infinity", "-Infinity" and "NaN" are accepted.
 		- Leading zeroes in integer numbers are ignored, e.g. "012"
 		  for "12" or "-012" for "-12".
-		- Capitalization is ignored in literal names null, true or
-		  false, e.g. "NULL" for "null", "True" for "true".
 		- Control characters U+0000 through U+001F which are not
 		  escaped in strings are accepted, e.g. "	" (tab
 		  character in string) for "\t".
 		- An empty JSON expression or made of only spaces is accepted
 		  and results in v:none.
 		- Backslash in an invalid 2-character sequence escape is
 		  ignored, e.g. "\a" is decoded as "a".
-		- A correct surrogate pair in JSON strings should normally be
-		  a 12 character sequence such as "\uD834\uDD1E", but
-		  json_decode() silently accepts truncated surrogate pairs
-		  such as "\uD834" or "\uD834\u"
+		- A surrogate pair in JSON strings is a 12 character sequence
+		  such as "\uD834\uDD1E".  A lone surrogate or an invalid
+		  surrogate pair (e.g. "\uD800" or "\uD800\uD800") results
+		  in an error.
 							*E938*
 		A duplicate key in an object, valid in rfc7159, is not
 		accepted by json_decode() as the result must be a valid Vim
@@ -11695,6 +11695,30 @@ system({expr} [, {input}])				*system()* *E677*
 		Get the output of the shell command {expr} as a |String|.  See
 		|systemlist()| to get the output as a |List|.
 
+		{expr} can be a |String| or a |List|.
+		When {expr} is a |String|, the command is executed through the
+		shell (see below for how the command is constructed).
+
+								*E1575*
+		When {expr} is a |List|, the first item is the executable and
+		the remaining items are passed as arguments directly.  The
+		command is executed without using a shell, similar to
+		|job_start()|.  Since no shell is involved, shell features
+		such as redirection, piping, globbing, environment variable
+		expansion and backtick expansion will not work.  Characters
+		like ">" are passed as literal arguments to the command, not
+		interpreted as redirection.  Use this form when arguments may
+		contain special characters that should not be interpreted by
+		the shell.  Example: >
+		    :let out = system(['grep', '-r', 'pattern', '.'])
+<		With the String form ">" would be shell redirection, but
+		with a List it is passed as a literal argument: >
+		    :let out = system(['echo', 'hello', '>', 'world'])
+<		This outputs "hello > world", not redirect to a file.
+
+		To use the shell explicitly with a List: >
+		    :let out = system(['/bin/sh', '-c', 'echo $HOME'])
+<
 		When {input} is given and is a |String| this string is written
 		to a file and passed as stdin to the command.  The string is
 		written as-is, you need to take care of using the correct line
@@ -11720,11 +11744,11 @@ system({expr} [, {input}])				*system()* *E677*
 		being echoed on the screen. >
 			:silent let f = system('ls *.vim')
 <
-		Note: Use |shellescape()| or |::S| with |expand()| or
-		|fnamemodify()| to escape special characters in a command
-		argument.  Newlines in {expr} may cause the command to fail.
-		The characters in 'shellquote' and 'shellxquote' may also
-		cause trouble.
+		Note: When {expr} is a String, use |shellescape()| or |::S|
+		with |expand()| or |fnamemodify()| to escape special
+		characters in a command argument.  Newlines in {expr} may
+		cause the command to fail.  The characters in 'shellquote'
+		and 'shellxquote' may also cause trouble.
 		This is not to be used for interactive commands.
 
 		The result is a String.  Example: >
@@ -11737,7 +11761,8 @@ system({expr} [, {input}])				*system()* *E677*
 		To avoid the string being truncated at a NUL, all NUL
 		characters are replaced with SOH (0x01).
 
-		The command executed is constructed using several options:
+		When {expr} is a String, the command executed is constructed
+		using several options:
 	'shell' 'shellcmdflag' 'shellxquote' {expr} 'shellredir' {tmp} 'shellxquote'
 		({tmp} is an automatically generated file name).
 		For Unix, braces are put around {expr} to allow for
@@ -11764,6 +11789,9 @@ system({expr} [, {input}])				*system()* *E677*
 systemlist({expr} [, {input}])				*systemlist()*
 		Same as |system()|, but returns a |List| with lines (parts of
 		output separated by NL) with NULs transformed into NLs.
+		Like |system()|, {expr} can be a |String| (executed through
+		the shell) or a |List| (executed directly without a shell).
+		See |system()| for details.
 		Output is the same as |readfile()| will output with {binary}
 		argument set to "b", except that there is no extra empty item
 		when the result ends in a NL.