Skip to content

Update options.{txt,jax} #2172

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.

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 4 commits into from
Jul 22, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
33 changes: 31 additions & 2 deletions doc/options.jax
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*options.txt* For Vim バージョン 9.1. Last change: 2025 Jul 13
*options.txt* For Vim バージョン 9.1. Last change: 2025 Jul 21


VIMリファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -3009,6 +3009,25 @@ Note 1番目の形式では、行全体がオプション指定に使われる
カレントウィンドウをファイル間の差異を示すウィンドウのグループに組み入
れる。|vimdiff| を参照。

*'dia'* *'diffanchors'* *E1549*
'diffanchors' 'dia' 文字列 (既定では "")
グローバル/バッファについてローカル |global-local|
各バッファ内の {address} をコンマ区切りでリストする。これらは比較の際
にアンカーとして扱われる。最終行の 1 つ先を指定する際に "$+1" と記述す
ることは有効である。このオプションでは "%" は使用できない。各バッファ
には最大 20 個のアンカーを設定できる。

各アンカー行はバッファを分割する (分割はアンカー行の上で行われる)。各
部分は個別に比較され、最終結果が結合される。複数の {address} が指定さ
れた場合、アンカーは行番号で内部的にソートされる。バッファローカルなオ
プションを使用する場合、各バッファには同じ数のアンカーが必要である (余
分なアンカーは無視される)。このオプションは、'diffopt' に "anchor" が
設定されている場合にのみ使用される。詳細と例については |diff-anchors|
を参照。
*E1550*
{address} の一部が各バッファ内の行に解決されない場合 (例えば、何にも
マッチしないパターン検索)、どのアンカーも使用されない。

*'dex'* *'diffexpr'*
'diffexpr' 'dex' 文字列 (既定では "")
グローバル
Expand All @@ -3034,6 +3053,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
patience patience 差分アルゴリズム
histogram histogram 差分アルゴリズム

anchor 'diffanchors' が設定されている場合、各バッファ
内の特定の行を互いに揃えてアンカーする。
|diff-anchors| を参照。

closeoff 'diff' が設定されたウィンドウが閉じられ、同じ
タブページに 'diff' が設定されたウィンドウが
1 つだけ残っているとき、そのウィンドウで
Expand Down Expand Up @@ -3132,6 +3155,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
"linematch:60" である。これによりそれぞれ 30
行の 2 バッファ差分ハンク、またはそれぞれ 20
行の 3 バッファ差分ハンクの揃えが可能になる。
これを設定すると、暗黙的に "filler" が設定され
る。

vertical (他に明示的に指定されない限り)ウィンドウを垂直
分割して差分モードを開始する。
Expand Down Expand Up @@ -7505,6 +7530,10 @@ Note 1番目の形式では、行全体がオプション指定に使われる
うに '\' を置くことを忘れないこと。
将来はフィルタ処理にはパイプが使われるようになり、このオプションは時代
遅れになるだろう (少なくともUnixでは)。
Note: "| tee" のようなパイプを使用すると、シェルコマンドの終了コードが
失われる。これはシェルによって設定できる場合があるので、pipefail オプ
ションを探して欲しい (bash と zsh の場合は ":set -o pipefail" を使用す
る)。
セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
内で設定することはできない。

Expand Down Expand Up @@ -9795,7 +9824,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
< 'wildchar' は、|/|、|?|、|:s|、|:g|、|:v|、|:vim| などの検索パターンコ
ンテキストでも補完を有効にする。補完をトリガーする代わりに、文字の
<Tab> を挿入するには、<C-V><Tab> または "\t" と入力する。
|'wildoptions'| も参照。
|'wildoptions'| および |wildtrigger()| も参照。
NOTE: このオプションは 'compatible' がオンになると Vi の既定値に設定さ
れ、'compatible' がオフになると Vim の既定値に設定されるので注意。

Expand Down
33 changes: 31 additions & 2 deletions en/options.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*options.txt* For Vim version 9.1. Last change: 2025 Jul 13
*options.txt* For Vim version 9.1. Last change: 2025 Jul 21


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -2986,6 +2986,27 @@ A jump table for the options with a short description can be found at |Q_op|.
Join the current window in the group of windows that shows differences
between files. See |vimdiff|.

*'dia'* *'diffanchors'* *E1549*
'diffanchors' 'dia' string (default "")
global or local to buffer |global-local|
List of {address} in each buffer, separated by commas, that are
considered anchors when used for diffing. It's valid to specify "$+1"
for 1 past the last line. "%" cannot be used for this option. There
can be at most 20 anchors set for each buffer.

Each anchor line splits the buffer (the split happens above the
anchor), with each part being diff'ed separately before the final
result is joined. When more than one {address} are provided, the
anchors will be sorted interally by line number. If using buffer
local options, each buffer should have the same number of anchors
(extra anchors will be ignored). This option is only used when
'diffopt' has "anchor" set. See |diff-anchors| for more details and
examples.
*E1550*
If some of the {address} do not resolve to a line in each buffer (e.g.
a pattern search that does not match anything), none of the anchors
will be used.

*'dex'* *'diffexpr'*
'diffexpr' 'dex' string (default "")
global
Expand Down Expand Up @@ -3014,6 +3035,10 @@ A jump table for the options with a short description can be found at |Q_op|.
patience patience diff algorithm
histogram histogram diff algorithm

anchor Anchor specific lines in each buffer to be
aligned with each other if 'diffanchors' is
set. See |diff-anchors|.

closeoff When a window is closed where 'diff' is set
and there is only one window remaining in the
same tab page with 'diff' set, execute
Expand Down Expand Up @@ -3116,6 +3141,7 @@ A jump table for the options with a short description can be found at |Q_op|.
"linematch:60", as this will enable alignment
for a 2 buffer diff hunk of 30 lines each,
or a 3 buffer diff hunk of 20 lines each.
Implicitly sets "filler" when this is set.

vertical Start diff mode with vertical splits (unless
explicitly specified otherwise).
Expand Down Expand Up @@ -7477,6 +7503,9 @@ A jump table for the options with a short description can be found at |Q_op|.
Don't forget to precede the space with a backslash: ":set sp=\ ".
In the future pipes may be used for filtering and this option will
become obsolete (at least for Unix).
Note: When using a pipe like "| tee", you'll lose the exit code of the
shell command. This might be configurable by your shell, look for
the pipefail option (for bash and zsh, use ":set -o pipefail").
This option cannot be set from a |modeline| or in the |sandbox|, for
security reasons.

Expand Down Expand Up @@ -9768,7 +9797,7 @@ A jump table for the options with a short description can be found at |Q_op|.
< 'wildchar' also enables completion in search pattern contexts such as
|/|, |?|, |:s|, |:g|, |:v|, and |:vim|. To insert a literal <Tab>
instead of triggering completion, type <C-V><Tab> or "\t".
See also |'wildoptions'|.
See also 'wildoptions' and |wildtrigger()|.
NOTE: This option is set to the Vi default value when 'compatible' is
set and to the Vim default value when 'compatible' is reset.

Expand Down