Merge pull request #2549 from h-east/update-options

Update options.{txt,jax}

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 16
+*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 23
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -119,13 +119,26 @@ Vimには、特別な働きをさせるための多くの内部変数とスイ
 			オプションがフラグのリストであるときは、冗長なフラグは
 			取り除かれる。すでに入っているフラグを加えようとしたと
 			きは、そのオプションの値は変わらない。
+			オプションが "key:value" 項目をサポートしており、
+			{value} に "key:value" 項目またはコンマ区切りの複数の
+			項目が含まれている場合、各項目は個別に処理される:
+			- キーが異なる値で既に存在する "key:value" の項目: 古
+			  い項目は削除され、新しい項目が末尾に追加される。
+			- 完全に重複する "key:value" の項目は変更されない。
+			- 既に存在するその他の項目は変更されない。
+			- 新しい項目は末尾に追加される。
 			上の |:set-args| も参照。
 
 :se[t] {option}^={value}				*:set^=*
-			数値オプションに対してはその値を {value} 倍する。文字
-			列オプションに対しては前に {value} を追加する。オプショ
-			ンがコンマ区切りのリストのときは、{value} と元の値の間
-			にコンマが付け加えられる。
+			数値オプションの場合は値を {value} 倍し、文字列オプショ
+			ンの場合は {value} を先頭に追加する。オプションがコン
+			マ区切りのリストの場合は、値が空でない限りコンマが追加
+			される。
+			オプションが "key:value" 項目をサポートしており、
+			{value} に "key:value" 項目またはコンマ区切りの複数の
+			項目が含まれている場合、各項目は個別に処理される。
+			|:set+=| と同様の動作だが、新しい項目は末尾に追加され
+			るのではなく、先頭に追加される。
 			上の |:set-args| も参照。
 
 :se[t] {option}-={value}				*:set-=*
@@ -140,6 +153,12 @@ Vimには、特別な働きをさせるための多くの内部変数とスイ
 			中に現れるままに、正確に指定しなければならない。問題が
 			起こるのを避けるために、フラグを取り除くときは1個ずつ
 			指定すること。
+			オプションが "key:value" 項目をサポートしており、
+			{value} に "key:value" 項目またはこコンマ区切りの複数
+			の項目が含まれている場合、各項目は個別に処理され
+			る。"key:value" 項目は、値に関係なく、そのキーを持つ既
+			存の項目を削除する。"key:" 項目も、キーの一致に基づい
+			て削除する。
 			コンマで区切られたリストやフラグのリストにある個々の値
 			は、'wildchar' をタイプすることで挿入できる。
 			|complete-set-option| を参照のこと。
@@ -6059,7 +6078,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	この制限を200より大きな値に増やした場合、Exコマンドの再帰の最大値も変
 	更される。|E169| 参照。
 	|:function| も参照。
-	コールバック関数の呼び出しの深さの最大値にも用いられる。
+	また、コールバック関数の呼び出しの深さの最大値や、深くネストされた
+	JSON データのエンコードおよびデコードにも使用される。
 
 						*'maxmapdepth'* *'mmd'* *E223*
 'maxmapdepth' 'mmd'	数値	(既定では 1000)

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.2.  Last change: 2026 Mar 16
+*options.txt*	For Vim version 9.2.  Last change: 2026 Mar 23
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -97,13 +97,29 @@ achieve special effects.  These options come in three forms:
 			If the option is a list of flags, superfluous flags
 			are removed.  When adding a flag that was already
 			present the option value doesn't change.
+			When the option supports "key:value" items and {value}
+			contains a "key:value" item or multiple
+			comma-separated items, each item is processed
+			individually:
+			- A "key:value" item where the key already exists with
+			  a different value: the old item is removed and the
+			  new item is appended to the end.
+			- A "key:value" item that is an exact duplicate is
+			  left unchanged.
+			- Other items that already exist are left unchanged.
+			- New items are appended to the end.
 			Also see |:set-args| above.
 
 :se[t] {option}^={value}				*:set^=*
 			Multiply the {value} to a number option, or prepend
 			the {value} to a string option.  When the option is a
 			comma-separated list, a comma is added, unless the
 			value was empty.
+			When the option supports "key:value" items and {value}
+			contains a "key:value" item or multiple
+			comma-separated items, each item is processed
+			individually.  Works like |:set+=| but new items are
+			prepended to the beginning instead of appended.
 			Also see |:set-args| above.
 
 :se[t] {option}-={value}				*:set-=*
@@ -116,6 +132,12 @@ achieve special effects.  These options come in three forms:
 			When the option is a list of flags, {value} must be
 			exactly as they appear in the option.  Remove flags
 			one by one to avoid problems.
+			When the option supports "key:value" items and {value}
+			contains a "key:value" item or multiple
+			comma-separated items, each item is processed
+			individually.  A "key:value" item removes the existing
+			item with that key regardless of its value.  A "key:"
+			item also removes by key match.
 			The individual values from a comma separated list or
 			list of flags can be inserted by typing 'wildchar'.
 			See |complete-set-option|.
@@ -6004,7 +6026,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Increasing this limit above 200 also changes the maximum for Ex
 	command recursion, see |E169|.
 	See also |:function|.
-	Also used for maximum depth of callback functions.
+	Also used for maximum depth of callback functions and encoding and
+	decoding of deeply nested json data.
 
 						*'maxmapdepth'* *'mmd'* *E223*
 'maxmapdepth' 'mmd'	number	(default 1000)