Skip to content

Update options.{txt,jax} #2427

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 3 commits into from
Nov 28, 2025
Merged

Update options.{txt,jax} #2427

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1bb953a
Update options.{txt,jax}
h-east Nov 25, 2025
be79743
Update by original
h-east Nov 27, 2025
16058e4
Update by original and Added forgotten commit
h-east Nov 28, 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
60 changes: 36 additions & 24 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 Nov 09
*options.txt* For Vim バージョン 9.1. Last change: 2025 Nov 26


VIM リファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -1721,12 +1721,15 @@ Note 1番目の形式では、行全体がオプション指定に使われる
|file-searching| も参照。
既定値は環境変数 $CDPATH から取り込まれるが、カレントディレクトリを最
初に探すために "," が先頭に挿入される。
$CDPATH から取り込まれたものが望ましくないときは、値を上書きするために、
次のコマンドを適当に修正し、ユーザーのファイル vimrc に加えること: >
$CDPATH から取り込まれたものが望ましくないときは、値を上書きするため
に、次のコマンドを適当に修正し、ユーザーのファイル vimrc に加えること:
>
:let &cdpath = ',' .. substitute(substitute($CDPATH, '[, ]', '\\\0', 'g'), ':', ',', 'g')
< セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。('cdpath' の値の一部は、ファイル名を展開す
るためにシェルに渡すことができる)。
< 環境変数は |:set_env| によって展開される。
このオプションは、セキュリティ上の理由により、|modeline| または
|sandbox| からは設定できない。
('cdpath' の値の一部は、ファイル名を展開するためにシェルに渡すことがで
きる)。

*'cedit'*
'cedit' 文字列 (Viの既定値: "", Vimの既定値: CTRL-F)
Expand Down Expand Up @@ -1894,10 +1897,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
"unnamed" も同時に指定した場合は、コピー操作 (削除、変
更、ペースト以外の操作) で、レジスタ '*' にもテキスト
がコピーされる。Wayland が使用されており、コンポジタが
primary-selection-unstable-v1 プロトコルをサポートして
いない場合、代わりに通常のセレクションが使用される。
|+X11| または |+wayland_clipboard| 機能でのみ使用可能
である。使用可能かどうかは以下で確認できる: >
プライマリ選択をサポートしていない場合は、代わりに通常
の選択が使用される。|+X11| または |+wayland_clipboard|
機能でのみ使用可能である。使用可能かどうかは以下で確認
できる: >
if has('unnamedplus')
<
*clipboard-autoselect*
Expand Down Expand Up @@ -2040,7 +2043,6 @@ Note 1番目の形式では、行全体がオプション指定に使われる
*'commentstring'* *'cms'* *E537*
'commentstring' 'cms' 文字列 (既定では "/* %s */")
バッファについてローカル
{|+folding| 機能付きでコンパイルされたときのみ有効}
コメント用のテンプレート (雛形)。値内の "%s" はコメントテキストに置き
換えられ、可能な限りスペースでパディングされるべきである。現在のとこ
ろ、折り畳み用のマーカーを追加するために使用されている。|fold-marker|
Expand Down Expand Up @@ -2256,11 +2258,14 @@ Note 1番目の形式では、行全体がオプション指定に使われる
*'completefuzzycollect'* *'cfc'*
'completefuzzycollect' 'cfc' 文字列 (既定では空)
グローバル
特定の |ins-completion| モードでファジー収集を有効にする文字列のコンマ
区切りのリスト。補完中にマッチが収集される方法に影響する。指定された
モードでは標準のプリフィックスベースのマッチングではなく、ファジーマッ
チングを使用して補完候補が検索される。このオプションには以下の値を含め
ることができる:
DEPRECATED: このオプションは現在は使用されていないため、変更しても効果
はない。
'completeopt' に "fuzzy" が含まれている場合、Vim は内部的に次と同等の
ものを使用する:
"keyword,files,whole_line"

以下の値は互換性のため、およびこのオプションを読み取る可能性のあるスク
リプトのために保持される:

keyword カレントファイル内のキーワード |i_CTRL-X_CTRL-N|
'complete' 内のフラグ "."、 |i_CTRL-N| |i_CTRL-P|
Expand All @@ -2271,10 +2276,6 @@ Note 1番目の形式では、行全体がオプション指定に使われる

whole_line 行全体 |i_CTRL-X_CTRL-L|

'completeopt' の "longest" オプション値を使用すると、ファジー収集は最
適なファジーマッチの中から最長の共通文字列を識別し、それを自動的に挿入
できる。

*'completeitemalign'* *'cia'*
'completeitemalign' 'cia' 文字列 (既定では "abbr,kind,menu")
グローバル
Expand Down Expand Up @@ -3099,6 +3100,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
ファイル名にコンマを含めるには、コンマの前に '\' を置くこと。コンマの
後ろの空白は無視されるが、それ以外の空白はファイル名の一部として扱われ
る。'\' の使い方については |option-backslash| を参照すること。
環境変数は |:set_env| によって展開される。
このオプションは変数の辞書型|Dictionary|とは関係ない。
単語リストはどこで見つかるか？
- FreeBSDでは、"/usr/share/dict/words" というファイルがある。
Expand Down Expand Up @@ -6170,7 +6172,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
:set mkspellmem=900000,3000,800
< 512 Mbyte より少ないメモリしか持っていないなら、'mkspellmem' がどんな
値であっても、ある言語に対しては |:mkspell|が失敗するかもしれない。

環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -6587,6 +6589,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
*'packpath'* *'pp'*
'packpath' 'pp' 文字列 (既定では: 'runtimepath' を参照)
パッケージを見つけるために使われるディレクトリ。 |packages| を参照。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -7387,6 +7390,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
レクトリは、環境変数 $VIMRUNTIME の後に指定すればよい。
Vim が |--clean| 付きで開始される場合、ホームディレクトリのエントリは
含まれない。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -8221,6 +8225,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
加することもできる。しかしその場合、'spellfile' がそのファイル名に設定
されているときだけ使われる。'spelllang' のエントリに対しては地域名を省
いたファイルだけが使われる。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -8338,7 +8343,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
"best", "double", "fast" は、どれか1つだけ指定できる。他のものはどんな
順序で何回指定してもよい。例: >
:set sps=file:~/.vim/sugg,best,expr:MySuggest()
<
< 環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -9191,8 +9196,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
値に空白や '\' を含める方法については、|option-backslash| を参照。リス
トにディレクトリを追加または削除する場合は |:set+=| および |:set-=| を
使うのがよい。こうすると将来のバージョンで異なった既定値が使われるよう
になったときに、問題が起きるのを防げる。セキュリティ上の理由から、バッ
ククォート (`) をこのオプションの値に使うことはできない。
になったときに、問題が起きるのを防げる。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、バッククォート (`) をこのオプションの値に使
うことはできない。

*'thesaurusfunc'* *'tsrfu'*
'thesaurusfunc' 'tsrfu' 文字列 (既定では空)
Expand Down Expand Up @@ -9526,6 +9533,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
'ttytype' 'tty' 文字列 (既定値は $TERM によって決まる)
グローバル
上記のオプション 'term' の別名。
環境変数は |:set_env| によって展開される。

*'undodir'* *'udir'*
'undodir' 'udir' 文字列 (既定値は ".")
Expand All @@ -9544,6 +9552,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
に見つかったファイルが使用される。見つかったファイルが読めなかったりエ
ラーが発生したりしても、それ以降のエントリは使用されない。
|undo-persistence| 参照。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -9695,6 +9704,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
'verbosefile' を新しい値に設定すると、最初に空に設定したのと同じことに
なる。|:redir|との違いは、'verbosefile' が設定されているとき冗長なメッ
セージは画面に表示されないことである。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand All @@ -9708,6 +9718,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
{|+mksession| 機能付きでコンパイルされたときのみ有効}
コマンド |:mkview| によるファイルを格納するディレクトリの名前。
$XDG_CONFIG_HOME については、|xdg-base-dir| を参照。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -9855,6 +9866,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
"NONE" のとき、viminfo の読み込みも書き込みもされない。
このオプションはコマンドラインの |-i| フラグで設定することができる。
コマンドラインからの |--clean| フラグはこれを "NONE" に設定する。
環境変数は |:set_env| によって展開される。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down
25 changes: 17 additions & 8 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 Nov 09
*options.txt* For Vim version 9.1. Last change: 2025 Nov 23


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -1670,7 +1670,8 @@ A jump table for the options with a short description can be found at |Q_op|.
a modified version of the following command in your vimrc file to
override it: >
:let &cdpath = ',' .. substitute(substitute($CDPATH, '[, ]', '\\\0', 'g'), ':', ',', 'g')
< This option cannot be set from a |modeline| or in the |sandbox|, for
< Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.
(parts of 'cdpath' can be passed to the shell to expand file names).

Expand Down Expand Up @@ -1991,8 +1992,6 @@ A jump table for the options with a short description can be found at |Q_op|.
*'commentstring'* *'cms'* *E537*
'commentstring' 'cms' string (default "/* %s */")
local to buffer
{not available when compiled without the |+folding|
feature}
A template for a comment. The "%s" in the value is replaced with the
comment text, and should be padded with a space when possible.
Currently used to add markers for folding, see |fold-marker|. Also
Expand Down Expand Up @@ -3066,6 +3065,7 @@ A jump table for the options with a short description can be found at |Q_op|.
To include a comma in a file name precede it with a backslash. Spaces
after a comma are ignored, otherwise spaces are included in the file
name. See |option-backslash| about using backslashes.
Environment variables are expanded |:set_env|.
This has nothing to do with the |Dictionary| variable type.
Where to find a list of words?
- On FreeBSD, there is the file "/usr/share/dict/words".
Expand Down Expand Up @@ -6118,7 +6118,7 @@ A jump table for the options with a short description can be found at |Q_op|.
:set mkspellmem=900000,3000,800
< If you have less than 512 Mbyte |:mkspell| may fail for some
languages, no matter what you set 'mkspellmem' to.

Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -6541,6 +6541,7 @@ A jump table for the options with a short description can be found at |Q_op|.
*'packpath'* *'pp'*
'packpath' 'pp' string (default: see 'runtimepath')
Directories used to find packages. See |packages|.
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -7365,6 +7366,7 @@ A jump table for the options with a short description can be found at |Q_op|.
runtime files.
When Vim is started with |--clean| the home directory entries are not
included.
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -8197,6 +8199,7 @@ A jump table for the options with a short description can be found at |Q_op|.
name if you want to. However, it will then only be used when
'spellfile' is set to it, for entries in 'spelllang' only files
without region name will be found.
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -8324,7 +8327,7 @@ A jump table for the options with a short description can be found at |Q_op|.
Only one of "best", "double" or "fast" may be used. The others may
appear several times in any order. Example: >
:set sps=file:~/.vim/sugg,best,expr:MySuggest()
<
< Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -9161,8 +9164,9 @@ A jump table for the options with a short description can be found at |Q_op|.
name. See |option-backslash| about using backslashes. The use of
|:set+=| and |:set-=| is preferred when adding or removing directories
from the list. This avoids problems when a future version uses
another default. Backticks cannot be used in this option for security
reasons.
another default.
Environment variables are expanded |:set_env|.
Backticks cannot be used in this option for security reasons.

*'thesaurusfunc'* *'tsrfu'*
'thesaurusfunc' 'tsrfu' string (default: empty)
Expand Down Expand Up @@ -9490,6 +9494,7 @@ A jump table for the options with a short description can be found at |Q_op|.
'ttytype' 'tty' string (default from $TERM)
global
Alias for 'term', see above.
Environment variables are expanded |:set_env|.

*'undodir'* *'udir'*
'undodir' 'udir' string (default ".")
Expand All @@ -9507,6 +9512,7 @@ A jump table for the options with a short description can be found at |Q_op|.
undo file that exists is used. When it cannot be read an error is
given, no further entry is used.
See |undo-persistence|.
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -9658,6 +9664,7 @@ A jump table for the options with a short description can be found at |Q_op|.
Setting 'verbosefile' to a new value is like making it empty first.
The difference with |:redir| is that verbose messages are not
displayed when 'verbosefile' is set.
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand All @@ -9672,6 +9679,7 @@ A jump table for the options with a short description can be found at |Q_op|.
feature}
Name of the directory where to store files for |:mkview|.
For $XDG_CONFIG_HOME see |xdg-base-dir|.
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -9827,6 +9835,7 @@ A jump table for the options with a short description can be found at |Q_op|.
When equal to "NONE" no viminfo file will be read or written.
This option can be set with the |-i| command line flag. The |--clean|
command line flag sets it to "NONE".
Environment variables are expanded |:set_env|.
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down