Merge pull request #2517 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 Feb 17
+*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 02
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -2308,14 +2308,16 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	   fuzzy    補完候補に対して |fuzzy-matching| を有効にする。これによ
 		    り、より柔軟で直感的なマッチングが可能になり、文字をスキッ
 		    プしたり、正確なシーケンスが入力されていなくてもマッチを見
-		    つけることができる。
+		    つけることができる (シソーラス補完 |compl-thesaurus| では
+		    無効)。
 
 	   longest
 		    'autocomplete' が無効の場合、マッチした単語の最長共通プリ
-		    フィックスのみが挿入される。ポップアップメニューが表示され
-		    ている場合は、CTRL-L で文字を追加できる。大文字小文字が無
-		    視されるかどうかは、補完の種類によって異なる。バッファ内の
-		    テキストには、'ignorecase' オプションが適用される。
+		    フィックスのみが挿入される (シソーラス補完
+		    |compl-thesaurus| では無効)。ポップアップメニューが表示さ
+		    れている場合は、CTRL-L で文字を追加できる。大文字小文字が
+		    無視されるかどうかは、補完の種類によって異なる。バッファ内
+		    のテキストには、'ignorecase' オプションが適用される。
 
 		    'autocomplete' が有効で、補完項目が選択されていない場合、
 		    マッチした候補の中の最長共通プリフィックスがカーソルの後ろ
@@ -3618,6 +3620,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 		|RemoteReply|,
 		|SafeState|,
 		|SafeStateAgain|,
+		|SessionLoadPre|,
 		|SessionLoadPost|,
 		|SessionWritePost|,
 		|ShellCmdPost|,
@@ -4784,7 +4787,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	このオプションは、様々な対象に対する強調表示モードを設定する。文字の組
 	をコンマ区切りのリストとして指定する。1番目の文字は適用される対象を指
 	定し、2番目の文字はその対象に適用するモードを指定する。
-	対象は以下の通りである。
+	対象は以下の通りである:
 	|hl-SpecialKey|	 8  ":map" でリスト表示されるメタキーと特殊キー
 	|hl-EndOfBuffer|   ~  バッファの最後の行以降の行
 	|hl-NonText|	 @  ウィンドウ末尾の '@' と 'showbreak' によって
@@ -4848,6 +4851,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	|hl-PmenuShadow|   H  ポップアップメニューの影
 	|hl-PreInsert|	 I  "preinsert" が 'completeopt' にあるときに挿入され
 			    るテキスト
+	|hl-Normal|	 (  ウィンドウカラー ('wincolor' オプションより優先さ
+			    れる)
+
+	Note デフォルトでは、対象 '(' は設定されていないことに注意。
 
 	表示モードは以下の通りである。
 		r	反転		(termcapの項目 "mr" と "me")
@@ -5861,6 +5868,16 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 				---+---+--XXX ~
 			ここで "XXX" はこの行の最初の空白ではない文字を意味す
 			る。
+							*lcs-leadtab*
+	  leadtab:xy[z]
+			|lcs-tab| と同様だが、先頭のタブにのみ適用される。省略
+			された場合は、先頭のタブには "tab" 設定が使用される。
+									*E1572*
+			これを機能させるには |lcs-tab| も設定する必要がある。
+			"tab:" と組み合わせることもできる。例: >
+				:set listchars=tab:>-,leadtab:.\ 
+<			先頭のタブはピリオド (.) で表示され、その他のタブは
+			">--" で表示される。
 							*lcs-trail*
 	  trail:文字	行末のスペースの表示に使われる文字。指定されないと、行
 			末のスペースは空白のまま。行末のスペースでは "space"
@@ -8536,6 +8553,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	      いは非カレントウィンドウのステータス行にはハイライトグループ
 	      StatusLineNC が適用されることである。数 N は 1 以上 9 以下であ
 	      る。|hl-User1..9| を参照。
+								*stl-%@*
+	@ -   改行を挿入する (|tabpanel| の場合、またはステータスライン
+	      'statuslineopt' の "maxheight" 値が 1 より大きい場合)。
 
 	フラグを表示するとき、そのフラグがプレーンテキストの直後にあるな
 	ら、その先頭にコンマがある場合は削除される。そうすることによって以下の
@@ -8597,6 +8617,33 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	  :function VarExists(var, val)
 	  :    if exists(a:var) | return a:val | else | return '' | endif
 	  :endfunction
+<
+						*'statuslineopt'* *'stlo'*
+'statuslineopt' 'stlo'	文字列	(既定では "")
+			グローバル
+			{|+statusline| 機能付きでコンパイルされたときのみ有効}
+	|status-line| のオプション設定。以下の項目から構成される。すべて任意で
+	ある。項目はコンマで区切る必要がある。
+
+		maxheight:{n}	ステータスラインの最大の高さを {n} に設定する。
+				{n} は 1 以上である必要がある。
+				指定がない場合は 1 が使用される。
+				{n} がすべてのタブページのすべてのウィンドウに
+				適用可能かどうかを確認し、適用できない場合は、
+				可能な限り最も近い値に設定する。
+				オプションの値は実際に適用された値に更新され
+				る。例えば、maxheight:999 と設定した場合、利用
+				可能なスペースによっては値が小さくなる可能性が
+				ある。
+				{n} を 2 以上に設定すると、'statusline' で "@"
+				を使用して、ステータスラインに複数行の情報を表
+				示できる。
+				|stl-%@| を参照。
+
+	例: >
+		:set stlo=
+		:set stlo=maxheight:2
+		:set stlo+=maxheight:3
 <
 						*'suffixes'* *'su'*
 'suffixes' 'su'		文字列	(既定では ".bak,~,.o,.h,.info,.swp,.obj")
@@ -8786,12 +8833,12 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	ない。
 
 	|g:actual_curtabpage| は、タブパネルに割り当てられた関数内で使用でき
-	る。|g:actual_curtabpage| はカレントタブページのラベル番号を表す。オプ
-	ション値には、改行を強制するために "\n" を含めることができる: >
+	る。|g:actual_curtabpage| はカレントタブページのラベル番号を表す。
+	新しい行を挿入するには、"%@" または "\n" を使用できる: >
 
 		set tabpanel=%!TabPanel()
 		function! TabPanel() abort
-		  return printf("(%2d)\n  %%f", g:actual_curtabpage)
+		  return "(" .. g:actual_curtabpage .. ")%@  %f"
 		endfunction
 <
 	結果は以下の通り:
@@ -8805,8 +8852,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	|           |
 	|           |
 <
-	Note: "\n" の使用は実験的なものと見なされており、将来変更される可能性
-	がある。代わりに %-アトムが使用されるかもしれない。
+	Note: "\n" の使用は実験的であり非推奨である。代わりに |stl-%@| アトム
+	を使用すること。
 
 					*'tabpanelopt'* *'tplo'*
 'tabpanelopt' 'tplo'	文字列	(既定では "")
@@ -9146,9 +9193,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 
 	|ConPTY| のサポートはプラットフォーム次第である。Windows 10 October
 	2018 Update は、ConPTYをサポートする最初のバージョンだが、それでもまだ
-	不安定と考えられている。Windows 10 の次のリリースでは、ConPTY が安定す
-	る可能性がある。winpty のサポートはインストールする必要がある。どちら
-	もサポートされていない場合は、端末ウィンドウを開くことはできない。
+	不安定と考えられている。ConPTY は Windows 11 の初期リリースで安定した。
+	winpty のサポートはインストールする必要がある。どちらもサポートされて
+	いない場合は、端末ウィンドウを開くことはできない。
 
 						*'terse'* *'noterse'*
 'terse'			切替	(既定ではオフ)
@@ -10220,8 +10267,20 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 						*'wincolor'* *'wcr'*
 'wincolor' 'wcr'	文字列 (既定では "")
 			ウィンドウについてローカル
+	DEPRECATED: 可能であれば 'winhighlight' を使用すること。このオプション
+	は、以下のように設定することで内部的に 'winhighlight' を使用する: >vim
+	    set winhighlight=!(:HighlightGroup
+<	このオプションが設定されている場合、'winhighlight' の値が変更されても、
+	オプションの値は更新されない。例えば、'wincolor' が "A" に設定され、
+	'winhighlight' が空の値に設定された場合、'wincolor' は "A" のままとな
+	る。また、このオプションが設定されると、'winhighlight' の既存の値は破
+	棄される。
+
 	通常の色 |hl-Normal| の代わりにこのウィンドウに使用するハイライトグルー
 	プ名。
+	その他のハイライトグループについては、'winhighlight' を参照。Note この
+	グループと 'winhighlight' を同時に設定することは推奨されていないことに
+	注意。
 
 						*'window'* *'wi'*
 'window' 'wi'		数値  (既定では: 画面の高さ - 1)
@@ -10282,6 +10341,36 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	'winheight' はカレントウィンドウに適用される。他のウィンドウの高さの最
 	小値の設定には、'winminheight' を使うこと。
 
+						*'winhighlight'* *'whl'*
+'winhighlight' 'whl'	文字列 (既定では空)
+			ウィンドウについてローカル
+	ウィンドウローカルのハイライトグループマッピング。ハイライト
+	|group-name| ペアのコンマ区切りのリスト "{hl-from}:{hl-to},..." で、各
+	{hl-from} はウィンドウ内の {hl-to} グループによって上書きされる
+	|highlight-groups| 項目である。{hl-from} が "Normal" の場合、常に
+	'highlight' の "(" (ウィンドウカラー) の値にマッピングされる。
+
+	ハイライトグループ名が "!" で始まる場合、それは 'highlight' の値にマッ
+	ピングされているとみなされる。例えば、以下の設定はビジュアルモードの設
+	定を上書きする: >vim
+	    set winhighlight=!v:SomeHighlightGroup
+<	これは、対象 "v" を対象 "l" にマッピングする >vim
+	    set winhighlight=!v:!l
+<
+	垂直セパレーターのハイライトは、セパレータの左側のウィンドウによって決
+	定される。タブページの 'tabline' のハイライトは、タブページで最後に
+	フォーカスされていたウィンドウによって決定される。ポップアップメニュー
+	のハイライトは、カレントウィンドウによって決定される。メッセージ領域の
+	ハイライトは上書きできない。
+
+	ハイライトグループのリンクを扱う際、ハイライトグループ (リンクである場
+	合もある) が 'winhighlight' によって上書きされると、それにリンクしてい
+	るすべてのハイライトグループが影響を受ける。例えば、ハイライトグループ
+	C が B にリンクし、B が A にリンクしている場合 >vim
+	    set winhighlight=B:SomeHighlightGroup
+<	SomeHighlightGroup はグループ B と C をオーバーライドするが、グループ
+	A はオーバーライドしない。
+
 						*'winminheight'* *'wmh'*
 'winminheight' 'wmh'	数値	(既定では 1)
 			グローバル