diff --git a/doc/options.jax b/doc/options.jax index 9a0d17c07..12a02ecb3 100644 --- a/doc/options.jax +++ b/doc/options.jax @@ -1,4 +1,4 @@ -*options.txt* For Vim バージョン 9.1. Last change: 2025 Jul 25 +*options.txt* For Vim バージョン 9.1. Last change: 2025 Aug 06 VIMリファレンスマニュアル by Bram Moolenaar @@ -1062,7 +1062,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる < Vimはその値を推測する。GUI版ならばうまくいくはずだが、そうでなければ正 しい値を推測できないかもしれない。 GUIがダークテーマをサポートしている場合、'guioptions' で "d" フラグを - 使用できる。'go-d' を参照。 + 使用できる。|'go-d'| を参照。 |t_RB| オプションが設定されると、Vim はターミナルから背景色をリクエス トするために使われる。もしも返された RGB の値が dark/light であり、 @@ -2273,8 +2273,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる つけることができる。Note: このオプションは候補リストの収集 には影響しない。補完候補が代替リストからどのように削減され るかを制御するだけである。|fuzzy-matching| を使用して候補 - リストの代替をさらに収集する場合は、 - |'completefuzzycollect'| を参照。 + リストの代替をさらに収集する場合は、'completefuzzycollect' + を参照。 longest 候補の文字列の最長の共通部分だけを挿入する。メニューが表示 されているならばCTRL-Lでさらに文字を挿入することができる。 @@ -2311,7 +2311,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる popup 現在選択されている補完に関する追加情報をポップアップウィン ドウに表示する。"menu" または "menuone" との組み合わせでの み機能する。"preview" を無視する。 - 指定するプロパティについては |'completepopup'| を参照。 + 指定するプロパティについては 'completepopup' を参照。 {|+textprop| 機能付きでコンパイルされたときのみ有効} popuphidden @@ -2429,7 +2429,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる 'copyindent' 'ci' 切替 (既定ではオフ) バッファについてローカル 新規行を自動インデントするとき、既存の行のインデント構造をコピーする。 - 普通、新しい行のインデントは |'expandtab'| が有効になっていないかぎり + 普通、新しい行のインデントは 'expandtab' が有効になっていないかぎり (この場合は全てスペースになる)、まずタブが使われ、足りない部分がスペー スで埋められる。このオプションを有効にすると、既存の行のインデントにど んな文字が使われていようとそれを新規行にコピーする。'expandtab' はこれ @@ -5655,9 +5655,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる *'lispoptions'* *'lop'* 'lispoptions' 'lop' 文字列 (既定では "") バッファについてローカル - |'lisp'| オプションとともに有効化された場合、Lisp のインデントに影響を - 与える項目のコンマ区切りのリスト。現在サポートされている項目は 1 つだ - けである。 + 'lisp' オプションとともに有効化された場合、Lisp のインデントに影響を与 + える項目のコンマ区切りのリスト。現在サポートされている項目は 1 つだけ + である。 expr:1 設定されている場合、Lisp のインデントに 'indentexpr' を 使用する expr:0 Lisp のインデントに 'indentexpr' を使用しない (デフォ @@ -5668,8 +5668,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる *'lispwords'* *'lw'* 'lispwords' 'lw' 文字列 (既定値はとても長い) グローバル／バッファについてローカル |global-local| - |'lisp'| オプションとともに有効化された場合、Lisp用のインデント方法を - 設定するキーワードの、コンマ区切りのリスト。 + 'lisp' オプションとともに有効化された場合、Lisp用のインデント方法を設 + 定するキーワードの、コンマ区切りのリスト。 *'list'* *'nolist'* 'list' 切替 (既定ではオフ) @@ -6151,7 +6151,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる マウスを有効にしていなくても、GUI版ではモードレスセレクションにマウス を使うことができる。しかしこのときにはカーソルは動かない。 - |mouse-using| を参照。またオプション 'clipboard' も参照。 + |mouse-using| を参照。またオプション 'clipboard' も参照。 Note: ターミナルでマウスを有効にすると、Xサーバーにアクセスできるなら ばコピー／貼り付けではレジスタ "* を使うことに注意。マウスボタンの @@ -6640,7 +6640,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる バッファについてローカル カレント行のインデントを変更するとき、可能な限りインデントの構造を保つ ようにする。普通、インデントはまずタブで埋められ、その後に必要なだけス - ペースで埋められる(|'expandtab'|がオンになっているときは違い、スペース + ペースで埋められる('expandtab' がオンになっているときは違い、スペース だけで埋められる)。このオプションをオンにすると、インデントの既存の文 字をできるだけそのままにし、追加の際に必要なだけタブやスペースを追加す るようになる。 @@ -7682,7 +7682,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる *'shiftwidth'* *'sw'* 'shiftwidth' 'sw' 数値 (既定では 8) バッファについてローカル - 1 レベルの (自動) インデントを構成する桁数。|'cindent'|、|<<|、|>>| な + 1 レベルの (自動) インデントを構成する桁数。'cindent'、|<<|、|>>| な どで使用される。 0 に設定すると、Vim は現在の 'tabstop' 値を使用する。スクリプト内で有 効な値を取得するには、|shiftwidth()| を使用する。 @@ -8027,7 +8027,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる る。詳細な説明については、|ins-expandtab| およびユーザーマニュアルのセ クション |30.5| も参照。 - Vim が |+vartabs| 機能付きでコンパイルされている場合、|'varsofttabstop'| + Vim が |+vartabs| 機能付きでコンパイルされている場合、'varsofttabstop' が空文字列以外の何かに設定されていると 'softtabstop' の値は無視される。 *'spell'* *'nospell'* @@ -9387,7 +9387,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる {|+persistent_undo| 機能付きでコンパイルされたときのみ 有効} アンドゥファイル用のディレクトリをコンマ区切りのリストで指定する。 - 書式についての詳細は |'backupdir'| を参照。 + 書式についての詳細は 'backupdir' を参照。 "." はファイルのディレクトリを意味する。アンドゥファイルの名前は例えば "file.txt" なら ".file.txt.un~" になる。 別ディレクトリに保存される場合は、アンドゥファイルの名前は対象のファイ @@ -9836,7 +9836,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる < 'wildchar' は、|/|、|?|、|:s|、|:g|、|:v|、|:vim| などの検索パターンコ ンテキストでも補完を有効にする。補完をトリガーする代わりに、文字の を挿入するには、 または "\t" と入力する。 - |'wildoptions'| および |wildtrigger()| も参照。 + 'wildoptions' および |wildtrigger()| も参照。 NOTE: このオプションは 'compatible' がオンになると Vi の既定値に設定さ れ、'compatible' がオフになると Vim の既定値に設定されるので注意。 diff --git a/en/options.txt b/en/options.txt index a9ebaec19..7a12ee12b 100644 --- a/en/options.txt +++ b/en/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 9.1. Last change: 2025 Jul 25 +*options.txt* For Vim version 9.1. Last change: 2025 Aug 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1035,7 +1035,7 @@ A jump table for the options with a short description can be found at |Q_op|. < Vim will guess the value. In the GUI this should work correctly, in other cases Vim might not be able to guess the right value. If the GUI supports a dark theme, you can use the "d" flag in - 'guioptions', see 'go-d'. + 'guioptions', see |'go-d'|. When the |t_RB| option is set, Vim will use it to request the background color from the terminal. If the returned RGB value is dark/light and @@ -1589,7 +1589,7 @@ A jump table for the options with a short description can be found at |Q_op|. "nofile" and "nowrite" buffers are similar: both: The buffer is not to be written to disk, ":w" doesn't work (":w filename" does work though). - both: The buffer is never considered to be |'modified'|. + both: The buffer is never considered to be 'modified'. There is no warning when the changes will be lost, for example when you quit Vim. both: A swap file is only created when using too much memory @@ -1642,7 +1642,7 @@ A jump table for the options with a short description can be found at |Q_op|. searched for has a relative path, not an absolute part starting with "/", "./" or "../", the 'cdpath' option is not used then. The 'cdpath' option's value has the same form and semantics as - |'path'|. Also see |file-searching|. + 'path'. Also see |file-searching|. The default value is taken from $CDPATH, with a "," prepended to look in the current directory first. If the default value taken from $CDPATH is not what you want, include @@ -2228,7 +2228,7 @@ A jump table for the options with a short description can be found at |Q_op|. controls how completion candidates are reduced from the list of alternatives. If you want to use |fuzzy-matching| to gather more alternatives for your candidate list, - see |'completefuzzycollect'|. + 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 @@ -2265,7 +2265,7 @@ A jump table for the options with a short description can be found at |Q_op|. popup Show extra information about the currently selected completion in a popup window. Only works in combination with "menu" or "menuone". Overrides "preview". - See |'completepopup'| for specifying properties. + See 'completepopup' for specifying properties. {only works when compiled with the |+textprop| feature} popuphidden @@ -2386,7 +2386,7 @@ A jump table for the options with a short description can be found at |Q_op|. local to buffer Copy the structure of the existing lines indent when autoindenting a new line. Normally the new indent is reconstructed by a series of - tabs followed by spaces as required (unless |'expandtab'| is enabled, + tabs followed by spaces as required (unless 'expandtab' is enabled, in which case only spaces are used). Enabling this option makes the new line copy whatever characters were used for indenting on the existing line. 'expandtab' has no effect on these characters, a Tab @@ -2537,7 +2537,7 @@ A jump table for the options with a short description can be found at |Q_op|. *cpo-m* m When included, a showmatch will always wait half a second. When not included, a showmatch will wait half - a second or until a character is typed. |'showmatch'| + a second or until a character is typed. 'showmatch' *cpo-M* M When excluded, "%" matching will take backslashes into account. Thus in "( \( )" and "\( ( \)" the outer @@ -5609,8 +5609,7 @@ A jump table for the options with a short description can be found at |Q_op|. 'lispoptions' 'lop' string (default "") local to buffer Comma-separated list of items that influence the Lisp indenting when - enabled with the |'lisp'| option. Currently only one item is - supported: + enabled with the 'lisp' option. Currently only one item is supported: expr:1 use 'indentexpr' for Lisp indenting when it is set expr:0 do not use 'indentexpr' for Lisp indenting (default) Note that when using 'indentexpr' the `=` operator indents all the @@ -5620,7 +5619,7 @@ A jump table for the options with a short description can be found at |Q_op|. 'lispwords' 'lw' string (default is very long) global or local to buffer |global-local| Comma-separated list of words that influence the Lisp indenting when - enabled with the |'lisp'| option. + enabled with the 'lisp' option. *'list'* *'nolist'* 'list' boolean (default off) @@ -6112,7 +6111,7 @@ A jump table for the options with a short description can be found at |Q_op|. When the mouse is not enabled, the GUI will still use the mouse for modeless selection. This doesn't move the text cursor. - See |mouse-using|. Also see |'clipboard'|. + See |mouse-using|. Also see 'clipboard'. Note: When enabling the mouse in a terminal, copy/paste will use the "* register if there is access to an X-server. The xterm handling of @@ -6603,7 +6602,7 @@ A jump table for the options with a short description can be found at |Q_op|. local to buffer When changing the indent of the current line, preserve as much of the indent structure as possible. Normally the indent is replaced by a - series of tabs followed by spaces as required (unless |'expandtab'| is + series of tabs followed by spaces as required (unless 'expandtab' is enabled, in which case only spaces are used). Enabling this option means the indent will preserve as many existing characters as possible for indenting, and only add additional tabs or spaces as required. @@ -7238,7 +7237,7 @@ A jump table for the options with a short description can be found at |Q_op|. current window also scrolls other scrollbind windows (windows that also have this option set). This option is useful for viewing the differences between two versions of a file, see 'diff'. - See |'scrollopt'| for options that determine how this option should be + See 'scrollopt' for options that determine how this option should be interpreted. This option is mostly reset when splitting a window to edit another file. This means that ":split | edit file" results in two windows @@ -7658,7 +7657,7 @@ A jump table for the options with a short description can be found at |Q_op|. 'shiftwidth' 'sw' number (default 8) local to buffer Number of columns that make up one level of (auto)indentation. Used - by |'cindent'|, |<<|, |>>|, etc. + by 'cindent', |<<|, |>>|, etc. If set to 0, Vim uses the current 'tabstop' value. Use |shiftwidth()| to obtain the effective value in scripts. @@ -7881,7 +7880,7 @@ A jump table for the options with a short description can be found at |Q_op|. global or local to window |global-local| The minimal number of screen columns to keep to the left and to the right of the cursor if 'nowrap' is set. Setting this option to a - value greater than 0 while having |'sidescroll'| also at a non-zero + value greater than 0 while having 'sidescroll' also at a non-zero value makes some context visible in the line you are scrolling in horizontally (except at beginning of the line). Setting this option to a large value (like 999) has the effect of keeping the cursor @@ -7893,9 +7892,9 @@ A jump table for the options with a short description can be found at |Q_op|. setlocal sidescrolloff=-1 < NOTE: This option is set to 0 when 'compatible' is set. - Example: Try this together with 'sidescroll' and 'listchars' as - in the following example to never allow the cursor to move - onto the "extends" character: > + Example: Try this together with 'sidescroll' and 'listchars' as in the + following example to never allow the cursor to move onto the + "extends" character: > :set nowrap sidescroll=1 listchars=extends:>,precedes:< :set sidescrolloff=1 @@ -7999,8 +7998,8 @@ A jump table for the options with a short description can be found at |Q_op|. in-depth explanations. If Vim is compiled with the |+vartabs| feature then the value of - 'softtabstop' will be ignored if |'varsofttabstop'| is set to - anything other than an empty string. + 'softtabstop' will be ignored if 'varsofttabstop' is set to anything + other than an empty string. *'spell'* *'nospell'* 'spell' boolean (default off) @@ -8443,12 +8442,12 @@ A jump table for the options with a short description can be found at |Q_op|. Careful: All text will be in memory: - Don't use this for big files. - Recovery will be impossible! - A swapfile will only be present when |'updatecount'| is non-zero and + A swapfile will only be present when 'updatecount' is non-zero and 'swapfile' is set. When 'swapfile' is reset, the swap file for the current buffer is immediately deleted. When 'swapfile' is set, and 'updatecount' is non-zero, a swap file is immediately created. - Also see |swap-file| and |'swapsync'|. + Also see |swap-file| and 'swapsync'. If you want to open a new buffer without creating a swap file for it, use the |:noswapfile| modifier. See 'directory' for where the swap file is created. @@ -8653,7 +8652,7 @@ A jump table for the options with a short description can be found at |Q_op|. character (ASCII 9); a Horizontal Tab always advances to the next tab stop. The value must be at least 1 and at most 9999. - If Vim was compiled with |+vartabs| and |'vartabstop'| is set, this + If Vim was compiled with |+vartabs| and 'vartabstop' is set, this option is ignored. Leave it at 8 unless you have a strong reason (see usr |30.5|). @@ -9115,7 +9114,7 @@ A jump table for the options with a short description can be found at |Q_op|. When Vim was compiled with HAVE_X11 defined, the original title will be restored if possible. The output of ":version" will include "+X11" when HAVE_X11 was defined, otherwise it will be "-X11". This also - works for the icon name |'icon'|. + works for the icon name 'icon'. But: When Vim was started with the |-X| argument, restoring the title will not work (except in the GUI). If the title cannot be restored, it is set to the value of 'titleold'. @@ -9348,7 +9347,7 @@ A jump table for the options with a short description can be found at |Q_op|. global {only when compiled with the |+persistent_undo| feature} List of directory names for undo files, separated with commas. - See |'backupdir'| for details of the format. + See 'backupdir' for details of the format. "." means using the directory of the file. The undo file name for "file.txt" is ".file.txt.un~". For other directories the file name is the full path of the edited @@ -9420,13 +9419,13 @@ A jump table for the options with a short description can be found at |Q_op|. recovery |crash-recovery|). 'updatecount' is set to zero by starting Vim with the "-n" option, see |startup|. When editing in readonly mode this option will be initialized to 10000. - The swapfile can be disabled per buffer with |'swapfile'|. + The swapfile can be disabled per buffer with 'swapfile'. When 'updatecount' is set from zero to non-zero, swap files are created for all buffers that have 'swapfile' set. When 'updatecount' is set to zero, existing swap files are not deleted. - Also see |'swapsync'|. - This option has no meaning in buffers where |'buftype'| is "nofile" - or "nowrite". + Also see 'swapsync'. + This option has no meaning in buffers where 'buftype' is "nofile" or + "nowrite". *'updatetime'* *'ut'* 'updatetime' 'ut' number (default 4000)