Merge pull request #2530 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 02
+*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 12
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -8554,8 +8554,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	      StatusLineNC が適用されることである。数 N は 1 以上 9 以下であ
 	      る。|hl-User1..9| を参照。
 								*stl-%@*
-	@ -   改行を挿入する (|tabpanel| の場合、またはステータスライン
-	      'statuslineopt' の "maxheight" 値が 1 より大きい場合)。
+	@ -   改行を挿入する。これは、'statuslineopt' の "maxheight" 値が 1 よ
+	      り大きい場合、または |tabpanel| の場合にのみ有効である。
 
 	フラグを表示するとき、そのフラグがプレーンテキストの直後にあるな
 	ら、その先頭にコンマがある場合は削除される。そうすることによって以下の
@@ -8620,30 +8620,46 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 <
 						*'statuslineopt'* *'stlo'*
 'statuslineopt' 'stlo'	文字列	(既定では "")
-			グローバル
+			グローバル／ウィンドウについてローカル |global-local|
 			{|+statusline| 機能付きでコンパイルされたときのみ有効}
 	|status-line| のオプション設定。以下の項目から構成される。すべて任意で
 	ある。項目はコンマで区切る必要がある。
 
-		maxheight:{n}	ステータスラインの最大の高さを {n} に設定する。
-				{n} は 1 以上である必要がある。
-				指定がない場合は 1 が使用される。
-				{n} がすべてのタブページのすべてのウィンドウに
-				適用可能かどうかを確認し、適用できない場合は、
-				可能な限り最も近い値に設定する。
-				オプションの値は実際に適用された値に更新され
-				る。例えば、maxheight:999 と設定した場合、利用
-				可能なスペースによっては値が小さくなる可能性が
-				ある。
-				{n} を 2 以上に設定すると、'statusline' で "@"
-				を使用して、ステータスラインに複数行の情報を表
-				示できる。
-				|stl-%@| を参照。
-
+	    fixedheight     ステータスラインの高さを "maxheight" に固定する。
+			    これがない場合、高さは 'statusline' 内の改行文字
+			    |stl-%@| の数に基づいて 1 から "maxheight" まで変
+			    化する。
+
+	    maxheight:{n}   ステータスラインの最大の高さを {n} に設定する。
+			    {n} は 1 以上である必要がある。指定されていない場
+			    合、高さは 1 になる。
+			    {n} が 2 以上の場合、'statusline' で改行 |stl-%@|
+			    を使用して、複数行に情報を表示できる。
+
+			    ウィンドウの高さが十分でないなどの制約により {n}
+			    を設定できない場合は、{n} を超えない範囲で可能な限
+			    り近い値を設定するようベストエフォート方式で処理さ
+			    れる。設定を変更できない場合でもエラーは表示されな
+			    い。
+
+			    グローバル値には、すべてのタブページのすべてのウィ
+			    ンドウに適用可能な値が使用される。ウィンドウローカ
+			    ル値には、そのウィンドウに適用される値が使用され
+			    る。
+			    Note: 適用された値が {n} と異なる場合、オプション
+			    はそれを反映して更新される。
+			    更新されたオプションの例: >vim
+				:set statuslineopt=maxheight:999,fixedheight
+				" 適用できるのは 20 行までだったため、
+				" maxheight は 20 に更新された。
+				:set statuslineopt?
+				  statuslineopt=maxheight:20,fixedheight
+<
 	例: >
+		:set statuslineopt=fixedheight
 		:set stlo=
-		:set stlo=maxheight:2
-		:set stlo+=maxheight:3
+		:set stlo=maxheight:2,fixedheight
+		:set stlo-=fixedheight
 <
 						*'suffixes'* *'su'*
 'suffixes' 'su'		文字列	(既定では ".bak,~,.o,.h,.info,.swp,.obj")
@@ -8834,7 +8850,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 
 	|g:actual_curtabpage| は、タブパネルに割り当てられた関数内で使用でき
 	る。|g:actual_curtabpage| はカレントタブページのラベル番号を表す。
-	新しい行を挿入するには、"%@" または "\n" を使用できる: >
+	改行を挿入するには、"%@" または "\n" を使用できる: >
 
 		set tabpanel=%!TabPanel()
 		function! TabPanel() abort
@@ -9126,6 +9142,43 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 <
 	NOTE: このオプションは、'compatible' がオンになるとオフになるので注意。
 
+						*'termresize'* *'trz'*
+'termresize' 'trz'	文字列	(既定では "")
+			グローバル
+			{Vim の Unix 版でのみ使用可能、GUI では動作しない}
+	ウィンドウのサイズ変更イベントを検出するために使用する方法を決定する。
+	可能な値は以下のとおりである:
+	    "sigwinch":	    SIGWINCH シグナルを使用する。
+	    "inband":	    エスケープシーケンスを介して端末からサイズ変更イベ
+			    ントを受信する (端末でサポートされている場合は推奨
+			    される)。
+	    "":		    端末に応じて自動的に選択する。
+
+	SIGWINCH ハンドラは常に使用可能である。"inband" に設定され、端末がイン
+	バンドウィンドウサイズ変更イベントをサポートしていない場合は、フォール
+	バックとして SIGWINCH ハンドラが使用される。"" (空オプション) に設定さ
+	れている場合、Vim が端末がサポートしていることを検出した場合は
+	"inband" が使用され、そうでない場合は "sigwinch" が使用される。
+
+
+						*'termsync'* *'tsy'*
+'termsync' 'tsy'	切替	(既定ではオフ)
+			グローバル
+	ホスト端末がサポートしている場合、再描画サイクル中に行われるすべての画
+	面更新をバッファリングし、各画面が端末に一度に表示されるようにする。こ
+	れにより、端末の更新速度が Vim の再描画速度よりも速い場合に、ティアリ
+	ングやちらつきを防ぐことができる。ホスト端末がサポートしていない場合、
+	または Vim がグラフィカルモードで動作している場合、このオプションは何
+	も行わない。
+
+	仕様は以下の場所にある:
+	https://github.com/contour-terminal/vt-extensions/blob/master/synchronized-output.md
+
+	Vim が |+termresponse| 機能付きでコンパイルされている場合、Vim は起動
+	時に端末に DEC モード 2026 のサポートを問い合わせることで、このオプショ
+	ンを自動的に設定することがある。使用される端末コードは |t_BS| と |t_ES|
+	である。
+
 						*'termwinkey'* *'twk'*
 'termwinkey' 'twk'	文字列	(既定では "")
 			ウィンドウについてローカル

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.2.  Last change: 2026 Mar 02
+*options.txt*	For Vim version 9.2.  Last change: 2026 Mar 12
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -8532,8 +8532,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 	      windows.
 	      The number N must be between 1 and 9.  See |hl-User1..9|
 								*stl-%@*
-	@ -   Insert a line break (for the |tabpanel| or when the status line
-	      'statuslineopt' has a "maxheight" value greater than 1).
+	@ -   Inserts a newline.  This only takes effect when the "maxheight"
+	      value of 'statuslineopt' is greater than 1, or for |tabpanel|.
 
 	When displaying a flag, Vim removes the leading comma, if any, when
 	that flag comes right after plaintext.  This will make a nice display
@@ -8594,31 +8594,48 @@ A jump table for the options with a short description can be found at |Q_op|.
 <
 						*'statuslineopt'* *'stlo'*
 'statuslineopt' 'stlo'	string	(default "")
-			global
+			global or local to window |global-local|
 			{not available when compiled without the |+statusline|
 			feature}
 	Optional settings for |status-line|.  It can consist of the following
 	items.  All are optional.  Items must be separated by a comma.
 
-		maxheight:{n}	Set the maximum status line height to {n}.
-				{n} must be 1 or greater.
-				If not present, 1 is used.
-				Check whether {n} is applicable to all windows
-				on all tab pages, and if not, set it to the
-				closest possible value.
-				The option value is updated to the actual
-				applied value.  For example, setting
-				maxheight:999 may result in a smaller value
-				depending on the available space.
-				When {n} is set to 2 or more, you can use "@"
-				in 'statusline' to display information on
-				multiple lines in the status line.
-				See |stl-%@|.
-
+	    fixedheight     Fix the status line height to "maxheight".
+			    Without this, the height varies from 1 to
+			    "maxheight" based on the number of newline
+			    |stl-%@| in 'statusline'.
+
+	    maxheight:{n}   Set the maximum status line height to {n}.
+			    {n} must be 1 or greater.  If not specified, the
+			    height is 1.
+			    When {n} is 2 or more, you can use newline
+			    |stl-%@| in 'statusline' to display information on
+			    multiple lines.
+
+			    If {n} cannot be set due to insufficient window
+			    height or other constraints, a best-effort
+			    approach will be taken to set the closest possible
+			    value that does not exceed {n}.  No error will be
+			    shown even if the setting cannot be changed.
+
+			    For the global value, a value applicable to all
+			    windows on all tab pages is used.  For a
+			    window-local value, a value applicable to that
+			    window is used.
+			    Note: When the applied value differs from {n}, the
+			    option is updated to reflect it.
+			    Example of updated options: >vim
+				:set statuslineopt=maxheight:999,fixedheight
+				" Only 20 lines could be applied, so
+				" maxheight is updated to 20.
+				:set statuslineopt?
+				  statuslineopt=maxheight:20,fixedheight
+<
 	Examples: >
+		:set statuslineopt=fixedheight
 		:set stlo=
-		:set stlo=maxheight:2
-		:set stlo+=maxheight:3
+		:set stlo=maxheight:2,fixedheight
+		:set stlo-=fixedheight
 <
 						*'suffixes'* *'su'*
 'suffixes' 'su'		string	(default ".bak,~,.o,.h,.info,.swp,.obj")
@@ -8805,7 +8822,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 
 	You can use |g:actual_curtabpage| within a function assigned to
 	tabpanel.  |g:actual_curtabpage| represents current tab's label number.
-	You can use "%@" or "\n" to insert a new line: >
+	You can use "%@" or "\n" to insert a newline: >
 
 		set tabpanel=%!TabPanel()
 		function! TabPanel() abort
@@ -9096,6 +9113,42 @@ A jump table for the options with a short description can be found at |Q_op|.
 <
 	NOTE: This option is reset when 'compatible' is set.
 
+						*'termresize'* *'trz'*
+'termresize' 'trz'	string	(default "")
+			global
+			{only available in Unix, does not work in the GUI}
+	Determines the method to use for detecting window resize events,
+	possible values are:
+	    "sigwinch":	    Use the SIGWINCH signal.
+	    "inband":	    Receive resize events from the terminal via escape
+			    sequences (recommended if supported by terminal).
+	    "":		    Automatically choose depending on terminal.
+
+	The SIGWINCH handler is always available.  If set to "inband" and the
+	terminal does not support in-band window resize events, then the
+	SIGWINCH handler will be used instead as a fallback.  If set to ""
+	(empty option), then "inband" will be used if Vim detects that the
+	terminal supports it, otherwise "sigwinch".
+
+
+						*'termsync'* *'tsy'*
+'termsync' 'tsy'	boolean (default off)
+			global
+	If the host terminal supports it, buffer all screen updates made
+	during a redraw cycle so that each screen is displayed in the terminal
+	all at once.  This can prevent tearing or flickering when the terminal
+	updates faster than Vim can redraw.  If the host terminal does not
+	support it or if Vim is running graphically, then this option does
+	nothing.
+
+	The specification can be found at:
+	https://github.com/contour-terminal/vt-extensions/blob/master/synchronized-output.md
+
+	Vim may set this option automatically at startup time when Vim is
+	compiled with the |+termresponse| feature, by querying the terminal
+	for DEC mode 2026 support.  The terminal codes used are |t_BS| and
+	|t_ES|.
+
 						*'termwinkey'* *'twk'*
 'termwinkey' 'twk'	string	(default "")
 			local to window