Merge pull request #2576 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 Apr 09
+*options.txt*  For Vim バージョン 9.2.  Last change: 2026 Apr 14
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -4794,7 +4794,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 				     l:Search,m:MoreMsg,M:ModeMsg,n:LineNr,
 				     a:LineNrAbove,b:LineNrBelow,
 				     N:CursorLineNr,r:Question,s:StatusLine,
-				     S:StatusLineNC,c:VertSplit,t:Title,
+				     S:StatusLineNC,c:VertSplit,
+				     |:VertSplitNC,t:Title,
 				     v:Visual,V:VisualNOS,w:WarningMsg,
 				     W:WildMenu,f:Folded,F:FoldColumn,
 				     A:DiffAdd,C:DiffChange,D:DiffDelete,
@@ -4843,6 +4844,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	|hl-StatusLineNC|  S  非カレントウィンドウのステータス行
 	|hl-Title|	 t  ":set all", ":autocmd" 等の出力のタイトル
 	|hl-VertSplit|	 c  ウィンドウの垂直分割に使われる区切り
+	|hl-VertSplitNC|   |  非カレントな垂直分割ウィンドウを区切る桁
 	|hl-Visual|	 v  ビジュアルモード
 	|hl-VisualNOS|	 V  Vim が「セレクションを所有していない」場合のビジュ
 			    アルモード。X11 Gui の |gui-x11|、
@@ -6243,6 +6245,48 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	NOTE: 'modeline' は、'compatible' がオンになるとViの既定値に設定され、
 	'compatible' がオフになるとVimの既定値に設定されるので注意。
 
+		    *'modelinestrict'* *'mlst'* *'nomodelinestrict'* *'nomlst'*
+'modelinestrict' 'mlst'	切替 (既定ではオン)
+			グローバル
+	有効にすると、|modeline| から設定できるオプションは安全なサブセットの
+	みになる。以下のオプションが許可される:
+		'autoindent'
+		'cindent'
+		'commentstring'
+		'expandtab'
+		'filetype'
+		'foldcolumn'
+		'foldenable'
+		'foldmethod'
+		'modifiable'
+		'readonly'
+		'rightleft'
+		'shiftwidth'
+		'smartindent'
+		'softtabstop'
+		'spell'
+		'spelllang'
+		'tabstop'
+		'textwidth'
+		'varsofttabstop'
+		'vartabstop'
+
+	モードラインから設定されたその他のオプションは、すべて無視される。
+	セキュリティ上の理由から、このオプションは |modeline| または |sandbox|
+	内では設定できない。
+
+	'modeline'、'modelinestrict'、および 'modelineexpr' の動作は以下のとお
+	りである:
+
+	'modeline'| 'modelinestrict'| 'modelineexpr' | 意味
+	----------+-----------------+-------------------+--------~
+	   on     |    off          |   on           | 全オプションを設定可能
+	   on     |    on           |   any          | ホワイトリストに登録され
+		  |                 |                | たオプションのみ設定可能
+	   on     |    off          |   off          | expr オプションを除く全
+		  |                 |                | オプションを設定可能
+	   off    |    any          |   any          | オプションは設定不可
+
 				*'modifiable'* *'ma'* *'nomodifiable'* *'noma'*
 				*E21*
 'modifiable' 'ma'	切替	(既定ではオン)
@@ -8640,10 +8684,64 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	      いは非カレントウィンドウのステータス行にはハイライトグループ
 	      StatusLineNC が適用されることである。数 N は 1 以上 9 以下であ
 	      る。|hl-User1..9| を参照。
-								*stl-%@*
+							*stl-%@*
 	@ -   改行を挿入する。これは、'statuslineopt' の "maxheight" 値が 1 よ
 	      り大きい場合、または |tabpanel| の場合にのみ有効である。
 
+							*stl-%[FuncName]*
+	%[ はステータスライン内のクリック可能な領域を定義する。ユーザーがマウ
+	スで領域をクリックすると、指定された関数が呼び出される。同じ構文は
+	'tabline' でも使用できる。
+
+	  %[FuncName]	クリック可能な領域の開始位置。"FuncName" は、その領域
+			がクリックされたときに呼び出される Vim の関数の名前で
+			ある。
+	  %[]		クリック可能な領域の終了位置。省略した場合、領域はス
+			テータスラインの末尾、または次のクリック可能な領域の開
+			始位置まで延長される。
+
+	{minwid} 値を使用すると、識別子をコールバックに渡すことができる:
+	  %3[FuncName]	最小幅 3 のクリック可能な領域を開始する。
+
+	この関数は、以下のエントリを含む単一の |Dictionary| 引数を受け取る:
+	  "minwid"	%N[Func] からの minwid 値 (指定されていない場合は 0)。
+	  "nclicks"	クリック数: 1、2、または 3。
+	  "button"	マウスボタン: "l" (左)、"m" (中央)、"r" (右)。
+	  "mods"	修飾キー: "s" (Shift)、"c" (Ctrl)、"a" (Alt) の組み合
+			わせ。修飾キーがない場合は空文字列。
+	  "winid"	ステータスラインがクリックされたウィンドウの
+			|window-ID|、またはクリックが 'tabline' 内で行われた場
+			合は 0。
+	  "area"	"statusline" または "tabline"。クリックされた領域がど
+			ちらのオプションに属するかを示す。'statusline' と
+			'tabline' で単一のコールバックが共有されている場合に便
+			利である。
+
+	関数がゼロ以外の値を返した場合、ステータスラインが再描画される。
+	ステータスラインをドラッグしてウィンドウのサイズを変更する操作は、ク
+	リックハンドラが定義されている場合でも引き続き機能する。'tabline' 内で
+	使用される場合、%[FuncName] 領域でのクリックは、デフォルトのタブページ
+	選択動作ではなく、コールバックにディスパッチされる。
+
+	例: >
+	    func! ClickFile(info)
+		if a:info.button ==# 'l' && a:info.nclicks == 2
+		    browse edit
+		endif
+		return 0
+	    endfunc
+	    set statusline=%[ClickFile]%f%[]\ %l:%c
+<	これにより、ステータスラインに表示されるファイル名がクリック可能にな
+	る。ダブルクリックするとファイルブラウザーが開く。
+
+	`has('statusline_click')` を使用して、この機能が使用可能かどうかを確認
+	する。これは下位互換性のために役立つ: >
+	    if has('statusline_click')
+		set statusline=%[ClickFile]%f%[]\ %l:%c
+	    else
+		set statusline=%f\ %l:%c
+	    endif
+<
 	フラグを表示するとき、そのフラグがプレーンテキストの直後にあるな
 	ら、その先頭にコンマがある場合は削除される。そうすることによって以下の
 	例のようなフラグの使い方をしたとき、きれいに表示されるようになっている。

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.2.  Last change: 2026 Apr 09
+*options.txt*	For Vim version 9.2.  Last change: 2026 Apr 14
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -4757,7 +4757,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 				     l:Search,m:MoreMsg,M:ModeMsg,n:LineNr,
 				     a:LineNrAbove,b:LineNrBelow,
 				     N:CursorLineNr,r:Question,s:StatusLine,
-				     S:StatusLineNC,c:VertSplit,t:Title,
+				     S:StatusLineNC,c:VertSplit,
+				     |:VertSplitNC,t:Title,
 				     v:Visual,V:VisualNOS,w:WarningMsg,
 				     W:WildMenu,f:Folded,F:FoldColumn,
 				     A:DiffAdd,C:DiffChange,D:DiffDelete,
@@ -4805,6 +4806,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 	|hl-StatusLineNC|  S  status lines of not-current windows
 	|hl-Title|	 t  Titles for output from ":set all", ":autocmd" etc.
 	|hl-VertSplit|	 c  column used to separate vertically split windows
+	|hl-VertSplitNC| |  column separating non-current vertically split
+			    windows
 	|hl-Visual|	 v  Visual mode
 	|hl-VisualNOS|	 V  Visual mode when Vim is "Not Owning the
 			    Selection" Only X11 Gui's |gui-x11|,
@@ -6196,6 +6199,48 @@ A jump table for the options with a short description can be found at |Q_op|.
 	NOTE: 'modeline' is set to the Vi default value when 'compatible' is
 	set and to the Vim default value when 'compatible' is reset.
 
+		    *'modelinestrict'* *'mlst'* *'nomodelinestrict'* *'nomlst'*
+'modelinestrict' 'mlst'	boolean (default: on)
+			global
+	When on, only a safe subset of options can be set from a |modeline|.
+	The following options are allowed:
+		'autoindent'
+		'cindent'
+		'commentstring'
+		'expandtab'
+		'filetype'
+		'foldcolumn'
+		'foldenable'
+		'foldmethod'
+		'modifiable'
+		'readonly'
+		'rightleft'
+		'shiftwidth'
+		'smartindent'
+		'softtabstop'
+		'spell'
+		'spelllang'
+		'tabstop'
+		'textwidth'
+		'varsofttabstop'
+		'vartabstop'
+
+	Any other option set from a modeline will be silently ignored.
+	This option cannot be set from a |modeline| or in the |sandbox|, for
+	security reasons.
+
+	The behaviour of 'modeline', 'modelinestrict' and 'modelineexpr' is
+	as follows:
+
+	'modeline'| 'modelinestrict'| 'modelineexpr' | Meaning
+	----------+-----------------+-------------------+--------~
+	   on     |    off          |   on           | All options can be set
+	   on     |    on           |   any          | Only whitelisted
+		  |                 |                | options can be set
+	   on     |    off          |   off          | All options except for
+		  |                 |                | expr options can be set
+	   off    |    any          |   any          | No options can be set
+
 				*'modifiable'* *'ma'* *'nomodifiable'* *'noma'*
 				*E21*
 'modifiable' 'ma'	boolean	(default on)
@@ -8620,10 +8665,62 @@ A jump table for the options with a short description can be found at |Q_op|.
 	      applied to StatusLineNC for the statusline of non-current
 	      windows.
 	      The number N must be between 1 and 9.  See |hl-User1..9|
-								*stl-%@*
+							*stl-%@*
 	@ -   Inserts a newline.  This only takes effect when the "maxheight"
 	      value of 'statuslineopt' is greater than 1, or for |tabpanel|.
 
+							*stl-%[FuncName]*
+	%[ defines clickable regions in the statusline.  When the user clicks
+	on a region with the mouse, the specified function is called.  The
+	same syntax can also be used in 'tabline'.
+
+	  %[FuncName]	Start of a clickable region.  "FuncName" is the name
+			of a Vim function to call when the region is clicked.
+	  %[]		End of the clickable region.  If omitted, the region
+			extends to the end of the statusline or to the start
+			of the next clickable region.
+
+	A {minwid} value can be used to pass an identifier to the callback:
+	  %3[FuncName]	Starts a clickable region with minwid 3.
+
+	The function receives a single |Dictionary| argument with these
+	entries:
+	  "minwid"	The minwid value from %N[Func] (0 if not specified).
+	  "nclicks"	Number of clicks: 1, 2, or 3.
+	  "button"	Mouse button: "l" (left), "m" (middle), "r" (right).
+	  "mods"	Modifier keys: combination of "s" (shift), "c" (ctrl),
+			"a" (alt).  Empty string if no modifiers.
+	  "winid"	|window-ID| of the window whose statusline was clicked,
+			or 0 when the click was in 'tabline'.
+	  "area"	"statusline" or "tabline".  Indicates which option the
+			clicked region belongs to.  Useful when a single
+			callback is shared between 'statusline' and 'tabline'.
+
+	If the function returns non-zero, the statusline is redrawn.
+	Dragging the statusline to resize the window still works even when
+	click handlers are defined.  When used in 'tabline', clicks in
+	%[FuncName] regions are dispatched to the callback instead of the
+	default tab page selection behavior.
+
+	Example: >
+	    func! ClickFile(info)
+		if a:info.button ==# 'l' && a:info.nclicks == 2
+		    browse edit
+		endif
+		return 0
+	    endfunc
+	    set statusline=%[ClickFile]%f%[]\ %l:%c
+<	This makes the filename in the statusline clickable.  Double-clicking
+	it opens the file browser.
+
+	Use `has('statusline_click')` to check if this feature is available.
+	This is useful for backward compatibility: >
+	    if has('statusline_click')
+		set statusline=%[ClickFile]%f%[]\ %l:%c
+	    else
+		set statusline=%f\ %l:%c
+	    endif
+<
 	When displaying a flag, Vim removes the leading comma, if any, when
 	that flag comes right after plaintext.  This will make a nice display
 	when flags are used like in the examples below.