Skip to content

Update options.{txt,jax} #2273

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

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Update options.{txt,jax} #2273

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3d25c70
Update options.{txt,jax}
h-east Aug 24, 2025
94192fd
Update by original
h-east Aug 28, 2025
01bac35
Update by original
h-east Sep 2, 2025
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
58 changes: 43 additions & 15 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 Aug 21
*options.txt* For Vim バージョン 9.1. Last change: 2025 Sep 01


VIMリファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -953,6 +953,20 @@ Note 1番目の形式では、行全体がオプション指定に使われる
完メニューがすぐに表示されて欲しくない場合には、入力速度より少し長めの
値を設定する。|ins-autocompletion| を参照。

*'autocompletetimeout'* *'act'*
'autocompletetimeout' 'act' 数値 (既定では 80)
グローバル
減衰型タイムスライス補完アルゴリズムの初期タイムアウト (ミリ秒)。この
値から開始し、低速なソースごとに半分ずつ減らし、最小値に達する。すべて
のソースは実行されるが、低速なソースはすぐに優先順位が下げられる。デ
フォルトでは、低速なシステムで複数の低速なソースがあっても、ポップアッ
プメニューが約 200 ミリ秒以内に開くように調整されている。この値を変更
する必要はほとんどない。80 以上の値のみ有効である。
特別なケース: 'complete' に "F" または "o" が含まれる場合 (関数ソース
の場合)、より長いタイムアウトが使用される。LSP サーバーなど、場合によっ
ては時間がかかる可能性のあるソース (モジュールの読み込み中など) に対し
ては、最大約 1 秒まで許容される。|ins-autocompletion| を参照。

*'autoindent'* *'ai'* *'noautoindent'* *'noai'*
'autoindent' 'ai' 切替 (既定ではオフ)
バッファについてローカル
Expand Down Expand Up @@ -1782,6 +1796,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
内で設定することはできない。

*'chistory'* *'chi'*
*E1542* *E1543* *E1544*
'chistory' 'chi' 数値 (既定では 10)
グローバル
{|+quickfix| 機能付きでコンパイルされたときのみ有効}
Expand Down Expand Up @@ -1939,26 +1954,26 @@ Note 1番目の形式では、行全体がオプション指定に使われる
後に指定しなければならない。

*'clipmethod'* *'cpm'*
'clipmethod' 'cpm' 文字列 (Unix での既定値: "wayland,x11",
VMS: "x11",
その他: "")
'clipmethod' 'cpm' 文字列 (Unix での既定値: "wayland,x11,gui,other",
VMS: "x11,gui,other",
その他: "gui,other")
グローバル
{|+xterm_clipboard| または |+wayland_clipboard| 機能付
きでコンパイルされたもののみ有効}
{|+clipboard| 機能付きでコンパイルされたときのみ有効}
システムクリップボードへのアクセス方法を指定する。先に動作したメソッ
ド、または利用可能なメソッドに応じて使用される。サポートされているメ
ソッドは以下のとおり:
wayland Wayland セレクション
x11 X11 セレクション
gui GUI 固有のメソッド
other その他のメソッド

Note: このオプションは、GUI が動作している場合、または Windows や
macOS など Wayland や X11 がサポートされていないシステムで Vim を実行
している場合には無視される。代わりに、GUI やシステムのクリップボードア
クセス方法が常に使用される。
Note: "other" は GUI なしで Vim を実行している場合の、MS-Windows や
MacOS など、X11/Wayland がないシステム使用される。

オプションの値は、コンマ区切りの項目のリストである。リストは左から右へ
と順に解析され、Vim が最初に利用可能または動作していると判断するメソッ
ドが、クリップボードへのアクセスに実際に使用される。
ドが、クリップボードへのアクセスに実際に使用される。このオプションを空
の値に設定すると、すべてのシステムでクリップボード機能が無効になる。

現在使用されているメソッドは |v:clipmethod| 変数で確認できる。

Expand Down Expand Up @@ -2372,6 +2387,12 @@ Note 1番目の形式では、行全体がオプション指定に使われる
挿入モードの補完には、バッファローカル値が使用される。コマンドラインの
補完には、グローバル値が使用される。

*'completetimeout'* *'cto'*
'completetimeout' 'cto' 数値 (既定では 0)
グローバル
'autocompletetimeout' と同様だが、|i_CTRL-N| および |i_CTRL-P| 補完に
適用される。値 0 はタイムアウトを無効にする。正の値が許可される。

*'concealcursor'* *'cocu'*
'concealcursor' 'cocu' 文字列 (既定では: "")
ウィンドウについてローカル
Expand Down Expand Up @@ -6462,6 +6483,14 @@ Note 1番目の形式では、行全体がオプション指定に使われる
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

*'osctimeoutlen'* *'ost'* *E1568*
'osctimeoutlen' 'ost' 数値 (既定では 1000)
グローバル
このオプションは、Vim が OSC コマンド応答の開始を受信してから OSC 終端
を受信するまで待機するタイムアウト時間をミリ秒単位で指定する。詳細につ
いては、|TermResponseAll| 自動コマンドイベントおよび |v:termosc| を参
照。

*'osfiletype'* *'oft'*
'osfiletype' 'oft' 文字列 (既定では: "")
バッファについてローカル
Expand Down Expand Up @@ -8906,8 +8935,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
がこのように設定する必要がある。

*'termguicolors'* *'tgc'* *'notermguicolors'* *'notgc'* *E954*
'termguicolors' 'tgc' 切替 (Vim が対応端末で実行されていることを検出しな
い限り、既定ではオフ)
'termguicolors' 'tgc' 切替 (既定ではオフ)
グローバル
{|+termguicolors| 機能付きでコンパイルされたときのみ有
効}
Expand Down Expand Up @@ -10195,8 +10223,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
*'wlsteal'* *'wst'* *'nowlsteal'* *'nowst'*
'wlsteal' 'wst' 切替 (既定ではオフ)
グローバル
{|+wayland_clipboard| 機能付きでコンパイルされたときの
み有効}
{|+wayland_focus_steal| 機能付きでコンパイルされたとき
のみ有効}
有効にすると、Vim はクリップボードにアクセスするために一時的なサーフェ
スを作成してフォーカスを奪取できるようになる。詳細については
|wayland-focus-steal| を参照。
Expand Down
61 changes: 45 additions & 16 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 Aug 21
*options.txt* For Vim version 9.1. Last change: 2025 Sep 01


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -925,6 +925,20 @@ A jump table for the options with a short description can be found at |Q_op|.
typing. If you prefer it not to open too quickly, set this value
slightly above your typing speed. See |ins-autocompletion|.

*'autocompletetimeout'* *'act'*
'autocompletetimeout' 'act' number (default 80)
global
Initial timeout (in milliseconds) for the decaying time-sliced
completion algorithm. Starts at this value, halves for each slower
source until a minimum is reached. All sources run, but slower ones
are quickly de-prioritized. The default is tuned so the popup menu
opens within ~200ms even with multiple slow sources on a slow system.
Changing this value is rarely needed. Only 80 or higher is valid.
Special case: when 'complete' contains "F" or "o" (function sources),
a longer timeout is used, allowing up to ~1s for sources such as LSP
servers that may sometimes take longer (e.g., while loading modules).
See |ins-autocompletion|.

*'autoindent'* *'ai'* *'noautoindent'* *'noai'*
'autoindent' 'ai' boolean (default off)
local to buffer
Expand Down Expand Up @@ -1732,6 +1746,7 @@ A jump table for the options with a short description can be found at |Q_op|.
security reasons.

*'chistory'* *'chi'*
*E1542* *E1543* *E1544*
'chistory' 'chi' number (default: 10)
global
{only available when compiled with the |+quickfix|
Expand Down Expand Up @@ -1891,30 +1906,30 @@ A jump table for the options with a short description can be found at |Q_op|.
{pattern}, this must be the last entry.

*'clipmethod'* *'cpm'*
'clipmethod' 'cpm' string (default for Unix: "wayland,x11",
for VMS: "x11",
otherwise: "")
'clipmethod' 'cpm' string (default for Unix: "wayland,x11,gui,other",
for VMS: "x11,gui,other",
otherwise: "gui,other")
global
{only when the |+xterm_clipboard| or
|+wayland_clipboard| features are included}
{only when the |+clipboard| feature is included}
Specifies which method of accessing the system clipboard is used,
depending on which method works first or is available. Supported
methods are:
wayland Wayland selections
x11 X11 selections
gui GUI specific method
other Some other method

Note: This option is ignored when either the GUI is running or if Vim
is run on a system without Wayland or X11 support, such as Windows or
macOS. The GUI or system way of accessing the clipboard is always
used instead.
Note: "other" is used on systems without X11/Wayland, such as
MS-Windows or MacOS, when running Vim without the GUI.

The option value is a list of comma separated items. The list is
parsed left to right in order, and the first method that Vim
determines is available or is working is used as the actual method for
accessing the clipboard.
accessing the clipboard. Setting this option to an empty value
disables the clipboard functionality on all systems.

The current method that is being used can be found in the |v:clipmethod|
variable.
The current method that is being used can be found in the
|v:clipmethod| variable.

*'cmdheight'* *'ch'*
'cmdheight' 'ch' number (default 1)
Expand Down Expand Up @@ -2325,6 +2340,12 @@ A jump table for the options with a short description can be found at |Q_op|.
For Insert mode completion the buffer-local value is used. For
command line completion the global value is used.

*'completetimeout'* *'cto'*
'completetimeout' 'cto' number (default 0)
global
Like 'autocompletetimeout', but applies to |i_CTRL-N| and |i_CTRL-P|
completion. Value of 0 disables the timeout; positive values allowed.

*'concealcursor'* *'cocu'*
'concealcursor' 'cocu' string (default: "")
local to window
Expand Down Expand Up @@ -6427,6 +6448,14 @@ A jump table for the options with a short description can be found at |Q_op|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

*'osctimeoutlen'* *'ost'* *E1568*
'osctimeoutlen' 'ost' number (default 1000)
global
This option specifies the timeout in milliseconds Vim should wait
until it receives an OSC terminator after receiving the beginning of
an OSC command response. See the |TermResponseAll| autocommand event
and |v:termosc| for more information.

*'osfiletype'* *'oft'*
'osfiletype' 'oft' string (default: "")
local to buffer
Expand Down Expand Up @@ -8867,8 +8896,7 @@ A jump table for the options with a short description can be found at |Q_op|.
< You need to do this when your system has no locale support for UTF-8.

*'termguicolors'* *'tgc'* *'notermguicolors'* *'notgc'* *E954*
'termguicolors' 'tgc' boolean (default off unless Vim detects that it runs
in a capable terminal)
'termguicolors' 'tgc' boolean (default off)
global
{not available when compiled without the
|+termguicolors| feature}
Expand Down Expand Up @@ -10167,7 +10195,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