Skip to content

Update options.{txt,jax} #2339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 5, 2025
+90 −42
Merged

Update options.{txt,jax} #2339

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 44 additions & 19 deletions doc/options.jax
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -939,7 +939,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる

*'autocomplete'* *'ac'* *'noautocomplete'* *'noac'*
'autocomplete' 'ac' 切替 (既定ではオフ)
グローバル
グローバル／バッファについてローカル |global-local|
{Vim がタイミングをサポートするプラットフォームでのみ
有効}
オンにすると、Vim は入力時に補完メニューを表示する。これは |i_CTRL-N|
Expand Down Expand Up @@ -2305,6 +2305,21 @@ Note 1番目の形式では、行全体がオプション指定に使われる
大文字・小文字が同一視されるかどうかは補完の種類による。
バッファのテキストについてはオプション 'ignorecase' が適用
される。
longest
'autocomplete' が無効の場合、マッチした単語の最長共通プリ
フィックスのみが挿入される。ポップアップメニューが表示され
ている場合は、CTRL-L で文字を追加できる。大文字小文字が無
視されるかどうかは、補完の種類によって異なる。バッファ内の
テキストには、'ignorecase' オプションが適用される。

'autocomplete' が有効で、補完項目が選択されていない場合、
マッチした候補の中の最長共通プリフィックスがカーソルの後ろ
に挿入される。このプリフィックスは、表示されているすべての
項目から取得するか、カレントバッファ内の項目のみから取得す
る。挿入されたテキストは |hl-PreInsert| でハイライトされ、
カーソル位置は変化しない (`"preinsert"` と同様)。挿入する
には CTRL-Y を押下する。
|preinserted()| も参照。

menu ポップアップメニューで補完候補を表示する。ポップアップメ
ニューは、候補が2個以上あり、十分な数の色が使用できるとき
Expand Down Expand Up @@ -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' を参照。
Expand Down Expand Up @@ -3813,8 +3826,14 @@ Note 1番目の形式では、行全体がオプション指定に使われる
'fileignorecase' 'fic' 切替 (既定値: ファイル名の大文字と小文字の違いを無
視するシステムではオン)
グローバル
このオプションを設定すると、ファイル名とディレクトリ名の大文字と小文字
の違いが無視される。
このオプションを設定すると、ファイルおよびディレクトリ名の大文字と小文
字の違いが無視される。

このオプションは、ファイルシステムが伝統的に大文字と小文字を区別しない
システム (例えば MS-Windows や macOS) ではデフォルトでオンになってい
る。ただし、Vim は実行時に特定のファイルシステムが大文字と小文字を区別
するか区別しないかを判断できない。

補完で大文字と小文字の違いを無視したい場合は 'wildignorecase' を参照。

*'filetype'* *'ft'*
Expand Down Expand Up @@ -8959,6 +8978,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
も新しいバージョンが必要である。以下のように確認する: >
if has('vcon')
< これには Vim が |+vtp| 機能付きでビルドされている必要がある。
|win32-term-colors| も参照。

Note "cterm" の特徴はまだ使われているが、"gui" はそうではないことに注
意。
Expand Down Expand Up @@ -10232,8 +10252,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
*'wlsteal'* *'wst'* *'nowlsteal'* *'nowst'*
'wlsteal' 'wst' 切替 (既定ではオフ)
グローバル
{|+wayland_clipboard| 機能付きでコンパイルされたときの
み有効}
{|+wayland_focus_steal| 機能付きでコンパイルされたとき
のみ有効}
有効にすると、Vim はクリップボードにアクセスするために一時的なサーフェ
スを作成してフォーカスを奪取できるようになる。詳細については
|wayland-focus-steal| を参照。
Expand Down Expand Up @@ -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)
Expand Down
69 changes: 46 additions & 23 deletions en/options.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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|.
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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'*
Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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|.
Expand Down Expand Up @@ -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)
Expand Down