Update by original

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 01
+*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 02
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -4787,7 +4787,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	このオプションは、様々な対象に対する強調表示モードを設定する。文字の組
 	をコンマ区切りのリストとして指定する。1番目の文字は適用される対象を指
 	定し、2番目の文字はその対象に適用するモードを指定する。
-	対象は以下の通りである。
+	対象は以下の通りである:
 	|hl-SpecialKey|	 8  ":map" でリスト表示されるメタキーと特殊キー
 	|hl-EndOfBuffer|   ~  バッファの最後の行以降の行
 	|hl-NonText|	 @  ウィンドウ末尾の '@' と 'showbreak' によって
@@ -4851,6 +4851,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	|hl-PmenuShadow|   H  ポップアップメニューの影
 	|hl-PreInsert|	 I  "preinsert" が 'completeopt' にあるときに挿入され
 			    るテキスト
+	|hl-Normal|	 (  ウィンドウカラー ('wincolor' オプションより優先さ
+			    れる)
+
+	Note デフォルトでは、対象 '(' は設定されていないことに注意。
 
 	表示モードは以下の通りである。
 		r	反転		(termcapの項目 "mr" と "me")
@@ -5870,9 +5874,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 			された場合は、先頭のタブには "tab" 設定が使用される。
 									*E1572*
 			これを機能させるには |lcs-tab| も設定する必要がある。
-			"tab:" と組み合わせることもできる。例:
-			`:set listchars=tab:>-,leadtab:.\ `
-			先頭のタブはピリオド (.) で表示され、その他のタブは
+			"tab:" と組み合わせることもできる。例: >
+				:set listchars=tab:>-,leadtab:.\ 
+<			先頭のタブはピリオド (.) で表示され、その他のタブは
 			">--" で表示される。
 							*lcs-trail*
 	  trail:文字	行末のスペースの表示に使われる文字。指定されないと、行
@@ -10263,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)
@@ -10325,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)
 			グローバル

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.2.  Last change: 2026 Mar 01
+*options.txt*	For Vim version 9.2.  Last change: 2026 Mar 02
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -4810,6 +4810,9 @@ A jump table for the options with a short description can be found at |Q_op|.
 	|hl-PmenuBorder|   j  popup menu border characters
 	|hl-PmenuShadow|   H  popup menu shadow
 	|hl-PreInsert|	 I  text inserted when "preinsert" is in 'completeopt'
+	|hl-Normal|	 (  Window color (supersedes 'wincolor' option)
+
+	Note that the "(" occasion is not set by default.
 
 	The display modes are:
 		r	reverse		(termcap entry "mr" and "me")
@@ -5813,9 +5816,9 @@ A jump table for the options with a short description can be found at |Q_op|.
 			Like |lcs-tab|, but only for leading tabs.  When
 			omitted, the "tab" setting is used for leading tabs.
 			|lcs-tab| must also be set for this to work. *E1572*
-			You can combine it with "tab:", for example:
-			`:set listchars=tab:>-,leadtab:.\ `
-			This shows leading tabs as periods(.) and other tabs
+			You can combine it with "tab:", for example: >
+				:set listchars=tab:>-,leadtab:.\ 
+<			This shows leading tabs as periods(.) and other tabs
 			as ">--".
 							*lcs-trail*
 	  trail:c	Character to show for trailing spaces.  When omitted,
@@ -10246,8 +10249,19 @@ A jump table for the options with a short description can be found at |Q_op|.
 						*'wincolor'* *'wcr'*
 'wincolor' 'wcr' string (default empty)
 			local to window
+	DEPRECATED: Use 'winhighlight' if possible, this option uses
+	'winhighlight' internally by setting it to: >vim
+	    set winhighlight=!(:HighlightGroup
+<	If this option is set and 'winhighlight' is changed, then it will not
+	update the option value.  For example, if 'wincolor' is set to "A" and
+	then 'winhighlight' is to an empty value, then 'wincolor' will still
+	remain as "A".  Additionally, the existing value in 'winhighlight' will
+	be discarded when this option is set.
+
 	Highlight group name to use for this window instead of the Normal
-	color |hl-Normal|.
+	color |hl-Normal|.  For other |highlight-groups|, see 'winhighlight'.
+	Note that it is not recommended to set this and 'winhighlight' at the
+	same time.
 
 						*'window'* *'wi'*
 'window' 'wi'		number  (default screen height - 1)
@@ -10306,6 +10320,35 @@ A jump table for the options with a short description can be found at |Q_op|.
 	'winheight' applies to the current window.  Use 'winminheight' to set
 	the minimal height for other windows.
 
+						*'winhighlight'* *'whl'*
+'winhighlight' 'whl'	string (default empty)
+			local to window
+	Window-local highlight group mappings.  Comma-delimited list of
+	highlight |group-name| pairs "{hl-from}:{hl-to},..." where each
+	{hl-from} is a |highlight-groups| item to be overridden by {hl-to}
+	group in the window.  If {hl-from} is "Normal", then it will always
+	map to the "(" (window color) value in 'highlight'.
+
+	If a highlight group name starts with "!", then it is assumed to map
+	to a value in 'highlight'.  For example, this will override the
+	visual mode setting: >vim
+	    set winhighlight=!v:SomeHighlightGroup
+<	This will map the occasion "v" to occasion "l" >vim
+	    set winhighlight=!v:!l
+<
+	Highlights of vertical separators are determined by the window to the
+	left of the separator.  The 'tabline' highlight of a tabpage is
+	decided by the last-focused window of the tabpage.  Highlights of
+	the popupmenu are determined by the current window.  Highlights in the
+	message area cannot be overridden.
+
+	When handling highlight group links, if a highlight group (which may
+	be a link as well) is overridden by 'winhighlight', then all highlight
+	groups that link to it will be affected.  For example, if highlight
+	group C links to B which links to A, then >vim
+	    set winhighlight=B:SomeHighlightGroup
+<	will make SomeHighlightGroup override groups B and C, but not A.
+
 						*'winminheight'* *'wmh'*
 'winminheight' 'wmh'	number	(default 1)
 			global