Merge pull request #2339 from h-east/update-options

Update options.{txt,jax}

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.1. Last change: 2025 Sep 15
+*options.txt*	For Vim バージョン 9.1. Last change: 2025 Sep 29
 
 
  VIMリファレンスマニュアル by Bram Moolenaar
@@ -939,7 +939,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 
 *'autocomplete'* *'ac'* *'noautocomplete'* *'noac'*
 'autocomplete' 'ac'	切替	(既定ではオフ)
-グローバル
+グローバル／バッファについてローカル |global-local|
 {Vim がタイミングをサポートするプラットフォームでのみ
 有効}
 オンにすると、Vim は入力時に補完メニューを表示する。これは |i_CTRL-N|
@@ -2305,6 +2305,21 @@ Note 1番目の形式では、行全体がオプション指定に使われる
  大文字・小文字が同一視されるかどうかは補完の種類による。
  バッファのテキストについてはオプション 'ignorecase' が適用
  される。
+ longest
+ 'autocomplete' が無効の場合、マッチした単語の最長共通プリ
+ フィックスのみが挿入される。ポップアップメニューが表示され
+ ている場合は、CTRL-L で文字を追加できる。大文字小文字が無
+ 視されるかどうかは、補完の種類によって異なる。バッファ内の
+ テキストには、'ignorecase' オプションが適用される。
+
+ 'autocomplete' が有効で、補完項目が選択されていない場合、
+ マッチした候補の中の最長共通プリフィックスがカーソルの後ろ
+ に挿入される。このプリフィックスは、表示されているすべての
+ 項目から取得するか、カレントバッファ内の項目のみから取得す
+ る。挿入されたテキストは |hl-PreInsert| でハイライトされ、
+ カーソル位置は変化しない (`"preinsert"` と同様)。挿入する
+ には CTRL-Y を押下する。
+ |preinserted()| も参照。
 
  menu ポップアップメニューで補完候補を表示する。ポップアップメ
  ニューは、候補が2個以上あり、十分な数の色が使用できるとき
@@ -2346,24 +2361,22 @@ Note 1番目の形式では、行全体がオプション指定に使われる
  {|+textprop| 機能付きでコンパイルされたときのみ有効}
 
  preinsert
- 'autocomplete' がアクティブでない場合、最初の候補単語のう
- ち、|hl-PreInsert| でハイライト表示されている現在の補完リー
- ダーの後ろの部分を挿入する。カーソルは移動しない。'fuzzy'
- が未設定で、'completeopt' に "menuone" が指定されている必
- 要がある。
-
- 'autocomplete' がアクティブな場合、(表示されているすべての
- 項目、または現在のバッファ項目から) マッチした単語の中で最
- 長の共通プリフィックスを挿入する。これは、メニュー項目が選
- 択されていない場合にのみ実行される。確定するには Ctrl-Y を
- 押す。
+ 最初の補完候補のテキストを、現在のリーダーの後ろに挿入す
+ る。このテキストは |hl-PreInsert| でハイライトされる。
+ カーソルは移動しない。
+ "fuzzy" を無効にし、さらに 'completeopt' に "menuone" を設
+ 定するか、または 'autocomplete' を有効にしておく必要があ
+ る。'autocomplete' を有効にしている場合、'ignorecase' だけ
+ が設定されていて 'infercase' が設定されていないと動作しな
+ い。
+ |preinserted()| も参照。
 
  preview 現在選択されている候補についての付加的な情報をプレビュー
  ウィンドウに表示する。"menu" または "menuone" と組み合わせ
  たときのみ有効。
 
-'autocomplete' が有効な場合、"fuzzy"、"popup"、"popuphidden"、
-"preinsert" および "preview" のみ効果がある。
+'autocomplete' が有効な場合、"fuzzy"、"longest"、"popup"、
+"popuphidden"、"preinsert" および"preview" のみが効果がある。
 
 このオプションは |cmdline-completion| には適用されない。詳細については
 'wildoptions' を参照。
@@ -3813,8 +3826,14 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 'fileignorecase' 'fic'	切替	(既定値: ファイル名の大文字と小文字の違いを無
 視するシステムではオン)
 グローバル
-このオプションを設定すると、ファイル名とディレクトリ名の大文字と小文字
-の違いが無視される。
+このオプションを設定すると、ファイルおよびディレクトリ名の大文字と小文
+字の違いが無視される。
+
+このオプションは、ファイルシステムが伝統的に大文字と小文字を区別しない
+システム (例えば MS-Windows や macOS) ではデフォルトでオンになってい
+る。ただし、Vim は実行時に特定のファイルシステムが大文字と小文字を区別
+するか区別しないかを判断できない。
+
 補完で大文字と小文字の違いを無視したい場合は 'wildignorecase' を参照。
 
 *'filetype'* *'ft'*
@@ -8959,6 +8978,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 も新しいバージョンが必要である。以下のように確認する: >
 if has('vcon')
 <	これには Vim が |+vtp| 機能付きでビルドされている必要がある。
+|win32-term-colors| も参照。
 
 Note "cterm" の特徴はまだ使われているが、"gui" はそうではないことに注
 意。
@@ -10232,8 +10252,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 *'wlsteal'* *'wst'* *'nowlsteal'* *'nowst'*
 'wlsteal' 'wst'	切替 (既定ではオフ)
 グローバル
-{|+wayland_clipboard| 機能付きでコンパイルされたときの
-み有効}
+{|+wayland_focus_steal| 機能付きでコンパイルされたとき
+のみ有効}
 有効にすると、Vim はクリップボードにアクセスするために一時的なサーフェ
 スを作成してフォーカスを奪取できるようになる。詳細については
 |wayland-focus-steal| を参照。
@@ -10268,6 +10288,11 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 <	'sidescroll'、'listchars' や |wrap-off| を参照。
 オプション 'diff' がオンの場合、モードライン |modeline| からこのオプ
 ションを設定することはできない。
+|modeline| または |sandbox| で 'nowrap' が設定された場合、'list' およ
+び 'listchars' オプションの値に関係なく、'>' が |lcs-extends| 文字とし
+て使用される。これは、ビューポート外の悪意のあるコードが検知されないこ
+とを防ぐためである。この動作を無効にするには、後で手動で
+`:setlocal nowrap` を使用する。
 
 *'wrapmargin'* *'wm'*
 'wrapmargin' 'wm'	数値	(既定では 0)

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*For Vim version 9.1. Last change: 2025 Sep 15
+*options.txt*For Vim version 9.1. Last change: 2025 Sep 29
 
 
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -913,7 +913,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 
 *'autocomplete'* *'ac'* *'noautocomplete'* *'noac'*
 'autocomplete' 'ac'boolean (default off)
-global
+global or local to buffer |global-local|
 {only available on platforms with timing support}
 When on, Vim shows a completion menu as you type, similar to using
 |i_CTRL-N|, but triggered automatically. See |ins-autocompletion|.
@@ -2256,11 +2256,22 @@ A jump table for the options with a short description can be found at |Q_op|.
  to gather more alternatives for your candidate list,
  see 'completefuzzycollect'.
 
- longest Only insert the longest common text of the matches. If
- the menu is displayed you can use CTRL-L to add more
- characters. Whether case is ignored depends on the kind
- of completion. For buffer text the 'ignorecase' option is
- used.
+ longest
+ When 'autocomplete' is not active, only the longest
+ common prefix of the matches is inserted. If the popup
+ menu is displayed, you can use CTRL-L to add more
+ characters. Whether case is ignored depends on the type
+ of completion. For buffer text the 'ignorecase' option
+ applies.
+
+ When 'autocomplete' is active and no completion item is
+ selected, the longest common prefix of the matches is
+ inserted after the cursor. The prefix is taken either
+ from all displayed items or only from items in the current
+ buffer. The inserted text is highlighted with
+ |hl-PreInsert|, and the cursor position does not change
+ (similar to `"preinsert"`). Press CTRL-Y to accept.
+ See also |preinserted()|.
 
  menu Use a popup menu to show the possible completions. The
  menu is only shown when there is more than one match and
@@ -2302,22 +2313,21 @@ A jump table for the options with a short description can be found at |Q_op|.
  {only works when compiled with the |+textprop| feature}
 
  preinsert
- When 'autocomplete' is not active, inserts the part of the
- first candidate word beyond the current completion leader,
- highlighted with |hl-PreInsert|. The cursor doesn't move.
- Requires "fuzzy" unset and "menuone" in 'completeopt'.
-
- When 'autocomplete' is active, inserts the longest common
- prefix of matches (from all shown items or from the
- current buffer items). This occurs only when no menu item
- is selected. Press CTRL-Y to accept.
+ Inserts the text of the first completion candidate
+ beyond the current leader, highlighted with |hl-PreInsert|.
+ The cursor does not move.
+ Requires "fuzzy" to be unset, and either "menuone" in
+ 'completeopt' or 'autocomplete' enabled. When
+ 'autocomplete' is enabled, this does not work if
+ 'ignorecase' is set without 'infercase'.
+ See also |preinserted()|.
 
  preview Show extra information about the currently selected
  completion in the preview window. Only works in
  combination with "menu" or "menuone".
 
-Only "fuzzy", "popup", "popuphidden", "preinsert" and "preview" have
-an effect when 'autocomplete' is enabled.
+Only "fuzzy", "longest", "popup", "popuphidden", "preinsert" and
+"preview" have an effect when 'autocomplete' is enabled.
 
 This option does not apply to |cmdline-completion|. See 'wildoptions'
 for that.
@@ -3699,7 +3709,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 command to find the illegal byte sequence.
 WRONG VALUES:	WHAT'S WRONG:
 latin1,utf-8	"latin1" will always be used
-utf-8,ucs-bom,latin1	BOM won't be recognized in an utf-8
+utf-8,ucs-bom,latin1	BOM won't be recognized in a utf-8
 file
 cp1250,latin1	"cp1250" will always be used
 If 'fileencodings' is empty, 'fileencoding' is not modified.
@@ -3791,7 +3801,13 @@ A jump table for the options with a short description can be found at |Q_op|.
 'fileignorecase' 'fic'boolean	(default on for systems where case in file
  names is normally ignored)
 global
-When set case is ignored when using file names and directories.
+When set, case is ignored when using file and directory names.
+
+This option is on by default on systems where the filesystem is
+traditionally case-insensitive (for example MS-Windows and macOS).
+However, Vim cannot determine at runtime whether a particular
+filesystem is case-sensitive or case-insensitive.
+
 See 'wildignorecase' for only ignoring case when doing completion.
 
 *'filetype'* *'ft'*
@@ -8913,14 +8929,15 @@ A jump table for the options with a short description can be found at |Q_op|.
 When on, uses |highlight-guifg| and |highlight-guibg| attributes in
 the terminal (thus using 24-bit color).
 
-Requires a ISO-8613-3 compatible terminal. If setting this option
+Requires an ISO-8613-3 compatible terminal. If setting this option
 does not work (produces a colorless UI) reading |xterm-true-color|
 might help.
 
 For Win32 console, Windows 10 version 1703 (Creators Update) or later
 is required. Use this check to find out: >
 if has('vcon')
-<This requires Vim to be built with the |+vtp| feature.
+<This requires Vim to be built with the |+vtp| feature, see also
+|win32-term-colors|.
 
 Note that the "cterm" attributes are still used, not the "gui" ones.
 
@@ -10204,7 +10221,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 *'wlsteal'* *'wst'* *'nowlsteal'* *'nowst'*
 'wlsteal' 'wst'boolean (default off)
 global
-{only when the |+wayland_clipboard| feature is included}
+{only when the |+wayland_focus_steal| feature is
+included}
 When enabled, then allow Vim to steal focus by creating a temporary
 surface, in order to access the clipboard. For more information see
 |wayland-focus-steal|.
@@ -10241,6 +10259,11 @@ A jump table for the options with a short description can be found at |Q_op|.
 <See 'sidescroll', 'listchars' and |wrap-off|.
 This option can't be set from a |modeline| when the 'diff' option is
 on.
+If 'nowrap' was set from a |modeline| or in the |sandbox|, '>' is used
+as the |lcs-extends| character regardless of the value of the 'list'
+and 'listchars' options. This is to prevent malicious code outside
+the viewport from going unnoticed. Use `:setlocal nowrap` manually
+afterwards to disable this behavior.
 
 *'wrapmargin'* *'wm'*
 'wrapmargin' 'wm'number	(default 0)