Skip to content

Update options.{txt,jax} #2616

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
h-east wants to merge 2 commits into
base: master
Choose a base branch
from
+55 −8
Open

Update options.{txt,jax} #2616

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b4b50db
Update options.{txt,jax}
h-east May 4, 2026
e8e4ad1
Update by original
h-east May 5, 2026
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
32 changes: 28 additions & 4 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.2. Last change: 2026 Apr 28
*options.txt* For Vim バージョン 9.2. Last change: 2026 May 04


VIM リファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -2441,8 +2441,11 @@ Note 1番目の形式では、行全体がオプション指定に使われる
close 閉じるボタンを表示: "on" (デフォルト) または
"off"
height ポップアップの最大高さ
highlight ポップアップのハイライトグループ (default:
highlight ポップアップのハイライトグループ (デフォルト:
PmenuSel)
opacity 不透明度のパーセンテージ 0-100 (デフォルトは
100 で、完全に不透明)。100 未満の場合、ポップ
アップの下にあるコンテンツが透けて見える。
resize サイズ変更ハンドルを表示: "on" (デフォルト) ま
たは "off"
shadow |hl-PmenuShadow| を使用する。"off" (デフォルト)
Expand All @@ -2452,6 +2455,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
例: >
:set completepopup=height:10,border:single,highlight:InfoPopup
:set completepopup=width:60,border:custom:─;│;─;│;┌;┐;┘;└
:set completepopup=border:round,opacity:80
<
"align" を "item" に設定すると、ポップアップは選択された項目の近くに配
置され、選択内容の変更に応じて移動する。
Expand Down Expand Up @@ -6837,6 +6841,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる
< 文字 ';' を ':' または指定可能な区切り文字で置換する。 Note この方法
は、$INCL がコンマや空白を含んでいるときには使えないので注意。

セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

*'perldll'*
'perldll' 文字列 (既定値はビルドに依存)
グローバル
Expand Down Expand Up @@ -7042,6 +7049,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
opacity:{n} 不透明度のパーセント 0-100 (デフォルト 100)。
100 未満の場合、ポップアップメニュー越しに背後
のコンテンツが透けて見える。
GUI、'termguicolors' または 256 色対応端末が必
要である。

フラグ (値なし):
margin 左右のボーダーの内側に 1 セル分のスペースを追
Expand Down Expand Up @@ -8071,6 +8080,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる
統計の前に "W" (覚え方: Wrapped) 文字のみで示される。最大制限
数は 'maxsearchcount' オプションで設定できる。|searchcount()|
関数も参照。
u 以下のようなアンドゥ/リドゥメッセージを表示しない *shm-u*
"1 line less; before #1 1 second ago"、
"Already at oldest change" または "Already at newest change"

このオプションはバッファを変更するとき <Enter> を打ち込むのを避ける機
会を提供する。が、表示の余裕がある限り有益なメッセージを表示する。
Expand Down Expand Up @@ -10066,6 +10078,14 @@ Note 1番目の形式では、行全体がオプション指定に使われる
ないグローバル変数を保存・復元する。つまり "KEEPTHIS" と
"K_L_M" は保存されるが、"KeepThis" と "_K_L_M" は保存されない。
入れ子になったリストと辞書は正しく復元されず、空文字列になる。

|List|、|Dictionary|、|Tuple| 変数の復元は、Vim 式評価器でテキ
スト形式を解析することによって行われる。したがって、"!" を有効
にした状態で viminfo ファイルを読み込むのは、そのファイルが信
頼できる場合にのみ安全である。特に、他のユーザーから入手した
り、ダウンロードした、または他のアカウントで書き込み可能な
viminfo ファイルを読み込む前に、"!" を有効にしてはならない。
|viminfo-security| も参照。
*viminfo-quote*
" 各レジスタで保存される行数の最大値。これはフラグ '<' の古い表
記である。この表記の不利点は、(エスケープのために)バックスラッ
Expand Down Expand Up @@ -10413,8 +10433,12 @@ Note 1番目の形式では、行全体がオプション指定に使われる
る。
"noselect" 'wildmenu' が有効な場合、メニューは表示されるが、最初
の項目は事前に選択されない。
マッチするものが 1 つしかない場合は、"noselect" が指定されていない限り
完全に補完される。
"noinsert" 'wildmenu' が有効になっている場合、メニューを表示し、
最初に見つかったマッチ項目を事前に選択するが、コマンド
ラインには挿入しない。"noinsert" と "noselect" の両方
が指定されている場合は、"noselect" が優先される。
マッチするものが 1 つしかない場合は、"noselect" または "noinsert" が指
定されていない限り完全に補完される。

コロンで区切られた値の便利な組み合わせの例:
"longest:full" 最長共通の文字列から開始し、 'wildmenu' (有効
Expand Down
31 changes: 27 additions & 4 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.2. Last change: 2026 Apr 28
*options.txt* For Vim version 9.2. Last change: 2026 May 04


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -2393,13 +2393,17 @@ A jump table for the options with a short description can be found at |Q_op|.
close show close button: "on" (default) or "off"
height maximum height of the popup
highlight popup highlight group (default: PmenuSel)
opacity opacity percentage 0-100 (default 100, fully
opaque). When less than 100, content beneath
the popup shows through.
resize show resize handle: "on" (default) or "off"
shadow "off" (default) or "on" using |hl-PmenuShadow|
width maximum width of the popup

Example: >
:set completepopup=height:10,border:single,highlight:InfoPopup
:set completepopup=width:60,border:custom:─;│;─;│;┌;┐;┘;└
:set completepopup=border:round,opacity:80
<
When "align" is set to "item", the popup is positioned near the
selected item and moves as the selection changes.
Expand Down Expand Up @@ -6795,6 +6799,9 @@ A jump table for the options with a short description can be found at |Q_op|.
< Replace the ';' with a ':' or whatever separator is used. Note that
this doesn't work when $INCL contains a comma or white space.

This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

*'perldll'*
'perldll' string (default depends on the build)
global
Expand Down Expand Up @@ -7007,7 +7014,8 @@ A jump table for the options with a short description can be found at |Q_op|.
of 'fillchars' option.
opacity:{n} opacity percentage 0-100 (default 100).
When less than 100, background content shows
through the popup menu.
through the popup menu. Requires the GUI,
'termguicolors', or a 256-color terminal.

Flags (no value):
margin adds one-cell spacing inside the left and
Expand Down Expand Up @@ -8044,6 +8052,9 @@ A jump table for the options with a short description can be found at |Q_op|.
search count statistics. The maximum limit can be set with
the 'maxsearchcount' option, see also |searchcount()|
function.
u don't give undo and redo messages like *shm-u*
"1 line less; before #1 1 second ago", "Already at oldest
change" or "Already at newest change"

This gives you the opportunity to avoid that a change between buffers
requires you to hit <Enter>, but still gives as useful a message as
Expand Down Expand Up @@ -10041,6 +10052,14 @@ A jump table for the options with a short description can be found at |Q_op|.
letter. Thus "KEEPTHIS and "K_L_M" are stored, but "KeepThis"
and "_K_L_M" are not. Nested List and Dict items may not be
read back correctly, you end up with an empty item.

Restoring |List|, |Dictionary| and |Tuple| variables is done by
parsing their textual form with the Vim expression evaluator.
Reading a viminfo file with "!" enabled is therefore only safe
when the file is trusted. In particular, do not enable "!"
before reading a viminfo file you obtained from another user,
downloaded, or that is writable by another account. See
also |viminfo-security|.
*viminfo-quote*
" Maximum number of lines saved for each register. Old name of
the '<' item, with the disadvantage that you need to put a
Expand Down Expand Up @@ -10398,8 +10417,12 @@ A jump table for the options with a short description can be found at |Q_op|.
applies to buffer name completion.
"noselect" If 'wildmenu' is enabled, show the menu but do not
preselect the first item.
If only one match exists, it is completed fully, unless "noselect" is
specified.
"noinsert" If 'wildmenu' is enabled, show the menu and preselect
the first match, but do not insert it in the command
line. If both "noinsert" and "noselect" are present,
"noselect" takes precedence.
If only one match exists, it is completed fully, unless "noselect" or
"noinsert" is specified.

Some useful combinations of colon-separated values:
"longest:full" Start with the longest common string and show
Expand Down