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

Update options.{txt,jax}

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.1.  Last change: 2025 Jul 13
+*options.txt*	For Vim バージョン 9.1.  Last change: 2025 Jul 21
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -3009,6 +3009,25 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	カレントウィンドウをファイル間の差異を示すウィンドウのグループに組み入
 	れる。|vimdiff| を参照。
 
+					    *'dia'* *'diffanchors'* *E1549*
+'diffanchors' 'dia'	文字列 (既定では "")
+			グローバル／バッファについてローカル |global-local|
+	各バッファ内の {address} をコンマ区切りでリストする。これらは比較の際
+	にアンカーとして扱われる。最終行の 1 つ先を指定する際に "$+1" と記述す
+	ることは有効である。このオプションでは "%" は使用できない。各バッファ
+	には最大 20 個のアンカーを設定できる。
+
+	各アンカー行はバッファを分割する (分割はアンカー行の上で行われる)。各
+	部分は個別に比較され、最終結果が結合される。複数の {address} が指定さ
+	れた場合、アンカーは行番号で内部的にソートされる。バッファローカルなオ
+	プションを使用する場合、各バッファには同じ数のアンカーが必要である (余
+	分なアンカーは無視される)。このオプションは、'diffopt' に "anchor" が
+	設定されている場合にのみ使用される。詳細と例については |diff-anchors|
+	を参照。
+								*E1550*
+	{address} の一部が各バッファ内の行に解決されない場合 (例えば、何にも
+	マッチしないパターン検索)、どのアンカーも使用されない。
+
 						*'dex'* *'diffexpr'*
 'diffexpr' 'dex'	文字列 (既定では "")
 			グローバル
@@ -3034,6 +3053,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 				patience   patience 差分アルゴリズム
 				histogram  histogram 差分アルゴリズム
 
+		anchor		'diffanchors' が設定されている場合、各バッファ
+				内の特定の行を互いに揃えてアンカーする。
+				|diff-anchors| を参照。
+
 		closeoff	'diff' が設定されたウィンドウが閉じられ、同じ
 				タブページに 'diff' が設定されたウィンドウが
 				1 つだけ残っているとき、そのウィンドウで
@@ -3132,6 +3155,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 				"linematch:60" である。これによりそれぞれ 30
 				行の 2 バッファ差分ハンク、またはそれぞれ 20
 				行の 3 バッファ差分ハンクの揃えが可能になる。
+				これを設定すると、暗黙的に "filler" が設定され
+				る。
 
 		vertical	(他に明示的に指定されない限り)ウィンドウを垂直
 				分割して差分モードを開始する。
@@ -7505,6 +7530,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	うに '\' を置くことを忘れないこと。
 	将来はフィルタ処理にはパイプが使われるようになり、このオプションは時代
 	遅れになるだろう (少なくともUnixでは)。
+	Note: "| tee" のようなパイプを使用すると、シェルコマンドの終了コードが
+	失われる。これはシェルによって設定できる場合があるので、pipefail オプ
+	ションを探して欲しい (bash と zsh の場合は ":set -o pipefail" を使用す
+	る)。
 	セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
 	内で設定することはできない。
 
@@ -9795,7 +9824,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 <	'wildchar' は、|/|、|?|、|:s|、|:g|、|:v|、|:vim| などの検索パターンコ
 	ンテキストでも補完を有効にする。補完をトリガーする代わりに、文字の
 	<Tab> を挿入するには、<C-V><Tab> または "\t" と入力する。
-	|'wildoptions'| も参照。
+	|'wildoptions'| および |wildtrigger()| も参照。
 	NOTE: このオプションは 'compatible' がオンになると Vi の既定値に設定さ
 	れ、'compatible' がオフになると Vim の既定値に設定されるので注意。
 

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.1.  Last change: 2025 Jul 13
+*options.txt*	For Vim version 9.1.  Last change: 2025 Jul 21
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -2986,6 +2986,27 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Join the current window in the group of windows that shows differences
 	between files.  See |vimdiff|.
 
+					    *'dia'* *'diffanchors'* *E1549*
+'diffanchors' 'dia'	string	(default "")
+			global or local to buffer |global-local|
+	List of {address} in each buffer, separated by commas, that are
+	considered anchors when used for diffing.  It's valid to specify "$+1"
+	for 1 past the last line.  "%" cannot be used for this option.  There
+	can be at most 20 anchors set for each buffer.
+
+	Each anchor line splits the buffer (the split happens above the
+	anchor), with each part being diff'ed separately before the final
+	result is joined.  When more than one {address} are provided, the
+	anchors will be sorted interally by line number.  If using buffer
+	local options, each buffer should have the same number of anchors
+	(extra anchors will be ignored).  This option is only used when
+	'diffopt' has "anchor" set.  See |diff-anchors| for more details and
+	examples.
+								*E1550*
+	If some of the {address} do not resolve to a line in each buffer (e.g.
+	a pattern search that does not match anything), none of the anchors
+	will be used.
+
 						*'dex'* *'diffexpr'*
 'diffexpr' 'dex'	string	(default "")
 			global
@@ -3014,6 +3035,10 @@ A jump table for the options with a short description can be found at |Q_op|.
 				patience   patience diff algorithm
 				histogram  histogram diff algorithm
 
+		anchor		Anchor specific lines in each buffer to be
+				aligned with each other if 'diffanchors' is
+				set.  See |diff-anchors|.
+
 		closeoff	When a window is closed where 'diff' is set
 				and there is only one window remaining in the
 				same tab page with 'diff' set, execute
@@ -3116,6 +3141,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 				"linematch:60", as this will enable alignment
 				for a 2 buffer diff hunk of 30 lines each,
 				or a 3 buffer diff hunk of 20 lines each.
+				Implicitly sets "filler" when this is set.
 
 		vertical	Start diff mode with vertical splits (unless
 				explicitly specified otherwise).
@@ -7477,6 +7503,9 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Don't forget to precede the space with a backslash: ":set sp=\ ".
 	In the future pipes may be used for filtering and this option will
 	become obsolete (at least for Unix).
+	Note: When using a pipe like "| tee", you'll lose the exit code of the
+	shell command.  This might be configurable by your shell, look for
+	the pipefail option (for bash and zsh, use ":set -o pipefail").
 	This option cannot be set from a |modeline| or in the |sandbox|, for
 	security reasons.
 
@@ -9768,7 +9797,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 <	'wildchar' also enables completion in search pattern contexts such as
 	|/|, |?|, |:s|, |:g|, |:v|, and |:vim|.  To insert a literal <Tab>
 	instead of triggering completion, type <C-V><Tab> or "\t".
-	See also |'wildoptions'|.
+	See also 'wildoptions' and |wildtrigger()|.
 	NOTE: This option is set to the Vi default value when 'compatible' is
 	set and to the Vim default value when 'compatible' is reset.