Merge pull request #1454 from vim-jp/hh-update-options

Update options.{txt,jax}

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.1.  Last change: 2024 Jan 30
+*options.txt*	For Vim バージョン 9.1.  Last change: 2024 Mar 11
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -363,6 +363,7 @@ Note: 以下は |global-local| オプションにも適用される。
 	オプション	理由	~
 	'previewwindow'	1つしか存在できない
 	'scroll'	既存のウィンドウに固有のもの
+	'winfixbuf'	既存のウィンドウに固有のもの
 	'winfixheight'	既存のウィンドウに固有のもの
 	'winfixwidth'	既存のウィンドウに固有のもの
 
@@ -395,13 +396,20 @@ Note: 以下は |global-local| オプションにも適用される。
 			グローバルオプションに対しては、グローバルな値が表示さ
 			れる (しかし、これは将来変更されるかもしれない)。
 
+:se[t] {option}<	{option} の実効値をそのグローバル値に設定する。
+			文字列の |global-local| オプションの場合、ローカル値は
+			削除され、グローバル値が使用されるようになる。
+			他のすべてのオプションの場合、グローバル値がローカル値
+			にコピーされる。
 
-:setl[ocal] {option}<	値をコピーすることによって{option}のローカルな値をグ
-			ローバルな値と同じにする。
+:setl[ocal] {option}<	{option} の実効値をそのグローバル値に設定する。
+			数値および真偽値の |global-local| オプションの場合、
+			ローカル値が削除され、グローバル値が使用される。
+			文字列の |global-local| オプションを含む他のすべてのオ
+			プションでは、グローバル値がローカル値にコピーされる。
 
-:se[t] {option}<	|global-local| オプションに対して: {option} のローカル
-			値を削除する。そうすることでグローバル値が使われるよう
-			になる。
+Note |global-local| オプションの挙動は、文字列ベースのオプションと数値ベースの
+オプションでは若干異なることに注意。
 
 							*:setg* *:setglobal*
 :setg[lobal][!] ...	コマンド ":set" と似ているが、ローカルオプションのグロー
@@ -4034,7 +4042,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 						*'guiligatures'* *'gli'* *E1243*
 'guiligatures' 'gli'	文字列	(既定では "")
 			グローバル
-			{GTK GUIでのみ有効}
+			{GTK および Win32 GUI でのみ有効}
 	より複雑な形状を作るために結合して利用できるASCII文字セットのリスト。
 	各文字は値が32-127の範囲内の印字可能なASCIIの文字。
 	例: >
@@ -6481,7 +6489,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	のオンのままにしておくこと。昔の Vi スクリプトを使うときだけこれをオフ
 	にすること。
 
-                                               *'renderoptions'* *'rop'*
+						*'renderoptions'* *'rop'*
 'renderoptions' 'rop'	文字列  (既定では空)
 			グローバル
 			{Vim が MS-Windows で GUI と DIRECTX 付きでコンパイル
@@ -7273,8 +7281,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 		中にメッセージを表示しない
 	  q	"記録中 @a" の代わりに "記録中" を表示			*shm-q*
 	  F	コマンドに対する |:silent| のように、ファイルを編集中	*shm-F*
-		にファイル情報を表示しない。note これは autocommand からのメッ
-		セージにも影響する
+		にファイル情報を表示しない。note これは autocommand および
+		'autoread' の再読み込みからのメッセージにも影響する
 	  S     検索時に検索件数メッセージを表示しない。例えば "[1/5]"	*shm-S*
 	{訳注: 以下日本語メッセージの場合:
 	  "[Incomplete last line]"	"[最終行が不完全]"
@@ -8055,6 +8063,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 			両方指定された場合はこちらが優先される。
 	   uselast	これが含まれていると、|quickfix| コマンドでエラーにジャ
 			ンプするときに、前に使われたウィンドウにジャンプする。
+	ウィンドウで 'winfixbuf' が有効になっている場合、'switchbuf' は現在の
+	ところ分割ウィンドウには適用されない。
 
 						*'synmaxcol'* *'smc'*
 'synmaxcol' 'smc'	数値	(既定では 3000)
@@ -9496,6 +9506,15 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	Note: Vim のウィンドウの高さと混同しないこと。それには 'lines' を利用
 	する。
 
+						*'winfixbuf'*
+'winfixbuf' 'wfb'	切替	(既定ではオフ)
+			ウィンドウについてローカル
+	有効にすると、ウィンドウとそれが表示しているバッファがペアになる。
+	例えば、|:edit| を使用してバッファを変更しようとすると失敗する。
+	ウィンドウのバッファを変更する |:cnext| のような他のコマンドも
+	'winfixbuf' が有効なウィンドウをスキップする。ただし、Ex コマンドに
+	"!" 修飾子がある場合は、バッファを強制的に切り替えることができる。
+
 			*'winfixheight'* *'wfh'* *'nowinfixheight'* *'nowfh'*
 'winfixheight' 'wfh'	切替	(既定ではオフ)
 			ウィンドウについてローカル  |local-noglobal|

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.1.  Last change: 2024 Jan 30
+*options.txt*	For Vim version 9.1.  Last change: 2024 Mar 11
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -333,6 +333,7 @@ created, thus they behave slightly differently:
 	Option		Reason	~
 	'previewwindow'	there can only be a single one
 	'scroll'	specific to existing window
+	'winfixbuf'	specific to existing window
 	'winfixheight'	specific to existing window
 	'winfixwidth'	specific to existing window
 
@@ -365,11 +366,24 @@ created, thus they behave slightly differently:
 			For a global option the global value is
 			shown (but that might change in the future).
 
-:setl[ocal] {option}<	Set the local value of {option} to its global value by
-			copying the value.
-
-:se[t] {option}<	For |global-local| options: Remove the local value of
-			{option}, so that the global value will be used.
+:se[t] {option}<	Set the effective value of {option} to its global
+			value.
+			For string |global-local| options, the local value is
+			removed, so that the global value will be used.
+			For all other options, the global value is copied to
+			the local value.
+
+:setl[ocal] {option}<	Set the effective value of {option} to its global
+			value.
+			For number and boolean |global-local| options, the
+			local value is removed, so that the global value will
+			be used.
+			For all other options, including string |global-local|
+			options, the global value is copied to the local
+			value.
+
+Note that the behaviour for |global-local| options is slightly different
+between string and number-based options.
 
 							*:setg* *:setglobal*
 :setg[lobal][!] ...	Like ":set" but set only the global value for a local
@@ -2919,7 +2933,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 				Use the indent heuristic for the internal
 				diff library.
 
-                algorithm:{text} Use the specified diff algorithm with the
+		algorithm:{text} Use the specified diff algorithm with the
 				internal diff engine. Currently supported
 				algorithms are:
 				myers      the default algorithm
@@ -4000,7 +4014,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 						*'guiligatures'* *'gli'* *E1243*
 'guiligatures' 'gli'	string	(default "")
 			global
-			{only for GTK GUI}
+			{only for GTK and Win32 GUI}
 	List of ASCII characters that, when combined together, can create more
 	complex shapes. Each character must be a printable ASCII character
 	with a value in the 32-127 range.
@@ -6454,7 +6468,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	this option at the default "on".  Only switch it off when working with
 	old Vi scripts.
 
-                                               *'renderoptions'* *'rop'*
+						*'renderoptions'* *'rop'*
 'renderoptions' 'rop'	string  (default: empty)
 			global
 			{only available when compiled with GUI and DIRECTX on
@@ -7240,7 +7254,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	  q	use "recording" instead of "recording @a"		*shm-q*
 	  F	don't give the file info when editing a file, like	*shm-F*
 		`:silent` was used for the command; note that this also
-		affects messages from autocommands
+		affects messages from autocommands and 'autoread' reloading
 	  S	do not show search count message when searching, e.g.	*shm-S*
 		"[1/5]"
 
@@ -8008,6 +8022,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 			"split" when both are present.
 	   uselast	If included, jump to the previously used window when
 			jumping to errors with |quickfix| commands.
+	If a window has 'winfixbuf' enabled, 'switchbuf' is currently not
+	applied to the split window.
 
 						*'synmaxcol'* *'smc'*
 'synmaxcol' 'smc'	number	(default 3000)
@@ -9458,6 +9474,15 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Note: Do not confuse this with the height of the Vim window, use
 	'lines' for that.
 
+						*'winfixbuf'*
+'winfixbuf' 'wfb'	boolean	(default off)
+			local to window
+	If enabled, the window and the buffer it is displaying are paired.
+	For example, attempting to change the buffer with |:edit| will fail.
+	Other commands which change a window's buffer such as |:cnext| will
+	also skip any window with 'winfixbuf' enabled.  However if an Ex
+	command has a "!" modifier, it can force switching buffers.
+
 			*'winfixheight'* *'wfh'* *'nowinfixheight'* *'nowfh'*
 'winfixheight' 'wfh'	boolean	(default off)
 			local to window  |local-noglobal|