*options.txt* For
Vim バージョン 7.3. Last change: 2012 Feb 22
VIM REFERENCE MANUAL by Bram Moolenaar
オプション
*options*
1. オプションの設定
|set-option|
2. オプションの自動設定
|auto-setting|
3. オプションの要約
|option-summary|
オプションの概要については、help.txt
|option-list| を参照。
Vimには、特別な働きをさせるための多くの内部変数とスイッチがある。それらのオプ
ションには3種類ある。
*boolean* *toggle*
切替 boolean オプション オンかオフかのどちらかの値をとる
数値 number オプション 数値の値を取る
文字列 string オプション 文字列の値を取る
(訳注: このヘルプの中で多く出てくる語句で、分かりにくいものを説明する。
- ローカルな:
あるバッファまたはウィンドウにのみ適用されるような、という意味。
- ローカルオプション:
あるバッファまたはウィンドウ内の設定のみを変え、その他のバッファまたは
ウィンドウの設定に影響しないようなオプション。
- ウィンドウについてローカルな:
あるウィンドウにのみ適用されるような、という意味。バッファについてロー
カルな、も同様な意味を持つ。
- グローバルな:
Vim全体に適用されるような、または、Vim全体で共通の値を使うような、とい
う意味。
上の4項目については
|option-summary| も参照。
- non-printable, unprintable:
文字が画面に表示可能なフォントに対応していないこと。具体的には
<CTRL>
などを押しながら入力した文字や
<ESC> が例である。主に制御に利用される。
訳語で、さらに相応しいものがあればご提案を下さい。)
==============================================================================
1. オプションの設定
*set-option* *E764*
*:se* *:set*
:se[t] 既定値と違う値のオプションを全て表示する。
:se[t] all ターミナルオプション以外の全てのオプションを表示する。
:se[t] termcap ターミナルオプションを全て表示する。
Note GUIバージョン
では、キーコードは表示されないので注意。なぜなら、キー
コードは内部的に生成され、変更が不可能だからだ。それに、
GUIバージョンでターミナルコードを変更するのは便利とは
言えない...
*E518* *E519*
:se[t]
{option}?
{option} の値を表示する。
:se[t]
{option} 切替オプション: セット、すなわちオンに切り替える。
数値オプション: 値を表示する。
文字列オプション: 値を表示する。
:se[t] no
{option} 切替オプション: リセット、すなわちオフに切り替える。
*:set-!* *:set-inv*
:se[t]
{option}! または
:se[t] inv
{option} 切替オプション: オンとオフを切り替える。
{Vi にはない}
*:set-default* *:set-&* *:set-&vi* *:set-&vim*
:se[t]
{option}& オプションを既定値に設定する。オプション
'compatible'
のその時点の値によって違うかもしれない。
{Vi にはない}
:se[t]
{option}&vi オプションをViの既定値に設定する。
{Vi にはない}
:se[t]
{option}&vim オプションをVimの既定値に設定する。
{Vi にはない}
:se[t] all& ターミナルオプション以外の全てのオプションを既定値に設
定する。オプション
'term',
'lines' と
'columns' の値は
変更されない。
{Vi にはない}
*:set-args* *E487* *E521*
:se[t]
{option}=
{value} または
:se[t]
{option}:
{value}
数値および文字列オプションの値を
{value} に設定する。
数値オプションの値は、10進数、(0x を頭に付けて) 16進数、
または ('0' を頭に付けて) 8進数で指定できる (16進数と8
進数は、関数 strtol() を持つマシンでのみ利用可能)。
オプション
'wildchar' で指定された文字 (既定では
<Tab>、オプション
'compatible' がオンにならば
CTRL-E)
を打ち込むと、古い値を挿入できる。
|cmdline-completion|
を参照。
{option} と '=' の間には空白を入れることができる。それ
らは無視される。'=' と
{value} の間に空白を入れてはい
けない。
{value} 内での空白や '\' の使用に関しては、
|option-backslash| を参照 (訳注: 文書先頭も参照)。
:se[t]
{option}+=
{value} *:set+=*
数値オプションに対しては
{value} だけその値を増す。文
字列オプションに対しては後ろに
{value} を追加する。オ
プションがコンマ区切りのリストのときは、値が空でない限
り、元の値と
{value} の間にコンマが付け加えられる。
オプションがフラグのリストであるときは、冗長なフラグは
取り除かれる。すでに入っているフラグを加えようとしたと
きは、そのオプションの値は変わらない。
< 上の
|:set-args| も参照。
{Vi にはない}
:se[t]
{option}^=
{value} *:set^=*
数値オプションに対してはその値を
{value} 倍する。文字
列オプションに対しては前に
{value} を追加する。オプショ
ンがコンマ区切りのリストのときは、
{value} と元の値の間
にコンマが付け加えられる。
上の
|:set-args| も参照。
{Vi にはない}
:se[t]
{option}-=
{value} *:set-=*
数値オプションに対しては
{value} だけその値を減らす。
文字列オプションに対しては
{value} を (それが含まれて
いたら) 取り除く。
そのとき
{value} が含まれていな
くても、警告やエラーは出ない。オプションがコンマ区切り
のリストであり、取り除くオプションが唯一の値でない限り、
間のコンマも削除される。
オプションがフラグのリストであるときは、
{value} は値の
中に現れるままに、正確に指定しなければならない。問題
が起こるのを避けるために、フラグを取り除くときは1個ず
つ指定すること。
上の
|:set-args| も参照。
{Vi にはない}
1回のコマンド ":set" に対し、複数の
{option} を引数に指定できる。例:
引数の中にエラーがあると、エラーメッセージが現れ、エラーの元になったオプション
以降は無視される。
*:set-verbose*
オプション
'verbose' の値が非0 なら、オプションの値を表示するとき、同時に、そ
のオプションが最後に設定されたのはどこであったかも分かる。例:
これは特定のオプション名が指定されたときのみ機能する。コマンド ":set all" や、
引数のないコマンド ":verbose" ではメッセージが現れない。
オプションが手動で設定されていると、メッセージ "Last set" は現れない。
オプションが関数やユーザコマンド、オートコマンド autocommand の実行中に設定さ
れたときは、それらが定義されているスクリプト名が報告される。
Note 'compatible'を設定すると副作用として他のオプションも設定されることがある。
以下のような特殊なメッセージがある:
Last set from modeline
モードライン
|modeline| の中でオプションが設定された。
Last set from --cmd argument
コマンドライン引数
|--cmd| または + によりオプションが設定され
た。
Last set from -c argument
コマンドライン引数
|-c|, +,
|-S|,
|-q| によりオプションが設定
された。
Last set from environment variable
環境変数、$VIMINIT、$GVIMINIT、$EXINIT によりオプションが設定
された。
Last set from error handler
オプションを評価中にエラーが発生し、クリアされた。
{Vimが |+eval| 機能付きでコンパイルされたときのみ有効}
*:set-termcap* *E522*
Termcap オプションを設定するには、
{option} に "t_xx" の形式を使ってもよい。こ
れは termcap による値を上書きする。これはマッピングの中で利用することもできる。
"xx" の部分が特別な文字を含むときは、
<t_xx> の形式を使うこと:
これは特殊なコードを普通のキーに変換する際にも使われる。例えば Alt-b が
<Esc>b
を出力するなら、次のようにすること。
(ここで ^[ は本物の
<Esc> である。入力には
CTRL-V <Esc> を使うこと)
マッピングの利点は、どんなときにも機能することである。
キーコードを定義することができます。例:
未知のキーコード名を使っても警告は表示されません。これらのキーコードに対して
マップを定義できます:
*E846*
キーコードが設定されていない場合、それは存在しないのと同じです。その値を取得し
ようとするとエラーになります:
t_xxの形のオプションは安全上の理由により、モードライン
|modeline|やサンドボック
ス
|sandbox|では設定できない。
コマンド ":set" によるリスト表示の外見は、Viとは違う。長い文字列オプションはリ
ストの終わりに現れる。オプションの数も極めて多い。コマンド "set all" による表
示は、画面に収まらないだろう。そうしたとき、Vimは「継続」プロンプト
|more-prompt| を出す。
*option-backslash*
文字列オプションの値に空白を含めるには、空白の前に '\' を置く必要がある。値に
'\' を含めるには、2個繰り返す。結果的には、オプションの値の中の '\' の数は半分
になる (端数は切り捨て)。
例をいくつか挙げる。
文字 "|" によって、コマンド ":set" を後に続くコマンドと分けることができる。文
字列オプションの値に "|" を含めるには、代わりに "\|" を使うこと。次の例ではオ
プション
'titlestring' の値を "hi|there" に設定している。
しかし次の例では、2個のオプション
'titlestring',
'iconstring' をそれぞれ "hi",
"there" に設定している。
また、ダブルクォート文字はコメントを開始する。オプションの値に'"'を含めるには
'\"'と書くこと。次の例は
'titlestring'を'hi "there"'に設定する:
MS-DOSとWin32では、ファイル名の中の '\' は大抵は取り除かれない。正確に言うと、
値にファイル名を取るオプション (環境変数が展開されるもの) では、通常のファイル
名に使われる文字の前の '\' は取り除かれない。しかし、特別な文字 (空白、'\' そ
のもの、コンマ等) の前の '\' は、上で説明した通りの働きをする。
オプションの値が "\\" で始まるときは、特別な状態になる。
最初の例では、始まりの部分の '\' はそのまま保たれている。しかし2番目の例では、
'\' の数は半分になっている。つまり、'\' をそのまま保ちたいときでも、半分にした
いときでも、どちらがよいか指定できることが分かる。3番目の結果は、おそらく希望
通りのものではないだろう。このやり方は避けること。
*add-option-flags* *remove-option-flags*
*E539* *E550* *E551* *E552*
値がフラグのリストからなるオプションもある。そういったオプションにフラグを追加
したいとき、既存の値を変更したくないならば、こうすること。
オプションからフラグを取り除くには、こうすること。
これはオプション
'guioptions' からフラグ 'a' を取り除く。
Note フラグは1個ずつ追加したり取り除いたりするよう注意。オプション
'guioptions' が "ab" という値であるとき、"set guioptions-=ba" は機能しない。な
ぜなら、"ba" という文字列は現れていないからである。
*:set_env* *expand-env* *expand-environment-var*
特定の文字列オプションでは環境変数が展開される。'$' とそれに続く環境変数名
が、その値に置き換えられる (その環境変数が存在するとき)。環境変数が存在しない
とき、'$' とそれに続く変数名は変更を受けない。識別子に使えない non-id 文字 (英
字、数字、'_' 以外) なら、どれでも環境変数名の後に続けることができる。識別子に
使えない文字とそれに続く文字は、環境変数の値の後ろにそのまま追加される。例:
コマンド ":set opt-=値" でオプションから文字列を取り除いたり、コマンド ":set
opt+=値" でオプションに文字列を追加したりするときには、環境変数の展開が行われ
てからそうした操作がなされる。
ローカル変数の扱い
*local-options*
いくつかのオプションは、1つのウィンドウや1つのバッファのみに適用される。それぞ
れのウィンドウやバッファは、そうしたオプションの独自のコピーを保持しているため、
独自の値を持つことができる。これにより、あるウィンドウ内では
'list' オプション
をオンにするが、他のウィンドウではオフにする、ということが可能になる。またオプ
ション
'shiftwidth' を、あるバッファ内では 3 にし、他では 4 にすることもできる。
以降では、特定の状況下でそれらのローカルオプションがどうなるかを説明する。実際
には、それらを全て知る必要はない。なぜなら、Vimはおそらくユーザが予想する通り
にオプションの値を使うからである。残念ながら、ユーザの予想通りに働くのは、いく
らか複雑なことである...
ウィンドウを分割すると、ローカルオプションは新しいウィンドウにコピーされて引き
継がれる。そのため、ウィンドウを分割した直後には、2つのウィンドウの内容は同じ
ように見える。
新しいバッファを編集するとき、そのバッファのローカルオプションは初期化されなけ
ればならない。その以前のカレントバッファのローカルオプションは、そのバッファの
みに適用すべきものかもしれないので、新しいバッファには適用されない。その代わり、
バッファについてローカルなオプションにはそれぞれグローバルな値があり、新しいバッ
ファにはそれが適用される。コマンド ":set" によって、ローカルな値とグローバルな
値の両方が変更される。コマンド "setlocal" はローカルな値のみを変更するので、そ
れで指定した値は新しいバッファには適用されない。
すでに編集されているバッファを編集するときは、最後に使われたウィンドウ内のロー
カルオプションが再び使われる。このバッファがこのウィンドウ内ですでに編集されて
いたなら、そのときの値が再び用いられる。そうでなければ、そのバッファが最後に編
集されたウィンドウ内の値が用いられる。
特定のバッファの種類についてウィンドウ内のローカルオプションを設定することも可
能である。同じウィンドウ内で別のバッファを編集するときは、ウィンドウについてロー
カルなオプションを使い続けたくはないだろう。そのためVimはウィンドウについてロー
カルなオプションのグローバルな値を記憶しており、別のバッファの編集時にはそれを
用いる。ウィンドウはそれぞれ、それらの値の独自のコピーを持っている。そのため、
それらのオプションはウィンドウについてはローカルであるが、そのウィンドウ内の全
てのバッファについてグローバルである。それらを用いて、次のようなことが可能であ
る。
こうするとオプション
'list' はバッファ "二つ目" にも適用される。コマンド
":set list" により、グローバルな値もオンになったからである。
今度はバッファ "二つ目" ではオプション
'list' はオフである。なぜならコマンド
":set nolist" がグローバルな値をオフにしたが、コマンド ":setlocal list" はバッ
ファ "一つ目" についてローカルな値をオンにしただけで、":e 二つ目" ではグローバ
ルな値が適用されるからである。
Note 次にこうすると
最後にバッファ "一つ目" を編集したときの通りにオプション
'list' の値が戻るわけで
はないので注意。ウィンドウについてローカルなオプションは、バッファそれぞれに対
して復元されるわけではないからである。
*:setl* *:setlocal*
:setl[ocal] ... コマンド ":set" と似ているが、カレントバッファ／ウィン
ドウについてローカルな値のみを設定する。全てのオプショ
ンがローカルな値を持つわけではない。オプションがローカ
ルな値を持たないときは、グローバルな値が設定される。
引数が "all" のとき: 全てのローカルオプションのローカ
ルな値を表示する。
引数がないとき: 全てのローカルオプションのローカルな値
で、既定値と異なるものを表示する。
特定のローカルオプションを表示するときは、ローカルな値
も表示する。グローバルまたはローカルな切替オプションに
対しては、グローバルな値が表示される場合には、オプショ
ン名の前に "--" が表示される。
グローバルオプションに対しては、グローバルな値が表示さ
れる (しかし、これは将来変更されるかもしれない)。
{Vi にはない}
:setl[ocal]
{option}< 値をコピーすることによって
{option}のローカルな値をグ
ローバルな値と同じにする。
{Vi にはない}
:se[t]
{option}<
|global-local| オプションに対して:
{option} のローカル
値を削除する。そうすることでグローバル値が使われるよう
になる。
{Vi にはない}
*:setg* *:setglobal*
:setg[lobal] ... コマンド ":set" と似ているが、ローカルオプションのグロー
バルな値のみを設定し、ローカルな値は変更しない。
オプションの値を表示するときは、グローバルな値が表示さ
れる。
引数が "all" のとき: 全てのローカルオプションのグロー
バルな値を表示する。
引数がないとき: 全てのローカルオプションのグローバルな
値で、既定値と異なるものを表示する。
{Vi にはない}
バッファ／ウィンドウについてローカルなオプションに対して:
コマンド グローバルな値 ローカルな値
:set オプション=値 設定される 設定される
:setlocal オプション=値 なし 設定される
:setglobal オプション=値 設定される なし
:set オプション? なし 表示される
:setlocal オプション? なし 表示される
:setglobal オプション? 表示される なし
ローカルな値を持つグローバルオプション
*global-local*
オプションがグローバルであるというのは、一つの値を全てのバッファとウィンドウに
用いるような場合である。いくつかのグローバルオプションでは、ローカルな別の値を
持てると便利である。ローカルな値は、コマンド ":setlocal" で設定できる。すると
コマンド":setlocal" を実行したバッファとウィンドウではローカルな値が用いられる
が、他のバッファでは引き続きグローバルな値が用いられる。
例えば、あなたは2つのウィンドウを開き、両方でC言語のソースファイルを編集してい
るとする。グローバルなオプション
'makeprg' は両方に適用される。そこでウィンド
ウの片方で
とすると、別のウィンドウでも同じ値が用いられる。別のウィンドウに移って
オプション
'makeprg' を設定する必要はない。
しかし、新しいウィンドウでPerlのソースファイルの編集を始めると、
'makeprg' に別
の値を設定したくなる。しかしCソースに適用された値を変えたくはない。そんなとき
には次のようにする。
次のようにローカルな値を空にすると、グローバルな値に戻る。
ただし、この方法は文字列オプションにしか使えない。切替オプションには、次のよう
に "<" フラグを使う必要がある。
Note: 非切替オプションの変更で "<" を使うと、グローバルな値がローカルな値にコ
ピーされるが、それはグローバルな値を使うようにするのとは少し違うことに注意 (こ
れは後でグローバルな値が変更されたときに問題になる。--訳注: グローバルな値が変
更されても、"<" でコピーした値までは変更されない。あくまでもローカルな値だか
ら)。次を使うこともできる:
これは
'path'のローカルな値を空にし、グローバルな値が使われるようにする。すな
わち、次と同じことをする:
Note: 将来、値にグローバルとローカルの区別のあるオプションが増えたら、グローバ
ルオプションにコマンド ":setlocal" を使ったときの結果が変わるかもしれない。
ファイルタイプの設定
:setf[iletype]
{filetype} *:setf* *:setfiletype*
{filetype} に対してオプション
'filetype' を設定する。
ただし autocommand の中 (入れ子になっているときは、外
側も含めて) でまだ実行されていないときのみ有効である。
これは以下のコマンドの略である。
このコマンドは filetype.vim の中で使われ、オプション
'filetype' が2度設定されて別の設定や構文ファイルが読み
込まれることがないようにしている。
{Vi にはない}
*option-window* *optwin*
:bro[wse] se[t]
*:set-browse* *:browse-set* *:opt* *:options*
:opt[ions] 全てのオプションを表示したり設定するためのウィンドウを
開く。
オプションは機能ごとにまとめられている。
ここではオプションの短い説明が読める。その上で
<CR> を
打ち込むと、そのオプションについてのヘルプウィンドウが
開き、詳しい説明が読める。
表示されている値を修正した後に "set" 行の上で
<CR> を
打ち込むと、新しい値を設定できる。ウィンドウやバッファ
固有のオプションについては、変更した値は最後に使用した
ウィンドウに適用される。そのウィンドウがヘルプウィンド
ウだったときは、変更した値はヘルプウィンドウの (オプショ
ンウィンドウを抜かして) 1つ下のウィンドウに適用される。
{Vimが |+eval| 機能と |+autocmd| 機能付きでコンパイル
されたときのみ有効}
*$HOME*
"~" は "$HOME" と同様に扱われるが、こちらは値の先頭にあるか、空白かコンマの後
にあるときのみ認識される。
Unix系のシステムでは "~正和" も使える。これは "正和" というユーザのホームディ
レクトリに置き換えられる。例:
Unix系のシステムでは "$
{HOME}" という形式も使える。ここで {} の間には識別子に
使えない文字 (訳注: 上を参照) が入ってもよい。
Note これをコマンド "gf" のため
に使いたいなら、文字 '{' と '}' をオプション
'isfname' に追加する必要がある。
MS-Windows では、$HOME 環境変数が定義されていない場合は Vim の起動時に
$HOMEDRIVE$HOMEPATH という値で定義されます。
NOTE: 環境変数と"~/"の展開はコマンド":set"のときのみ行われる。":let"でオプショ
ンに値を代入するときは展開されない。
Note 展開されるオプションの値の長さ制限に注意。システムごとに異なるが、大抵は
256文字や1024文字等の長さである (訳注: これは半角の場合で、全角では半分)。
*:fix* *:fixdel*
:fix[del] ターミナルオプション
't_kD' (訳注: デリートキー) の値
を設定する。
't_kb' が のとき 't_kD' は
CTRL-? CTRL-H
CTRL-?以外
CTRL-?
(
CTRL-? は8進数で 0177、16進数で 0x7f)
{Vi にはない}
ターミナルのデリートキーのキーコードが違っているが、バッ
クスペースのキーコードは正しいときは、次のコマンドをファ
イル .vimrc に加えればよい。
これはバックスペースのキーコードが実際に何であっても有
効である。
バックスペースのキーコードが違っていたら、以下のように
する。
ここで "^V" は
CTRL-V 、 "
<BS>" はバックスペースを表す
(実際に「^」「V」などのキーを押さないこと)。"termname"
にはユーザの使うターミナル名を当てはめる。
<Delete> キーが奇妙なキーコード列 (
CTRL-? でも
CTRL-H
でもない) を送るときは、コマンド ":fixdel" ではなく以
下の方法を使う。
ここで "^V" は
CTRL-V 、 "
<BS>" はデリートキーを表す
(実際に「^」「V」などのキーを押さないこと)。"termname"
にはあなたの使うターミナルの種類を当てはめる。
*Linux-backspace*
Note Linuxについての注意: 既定ではバックスペースキーは
CTRL-? を送るが、これは違っている。これを修正するには、
ファイル rc.local に次の行を加える。
*NetBSD-backspace*
Note NetBSDについての注意: バックスペースキーが正しい
キーコードを送らないとき、これを試すこと。
有効だったら、ファイル .Xmodmap に次の行を加えること。
これを有効にするには、再起動する必要がある。
==============================================================================
2. オプションの自動設定
*auto-setting*
コマンド ":set" によるオプションの設定の他に、3通りの方法で、1つまたは複数のファ
イルに自動的にオプションを設定できる。
1. Vimを起動したとき、様々な場所から初期化設定を読み込ませることができる。
|initialization| を参照。多くの設定は編集セッション全てに適用されるが、いく
つかはVimを起動したディレクトリによって異なる。初期化設定ファイルはコマンド
|:mkvimrc|,
|:mkview|,
|:mksession| で生成できる。
2. 新しいファイルの編集を始めたとき、自動的に実行されるコマンドがある。
これを使うと、特定のパターンにマッチするファイルに対してオプションを設定し
たり、様々なことが可能である。
|autocommand| を参照。
3. 新しいファイルの編集を始めたときオプション
'modeline' がオンなら、ファイル
の先頭と末尾の数行ずつがモードラインとして読み込まれる。それをここで説明す
る。
*modeline* *vim:* *vi:* *ex:* *E520*
モードラインには2つの形式がある。1つ目の形式は次の通りである。
[text]{white}{vi:|vim:|ex:}[white]
{options}
[text] 任意のテキスト、なくても良い
{white} 1個以上の余白 (
<Space> または
<Tab>)
{vi:|vim:|ex:} "vi:" か "vim:" か "ex:" という文字列
[white] 空白、なくても良い
{options} オプション設定が、空白か ':' で区切られて並んだもので、':' の
間の部分はコマンド ":set" の引数である(空でもよい)
例:
vi:noai:sw=3 ts=6
2つ目の形式は次の通りである (Viのヴァージョンによってはこの形式と互換性がある)。
[text]{white}{vi:|vim:|ex:}[white]se[t]
{options}:[text]
[text] 任意のテキスト、なくても良い
{white} 1個以上の余白 (
<Space> または
<Tab>)
{vi:|vim:|ex:} "vi:" か "vim:" か "ex:" という文字列
[white] 空白、なくても良い
se[t] "set "または"se " という文字列 (
NOTE 終わりの空白に注意)
{options} オプション設定が空白で区切られて並んだもので、コマンド ":set"
の引数である
: コロン
[text] 任意のテキスト、なくても良い
例:
/* vim: set ai tw=75: */
"vi:" または "
|vim:|" または "ex:" の前には空白が必要である。これが "lex:" 等
の普通の言葉を誤認する可能性を低めている。ただし例外があり、 "vi:" と "vim:"
は行頭に来てもよい (バージョン3.0との互換性のため)。"ex:" が行頭に来ると、モー
ドラインとは見なされない ("example:" の略かもしれないから)。
*modeline-local*
オプションは ":setlocal" などで設定できる。そうして設定した値は、そのバッファ
とそれを開いているウィンドウにのみ適用される。モードラインからグローバルオプショ
ンを設定することは不可能ではないが、普通そういうことはしない。2つのウィンドウ
を開いていて、それぞれのファイルが同じグローバルオプションを違う値に設定しよう
としたときは、後に開かれたウィンドウが優先される。
既に読み込まれているファイルを開くときは、モードラインからはウィンドウローカル
なオプションだけが設定される。つまり、ファイルを開いた後に手動でバッファローカ
ルなオプションを変更したら、そのバッファを別なウィンドウで開いてもそのオプショ
ンは変更されないが、ウィンドウローカルなオプションは変更される。
*modeline-version*
モードラインの内容が、Vimのバージョンによって使用可能だったり不可能だったりす
る場合には、"vim:" のところでバージョンを指定できる。
vim
{vers}: バージョン
{vers} 以降 (そのバージョンを含む)
vim<
{vers}: バージョン
{vers} より前
vim=
{vers}: バージョン
{vers} のみ
vim>
{vers}: バージョン
{vers} より後 (そのバージョンを含まない)
{vers} に 600 を指定するとVim 6.0を表す (メジャー・バージョンナンバーの100倍足
すマイナー・バージョンナンバー)。
例えば、Vim 6.0またはそれより新しいバージョンでのみモードラインを使うにはこう
する。
/* vim600: set foldmethod=marker: */
Vim 5.7より古いバージョンでのみモードラインを使うにはこうする
/* vim<570: set sw=4: */
"vim" と ":" の間に空白があってはならない。
モードラインを探す行数はオプション
'modelines' で設定できる。オプション
'modeline' がオフであるかオプション
'modelines' の値が 0 だと、モードラインを
探さない。
Note 1番目の形式では、行全体がオプション指定に使われることに注意。そのため次の
ようにすると、行末の "*/" のためにエラーメッセージが現れる。
/* vi:ts=4: */
その代わり、こうすればよい。
/* vi:set ts=4: */
エラーが発見されると、その行の残りは無視される。
コマンド "set" の引数に ':' を含めたいときは、その前に '\' を置くこと。':' の
前の '\' は取り除かれる。例:
/* vi:set dir=c\:\tmp: */
これはオプション
'dir' を "c:\tmp" に変更する。':' の前に '\' が置かれたとき、
取り除かれるのは1個だけである。だからオプションの値に "\:" を含めたいなら
"\\:" を指定すること。
安全上の理由から、コマンド "set" 以外は使用できない (誰かがテキストファイルで
「トロイの木馬」を作るかもしれないから) 。また、全てのオプションが設定できるわ
けではない。ある種のオプションにはフラグが設定されており、それが使用されるとき
には
|sandbox|が有効になる。しかしそれでもモードラインが問題を引き起こす可能性
はわずかに残る。例えば、悪意のある誰かが
'textwidth'を5にすると、ファイルの全て
の行が予期せず折り返されてしまう。そのため、信用できないファイルを編集する前に
はモードラインを無効にすること。
例えばmail ftpluginはそれを行っている。
ヒント: ファイルを読み込みときにオプション設定以外を行いたいなら、ファイル内の
特定の文字列を調べる autocommand を定義すればよい。例:
そして "VAR" を含む行に何かを行うための SetVar() 関数を定義すればよい。
==============================================================================
3. オプションの要約
*option-summary*
以下のリストでは、全てのオプションが、正確な名前と (あれば) 略名で示されている。
どちらの形を使ってもよい。
この文書内では、切替オプションを「オンに」するというのは ":set オプション" を
実行することを表す。切り替えオプションを「オフに」するというのは
":set noオプション" を実行することを表す。
いくつかのオプションには、既定値が2種類あるものがある: 1つ目は "Vim default"
つまりVimの既定値で、オプション
'compatible' がオフになっているときに使われる。
2つ目は "Vi default" つまりViの既定値で、オプション
'compatible' がオンになって
いるときに使われる。
ほとんどのオプションは全てのウィンドウやバッファで共通である。さてその中には、
テキストがウィンドウ内でどのように表示されるかを定めるものもある。そういったオ
プションは、ウィンドウごとに違う値にできる。例えばオプション
'list' は、あるウィ
ンドウ内でオンにしても、同じテキストを編集している別のウィンドウ内ではオフに
することができる。すると同時に違った表示方法が使える。また、ファイルごとに特定
の値にできるオプションもある。そういったオプションは、ファイルごとまたはバッファ
ごとに違う値にできる。例えばオプション
'textwidth' は、通常のテキストファイル
には78にし、Cプログラムのファイルには0にするようにできる。
グローバル:
一つのオプションが全てのバッファやウィンドウに対して適用される
ウィンドウについてローカル:
ウィンドウがそれぞれ、そのオプションのコピーを独自に持つ
バッファについてローカル:
バッファがそれぞれ、そのオプションのコピーを独自に持つ
(訳注: 上の項目については、文書先頭も参照)
新しいウィンドウを開くとき、ウィンドウ固有のオプションには、その前にアクティブ
だったウィンドウでの値がまず使われる。バッファ固有のオプションは、オプション
'cpoptions' のフラグ 's' とフラグ 'S' によって違ってくる。フラグ 's' が含まれ
ていると (既定ではこうなっている)、新しいバッファが最初にアクティブになったと
きに、その前にアクティブだったバッファでの値がコピーされる。フラグ 'S' が含ま
れていると、バッファがアクティブになる度に値がコピーされる。これはグローバルオ
プションであるようなものである。フラグ 's' もフラグ 'S' も含まれていないときは、
バッファが作られるときに、その前にアクティブだったバッファでの値がコピーされる。
隠しオプション
*hidden-options*
全てのオプションが全てのバージョンでサポートされているわけではない。これは有効
にされている機能とシステムにもよる。これに関しての注意は以下の波括弧の中にある。
もしあるオプションがサポートされていなくても、そのオプションへの設定はエラーに
ならず成功する。これを隠しオプションと呼ぶ。しかし隠しオプションの値は保持され
ていないため、取得することはできない。
オプション"foo"が":set"で設定できるかどうか判定するにはこのようにする:
これは隠しオプションに対してもtrueを返す。オプション"foo"が本当にサポートされ
ているかを判定するにはこのようにする:
*E355*
|Q_op| にはオプションの短い説明付きの表があり、そこからヘルプにジャンプできる。
*'aleph'* *'al'* *aleph* *Aleph*
'aleph' 'al' 数値 (既定値はMS-DOSでは128、それ以外では224)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
ヘブライ語アルファベットの最初の文字を表すASCIIコード。Insertモード
(オプション
'hkmap' がオンのとき) と Command-lineモード (
CTRL-_ を打ち
込んだとき) の両方において、ヘブライモードのキーボード配列をマッピング
するルーチンは、[aleph..aleph+26] の範囲のヘブライ文字を出力する。
'aleph'=128 はPCコード、
'aleph'=224 は ISO 8859-8 に使われる。
|rileft.txt| を参照。
*'allowrevins'* *'ari'* *'noallowrevins'* *'noari'*
'allowrevins' 'ari' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
InsertモードとCommand-lineモードで
CTRL-_ を使用可能にする。これは既定
ではオフになっている。ユーザが間違って SHIFT-_ ではなく
CTRL-_ を打ち
込み、右から左に書いていくモードに入って抜けられなくなる事態を防ぐため
である。オプション
'revins' を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'altkeymap'* *'akm'* *'noaltkeymap'* *'noakm'*
'altkeymap' 'akm' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+farsi| 機能付きでコンパイルされたときのみ有
効}
オンのとき、2番目の言語が Farsi になる。オプション
'allowrevins' がオ
ンならば、Insertモードでは
CTRL-_ で Farsi と英語のキーボードマップを
切り替えられる。
オフのとき、キーボードマップはヘブライ語と英語で切り替えられる。これは
普通の状態、つまり英語モード (左から右に書く言語のモード) と既定の第2
言語である Farsi またはヘブライ語モード (右から左に書く言語のモード)を
切り替えた上でVimを開始するのに便利である。
|farsi.txt| を参照。
*'ambiwidth'* *'ambw'*
'ambiwidth' 'ambw' 文字列 (既定では"single")
グローバル
{Vi にはない}
{Vimが|+multi_byte|機能付きでコンパイルされたときのみ
有効}
'encoding'が"utf-8"などユニコードエンコーディングのときのみ効果がある。
East Asian Width Class Ambiguous な文字(ユーロ、登録商標記号、著作権記
号、ギリシャ文字、キリル文字など)をどう扱うかを定める。
現在のところ、設定可能な値は次の2通りである:
"single": US-ASCIIの文字と同じ幅を使う。これはほとんどのユーザに
とって期待どおりになる。
"double": ASCII文字の2倍の幅を使う。
*E834* *E835*
"double" は
'listchars' や
'fillchars' に指定された文字が全角幅になっ
てしまう場合は使えません。
これらの文字のグリフの幅を、旧い／伝統的なCJKエンコーディングで何オク
テットを占めるかだけによって決めているCJKフォントがたくさんある。その
エンコーディングではユーロ、登録商標記号、ギリシャ文字、キリル文字は2
オクテットで表現されるので、それらのフォントはこれらの文字に「wideな」
グリフを当てている。これはテキストファイルで表を作るための罫線文字にも
あてはまる。そのためGUI版のVimにCJKフォントを使うときや、CJKフォント
を使うターミナル(エミュレータ)の中でVimを実行するとき(またはオプション
"-cjkwidth"つきで起動されたxtermの中でVimを実行するとき)にはこのオプ
ションを"double"にして、Vimが認識する幅をフォントのグリフの幅に合わせ
なければならない。CJKのWindows 9x/MEやWindows 2k/XPでもシステムのロケー
ルがCJKロケールのどれかに設定されている場合は多分"double"にしなければ
ならないだろう。
Unicode Standard Annex #11 (
http://www.unicode.org/reports/tr11)を参照。
*'antialias'* *'anti'* *'noantialias'* *'noanti'*
'antialias' 'anti' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{VimがMac OS XでGUIを有効にしてコンパイルされたときの
み有効}
このオプションはMac OS X v10.2以降の上でGUI版のVimを使うときだけ効果が
ある。これがオンであるとなめらかな(アンチエイリアスされた)フォントが使
われる。このフォントはある種のディスプレイ上、あるサイズでは読み易くな
る。
'guifont'が既定値(空文字列)のときこのオプションを設定すると問題が発生
することがある。
*'autochdir'* *'acd'* *'noautochdir'* *'noacd'*
'autochdir' 'acd' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimのコンパイル時に有効にされたときのみ有効。使用で
きるかどうかは exists("+autochdir") で確認できる}
これがオンであるとファイルを開くとき、バッファを切り替えるとき、バッファ
を削除するとき、ウィンドウを開閉するときに毎回作業ディレクトリが変更さ
れる。開かれた／選択されたファイルを含んでいるディレクトリがカレント
ディレクトリになる。
このオプションはSun ONE Studio 4 Enterprise Editionとともにリリースさ
れたVimとの後方互換性のために提供されている。
Note: このオプションがオンになっていると動かないプラグインがある。
*'arabic'* *'arab'* *'noarabic'* *'noarab'*
'arabic' 'arab' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが|+arabic|機能付きでコンパイルされたときのみ
有効}
アラビア語のテキストを編集するときにこのオプションを設定することができ
る。
このオプションを設定すると次のことが行われる:
-
'termbidi'がオンでない限り、オプション
'rightleft'をオンにする。
-
'termbidi'がオンでない限り、オプション
'arabicshape'をオンにする。
- オプション
'keymap'を"arabic"に設定する。これによってインサートモード
で
CTRL-^を押すと英語とアラビア語のキーマッピングがトグルする。
- オプション
'delcombine'をオンにする。
アラビア語のテキストを編集するには
'encoding'が"utf-8"でなければならな
いことに注意。
このオプションをオフにすると次のことが行われる:
-
'rightleft'をオンにする
-
'keymap'の使用を無効にする(その値は変更しない)
'arabicshape'と
'delcombine'はオフにならない(これらはグローバルオプショ
ンである)。
|arabic.txt|も参照。
*'arabicshape'* *'arshape'*
*'noarabicshape'* *'noarshape'*
'arabicshape' 'arshape' 切替 (既定ではオン)
グローバル
{Vi にはない}
{Vimが|+arabic|機能付きでコンパイルされたときのみ
有効}
これがオンで
'termbidi'がオフになっているとアラビア語を表示するのに必要
な文字表示補正が行われる。本質的には字形作成(shaping)が有効になる。こ
の用語は次の事を含む広い用語である。
a) 単語の中の位置(初期、中間、最終、孤立)によって文字を変更/変形させ
る。
b) 文字合成機能の有効化
c) ある文字の組み合わせの有効化
これが無効になっていると、表示がそれぞれの文字の本来の孤立形になる。
アラビア語は他にも設定が必要な複雑な言語である。より詳しくは
|arabic.txt|を参照。
*'autoindent'* *'ai'* *'noautoindent'* *'noai'*
'autoindent' 'ai' 切替 (既定ではオフ)
バッファについてローカル
新しい行を開始したとき (Insertモードで
<CR> を打ち込むか、コマンド "o"
や "O" を使ったとき)、新しい行のインデントを現在行と同じくする。新しい
行で
<BS> か
CTRL-D 以外を打ち込まずに
<Esc>、
CTRL-O か
<CR> を打ち込
むと、その行のインデントは削除される。
'cpoptions'にフラグ'I'が入ってい
ないかぎり、カーソルを他の行に移動させても同様である。
オプション
'autoindent' がオンのときは、テキストの整形処理 (コマンド
"gq" を使ったり、挿入モードで 1行の文字数がオプション
'textwidth' で指
定した数に届いたとき) には最初の行のインデントが使われる。
オプション
'smartindent' かオプション
'cindent' がオンのときは、インデ
ントの方法は違ってくる。
オプション
'paste' がオンのときは
'autoindent' はオフになる。
{Vi との微妙な違い: <Esc> または <CR> を打ち込んでインデントが削除され
た後、上下に移動した後のカーソル位置は削除されたインデントの後ろになる。
Viでは削除されたインデントの中のどこかになる}
*'autoread'* *'ar'* *'noautoread'* *'noar'*
'autoread' 'ar' 切替 (既定ではオフ)
グローバルまたはバッファについてローカル
|global-local|
{Vi にはない}
ファイルがVimの内部では変更されてないが、Vimの外部で変更されたことが判
明したとき、自動的に読み直す。ファイルが削除されたときにはこのようには
ならない。
|timestamp|
このオプションがローカルな値を持つとき、再びグローバルな値を使うように
するには次のようにする。
*'autowrite'* *'aw'* *'noautowrite'* *'noaw'*
'autowrite' 'aw' 切替 (既定ではオフ)
グローバル
コマンド :next, :rewind, :last, :first, :previous, :stop, :suspend,
:tag, :!, :make,
CTRL-],
CTRL-^ を実行したときや、コマンド :buffer,
CTRL-O,
CTRL-I, '
{A-Z0-9}, `
{A-Z0-9} の移動先が別のファイルのとき、ファ
イルが変更されているなら書き込む。
Note 'autowrite' が適用されないコマンドもあることに注意。それについて
はオプション
'autowriteall' を参照。
*'autowriteall'* *'awa'* *'noautowriteall'* *'noawa'*
'autowriteall' 'awa' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オプション
'autowrite' と似ているが、さらにコマンド ":edit", ":enew",
":quit", ":qall", ":exit", ":xit", ":recover" を実行したときや、Vimの
ウィンドウを閉じるときも、ファイルが変更されているなら保存する。このオ
プションをオンにすると、同時に
'autowrite' もオンになったような動作に
なる (訳注:このオプションは
'autowrite' の適用されるコマンド全てに適用
されるので)。
*'background'* *'bg'*
'background' 'bg' 文字列 (既定は "dark" または "light"、下記参照)
グローバル
{Vi にはない}
値が "dark" のときは、Vimは暗い背景によく合う色を使おうとする。値が
"light" のときは、Vimは明るい背景によく合う色を使おうとする。その他の
値は無効である。
Vimは使われているターミナルの種類に従って既定の値を定めるが、常に正し
いとは限らない。
このオプションを変更しても背景色は変わらない。これはただVimに背景色が
どのようなものかを伝えるだけである。背景色の変更には
|:hi-normal| を参
照。
オプション
'background' が変更されると、Vimは既定の色設定グループをを
その値に合わせて調整する。しかし構文強調表示に使われる色設定は変化しな
い。
*g:colors_name*
カラースキームが読み込まれているとき (つまり変数 "g:colors_name" が設定さ
れているとき)
'background' を変更するとカラースキームが再び読み込まれ
る。カラースキームが
'background' に対応していればこれは適用される。し
かしカラースキームが
'background' 自体を設定しているときは効果がない。
必要ならば変数 "g:colors_name" を消去すること。
'background' を次のようにして既定値に戻したとき、
Vimはその値を推測する。GUI版ならばうまくいくはずだが、そうでなければ正
しい値を推測できないかもしれない。
GUIを開始したとき、
'background' の既定値は "light" である。値がファイ
ル .gvimrc で定められておらず、Vimが背景色は実際は暗いと判断したときは、
'background' は "dark" になる。しかしこれは .gvimrc が読み込まれた「後」
に行われる (実際の背景色を知るためにウィンドウが開かれる必要があるか
ら)。これを避けるには、コマンド ":gui" を .gvimrc の中の
'background'
の値が使われる前に置いて (例えば ":syntax on" の前) GUIウィンドウを強
制的に開かせればよい。
MS-DOS、Windows、OS/2 では初期設定は "dark" です。
他のシステムでは
'term' が "linux"、"screen.linux"、"cygwin"、
または "putty" であるか、$COLORFGBG によってが暗い背景が推奨されていれ
と初期設定は "dark" になります。そうでなければ初期設定は "light" で
す。
通常、このオプションは .vimrc 内で設定される。設定はターミナルの名前に
依存するでしょう。例:
このオプションが設定されると、強調表示の既定の設定が変更される。他の設
定を使いたいなら、
'background' を設定した「後」にコマンド ":highlight"
を置くこと。
このオプションはファイル "$VIMRUNTIME/syntax/syntax.vim" 内でも、構文
強調表示のための色を選択するのに使われる。このオプションを設定した後は
syntax.vim を再読み込みしないと結果が分からない。これにはコマンド
":syntax on" を実行すればよい。
*'backspace'* *'bs'*
'backspace' 'bs' 文字列 (既定では "")
グローバル
{Vi にはない}
Insertモードでの
<BS>,
<Del>,
CTRL-W,
CTRL-U の働きに影響する。値はキー
ワードのコンマ区切りのリストである。それぞれのキーワードがバックスペー
スの働く対象を定めている。
値 効果
indent autoindent を超えてバックスペースを働かせる
eol 改行を超えてバックスペースを働かせる (行を連結する)
start 挿入区間の始めでバックスペースを働かせるが
CTRL-W と
CTRL-U は
挿入区間の始めでいったん止まる
値が空のときは、バックスペースの働きはVi互換になる。
バージョン 5.4 またはそれ以前との互換性を保つには次のようにする。
値 効果
0 ":set backspace=" と同じ (Vi互換)
1 ":set backspace=indent,eol" と同じ
2 ":set backspace=indent,eol,start" と同じ
<BS> や
<Del> で望み通りの動作ができないときは
|:fixdel| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときは "" にな
るので注意。
*'backup'* *'bk'* *'nobackup'* *'nobk'*
'backup' 'bk' 切替 (既定ではオフ)
グローバル
{Vi にはない}
ファイルを上書きする前にバックアップを作る。書き込みが成功してもバック
アップはそのまま取っておく。バックアップを取っておきたくはないが、書き
込み中にはバックアップが欲しいときには、このオプションをオフにしてオプ
ション
'writebackup' をオンにすること (既定ではそうなっている)。全くバッ
クアップが要らないなら両方をオフにすること (ユーザのファイルシステムが
ほとんど満杯ならこうするとよい)。詳しくは
|backup-table| を参照。
どちらにしてもオプション
'backupskip' のパターンがマッチすると、バック
アップは作られない。オプション
'patchmode' がオンのときは、バックアッ
プはリネームされてファイルの最も古いバージョンになることがある。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'backupcopy'* *'bkc'*
'backupcopy' 'bkc' 文字列 (UnixでのViの既定値: "yes" 、それ以外: "auto")
グローバル
{Vi にはない}
ファイルの書き込みをしてバックアップが作られるとき、その方法をこのオプ
ションで指定する。このオプションはコンマで区切られた単語のリストである。
主な値は次の通り:
"yes" 先にファイルのコピーを作ってバックアップにして、更新した内容は
元のファイルに上書きする
"no" 先に元のファイルをリネームしてバックアップにして、更新した内容
は新しいファイルに書き出す
"auto" どちらか適切な方を選ぶ
次の値を上のどれか1つと組み合わせることができる:
"breaksymlink"は書き込み時に常にシンボリックリンクを切る。
"breakhardlink"は書き込み時に常にハードリンクを切る。
訳注:
$ ls -lF
total 2
-rw-r--r-- 1 ao ao 24 9 17 12:26 hontai
lrwxr-xr-x 1 ao ao 6 9 17 12:29 l@ -> hontai
となっているとき、ファイルlを編集して:wすると、
backupcopy=auto の場合:
-rw-r--r-- 1 ao ao 24 9 17 12:26 l~
lrwxr-xr-x 1 ao ao 6 9 17 12:29 l@ -> hontai
-rw-r--r-- 1 ao ao 27 9 17 12:31 hontai
backupcopy=auto,breaksymlink の場合:
-rw-r--r-- 1 ao ao 27 9 17 12:26 hontai
lrwxr-xr-x 1 ao ao 6 9 17 12:29 l~@ -> hontai
-rw-r--r-- 1 ao ao 30 9 17 12:32 l
という結果になる。
ファイルのコピーを作ってから元のファイルを上書きする方法:
X ファイルのコピーに余計な時間がかかる。
O 編集したファイルが特別な属性を持っていたり、ファイルがハードリンクや
シンボリックリンクであったり、リソースフォークを持っているときでも、
全て元のまま保たれる。
X 編集したファイルがリンクのとき、バックアップの名前がリンク先の文書の
名前でなく、リンクの名前になってしまう。
ファイルをリネームしてから新しいファイルに書き出す方法:
O 高速である。
X 時々、元のファイルの属性の一部しか新しいファイルにコピーされないこと
がある。
X 編集したファイルがリンクのとき、新しいファイルはリンクにならない。
"auto" の値にすると折衷策を採る。Vimが副作用なしにリネームの方法が使え
ると判断したとき (属性がコピーでき、ファイルがリンクでないとき) は、そ
ちらが使われる。それでは問題がありそうなときはコピーの方法が使われる。
"breaksymlink"と"breakhardlink"の値は"yes", "no", "auto"のどれとも組み
合わせることができる。これらが含まれていると、必ず"no"とまったく同じよ
うにシンボリックリンクやハードリンクを切るようになり、元のファイルがそ
のままバックアップになり、新しいファイルが作成される。これは例えば全て
のファイルがシンボリックリンクやハードリンクになっているソースツリーで
便利である。変更がローカルのソースツリーに対してだけ行われ、元のソース
ツリーには反映されない。
*crontab*
"no" と "auto" では問題が起きる場合がある。プログラムによっては、ファ
イルを開き、Vimを呼び出してそのファイルを編集させ、(ファイル区別プログ
ラムを使って) そのファイルが変更されたかどうかを調べるものがある。そう
したプログラムは新しく書き出されたファイルではなく、バックアップファイ
ルの方を調べてしまう。例としては "crontab -e" が挙げられる。
コピーの方法のときは、元のファイルの中身はいったん空になり、そこに新し
いテキストが書き込まれる。つまり、元のファイルの保護ビット、ファイル所
有者やシンボリックリンクは変更されない。しかし、新しく作られることにな
るバックアップファイルは、ファイルを編集したユーザの所有となる。また
バックアップファイルの属するグループは、元のファイルと同じグループにな
る。これが失敗すると、他の属性と同様に、そのグループの保護ビットが設定
される。
リネームの方法のときは別の結果になる。バックアップファイルは元のファイ
ルと同じ属性を持ち、新しく書き出されたファイルは、ファイルを編集したユー
ザの所有となる。開いたファイルがハードリンクまたはシンボリックリンクだっ
た場合でも、新しく書き出されたファイルはリンクにならない！だから値が
"auto" のとき、ファイルがリンクならリネームを行わないのである。新しく
書き出されたファイルの所有者と属するグループは、元のファイルと同じとし
て設定される。しかしシステムがこうすることを許可しないかもしれない。そ
の場合、値が "auto" ならもうファイルのリネームをしようとはしない。
*'backupdir'* *'bdir'*
'backupdir' 'bdir' 文字列 (Amigaでの既定値: ".,t:",
MS-DOSとWin32での既定値: ".,c:/tmp,c:/temp"
Unixでの既定値: ".,~/tmp,~/")
グローバル
{Vi にはない}
値は、バックアップファイル用ディレクトリの、コンマ区切りのリストである。
- バックアップファイルは、リスト内の、使用可能な最初のディレクトリの中
に作られる。Vim はそのディレクトリを作成しないので、存在していなけれ
ばならない。
- 値が空だと、バックアップファイルは作られない (
'patchmode' は使えなく
なる！)。そのため書き込みが失敗するかもしれない。
- ディレクトリに "." を指定するのは、バックアップファイルを、編集され
たファイルと同じディレクトリに作るということである。
- ディレクトリが "./" (MS-DOS等では ".\") で始まるのは、バックアップファ
イルを作るディレクトリを、編集されたファイルとの相対的な位置で決める
ということである。最初の "." は編集されたファイルのパス名で置き換え
られる (ディレクトリ名の内部の "." には特別な意味はない)。
- コンマの後の空白は無視されるが、他の場所の空白はディレクトリ名の一部
と見なされる。ディレクトリ名の先頭に空白を使いたいなら、その空白の前
に '\' を置くこと。
- ディレクトリ名にコンマを使いたいなら、そのコンマの前に '\' を置くこ
と。
- ディレクトリ名は '/' で終わってもよい。
- 環境変数は展開される
|:set_env|。
- 文字 '\' には注意。空白の前には1個置き、オプションの値に '\' 自身を
含めるなら2個置く (
|option-backslash| を参照)。例:
-
Vim version 3.0 との後方互換性のため、値の先頭の '>' は取り除かれる。
オプション
'backup' および
'writebackup' も参照。
Unixでユーザのバックアップファイルを隠したいなら、次のようにしてみるこ
と。
この方法を使うには、それぞれのディレクトリとあなたのホームディレクトリ
にディレクトリ ".backup" を作らなければならない。
リストにディレクトリを追加するときにはコマンド
|:set+=|、リストからディ
レクトリを除くときにはコマンド
|:set-=| を使うのがよい。こうすると将来
のヴァージョンで異なった既定値が使われるようになったときに、問題が起き
るのを防げる。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'backupext'* *'bex'* *E589*
'backupext' 'bex' 文字列 (既定では "~", VMSでは "_")
グローバル
{Vi にはない}
バックアップファイルの名前を作る際、元のファイル名の後ろに付け加える文
字列。既定では普段使いそうもないものに定めてあるが、これは既存のファイ
ルをバックアップファイルで上書きするのを避けるためである。".bak" を使
いたいかもしれないが、大事なファイルに ".bak" で終わるものがないか確か
めること。
通常のファイル名文字だけ使える。"/\*?[|<>"は不正である。
たくさんのバックアップを残しておきたいなら、自動コマンドBufWritePreを
使ってファイルを書き込む直前に
'backupext'にタイムスタンプを含めるよう
に変更するとよい。
バックアップを別のディレクトリに保存させるには、オプション
'backupdir'
を設定すること。
*'backupskip'* *'bsk'*
'backupskip' 'bsk' 文字列 (既定では "/tmp/*,$TMPDIR/*,$TMP/*,$TEMP/*")
グローバル
{Vi にはない}
{Vimが |+wildignore| 機能付きでコンパイルされたときの
み有効}
ファイル名のパターンのリスト。書き込みをするファイルの名前にマッチする
パターンがこの中にあれば、そのファイルのバックアップは作られない。ファ
イル名を指定してもよいし、ファイルのフルパスを指定 (訳注: C:/temp/* 等
の方法。既定値ではこの方法で一時ファイル用のディレクトリを指定し、一時
ファイルのバックアップを作らないようにしている) してもよい。
パターンの指定方法は
|:autocmd| と同じである。
|autocmd-patterns| を参
照。特別な文字に注意するために
|option-backslash| を参照。
環境変数の$TMPDIR, $TMP または $TEMP が定義されていないとき、それらは
既定値に使われない。"/tmp/*" はUnixでのみ使われる。
環境変数は展開されない。$HOMEを使いたい場合は、明示的に展開しなければ
ならない。例:
既定値は"crontab -e"が正常に機能するように定められている(元のファイル
をリネームすることによってバックアップを作ると、crontabは新しく作られ
たファイルを参照しない)。
'backupcopy'と
|crontab|も参照。
*'balloondelay'* *'bdlay'*
'balloondelay' 'bdlay' 数値 (既定では 600)
グローバル
{Vi にはない}
{Vimが |+balloon_eval| 機能付きでコンパイルされたとき
のみ有効}
バルーン表示が出るまでの時間 (ミリ秒単位)。
|balloon-eval| を参照。
*'ballooneval'* *'beval'* *'noballooneval'* *'nobeval'*
'ballooneval' 'beval' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+balloon_eval| 機能付きでコンパイルされたとき
のみ有効}
|balloon-eval| 機能を働かせる。
*'balloonexpr'* *'bexpr'*
'balloonexpr' 'bexpr' 文字列 (既定では "")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
{Vimが|+balloon_eval|機能付きでコンパイルされたときの
み有効}
バルーンウィンドウに表示するテキストの式。
'ballooneval'がオンのときの
み使われる。以下の変数を使用できる:
v:beval_bufnr バルーンを表示するバッファの番号
v:beval_winnr ウィンドウの番号
v:beval_lnum 行番号
v:beval_col 桁番号(バイトインデックス)
v:beval_text マウスポインタの下、または後ろにある単語
この式の評価には副作用があってはならない。
例:
NOTE: バルーンはカーソルがテキスト文字の上にあるときだけ表示される。
'balloonexpr'を評価した結果が空でないなら、Vimは外部デバッガ(Netbeans
またはSun Workshop)にメッセージを送ろうとしない。
この式はサンドボックス
|sandbox|の中でも評価できる。
|sandbox-option|を
参照。
バルーンのテキスト中の改行が機能するかを調べるにはこれを使う:
これがサポートされているなら文字列"\n"は新規行を開始する。この式を評価
した結果がリスト
|List|になる場合は、そのリストの各要素を文字列とし、
それらの間に"\n"を置くのと同じことになる。
*'binary'* *'bin'* *'nobinary'* *'nobin'*
'binary' 'bin' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
バイナリファイルを編集する前には、このオプションをオンにすべきである。
Vimの起動時に引数
|-b| を使ってもよい。オンのときは、いくつかのオプショ
ンの設定が変わる。
'textwidth' は 0 になる
'wrapmargin' は 0 になる
'modeline' は オフ になる
'expandtab' は オフ になる
またオプション
'fileformat' と
'fileformats' は無視され、読み込みと書
き込みは
'fileformat' が "unix" のときのようになる (1個の
<NL> が改行
になる)。
さらにオプション
'fileencoding' と
'fileencodings' も無視され、ファイ
ルは変換なしに読み込まれるようになる。
NOTE: オプション
'bin' がオンのときに新しくファイルを読み込むと、
autocommand によって設定が再び変えられ (例えば
'textwidth')、編集時に
問題を起こす ことがあるので注意。ファイルを読み込んだ後に再び
'bin' を
オンにするとよい。
変更されるオプションの値は記憶されているので、オプション
'bin' がオフに
戻るとそれらの値も復元される。それらの値はバッファごと独自に記憶される。
引数
|++bin|を使うと、
'binary'をオンにしてファイルを開くことができる。
これを使うと":set bin"としなくてすむ。":set bin"は編集する全てのバッファ
に対して効果を持つ。
'bin' がオンならば、ファイルを書き込むときに最終行に
<EOL> が付け加え
られるのは、元のファイルにすでに
<EOL> があるときだけである (普通は、
最終行に
<EOL> がないならVimはそれを付け加える。こうするとその分ファイ
ルが長くなる)。オプション
'endofline' を参照。
*'bioskey'* *'biosk'* *'nobioskey'* *'nobiosk'*
'bioskey' 'biosk' 切替 (既定ではオン)
グローバル
{Vi にはなく、MS-DOS版のみ}
オンのとき、キーボードで打ち込まれた文字を取得するためにバイオスが呼び
出される。これは
CTRL-C を認識するためにはよいが、コンソールでしか機能
しない。ターミナルをシリアルポートから利用する場合は、オフにすること。
'conskey' も参照。
*'bomb'* *'nobomb'*
'bomb' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
{Vimが |+multi_byte| 機能付きでコンパイルされたときの
み有効}
ファイルを書き込むときに以下の条件が満たされれば、BOM (Byte Order Mark
--訳注: バイト順マーク。Unicodeを適切に扱うために使われるマーク) がファ
イル先頭に付けられる。
- このオプションがオンである
-
'binary' がオフである
-
'fileencoding' が "utf-8", "ucs-2" または "ucs-4" である (リトルエン
ディアンとビッグエンディアンの違いは無視)
アプリケーションの中には、ファイルのエンコーディングを認識するために
BOM を使うものがある。MS-Windows で UCS-2 ファイルのためによく使われる。
しかし、アプリケーションによってはこれが問題になることもある。例えば
"cat file1 file2" とすると、file2の BOM がファイル途中に現れてしまう。
gcc は BOM を受け付けない。
ファイルを読み込むときに
'fileencodings' が "ucs-bom" で始まるならば、
BOM が存在するかどうかが調べられ、その結果に従って
'bomb' が設定される。
'binary' がオンでなければ BOM は編集時には取り除かれ、ユーザの目には触
れない。
'bomb' をオフにしたり
'binary' をオンにしたり
'fileencodings'
を変えなければ、ファイルの書き込み時に再び BOM が復元される。
*'breakat'* *'brk'*
'breakat' 'brk' 文字列 (既定では " ^I!@*-+;:,./?")
グローバル
{Vi にはない}
{Vimが |+linebreak| 機能付きでコンパイルされたときの
み有効}
オプション
'linebreak' がオンのとき、どの文字のところで行が折り返され
て表示されるかを、このオプションで指定する。これが機能するのはASCIIと
8bit文字(
'encoding'が8bitエンコーディングのとき)だけである。
*'browsedir'* *'bsdir'*
'browsedir' 'bsdir' 文字列 (既定では "last")
グローバル
{Vi にはなく、Motif, Athena, Mac, Win32のGUI版のみ}
ファイルブラウザの開始時、どのディレクトリを開くかを指定する。
last 前回にファイルブラウザでファイルを開く・または保存した
ディレクトリ
buffer バッファで開いているファイルのディレクトリ
current カレントディレクトリ
{path} {path} で指定されたディレクトリ
*'bufhidden'* *'bh'*
'bufhidden' 'bh' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+quickfix| 機能付きでコンパイルされたときの
み有効}
バッファがウィンドウ内に表示されなくなったときの動作を指定する。
<empty> グローバルオプション
'hidden' に従う
hide バッファを隠す (解放しない)。
'hidden' がオフでもそうす
る。
unload バッファを解放する。
'hidden' がオフのときも、コマンド
|:hide| を使ったときもそうする。
delete バッファをバッファリストから削除する。
'hidden' がオン
のときも、
|:hide| を使ったときも、
|:bdelete| を使った
ときのように、リストから削除する。
wipe バッファをバッファリストから完全に削除(wipe out)する。
'hidden' がオンのときも、
|:hide| を使ったときも、
|:bwipeout| を使ったときのように、リストから削除する。
注意: "unload", "delete", "wipe"を設定すると、バッファの変更は警告
無しに失われる。また、これらの値はバッファを一時的に切り替えるような自
動コマンドを壊す可能性があります。
このオプションは
'buftype' や
'swapfile' と共に使われ、特殊な用途のバッ
ファを指定する。
|special-buffers| を参照。
*'buflisted'* *'bl'* *'nobuflisted'* *'nobl'* *E85*
'buflisted' 'bl' 切替 (既定ではオン)
バッファについてローカル
{Vi にはない}
オンのときは、バッファはバッファリストに表示される。オフのときは、その
バッファはコマンド ":bnext" や ":ls" およびバッファメニュー等の対象に
ならない。
ファイル名やマークを思い出したりするためだけのバッファでは、このオプショ
ンはオフになる。バッファの編集を始めたときは、このオプションはオンにな
る。しかし ":buffer" でバッファに移動したときはオンにはならない。
*'buftype'* *'bt'* *E382*
'buftype' 'bt' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+quickfix| 機能付きでコンパイルされたときの
み有効}
このオプションはバッファの種類を指定する。
<empty> 普通のバッファ
nofile ファイルと関連がなく、書き込まれる予定のないバッファ
nowrite 書き込まれる予定のないバッファ
acwrite いつも自動コマンドBufWriteCmdで書き込まれる予定のバッ
ファ。
{Vimが|+autocmd|機能付きでコンパイルされたとき
のみ有効}
quickfix エラーリスト／ロケーションリスト用の quickfix バッファ
(
|:cwindow|,
|:lwindow|を参照)
help ヘルプバッファ (ユーザが手動でこれに設定することはない
はずである)
このオプションはオプション
'bufhidden' や
'swapfile' と共に使われ、特
殊な用途のバッファを指定する。
|special-buffers| を参照。
このオプションの変更には十分注意すること。多くの副作用が起こるかもしれ
ない！
"quickfix" バッファはエラーリストとロケーションリストにのみ使われる。
この値はコマンド
|:cwindow| と
|:lwindow|で設定され、ユーザが変更するこ
とはないはずである。
"nofile" バッファと "nowrite" バッファは似ている。
両方とも、 バッファの内容はファイルに書き込まれない。":w" が使え
ない (":w 新ファイル名" は使える)。
両方とも、 バッファの内容が変更された
'modified' と認識されること
がない。Vimの終了時等、変更点が失われるときでも警告が
現れない。
両方とも、 スワップファイルはメモリを大量に消費したときのみ作られ
る (
'swapfile' がオフだと、スワップファイルは作られな
い)。
nofile だけは、 バッファ名は固定され、ファイル名のようには扱われない。
|:cd| の結果としてバッファ名が変わることはない。
*E676*
"acwrite"は"nofile"と同様にバッファ名がファイルと関係していないことを
意味するが、"nofile"と違って保存される。すなわち、"nofile"と"nowrite"
違って":w"ができ、変更されたバッファを保存せずに破棄することはできない。
これを保存するには、マッチする自動コマンド
|BufWriteCmd|,
|FileWriteCmd|,
|FileAppendCmd|がなければならない。
*'casemap'* *'cmp'*
'casemap' 'cmp' 文字列 (既定では"internal,keepascii")
グローバル
{Vi にはない}
{Vimが|+multi_byte|機能付きでコンパイルされたときのみ
有効}
大文字・小文字の変更について詳細を指定する。このオプションはコンマ区切
りで以下の単語を含む:
internal 内部の大文字・小文字対応関数を使う。現在のロケールに
よって対応が変更されない。これは
'encoding'がユニコード
エンコーディング, "latin1", "iso-8859-15"のときのみ問
題になる。"internal"が除かれるとシステムライブラリ関数
towupper()とtowlower()が利用可能ならば使われる。
keepascii アスキー文字(0x00から0x7f)についてはUS大文字小文字対応
を使う。現在のロケールは効果を持たない。
これはおそらくトルコ語でだけ問題になる。
*'cdpath'* *'cd'* *E344* *E346*
'cdpath' 'cd' 文字列 (既定では環境変数 $CDPATH または ",,")
グローバル
{Vi にはない}
{Vimが |+file_in_path| 機能付きでコンパイルされたとき
のみ有効}
コマンド
|:cd| や
|:lcd| を使ったときに検索されるディレクトリのリスト。
ただし検索されるディレクトリが "/", "./" や "../" で始まるときはこのオ
プションは使われない。
オプション
'cdpath' には、
'path' と同様の指定方法を使う。
|file-searching| も参照。
既定値は環境変数 $CDPATH から取り込まれるが、カレントディレクトリを最
初に探すために "," が先頭に挿入される。
$CDPATH から取り込まれたものが望ましくないときは、値を上書きするために、
次のコマンドを適当に修正し、ユーザのファイル vimrc に加えること。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。(
'cdpath' の値の一部は、
ファイル名を展開するためにシェルに渡すことができる)。
*'cedit'*
'cedit' 文字列 (Viの既定値: "", Vimの既定値:
CTRL-F)
グローバル
{Vi にはない}
{Vimが |+vertsplit| 機能付きでコンパイルされたときの
み有効}
Command-lineモードで、Command-lineウィンドウを開くために使われるキー。
オプション
'compatible' がオフならば、既定では
CTRL-F である。
non-printable なキー (訳注: 文書先頭を参照) しか指定できない。キーは単
一の文字として設定することもできるが、それでは入力しにくい。<> を使っ
た表記を推奨する。例:
|Nvi| にもこのオプションがあるが、最初の1文字だけが使用される。
|cmdwin| を参照。
*'charconvert'* *'ccv'* *E202* *E214* *E513*
'charconvert' 'ccv' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+multi_byte| 機能および |+eval| 機能付きでコ
ンパイルされたときのみ有効}
文字エンコーディングの変換に使われる expression を定める。これは読み込
まれようとしているファイルや書き込みをしたファイルのエンコーディングが、
望むものと違うときに評価される。
オプション
'charconvert' の値は、内部関数 iconv() がサポートされ、それ
による変換が可能ならば使われることはない。ずっと高速なため、iconv() の
使用を推奨する。
'charconvert' は標準入力 (stdin
|--|) から読み込みときには使われない。
なぜなら変換元のファイルが存在しないからだ。まずテキストの内容をファイ
ルに保存しなければいけない。
使われる expression は、変換成功時には空文字列または0、失敗時には非0を
返さなければならない。
使用可能なエンコーディング名は
'encoding' で設定されている (訳注: よく
分からない。原文は The possible encoding names encountered are in
'encoding'.)。それに加え、
'fileencodings' と
'fileencoding' に設定され
ているエンコーディング名も使われる。
"latin1", "unicode", "ucs-2", "ucs-4", "utf-8" の間の変換はVimの内部で
行われ、
'charconvert' は使われない。
'viminfo' の中にフラグ 'c' が含ま
れるならば、
'charconvert' はファイル viminfo の変換にも使われる。また
Unicode の変換にも使われる。
例:
関連するVimの変数は以下の通り。
v:charconvert_from 現在のエンコーディング名
v:charconvert_to 希望するエンコーディング名
v:fname_in 入力ファイル名
v:fname_out 出力ファイル名
Note 変数 v:fname_in と v:fname_out とは、決して同じになってはいけない
ので注意。
Note v:charconvert_from と v:charconvert_to の値は
'encoding' と異なる
かもしれないので注意。Vim内部では UCS-2 または UCS-4 の代わりには
UTF-8 を使っている。
Vim は
'charconvert' を用いたエンコーディング変換では暗号化をしない。
変換後に暗号化をしたいなら、
'charconvert' にそうさせる必要がある。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'cindent'* *'cin'* *'nocindent'* *'nocin'*
'cindent' 'cin' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
{Vimが |+cindent| 機能付きでコンパイルされたときのみ
有効}
Cプログラムファイルの自動インデントを行う。Insertモードで再インデント
を引き起こす文字列を指定するにはオプション
'cinkeys' を、好みのインデ
ントスタイルを設定するには
'cinoptions' を参照。
'indentexpr' の値が空でないなら、それは
'cindent' の設定を上書きする。
'lisp' がオフで、
'indentexpr' と
'equalprg' の両方の値が空なら、"=" に
よるインデントはこのアルゴリズムを使い、外部プログラムを使わない。
|C-indenting| を参照。
'cindent' の動作が気に入らないならば、
'smartindent' か
'indentexpr' を
試してみること。
このオプションは
'paste' がオンのときには使われない。
NOTE: このオプションは
'compatible' がオンのときはオフになるので注意。
*'cinkeys'* *'cink'*
'cinkeys' 'cink' 文字列 (既定では "0
{,0},0),:,0#,!^F,o,O,e")
バッファについてローカル
{Vi にはない}
{Vimが |+cindent| 機能付きでコンパイルされたときのみ
有効}
Insertモードで入力されたときに、現在行の再インデントを引き起こす文字の
リスト。オプション
'cindent' がオンで、かつ
'indentexpr' が空の時のみ
使われる。
このオプションの設定方法については
|cinkeys-format| を参照。
また
|C-indenting| を参照。
*'cinoptions'* *'cino'*
'cinoptions' 'cino' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+cindent| 機能付きでコンパイルされたときのみ
有効}
このオプションは、
'cindent' でのC言語ソース内の行の再インデント方法に
影響を与える。このオプションの値については
|cinoptions-values| を、一
般的なC言語ソースのインデントの情報については
|C-indenting| を参照。
*'cinwords'* *'cinw'*
'cinwords' 'cinw' 文字列 (既定では "if,else,while,do,for,switch")
バッファについてローカル
{Vi にはない}
{Vimが |+cindent| 機能と |+smartindent| 機能(両方)付
きでコンパイルされたときのみ有効}
オプション
'smartindent' か
'cindent' がオンのとき、ここに指定したキー
ワードの次の行は、さらにインデントされる。
'cindent' がオンのときには、
適切な場所 ({} の内側) でのみ機能する。
NOTE 'ignorecase' は
'cinwords' の値には適用されないので注意。大文字か
小文字かを区別したくないなら、値に両方を指定すること。例: "if,If,IF"
*'clipboard'* *'cb'*
'clipboard' 'cb' 文字列 (既定値はX-windowsでは
"autoselect,exclude:cons\|linux"
それ以外では "")
グローバル
{Vi にはない}
{VimのGUIバージョンか |+xterm_clipboard| 機能付きでコ
ンパイルされたもののみ有効}
コンマ区切りのキーワードのリストを指定する。
認識されるのは、以下のキーワードである。
unnamed これが含まれると、コピー、削除、変更、ペーストなどの操
作で、普通なら無名レジスタが使われるところで、全てク
リップボードレジスタ "*" が使われるようになる。ただし
レジスタ名を陽に指定すれば、オプション
'clipboard' に
"unnamed" が含まれているかいないかに関わらず、指定され
たレジスタが使われる。またクリップボードレジスタは、"*
という記法を用いれば常にアクセスできる。
|gui-clipboard| も参照。
unnamedplus "unnamed" と似ていますがヤンク以外のすべての操作でレジ
スタ '*' ではなくレジスタ '+' (
|quoteplus|) が使われま
す。ヤンクしたときはレジスタ '+' にテキストがコピーさ
れ、"unnamed" が指定されていればレジスタ '*' にもコ
ピーされます。
|+X11| 機能が有効な場合のみ利用可能。
利用できるかどうかは次のコマンドで確認できます:
autoselect
'guioptions' のフラグ 'a' のように働く: これが含まれる
と、Visualモードが開始されるたび、または Visual選択範
囲が変更されるたびに、Vimはウィンドウシステムのグロー
バルなクリップボードのオーナーになろうとするか、選択さ
れたテキストをクリップボード用レジスタ "* を使ってクリッ
プボードにコピーしようとする。詳細は
|guioptions_a| と
|quotestar| を参照。GUI機能が有効のときは
'guioptions'
のフラグ 'a' が使用され、無効のときはこの "autoselect"
フラグが使用される。また、モードレスなセレクションにも
適用される。
autoselectml "autoselect" と似ているが、モードレスセレクションのみ
に適用される。
'guioptions' のフラグ 'A' と比較してみる
こと。
html クリップボードの内容が HTML であるとき、貼り付け時に使
われる。テキストをクリップボードにコピーするとき、
HTML としてマークアップする。Firefox で描画された HTML
あをコピーして Vim で HTML ソースとして貼り付けるとき
や、Vim で HTML を選択して Firefox のリッチエディット
ボックスに貼り付けるときに使われる。
これを一時的にのみ使いたい場合は BufEnter 自動コマンド
を使うといいかもしれない。
GTK 2 以降のみ対応している。
|+multi_byte| 機能が有効なときのみ利用可能。
exclude:
{pattern}
ターミナルの名前
'term' にマッチするパターンを定義する。
パターンがマッチすると、Xサーバとの通信がなされなくなる。
このオプションは以下の場合に便利である。
- Vimをコンソールで使用しているとき。
- アプリケーションを別のディスプレイで使うため、環境変
数 $DISPLAY が設定されているとき。
- コンソールではXサーバと通信してほしくないが、ターミ
ナルエミュレータ上では通信してほしいとき。
- コンソールでVimを使用している最中にXサーバが終了させ
られ、Vimをキルせざるを得ないかもしれないとき。
Xサーバと全く通信しないようにするには、次のようにする。
これは引数
|-X| を使用したのと同じ効果を持つ。
Note Xサーバと通信していないとき、ウィンドウタイトルは
復元されず、クリップボードにはアクセスできない。
'magic' の値は無視され、
{pattern} は
'magic' がオンの
ときのように解釈される。オプション
'clipboard' の値の
残りは
{pattern} として認識されるので、"exclude" は最
後に指定しなければならない。
*'cmdheight'* *'ch'*
'cmdheight' 'ch' 数値 (既定では 1)
グローバル
{Vi にはない}
コマンドラインに使われる画面上の行数。
|hit-enter| プロンプトの出現を避
けるのに役立つ。
各タブページが異なる値を持てるようにするために、このオプションの値はタ
ブページに保存される。
*'cmdwinheight'* *'cwh'*
'cmdwinheight' 'cwh' 数値 (既定では 7)
グローバル
{Vi にはない}
{Vimが |+vertsplit| 機能付きでコンパイルされたときの
み有効}
コマンドライン・ウィンドウに使われる画面上の行数。
|cmdwin| を参照。
*'colorcolumn'* *'cc'*
'colorcolumn' 'cc' 文字列 (既定では "")
ウィンドウについてローカル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ有
効}
'colorcolumn' はスクリーンの列をカンマ区切りで指定します。指定された列
は ColorColumn (
|hl-ColorColumn|) で強調表示されます。テキストを整列す
るときに便利です。スクリーンの表示は遅くなります。
列番号は絶対値で指定するか、番号に '+' か '-' を前置して
'textwidth'
からの相対値として指定します。
'textwidth' がゼロのときは '-' と '+' で指定されたアイテムは使用されま
せん。
最大で 256 個の列を強調表示できます。
*'columns'* *'co'* *E594*
'columns' 'co' 数値 (既定では 80 またはターミナルの幅)
グローバル
{Vi にはない}
画面上の列幅を設定する。普通このオプションはターミナルの初期化の時点で
設定され、手動で設定する必要はない。
|posix-screen-size|も参照。
VimがGUI内やサイズ変更可能なウィンドウ内で実行されているときは、このオ
プションを変更するとウィンドウサイズも変更される。GUIでだけこのサイズ
を使用したい場合は、このコマンドを
|gvimrc|に書くこと。
ユーザがこのオプションを変更したのに、Vimがディスプレイの列幅の物理的
な値を変更できなかったら、ディスプレイ表示がめちゃめちゃになるおそれが
ある。GUIでは常にその可能性があるので、Vimは桁数を画面に収まる値に制限
している。可能なウィンドウ幅の最大値を取得するには、次のコマンドを使
う:
最小値は12、最大値は10000。
(訳注: オプション
'lines' も参照)
*'comments'* *'com'* *E524* *E525*
'comments' 'com' 文字列 (既定では
"s1:/*,mb:*,ex:*/,://,b:#,:%,:XCOMM,n:>,fb:-")
バッファについてローカル
{Vi にはない}
{Vimが |+comments| 機能付きでコンパイルされたときのみ
有効}
コメント行の始まりとなる文字列の、コンマ区切りのリスト。
|format-comments| を参照。'\' を使って値にスペースを含める方法について
は、
|option-backslash| を参照。
*'commentstring'* *'cms'* *E537*
'commentstring' 'cms' 文字列 (既定では "/*%s*/")
バッファについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
コメント用のテンプレート (雛形)。値の中の "%s" はコメントの内容と置き
換えられる。現在のところ、折り畳み用のマーカを追加するためにのみ使用さ
れている。
|fold-marker| を参照。
*'compatible'* *'cp'* *'nocompatible'* *'nocp'*
'compatible' 'cp' 切替 (既定では オン、ファイル
|vimrc|または
|gvimrc|が発見されたらオフ)
グローバル
{Vi にはない}
VimをなるべくVi互換にするか、便利な機能を使えるようにするかを決定する。
これは、特別な種類のオプションである。このオプションの値が変更されると、
それに伴って他のオプションも変更されるからだ。＊注意: このオプションを
変更すると、予期しない効果が数多く現れる。キーマップの解釈は変わり、ア
ンドゥも違った方法で行われる、等々。このオプションをファイル vimrc 内
で設定するなら、一番先頭に置くこと。
既定ではオンなので、その他のオプションにはViの既定値が使われる。この既
定値は、VimをViと全く同じように使うことを望み、オプション
'compatible'
について知りもしない、または知りたいとも思わない人たちのためのものであ
る。
Vimが立ち上がる間にファイル
|vimrc| または
|gvimrc| が見つかると、こ
のオプションはオフにされ、その他のオプションで変更されていないものは、
みなVimの既定値に設定される。要するに、Vimはファイル
|vimrc| または
|gvimrc| が存在するならVimの既定値を、存在しないならViの既定値を使うの
だ (
Note: システム全体用のファイルvimrc や引数
|-u|で指定されるファイ
ルは関係ないことに注意)。
|compatible-default| と
|posix-compliance| も
参照。
このオプションは引数 "-C" でオンに、引数 "-
N" でオフにできる。
|-C| と
|-N| を参照。
オフに設定すると、「Viの既定値」と「Vimの既定値」が異なっているオプショ
ンについて、Vimの既定値が用いられるようになる。下の表で '+' がついてい
るものを参照。その他のオプションは影響を受けない。
オンにすると、他のオプションがいくつか変更され、Vimはできる限りVi互換
を保とうとする。下の表を参照。これはVi互換の編集方法に戻りたいと思うと
きに使うことができる。
'cpoptions' も参照。
オプション + Viの既定値 効果
'allowrevins' オフ コマンド
CTRL-_ なし
'backupcopy' Unix: "yes" バックアップファイルがコピーになる
他: "auto" バップアップはコピーまたはリネーム
'backspace' "" 普通のバックスペース
'backup' オフ バックアップファイルなし
'cindent' オフ C言語ファイルにインデントなし
'cedit' + ""
|cmdwin| を開くキーなし
'cpoptions' + (全フラグ) Vi互換のフラグ
'cscopetag' オフ ":tag" に cscope を使わない
'cscopetagorder' 0
|cscopetagorder| を参照
'cscopeverbose' オフ
|cscopeverbose| を参照
'digraph' オフ ダイグラフなし
'esckeys' + オフ Insertモードで
<Esc> で始まるキーなし
'expandtab' オフ タブはスペースに展開されない
'fileformats' + "" 自動ファイルタイプ決定なし
"dos,unix" (ただし DOS, Windows と OS/2 以外で)
'formatoptions' + "vt" Vi互換の文書整形
'gdefault' オフ ":s" でフラグの既定値に 'g' なし
'history' + 0 コマンドラインの履歴なし
'hkmap' オフ ヘブライ語用キーボードマップなし
'hkmapp' オフ phoneticヘブライ語用キーボードマップなし
'hlsearch' オフ 検索でマッチした文字列に強調なし
'incsearch' オフ インクリメンタル・サーチなし
'indentexpr' "" expression によるインデントなし
'insertmode' オフ Insertモードでの開始なし
'iskeyword' + "@,48-57,_" キーワードはアルファベットと数字と '_'
'joinspaces' オン ピリオドの後ろには空白を2個挿入
'modeline' + オフ モードラインなし
'more' + オフ リスト表示が止まらない
'revins' オフ 右から左の挿入なし
'ruler' オフ ルーラなし
'scrolljump' 1 ジャンプスクロールなし
'scrolloff' 0 スクロールにオフセットなし
'shiftround' オフ インデントは shiftwidth の整数倍でない
'shortmess' + "" メッセージの短縮なし
'showcmd' + オフ コマンドの文字は表示されない
'showmode' + オフ 現在のモードは表示されない
'smartcase' オフ 大文字小文字の無視は自動にならない
'smartindent' オフ 高度なインデントなし
'smarttab' オフ 高度なタブ挿入なし
'softtabstop' 0 タブは常に
'tabstop' を基準
'startofline' オン いくつかのコマンドで行頭に移動する
'tagrelative' + オフ タグファイル名は相対的でない
'textauto' + オフ 自動改行コード決定なし
'textwidth' 0 自動行分割なし
'tildeop' オフ ティルデはオペレータではない
'ttimeout' オフ ターミナルの時間切れなし
'whichwrap' + "" 左から右への移動は行を超えない
'wildchar' +
CTRL-E 現在の値が
<Tab> のときのみ、コマンド
ライン補完に
CTRL-E を使う
'writebackup' オンかオフ
|+writebackup| 機能に依る
*'complete'* *'cpt'* *E535*
'complete' 'cpt' 文字列 (既定では: ".,w,b,u,t,i")
バッファについてローカル
{Vi にはない}
コマンド
CTRL-P や
CTRL-N によるキーワード補完
|ins-completion| の動作
を指定する。このオプションは行全体の補完
|i_CTRL-X_CTRL-L| にも適用さ
れる。このオプションは補完の方法と、キーワード検索の対象となる場所を示
す、コンマ区切りのフラグのリストである。
. カレントバッファから検索 (
'wrapscan' の値は無視)
w 別のウィンドウ内のバッファから検索
b バッファリスト内の、現在読み込まれている別のバッファから検索
u バッファリスト内の、現在読み込まれていない別のバッファから検索
U バッファリストにないバッファから検索
k
'dictionary' で指定されたファイルから検索
kspell 現在有効化されているスペルチェックを使う
|spell|
k
{dict} {dict} で与えられたファイルから検索。"k" を複数指定してもよい。
ファイル名はパターンでも指定できる。例:
s
'thesaurus' で指定されたファイルから検索
s
{tsr} {tsr} で与えられたファイルから検索。 "s" を複数指定してもよい。
ファイル名はパターンでも指定できる。
i カレントファイルとインクルードされるファイルから検索
d カレントファイルとインクルードされるファイルから、定義された名
前またはマクロを検索
|i_CTRL-X_CTRL-D|
] タグ補完
t "]" と同じ
読み込まれていないバッファでは、何しろ読み込まれていないのだから、
|:autocmd| は実行されていない。そのため、ある種のファイルからは思いも
しないキーワードを補完してしまうことがある (gzip圧縮されたファイルな
ど)。読み込まれていないバッファは、行全体の補完には使われない。
既定では ".,w,b,u,t,i" となっていて、これは検索対象を次のように指定し
ている。
1. カレントバッファ
2. 別のウィンドウ内のバッファ
3. 他の読み込まれたバッファ
4. バッファリスト内の読み込まれていないバッファ
5. タグ
6. インクルードされるファイル
CTRL-N と
CTRL-P は
'iskeyword' を利用した全てのファイル名展開で使用で
きる (つまり辞書
|i_CTRL-X_CTRL-K| 、インクルードされるパターン
|i_CTRL-X_CTRL-I|、タグ
|i_CTRL-X_CTRL-]| および通常の展開)。
*'completefunc'* *'cfu'*
'completefunc' 'cfu' 文字列 (既定では空)
バッファについてローカル
{Vi にはない}
{Vimが |+eval| と |+insert_expand| 機能付きでコンパイ
ルされたときのみ有効}
このオプションは入力モードの
CTRL-X CTRL-U |i_CTRL-X_CTRL-U|での補完に
使われる関数を指定する。
その関数がどのように起動され、何を返すべきかについての説明は
|complete-functions|を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'completeopt'* *'cot'*
'completeopt' 'cot' 文字列 (既定では "menu,preview")
グローバル
{Vimが|+insert_expand|機能付きでコンパイルされたとき
のみ有効}
{Vi にはない}
入力モードでの補完
|ins-completion|についてのオプションのコンマ区切りの
リスト。サポートされている値は次の通り:
menu ポップアップメニューで補完候補を表示する。ポップアップメ
ニューは、候補が2個以上あり、十分な数の色が使用できるとき
だけ表示される。
|ins-completion-menu|を参照。
menuone 候補が1つしかないときもポップアップメニューを使う。候補に
ついて付加的な情報があるときに便利である。例えば、それがど
のファイルに含まれているかなど。
longest 候補の文字列の最長の共通部分だけを挿入する。メニューが表示
されているならば
CTRL-Lでさらに文字を挿入することができる。
大文字・小文字が同一視されるかどうかは補完の種類による。バッ
ファのテキストについてはオプション
'ignorecase'が適用される。
preview 現在選択されている候補についての付加的な情報をプレビュー
ウィンドウに表示する。"menu"または"menuone"と組み合わせた
ときのみ有効。
*'concealcursor'* *'cocu'*
'concealcursor' 'cocu' 文字列 (既定では: "")
ウィンドウについてローカル
{Vi にはない}
{Vim が |+conceal| 機能付きでコンパイルされたときのみ
有効}
カーソル行のテキストを Conceal 表示するモードを設定します。現在のモー
ドがこのオプション値に含まれているなら他の行と同様に Conceal 表示され
ます。
n ノーマルモード
v ビジュアルモード
i インサートモード
c コマンドライン編集 (
'incsearch' 用)
'v' はカーソル行だけでなくビジュアル選択された行全体に適用されます。
便利な値は "nc" です。これはヘルプファイルで使われています。移動してい
るときはテキストは Conceal 表示されますが、テキストを入力したりビジュ
アル選択したりするときは実際のテキストが表示されるので、自分の操作を視
覚できます。
カーソルの位置は実際の表示とはことなる場合があるので注意してください。
例えば縦に移動することで列が変わることがあります。
'conceallevel' 'cole' *'conceallevel'* *'cole'*
数値 (既定では 0)
ウィンドウについてローカル
{Vi にはない}
{Vim が |+conceal| 機能付きでコンパイルされたときのみ
有効}
"conceal" 構文属性 (
|:syn-conceal|) のテキストをどのように表示するかを
設定します:
値 効果
0 テキストは通常通り表示されます
1 各ブロックの Conceal されたテキストは一つの文字に置換
されます。構文アイテムに代理文字 (
|:syn-cchar| 参照)
が指定されていないときは
'listchars' の設定が使われま
す (初期設定はスペース)。
文字は "Conceal" 強調グループを使って強調表示されま
す。
2 Conceal されたテキストは構文アイテムに指定された代理文
字 (
|:syn-cchar|) として表示されます。それが指定されて
いないときは完全に非表示になります。
3 Conceal されたテキストは完全に非表示になります。
Note: テキストの編集やコピーの操作を妨げないようにするため、カーソル行
の Conceal テキストは非表示になりません。これは
'concealcursor' オプ
ションで変更できます。
*'confirm'* *'cf'* *'noconfirm'* *'nocf'*
'confirm' 'cf' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オプション
'confirm' がオンならば、バッファへの変更を保存していないと
実行に失敗する操作 (例えばコマンド ":q" と ":e") の際、ダイアログ
|dialog| を開いてファイルを保存するかどうか尋ねる。これがオンになって
いても、意図的に変更を廃棄したいなら ! を使える。
'confirm' がオフでも、コマンド
|:confirm| で個別に確認を求めることがで
きる (これはキーマッピングで使うととても便利である)。
関数
|confirm()| と
'guioptions' のフラグ 'v' も参照。
*'conskey'* *'consk'* *'noconskey'* *'noconsk'*
'conskey' 'consk' 切替 (既定ではオフ)
グローバル
{Vi にはない} {VimのMS-DOS版のみ}
オンのとき、キーボードの文字を受け取るのに直接コンソール出入力が使われ
る。これはたいていの場合有効である。
'bioskey' も参照。合わせて、3種類
のコンソール入力が使える。
'conskey' 'bioskey' action
オン オンかオフ 直接コンソール入力
オフ オン BIOS
オフ オフ 標準入力
*'copyindent'* *'ci'* *'nocopyindent'* *'noci'*
'copyindent' 'ci' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
新規行を自動インデントするとき、既存の行のインデント構造をコピーする。
普通、新しい行のインデントは
|'expandtab'|が有効になっていないかぎり
(この場合は全てスペースになる)、まずタブが使われ、足りない部分がスペー
スで埋められる。このオプションを有効にすると、既存の行のインデントにど
んな文字が使われていようとそれを新規行にコピーする。
'expandtab' はこれ
らの文字には影響せず、タブはタブのままになる。新規行のインデントが既存
の行よりも深いならば、その差の部分は通常の方法で埋められる。
NOTE:
'compatible'がオンにされると
'copyindent'はオフになる。
'preserveindent'も参照。
*'cpoptions'* *'cpo'*
'cpoptions' 'cpo' 文字列 (Vimの既定値: "aABceFs", Viの既定値: 全フラグ)
グローバル
{Vi にはない}
1文字のフラグの列で設定する。フラグが設定されると、対応する動作がVi互
換になる。大部分、またはある程度のVi互換が求められるときに使われる。
'cpoptions' は "compatible-options (互換オプション)" の意味である。
読みやすくするためにコンマを入れてもよい。
将来追加されるフラグによる問題を避けるため、コマンド ":set" では "+="
と "-=" を使うこと
|add-option-flags|。
NOTE: このオプションは
'compatible' がオンのときはVi互換の値に設定され、
'compatible' がオフのときはVim互換の値に設定されるので注意。
NOTE: Viの既定値が使われるようになっており、さらに環境変数$VIM_POSIXが
存在するとき、Vim起動時にこのオプションがPOSIXの既定値にセットされる
|posix|。これによってVimがPOSIX仕様に近い挙動をするようになる。
フラグ 動作
*cpo-a*
a これが含まれると、":read" にファイル名の引数を与えたと
き、そのファイルをカレントウィンドウの代替ファイルに設
定する。
*cpo-A*
A これが含まれると、":write" にファイル名の引数を与えた
とき、そのファイルをカレントウィンドウの代替ファイルに
設定する。
*cpo-b*
b ":map" 内の "\|" がコマンドの終端と見なされるようにな
る。'\' はキーマッピングの一部に、'|' の次のテキストは
次のコマンドと見なされる。'|' をキーマッピングに含める
には、'\' でなく
CTRL-V を使うこと。キーマッピングや略
語やメニューや autocmd コマンドの全てに適用される。
|map_bar| も参照。
*cpo-B*
B '\' が、":menu" のメニューから実行される部分やキーマッ
ピングや略語において、特別な意味を持たなくなる。'\' を
CTRL-V のように使いたいのならこのフラグを取り除くこと。
例えば、":map X \
<Esc>" で X がマップされるのは、
'B' が含まれたとき: "\^[" (^[ は本当の
<Esc>)
'B' が除かれたとき: "
<Esc>" (5個の文字)
(どちらの場合も '<' が除かれているとする)
*cpo-c*
c (訳注: 検索でマッチする文字列があった後) カーソル位置
のマッチの終わり(ただし次行の開始位置を越えない)から次
の検索を行う。このフラグが含まれないと、次の検索はカー
ソル位置の1文字後から始まる。'c'が含まれると、"/abab"
で検索したとき "abababababab" には3回しかマッチしない
が、'c' が含まれないと5回マッチする。
*cpo-C*
C ":source" で読み込まれたファイルのうち、'\' で始まる行
を連結しない。
|line-continuation| を参照。
*cpo-d*
d
'tags' 内で "./" という記法を使ったとき、タグファイル
はカレントファイルのディレクトリでなく、カレントディレ
クトリから探す。
*cpo-D*
D
|r|,
|f| や
|t| のような、文字を引数に取る Normalモー
ドコマンドの後で、
CTRL-K によるダイグラフの入力ができ
なくなる。
*cpo-e*
e ":@r" でレジスタの内容を (訳注: Exコマンドとして) 実行
するとき、レジスタが行全体を保存したものでないときでも、
常に最終行に
<CR> を付け加える。このフラグが含まれない
ときは、レジスタの内容が行全体を保存したものでなく、か
つ
<CR> で終わらないならば、実行すると最終行はコマンド
ラインに表示され、
<CR> を打ち込むまでは編集できる。
*cpo-E*
E 空の範囲に "y", "d", "c", "g~", "gu", "gU" などのコマ
ンドを使うとエラーになる。オペレータは作用する対象が最
低でも1文字ないと使えない。例: これが含まれると、最初
の桁で "y0" を行うとエラーになる。
*cpo-f*
f これが含まれると、カレントバッファにファイル名がまだ設
定されていないなら、":read" にファイル名の引数を与えた
とき、そのファイル名をカレントバッファのファイル名に設
定する。
*cpo-F*
F これが含まれると、カレントバッファにファイル名がまだ設
定されていないなら、":write" にファイル名の引数を与え
たとき、そのファイル名をカレントバッファのファイル名に
設定する。
|cpo-P|も参照。
*cpo-g*
g ":edit" を引数なしで使うと1行目に移動する。
*cpo-H*
H 空白のみを含む行の上で"I"を使ったとき、最後の空白の前
から挿入する。このフラグが含まれていないと、最後の空白
の後から挿入を開始する。
*cpo-i*
i これが含まれると、ファイルの読み込み中に中断が起きたと
き、ファイルは変更されたままになる。
*cpo-I*
I
'autoindent'によるインデントが挿入された直後にカーソル
を上下に移動したときインデントを削除しない。
*cpo-j*
j 行の連結時に追加する空白が、'.' の後のみ2個になり、'!'
や '?' の後は1個になる。
'joinspaces' も参照。
*cpo-J*
J 文
|sentence| は '.', '!' または '?' の後に2個の空白を
伴わなければならない。
<Tab> は空白とは見なされない。
*cpo-k*
k ":menu" で実行される部分や、キーマッピングや略語におい
て、直接入力されたキーコードを認識しない。例えば、
<Key> が ^[OA を送るなら (ここで ^[ は
<Esc> )、
":map X ^[OA" で X がマップされるのは、
'k' が含まれたとき: "^[OA" (3個の文字)
'k' が除かれたとき: "
<Key>" (1個のキーコード)
下の '<' も参照。
*cpo-K*
K キーマッピングの途中で、キーコードが完全に入力されるの
を待たない。This breaks mapping
<F1><F1> when
only part of the second
<F1> has been read. こうすると
<F1><Esc> と打ち込めばマッピングをキャンセルできる。
*cpo-l*
l 検索パターンの [] 範囲内で、'\' は文字通りに解釈され、
"\]", "\^", "\\" だけが特別な意味を持つ。
|/[]| を参照。
'l' が含まれたとき:
"/[ \t]" がマッチするのは
<Space>, '\' と 't'
'l' が除かれたとき:
"/[ \t]" がマッチするのは
<Space> と
<Tab>
|cpo-\|も参照。
*cpo-L*
L
'list' がオンのとき、
'wrapmargin',
'textwidth',
'softtabstop' とVirtual replaceモード (
|gR| を参照) で、
<Tab> の普通の数え方をせず、必ず 2 文字に数える。
*cpo-m*
m これが含まれると、対応する括弧の表示を0.5秒待つ。含ま
れていないと、対応する括弧の表示を0.5秒または次の文字
が打ち込まれるまで待つ。
'showmatch' を参照。
*cpo-M*
M これが含まれていない場合、"%"での括弧の対応にバックス
ラッシュを考慮に入れる。すなわち"( \( )"や"\( ( \)"で
外側の括弧同士が対応するようになる。"%"が含まれている
場合はVi互換になり、バックスラッシュは無視される。
*cpo-n*
n これが含まれているときは折り返された行のテキストの表示
に
'number' と
'relativenumber' によって行番号表示され
ている列も使用される。
*cpo-o*
o 検索コマンドの行オフセットは、次回の検索には使われない。
*cpo-O*
O ファイルが上書きされたとき、編集を始めたときにはそのファ
イルが存在しなかった場合でも警告しない。これは別人に突
然作り出されたファイルに対する防御である。Viはこれに警
告を出さなかった。
*cpo-p*
p Vi互換のLisp用インデント。これが含まれないと、いくらか
良いアルゴリズムが使われる。
*cpo-P*
P これとフラグ'F'が同時に含まれていると、コマンド":write"
で既存のファイルに追加するとき、カレントバッファの名前
がまだないならそのファイルの名前をカレントバッファの名
前にする。
|cpo-F|
*cpo-q*
q 複数の行を連結するとき、2行を連結するときと同じ位置に
カーソルを置く。
*cpo-r*
r リドゥ (コマンド ".") で検索を繰り返すとき、実際には
"/" を使う。
*cpo-R*
R フィルタされた行のマークを除去する。このフラグが入って
いないと、
|:keepmarks|を使ったときと同じようにフラグは
そのまま保たれる。
*cpo-s*
s バッファが初めてアクティブになる時点でバッファのオプショ
ンが設定される。これは
Vim version 3.0 と同じ動作であ
る。そして既定ではこの動作を行う。これが含まれないと、
オプションはバッファが作られた時点で設定される。
*cpo-S*
S バッファのオプションを常にバッファに移動する時点で設定
する (
'readonly',
'fileformat',
'filetype' と
'syntax'
以外)。これは (ほとんど) Vi互換の設定である。
オプションの値は元のカレントバッファでの値になる。ユー
ザがオプションを変更し、その後で別のバッファに移ると、
その値はコピーされる。事実上、バッファオプションを全て
のバッファに対しグローバルにしている。
's' 'S' バッファのオプションをコピーするタイミング
オフ オフ バッファが作られた時点
オン オフ バッファが初めてアクティブになった時点 (既定)
なし オン バッファに移動するたび (Vi互換)
*cpo-t*
t タグコマンドの検索パターンが "n" による検索の繰り返し
にも使われる。これが含まれないと、検索パターンの履歴に
は加えられるが、最終検索パターンは変化しない。
*cpo-u*
u アンドゥがVi互換になる。
|undo-two-ways| を参照。
*cpo-v*
v インサートモードにおいて、バックスペースで消した文字を
画面上に表示したままにしておく。このフラグが入っていな
いと、消された文字はすぐに画面から消える。このフラグが
入っていると、新しく入力された文字がバックスペースで消
された文字を上書きする。
*cpo-w*
w 空白の上で "cw" を使ったとき、1文字だけ変更して、次の
単語の始まりまでの空白は変更しない。
*cpo-W*
W 読み込み専用ファイルを上書きしない。これが含まれないと、
可能であれば ":w!" で読み込み専用ファイルも上書きでき
る。
*cpo-x*
x コマンドラインで
<Esc> を打ち込むとコマンドを実行する。
Vimでの既定ではコマンドライン入力を中止して元のモード
に戻る。それは
<Esc> は普通はコマンドの中止に使われる
からである。
|c_<Esc>| を参照。
*cpo-X*
X "R"でカウントを指定したとき、置換されるテキストが一度
だけ削除される。カウントをつけた"."で"R"を繰り返したと
きも同じ。
*cpo-y*
y コピーコマンドを "." でリドゥできる。
*cpo-Z*
Z オプション
'readonly'がオンになっているのに"w!"をしたと
き
'readonly'をオフにしない。
*cpo-!*
! フィルタコマンドをリドゥするとき、何であってもとにかく
最後に実行された外部コマンドを使う。これが含まれないと、
最後に実行された「フィルタ」コマンドが使われる。
*cpo-$*
$ 1行に対して変更をするとき、行を再描画せず、代わりに変
更されたテキストの最後に '$' を表示する。変更されたテ
キストはユーザが新しいテキストを入力したときに上書きさ
れる。その行はユーザがカーソルを挿入点から動かすコマン
ドを入力したときに再描画される。
*cpo-%*
% "%" でVi互換の対応検索が行われる。
"#if", "#endif" などを認識しない。
"/*" と "*/" も認識しない。
単引用符 ''' または二重引用符 '"' の内部の括弧も数えら
れる。すると括弧を含む文字列が対応を乱すことになる。例
えば、"if (strcmp("foo(", s))" などでは最初の括弧と最
後の括弧はマッチしない。これが含まれないと、単引用符ま
たは二重引用符の内部の括弧は特別な扱いを受ける。引用符
の外部の括弧の対応を調べるときは、引用符の内部は一切無
視される。引用符の内部の括弧の対応を調べるときは、対応
する括弧を探す (存在すれば)。これはC言語プログラムでは
とても良く機能する。
このフラグはCインデントなど他の機能にも使われる。
*cpo--*
- これが含まれていると最初の行や最後の行を越えるような上
下移動コマンドは失敗する。含まれているとカーソルが最初
の行または最後の行に移動する(既にカーソルがその行にな
いかぎり)。
コマンド"-", "k",
CTRL-P, "+", "j",
CTRL-N,
CTRL-J,
":1234"に適用される。
(訳注: 2行目で3kしたとき、これが含まれているならカーソ
ルは移動しない。含まれていないなら1行目へ移動する)
*cpo-+*
+ これが含まれていると、":write file"をしたとき、まだそ
のバッファが対応するファイルと異なっていても、そのバッ
ファのフラグ
'modified'がオフになる。
*cpo-star*
* ":*" を ":@" と同じように扱う。これが含まれないと、
":*" は ":'<,'>" の別名となり、Visualエリアを選択する。
*cpo-<*
< ":menu" で実行される部分や、キーマッピングや略語におい
て、
|<>| 記法による特殊キーの認識を行わない。例えば、
":map X
<Tab>" で X がマップされるのは、
'<' が含まれたとき: "
<Tab>" (5個の文字)
'<' が除かれたとき: "^I" (^I は本当の
<Tab>)
上の 'k' も参照。
*cpo->*
> レジスタにテキスト追加するとき、そのテキストの前に改行
文字をつける。
*cpo-;*
;
|,| や
|;| で最後の
|t| 検索を繰り返すとき、カーソルの
位置が検索文字の一つ手前であればカーソルを移動しない。
フラグが含まれていない場合は、カーソルはその文字を飛び
越えて次の場所にジャンプする。
次のものはPOSIXフラグである。起動時に$VIM_POSIXがセットされていない限
り、これらはViの既定値には含まれない。
|posix|
フラグ 動作
*cpo-#*
# "D", "o", "O"に対するカウントは効果がない。
*cpo-&*
& ":preserve"が使われたとき通常終了時にバッファはまだ読
み込まれているが、スワップファイルを保存する。このフラ
グはVimの終了時に判定される。
*cpo-\*
\ 検索パターンの範囲[]の中のバックスラッシュが文字どおり
に解釈される。"\]"だけがエスケープになる。
|/[]|を参照。
'\'が含まれていると"/[ \-]"は
<Space>, '\', '-'にマッチ
する。'\'が含まれていないと"/[ \-]"は
<Space>, '-'にマッ
チする。
|cpo-l|も参照。
*cpo-/*
/ コマンド
|:s|の置換後文字列に"%"を指定したとき、前回の
置換後文字列を使う。
|:s%|を参照。
*cpo-{*
{ コマンド
|{|と
|}|が行頭の文字"{"にも止まる。
*cpo-.*
. カレントバッファが変更されているとき、"!"をつけないか
ぎりコマンド":chdir"と":cd"が失敗する。Vimは開いたファ
イルのフルパスを覚えているため、これを必要としない。
*cpo-bar*
| 環境変数$LINESと$COLUMNSの値をシステム固有の関数で得ら
れたターミナルサイズより優先させる。
*'cryptmethod'* *'cm'*
'cryptmethod' 文字列 (既定では "zip")
グローバルまたはバッファについてローカル
|global-local|
{Vi にはない}
バッファをファイルに保存するときに使用される暗号化メソッドを設定する:
*pkzip*
zip PkZip 互換メソッド。弱い暗号化。
Vim 7.2 以前との後方互換。
*blowfish*
blowfish Blowfish メソッド。強い暗号化。Vim 7.3 以降が必要。こ
のメソッドで保存されたファイルは Vim 7.2 以前のバー
ジョンでは開くことができない。ファイルには "seed" が付
加されるので、ファイルを書き込むたびに暗号化されたバイ
ト列は異なる。
暗号化されたファイルを読み込んだとき、
'cryptmethod' は自動的にそのファ
イルに使用されている暗号メソッドに設定されます。つまり、そのまま
'cryptmethod' を変更せずにファイルを保存すれば同じメソッドが使用されま
す。
'cryptmethod' の設定を変更してもファイルは変更あり状態にはなりません。
設定変更を有効にするにはファイルを保存する必要があります。もし他に変更
がなければ保存せずに終了したとしても警告は表示されません。
|:X| 参照。
グローバル設定を空文字に設定すると "zip" が使用されます。ローカル設定
を空文字に設定するとグローバル設定が使用されます。
Vim の将来のバージョンに新しい暗号化メソッドが追加され、現在の Vim が
それを認識できないときは
*E821* エラーが表示されます。
そのファイルは新しいバージョンの Vim で開く必要があります。
*'cscopepathcomp'* *'cspc'*
'cscopepathcomp' 'cspc' 数値 (既定では 0)
グローバル
{Vi にはない}
{Vimが |+cscope| 機能付きでコンパイルされたときのみ有
効}
タグのリストの中でパスを (訳注: 上にさかのぼって) どこまで表示するかを
指定する。
|cscopepathcomp| を参照。
*'cscopeprg'* *'csprg'*
'cscopeprg' 'csprg' 文字列 (既定では "cscope")
グローバル
{Vi にはない}
{Vimが |+cscope| 機能付きでコンパイルされたときのみ有
効}
Cscope を実行するコマンド名を指定する。
|cscopeprg| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'cscopequickfix'* *'csqf'*
'cscopequickfix' 'csqf' 文字列 (既定では"")
グローバル
{Vimが|+cscope|または|+quickfix|機能つきでコンパイル
されたときのみ利用可能}
{Vi にはない}
cscopeの結果を表示するのにQuickFixウィンドウを使うかどうかを指定する。
|cscopequickfix|を参照。
*'cscoperelative'* *'csre'*
'cscoperelative' 'csre' 切替 (既定は off)
グローバル
{Vimが|+cscope|機能つきでコンパイルされたときのみ利用
可能}
{Vi にはない}
cscope のプレフィックス (-P) がないとき、このオプションをオンに設定す
ると、cscope.out が保存されているディレクトリがプレフィックスとして使
われます。
|cscoperelative| 参照。
*'cscopetag'* *'cst'* *'nocscopetag'* *'nocst'*
'cscopetag' 'cst' 切替 (既定ではオフ)
グローバル
{Vimが|+cscope|機能つきでコンパイルされたときのみ
有効}
{Vi にはない}
コマンドtagにcscopeを使う。
|cscope-options|を参照。
NOTE:
'compatible'をオンにするとこのオプションはオフになる。
*'cscopetagorder'* *'csto'*
'cscopetagorder' 'csto' 数値 (既定では 0)
グローバル
{Vi にはない}
{Vimが |+cscope| 機能付きでコンパイルされたときのみ有
効}
コマンド ":cstag" が検索を行う順番を指定する。
|cscopetagorder| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときは 0 にな
るので注意。
*'cscopeverbose'* *'csverb'*
*'nocscopeverbose'* *'nocsverb'*
'cscopeverbose' 'csverb' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+cscope| 機能付きでコンパイルされたときのみ有
効}
Cscope のデータベースに情報を追加するときメッセージを表示する。
|cscopeverbose| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'cursorbind'* *'crb'* *'nocursorbind'* *'nocrb'*
'cursorbind' 'crb' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+cursorbind| 機能つきでコンパイルされたときの
み有効}
このオプションをオンにすると、現在のウィンドウでカーソルを動かしたとき
に、他のウィンドウ (
'cursorbind' オプションが設定されたウィンドウ) 内
のカーソルも同じ行と列に移動します。このオプションはバージョン違いの
ファイルの差を見るときに便利です (
'diff' 参照)。diff モードでは追加ま
たは削除された行 (行に文字がなくても) のみが考慮されます。
*'cursorcolumn'* *'cuc'* *'nocursorcolumn'* *'nocuc'*
'cursorcolumn' 'cuc' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが|+syntax|機能つきでコンパイルされたときのみ
有効}
カーソルのある画面上の桁をCursorColumnで強調する
|hl-CursorColumn|。
テキストを桁揃えするのに便利。スクリーンの再描画が遅くなる。
カレントウィンドウに対してだけこの強調をしたいなら次の自動コマンドを使
う:
*'cursorline'* *'cul'* *'nocursorline'* *'nocul'*
'cursorline' 'cul' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが|+syntax|機能つきでコンパイルされたときのみ
有効}
カーソルがある画面上の行をCursorLineで強調する
|hl-CursorLine|。
カーソルを目立たせるのに便利。スクリーンの再描画が遅くなる。
ビジュアルモードでは選択されたテキストをわかりやすくするためにこの強調
は行われない。
*'debug'*
'debug' 文字列 (既定では "")
グローバル
{Vi にはない}
以下の値を指定することができる:
msg 省かれるはずのエラーメッセージも表示する。
throw 省かれるはずのエラーメッセージも表示し、さらに例外を投げ、
|v:errmsg|を設定する。
beep ビープが鳴るだけのところでメッセージを表示する。
これらの値はコンマで区切って組み合わせることができる。
"msg"と"throw"はオプション
'foldexpr' や
'formatexpr',
'indentexpr' を
デバッグするのに便利である。
*'define'* *'def'*
'define' 'def' 文字列 (既定では "^\s*#\s*define")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
マクロ定義を発見するのに使われるパターンを指定する。値はコマンド "/"
で使うのと同様の検索パターンである。このオプションは "[i" や "[d" 等に
使われる
|include-search|。オプション
'isident' は、これがマッチした部
分の後の定義された名前を認識するのに使われる。
{
'define' のマッチ}{非識別子}{定義名}{非識別子}
値に空白や '\' を含めるために '\' を挿入することに関しては、
|option-backslash| を参照。
既定値はCプログラム用である。C++プログラムには、定数定義を加えて次のよ
うにすると便利だろう。
":set" で設定するときは、'\' の数を2倍にする必要がある！
*'delcombine'* *'deco'* *'nodelcombine'* *'nodeco'*
'delcombine' 'deco' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+multi_byte| 機能付きでコンパイルされたときの
み有効}
オンのときは、Unicodeのファイルの編集時、バックスペースとNormalモード
のコマンド "x" はそれぞれの文字の上の combining character のみを削除す
る。オフのときは (これが既定である) combining character と文字は同時に
削除される。
Note:
'delcombine'がオンになっていると"xx"の動作が"2x"と異なる場合があ
る。
このオプションは、アラビア語、ヘブライ語その他の言語で、ベースとなる文
字の上にcombining character が付いていて、combining character のみを削
除したいときに便利である。
*'dictionary'* *'dict'*
'dictionary' 'dict' 文字列 (既定では "")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
ファイル名のコンマ区切りのリスト。キーワード補完コマンド
|i_CTRL-X_CTRL-K| 用の単語を探すために使われる。単語のリストからなるファ
イルを指定する。その中では1行ごとに1語が並べられていてもよいし、1行に
キーワードでない文字 (空白を推奨) で区切られた数語が並んでいてもよい。
1行の文字数の最大値は510バイト分である (訳注: 日本語のいわゆる全角文字
では半分の255文字)。
このオプションが空のとき、または"spell"が含まれていてスペルチェックが
有効になっているとき、現在アクティブなスペリングが使われる。
|spell|
ファイル名にコンマを含めるには、コンマの前に '\' を置くこと。コンマの
後ろの空白は無視されるが、それ以外の空白はファイル名の一部として扱われ
る。'\' の使い方については
|option-backslash| を参照すること。
このオプションは変数の辞書型
|Dictionary|とは関係ない。
単語リストはどこで見つかるか？
- FreeBSDでは、"/usr/share/dict/words" というファイルがある。
- Simtelアーカイブでは、ディレクトリ "msdos/linguist" を探すこと。
- GNUコレクションでは、"miscfiles" の中にある。
リストにディレクトリを追加するときには
|:set+=| コマンド、リストからディ
レクトリを除くときには
|:set-=| コマンドを使うのがよい。こうすると将来
のヴァージョンで異なった既定値が使われるようになったときに、問題が起き
るのを防げる。
安全上の理由から、バッククォート (`) をこのオプションの値に使うことは
できない。
*'diff'* *'nodiff'*
'diff' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+diff| 機能付きでコンパイルされたときのみ有効}
カレントウィンドウをファイル間の差異を示すウィンドウのグループに組み入
れる。
|vimdiff| を参照。
*'dex'* *'diffexpr'*
'diffexpr' 'dex' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+diff| 機能付きでコンパイルされたときのみ有効}
2個のファイル間の差異を求めるとき、ed形式のdiffファイルを求めるために
評価される expression。
|diff-diffexpr| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'dip'* *'diffopt'*
'diffopt' 'dip' 文字列 (既定では "filler")
グローバル
{Vi にはない}
{Vimが |+diff| 機能付きでコンパイルされたときのみ有効}
Diffモード用のオプション設定。値は、以下のキーワードのコンマ区切りのリ
ストである。指定しないものがあってもよい。
filler 片方のウィンドウ内のテキストのある位置に行が挿
入されていたときに、ウィンドウのスクロールを同
調させるために、埋め立て用の行を表示する。ウィ
ンドウが隣り合っていて、オプション
'scrollbind' がオンのときには大抵便利である。
context:
{n} 変更のあった行の上下を
{n} 行だけ折り畳まずに
表示 (コンテキストの表示) する。指定されないと、
コンテキストは6行になる。
|fold-diff| を参照。
icase テキストの大文字と小文字の違いを無視する。"a"
と "A" は同じものと見なされる。オプション
'diffexpr' が空なら、コマンド "diff" にフラグ
"-i" を追加する。
iwhite 空白の数の違いを無視する。オプション
'diffexpr' が空なら、コマンド "diff" にフラグ
"-b" を追加する。これが正確には何を指定してい
るのかについては、コマンド "diff" のドキュメン
トを参照すること。これは後ろに追加された空白は
無視するが、前に追加された空白は無視しないはず
である。
horizontal (他に明示的に指定されない限り)ウィンドウを水平
分割してdiffモードを開始する。
vertical (他に明示的に指定されない限り)ウィンドウを垂直
分割してdiffモードを開始する。
foldcolumn:
{n} diffモードの開始時にオプション
'foldcolumn'を
{n}に設定する。
例:
*'digraph'* *'dg'* *'nodigraph'* *'nodg'*
'digraph' 'dg' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+digraphs| 機能付きでコンパイルされたときのみ
有効}
Insertモードで
{char1} <BS> {char2} でダイグラフを入力できるようにする。
|digraphs| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'directory'* *'dir'*
'directory' 'dir' 文字列 (Amigaでの既定値: ".,t:",
MS-DOSとWin32での既定値: ".,c:\tmp,c:\temp"
Unixでの既定値: ".,~/tmp,/var/tmp,/tmp")
グローバル
スワップファイル用ディレクトリの、コンマ区切りのリスト。
- スワップファイルは、リスト内の利用できるディレクトリのうち、最初のディ
レクトリの中に作られる。
- 値が空だとスワップファイルは作られない (回復は不可能になる！)。
- ディレクトリに "." を指定すると、編集されているファイルと同じディレ
クトリにスワップファイルが作られる。Unixではファイル名の先頭にドット
が追加されるので、ディレクトリ内のファイル一覧には表示されない。
MS-Windowsでは属性"hidden"が設定され、可能ならばファイル名の先頭に
ドットが追加される。
- "./" で始まるディレクトリ (MS-DOSなどでは ".\") を指定すると、編集さ
れているファイルからの相対的な位置にスワップファイルが作られる。先頭
の "." は編集されているファイルのパス名に置換される。
- UnixとWin32では、指定されたディレクトリ名の末尾がディレクトリの区切
り記号2個("//"または"\\")で終わっていたら、スワップファイルの名前は
フルパスに従って付けられる。スワップファイルのファイル名をフルパス形
式で表し、ディレクトリの区切り文字をパーセント記号 '%' で置き換えた
ものが使われる。こうするとスワップファイル格納用ディレクトリの中でも
(訳注: 別のディレクトリ内の同名ファイルのスワップファイルが集まるか
もしれない)、ファイル名の一意性が保証される。
Win32 では、区切り文字のカンマの前では "\\" でなく "//" と書かなけれ
ばならない。"\\" と書くと、カンマがファイル名の一部と解釈されてしまう
ためである。
- コンマの後の空白は無視されるが、その他の場所の空白はディレクトリ名の
一部と見なされる。ディレクトリ名の先頭に空白を指定したいなら、'\' を
前に付けること。
- コンマをディレクトリ名の一部に使いたいなら、コンマの前に '\' を付け
ること。
- ディレクトリ名は ':' や '/' で終わっていてもよい。
- 環境変数は展開される
|:set_env|。
- '\' の扱いには注意。空白の前には1個置く。値の中に指定するには2個置く
(
|option-backslash| を参照)。例:
-
Vim version 3.0 との後方互換性のため、値の先頭に '>' を置いてもそれ
は無視される。
リストの先頭には "." を指定することを推奨する。こうすると、同じファイ
ルを2重に編集しようとすると警告が出る。Unixでディレクトリ "/tmp" を使
うのはお勧めできない。システムがクラッシュすると、スワップファイルも失
われてしまう。ディレクトリ "/var/tmp" の中はリブート時にも大抵クリアさ
れないので、ディレクトリ "/tmp" よりもよい選択である。しかしその中には
多くのファイルが入っているかもしれないので、ユーザのスワップファイルは
他のファイルに紛れて分からなくなるかもしれない。ユーザのホームディレク
トリ内のディレクトリ "tmp" が最初に試されるのはそのためだ。
リストにディレクトリを追加するときにはコマンド
|:set+=|、リストからディ
レクトリを除くときにはコマンド
|:set-=| を使うのがよい。こうすると将来
のヴァージョンで異なった既定値が使われるようになったときに、問題が起き
るのを防げる。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
{Vi: 一時ファイルを作るディレクトリを指定する。既定では "/tmp"}
*'display'* *'dy'*
'display' 'dy' 文字列 (既定では "")
グローバル
{Vi にはない}
テキスト表示の方法を変える。値はフラグのコンマ区切りのリストである。
lastline これが含まれると、ウィンドウの最後の行ができる限りまで
表示される。含まれないと、最後の行が収まりきらないなら
その行は "@" と表示される。
uhex unprintable な文字を (訳注: 文書先頭を参照)
<xx> とい
う形式で16進数表示し、^C や ~C の形式を使わない。
*'eadirection'* *'ead'*
'eadirection' 'ead' 文字列 (既定では "both")
グローバル
{Vi にはない}
{Vimが |+vertsplit| 機能付きでコンパイルされたときの
み有効}
オプション
'equalalways' が適用されるときに、
ver ウィンドウの高さにのみ効果がある
hor ウィンドウの幅にのみ効果がある
both ウィンドウの高さと幅、両方に効果がある
*'ed'* *'edcompatible'* *'noed'* *'noedcompatible'*
'edcompatible' 'ed' 切替 (既定ではオフ)
グローバル
コマンド ":substitute" のフラグ 'g' と 'c' を、次に別の方を指定するま
でずっと効力を持つようにする。
|complex-change| を参照。オプション
'gdefault' も参照。
このオプションをオンに設定するのは推奨できない！
*'encoding'* *'enc'* *E543*
'encoding' 'enc' 文字列 (既定では "latin1" または $LANG)
グローバル
{Vi にはない}
{Vimが |+multi_byte| 機能付きでコンパイルされたときの
み有効}
Vim内部で使われる文字エンコーディングを設定する。そのエンコーディング
はバッファやレジスタ内のテキスト、expression 内の文字列、ファイル
viminfo 内のテキスト等に適用される。つまり、このオプションはVimの通常
扱う文字の種類を設定する。指定できる値については
|encoding-names| を参
照。
NOTE: このオプションの値を変更しても、Vim内部の既存のテキストのエンコー
ディングは変化しないので注意。非アスキー文字がおかしくなる恐れもある。
既定の値から変更しないか、Vimの起動時に限って設定すること。
|multibyte|
を参照。メニューを再読み込みするには
|:menutrans|を参照。
このオプションはモードライン (
|modeline|) では設定できません。テキスト
が壊れてしまうため。
NOTE: GTK+2では
'encoding'を"utf-8"に設定することが強く推奨される。
他の値であってもよいが、この環境では"utf-8"が自然な選択であり、不必要
な変換のオーバーヘッドを避けることができる。GUIやターミナルのバージョ
ンによって挙動が異なってしまうのを避けるためと、新しく作られたファイル
のエンコーディングが知らないうちに変わってしまうのを避けるため
(
'fileencodings'が空の場合)、"utf-8"は既定にはなっていない。
編集するファイルの文字エンコーディングはオプション
'encoding' と異なっ
てもよい。そちらは
'fileencoding' で設定される。エンコーディングの変換
は関数 iconv() または
'charconvert' で指定された式による。
'encoding' がマルチバイトエンコーディングであるかを知るに
は、以下のコマンドが使える:
普通、
'encoding' はユーザのカレントロケールと同じである。Vimがユーザの
環境設定を認識したならば、それが既定値になる。
'encoding' の値がカレン
トロケールに設定されていなければ、入力されたテキストと表示されるテキス
トを変換するために、
'termencoding' が設定されていなければならない。
|encoding-table| を参照。
このオプションを設定すると、必要に応じてフォントを設定できるように、
autocommand のイベント
|EncodingChanged| が発生する。
オプションが設定されると、値は小文字に変換される。そのため、値を大文字
で設定してもよい。アンダースコア(下線) '_' はハイフン '-' に変換される。
エンコーディングが認識されると、値は標準の名前に変換される。例えば
"Latin-1" は "latin1" に、"ISO_88592" は "iso-8859-2" に、"utf8" は
"utf-8" になる。
Note: "latin1" という値は、エンコーディングを判別できなかったときにも
使われるので注意。これが正しいのは、編集するファイルが実際に latin1 エ
ンコーディングのときのみである！実際の文字セットが latin1 でないときは、
'fileencoding' と
'fileencodings' が空であるのを確認すること。変換が必
要なときは、utf-8 を使うようにすること。
値が "unicode", "ucs-2" または "ucs-4" であるとき、Vim内部では utf-8
が使われている。このことはユーザが編集中に注意を払うことはないが、
|viminfo-file| については問題になる。またVimはターミナルも utf-8 を使
うことを想定する。そのため、
'encoding' を utf-8 でなく上記のいずれかの
値に設定しても、
'fileencoding' が空のときに編集するファイルのエンコー
ディングにしか影響がない。
'encoding' が Unicode の一種に設定され、
'fileencodings' がまだ設定され
ていなければ、
'fileencodings' の既定値は変更される。
*'endofline'* *'eol'* *'noendofline'* *'noeol'*
'endofline' 'eol' 切替 (既定ではオン)
バッファについてローカル
{Vi にはない}
ファイルを書き込むときに、このオプションがオフでオプション
'binary' が
オンならば、ファイルの最終行に
<EOL> が書き込まれない。このオプション
はファイルの編集を始めるときには自動的にオンになる。ただし編集を始めた
ファイルの最終行に
<EOL> がないときにはオフになる。普通はユーザがこの
オプションを設定する必要はない。
'binary' がオフのときはこのオプション
は使われない。
'binary' がオンのときは、ファイルの最終行に
<EOL> があっ
たかどうかを復元するためにこのオプションが使われる。そのため、ユーザが
ファイルを書き込むときに元のファイルの状態を保つことができるし、変更す
ることもできる。
*'equalalways'* *'ea'* *'noequalalways'* *'noea'*
'equalalways' 'ea' 切替 (既定ではオン)
グローバル
{Vi にはない}
オンのときは、ウィンドウを分割したり閉じたりした後、全てのウィンドウが
自動的に同じサイズになる。これはこのオプションがオフになった瞬間にも起
こる。オフのときは、ウィンドウを分割するとカレントウィンドウのサイズだ
けが減り、他のウィンドウに変化はない。ウィンドウを閉じると、
(
'splitbelow' と
'splitright' に従って) 閉じたウィンドウの隣のウィンド
ウの行数が増す。
水平に分割されたウィンドウと垂直に分割されたウィンドウが混在していると
きは、サイズの最小値が計算され、いくつかのウィンドウは (余裕があれば)
大きくなる。
'eadirection' はサイズの変化する方向を指定する。
'winfixheight',
'winfixwidth' を設定するとウィンドウの高さ・幅が変わる
のを防ぐことができる。
新規ウィンドウ作成時にウィンドウサイズが指定された場合、ウィンドウサイ
ズは等しくならない(これは複雑だが、将来は実装されるかもしれない)。
*'equalprg'* *'ep'*
'equalprg' 'ep' 文字列 (既定では "")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
コマンド "=" に使う外部プログラムを指定する。値が空のときは内部関数が
整形に使われる (オプション
'lisp',
'cindent' または
'indentexpr')。
Vim が内部フォーマットなしでコンパイルされているときは indent コマン
ドが使われる。
環境変数は展開される
|:set_env|。値に空白や '\' を含める方法については
|option-backslash| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'errorbells'* *'eb'* *'noerrorbells'* *'noeb'*
'errorbells' 'eb' 切替 (既定ではオフ)
グローバル
エラーメッセージに伴ってベル (ビープ音または画面フラッシュ) を発生させ
る。このオプションはエラーメッセージにのみ適用され、メッセージのない多
くのエラー (例えばNormalモードで
<ESC> を打ち込んだとき) についてはベ
ルは常に使用される。ベルをビープ音にしたり、画面フラッシュにしたり、無
効にしたりするためには、オプション
'visualbell' を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'errorfile'* *'ef'*
'errorfile' 'ef' 文字列 (Amigaでの既定値: "AztecC.Err",
他の既定値: "errors.err")
グローバル
{Vi にはない}
{Vimが |+quickfix| 機能付きでコンパイルされたときのみ
有効}
QuickFixモードで使われるエラーファイルの名前 (
|:cf| を参照)。
コマンドライン引数 "-q" が指定されたときは、オプション
'errorfile' は
それに続く値に設定される。
|-q| を参照。
コマンド ":make" には「使われない」。それについては
'makeef' を参照。
環境変数は展開される
|:set_env|。値に空白や '\' を含める方法については
|option-backslash| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'errorformat'* *'efm'*
'errorformat' 'efm' 文字列 (既定値はとても長い)
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
{Vimが |+quickfix| 機能付きでコンパイルされたときのみ
有効}
エラーファイルの内容の書式を、関数 scanf 風に指定する (
|errorformat|
を参照)。
*'esckeys'* *'ek'* *'noesckeys'* *'noek'*
'esckeys' 'ek' (Vimの既定値: オン, Viの既定値: オフ)
グローバル
{Vi にはない}
オンのときは、
<Esc> で始まるファンクションキーもInsertモードで認識され
るようになる。オフのときは、
<Esc> で始まるカーソルキーとファンクション
キーは、Insertモードで使うことができない。オンにすることの利点は、
<Esc> を一回打ち込むだけですぐに認識され、1秒ほど待つ必要がないことだ。
このオプションをオフにしなくても、オプション
'timeoutlen' と
'ttimeoutlen' を変更してみるとよい。
Note 'esckeys' がオフのときでも、
どのキーをマッピングすることもできるが、そのままではカーソルキーは使用
できないことに注意。
NOTE: このオプションは
'compatible' がオンのときはViの既定値に、オフの
ときはVimの既定値に設定されるので注意。
*'eventignore'* *'ei'*
'eventignore' 'ei' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+autocmd| 機能付きでコンパイルされたときのみ
有効}
Autocommand のイベント名のうち、無視したいもののリスト。
"all"が含まれていると全ての autocommand のイベントが無視され、
autocommand は実行されなくなる。
それ以外では、値はイベント名のコンマ区切りのリストである。例:
*'expandtab'* *'et'* *'noexpandtab'* *'noet'*
'expandtab' 'et' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
Insertモードで
<Tab> を挿入するとき、代わりに適切な数の空白を使う。ま
た、コマンド '>' や '<' によるインデントや、オプション
'autoindent' が
オンのときのインデントでも空白を使う。
'expandtab' がオンのときに本当の
タブを挿入するには、
CTRL-V<Tab> を使うこと。
|:retab| と
|ins-expandtab| も参照。
NOTE: このオプションは、
'compatible' がオンのときはオフになるので注意。
*'exrc'* *'ex'* *'noexrc'* *'noex'*
'exrc' 'ex' 切替 (既定ではオフ)
グローバル
{Vi にはない}
カレントディレクトリ内のファイル .vimrc, .exrc や .gvimrc 等の読み込み
を有効にする。このオプションをオンにするなら、オプション
'secure' もオ
ンにするよう検討すること (
|initialization| を参照)。ファイル .exrc,
.vimrc や .gvimrc にローカルなものを用いると潜在的な安全保護の漏れを招
くので、注意して使うこと！
|.vimrc| と
|gui-init| も参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'fileencoding'* *'fenc'* *E213*
'fileencoding' 'fenc' 文字列 (既定では "")
バッファについてローカル
{Vimが |+multi_byte| 機能付きでコンパイルされたときの
み有効}
{Vi にはない}
カレントバッファのファイルの文字エンコーディングを設定する。
'fileencoding' と
'encoding' が異なるとき、ファイルの書き出しの際に文
字エンコーディングの変換が行われる。読み込みについては後述。
'fileencoding' が空の場合、
'encoding' と同じ値が使われる (ファイルの読
み書きの際に変換をしない)。
'encoding' と
'fileencoding' がともに Unicode エンコーディングであり、
'fileencoding' が utf-8 でない場合にも変換が行われる。内部では Unicode
は常に utf-8 で保持されているためである。
警告: 文字エンコーディングを変換すると、情報が失われるおそれが
ある！
'encoding' が "utf-8" など Unicode エンコーディングだと、
変換は大抵成功するし、逆変換をしても同じテキストになる。
'encoding' が "utf-8" でないときは、失われる文字があるかもしれ
ない！
指定可能な値については
'encoding' を参照。それらに加え、変換ツールで変
換可能なエンコーディングの値も設定できる。
|mbyte-conversion|を参照。
ファイルを読み込むときは、
'fileencoding' は
'fileencodings' の値の中か
ら設定される。あるエンコーディングのファイルを読み込むには
'fileencoding' を設定してもだめで、引数
|++enc| を使う。1つの例外:
'fileencodings'が空のときは
'fileencoding'の値が使われる。
新規ファイルに対しては
'fileencoding'のグローバルな値が使われる。
"8bit-" や "2byte-" を頭に付けてもここでは意味がなく、無視される。
オプションが設定されると、値は小文字に変換される。そのため、値を大文字
で設定してもよい。アンダースコア(下線) '_' はハイフン '-' に変換される。
値が
'encoding' の値に含まれることが認識されると、値は標準の名前に変換
される。例えば "ISO_88592" は "iso-8859-2" になる。
ファイルの編集を始めた後にこのオプションを設定すると、
'modified' がオ
ンになる。なぜならそのファイルの中身は、書き込まれるときには違うものに
なるからである。
'fenc' をモードラインで設定した場合、設定はファイルが読み込まれた後で
変更されるので注意してください。つまり設定された値はそのファイルを保存
するときになってから効果を発揮します。もし
'fenc' をモードラインで設定
するなら
'nomodified' も同時に設定すると ":q" での終了を妨げないのでい
いかもしれません。
*'fe'*
NOTE:
Vim version 6.0 以前では、このオプションはVim全体の文字エンコー
ディングを指定していたことに注意。これは誤りだった。そのためには代わり
に
'encoding' を使うこと。古い省略形式の名前は
'fe' だが、これはもう使
われていない。
*'fileencodings'* *'fencs'*
'fileencodings' 'fencs' 文字列 (既定値: "ucs-bom",
'encoding' の値がUnicodeに設定されたときは
"ucs-bom,utf-8,default,latin1")
グローバル
{Vi にはない}
{Vimが |+multi_byte| 機能付きでコンパイルされたときの
み有効}
値は、既存のファイルの編集を開始するときに考慮される文字エンコーディン
グのリストである。ファイルが読み込まれると、Vimは指定されたうちの先頭
の文字エンコーディングを使おうとする。そのときエラーが発見されると、値
のリスト内で次に並んでいるエンコーディングが試される。あるエンコーディ
ングでうまくいくとわかると、
'fileencoding'がそれに設定される。すべての
エンコーディングが失敗すると
'fileencoding'は空文字列に設定され、
'encoding'の値が使われることになる。
警告: 文字エンコーディングを変換すると、情報が失われるおそれが
ある！
'encoding' が "utf-8" だと、変換は大抵成功するし、逆変換
をしても同じテキストになる。
'encoding' が "utf-8" でないときは、
非アスキー文字が失われるかもしれない！変換できない文字をどう扱
うかは引数
|++bad|で指定することができる。
空ファイルやアスキー文字のみのファイルではほとんどのエンコーディングで
うまくので、
'fileencodings'の最初の値が使われる("ucs-bom"を除く。これ
はBOMがなければいけない)。他のエンコーディングがよければ自動コマンドイ
ベントBufReadPostを使って、そのエンコーディングが使われるかどうかを判
定すること。例:
これは、ファイルが空白文字しか含まないとき
'fileencoding'を
"iso-2022-jp"に設定する。
引数
|++enc|を使ったときは
'fileencodings'の値は考慮されない。
新規ファイルには
'fileencodings'は適用されないことに注意。代わりに
'fileencoding'のグローバルな値が適用される。これを設定するには:
とする。これは存在しないファイルが空のファイルとは異なるエンコーディン
グになることを意味する。
ファイル先頭にユニコードの BOM (Byte Order Mark: バイト順マーク) があ
るかどうか調べるには、"ucs-bom" という特別な値が使える。この値を
"utf-8" 等のUnicode系の値よりも後に指定すると正しく機能しない。
8ビットエンコーディング("latin1"など)の項目はリストの最後に書かなけれ
ばならない。そうしないとVimがエラーを検出できず、常にそのエンコーディ
ングが適用されてしまうためである。
特別な値"default"を使うと環境からのエンコーディングが適用される。これ
が
'encoding'の既定の値である。これは
'encoding'が"utf-8"に設定され、環
境がロシア語などlatin1でないエンコーディングを使っているときに便利であ
る。
'encoding'が"utf-8"のとき、ファイルが不正なバイト列を含んでいるとその
ファイルはUTF-8と認識されない。コマンド
|8g8|を使うと不正なバイト列を見
つけることができる。
間違った値： どこが間違っているか:
latin1,utf-8 常に"latin1"が使われてしまう
utf-8,ucs-bom,latin1 utf-8のファイルでBOMが認識されない
cp1250,latin1 常に"cp1250"が使われてしまう
'fileencodings' が空のときには
'fileencoding' は変更されない。
設定可能な値については
'encoding' を参照すること。
このオプションを設定しても次にファイルを読み込むときまでは効果がない。
*'fileformat'* *'ff'*
'fileformat' 'ff' 文字列 (MS-DOS, MS-Windows, OS/2 での既定値: "dos",
Unix での既定値: "unix",
Macintosh での既定値: "mac")
バッファについてローカル
{Vi にはない}
バッファにファイルを読み込んだり、バッファからファイルに書き込んだりす
るときに使われる
<EOL> を、カレントバッファについて設定する。
dos
<CR> <NL>
unix
<NL>
mac
<CR>
"dos" が使われたとき、ファイル末尾の
CTRL-Z は無視される。
|file-formats| と
|file-read| を参照。
ファイルの文字エンコーディングについてはオプション
'fileencoding' を参
照。
'binary' がオンのときは、
'fileformat' の実際の値は無視され、ファイルの
読み書きは値が "unix' に設定されたときのように行われる。
ファイルの編集を始めたときに
'fileformats' が空でなく、
'binary' がオフ
ならば、
'fileformat' は自動的に設定される。
ファイルの編集を始めた後にこのオプションを設定すると、
'modified' がオ
ンになる。なぜならそのファイルの中身は、書き込まれるときには違うものに
なるからである。
このオプションは、
'modifiable' がオフのときは変更できない。
後方互換性のために: このオプションが "dos" になると
'textmode' がオン
になり、それ以外では
'textmode' はオフになる。
*'fileformats'* *'ffs'*
'fileformats' 'ffs' 文字列 (既定値:
Vim+Vi MS-DOS, MS-Windows OS/2: "dos,unix",
Vim Unix: "unix,dos",
Vim Mac: "mac,unix,dos",
Vi Cygwin: "unix,dos",
Vi その他: "")
グローバル
{Vi にはない}
想定される改行 (
<EOL>) の種類を指定する。これは新しいバッファの編集を
始めたときと、ファイルを既存のバッファに読み込んだときに使われる。
- 値が空のときは、オプション
'fileformat' で指定された種類の改行が常に
使われる。自動的な設定は行われない。
- 1種類の名前が設定されているときは、新しいバッファが開かれるときには
常にその種類の改行が使われる。そのバッファでは、
'fileformat' はこの
オプションに従って設定される。
'fileformats' は、ファイルを既存のバッ
ファに読み込むときに使われる。その際、そのバッファで
'fileformat' が
何に設定されていても関係ない。
- 複数の名前がコンマで区切られて設定されているときは、ファイルを読み込
むときに
<EOL> の判別が自動的に行われる。Vimはファイルの編集を始める
ときに、
<EOL> を以下のように調べる。
1. 全ての行が
<CR><NL> で終わっており、かつ
'fileformats' が "dos"
を含むなら、
'fileformat' は "dos" になる。
2. 改行に
<NL> が使われていて、かつ
'fileformats' が "unix" を含むな
ら、
'fileformat' は "unix" になる。
Note <NL> があって、その前に
<CR> がないと、"dos" より "unix" が優先的に使われることに注意。
3.
'fileformat' がまだ設定されておらず、
'fileformats' に "mac" が含
まれているときは、
'fileformat' は "mac" に設定される。
つまり "mac" が選択されるのは:
"unix" が含まれていないか
<NL> がファイルに無い、そして
"dos" が含まれていないか
<CR><NL> がファイルに無いときである。
ただし: "unix" が選択され、最初の
<NL> よりも前に
<CR> があり、
最初の数行において
<CR> の数が
<NL> の数よりも多いときは、"mac"
に設定される。
4. それでも
'fileformat' を決定できないときは、
'fileformats' の中で
最初に指定されている値が使われる。
既存のバッファにファイルを読み込むときにも同じ経過をたどる。しかし
'fileformat' は読み込まれるファイルについては適切に設定されるが、
そのバッファでの値は変更されない。
'binary' がオンのときは、
'fileformats' は使われない。
Note: Vim が空のバッファで起動されたときはこのオプションは使用されませ
ん。変更したい場合は .vimrc で
'fileformat' を設定してください。
DOS形式の
<EOL> (
<CR><NL>) のシステムでは、コマンド ":source" で読み込
まれるファイルと、ファイル vimrc については、
<EOL> の判別が自動的に行
われる。
-
'fileformats' が空のときは、自動設定は行われない。常にDOS形式の改行
が使われる。
-
'fileformats' の値に1種類以上の名前が設定されているときは、自動設定
が行われる。これはファイル内の1個目の
<NL> に関して行われる。その前
に
<CR> があるときはDOS形式が使われ、そうでなければUnix形式が使われ
る。
また
|file-formats| も参照。
後方互換性のために: このオプションに、空の文字列か1種類だけの名前が設
定されたとき (コンマが含まれていないとき) には、
'textauto' はオフにな
る。そうでなければ
'textauto' はオンになる。
NOTE: このオプションは、
'compatible' がオンのときはViの既定値に、オフ
のときはVimの既定値になるので注意。
*'filetype'* *'ft'*
'filetype' 'ft' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+autocmd| 機能付きでコンパイルされたときのみ
有効}
このオプションが変更されると autocommand のイベント FileType が発生し、
このオプションの値にマッチする全ての autocommand が実行される。つ
まり、(訳注: 普通 autocommand が実行されるのはファイル名がマッチしたと
きだが)
'filetype' の値がファイル名の代わりに使われる。
しかしこのオプションはカレントファイルのファイルタイプを常に反映してい
るわけではない。普通このオプションは、ファイルタイプが判別されたときに
設定される。判別を有効にするにはコマンド ":filetype on" を使うこと
|:filetype|。
ファイルタイプが自動的に認識されないファイルのモードラインで、このオプ
ションを異なった値に設定すると非常に便利である。例えば、IDL ファイルの
中でこうする。
/* vim: set filetype=idl : */
|FileType| |filetypes|
値の中にドットが現れると、それが2つのファイルタイプ名の区切りとなる。
例:
/* vim: set filetype=c.doxygen : */
こうすると最初にファイルタイプ"c"を使い、次にファイルタイプ"doxygen"を
使う。これはファイルタイププラグインと構文ファイル両方に適用される。2
個以上のドットが現れてもよい。
このオプションは
'cpoptions' のフラグ 's' や 'S' に関わらず、別のバッ
ファにはコピーされない。
通常のファイル名文字だけが使える。"/\*?[|<>"は不正である。
*'fillchars'* *'fcs'*
'fillchars' 'fcs' 文字列 (既定では "vert:|,fold:-")
グローバル
{Vi にはない}
{Vimが |+windows| 機能と |+folding| 機能付きでコンパ
イルされたときのみ有効}
ステータス行と垂直分割の区切りを埋める文字を設定する。値にはキーワード
をコンマで区切って指定する。
キーワード 既定値 変更の対象
stl:文字 ' ' か '^' カレントウィンドウのステータス行
stlnc:文字 ' ' か '-' 非カレントウィンドウのステータス行
vert:文字 '|' 垂直分割の区切り
|:vsplit|
fold:文字 '-'
'foldtext' での空白部分
diff:文字 '-'
'diff' での削除された行
指定されなかったキーワードについては、既定値が使われる。"stl" と
"stlnc" には、強調表示が行われているときは空白が、行われていないときは
'^' と '-' がそれぞれ使われる。
例:
これは既定値と似ているが、強調表示が行われていてもこれらの文字が使われ
る点が異なっている。
"stl"と"stlnc"に対しては1バイトの値しか使用できない。
強調表示が行われるものおよびその属するグループ:
キーワード 強調表示グループ
stl:文字 StatusLine
|hl-StatusLine|
stlnc:文字 StatusLineNC
|hl-StatusLineNC|
vert:文字 VertSplit
|hl-VertSplit|
fold:文字 Folded
|hl-Folded|
diff:文字 DiffDelete
|hl-DiffDelete|
*'fkmap'* *'fk'* *'nofkmap'* *'nofk'*
'fkmap' 'fk' 切替 (既定ではオフ)
*E198*
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
オンのとき、キーボードは Farsi 文字セットにマップされる。
普通、オプション
'allowrevins' をオンにしておき、insertモードでこのオ
プションをコマンド
CTRL-_ で切り替えられるようにする
|i_CTRL-_|。
|farsi.txt| を参照。
*'foldclose'* *'fcl'*
'foldclose' 'fcl' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
"all" に設定すると、カーソルが折り畳み区間の外に出たとき、その区間の折
り畳みの深さがオプション
'foldlevel' より大きければ折り畳みを行う。折
り畳み区間の外に出るとき、自動的に折り畳みを行いたいときに便利である。
*'foldcolumn'* *'fdc'*
'foldcolumn' 'fdc' 数値 (既定では 0)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
非0 に設定されると、ウィンドウの端の指定された幅の列が折り畳みを (開い
ていても閉じていても) 表示する。最大値は 12 である。
|folding| を参照。
*'foldenable'* *'fen'* *'nofoldenable'* *'nofen'*
'foldenable' 'fen' 切替 (既定ではオン)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
オフのときは、全ての折り畳みが開かれる。このオプションは、全てのテキス
トを折り畳みなしで見る状態とテキストの一部を折り畳んで見る (手動で開か
れたり閉じられた折り畳みも含む) 状態を素早く切り替えるために使われる。
このオプションはコマンド
|zi| で切り替えることができる。オプション
'foldenable' がオフのときは、
'foldcolumn' は空白のままである。
このオプションは、新しい折り畳みを作ったり、折り畳みを閉じたりするコマ
ンドによってオンにされる。
|folding| を参照。
*'foldexpr'* *'fde'*
'foldexpr' 'fde' 文字列 (既定では "0")
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能と |+eval| 機能付きでコンパイル
されたときのみ有効}
オプション
'foldmethod' が "expr" のときに使われる expression。これは
折り畳みの深さを求めるために各行について評価される。
|fold-expr| を参照。
この式はサンドボックス
|sandbox|の中で評価することもできる。
|sandbox-option|を参照。
'diff' がオンのとき、このオプションをモードライン
|modeline| で設定す
ることはできない。
'foldexpr'を評価している最中にテキストを変更したり他のウィンドウへジャ
ンプすることは許されていない。
|textlock|
*'foldignore'* *'fdi'*
'foldignore' 'fdi' 文字列 (既定では "#")
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
オプション
'foldmethod' が "indent" のときのみ使われる。
'foldignore'
で指定した文字で始まる行の折り畳みの深さは、上下の行から決められる (訳
注: その行のインデントが上下と違っていても、一緒に折り畳めるようにする
ため)。空白を無視した上で指定された文字の存在を調べる。
既定値の "#" はC言語プログラムについてはうまく動作する。
|fold-indent|
を参照。
*'foldlevel'* *'fdl'*
'foldlevel' 'fdl' 数値 (既定では 0)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
折り畳みの深さを設定する。指定した数値よりレベルの深い折り畳み区間は閉
じられる。このオプションを 0 に設定すると、全ての折り畳みが閉じられる。
大きな数値を設定すると、それだけ閉じられる折り畳みの数は減る。
このオプションはコマンド
|zm|,
|zM| や
|zR| によって設定される。
|fold-foldlevel| を参照。
*'foldlevelstart'* *'fdls'*
'foldlevelstart' 'fdls' 数値 (既定では -1)
グローバル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
ウィンドウで新しいバッファの編集を始めるときのオプション
'foldlevel'
を設定する。編集開始時に常に全ての折り畳みを閉じておいたり (そのために
は 0 にする)、いくつかを閉じておいたり (1 にする)、全て開いておいたり
(99にする) するときに便利である。
これによる設定はモードラインの読み込み前に行われるので、モードライン内
での設定はこのオプションによる設定より優先される。ファイルの編集を
|diff-mode| で開始してもやはりこのオプションは無視され、全ての折り畳み
が閉じられる。
またこれによる設定はイベント BufReadPre による autocommand よりも前に
行われるので、特定のファイルについて autocommand で
'foldlevel' を上書
きできる。
値が負のときには、このオプションは使われない。
*'foldmarker'* *'fmr'* *E536*
'foldmarker' 'fmr' 文字列 (既定では "{{
{,}}}")
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
オプション
'foldmethod' が "marker" のときに使われる、折り畳み開始／終
了を示すマーカー。開始マーカーと終了マーカーを分けるために、間に1個の
コンマがなければいけない。マーカーはただの文字列である (正規表現では動
作が遅すぎるだろう)。
|fold-marker| を参照。
*'foldmethod'* *'fdm'*
'foldmethod' 'fdm' 文字列 (既定では "manual")
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
カレントウィンドウに適用される折り畳みの種類を設定する。指定可能な値は
以下の通り。
|fold-manual| manual 折り畳みは手動で設定する。
|fold-indent| indent 等しいインデントの行で折り畳みを作る。
|fold-expr| expr オプション
'foldexpr' で深さを設定する。
|fold-marker| marker マーカーで折り畳みを指定する。
|fold-syntax| syntax 構文強調表示のキーワードを使って指定する。
|fold-diff| diff 変更されていないテキストを折り畳む。
*'foldminlines'* *'fml'*
'foldminlines' 'fml' 数値 (既定では 1)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
画面上の行数を設定する。設定された行数より大きな折り畳みだけが閉じた折
り畳みとして表示される。手動で閉じられた折り畳みにも適用される。初期設
定の 1 では、折り畳みが 2 行以上の場合のみ閉じることができる。ゼロに設
定することで 1 行だけの折り畳みを閉じることができる。
Note: このオプションは折り畳みの表示方法に関してのみ効果を持つ。例えば
"zc" で折り畳みを閉じて、その折り畳みが
'foldminlines' より小さいため
に開いた状態で表示されているとき、続けて "zc" を入力するとその外側の折
り畳みを閉じることになる。
*'foldnestmax'* *'fdn'*
'foldnestmax' 'fdn' 数値 (既定では 20)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
折り畳みの方法に "indent" や "syntax" が選ばれたときの、折り畳みの入れ
子の深さの最大値を設定する。これにより折り畳みが膨大に作られるのを防ぐ
ことができる。Vim内部の制限が 20 になっているので、20 以上を設定しても
無効である。
*'foldopen'* *'fdo'*
'foldopen' 'fdo' 文字列 (既定では "block,hor,mark,percent,quickfix,
search,tag,undo")
グローバル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
カーソルがコマンドによって、閉じている折り畳みの中に移動したとき、どの
種類のコマンドだったら折り畳みが開かれるかを指定する。値はコンマ区切り
のキーワードである。
NOTE: コマンドがマッピングの一部として実行されたときは、このオプション
は使われない。同じ効果を得るには、マッピングにコマンド
|zv| を加えるこ
と。
(理由: 折り畳みを開くかどうかはマッピング自身でコントロールできたほう
がいい)
キーワード 適用されるコマンド
all 全て
block "(", "{", "[[", "[{" 等
hor 水平移動: "l", "w", "fx" 等
insert Insertモードのコマンド全て
jump 長いジャンプ: "G", "gg" 等
mark マークへのジャンプ: "'m",
CTRL-O 等
percent "%"
quickfix ":cn", ":crew", ":make" 等
search パターン検索: "/", "n", "*", "gd" 等
(":"コマンドでの検索パターンには適用されない)
|[s|と
|]s|にも適用される。
tag タグへのジャンプ: ":ta",
CTRL-T 等
undo アンドゥ／リドゥ: "u" と
CTRL-R
移動コマンドがオペレータとして使われたときは (例えば "dl" や "y%")、こ
のオプションは使われない。つまりオペレータは閉じられている折り畳み全体
を含む効果を持つということだ。
Note 垂直方向の移動がここに含まれていないことに注意。それは垂直移動を
含めると、閉じられた折り畳みの上への移動が困難になるからだ。Insertモー
ドでテキストが挿入されるときには、カーソルが中に入っていった折り畳みは
必ず開かれる。
折り畳みを閉じるには、
|zx| でオプション
'foldlevel' を再適用するか、
'foldclose' を "all" にすればよい。
*'foldtext'* *'fdt'*
'foldtext' 'fdt' 文字列 (既定では "foldtext()")
ウィンドウについてローカル
{Vi にはない}
{Vimが |+folding| 機能付きでコンパイルされたときのみ
有効}
閉じられた折り畳みのところに表示されるテキストを生成する expression を
指定する。
|fold-foldtext| を参照。
この式はサンドボックス
|sandbox|の中で評価することもできる。
|sandbox-option|を参照。
'foldexpr'を評価している最中にテキストを変更したり他のウィンドウへジャ
ンプすることは許されていない。
|textlock|
*'formatoptions'* *'fo'*
'formatoptions' 'fo' 文字列 (Vimの既定値: "tcq", Viの既定値: "vt")
バッファについてローカル
{Vi にはない}
自動整形の実行方法を決めるフラグの列である。
|fo-table| を参照。オプショ
ン
'paste' がオンのときは、(
'formatoptions' が空のときのように) 整形は
行われない。読みやすくするために、フラグの間にコンマを挟んでもよい。
将来追加されるフラグによる問題を避けるため、コマンド ":set" では "+="
と "-=" を使うこと
|add-option-flags|。
NOTE: このオプションは、
'compatible' がオンのときはViの既定値に、オフ
のときはVimの既定値になるので注意。
*'formatlistpat'* *'flp'*
'formatlistpat' 'flp' 文字列 (既定では "^\s*\d\+[\]:.)}\t ]\s*")
バッファについてローカル
{Vi にはない}
リストのヘッダを認識するのに使われるパターン。
'formatoptions'のフラグ
"n"に適用される。
このパターンにマッチする部分が、それ以下の行のインデントとなる。
|/\ze|を使うとマッチの終わりをマークしつつ、さらに文字のチェックを続け
ることができる。
(訳注: 例えば、このオプションが既定の"^\s*\d\+[\]:.)}\t ]\s*"のとき、
マッチする部分は
1. the first item
wraps
^^^^^^^^^^
の部分である。既定の値に\zeをはさんで"^\s*\d\+[\]:.)}\t ]\ze\s*"とす
ると、リストのヘッダと認識されるパターンはまったく変わらないが、次行
のインデントが\ze以前の部分に等しくなる:
1. the first item
wraps
^^^^^^
)
パターンの後ろに文字がなければならない。行全体がマッチすると、その行は
マッチがないのと同様に扱われてしまう。
既定では数字(後ろに句読点や空白があってもよい)を認識する。
*'formatprg'* *'fp'*
'formatprg' 'fp' 文字列 (既定では "")
グローバル
{Vi にはない}
選択された行をコマンド
|gq| で整形するのに使われる外部プログラムの名前
を指定する。使われるプログラムは標準入力からテキストを読み込み、整形さ
れたテキストを標準出力に出力しなければいけない。Unixのプログラム "fmt"
が代表である。
オプション
'formatexpr'が空でないならば、代わりにその値が使われる。この
オプションが空ならば、内部の整形関数が使われる
|C-indenting|。
環境変数は展開される
|:set_env|。値に空白や '\' を含める方法については、
|option-backslash| を参照。
この式をサンドボックス
|sandbox|の中で評価することができる。
|sandbox-option|を参照。
*'formatexpr'* *'fex'*
'formatexpr' 'fex' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが|+eval|機能つきでコンパイルされたときのみ有効}
オペレータ
|gq| や自動整形 (
'formatoptions' 参照) で行の範囲を整形する
ために評価される式。このオプションが空だと
'formatprg' が使われる。
|v:lnum| 変数は整形される最初の行を保持する。
|v:count| 変数は整形される行数を保持する。
|v:char| 変数は挿入されようとしている文字を保持する (式が自動整形のた
めに評価されたときに使用される)。空文字の場合もある。この文
字をバッファに挿入しないでください。
例:
これはautoload/mylang.vim中の関数mylang#Format()を呼ぶ。
|autoload|
また、
'textwidth'がオンになっていて、テキストを追加しているときにその
値を超えたときにもこの式が評価される。これは内部整形が使われるときと同
じ条件で起こる。この式を評価した後のカーソル位置がテキストに対して元の
位置と同じになるようにすること。この式を評価中は、関数
|mode()|は"i"ま
たは"R"を返す。
この関数が非ゼロを返すと Vim 内部の文章整形処理が使われる。
この式はサンドボックス (
|sandbox|) の中で評価されることがあります。
|sandbox-option|を参照。その場合、サンドボックスの中ではバッファテキス
トの変更は許可されていないので、このオプションは機能しません。
*'fsync'* *'fs'*
'fsync' 'fs' 切替 (既定ではオン)
グローバル
{Vi にはない}
これがオンになっていると、ファイル書き込みの後にライブラリ関数fsync()
が呼ばれる。するとファイルがディスクにフラッシュされ、メタデータのみを
ジャーナルするファイルシステム上でも安全に書き込みが行われるようになる。
ラップトップモードで動作するLinuxシステム上で強制的にハードドライブを
回転させることになるが、これはある種の状況では望ましくない。これをオフ
にするとクラッシュ時にデータを失う可能性を高めることに注意。fsync()の
実装がないシステム上ではこの変数は常にオフである。
スワップファイルに対してfsync()をコントロールするには
'swapsync'を参照。
*'gdefault'* *'gd'* *'nogdefault'* *'nogd'*
'gdefault' 'gd' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンのときは、コマンド ":substitute" のフラグ 'g' がオンであることが既
定になる。つまり行内のマッチする文字列が、1番目のものだけでなく、全て
置換される。":substitute" に 'g' が指定されると、逆に1番目のみを置換す
るようになる。
|complex-change| を参照。
コマンド 'gdefault' がオン 'gdefault' がオフ
:s/// 全て置換 最初だけ置換
:s///g 最初だけ置換 全て置換
:s///gg 全て置換 最初だけ置換
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'grepformat'* *'gfm'*
'grepformat' 'gfm' 文字列 (既定では "%f:%l%m,%f %l%m")
グローバル
{Vi にはない}
コマンド ":grep" の出力を認識するための書式。
オプション
'errorformat' と同じく、関数 scanf 風の書式指定を使う。
|errorformat| を参照。
*'grepprg'* *'gp'*
'grepprg' 'gp' 文字列 (既定では "grep -n ",
Unixでは: "grep -n $* /dev/null",
Win32では: "findstr /n" か "grep -n",
VMSでは: "SEARCH/NUMBERS ")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
コマンド ":grep" で使われるプログラム。このオプションは文字 '%' や '#'
を含んでもよい。これらはコマンドラインで使われるときのように展開される。
引数の挿入される場所を指定するには "$*" が使える。環境変数は展開される
|:set_env|。値に空白や '\' を含める方法については、
|option-backslash|
を参照。
ユーザの "grep" が引数 "-H" を認識するなら、":grep" が1個のファイルに
対しても適切に働くように、次のようにすること。
特別な値:
'grepprg'が"internal"に設定されていると、
|:grep|は
|:vimgrep|
と同様に、
|:lgrep|は
|:lvimgrep|と同様に、
|:grepadd|,
|:vimgrepadd||,||:lgrepadd|は
|:lvimgrepadd|と同様に働くようになる。
<
|:make_makeprg| も参照。そこの記述のほとんどが
'grepprg' にも適用でき
るからだ。
Win32では、"findstr.exe" が見つかるならば既定値は "findstr /n" である。
見つからなければ "grep -n" である。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'guicursor'* *'gcr'* *E545* *E546* *E548* *E549*
'guicursor' 'gcr' 文字列 (既定では "n-v-c:block-Cursor/lCursor,
ve:ver35-Cursor,
o:hor50-Cursor,
i-ci:ver25-Cursor/lCursor,
r-cr:hor20-Cursor/lCursor,
sm:block-Cursor
-blinkwait175-blinkoff150-blinkon175")
MS-DOSとWin32コンソールでは:
"n-v-c:block,o:hor50,i-ci:hor15,
r-cr:hor30,sm:block")
グローバル
{Vi にはない}
{VimのGUI版か、MS-DOSまたはWin32のコンソール版でのみ
有効}
Vimのそれぞれのモード内でのカーソルの外観を指定する。GUI上では完全に機
能する。MSDOSやWin32コンソールではカーソルの高さだけを変更する。これは
ブロックカーソルを指定する、または垂直・水平方向のパーセンテージを指定
することで行う。
コンソール上ではエスケープシーケンス
't_SI'と
't_EI'が使われる。
値はコンマ区切りのキーワードのリストである。リストは部門別に分かれてお
り、各部門はモードリストと引数リストからなる。
モードリスト:引数リスト,モードリスト:引数リスト,..
モードリストは、モードを表す以下の記号のダッシュ区切りのリストである。
n Normalモード
v Visualモード
ve
'selection' が "exclusive" のときの Visualモード (指定
されなければ 'v' と同じ設定)
o Operator-pendingモード
i Insertモード
r Replaceモード
c Command-line Normal (追加) モード
ci Command-line Insertモード
cr Command-line Replaceモード
sm Insertモードでの対応括弧表示時
a 全てのモード
引数リストは、以下の引数のダッシュ区切りのリストである。
hor
{N} 文字高の
{N}% の高さの水平バーカーソル
ver
{N} 文字幅の
{N}% の幅の垂直バーカーソル
block 文字全体を覆う大きさのブロックカーソル
[上の3個のうちの1個だけを指定できる]
blinkwait
{N} *cursor-blinking*
blinkon
{N}
blinkoff
{N}
カーソルの点滅について指定する。blinkwait にはカーソル
が点滅を始めるまでの遅延時間を、blinkon にはカーソルが
表示される時間を、blinkoff にはカーソルが消えている時
間を指定する。時間の単位はミリ秒である。どれかに 0 を
指定すると、カーソルは点滅しない。既定では
"blinkwait700-blinkon400-blinkoff250" となっている。こ
れらは指定されなかった項目に適用される。つまり、既定で
は点滅するように設定されているということだ。点滅しない
ようにするには "blinkon0" を指定すればよい。カーソルが
点滅するのはVimが入力を待っている間で、コマンドを実行
している間は点滅しない。
カーソルを xterm の中で点滅させるには、
|xterm-blink|
を参照。
{group-name}
カーソルの色とフォントを設定する、強調表示のグループ名
を指定する。
{group-name}/
{group-name}
強調表示グループ名を2個指定する。1個目は言語マッピング
がないときに使われ、2個目は言語マッピングがあるときに
使われる。
|language-mapping|
値の一部の例:
n-c-v:block-nCursor Normalモード、Command-lineモードとVisualモード
で、強調表示グループ "nCursor" で指定された色
のブロックカーソルを使う。
i-ci:ver30-iCursor-blinkwait300-blinkon200-blinkoff150
InsertモードとCommand-line Insertモードで、強
調表示グループ "iCursor" で指定された色の、文
字高の30%の高さの垂直バーカーソルを使う。点滅
は少し速くする。
モード 'a' は他とは異なっていて、与えられた引数リストを全てのモードに
対して設定し、指定されなかった引数は変更しない。これは全てのモードに共
通の設定をするためにある。例えば、点滅を止めるには "a:blinkon0" とする。
カーソル強調表示の例:
MS-DOSとWin32のコンソール版では、カーソルの高さのみを指定できる。ブロッ
クカーソルを指定するか、垂直／水平バーカーソルの高さ／幅のパーセンテー
ジを指定する。
*'guifont'* *'gfn'*
*E235* *E596*
'guifont' 'gfn' 文字列 (既定では "")
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
VimのGUI版で使われるフォントのリストである。値の最も単純なものは、ただ
1個のフォント名である。フォントが見つからないとき、エラーメッセージが
表示される。別のフォント名を試すには、フォント名のコンマ区切りのリスト
を指定できる。その中の最初の使用可能なフォントが使われる。
オプション
'guifontset' が空でないとき、
'guifont' は使われない。
'guifontset'がサポートされているシステム上(X11)で、
'guifontset'が空で
ないならば
'guifont'が使われる。
コンマの後の空白は無視される。フォント名の中にコンマを指定するには、コ
ンマの前に '\' を置くこと。さらにオプションの値の中で空白や '\' を使う
には、それらの前に余分に '\' を置かなければならない。
|option-backslash| も参照。例えば
とすると、まずVimはフォント "Screen15" を使おうとし、だめなら代わりに
"7x13" を、そして "font,with,commas" を使おうとする。
フォントをどれも読み込めなかったら現在の設定のままになる。空のフォント
リストが与えられると、他のリソース設定を試してみて (X では Vim.font リ
ソースが使われる)、それがだめなら、必ず存在するはずの組み込みの既定
フォントを試す (X の場合は "7x13")。指定されるフォント名は "normal" な
(訳注: 太字や斜字体でない) フォントでなければならない。Vim は関連する
太字体や斜字体を見つけようとする。
Win32, GTK, Motif, Mac OS, Photon では:
これはフォント選択ダイアログを開く。そこで望みのフォントを選択すること
ができる。
フォント名は使っているGUIに依存する。様々なシステムに対して
'guifont'を
設定する方法については
|setting-guifont|を参照。
GTK+ 2ではフォント名は次のようになる:
これだけである。もうXLFDは受け付けない。中国語の場合は以下の記述でうま
くいくと報告されている:
Mac OXSでは次のようにする:
'macatsui'も参照。表示上の問題を解決する助けになる。
*E236*
Note フォントは等幅でなければならない (全ての文字が同じ幅でなければな
らない)。例外はGTK 2である。どんなフォントでも受け付けるが、等幅フォン
トがもっともきれいに見える。
X11でフォントのプレビューをするには、プログラム "xfontsel" が使えるか
もしれない。"xlsfonts" は、使用可能な全てのフォントのリストを与える。
Win32のGUIについて
*E244* *E245*
- フォント名には以下のオプションを指定できる。
hXX - 文字高が XX (単位はポイント。浮動小数点数でもよい)
wXX - 文字幅が XX (単位はポイント。浮動小数点数でもよい)
b - ボールド (太字体)
i - イタリック (斜字体)
u - 下線付き
s - 打ち消し (文字を横切る線付き)
cXX - 文字セットが XX。使用可能なものは以下の通り: ANSI,
ARABIC, BALTIC, CHINESEBIG5, DEFAULT, EASTEUROPE,
GB2312, GREEK, HANGEUL, HEBREW, JOHAB, MAC, OEM,
RUSSIAN, SHIFTJIS, SYMBOL, THAI, TURKISH,
VIETNAMESE ANSI, BALTIC
通常は"cDEFAULT"を使うとよいだろう。
オプションの区切りには ':' を使うこと。
- 空白の代わりに '_' が使えるので、空白を '\' でエスケープする必要はな
い。
- 例:
|font-sizes| も参照。
*'guifontset'* *'gfs'*
*E250* *E252* *E234* *E597* *E598*
'guifontset' 'gfs' 文字列 (既定では "")
グローバル
{Vi にはない}
{VimのGUI版で、|+xfontset| 機能付きでコンパイルされた
ときのみ有効}
{GTK+ 2 GUIでは利用できない}
このオプションには2種類 (またはそれ以上) のフォントを指定する。値が空
のときは無視される。 1種類目は普通の英語に使われるもので、2種類目はユー
ザの使う特別な言語用である。
|xfontset| を参照。
このオプションを設定すると、全てのフォント名はフォントセット名として扱
われるようになる。またコマンド
|:highlight| の引数 "font" に使われるも
のも同様である。
フォントはカレントロケールに適合していなければならない。カレントロケー
ルの使用している文字セット用のフォントが値に含まれていないと、
'guifontset' の設定は失敗する。
Note 'guifont' と
'guifontset' の違いに注意。
'guifont' では、コンマで
区切られたフォント名は代替用で、そのうちのどれか一つが使われる。
'guifontset' では、コンマも含めて値の文字列全体がフォントセット名を表
す。代替フォントセットを指定することはできない。
次の例は多くのX11システムで正しく機能する。
*'guifontwide'* *'gfw'* *E231* *E533* *E534*
'guifontwide' 'gfw' 文字列 (既定では "")
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
2倍幅の文字に使われるフォントをコンマ区切りのリストで指定する。値が空
のときは無視される。読み込み可能なフォントのうち先頭のものが使われる。
Note: 指定したフォントの幅は、オプション
'guifont' で指定したフォント
のちょうど2倍の幅で、同じ高さのものでなければならない。
GTK+ 2を除くすべてのバージョン:
'guifontwide'は、
'encoding' が "utf-8" で、かつ
'guifontset' が空であ
るか不適切なものであるときにのみ使われる。
'guifont' が設定されていて、その中に適切なフォントが含まれており、かつ
'guifontwide' が空のとき、Vimは適合する2倍幅のフォントを探し、
'guifontwide' をそれに設定しようとする。
GTK+ 2 GUI のみ:
*guifontwide_gtk2*
このオプションが設定されており、それが適切な値であるとき、
'encoding'が
"utf-8"でなくても常に2倍幅文字に対して
'guifontwide'が使われる。
Vimは自動的に
'guifontwide'に適合する値を探そうとはしない。
'guifontwide'が空ならばPango/Xftが
'guifont'で利用できない文字に対する
フォントを選ぶ。そのため、Pango/Xftが選んだ値を上書きしたいのでない限
り、
'guifontwide'を設定する必要はまったくない。
*'guiheadroom'* *'ghr'*
'guiheadroom' 'ghr' 数値 (既定では 50)
グローバル
{Vi にはない} {VimのGTKとX11のGUI版でのみ有効}
GUIウィンドウを画面に合わせるときに、画面の高さから差し引かれるピクセ
ル数。このオプションはGUIを開始する前に、例えばファイル
|gvimrc| 内で
設定すること。値を 0 にすると、画面の高さ全体がウィンドウに使われる。
正の値を指定すると、それだけのピクセル数がウィンドウの装飾や画面上の他
のもののために残される。ウィンドウを画面よりも高くするには、負の値を指
定すること。
*'guioptions'* *'go'*
'guioptions' 'go' 文字列 (既定では "egmrLtT" (MS-Windows),
"aegimrLtT" (GTK, MotifとAthena))
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
このオプションはVimのGUI版でのみ有効である。値は、GUIのどのコンポーネ
ントとオプションを使用するかを決定する、フラグの列である。
将来追加されるフラグによる問題を避けるため、コマンド ":set" では "+="
と "-=" を使うこと
|add-option-flags|。
使用できるフラグは以下の通りである。
*guioptions_a* *'go-a'*
'a' 自動選択 (autoselect): 値に含まれると、Visualモードが開始され
るたび、またはVisual選択範囲が変更されるたびに、Vimはウィンド
ウシステム共通のクリップボードを使おうとする。つまりVisual選択
で選択されたテキストは、Vim自身はもとより他のアプリケーション
でも張り付けに使えるということだ。(おそらくテキストに操作を実
行したせいで) Visualモードが終了したり、アプリケーションが選択
領域を張り付けようとしたときには、強調されたテキストは自動的に
クリップボードレジスタ "* にコピーされる。そのためVisualモード
が終了した後でも、選択領域を他のアプリケーションに張り付けるこ
とができる。
含まれないと、レジスタ "* に対するコピーや張り付けによって陽に
指定されない限り、Vimはウィンドウシステム共通のクリップボード
を使おうとはしない。
モードレスセレクションについても同様である。
*'go-A'*
'A' モードレスセレクションに対する自動選択。フラグ 'a' と似ている
が、モードレスセレクションにのみ適用される。
'guioptions' Visualモード モードレスセレクション
"" X X
"a" O O
"A" X O
"aA" O O
*'go-c'*
'c' 単純な選択にはポップアップダイアログでなくコンソールダイアログ
を使う。
*'go-e'*
'e'
'showtabline'で指定されたタイミングでタブを追加する。
'guitablabel'を使うとタブのラベルのテキストを変更することがで
きる。'e'がないと非GUIのタブページラインが使われる。GUIのタブ
はいくつかのシステム上(現在はGTK, Motif, Mac OS/X, MS-Windows)
でのみサポートされている。
*'go-f'*
'f' フォアグラウンド (foreground): シェルからGUIを開始し、そのシェ
ルからgVimを独立させる際に関数 fork() を使わない。これはエディ
タが終了するのを待つプログラム (例えばメールプログラム等) に対
して使う。フォアグラウンドでGUIを開始するには、これの代わりに
"gvim -f" や ":gui -f" も使える
|gui-fork|。
Note: このオプションはファイル vimrc 内で設定するよう注意。ファ
イル
|gvimrc|が読み込まれたときはフォーキングがすでに実行されて
いるかもしれない。
*'go-i'*
'i' Vimのアイコンを使う。KDEのGTKではウィンドウの左上に表示される。
GTKでないX11では、制限のため白黒のアイコンが使われる。色つきの
アイコンについては
|X11-icon| を参照。
*'go-m'*
'm' メニューバーを表示する。
*'go-M'*
'M' システムメニューの実体 "$VIMRUNTIME/menu.vim" が読み込まれない。
Note このフラグは、構文認識やファイルタイプ認識を起動する前に、
ファイル .vimrc 内で追加されていなければならない (ファイル
.gvimrc が読み込まれたときには、システムメニューはすでに読み込
まれた後である。コマンド ":syntax on" と ":filetype on" でもメ
ニューは読み込まれる)。
*'go-g'*
'g' メニュー項目の灰色表示: 無効のメニュー項目を灰色で表示する。含
まれていないと、無効のメニュー項目は全く表示されない。
例外: Athenaでは常にグレー表示を使う。
*'go-t'*
't' メニュー項目の切り離しを有効にする。現在のところWin32, GTK+ と
Motif 1.2 GUI でのみ有効である。
*'go-T'*
'T' ツールバーを表示する。現在のところWin32, GTK+ と Motif,
Photon, Athena GUIでのみ有効である。
*'go-r'*
'r' 右スクロールバーを常に表示する。
*'go-R'*
'R' 垂直分割されたウィンドウがあるときのみ、右スクロールバーを表示
する。
*'go-l'*
'l' 左スクロールバーを常に表示する。
*'go-L'*
'L' 垂直分割されたウィンドウがあるときのみ、左スクロールバーを表示
する。
*'go-b'*
'b' 下 (水平) スクロールバーを表示する。サイズは表示されている行の
中で一番長い行によって決まる。またはフラグ'h'が含まれていると
きはカーソル行によって決まる。
|gui-horiz-scroll|
*'go-h'*
'h' 水平スクロールバーのサイズをカーソル行の長さに制限する。計算量
を軽減させる。
|gui-horiz-scroll|
そう、もちろん、本当に望むのなら、左スクロールバーと右スクロールバーを
「両方」使うことだってできる :-) 詳しい情報については
|gui-scrollbars|
を参照。
*'go-v'*
'v' ダイアログのボタン配置を垂直方向にする。含まれていないとなるべ
く水平方向の配置を使うが、収まらないときには結局、垂直配置が使
われる。
*'go-p'*
'p' X11のGUIにおいて、ポインタ・コールバックを使う。ウィンドウマネー
ジャの中にはこれが必要なものもある。カーソルが正しいタイミング
で点滅したり変形したりしないときは、これを追加してみること。こ
れはGUIを開始する前に設定しなければならない。ユーザのファイル
|gvimrc|内で設定すること。GUIが開始した後にこのフラグを追加した
り取り除いたりしても、効果はない。
*'go-F'*
'F' フッタを追加する。Motifでのみ有効である。
|gui-footer| を参照。
*'guipty'* *'noguipty'*
'guipty' 切替 (既定ではオン)
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
GUI版でのみ有効である。オンのときは、シェルコマンドからの入力用および
シェルコマンドへの出力用の仮想端末 pseudo-tty を開こうとする。
|gui-pty| を参照。
*'guitablabel'* *'gtl'*
'guitablabel' 'gtl' 文字列 (既定では空文字列)
グローバル
{Vi にはない}
{GUI と
|+windows| 機能を有効にしてコンパイルされたと
きのみ利用可能}
空文字列でない場合は、GUI のタブページ行のラベルを設定する。空文字列で
あるか、または評価結果が空文字列である場合は、既定のラベルが使われる。
より詳しくは
|setting-guitablabel| を参照。
このオプションのフォーマットは
'statusline' のフォーマットに似ている。
ツールチップには
'guitabtooltip' が使われる。下記参照。
GUI のタブページが表示されるときのみ使われる。
'guioptions' に 'e' が含
まれていなければならない。GUI でないタブページ行については
'tabline'
が使われる。
*'guitabtooltip'* *'gtt'*
'guitabtooltip' 'gtt' 文字列 (既定では空文字列)
グローバル
{Vi にはない}
{GUI と
|+windows| 機能を有効にしてコンパイルしたとき
のみ利用可能}
空文字列でない場合は、GUI のタブページ行のツールチップを設定する。空文
字列である場合は、既定のツールチップが使われる。
それ以外は上記の
'guitablabel' と同様。
改行を含めることもできる。そのもっとも簡単な方法は
|:let|を使うことで
ある:
*'helpfile'* *'hf'*
'helpfile' 'hf' 文字列 (既定では MS-DOS: "$VIMRUNTIME\doc\help.txt"
その他: "$VIMRUNTIME/doc/help.txt")
グローバル
{Vi にはない}
ヘルプファイルの名前。Vim に付属のヘルプファイルは全て単一のディレクト
リ内に一緒に置かれるべきである。そのディレクトリの他に、
'runtimepath'
中の全ての "doc" ディレクトリも対象になる。
環境変数は展開される
|:set_env|。例:
"$VIMRUNTIME/doc/help.txt"。環境変数 $VIMRUNTIME が設定されてないとき
は、$VIM も試される。
|$VIMRUNTIME| を参照。値に空白や '\' を含めること
については
|option-backslash| も参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'helpheight'* *'hh'*
'helpheight' 'hh' 数値 (既定では 20)
グローバル
{Vi にはない}
{Vimが |+windows| 機能付きでコンパイルされたときのみ
有効}
コマンド ":help" で開かれたヘルプウィンドウの、開始時のウィンドウ高の
最小値を設定する。ヘルプウィンドウの開始時の高さはカレントウィンドウの
半分であるか、(オプション
'ea' がオンのときには) 他のウィンドウと同じ
である。ウィンドウ高が
'helpheight' より小さくなってしまうとき、実際の
高さは
'helpheight' になる。こうしないようにするには 0 に設定すること。
*'helplang'* *'hlg'*
'helplang' 'hlg' 文字列 (既定では: メッセージ言語または空)
グローバル
{Vi が |+multi_lang| 機能つきでコンパイルされたときの
み有効}
{Vi にはない}
コンマ区切りの言語のリスト。これらの言語の中から、探しているヘルプが見
つかった最初の言語を使う。英語のヘルプは常に優先度が最後になる。英語の
優先度を上げるために "en" を追加することはできるが、そうしても、その言
語に存在し、英語のヘルプに存在しないタグを見つけるだけである。
訳注: 上の文よくわからない。
例:
こうすると最初にドイツ語を検索し、次にイタリア語、そして最後に英語のヘ
ルプファイルを検索する。
|CTRL-]| や英語でないヘルプファイル中で ":help!" を使ったときは、この
オプションより先に現在の言語からタグを検索する。
|help-translated| を参
照。
*'hidden'* *'hid'* *'nohidden'* *'nohid'*
'hidden' 'hid' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オフのときは、バッファは放棄
|abandon| されるときに解放される。オンの
ときは、バッファは放棄
|abandon| されるときに隠れ (hidden) 状態になる。
そのバッファが別のウィンドウでまだ表示されているなら、もちろん隠れ状態
にはならない。
バッファリストをわたって動くコマンドは
'hidden' がオフでもバッファを
隠れ状態にすることがある。バッファの内容が変更されていて、
'autowrite'
がオフであるか書き込みが不可能な状態であり、フラグ '!' が使われたよう
なときだ。
|windows.txt| も参照。
1つのバッファだけを隠れ状態にするにはオプション
'bufhidden' を使う。
このオプションは、一つ一つのコマンドに対して ":hide
{command}" とする
ことでオンにできる
|:hide|。
警告: 隠れバッファに対する変更は忘れがちである。コマンド ":q!" や
":qa!" を使う前にはもう一度よく考えること。
*'highlight'* *'hl'*
'highlight' 'hl' 文字列 (既定では (単一の文字列として):
"8:SpecialKey,@:NonText,d:Directory,
e:ErrorMsg,i:IncSearch,l:Search,m:MoreMsg,
M:ModeMsg,n:LineNr,r:Question,
s:StatusLine,S:StatusLineNC,c:VertSplit
t:Title,v:Visual,w:WarningMsg,W:WildMenu,
f:Folded,F:FoldColumn,A:DiffAdd,
C:DiffChange,D:DiffDelete,T:DiffText,
>:SignColumn,B:SpellBad,P:SpellCap,
R:SpellRare,L:SpellLocal,-:Conceal,
+:Pmenu,=:PmenuSel,
x:PmenuSbar,X:PmenuThumb")
グローバル
{Vi にはない}
このオプションは、様々な対象に対する強調表示モードを設定する。文字の組
をコンマ区切りのリストとして指定する。1番目の文字は適用される対象を指
定し、2番目の文字はその対象に適用するモードを指定する。
対象は以下の通りである。
|hl-SpecialKey| 8 ":map" でリスト表示されるメタキーと特殊キー
|hl-NonText| @ ウィンドウ末尾の '~' と '@' 、および
'showbreak'
によって表示される文字
|hl-Directory| d
CTRL-D によるリスト表示内のディレクトリや、その他
の特別な項目
|hl-ErrorMsg| e エラーメッセージ
h (古くて使われておらず、無視される)
|hl-IncSearch| i
'incsearch' の強調表示
|hl-Search| l 最終検索パターン強調表示 (
'hlsearch' を参照)
|hl-MoreMsg| m 「継続」プロンプト
|more-prompt|
|hl-ModeMsg| M モード表示 (例えば "-- INSERT --")
|hl-LineNr| n ":number" と ":#" 用の行番号
|hl-LineNr| n ":number" と ":#" コマンドでの行番号と、
'number'
か
'relativenumber' がオンに設定されているときの行
番号。
|hl-Question| r 「続けるには」プロンプト
|hit-enter| とyes/no質問
|hl-StatusLine| s カレントウィンドウのステータス行
|status-line|
|hl-StatusLineNC| S 非カレントウィンドウのステータス行
|status-line|
|hl-Title| t ":set all", ":autocmd" 等の出力のタイトル
|hl-VertSplit| c ウィンドウの垂直分割に使われる区切り
|hl-Visual| v Visualモード
|hl-VisualNOS| V X11 Gui
|gui-x11| と
|xterm-clipboard| でのみ有効
な、選択領域をクリップボードに送らないVisualモード
(訳注: "Not Owning the Selection" をこういう意味に
取りましたが、勘違いかもしれません。どなたかご教授
ください)
|hl-WarningMsg| w 警告メッセージ
|hl-WildMenu| W
'wildmenu' によって表示されるワイルドカードマッチ
|hl-Folded| f 閉じられた折り畳みを表す行
|hl-FoldColumn| F
'foldcolumn'
|hl-DiffAdd| A diff モードで追加された行
|hl-DiffChange| C diff モードで変更された行
|hl-DiffDelete| D diff モードで削除された行
|hl-DiffText| T diff モードで挿入されたテキスト
|hl-SignColumn| >
|signs| に使われる桁
|hl-SpellBad| B スペルミスの単語
|spell|
|hl-SpellCap| P 大文字で始まるべきの単語
|spell|
|hl-SpellRare| R 滅多に現れない単語
|spell|
|hl-SpellLocal| L 他の地域の単語
|spell|
|hl-Conceal| - Conceal テキストの代替表示 (
'conceallevel' 参照)
|hl-Pmenu| + ポップアップメニューの通常の行
|hl-PmenuSel| = ポップアップメニューの通常の行
|hl-PmenuSbar| x ポップアップメニューのスクロールバー
|hl-PmenuThumb| X ポップアップメニューのスクロールバーのつまみ
表示モードは以下の通りである。
r 反転 (termcapの項目 "mr" と "me")
i 斜字体 (termcapの項目 "ZH" と "ZR")
b 太字体 (termcapの項目 "md" と "me")
s 強調 (termcapの項目 "so" と "se")
u 下線 (termcapの項目 "us" と "ue")
c undercurl (termcapの項目 "Cs" と "Ce")
n 強調表示なし
- 強調表示なし
: 強調表示グループを使って設定
(訳注: 「文字の組」と書きながら、既定値はどれも2文字でないのは、
この ":" が使われているからである。これだけは例外で、グルー
プ名を使って指定できる)
ユーザに指定されなかった項目については、既定値が使われる。
表示モードの効果を変更したいなら、例として
|dos-colors| を参照。
表示モードに ':' を使うときは、その後に強調表示グループの名前を続けな
ければならない。強調表示グループは、色も含めて強調表示のあらゆるタイプ
を指定することができる。グループの定義方法については
|:highlight| を参
照。既定値では対象それぞれに異なったグループを使っている。既定の強調表
示グループについては
|highlight-default| を参照。
*'hlsearch'* *'hls'* *'nohlsearch'* *'nohls'*
'hlsearch' 'hls' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+extra_search| 機能付きでコンパイルされたとき
のみ有効}
前回の検索パターンが存在するとき、それにマッチするテキストを全て強調表
示する。強調表示のタイプは、オプション
'highlight' のフラグ 'l' によっ
て設定できる。既定では強調表示グループ "Search" が使われる。
Note マッ
チするテキストのみが強調表示されるので注意。オフセットは適用されない。
'incsearch' とコマンド
|:match| も参照。
マッチするテキストが強調表示されるを見飽きたら、
|:nohlsearch| で無効に
切り替えることができる。このコマンドはオプションの設定値を変更しないの
で、再び検索コマンドを使えば、強調表示も再び行われる。
検索する時間の上限は
'redrawtime' で設定できる。
検索パターンが行の終わり end-of-line にマッチするときは、Vimはマッチし
たテキスト全体を強調表示しようとする。しかし、検索を開始した場所によっ
て結果は異なる。ウィンドウの1番上の行または閉じられた折り畳みの次の行
では、表示されない行内のマッチの強調表示は、表示されている行に継続しな
い。
起動時に強調表示の状態を復元するかどうかは
'viminfo' の 'h' フラグで設
定できる
|viminfo-h|。
You can specify whether the highlight status is restored on startup
with the 'h' flag in
'viminfo' |viminfo-h|.
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'history'* *'hi'*
'history' 'hi' 数値 (Vimの既定値: 20, Viの既定値: 0)
グローバル
{Vi にはない}
":" によるコマンドと以前に使った検索パターンの履歴は保存されるわけだが、
このオプションはそれぞれの履歴に何個の項目が保存されるかを指定する
(
|cmdline-editing| を参照)。
NOTE: このオプションはオプション
'compatible' がオンのときはViの既定値
に、オフのときはVimの既定値になるので注意すること。
*'hkmap'* *'hk'* *'nohkmap'* *'nohk'*
'hkmap' 'hk' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
オンのときは、キーボードはヘブライ文字セットにマップされる。普通、オプ
ション
'allowrevins' をオンにしておき、insertモードでこのオプションを
コマンド
CTRL-_ で切り替えられるようにすることになる
|i_CTRL-_|。
|rileft.txt| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'hkmapp'* *'hkp'* *'nohkmapp'* *'nohkp'*
'hkmapp' 'hkp' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
オンのときは、キーボードは音声ヘブライ文字セットにマップされる。またオ
プション
'hkmap' もオンでなければならない。これはユーザがヘブライ語キー
ボードを持っていないときに便利である。
|rileft.txt| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'icon'* *'noicon'*
'icon' 切替 (既定ではオフ、タイトルが復元できるならばオン)
グローバル
{Vi にはない}
{Vimが |+title| 機能付きでコンパイルされたときのみ有
効}
オンのときは、ウィンドウのアイコンテキストが
'iconstring' に (値が空で
なければ) 設定される。空ならば現在編集されているファイル名に設定される。
ファイル名の末尾部分のみが使われる。
この設定は
'iconstring' によって上書きできる。
ターミナルがウィンドウアイコンの設定をサポートしているときのみ有効であ
る (現在のところ X11 GUI とターミナルオプション
't_IS' の値が空でない
ターミナルのみ --- これらは既定では Unix xterm と iris-ansi であり、こ
のとき
't_IS' の値は組み込み termcap から取られる)。
Vimが HAVE_X11 が定義された状態でコンパイルされたなら、可能であれば元
のアイコンが復元される
|X11|。X11でアイコンを変更するには
|X11-icon|
を参照。
*'iconstring'*
'iconstring' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+title| 機能付きでコンパイルされたときのみ有
効}
このオプションが空でないなら、ウィンドウのアイコンテキストに設定される。
これは
'icon' がオンのときのみ使われる。
ターミナルがウィンドウのアイコンテキストの設定をサポートしているときの
み有効である (現在のところ X11 GUI とターミナルオプション
't_IS' の値
が空でないターミナルのみ)。
MS-Windowsでは無効である。
Vimが HAVE_X11 が定義された状態でコンパイルされたなら、可能であれば元
のアイコンが復元される
|X11|。
値に関数 printf 形式の '%' を使った項目が含まれていると、それらは
'statusline' と同じように展開される。設定例は
'titlestring' を参照。
{Vimが |+statusline| 機能付きでコンパイルされたときのみ有効}
*'ignorecase'* *'ic'* *'noignorecase'* *'noic'*
'ignorecase' 'ic' 切替 (既定ではオフ)
グローバル
検索パターンにおいて大文字と小文字を区別しない。タグファイル内の検索に
も適用される。
オプション
'smartcase' も参照。
パターン内で "\c" や "\C" を使うことで、この設定を上書きできる。
|/ignorecase| を参照。
*'imactivatekey'* *'imak'*
'imactivatekey' 'imak' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+xim| 機能と |+GUI_GTK| 機能付きでコンパイル
されたときのみ有効} *E599*
X-Windowsでのインプットメソッド (IM) を起動するのに使われるキーを指定
する。これが正しく設定されていれば、VimはIMをオプション
'imcmdline',
'iminsert' や
'imsearch' によって完全に制御できる。
このオプションで起動キーを変えることはできない。これはただVimにそのキー
が何であるのか伝えるだけである。
書式は以下の通り。
[MODIFIER_FLAG-]KEY_STRING
以下の文字が MODIFIER_FLAG として使える (大文字でも小文字でもよい)。
S シフトキー
L ロックキー
C コントロールキー
1 修飾キー1
2 修飾キー2
3 修飾キー3
4 修飾キー4
5 修飾キー5
これらを組み合わせることができる。例えば "S-C-space" や "SC-space" は
みな shift+ctrl+space を表す。
KEY_STRING については <X11/keysymdef.h> と XStringToKeysym を参照。
例:
"S-space" は shift+space である。これは kinput2 + canna (日本語) およ
び ami (韓国語) の起動キーである。
*'imcmdline'* *'imc'* *'noimcmdline'* *'noimc'*
'imcmdline' 'imc' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+xim| 機能または |+multi_byte_ime| 機能または
|global-ime| 機能付きでコンパイルされたときのみ有効}
オンのときは、コマンドラインの編集を始めるときには常にインプットメソッ
ド (IM) がオンになる。ただし検索パターンの入力には適用されない (それに
はオプション
'imsearch' を参照)。
ユーザの IM が英語の文字を直接入力できるならば (例えば IM が、普段使わ
れないキーからアクセント記号を入力する程度のものならば)、このオプショ
ンをオンにすると便利である。
*'imdisable'* *'imd'* *'noimdisable'* *'noimd'*
'imdisable' 'imd' 切替 (既定ではオフ、いくつかのシステム(SGI)ではオン)
グローバル
{Vi にはない}
{Vimが |+xim| 機能または |+multi_byte_ime| 機能または
|global-ime| 機能付きでコンパイルされたときのみ有効}
オンのときは、インプットメソッド (IM) が全く使われなくなる。これは IM
がうまく働かないとき、それを無効にしてしまうのに便利である。
現在のところ、SGI/IRIX のマシンではオンになっているのが既定である。こ
れは将来変更されるかもしれない。
*'iminsert'* *'imi'*
'iminsert' 'imi' 数値 (既定では 0、インプットメソッドがサポートされてい
れば 2)
バッファについてローカル
{Vi にはない}
訳注: iminsert=2 の場合、インサートモードを抜けると IM がオフにされます。
訳注: 再度インサートモードに入ると、前回抜けたときの IM 状態が復元
訳注: されます。この機能をオフにするには iminsert=0 にしてください。
:lmap かインプットメソッド (IM) がインサートモードで使われるかどうかを
指定する。指定できる値は以下の通り。
0 :lmap はオフ、IM もオフ
1 :lmap はオン、IM はオフ
2 :lmap はオフ、IM はオン
値 2 は、Vimが
|+multi_byte_ime| 機能または
|+xim| 機能または
|global-ime| 機能付きでコンパイルされたときのみ有効である。
コマンド
<Esc> でInsertモードを終える度に値を 0 に戻すには、次のように
すればよい。
これはInsertモードを終えるとき :lmap と IM を自動的にオフに切り替える。
Note Insertモードでコマンド
CTRL-^ を使うと、このオプションの値が変わ
るので注意
|i_CTRL-^|。
オプション
'keymap' に正しいキーマップ名が設定されると、このオプション
は 1 になる。
これはコマンド "r", "f" 等の引数にも適用される。
AthenaとMotifでは、値を 0 に設定すると正しく働かないようなXIMがある。
そのときは XIM を無効にするために
'imdisable' を使うこと。
*'imsearch'* *'ims'*
'imsearch' 'ims' 数値 (既定では 0、インプットメソッドがサポートされてい
れば 2)
バッファについてローカル
{Vi にはない}
:lmap かインプットメソッド (IM) が、検索パターンを入力するときに使われ
るかどうかを指定する。指定できる値は以下の通り。
-1
'iminsert' の値が使われ、それが検索パターンの入力にも
適用されているかのように動作する
0 :lmap はオフ、IM もオフ
1 :lmap がオン、IM はオフ
2 :lmap はオフ、IM がオン
Note Command-lineモードでコマンド
CTRL-^ を使うと、このオプションが変
わることに注意
|c_CTRL-^|。
値が -1 でないなら、
'keymap' に正しいキーマップ名が設定されると、この
オプションは 1 になる。
AthenaとMotifでは、値を 0 に設定すると正しく働かないようなXIMがある。
そのときは XIM を無効にするために
'imdisable' を使うこと。
*'include'* *'inc'*
'include' 'inc' 文字列 (既定では "^\s*#\s*include")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
{Vimが |+find_in_path| 機能付きでコンパイルされたとき
のみ有効}
(訳注: プログラミング言語の) インクルード命令を探すのに使われるパター
ンを設定する。値はコマンド "/" と同様の検索パターンである (
|pattern|
を参照)。既定値はC言語プログラム用に設定されている。このオプションはコ
マンド "[i", "]I", "[d" 等に使われる。
通常、マッチしたパターンの後に続くファイル名を認識するためにオプション
'isfname' が使われる。しかしパターン中に "\zs" が入っている場合、
"\zs" にマッチしたテキストから最後まで、または "\ze" が入っている場合
はそこまでがファイル名として認識される。スペースなど、
'isfname' に入っ
ていない文字を含めるにはこれを使う。そして
'includeexpr' を使ってマッ
チしたテキストを処理することができる。
スペースとバックスラッシュを含める方法については
|option-backslash| を
参照。
*'includeexpr'* *'inex'*
'includeexpr' 'inex' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+find_in_path| 機能と |+eval| 機能付きでコン
パイルされたときのみ有効}
オプション
'include' が判別した文字列を、ファイル名に変換するために使
われる expression を指定する。以下のようにして、Java言語で "." を "/"
に変換するようなときに便利である。
変数 "v:fname" は、判別されたファイル名に設定される。
このオプションの内容は
|sandbox| 内でも評価される。
コマンド
|gf| でも、ファイルの実際の名前が見つからないときは、これが使
われる。プログラミング言語の
'include' 文の後で "gf" を使えるようにな
る。
また
|<cfile>| にも使われる。
この式はサンドボックス
|sandbox| の中でも評価することができる。
|sandbox-option| を参照。
'includeexpr' を評価している間に、テキストを変更したり他のウィンドウに
移ることは許されない。
|textlock|
*'incsearch'* *'is'* *'noincsearch'* *'nois'*
'incsearch' 'is' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+extra_search| 機能付きでコンパイルされたとき
のみ有効}
検索コマンドを打ち込んでいる間にも、打ち込んだところまでのパターンがマッ
チするテキストを、すぐに表示する。マッチした文字列は強調表示される。パ
ターンが不適切であったり見つからなければ、何も表示されない。画面は次々
更新されることになるので、このオプションは表示の速いターミナルでのみ有
用である。
Note マッチが表示されても、カーソルは実際にはマッチした場所に移動して
いないので注意。カーソルを移動させるには、やはり
<Enter> を打ち込んで
検索コマンドを完了させる必要がある。
|+reltime| 機能つきでコンパイルされているときは約0.5秒だけ検索する。複
雑なパターンであったり、大量のテキストはマッチしない場合がある。これは
文字をタイプしている途中で Vim が応答しなくなってしまうのを避けるため
である。
強調表示は、オプション
'highlight' のフラグ 'i' によって設定できる。
'hlsearch' も参照。
CTRL-L を押すと、現在マッチしているテキストの後からコマンドラインへ1文
字を追加することができる。その際、
'ignorecase' と
'smartcase' が設定さ
れていてコマンドラインに大文字が含まれていなければ、追加された文字は小
文字に変換される。
CTRL-R CTRL-W を押すと、現在マッチしているテキストの末尾から単語を追加
することができる。そのとき、既にタイプされている文字は除かれる。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'indentexpr'* *'inde'*
'indentexpr' 'inde' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+cindent| 機能と |+eval| 機能付きでコンパイル
されたときのみ有効}
ある行の適切なインデントを得るために評価される expression。これは新し
い行が作られるとき、オペレータ
|=| が使われたとき、Insertモードでオプ
ション
'indentkeys' で指定したキーを打ち込んだときに使われる。
値が空でないとき、この設定が
'cindent' と
'smartindent' によるインデン
トの設定を上書きする。
'lisp' がオンのとき、このオプションは Lisp のイ
ンデントアルゴリズムによって上書きされる。
'paste' がオンのとき、このオプションはインデントに使われない。
指定された expression が評価されるとき、変数
|v:lnum| はインデント計算
の対象となっている行の行番号に設定される。また、この式を評価するとき、
カーソルもこの行に置かれる(移動してしまうかもしれないが)。
指定された expression は、インデントすべき空白の数を返さなければならな
い。そのままのインデントを保たせるには "-1" を返させればよい (つまり、
こうするとインデントには
'autoindent' が使われる)。
インデント深さを計算するのに便利な関数は、
|indent()|,
|cindent()| と
|lispindent()| である。
この expression の評価には副作用があってはならない！つまり、テキストを
変更したり、 別のウィンドウに移動してはいけない。評価後にはカーソル位
置は常に復元されるので、カーソルは移動してもよい。
普通、このオプションは関数を呼び出すように設定される:
'debug' が "msg" を含まないない限り、エラーメッセージの表示は抑制され
る。
|indent-expression| を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
この式はサンドボックス
|sandbox| の中で評価することができる。
|sandbox-option| を参照。
'indentexpr' を評価している間に、テキストを変更したり他のウィンドウに
移ることは許されない。
|textlock|
*'indentkeys'* *'indk'*
'indentkeys' 'indk' 文字列 (既定では "0
{,0},:,0#,!^F,o,O,e")
バッファについてローカル
{Vi にはない}
{Vimが |+cindent| 機能付きでコンパイルされたときのみ
有効}
Insertモードで打ち込まれたときに、現在行の再インデントを引き起こすキー
のリスト。これはオプション
'indentexpr' が空でないときのみ起きる。
書式は
'cinkeys' によって異なってくる。
|indentkeys-format| を参照。
|C-indenting| と
|indent-expression| を参照。
*'infercase'* *'inf'* *'noinfercase'* *'noinf'*
'infercase' 'inf' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
Insertモードで単語補完
|ins-completion| をしているとき、このオプション
と
'ignorecase' がオンならば、マッチした単語の大文字／小文字の区別は打
ち込んだテキストに応じて修正される。打ち込んだテキストでは小文字だがマッ
チした単語では大文字であるような所があれば、補完される部分もみな小文字
になる。打ち込んだテキストには小文字が1個もなく、打ち込んだテキストで
は大文字だがマッチした単語では小文字であるような所があり、かつその前に
文字があるならば、補完される部分もみな大文字になる。
'noinfercase' にすると、マッチした単語がそのまま挿入される。
*'insertmode'* *'im'* *'noinsertmode'* *'noim'*
'insertmode' 'im' 切替 (既定ではオフ)
グローバル
{Vi にはない}
VimがInsertモードを中心として動作するようになる。Vimをモードを持たない
エディタとして使いたいときに便利である。
|evim| で使われている。
以下のInsertモードのコマンドが便利だろう。
- カーソル移動に矢印キーを使う
- 1個のNormalモードコマンドを実行するためにはコマンド
CTRL-O を使う
|i_CTRL-O|。コマンドが別のキー列にマッピングされていたときは、オプショ
ン
'insertmode' がオフであるときのように実行される。つまりマッピング
の内容が終了するまでNormalモードが続く。
- 数個のNormalモードコマンドを使うためには先に
CTRL-L を使い、その後
Insertモードに戻るために
<Esc> を使う。
Note CTRL-L を使うと、
'insertmode' をオフにして
<Esc> を押したときと同様にカーソルが左へ移
動する。
|i_CTRL-L|
'insertmode' がオンになると、以下の項目に変化がある。
- ファイルの編集を始めたとき、VimはInsertモードになっている。
- Insertモードで
<Esc> を入力しても動作はなく (no-op)、ビープ音が鳴る。
- Normalモードで
<Esc> を入力するとInsertモードに移る。
- Insertモードでの
CTRL-L の入力はコマンドであり、挿入されない。
- Insertモードで
CTRL-Z を入力するとサスペンドする。
|CTRL-Z|を参照。
*i_CTRL-Z*
しかしマッピング内で
<Esc> が使われたときは、
'insertmode' がオフのとき
のように動作する。これは
'insertmode' がオンでもオフでも、同じマッピン
グが使えるようにするためである。
|:normal| でNormalモードコマンドを実行するときは、
'insertmode' は使わ
れない。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'isfname'* *'isf'*
'isfname' 'isf' 文字列 (MS-DOS, Win32とOS/2での既定値は:
"@,48-57,/,\,.,-,_,+,,,#,$,%,
{,},[,],:,@-@,!,~,="
AMIGAでは: "@,48-57,/,.,-,_,+,,,$,:"
VMSでは: "@,48-57,/,.,-,_,+,,,#,$,%,<,>,[,],:,;,~"
OS/390では: "@,240-249,/,.,-,_,+,,,#,$,%,~,="
それ以外では: "@,48-57,/,.,-,_,+,,,#,$,%,~,=")
グローバル
{Vi にはない}
ファイル名やパス名に使われる文字を指定する。ファイル名はコマンド "gf",
"[i" 等やタグファイル内で使われる。またパターン
|pattern| 内の "\f" に
も使われる。
文字コードが 256 以上のマルチバイト文字は常に含まることになっているの
で、文字コードが 255 以下の文字のみをこのオプションで指定する。
UTF-8では、文字コードが 0xa0 から 0xff の文字は、同様に常に含まれる。
このオプションに空白文字を加える場合はよく考えること! ファイル名にスペー
スが含まれることはあるが、スペースを含めると、ファイル名補完の際に、ど
こからどこまでがファイル名であるか判定できなくなってしまうだろう。おそ
らくスペースは含めない方がよいだろう。
Note '\' をパスの区切りに使うシステムでは、Vimは '\' がユーザの想定通
りに働くよう最善を尽くす。これには少し巧妙なことをしている。なぜならVi
は元々、'\' を特殊文字をエスケープするために使っていたからだ。そういっ
たシステムでは、普通のファイル名の文字の前にある '\' を取り除かない。
しかしUnix系列のシステムでは取り除く。既定では '&' と '^' は含まれない。
それはこれらの文字が cmd.exe (訳注: Windows NTのシェル) にとって特別な
意味を持つからである。
このオプションの値の書式は、コンマ区切りの指定部のリストである。それぞ
れの指定部は単一の文字または範囲指定からなる。範囲指定は2個の文字コー
ドが '-' で区切られたものである。文字コードは 0 から 255 の10進整数だ
が、代わりにASCIIキャラクタ自身を使ってもよい (ただし数字には使えない)。
例:
"_,-,128-140,#-43" ('_' と、'-' と、コードが 128 から 140
までの文字と、'#' からコードが 43 ま
での文字を含む)
指定部が '^' で始まるとき、それに続く文字コードまたは範囲は指定から除
外される。オプションは左から右に解釈されるので、指定したある範囲に除外
したい文字があったら、それをその範囲の後に除外指定すること。文字 '^'
自体を値に含みたいときは、値または指定部の最後に指定すること。例:
"^a-z,#,^" ('a' から 'z' までの文字を除き、'#' と '^' を
含む)
文字として '@' を指定すると、関数 isalpha() で TRUE が返るような文字全
てが含まれる。普通、それは a から z と A から Z の文字と、それらにアク
セントのついたものである。文字 '@' 自身を値に含みたいときは、"@-@" と
すること。例:
"@,^a-z" アルファベットの仲間全て、ただしアルファベット
の小文字は除く
"a-z,A-Z,@-@" アルファベット全てと、文字 '@'
コンマを含めるには、文字コードが来るはずのところにコンマをおけばよい。
例:
"48-57,,,_" 数字と、コンマと、下線 (アンダースコア)
コンマを除外するには、前に '^' をおく。例:
" -~,^,,9" 空白から '~' までの全ての文字、ただしコンマと
<Tab> を除く
値に空白や '\' を含める方法については、
|option-backslash| を参照。
*'isident'* *'isi'*
'isident' 'isi' 文字列 (MS-DOS, Win32とOS/2での既定値は:
"@,48-57,_,128-167,224-235"
それ以外では: "@,48-57,_,192-255")
グローバル
{Vi にはない}
Identifier に使われる文字を指定する。Identifier は、環境変数の認識とオ
プション
'define' のマッチしたところの後に使われる。またパターン
|pattern| 内の "\i" にも使われる。このオプションの書式の説明は、
'isfname' を参考にすること。
注意: このオプションを変更すると、環境変数の展開に失敗するかもしれない。
例えば値に '/' が含まれているときに "$HOME/.viminfo" を展開しようとす
るとき等である。おそらく代わりに
'iskeyword' を変更するべきだろう。
*'iskeyword'* *'isk'*
'iskeyword' 'isk' 文字列 (MS-DOSとWin32でのVimの既定値:
"@,48-57,_,128-167,224-235"
それ以外のシステムでのVimの既定値:
"@,48-57,_,192-255"
Viの既定値: "@,48-57,_")
バッファについてローカル
{Vi にはない}
Keyword は、"w", "*", "[i" 等の多くのコマンドで検索と認識に使われる。
またパターン
|pattern| 内の "\k" にも使われる。このオプションの値の書
式の説明については、オプション
'isfname' を参考にすること。C言語プログ
ラムには "a-z,A-Z,48-57,_,.,-,>" が使えるだろう。
ヘルプファイルでは、このオプションは '*', '"', '|' と空白の仲間を除い
た全ての printable な文字 (訳注: 文書先頭を参照) に設定される (コマン
ド上で
CTRL-] を入力したときにそのコマンドについてのヘルプにジャンプで
きるようにするため)。
'lisp' がオンのときは、文字 '-' は常に含まれる。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意すること。
*'isprint'* *'isp'*
'isprint' 'isp' 文字列 (MS-DOS, Win32, OS/2とMacintoshでの既定値:
"@,~-255"; それ以外では: "@,161-255")
グローバル
{Vi にはない}
このオプションで指定された文字は、画面に直接表示される。またパターン
|pattern| 内の "\p" にも使われる。空白 (ASCIIコード 32) から '~'
(ASCIIコード 126) までの文字は、
'isprint' に指定されていなくても、また
は除外指定されていても、常に直接表示される。このオプションの書式の説明
は、
'isfname' を参考にすること。
unprintable な文字 (訳注: 文書先頭を参照) は、2文字で表示される。
0 - 31 "^@" - "^_"
32 - 126 常に1文字で表示される
127 "^?"
128 - 159 "~@" - "~_"
160 - 254 "| " - "|~"
255 "~?"
'encoding' がUnicodeの一種だったときは、文字コードが 128 から 255 まで
の不正な文字は、
<xx> という形式で16進表示される。
'display' に "uhex" が含まれているときは、全ての unprintable な文字が
<xx> の形式で表示される。
unprintable な文字には、強調表示グループ SpecialKey が使われる
|hl-NonText|。
文字コードが 256 以上のマルチバイト文字は常に含まれることになっている
ので、文字コードが 255 以下の文字のみをこのオプションに指定する。文字
が本来は printable だが現在のフォントでは表示できないときは、代替文字
が表示される。
Unprintable またはゼロ幅のUnicode文字は
<xxxx> という形式で表示される。
そういった文字を指定するオプションはない。
*'joinspaces'* *'js'* *'nojoinspaces'* *'nojs'*
'joinspaces' 'js' 切替 (既定ではオン)
グローバル
{Vi にはない}
行連結コマンドにおいて、 '.', '?' や '!' の後に空白を 2 個挿入する。オ
プション
'cpoptions' にフラグ 'j' が含まれるときは、'.' の後にのみ空白
を2個挿入する。
それ以外では空白は1個だけ挿入される。
NOTE: このオプションは、オプション
'compatible' がオンのときにはオンに
なるので注意。
*'key'*
'key' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+cryptv| 機能付きでコンパイルされたときのみ有
効}
カレントバッファを暗号化したり復号したりするのに使われるキー。
|encryption| と
'cryptmethod' を参照。
注意: このキーの値を手動で (訳注: コマンド ":set" を使って、ということ)
設定しないこと。誰かが入力された文字を盗み見るかもしれない。代わりにコ
マンド
|:X| を使うこと。しかし次のようにして、
'key' を空にするのはよい。
このオプションの値は、":set key" や "echo &key" 等で得ることはできない。
これは、値を知るべきでない人に知られないようにするためである。このこと
はまた、設定してしまうとユーザ自身も値を知ることができないということで
ある。タイプミスをしないよう注意！
スクリプトで "&key" を使うことで暗号化が有効になっているか確認でき
る。
'key' がセットされている場合は "*****" (5個のスター) が返る。
*'keymap'* *'kmp'* *E544*
'keymap' 'kmp' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+keymap| 機能付きでコンパイルされたときのみ有
効}
キーマッピングの名前を指定する。
|mbyte-keymap| を参照。
このオプションを適正なキーマップ名に設定すると、キーマッピングが有効に
なるようにオプション
'iminsert' が 1 になるという影響がある。また
'imsearch' も、元が -1 でない限り 1 になる。
通常のファイル名文字だけが使用できる。"/\*?[|<>" は不正である。
*'keymodel'* *'km'*
'keymodel' 'km' 文字列 (既定では "")
グローバル
{Vi にはない}
キーで可能なことを指定するためのキーワードの、コンマ区切りのリスト。指
定可能なキーワードは以下の通りである。
startsel シフトキーと特別なキーを同時に押して選択を開始する
(SelectモードとVisualモードのどちらでも、オプション
'selectmode' で指定された "キー" によって)。
stopsel シフトキーを押さないままの特別なキーで選択を止める。
ここでいう「特別なキー」とはカーソルキー、
<End>,
<Home>,
<PageUp> や
<PageDown> である。
'keymodel' は、コマンド
|:behave| によって設定される。
*'keywordprg'* *'kp'*
'keywordprg' 'kp' 文字列 (既定では "man" または "man -s", DOSでは:
":help", OS/2では: "view /", VMSでは: "help")
グローバルまたはバッファについてローカル
|global-local|
{Vi にはない}
コマンド
|K| に使われるプログラム。環境変数は展開される
|:set_env|。
Vim の内部ヘルプを開くコマンドは ":help" である(以前はこのオプションの
グローバル値を空にすると Vim の内部ヘルプが使われたが、今は推奨されて
いない)。
"man" が指定されたときは、"K" に指定されたカウントは自動的に章番号に変
換される。"man -s" でも同様で、この場合カウントがないときは "-s" は取
り除かれる。
値に空白や '\' を含める方法については、
|option-backslash| を参照。
例:
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'langmap'* *'lmap'* *E357* *E358*
'langmap' 'lmap' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+langmap| 機能付きでコンパイルされたときのみ
有効}
このオプションでは、ユーザのキーボードを特別な言語モードに切り替えられ
るようにする。 Insertモードで文字を入力しているときは、文字は直接入力
される。しかしCommandモードではオプション
'langmap' により、入力された
特別な文字をキー本来の文字に変換する。つまりNormalモードコマンドを実行
するためにキーボードモードを変更しなくともよいということである。
このオプションは
'keymap' と正反対のものである。
'keymap' はInsertモー
ドでマッピングを行う。
例 (ギリシア語に対して、UTF-8で):
*greek*
例 (コマンドの z と y の意味の交換):
'langmap' は、コンマ区切りの指定部のリストである。
それぞれの指定部は次の2種類のうちどちらかの形式に従う。
1. 2文字の組のリスト。変換「元」の文字の直後に変換「先」の文字を置い
て組を作る。例: "aA", "aAbBcC"
2. 変換「元」の文字のリスト、セミコロン、変換「先」の文字のリスト。
例: "abc;ABC"
例: "aA,fgh;FGH,cCdDeE"
特別な文字は '\' を前に置く必要がある。そのような文字は ";", ',' と
'\' 自身である。
Langmap を使えば言語間の切り替えなしにVimの機能を有効化することができ
る。以下のような場合では、ユーザの言語の文字でも、Vimは (langmap のマッ
ピングに従って) 通常の英語の文字として理解できる。
o Normal/Visualモード (コマンド、バッファ／レジスタ名、ユーザのマッピ
ング)
o Insert/Replaceモード:
CTRL-R 入力後のレジスタ名
o Insert/Replaceモード: マッピング
Command-lineモードで入力された文字には、このオプションは効力を「持たな
い」。
Note このオプションは、異なった言語／エンコーディング用のマッピ
ングを切り替えられるときにはいつでも設定を変更できることに注意。毎回マッ
ピング設定を打ち込まずに済むようにするには、マッピングを使うこと！
*'langmenu'* *'lm'*
'langmenu' 'lm' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+menu| 機能と |+multi_lang| 機能付きでコンパ
イルされたときのみ有効}
メニュー翻訳に使われる言語。つまり
'runtimepath' 内のディレクトリ
"lang" からどのファイルを読み込むのか指定する。指定方法は次の通り (空
白はなし)。
例えば、環境変数 $LANG が何に設定されていても、常にオランダ語メニュー
を使うには、次のようにする。
'langmenu' が空のときは、変数
|v:lang| が使われる。
通常のファイル名文字だけが使用できる。"/\*?[|<>" は不正である。
ユーザの環境変数 $LANG は英語以外の言語だが、必ず英語のメニューを使い
たいならば、次のようにする。
このオプションは、メニューの読み込み、ファイルタイプ判定の起動、構文強
調表示の起動のいずれよりも先に設定しなければならない。メニューが定義さ
れてしまうと、このオプションを設定しても何の効果もない。しかしこうする
ことはできる。
注意: こうすると、ユーザ自身の定義したメニューも含む、全てのメニューが
いったん削除される！
*'laststatus'* *'ls'*
'laststatus' 'ls' 数値 (既定では 1)
グローバル
{Vi にはない}
最下ウィンドウにいつステータス行が表示されるかを設定する。
0: 全く表示しない
1: ウィンドウの数が2以上のときのみ表示
2: 常に表示
ウィンドウをいくつか表示しているときには、ステータス行があると見栄えが
よくなる。しかし画面上の行をさらに必要とする。
|status-line|
*'lazyredraw'* *'lz'* *'nolazyredraw'* *'nolz'*
'lazyredraw' 'lz' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンのときは、マクロやレジスタの内容およびその他のキーボードから打ち込
まれないコマンドを実行する間、画面は再描画されなくなる。また、ウィンド
ウタイトルの更新も後回しになる。画面の再描画を強制的に行うには、コマン
ド
|:redraw| を使うこと。
*'linebreak'* *'lbr'* *'nolinebreak'* *'nolbr'*
'linebreak' 'lbr' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+linebreak| 機能付きでコンパイルされたときの
み有効}
オンのときは、画面に収まりきる最後の文字ではなく、オプション
'breakat'
に指定された文字のところで、長い行を折り返す。
'wrapmargin' や
'textwidth' と違い、これはファイルに実際の
<EOL> を挿入しない。このオ
プションが影響するのはファイルの表示方法であり、内容ではない。
'showbreak' に設定された文字が折り返された行の先頭に置かれる。このオプ
ションは、
'wrap' がオフであるか、
'list' がオンのときには使われない。
Note 大抵、
<EOL> の後の
<Tab> は正しい数の空白として表示されないので注
意。
*'lines'* *E593*
'lines' 数値 (既定では 24 またはターミナルの高さ)
グローバル
画面上の行数。普通このオプションはターミナルの初期化の時点で設定され、
手動で設定する必要はない。
|posix-screen-size| も参照。
VimがGUI環境内やサイズ変更可能なウィンドウ内で実行されているときは、こ
のオプションを変更するとウィンドウサイズも変更される。このサイズ設定を
GUI でだけ使用したいなら、このコマンドを
|gvimrc| ファイルに書くこと。
行数の最大値は、画面に収まる行数に制限される。可能な限りウィンドウの高
さを大きくするには次のコマンドを使う:
最小値は2、最大値は1000。
行数が期待したのより少なかったら、オプション
'guiheadroom' を確認する
こと。
あなたがこのオプションを変更したのに、Vimがディスプレイの行数の物理的
な値を変更できなかったら、ディスプレイ表示がめちゃめちゃになるおそれが
ある。
(訳注: オプション
'columns' も参照)
*'linespace'* *'lsp'*
'linespace' 'lsp' 数値 (既定では 0, Win32のGUI版では 1)
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
行間の幅のピクセル数。フォントが文字セルの高さを一杯に使っていて、行同
士が接触してしまうときに便利である。1 以上のときには下線を引く余裕がで
きる。
フォントによっては行間が広すぎることがある。その場合は
'linespace'を負
の値にすると調整することができる。しかしそうすると表示に問題が出る場合
がある。
*'lisp'* *'nolisp'*
'lisp' 切替 (既定ではオフ)
バッファについてローカル
{Vimが |+lispindent| 機能付きでコンパイルされたときの
み有効}
Lispモード: Insertモードで
<Enter> が入力されると、次の行のインデント
を Lisp の標準 (というかまあ、その一種) にする。また "cc" や "S" でも
同様である。これが機能するにはオプション
'autoindent' もオンでなければ
ならない。
'cpoptions' のフラグ 'p' はインデントの方法 (Vi互換か、より
良い方法か) を変更する。
'lispwords' も参照。
キーワードを構成する文字に '-' も含まれるようになる。
'equalprg' が空の
ときには、外部プログラムを呼び出さず、Lisp用のインデント用アルゴリズム
を使うように、オペレータ "=" を再定義する。
このオプションは、
'paste' がオンのときには使われない。
{Vi では微妙に動作が違う}
*'lispwords'* *'lw'*
'lispwords' 'lw' 文字列 (既定値はとても長い)
グローバル
{Vi にはない}
{Vimが |+lispindent| 機能付きでコンパイルされたときの
み有効}
Lisp用のインデント方法を設定するキーワードの、コンマ区切りのリスト。
|'lisp'|
*'list'* *'nolist'*
'list' 切替 (既定ではオフ)
ウィンドウについてローカル
listモード: タブ文字を
CTRL-I で表示し、行末に $ を表示する。タブ文字
と空白文字との差異や、行末に続く空白の差異を見るのに便利である。
オプション
'listchars' でより詳しく表示方法を設定できる。
カーソルはタブが占める桁の最初の位置に表示される。nolist の場合はノー
マルモードでカーソルをタブの上に移動させると、タブが占める桁の最後の位
置にカーソルが表示されるが、それと異なる。タブをスペースで表示しつつ、
カーソル位置をそのように変えたいなら、次のようにする:
Note オプション
'cpoptions' がフラグ 'L' を含むならば、このオプション
は整形コマンドにも影響することに注意 (
'textwidth' や
'wrapmargin' と共
に設定されたとき)。タブの表示方法の変更については、
'listchars' を参照。
*'listchars'* *'lcs'*
'listchars' 'lcs' 文字列 (既定では "eol:$")
グローバル
{Vi にはない}
'list' モードと
|:list| コマンドでの表示に使われる文字を設定する。値は
指定文字列のコンマ区切りのリストである。
eol:文字 行末の表示に使われる文字。指定されないと、行末には何も
表示されない。
tab:2文字 タブ文字の表示に使われる文字。1文字目は1回だけ使われる。
2文字目はタブが通常占めるだけの空白を埋めるまで繰り返
し表示される。
"tab:>-" とすると、タブが4文字の設定では ">---" となる。
指定されないと、タブは ^I と表示される。
trail:文字 行末の空白の表示に使われる文字。指定されないと、行末の
空白は何も見えない。
extends:文字
'wrap' がオフで、行が画面の右端よりも伸びているときに、
最終列に表示される文字。
precedes:文字
'wrap' がオフで、最前列で表示されている最初
の文字より前にテキストが存在するとき (訳注: 上の行の末
尾が画面の右端より伸びているとき) に、最前列に表
示される文字。
conceal:文字
'conceallevel' が 1 のときに Conceal されたテキストの
代わりに表示される文字。
nbsp:文字 non-breakable な空白(文字 0xA0, 160)を示す文字。
指定されない場合は空白のまま。
(訳注: 0xA0はLatin1でnon-breakableな空白を表す)
文字 ':' と ',' は使えない。
'encoding' が "utf-8" のときはUTF-8の文字
が使える。そうでないときはprintableな文字 (訳注: 文書先頭を参照) だけ
が使える。全ての文字は幅が1でなければならない。
例:
"eol", "extends", "precedes" には強調表示グループ "NonText" が、
"nbsp", "tab" と "trail" には "SpecialKey" が適用される。
|hl-NonText| |hl-SpecialKey|
*'lpl'* *'nolpl'* *'loadplugins'* *'noloadplugins'*
'loadplugins' 'lpl' 切替 (既定ではオン)
グローバル
{Vi にはない}
オンのときは、Vimが立ち上がるときにプラグイン・スクリプトが読み込まれ
る
|load-plugins|。
このオプションをユーザのファイル
|vimrc| 内でオフにすることで、プラグ
インの読み込みを無効化できる。
Note コマンドライン引数 "-u NONE" または "--noplugin" によってこのオプ
ションをオフにできることに注意
|-u| |--noplugin|。
*'macatsui'* *'nomacatsui'*
'macatsui' 切替 (既定ではオン)
グローバル
{Mac GUI 版でのみ利用可能}
これは描画が正しく行われないときのための回避策である。マルチバイト機能
付きでコンパイルされ、このオプションがオンになっているとATSUI テキスト
描画が使われる。オフのときは ATSUI テキスト描画は使われない。描画に問
題が出るならこのオプションをオフにすること。将来のバージョンではこの問
題は解決し、このオプションは非推奨になるかもしれない。そのため、このオ
プションをオフにするには次のような方法を使うこと:
描画の問題があるかをチェックするもう1つのオプションは、
'termencoding'
である。
*'magic'* *'nomagic'*
'magic' 切替 (既定ではオン)
グローバル
検索パターン内で使用可能な特別な文字を変更する。
|pattern| を参照。
NOTE: パターンの使用に関わる移植性の問題を避けるため、常にこのオプショ
ンを既定値のオンにしておくこと。古いViのスクリプトを使うときのみオフに
切り替えること。それ以外では、いつでも
'magic' がオンのときに動作する
ようなパターンを書くこと。検索パターンに "\M" を含めると magic になる。
|/\M|
*'makeef'* *'mef'*
'makeef' 'mef' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+quickfix| 機能付きでコンパイルされたときのみ
有効}
コマンド
|:make| (
|:make_makeprg| を参照) と
|:grep| に使われるエラー
ファイルの名前。
値が空のときは、内部で生成された一時ファイルが使われる。
"##" が含まれているときは、その部分はファイル名の一意性を保つための数
字に置き換えられる。こうすれば ":make" で既存のファイルを上書きしてし
まうことがなくなる。
":cf" には使われ「ない」。それについてはオプション
'errorfile' を参照。
環境変数は展開される
|:set_env|。
値に空白や '\' を含める方法については、
|option-backslash| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'makeprg'* *'mp'*
'makeprg' 'mp' 文字列 (既定では "make", VMSでは "MMS")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
コマンド ":make" で使われるプログラム。
|:make_makeprg| を参照。値には
文字 '%' と '#' を使える。これらはそれぞれ現在のファイル名と代替ファイ
ル名に展開される。
|:_%| |:_#|
環境変数は展開される
|:set_env|。値に空白や '\' を含める方法については、
|option-backslash| を参照。
Note 文字 '|' は2回エスケープすることに注意:
1回目はコマンド ":set" に対して、 2回目はコマンドの解釈に対してである。
ユーザのフィルタが "マイフィルタ" であるときは、次のようにする。
引数が挿入される場所を指定するには、"$*" を (複数回でも) 使える。例:
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'matchpairs'* *'mps'*
'matchpairs' 'mps' 文字列 (既定では "(:),
{:},[:]")
バッファについてローカル
{Vi にはない}
括弧などの組を構成する文字。コマンド
|%| で片方からもう片方にジャンプ
する。現在のところ、互いに異なる1バイトの文字の組のみが指定可能である。
文字はコロンで区切らなければならない。組はコンマで区切って指定する。値
に'<' と '>' を設定する例 (HTML用):
さらに興味深い例は、代入文の '=' と ';' の間でジャンプするもので、Cや
Java等の言語で便利である。
コマンド "%" のさらに発展的な使用法については、ディレクトリ
$VIMRUNTIME/macros 内のプラグイン matchit.vim を参照。
|add-local-help|
*'matchtime'* *'mat'*
'matchtime' 'mat' 数値 (既定では 5)
グローバル
{Vi にはない}{Nvi で使われる}
オプション
'showmatch' がオンのとき、マッチしている括弧を表示するため
の時間を0.1秒単位で指定する。
Note このオプションでは、他の時間関係のオ
プションと違い、単位がミリ秒でないので注意。これは Nvi との互換性を保
つためである。
*'maxcombine'* *'mco'*
'maxcombine' 'mco' 数値 (既定では 2)
グローバル
{Vi にはない}
{Vim が |+multi_byte| 機能付きでコンパイルされたとき
のみ利用可能}
表示の際にサポートされている文字の組み合わせ数の最大値。
'encoding' が "utf-8" のときだけ適用される。
ほとんどの言語に対しては既定値で十分である。ヘブライ語は4以上が必要で
ある。最大値は6。
このオプションの値が2のときでも、それ以上の組み合わせのテキストを編集
することは可能である。ただしそれを表示することはできない。
|g8| や
|ga|
を使う。
|mbyte-combining| を参照。
*'maxfuncdepth'* *'mfd'*
'maxfuncdepth' 'mfd' 数値 (既定では 100)
グローバル
{Vi にはない}
{Vimが |+eval| 機能付きでコンパイルされたときのみ有効}
ユーザ定義関数の関数呼び出しの深さの最大値。これは普通、終わらない再帰
呼び出しを捉えるために使われる。関数のさらに深い再帰呼び出しを使うとき
は、オプション
'maxfuncdepth' に、さらに大きい値を設定すること。しかし
こうするとメモリを余計に消費するので、メモリを使い果たしたときに落ちる
危険がある。
|:function| も参照。
*'maxmapdepth'* *'mmd'* *E223*
'maxmapdepth' 'mmd' 数値 (既定では 1000)
グローバル
{Vi にはない}
マッピングに対するマッピングを、文字が使われるまでに繰り返す回数の最大
値。これは普通、":map x y" と ":map y x" のような堂々巡りで終わらない
マッピングを捉えるために使われる。しかしこれは ":map g wg" 等は捉えな
い。それは次のマッピングが行われる前に 'w' が使われているからである。
|key-mapping| も参照。
*'maxmem'* *'mm'*
'maxmem' 'mm' 数値 (既定では 256 から 5120 の間 (システムによって
異なる) または利用できるメモリの半分)
グローバル
{Vi にはない}
1つのバッファに使用できるメモリの最大値 (キロバイト単位)。この限界に達
すると、バッファにさらにメモリを割り当てるときには、他のメモリを解放す
る。このオプションの最大値は約 2000000 である。限界を設けないときにはこ
の値に設定すること。
'maxmemtot' も参照。
*'maxmempattern'* *'mmp'*
'maxmempattern' 'mmp' 数値 (既定では 1000)
グローバル
{Vi にはない}
パターンマッチングに使うメモリ量の最大値(キロバイト単位)。設定可能な最
大値は約2000000。限界を設けないときにはこの値に設定すること。
*E363*
この制限に達したときは、エラーメッセージを表示し、たいていの場合
CTRL-C が押されたのと同じように振る舞う。
制限に達するのはたいてい、検索パターンが極めて非効率であるか複雑過ぎる
ときである。これは非常に長い行の上で "\(.\)*" を検索するとすぐになる。
".*" の方がはるかによい。
'maxmempattern' の制限に達する前に Vim がメモリ不足になるかもしれない。
*'maxmemtot'* *'mmt'*
'maxmemtot' 'mmt' 数値 (既定では 2048 から 10240 の間 (システムによっ
て異なる) または利用できるメモリの半分)
グローバル
{Vi にはない}
全てのバッファで使用するメモリの合計の最大値 (キロバイト単位)。このオ
プションの最大値は約 2000000 (2 ギガバイト)である。限界を設けないとき
にはこの値に設定すること。64 ビットマシンではもっと高くしても動作する
かもしれない。けれど、本当にテキストの編集に 2 ギガバイト以上も必要で
すか？
'maxmem' も参照。
*'menuitems'* *'mis'*
'menuitems' 'mis' 数値 (既定では 25)
グローバル
{Vi にはない}
{Vimが |+menu| 機能付きでコンパイルされたときのみ有効}
メニューの項目数の最大値。自動生成されるメニュー、例えばバッファメニュー
に対して使われる。このオプションを変更しても直接の効果はなく、メニュー
を更新しなければならない。
*'mkspellmem'* *'msm'*
'mkspellmem' 'msm' 文字列 (既定では "460000,2000,500")
グローバル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ有
効}
|:mkspell| に対するパラメータ。単語ツリーの圧縮を開始するタイミングを
設定する。単語がたくさんあると圧縮に時間がかかるが、メモリ不足になるの
を防ぐためには必要な事である。単語につき使われるメモリ量はそれらの単語
がどれだけ似ているかに密接に関係する。そのため、この設定は複雑になる。
3つの数値があり、それらをコンマで区切る:
{start},
{inc},
{added}
ほとんどの言語では圧縮しない単語ツリーがメモリに収まる。
{start} は圧縮
を行う前に使えるメモリ量をキロバイト単位で指定する。これは Vim が利用
可能なメモリ量より少し少なくするべきである。
{start} の制限を超えたとき、別な圧縮を行う前に割り当てることができるメ
モリ量を
{inc} によりキロバイト単位で指定する。これを低い値にするとよ
り少ない単語を追加した後に圧縮を行うことになる。高い値にするとより多く
のメモリが割り当てられることになる。
圧縮を行った後、さらにメモリが必要になって
{inc} の制限が無視されて圧
縮が行われる前に
{added}×1024 個の単語を追加することができる。これを
低い値にすると
{inc} の制限にぶつかる機会が少なくなり、より少ないメモ
リを使うが、遅くなる。
これらの値が重要になる言語はイタリア語とハンガリー語である。システムが
約 512Mbyte のメモリを備えているときは既定値でうまくいく。1 GByte のメ
モリを持っているならこうしてもよい:
512 Mbyte より少ないメモリしか持っていないなら、
'mkspellmem' がどんな
値であっても、ある言語に対しては
|:mkspell|が失敗するかもしれない。
*'modeline'* *'ml'* *'nomodeline'* *'noml'*
'modeline' 'ml' 切替 (Vimの既定値はオン (rootの場合はオフ)、
Viの既定値はオフ)
バッファについてローカル
*'modelines'* *'mls'*
'modelines' 'mls' 数値 (既定では 5)
グローバル
{Vi にはない}
オプション
'modeline' がオンのときは、テキスト中のコマンド ":set" を
'modelines' に指定された行数だけ調べる。
'modeline' がオフであるか、
'modelines' が 0 のときは、":set" は調べられない。
|modeline| を参照。
NOTE:
'modeline' は、オプション
'compatible' がオンのときはViの既定値
に、オフのときはVimの既定値になるので注意。
*'modifiable'* *'ma'* *'nomodifiable'* *'noma'*
'modifiable' 'ma' 切替 (既定ではオン)
バッファについてローカル
{Vi にはない} *E21*
オフのときは、バッファの内容が変更できなくなる。オプション
'fileformat' と
'fileencoding' も変更できなくなる。
コマンドライン引数
|-M| でオフに設定できる。
*'modified'* *'mod'* *'nomodified'* *'nomod'*
'modified' 'mod' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
オンのとき、バッファは変更を受けたものとされる。これは以下のようなとき
にオンになる。
1. 最後に書き込みをした後にテキストが変更されたとき。
|undo| をするコマ
ンドで元の状態まで戻ったときは、このオプションはオフになる。しかし
書き込みより前の編集を undo すると、再びこのオプションはオンになる。
テキストが最後に書き込まれたときと異なっているからである。
2. オプション
'fileformat' や
'fileencoding' が元の値と異なっていると
き。元の値とは、バッファが読み込まれたり書き込まれたときに設定され
た値である。コマンド ":set nomodified" は
'fileformat' や
'fileencoding' を現在の値に設定し、
'modified' をオフにする。
このオプションは、BufNewFile、BufRead/BufReadPost、BufWritePost、
FileAppendPost、VimLeave イベントでバッファが変更された場合には設定さ
れません。例として
|gzip-example| 参照。
'buftype' が "nowrite" または "nofile" であるときもこのオプションを設
定できるが、無視される。
*'more'* *'nomore'*
'more' 切替 (Vimの既定値: オン、Viの既定値: オフ)
グローバル
{Vi にはない}
オンのときは、一覧表示で画面が一杯になったときは一旦停止し、「継続」プ
ロンプト
|more-prompt| を表示する。オフのときは停止せず、最後まで表示
する。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'mouse'* *E538*
'mouse' 文字列 (既定では "", MS-DOS, Win32とGUI版では "a")
グローバル
{Vi にはない}
オンのとき、マウスが利用可能になる。特定のターミナルでのみ有効である
(xterm, MS-DOS, Win32
|win32-mouse|, QNX pterm, sysmouse 付きの *BSD
コンソール, gpm 付きの Linux コンソール)。GUIでマウスを使うことについ
ては、
|gui-mouse| を参照。
マウスの利用はモードごとに設定できる。
n Normalモード
v Visualモード
i Insertモード
c Command-lineモード
h ヘルプファイルを閲覧しているときの上記の4モード全て
a 上記の4モード全て
r 「続けるには」プロンプト
|hit-enter| および「継続」プ
ロンプト
|more-prompt| が出ているとき
普通、次のようにしてマウスを4モード全てで利用可能にする。
マウスを有効にしていなくても、GUI版ではモードレスセレクションにマウス
を使うことができる。しかしこのときにはカーソルは動かない。
|mouse-using| を参照。またオプション
'clipboard' も参照。
Note: ターミナルでマウスを有効にすると、Xサーバにアクセスできるならば
コピー／張り付けではレジスタ "* を使うことに注意。マウスボタンの xterm
風の操作は、シフトキーを押したままにすることで実現できる。
'clipboard' も参照。
*'mousefocus'* *'mousef'* *'nomousefocus'* *'nomousef'*
'mousefocus' 'mousef' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
オンのときは、マウスカーソルのおかれたウィンドウが自動的にアクティブに
なる。マウス以外でウィンドウ配置やウィンドウフォーカスを変更すると、マ
ウスカーソルはキーボードフォーカスと共に移動する。既定ではオフだが、こ
れはマウスカーソルを動かして予期しないウィンドウをアクティブにしてしま
うことがあるため、プルダウンメニューの利用を少し面倒にするからである。
*'mousehide'* *'mh'* *'nomousehide'* *'nomh'*
'mousehide' 'mh' 切替 (既定ではオン)
グローバル
{Vi にはない}
{VimのGUI版でのみ有効}
オンのとき、文字が入力されるときにはマウスカーソルが隠される。マウスが
動くとマウスカーソルは再び現れる。
*'mousemodel'* *'mousem'*
'mousemodel' 'mousem' 文字列 (既定では "extend", MS-DOSとWin32では "popup")
グローバル
{Vi にはない}
マウスの動作モデルを設定する。モデル名は主にマウスの右クリックで行われ
る動作を表している。
extend 右クリックで選択範囲を広げる。これは xterm と同様の動
作である。
popup 右クリックでポップアップメニューを表示する。シフト+左
クリックで選択範囲を広げる。これは MS-Windows のような
動作になる。
popup_setpos "popup" と似ているが、カーソルが右クリックした場所に移
動する。その結果、選択範囲を対象とする操作が (訳注: マ
ウスのドラッグで選択した範囲ではなく) クリックしたオブ
ジェクトに対して働くようになる。
元々操作の対象となるはずの選択範囲内を右クリックしたと
きは、カーソルは移動しない。もちろん、選択範囲の外側を
左クリックすればVisualモードは終了する。
それぞれのモデルでの、マウス操作の働きの一覧:
マウス操作 extend popup(_setpos)
左クリック カーソル移動 カーソル移動
左ドラッグ 選択開始 選択開始
シフト+左 単語検索 選択範囲の拡張
右クリック 選択範囲の拡張 メニュー (カーソル移動)
右ドラッグ 選択範囲の拡張 なし
中央クリック 張り付け 張り付け
"popup" モデルでは、右クリックでポップアップメニューを表示する。これは
先に定義しておかなければならない。
|popup-menu| を参照。
Note マウス操作による動作は、マッピングでさらに詳しく設定できることに
注意。
|gui-mouse-mapping| を参照。しかしマッピングはモードレスセレクショ
ンには「使われない」 (GUIそのものの機能であるため)。
オプション
'mousemodel' は、コマンド
|:behave| で設定できる。
*'mouseshape'* *'mouses'* *E547*
'mouseshape' 'mouses' 文字列 (既定では "i:beam,r:beam,s:updown,sd:cross,
m:no,ml:up-arrow,v:rightup-arrow")
グローバル
{Vi にはない}
{Vimが |+mouseshape| 機能付きでコンパイルされたときの
み有効}
それぞれのモードでのマウスカーソルの外観を設定する。値はコンマ区切りの
指定部のリストであり、オプション
'guicursor' に使われるものと大分似て
いる。指定部は、次のような状態リストと外観設定からなる。
状態リスト:外観,状態リスト:外観,..
状態リストは、以下のモードまたはカーソル位置のダッシュ '-' 区切りのリ
ストである。
普通のウィンドウ内:
n Normalモード
v Visualモード
ve
'selection' に "exclusive" が含まれているときのVisual
モード (指定されなければ 'v' と同じ設定になる)
o Operator-pendingモード
i Insertモード
r Replaceモード
その他:
c コマンドラインへの追加時
ci コマンドラインへの挿入時
cr コマンドラインでの置換時
m 「続けるには」プロンプトまたは「継続」プロンプト表示中
e 全てのモードにおいて、マウスカーソルが最下ウィンドウよ
りも下に置かれているとき
s 全てのモードにおいて、マウスカーソルがステータス行に置
かれているとき
sd 全てのモードにおいて、ステータス行をドラッグ中のとき
vs 全てのモードにおいて、マウスカーソルが垂直分割の区切り
行に置かれているとき
vd 全てのモードにおいて、垂直分割区切りをドラッグ中のとき
a あらゆる場所
指定可能なマウスカーソルの形は以下の通りである。
avail 名前 外見
w x arrow 普通のマウスカーソル
w x blank カーソルなし (注意して使うこと!)
w x beam I 状の縦棒
w x updown 上下のサイズ変更矢印
w x leftright 左右のサイズ変更矢印
w x busy システムの「待ち」カーソル
w x no システムの「入力不可」カーソル
x udsizing 上下のサイズ変更を示す
x lrsizing 左右のサイズ変更を示す
x crosshair 大きくて細い +
x hand1 黒い手
x hand2 白い手
x pencil 文字を書くときの、あの鉛筆
x question 大きな ?
x rightup-arrow 右上向き矢印
w x up-arrow 上向き矢印
x
<number> 任意の X11 のカーソルナンバー
(X11/cursorfont.h を参照)
上の "avail" という項目は、 'w' ならばそのマウスカーソルをWin32で利用
でき、'x' ならばX11で利用できることを表す。
指定されなかったモードや、利用不可能なカーソルを指定されたモードでは、
通常のマウスカーソルを使う。
例:
とすると、マウスカーソルはステータス行の上ではサイズ変更を表す形になり、
「続けるには」プロンプトが表示されているときには入力不可を表す (この状
態ではマウスクリックに効果がないので)。
*'mousetime'* *'mouset'*
'mousetime' 'mouset' 数値 (既定では 500)
グローバル
{Vi にはない}
GUI版, MS-DOS, Win32とUnixのxtermでのみ有効。ダブルクリックなどとして
認識されるクリックとクリックの間の時間を、ミリ秒単位で設定する。
*'mzquantum'* *'mzq'*
'mzquantum' 'mzq' 数値 (既定では 100)
グローバル
{Vi にはない}
{Vimが |+mzscheme| 機能付きでコンパイルされたときのみ
有効}
MzScheme のスレッドを切り替える間隔(ミリ秒)。
負または0にするとスレッドのスケジューリングを行わなくなる。
*'nrformats'* *'nf'*
'nrformats' 'nf' 文字列 (既定では "octal,hex")
バッファについてローカル
{Vi にはない}
テキスト内の数をコマンド
CTRL-A や
CTRL-X で増減させるとき、 Vimに何を
数として認識させるかを設定する。これらのコマンドの詳しい情報については
|CTRL-A| を参照。
alpha これが含まれると、単一のアルファベットも増減操作を受ける。これ
は a), b) 等の、文字を使ったリストに対して便利である。
*octal-nrformats*
octal これが含まれると、0 で始まる数は8進数として認識される。例:
"007"の上で
CTRL-A を使うと "010" となる。
hex これが含まれると、"0x" や "0X" で始まる数は16進数として認識さ
れる。例: "0x100" の上で
CTRL-X を使うと "0x0ff" となる。
1 から 9 の数字で始まる数は、常に10進数として認識される。8進数または16
進数として認識されない数も10進数として認識される。
*'number'* *'nu'* *'nonumber'* *'nonu'*
'number' 'nu' 切替 (既定ではオフ)
ウィンドウについてローカル
毎行の前に行番号を表示する。オプション
'cpoptions' にフラグ 'n' が含ま
れていないときは、折り返された行の先頭は行番号の表示される桁に入り込ま
ない (
'compatible' がオフのときはこれが既定である)。
オプション
'numberwidth' で行番号の幅を設定することができる。
折り返された行が長すぎて (訳注: 行の途中の部分だけで画面一杯になってし
まい) 行の本当の先頭の文字が表示されていないときは、文字 '-' が行番号
の前に表示される。行番号に使われる強調表示グループについては
|hl-LineNr| を参照。
このオプションをオンにすると
'relativenumber' はオフになります。
*'numberwidth'* *'nuw'*
'numberwidth' 'nuw' 数値 (Vim の既定値: 4 Vi の既定値: 8)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+linebreak| 機能付きでコンパイルされたときの
み利用可能}
行番号を表示するのに使われる桁数の最小値。
'number' か
'relativenumber'
がオンのときか行番号付きで印刷するときのみ意味がある。常に番号とテキス
トの間にスペースが1つ置かれるので、番号そのものに割かれる桁数はこれよ
り1文字少なくなる。
この値は最小の幅である。
'number' がオンのときにはバッファの行数、
'relativenumber' がオンのときにはウィンドウの行数を、それぞれ表示する
のに足りないときは設定されたよりも広い幅が使われる。つまり、Vim の既定
値の4だと、999行目までの幅が割り当てられることになる。バッファが1000行
以上になると5桁が割り当てられるようになる。
最小値は1。最大値は10。
NOTE:
'compatible' がオンになると
'numberwidth' は8になる。
*'omnifunc'* *'ofu'*
'omnifunc' 'ofu' 文字列 (既定では: 空)
バッファについてローカル
{Vi にはない}
{Vim が |+eval| と |+insert_expand| 機能付きでコンパ
イルされたときのみ利用可能}
このオプションはインサートモードにおける
CTRL-X CTRL-O でのオムニ補完
で使われる関数を指定する。
|i_CTRL-X_CTRL-O|
この関数がどのように呼び出され、何を返すべきかについては
|complete-functions| を参照。
このオプションは普通ファイルタイププラグインによって設定される。
|:filetype-plugin-on|
*'opendevice'* *'odev'* *'noopendevice'* *'noodev'*
'opendevice' 'odev' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{MS-DOS, MS-Windows and OS/2 でのみ有効}
デバイスからの読み書きを有効にする。これを有効にすると、オープンされて
いる可能性があるが、実際には入出力を行わないデバイスにひっかかる
可能性がある。(訳注: 原文は次の通り:
This may get Vim stuck on a device that can be opened but doesn't
actually do the I/O. )
そのため既定ではオフになっている。
MS-Windowsで"aux.h"、"lpt1.txt"などを編集するとデバイスを編集中になる
ことに注意。
*'operatorfunc'* *'opfunc'*
'operatorfunc' 'opfunc' 文字列 (既定では: 空)
グローバル
{Vi にはない}
このオプションはオペレータ
|g@| で呼び出される関数を指定する。
より詳しい情報と例については
|:map-operator| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'osfiletype'* *'oft'*
'osfiletype' 'oft' 文字列 (既定では: "")
バッファについてローカル
{Vi にはない}
このオプションは RISC OS でサポートされていましたが、RISC OS サポート
は削除されました。
*'paragraphs'* *'para'*
'paragraphs' 'para' 文字列 (既定では "IPLPPPQPP TPHPLIPpLpItpplpipb")
グローバル
Nroff (訳注: UNIXで使われる画面整形システム) で使われる、段落を分ける
ためのマクロを指定する。値は2文字の組である (
|object-motions| を参照)。
*'paste'* *'nopaste'*
'paste' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンにするとVimはPasteモードに移行する。これはテキストを別のウィンドウ
から切り取ったりコピーして、Vim内に張り付けたいときに便利であり、予想
しない作用を避けることができる。
このオプションはVimをターミナルで使っているときに便利である。ターミナ
ルでは打ち込まれたテキストと張り付けられたテキストの区別がつかないから
だ。GUI版のVimでは張り付け時にすべき動作を知っているので、
'paste' がオ
フでも大抵うまくいく。Vimがマウスクリックを扱えるようなターミナルでも
同様にうまくいく。
GUI を開始するとこのオプションはオフになる。そのため、.vimrc 内でこの
オプションをオンにすると、それはターミナル内では働くが、GUI ではオフに
なる。GUI 版で
'paste' をオンにすると次のような副作用がある: 例.
「ペースト」ツールバーボタンがインサートモードで動作しなくなる。このボ
タンはマッピングを使っているためである。
'paste' がオンのときは、以下のように設定が変わる。
- InsertモードとCommand-lineモードでのマッピングが無効になる
- 略語展開が無効になる
-
'textwidth' が 0 になる
-
'wrapmargin' が 0 になる
-
'autoindent' がオフになる
-
'smartindent' がオフになる
-
'softtabstop' が 0 になる
-
'revins' がオフになる
-
'ruler' がオフになる
-
'showmatch' がオフになる
-
'formatoptions' が空のときのような動作になる
以下のオプションの値に変化はないが、働きは無効になる。
-
'lisp'
-
'indentexpr'
-
'cindent'
NOTE:
'paste' がオンのときに別のファイルの編集を始めると、モードライン
や autocommand によって設定が再び変わり、張り付け時に問題が起きること
があるので注意。そのときは
'paste' を再びオンにするとよいだろう。
'paste' をオフにすると、上記のオプションの設定は
'paste' がオンになっ
た時点の前の状態に復元される。
'paste' をオンにする前にオフにしても何の効果もない。
'paste' がオンの間はマッピングが無効になるので、どれかのキーで
'paste'
を切り替えるには
'pastetoggle' を使う必要がある。
*'pastetoggle'* *'pt'*
'pastetoggle' 'pt' 文字列 (既定では "")
グローバル
{Vi にはない}
空でないとき、オプション
'paste' を切り替えるキー列を指定する。これは
以下のようなマッピングの設定に似ている。
ここで
{keys} は
'pastetoggle' の値が当てはまる。
違うのは、こちらは
'paste' がオンでも有効だという点だ。
'pastetoggle' はInsertモードとNormalモードで有効だが、Command-lineモー
ドでは無効である。
マッピングが最初に調べられるので、
'pastetoggle' を上書きできる。しかし
'paste' がオンならばInsertモードでマッピングは無視されるので、以下のよ
うな設定が可能である。
こうすると
<F10> でPasteモードが始まり、
<F11> でPasteモードが終わる。
Note Pasteモードで
<F10> を入力すると "
<F10>" が挿入されるので注意。こ
れは、Pasteモードでは
'pastetoggle' で指定されたキー列以外は全てそのま
ま挿入されるからである。
このオプションの値が複数バイトからなる場合、
'ttimeoutlen' が適用される。
*'pex'* *'patchexpr'*
'patchexpr' 'pex' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+diff| 機能付きでコンパイルされたときのみ有効}
ファイルにパッチを適用し、ファイルの新しいヴァージョンを生成するために
使われる式。
|diff-patchexpr| を参照。
*'patchmode'* *'pm'* *E206*
'patchmode' 'pm' 文字列 (既定では "")
グローバル
{Vi にはない}
値が空でないとき、ファイルの最も古いヴァージョンが保管されるようになる。
ソース配布物内のファイルに変更を加えたとき、元のヴァージョンを取ってお
きたいならこれを使う。最初にファイルが書き込まれたときのみ、元のファイ
ルのコピーが作られる。コピーのファイル名は、元のファイル名の後に
'patchmode' の値を付け加えたものである。このオプションの値はドットで始
めるようにすべきである。".org" 等を使うこと。この機能を使うには、
'backupdir' が空であってはならない (詳細: 変更後のファイルの書き込みが
成功してから、バックアップファイルがオリジナルをコピーしたファイルにリ
ネームされるため、バックアップファイルを生成できなければならない)。バッ
クアップすべきファイルがないときは、空ファイルが作られる。
'backupskip' がファイル名にマッチしたときは、元のファイルは保管されな
い。
圧縮ファイルに
'patchmode' を使うと、ファイル名末尾に拡張子が付けられ
るので (例えば "file.gz.orig")、その結果できたファイルは必ずしも圧縮ファ
イルとは認識されなくなってしまう。
通常のファイル名文字だけが使える。"/\*?[|<>" は不正である。
*'path'* *'pa'* *E343* *E345* *E347* *E854*
'path' 'pa' 文字列 (Unixでの既定値: ".,/usr/include,,"
OS/2での既定値: ".,/emx/include,,"
他のシステムでの既定値: ".,,")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
値はディレクトリのリストであり、コマンド
|gf|, [f, ]f, ^Wf,
|:find|,
|:sfind|,
|:tabfind| 等で、検索されるファイルが相対パス ("/", "./",
"../" で始まらないパス --訳注: MS-Windowsでは "C:/" 等で始まらないパス)
で指定されたときに使われるものである。オプション
'path' にディレクトリ
を指定するには、相対パスでも絶対パスでもよい。
- 複数のディレクトリ名はコンマで区切る。
- 区切りには空白も使える (
Vim version 3.0 との後方互換性のため)。中に
空白を含んだディレクトリ名を指定するには、空白の前に余分に '\' (訳注:
|option-backslash| を参照) を置き、その上で空白と '\' を '\' でエス
ケープすること。
- 中にコンマを含んだディレクトリ名を指定するには、コンマの前に余分に
'\' を置き、その上で '\' を '\' でエスケープすること。
- カレントファイルに対し相対的にディレクトリを指定するには、こうする。
- カレントディレクトリを指定するには、2個のコンマで空文字列を挟む。
- ディレクトリ名の末尾は ':' や '/' でもよい。
- 環境変数は展開される
|:set_env|。
- 公式プラグイン
|netrw.vim| を使っているときはURLも指定できる。例えば
"
http://www.vim.org" を追加すると ":find index.html" とすることがで
きる。
- "*", "**", ";" を使えばディレクトリツリーの上下に向かって検索できる。
詳しくは
|file-searching| を参照。
{Vimが |+path_extra| 機能付きでコンパイルされたときのみ有効}
- 文字 '\' の扱いには注意。オプションの値に '\' を1個含めるには、次の
ように2個打ち込む。
または、次のように代わりに '/' を使う。
値に "." を含めるのを忘れないこと！そうしないと、カレントファイルと同
じディレクトリ内のファイルさえも発見できない！
値の長さには制限がある。システムごとに異なるが、大抵は256文字か1024文
字等の長さである (訳注: これは半角の場合で、全角では半分)。
'path' でインクルードしたファイルを全て発見できているかどうかについて
は、
|:checkpath| を参照。
リストにディレクトリを追加するときにはコマンド
|:set+=|、リストからディ
レクトリを除くときにはコマンド
|:set-=| を使うのがよい。こうすると将来
のヴァージョンで異なった既定値が使われるようになったときに、問題が起き
るのを防げる。ただしカレントディレクトリを取り除くには次のようにする。
またカレントディレクトリを追加するには次のようにする。
環境変数を使うには、その中の区切り文字を変える必要があるだろう。次のも
のは環境変数 $INCL を追加する例だが、その中ではディレクトリ名はセミコ
ロン ';' で区切られているとする。
文字 ';' を ':' または指定可能な区切り文字で置換する。
Note この方法
は、$INCL がコンマや空白を含んでいるときには使えないので注意。
*'preserveindent'* *'pi'* *'nopreserveindent'* *'nopi'*
'preserveindent' 'pi' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
カレント行のインデントを変更するとき、可能な限りインデントの構造を保つ
ようにする。普通、インデントはまずタブで埋められ、その後に必要なだけス
ペースで埋められる(
|'expandtab'|がオンになっているときは違い、スペース
だけで埋められる)。このオプションをオンにすると、インデントの既存の文
字をできるだけそのままにし、追加の際に必要なだけタブやスペースを追加す
るようになる。
'expandtab' は適用されない。タブはタブのままになる。
NOTE: ">>" を複数回使うと、インデントにタブとスペースが混在するように
なる。これは好ましくないかもしれない。
NOTE:
'compatible' がオンになると
'preserveindent' はオフになる。
'copyindent' も参照。
空白文字を揃えるには
|:retab| を使う。
*'previewheight'* *'pvh'*
'previewheight' 'pvh' 数値 (既定では 12)
グローバル
{Vi にはない}
{Vimが |+windows| 機能と |+quickfix| 機能付きでコンパ
イルされたときのみ有効}
プレビューウィンドウの高さの既定値。コマンド
|:ptag| とその関連コマン
ドで使われる。
|CTRL-W_}| にカウントが指定されなかったときもこれが使わ
れる。
*'previewwindow'* *'nopreviewwindow'*
*'pvw'* *'nopvw'* *E590*
'previewwindow' 'pvw' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+windows| 機能と |+quickfix| 機能付きでコンパ
イルされたときのみ有効}
このオプションでプレビューウィンドウを決める。ただ1つのウィンドウでの
み、このオプションをオンに設定できる。普通、直接設定されることはないが、
コマンド
|:ptag|,
|:pedit| 等を使うと設定される。
*'printdevice'* *'pdev'*
'printdevice' 'pdev' 文字列 (既定では空)
グローバル
{Vi にはない}
{Vimが |+printer| 機能付きでコンパイルされたときのみ
有効}
|:hardcopy| で使われるプリンタの名前。
|pdev-option| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'printencoding'* *'penc'*
'printencoding' 'penc' 文字列 (いくつかのシステムを除き、既定は空)
グローバル
{Vi にはない}
{Vimが |+printer| と |+postscript| 機能付きでコンパイ
ルされたときのみ利用可能}
印刷の際に使われる文字エンコーディングを指定する。
|penc-option| を参照。
*'printexpr'* *'pexpr'*
'printexpr' 'pexpr' 文字列 (既定値は、以下を参照)
グローバル
{Vi にはない}
{Vimが |+printer| 機能と |+postscript| 機能付きでコン
パイルされたときのみ有効}
コマンド ":hardcopy" で生成されるPostScript (PS) ファイルを印刷するた
めに評価される expression を指定する。
|pexpr-option| を参照。
*'printfont'* *'pfn'*
'printfont' 'pfn' 文字列 (既定では "courier")
グローバル
{Vi にはない}
{Vimが |+printer| 機能付きでコンパイルされたときのみ
有効}
コマンド
|:hardcopy| の出力に使われるフォント名。
|pfn-option| を参照。
*'printheader'* *'pheader'*
'printheader' 'pheader' 文字列 (既定では "%<%f%h%m%=Page %
N")
グローバル
{Vi にはない}
{Vimが |+printer| 機能付きでコンパイルされたときのみ
有効}
コマンド
|:hardcopy| の出力のヘッダの書式を定義する。
|pheader-option|を参照。
*'printmbcharset'* *'pmbcs'*
'printmbcharset' 'pmbcs' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+printer|, |+postscript|, |+multi_byte| 機能
付きでコンパイルされたときのみ利用可能}
コマンド
|:hardcopy| の出力の中の CJK 文字に使われる文字集合。
|pmbcs-option| を参照。
*'printmbfont'* *'pmbfn'*
'printmbfont' 'pmbfn' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+printer|, |+postscript|, |+multi_byte| 機能
付きでコンパイルされたときのみ利用可能}
コマンド
|:hardcopy| の出力の中の CJK 文字に使われるフォント名のリスト。
|pmbfn-option| を参照。
*'printoptions'* *'popt'*
'printoptions' 'popt' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+printer| 機能付きでコンパイルされたときのみ
有効}
コマンド
|:hardcopy| の出力の書式を設定する項目のリスト。
|popt-option| を参照。
*'prompt'* *'noprompt'*
'prompt' 切替 (既定ではオン)
グローバル
オンならば、Ex モードでプロンプト ":" が表示される。
*'pumheight'* *'ph'*
'pumheight' 'ph' 数値 (既定では 0)
グローバル
{Vim が |+insert_expand| 機能付きでコンパイルされたと
きのみ利用可能}
{Vi にはない}
インサートモード補完のポップアップメニューに表示される項目数の最大値。
0 のときはスペースの許す限り多く表示される。
|ins-completion-menu|
*'quoteescape'* *'qe'*
'quoteescape' 'qe' 文字列 (既定では "\")
バッファについてローカル
{Vi にはない}
文字列内で引用符をエスケープする文字。テキストオブジェクト a', a", a`
|a'| などで使われる。
このオプションの文字のどれかが文字列内に現れると、その次の文字はスキッ
プされる。既定値では、テキスト "foo\"bar\\" が1つの文字列とみなされる。
*'readonly'* *'ro'* *'noreadonly'* *'noro'*
'readonly' 'ro' 切替 (既定ではオフ)
バッファについてローカル
オンのときは、書き込みコマンドは '!' を付けないと使えない。これは間違っ
てファイルを上書きしてしまうことを防ぐためのものである。Vimが読み込み
専用モードで起動された ("vim -R") ときと、実行ファイルの名前が "view"
のときにはオンが既定値になる。
'cpoptions' にフラグ 'Z' が入っていない場合、":w!" を使うとカレントバッ
ファの
'readonly' がオフになる。
{Vi には、以下のコマンドはない} コマンド ":view" を使って開かれたバッ
ファでは、オプション
'readonly' はオンになる。
*'redrawtime'* *'rdt'*
'redrawtime' 'rdt' 数値 (既定では 2000)
グローバル
{Vi にはない}
{
|+reltime| 機能付きでコンパイルされたときのみ有効}
画面を再描画するのにかける時間(ミリ秒)。
'hlsearch' がオンのときのパ
ターン検索や
|:match| によるハイライトに対して適用される。再描画にこれ
で指定したミリ秒以上の時間がかかるとき、それ以上のマッチはハイライトさ
れない。非常に複雑なパターンを検索するさいに Vim が応答しなくなるのを
避けるためである。
*'relativenumber'* *'rnu'* *'norelativenumber'* *'nornu'*
'relativenumber' 'rnu' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
カーソル行からの相対的な行番号を表示する。相対行番号を見れば縦移動のコ
マンドでカウント指定 (
|count|) を使うとき自分で数える必要がないので便
利です。特に他のコマンド (例: y d c < > gg gw =) と組み合わせるときな
ど。
'cpoptions' に 'n' オプションが含まれていないときは、折り返された行を
表示するのに行番号の表示領域は使われません (これは
'compatible' がオフ
のときの既定動作です)。
行番号の表示領域の幅は
'numberwidth' オプションで設定できます。
折り返された行がとても長くてその行頭が画面外にあるときは、行番号の前に
'-' 文字が表示されます。
行番号の強調表示には
|hl-LineNr| が使われます。
このオプションをオンにすると
'number' はオフになります。
*'remap'* *'noremap'*
'remap' 切替 (既定ではオン)
グローバル
再帰的マッピング (訳注: マッピングに対するマッピング、に対するマッピン
グ...) を有効にする。特定のマッピングに対して再帰的マッピングを禁止し
たいときは、コマンド ":noremap[!]" を使うこと。
NOTE: Vim スクリプトのポータビリティのために、このオプションは常に既定
値のオンのままにしておくこと。昔の Vi スクリプトを使うときだけこれをオ
フにすること。
*'report'*
'report' 数値 (既定では 2)
グローバル
変更された行の数の報告が出る最小値。変更された行の数がオプション
'report' より大きければ、ほとんどの ":" によるコマンドでメッセージが表
示される。必ず報告してほしいなら
'report' を 0 にすること。
コマンド ":substitute" では、基準は変更された行数ではなく、置換を行っ
た回数になる。
*'restorescreen'* *'rs'* *'norestorescreen'* *'nors'*
'restorescreen' 'rs' 切替 (既定ではオン)
グローバル
{Vi にはない} {VimのWindows 95/NTのコンソール版}
オンのとき、Vimを終了した後にコンソール画面の内容が復元される。外部コ
マンドを実行するときも同様である。
Windows版以外のVimでは: ファイル .vimrc で、オプション
't_ti' と
't_te'を設定することで実現できる。画面の復元を無効にするには次のように
する。
復元を有効にするには次のようにする (xterm用の設定)。
(ここで ^[ は
<Esc> であり、入力するには
CTRL-V <Esc> と打ち込む)
*'revins'* *'ri'* *'norevins'* *'nori'*
'revins' 'ri' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
Insertモードでの文字の挿入が通常と逆向きになる。"typing backwards" を
参照
|ins-reverse|。このオプションは、オプション
'allowrevins' がオン
ならばInsertモードでコマンド
CTRL-_ を使うことで切り替えられる。
NOTE: このオプションは、オプション
'compatible' または
'paste' がオン
のときはオフになるので注意。
*'rightleft'* *'rl'* *'norightleft'* *'norl'*
'rightleft' 'rl' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
オンのとき、画面表示の方向が右から左になる。つまり、ファイルに保存され
ている文字は右から左の方向へ表示される。このオプションを使うと、ヘブラ
イ語やアラビア語のような右から左に向かって書かれる言語によるファイルを
編集できる。このオプションはウィンドウごとに設定可能なので、ヘブライ語
と英語のファイルを同時に編集したり、同一のファイルを2通りに表示するこ
とができる (これは右から左のテキストと左から右のテキストが混在している
ファイルを編集するときに便利である。両方を異なるウィンドウで適切に表示
することができる)。
|rileft.txt| を参照。
*'rightleftcmd'* *'rlc'*
'rightleftcmd' 'rlc' 文字列 (既定では "search")
ウィンドウについてローカル
{Vi にはない}
{Vim が |+rightleft| 機能付きでコンパイルされたときの
み利用可能}
左←右書きモードで動作するコマンドを指定する:
search コマンド "/" と "?"
これはヘブライ語、アラビア語、ペルシア語などの言語で便利である。
オプション
'rightleft' を設定しないと
'rightleftcmd' は効果がない。
*'ruler'* *'ru'* *'noruler'* *'noru'*
'ruler' 'ru' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+cmdline_info| 機能付きでコンパイルされたとき
のみ有効}
カーソルが何行目の何列目に置かれているかを表示する (訳注: これをルーラ
と呼ぶ)。行数と列数はコンマで区切られる。幅に余裕があるときは、表示さ
れているテキストの、ファイル内での相対位置が右端に表示される。
先頭 ファイル先頭の行が表示されているとき
末尾 ファイル末尾の行が表示されているとき
全て ファイル先頭と末尾の行の両方が表示されているとき
45% ファイル内での相対位置
オプション
'rulerformat' が設定されているときは、それによってルーラの
内容が指定される。ルーラはウィンドウごとに表示される。ウィンドウにステー
タス行が表示されていれば、ルーラもそこに表示される。そうでなければ画面
の末尾の行に表示される。ステータス行の内容が
'statusline' で指定されて
いるときは (つまりその値が空でないときは)、
'statusline' が
'ruler' や
'rulerformat' より優先される。
表示された文字の数がテキスト上でのバイト数と違うときは (例えば、タブ文
字やマルチバイト文字があるとき)、テキスト上の列数 (バイト数) と画面上
の列数が、ダッシュで区切られて両方表示される。
空行では "0-1" と表示される。
空のバッファでは行数も0になり、 "0,0-1" と表示される。
このオプションは、
'paste' がオンのときはオフになる。
ルーラを常に表示したくはないが、テキスト内のどこにいるのか知りたいとき
は、コマンド "g
CTRL-G" を使うこと
|g_CTRL-G|。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフに
なるので注意。
*'rulerformat'* *'ruf'*
'rulerformat' 'ruf' 文字列 (既定では空)
グローバル
{Vi にはない}
{Vimが |+statusline| 機能付きでコンパイルされたときの
み有効}
値が空でないときは、オプション
'ruler' によって表示されるルーラの内容
を指定する。
このオプションの書式は
'statusline' のものと同様である。
ルーラの幅は既定では17文字である。幅を15文字にするには、値の先頭に
"%15(" を置き、末尾に "%)" を置くこと。例:
*'runtimepath'* *'rtp'* *vimfiles*
'runtimepath' 'rtp' 文字列 (既定値:
Unix: "$HOME/.vim,
$VIM/vimfiles,
$VIMRUNTIME,
$VIM/vimfiles/after,
$HOME/.vim/after"
Amiga: "home:vimfiles,
$VIM/vimfiles,
$VIMRUNTIME,
$VIM/vimfiles/after,
home:vimfiles/after"
DOS, MS-Win系, OS/2: "$HOME/vimfiles,
$VIM/vimfiles,
$VIMRUNTIME,
$VIM/vimfiles/after,
$HOME/vimfiles/after"
Macintosh: "$VIM:vimfiles,
$VIMRUNTIME,
$VIM:vimfiles:after"
RISC-OS: "Choices:vimfiles,
$VIMRUNTIME,
Choices:vimfiles/after"
VMS: "sys$login:vimfiles,
$VIM/vimfiles,
$VIMRUNTIME,
$VIM/vimfiles/after,
sys$login:vimfiles/after")
グローバル
{Vi にはない}
以下のランタイムファイルが検索されるディレクトリのリスト。
filetype.vim ファイル名によるファイルタイプの決定
|new-filetype|
scripts.vim ファイルの内容によるファイルタイプの決定
|new-filetype-scripts|
autoload/ 自動的に読み込まれるスクリプト
|autoload-functions|
colors/ 色テーマ定義ファイル
|:colorscheme|
compiler/ コンパイラ定義ファイル
|:compiler|
doc/ ヘルプドキュメント
|write-local-help|
ftplugin/ ファイルタイププラグイン
|write-filetype-plugin|
indent/ インデントスクリプト
|indent-expression|
keymap/ キーマップ定義ファイル
|mbyte-keymap|
lang/ 翻訳版メニュー
|:menutrans|
menu.vim GUI版メニュー
|menu.vim|
plugin/ プラグインスクリプト
|write-plugin|
print/ 印刷用のファイル
|postscript-print-encoding|
spell/ スペルチェック用のファイル
|spell|
syntax/ 文法ファイル
|mysyntaxfile|
tutor/ Vimtutor用ファイル
|tutor|
および、コマンド
|:runtime| で検索される全てのファイル。
ほとんどのシステムでの既定値は、以下の5カ所を検索するようになっている。
1. ユーザの個人的な設定を読み込むため、ユーザのホームディレクトリを検
索する。
2. システム管理者による設定を読み込むため、システム共通のVim用ディレク
トリを検索する。
3. Vim付属のファイルを読み込むため、環境変数 $VIMRUNTIME 内を検索する。
*after-directory*
4. システム管理者が付属ファイルによる設定を上書きしたり、それに追加設
定をしたりできるようにするため、システム共通のVimディレクトリ内のディ
レクトリ "after" を検索する (これは滅多に使われない)。
5. ユーザが付属ファイルやシステム管理者による設定を上書きしたり、それ
に追加設定をしたりできるようにするため、ユーザのホームディレクトリ
内のディレクトリ "after" を検索する。
Note オプション
'path' と違い、ワイルドカードのうち "**" 等は使えない
ことに注意。普通のワイルドカードは使えるが、ランタイムファイルの検索が
目に見えて遅くなることがある。速度を向上させるには、設定する項目の数を
なるべく少なくし、ワイルドカードの使用を避けること。
|:runtime| を参照。
例:
こうすると、ディレクトリ "~/vimruntime" (ユーザの個人的Vimランタイムファ
イルを格納) を最初に検索し、次にディレクトリ "/mygroup/vim" (グループ
共通の設定ファイルを格納) を、最後に "$VIMRUNTIME" (付属ランタイムファ
イル) を検索する。
付属ランタイムファイルを使えるようにするため、どこかに必ず環境変数
$VIMRUNTIME を指定するべきだろう。付属ランタイムファイルの代わりに使う
ファイルを置くディレクトリは、環境変数 $VIMRUNTIME の前に指定すればよ
い。付属ランタイムファイルによる設定に追加するためのファイルを置くディ
レクトリは、環境変数 $VIMRUNTIME の後に指定すればよい。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'scroll'* *'scr'*
'scroll' 'scr' 数値 (既定では、ウィンドウ高の半分)
ウィンドウについてローカル
コマンド
CTRL-U や
CTRL-D でスクロールする行数。ウィンドウのサイズが変
わると、ウィンドウの行数の半分に設定される。
CTRL-U や
CTRL-D を、カウ
ントを指定して使うと、カウントはオプション
'scroll' の値として使われる。
":set scroll=0" とすると、値はウィンドウ高の半分に戻る。
{Vi では微妙
に違う: オプション 'scroll' ではファイル上の行数ではなく、画面上の行数
を指定していた。行の折り返しがあるときに違いが出る}
*'scrollbind'* *'scb'* *'noscrollbind'* *'noscb'*
'scrollbind' 'scb' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+scrollbind| 機能付きでコンパイルされたときの
み有効}
|scroll-binding| も参照。オンのとき、カレントウィンドウは他のスクロー
ル同調中ウィンドウ (このオプションがオンになっているウィンドウ) と同じ
だけスクロールする。このオプションは、ファイルの2個のヴァージョン間の
違いを見るのに便利である。オプション
'diff' を参照。
このオプションがどのように解釈されるかを決定するオプションについては、
オプション
'scrollopt' を参照。
ウィンドウを分割して他のファイルを編集すると、ほとんどの場合このオプショ
ンはオフになる。よって ":split | edit file" はウィンドウを2つに分割し、
scroll-binding を設定するが、":split file" はそうならない。
*'scrolljump'* *'sj'*
'scrolljump' 'sj' 数値 (既定では 1)
グローバル
{Vi にはない}
カーソルが画面外に出たときにスクロールする行数の最小値 (例えばコマンド
"j" 等によって)。スクロールコマンド (例えば
CTRL-E,
CTRL-D) には使われ
ない。ユーザのターミナルのスクロールがとても遅いときに便利である。
-1 から -100 までの負の数に設定すると、ウィンドウの高さのパーセンテー
ジとして扱われる。つまり -50 はウィンドウの高さの半分スクロールする。
NOTE: このオプションは、オプション
'compatible' がオンのときは 1 にな
るので注意。
*'scrolloff'* *'so'*
'scrolloff' 'so' 数値 (既定では 0)
グローバル
{Vi にはない}
カーソルの上または下には、最低でもこのオプションに指定した数の行が表示
される。これにより、編集中の箇所の周辺のテキストを見ることができる。と
ても大きい値 (999等) にすると、カーソルの置かれた行は常にウィンドウの
中央に表示される (ファイル先頭または末尾にいるときと、長い行が折り返さ
れているとき以外)。
水平スクロールについてはオプション
'sidescrolloff' を参照。
NOTE: このオプションは、オプション
'compatible' がオンのときは 0 にな
るので注意。
*'scrollopt'* *'sbo'*
'scrollopt' 'sbo' 文字列 (既定では "ver,jump")
グローバル
{Vimが |+scrollbind| 機能付きでコンパイルされたときの
み有効}
{Vi にはない}
スクロール同調中ウィンドウ (訳注: オプション
'scrollbind' がオンのウィ
ンドウ) の動作を設定するキーワードの、コンマ区切りのリスト。
'sbo' は
ScrollBindOptions の略である。
指定可能なキーワードは以下の通りである。
ver 同調中ウィンドウの垂直スクロールを同調させる
hor 同調中ウィンドウの水平スクロールを同調させる
jump これは垂直スクロールにおいて、2個のウィンドウ間の
offset に適用される。この offset とは同調中ウィンドウ
に表示されているテキストの先頭行のずれのことである。
ウィンドウ内を動き回るときは、別の同調中ウィンドウの表
示区域が、バッファの先頭より前またはバッファの末尾より
後ろに達してしまうかもしれない。それでも offset は変更
されず、カーソルが戻ってきたときは、同調中ウィンドウは
可能ならば求められる位置にスクロールしようとする。
カレントウィンドウを変更したときは、相対 offset を使っ
て2つのことが行われる。
1. 値に "jump" が含まれていないとき、新しくカレントウィ
ンドウになったウィンドウのスクロール位置により相対
offset が調節される。別のウィンドウに戻ったときは、
新しい相対 offset が使われる。
2. 値に "jump" が含まれているとき、同じ相対オフセット
を保つために他のウィンドウもスクロールする。他のウィ
ンドウに戻ったときも、同じ相対 offset を使う。
("jump" についての訳注: 100行のファイル "short" と200行のファイル
"long" をウィンドウ分割で並べ、1行目を表示させたまま共に
'scrollbind'
をオンにする。"long" を開いているウィンドウで150行目に移動すると、
"short" に150行目はないのだから、ウィンドウの同調が崩れる。具体的には、
"short" の方だけ100行目を表示したままになる。しかしそのまま "long" の
50行目に移動すると、何事もなかったかのように "short" のウィンドウも50
行目を表示する。しかし "long" の150 行目に移動した時点でカーソルを
"short" のウィンドウ (の100行目) に移すと、"jump" によって違いが出る。
1. では「"long" では150行目、"short" では100行目」という状態が新たな基
準となり、"short" のウィンドウで50行目に移ると、"long" のウィンドウは
とにかく50行バック、というわけで100行目を表示する。2. では「1行目同士
を合わせる」という基準は変わらず、やはり100行目同士を合わせろ、という
わけでウィンドウを移って "short" の100行目に着いた瞬間に "long" のウィ
ンドウも100行目を表示する。話を簡単にするために始めは共に1行目を表示し
ているとしたが、始めがずれているとそれが基準となることに注意)
|scroll-binding| も参照。
差分モードでは、たとえ "ver" が含まれていなくても常に垂直スクロール同
調をする。
*'sections'* *'sect'*
'sections' 'sect' 文字列 (既定では "SHNHH HUnhsh")
グローバル
Nroff (訳注: UNIXで使われる画面整形システム) で使われる、章を分けるた
めのマクロを指定する。値は2文字の組である (
|object-motions| を参照)。
既定では、章は nroff マクロの ".SH", ".NH", ".H", ".HU", ".nh" および
".sh" で始まることになる。
*'secure'* *'nosecure'* *E523*
'secure' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンのとき、コマンド ":autocmd" やシェルコマンド、書き込みコマンドがカ
レントディレクトリ内のファイル ".vimrc" や ".exrc" では使用できなくな
り、マッピングコマンドも表示されるようになる。問題が起きることはないと
分かっているときか、オプション
'exrc' がオフのときにのみこのオプション
をオフにすること。
Unixでは、このオプションはファイル ".vimrc" または ".exrc" の所有者が
ユーザ自身でないときのみ使われる。これはユーザが "chown" を使えるシス
テムでは危険である。そのときにはユーザのファイル ~/.vimrc の末尾で
'secure' をオンにしておいた方がよい。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'selection'* *'sel'*
'selection' 'sel' 文字列 (既定では "inclusive")
グローバル
{Vi にはない}
このオプションは、選択時の動作を設定する。これはVisualモードとSelect
モードでのみ使用される。
設定可能な値は以下の通り。
値 行末の後 末尾に操作
old X O
inclusive O O
exclusive O X
「行末の後」というのは、カーソルを行末より1文字後ろに置けることを表す。
「末尾に操作」というのは、選択領域の末尾の文字が操作を受けることを表す。
例えば、選択領域の削除に "x" が使われたときなどに違いが出る。
"exclusive" に設定していると、
'virtualedit' が空のときノーマルモードか
ら選択を開始し、末尾から後方に選択すると行末の文字を含めることができな
くなる。
オプション
'selection' は、コマンド
|:behave| によって設定される。
*'selectmode'* *'slm'*
'selectmode' 'slm' 文字列 (既定では "")
グローバル
{Vi にはない}
値はキーワードのコンマ区切りのリストである。キーワードは領域選択が開始
されたときのうち、どの場合でVisualモードでなくSelectモードを開始するか
を決定する。
指定可能なキーワードは以下の通りである。
mouse マウス使用時
key シフトキーと特別なキーの同時押しをしたとき
cmd コマンド "v", "V" または
CTRL-V の使用時
|Select-mode| を参照。
オプション
'selectmode' はコマンド
|:behave| で設定される。
*'sessionoptions'* *'ssop'*
'sessionoptions' 'ssop' 文字列 (既定では "blank,buffers,curdir,folds,
help,options,tabpages,winsize")
グローバル
{Vi にはない}
{Vimが |+mksession| 機能付きでコンパイルされたときの
み有効}
コマンド
|:mksession| の効果を変更する。値はキーワードのコンマ区切りの
リストである。キーワードは、ある項目の保存と復元を有効にする。
キーワード 復元される項目
blank 空のウィンドウ
buffers ウィンドウに表示されたバッファだけでなく、隠れバッファ
と、リストに載っているだけで読み込まれていないバッファ
curdir カレントディレクトリ
folds 手動で作られた折り畳み、折り畳みの開閉の区別、折り畳み
関連のローカルなオプション
globals 大文字で始まり、最低1個の小文字を含む名前のグローバル
変数。文字列型と数値型の変数のみ保存される。
help ヘルプウィンドウ
localoptions ウィンドウまたはバッファに対してローカルなオプションと
マッピング (ローカルなオプションのグローバルな値ではな
い)
options 全てのオプションとマッピング (ローカルなオプションのグ
ローバルな値も)
resize Vimのウィンドウのサイズ:
'lines' と
'columns' の値
sesdir セッションファイルがおかれているディレクトリが、カレン
トディレクトリになる (ネットワーク越しに、異なったシス
テムからアクセスを受けるプロジェクトでは便利である)
slash ファイル名内の '\' がスラッシュに置換される
tabpages 全タブページ。これが含まれていないと、カレントタブペー
ジのみが復元される。そのため、タブページごとに別々のセッ
ションを保存することができる。
unix WindowsやDOS上でも、Unix形式の end-of-line (1個の
<NL>) を使う
winpos Vimのウィンドウ全体の位置
winsize ウィンドウサイズ
"curdir" と "sesdir" の両方を含めないこと。
"curdir" も "sesdir" も含まれていないときは、ファイル名は絶対パスで保
存される。
"slash" と "unix" は、Windows上でセッションファイルをUnixと共有すると
きに便利である。Unix版のVimはdos形式のスクリプトを読み込めないが、
Windows版のVimはunix形式のスクリプトを読み込めるからだ。
*'shell'* *'sh'* *E91*
'shell' 'sh' 文字列 (既定では $SHELL または "sh",
MS-DOSとWin32では: "command.com" または
"cmd.exe", OS/2では: "cmd")
グローバル
"!" や ":!" 等のコマンドで使うシェルの名前。この値を変えたときは、以下
のオプションも調べること:
'shelltype',
'shellpipe',
'shellslash',
'shellredir',
'shellquote',
'shellxquote',
'shellcmdflag'
コマンドには引数を与えることができる。例えば "csh -f" である。
値に空白や '\' を含める方法については、
|option-backslash| を参照。環境
変数は展開される
|:set_env|。
シェルの名前が空白を含むときは、それを引用符で挟む必要があるだろう。例:
Note 引用符にそれぞれ付けられた '\' (コメントの開始を防ぐため) と空白
にそれぞれ付けられた '\' (値の終わりと間違えないため) に注意。
Note また "-f" は引用符の中に入っていないことにも注意。それはコマンド
名の一部ではないからである。またVimはパスの区切りに使われている '\' を
自動的に認識する。
32ビットのDOS (DJGPP) では、環境変数 $DJSYSFLAGS を設定することで外部
コマンドの実行方法を変えられる。DJGPPのファイル libc.inf を参照。
MS-Windowsでは、実行ファイルの名前が ".com" で終わるときは ".com" まで
含めなければならない。つまりシェルを "command.com" や "4dos.com" に設
定すると正しく機能するが、"command" や "4dos" に設定すると、必ずしも全
てのコマンドに対しては動作しなくなる (例えばフィルタコマンド)。
理由は不明だが、"4dos.com" を使ったときはカレントディレクトリが "C:\"
に変更される。これを防ぐには
'shell' を次のようにすること。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'shellcmdflag'* *'shcf'*
'shellcmdflag' 'shcf' 文字列 (既定では: "-c"
MS-DOS と Win32 で
'shell' に "sh" にが含まれ
ないときは: "/c")
グローバル
{Vi にはない}
"!" や ":!" 等のコマンドを実行するためにシェルに渡されるフラグ。例えば、
"bash.exe -c ls" や "command.com /c dir" である。MS-DOS系のシステムで
は、ユーザが必ずこのオプションを設定しなくともよいように、既定値はオプ
ション
'shell' に従って設定される。OS/2では使われない (EMXは自分でこれ
を理解する)。
Unix では一つ以上のフラグを指定できます。空白で区切られた各部は shell
コマンドの引数として渡されます。
値に空白や '\' を含める方法については、
|option-backslash| を参照。
MS-DOS と MS-Windows については
|dos-shell| も参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'shellpipe'* *'sp'*
'shellpipe' 'sp' 文字列 (既定では ">", "| tee", "|& tee" または
"2>&1| tee")
グローバル
{Vi にはない}
{Vimが |+quickfix| 機能付きでコンパイルされたときのみ
有効}
コマンド ":make" の出力をエラーファイルに導くために使われる文字列。
|:make_makeprg|も参照。値に空白や '\' を含める方法については、
|option-backslash| を参照。
必要であれば、一時ファイルの名前は "%s" で参照できる (値に "%s" が1個
も含まれていなければ、一時ファイル名は自動的に追加される)。
AmigaとMS-DOSでの既定値は ">" である。出力はファイルに直接保存され、ス
クリーンには表示されない。
Unixでの既定値は "| tee" である。コンパイラからの標準出力がファイルに
保存され、画面にも表示される。初期化の後にオプション
'shell' が "csh"
か "tcsh" だったときは、既定値は "|& tee" である。
'shell' が "sh",
"ksh", "mksh", "pdksh", "zsh" または "bash" のときは、既定値は "2>&1|
tee" である。つまり標準エラー出力も含まれる。
'shell' オプションは、使
用される前にパスが削除される (例えば "/bin/sh" なら "sh" が使われる)。
このオプションの初期化は、ファイル ".vimrc" の読み込みと他の初期化の後
に行われる。これは
'shell' がその間に設定されていたときは、
'shellpipe'
を自動的に変更するためである。ただし
'shellpipe' がユーザ自らによって
設定されていたときは、自動設定は行われない。
'shellpipe' が空のときは、":make" の出力はリダイレクトされない。この設
定は
'makeprg' のプログラムが自分で
'makeef' に書き込んでくれるときに
便利である。パイプ処理はしたくないが
'makeef' を含みたいときには、
'shellpipe' を1個の空白に設定すること。空白の前には ":set sp=\ " のよ
うに '\' を置くことを忘れないこと。
将来はフィルタ処理にはパイプが使われるようになり、このオプションは時代
遅れになるだろう (少なくともUnixでは)。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'shellquote'* *'shq'*
'shellquote' 'shq' 文字列 (既定では ""; MS-DOSとWin32で
'shell' に
"sh" が含まれるなら "\"")
グローバル
{Vi にはない}
"!" や ":!" 等のコマンドでコマンドをシェルに渡すときに、コマンドを囲む
引用符(の列)。リダイレクトの指示は常に引用符の外側に置かれる。リダイレ
クトの指示を中に含めるには、オプション
'shellxquote' を参照。両方のオ
プションを設定するのは、おそらく良い方法ではない。
既定値は空である。MS-DOS系のシステムの、MKS Korn Shell や bash 等のサー
ドパーティ製のシェルに対してのみ便利である。それらのシェルでは引用符を
"\"" とするべきである。ユーザが必ずこのオプションを設定しなくともよい
ように、既定値は
'shell' に従って設定される。
|dos-shell| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'shellredir'* *'srr'*
'shellredir' 'srr' 文字列 (既定では ">", ">&" or ">%s 2>&1")
グローバル
{Vi にはない}
フィルタコマンドの出力を一時ファイルに導くために使われる文字列。
|:!|も
参照。値に空白や '\' を含める方法については、
|option-backslash| を参照。
必要であれば、一時ファイルの名前は "%s" で参照できる (このオプションの
値に "%s" が1個も含まれていなければ、一時ファイル名は自動的に追加され
る)。
既定値は ">" である。Unixでは、初期化の後にオプション
'shell' が
"csh", "tcsh" または "zsh" だったときは、既定値は ">&" になる。
'shell'
が "sh", "ksh" または "bash" だったときは、既定値は ">%s 2>&1" になる。
つまり標準エラー出力も含まれる。
Win32では、Unixと同様のチェックがなされ、加えて値が "cmd" であるかどう
か調べられる。そのときは既定値は ">%s 2>&1" になる。また ".exe" 付きの
シェル名も探す。
このオプションの初期化は、ファイル ".vimrc" の読み込みと他の初期化の後
に行われる。これは
'shell' がその間に設定されていたときは、
'shellredir' を自動的に変更するためである。ただし
'shellredir' がユー
ザ自らによって設定されていたときは、自動設定は行われない。
将来はフィルタ処理にはパイプが使われるようになり、このオプションは時代
遅れになるだろう (少なくともUnixでは)。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'shellslash'* *'ssl'* *'noshellslash'* *'nossl'*
'shellslash' 'ssl' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{VimのMSDOS, MS-Windows, OS/2版でのみ有効}
オンのときは、ファイル名の展開にスラッシュが使われる。これは
command.com や cmd.exe の代わりにUnix系のシェルを使うときに便利である。
'\' も入力できるが、Vimによってスラッシュに変換される。
Note このオプションをオンにしたりオフにしても、すでにVim内に読み込まれ
たファイル名には影響がないので、完全を期すためにはこのオプションはどの
ファイルを開くのよりも先に設定する必要があることに注意。この点は将来変
更になるかもしれない。
'shellslash' はパスの区切りとして '\' が使われるときだけ働く。これをテ
ストするには次のようにする:
*'shelltemp'* *'stmp'* *'noshelltemp'* *'nostmp'*
'shelltemp' 'stmp' 切替 (Vi の既定はオフ, Vim の既定はオン)
グローバル
{Vi にはない}
オンのときは、シェルコマンドに一時ファイルを使う。オフのときはパイプを
使う。オフであってもパイプが使えない場合は一時ファイルを使う。
現在のところパイプは Unix と MS-Windows 2K 以降でのみサポートされてい
る。これを確認するには次のようにする:
パイプを使うことの利点は、一時ファイルを他人に読み取られないことと、
'shell' のプログラムがリダイレクトをサポートしていなくてもよいことである。
一時ファイルを使うことの利点は、ファイルタイプとエンコーディングを判別
できることである。
'shelltemp' がオフのときは自動コマンドイベント
|FilterReadPre|,
|FilterReadPost|,
|FilterWritePre|,
|FilterWritePost| が発生しない。
*'shelltype'* *'st'*
'shelltype' 'st' 数値 (既定では 0)
グローバル
{Vi にはない} {VimのAmiga版のみ}
Amigaでは、このオプションはシェルを使うコマンドの実行方法に影響する。
0 または 1: 常にシェルを使う
2 または 3: 行のフィルタ処理にのみシェルを使う
4 または 5: コマンド ':sh' にのみシェルを使う
シェルを使わないときは、コマンドは直接実行される。
0 または 2: "シェル名
'shellcmdflag' コマンド" で外部コマンドを実行
1 または 3: "シェル名 コマンド" で外部コマンドを実行
*'shellxescape'* *'sxe'*
'shellxescape' 'sxe' 文字列 (既定では: ""
MS-DOS と MS-Windows: "\"&|<>()@^")
グローバル
{Vi にはない}
'shellxquote' が "(" に設定されているとき、このオプションで指定された
文字は '^' 文字でエスケープされる。これによって cmd.exe を使ってほとん
どの外部コマンドを実行できるようにする。
*'shellxquote'* *'sxq'*
'shellxquote' 'sxq' 文字列 (既定では "";
Win32 で
'shell' が cmd.exe なら: "("
Win32で
'shell' に "sh" が含まるなら: "\""
Unixで system() を使っているなら: "\"")
グローバル
{Vi にはない}
"!" や ":!" 等のコマンドでコマンドをシェルに渡すときに、コマンドを囲む
引用符(の列)。リダイレクトの指示もこの中に含む。リダイレクトの指示を含
めないようにするには、オプション
'shellquote' を参照。両方のオプション
を設定するのは、おそらく良い方法ではない。
値が '(' なら末尾に ')' が追加される。値が '"(' なら ')"' が追加され
る。
値が '(' のときの動作に付いては
'shellxescape' も参照。
ほとんどのシステムでは初期設定は空になる。このオプションは Win32 版で
cmd.exe やサードパーティーのシェルを使う場合に便利です。cmd.exe は自動
的にコマンドの最初と最後のクオート文字を取り除きます。MKS Korn Shell
や bash などのサードパーティー製のシェルを使う場合は設定値は "\"" とす
べきです。ユーザーがこのオプションを設定する必要がないように、初期設定
は
'shell' に適した値が設定される。
|dos-shell| を参照。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'shiftround'* *'sr'* *'noshiftround'* *'nosr'*
'shiftround' 'sr' 切替 (既定ではオフ)
グローバル
{Vi にはない}
インデントをオプション
'shiftwidth' の値の倍数に丸める。コマンド ">"
と "<" に適用される。Insertモードでの
CTRL-T と
CTRL-D では、インデン
トは常に
'shiftwidth' の倍数に丸められる (これはVi互換の動作である)。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意すること。
*'shiftwidth'* *'sw'*
'shiftwidth' 'sw' 数値 (既定では 8)
バッファについてローカル
(自動) インデントの各段階に使われる空白の数。オプション
'cindent', コ
マンド
|>>|,
|<<| 等に使われる。
(訳注:
'shiftwidth' は自動インデントや "<<", ">>" でずれる幅。
'softtabstop' はタブキーやバックスペースキーでカーソルが動く幅。
'tabstop' は画面上でタブ文字が占める幅)
*'shortmess'* *'shm'*
'shortmess' 'shm' 文字列 (Vimの既定値: "filnxtToO", Viの既定値: "",
POSIX の既定値: "A")
グローバル
{Vi にはない}
このオプションは、コマンド
CTRL-G 等によるファイル関連のメッセージで、
「継続」プロンプト
|hit-enter| を避けるのに役立つ。またその他のメッセー
ジを避けるのにも役立つ。
値は以下のフラグのリストである。
フラグ 効果
f "(file 3 of 5)" の代わりに "(3 of 5)" を表示。
i "[最終行が不完全]" の代わりに "[noeol]" を表示。
l "999 行, 888 文字" の代わりに "999L, 888C" を表示。
m "[変更あり]" の代わりに "[+]" を表示。
n "[新ファイル]" の代わりに "[新]" を表示。
r "[読込専用]" の代わりに "[読専]" を表示。
w 書き込みコマンドには "書込み" の代わりに "[w]" を、コマンド
':w >> file' には "追加" の代わりに "[a]" を表示。
x "[dosフォーマット]" の代わりに "[dos]", "[unixフォーマット]"
の代わりに "[unix]", "[マックフォーマット]" の代わりに
"[マック]" を表示。
a 上記の省略を全て行う。
o ファイルの書き込み時のメッセージを、その後のファイルの読み込み
時のメッセージで上書きする (":wn" を使うときやオプション
'autowrite' がオンのときに便利である)
O ファイルの読み込み時のメッセージや Quickfix 関係のメッセージ
(例えば ":cn") がその前のメッセージを必ず上書きする。
s 「下まで検索したので上に戻ります」と「上まで検索したので下に戻
ります」というメッセージを表示しない。
t ファイル間連のメッセージが長すぎてコマンドラインに収まらないと
きは、先頭を切り詰める。先頭には "<" が表示される。Exモードで
は無視される。
T その他ののメッセージが長すぎてコマンドラインに収まらないときは、
中央を切り詰める。中央には "..." が表示される。Exモードでは無
視される。
W ファイルの書き込み時に "書込み" や "[w]" を表示しない。
A スワップファイルがすでにあることが発見されたときに「注意」メッ
セージを表示しない。
I Vimの開始時に挨拶メッセージを表示しない
|:intro|。
このオプションはバッファを変更するとき
<Enter> を打ち込むのを避ける機
会を提供する。が、表示の余裕がある限り有益なメッセージを表示する。
'shm' が空のときと同じようにメッセージ全体を表示するには、コマンド
":file!" を使うこと。
便利な値の例:
shm= メッセージの省略なし
shm=a メッセージを省略するが内容までは省略しない
shm=at メッセージを省略し、必要があれば内容も切りつめる
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'shortname'* *'sn'* *'noshortname'* *'nosn'*
'shortname' 'sn' 切替 (既定ではオフ)
バッファについてローカル
{Vi とMS-DOS版のVimにはない}
ファイル名が8文字に3文字の拡張子を付けたものであると仮定する。ファイル
名には複数のドット '.' は使えない。オンならば、拡張子 (".~" または
".swp") を付けるときにはファイル名の中のドットは下線 '_' に置き換えら
れる。このオプションはMS-DOS版では無効である。なぜなら当然常にオンであ
るからだ。このオプションは、ファイルをMS-DOS互換のシステム (例えば
messydos や crossdos) 上で編集するときに便利である。Win32のGUI版を使っ
ているときは、このオプションは常に既定ではオンである (訳注: いや、オフ
だと思う)。
*'showbreak'* *'sbr'* *E595*
'showbreak' 'sbr' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+linebreak| 機能付きでコンパイルされたときの
み有効}
折り返された行の先頭に表示する文字列。"> " や "+++ " に設定すると便利
である:
スペースの前にバックスラッシュをつけてエスケープしていることに注
意。次のようにするともっと簡単である:
<Tab> 文字とコンマ以外の、printable な文字 (訳注: 文書先頭を参照) のみ
が指定できる (将来のヴァージョンでは、行末に表示される部分と行頭に表示
される部分の区切りにコンマが使われるかもしれない)。
この文字列は、オプション
'highlight' のフラグ'@' に従って強調表示される。
Note 'showbreak' の文字列の次にタブ文字が来たときは、表示方法が異なる
ので注意。
'showbreak' の文字列を行番号の間に表示したいときは、
'cpoptions' にフラ
グ "n" を加えること。
*'showcmd'* *'sc'* *'noshowcmd'* *'nosc'*
'showcmd' 'sc' 切替 (Vimの既定値: オン、Unixでの既定値: オフ、
Viの既定値: オフ)
グローバル
{Vi にはない}
{Vimが |+cmdline_info| 機能付きでコンパイルされたとき
のみ有効}
コマンド (の一部) を画面の最下行に表示する。ユーザのターミナルの表示が
遅いときにはオフにすること。
Visualモードでは、選択領域のサイズが以下のように表示される。
- 1行の中で選択しているときは、文字数を表示。
文字数とバイト数が違う場合はそれも表示される: 例えば "2-6" なら 2 文
字で 6 バイトという意味になる。
- 2行以上にわたって選択しているときは、行数を表示。
- 矩形選択のときは、画面上の文字数、つまり行数×列数を表示。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'showfulltag'* *'sft'* *'noshowfulltag'* *'nosft'*
'showfulltag' 'sft' 切替 (既定ではオフ)
グローバル
{Vi にはない}
Insertモードでタグファイルから単語補完をするとき (
|ins-completion| を
参照)、タグ名と整理された検索パターン (あれば) の両方をマッチする限り
表示する。そのため、C言語の関数にマッチすれば、どのような引数を必要と
するかのテンプレートを見ることができる (コーディングスタイルが適当なも
のであれば)。
Note:
'completeopt' に "longest" を含めている場合はこれを同時に使うこ
とはできない。検索パターンからの補完がタイプされたテキストにマッチしな
いことがあるからである。
*'showmatch'* *'sm'* *'noshowmatch'* *'nosm'*
'showmatch' 'sm' 切替 (既定ではオフ)
グローバル
閉じ括弧が入力されたとき、対応する開き括弧にわずかの間ジャンプする。マッ
チした括弧が画面上に見えているときのみジャンプする。マッチを表示する時
間はオプション
'matchtime' で設定できる。
マッチする閉じ括弧がないときは、ビープ音が鳴る (マッチが見えても見えな
くても)。このオプションは、
'paste' がオンのときはオフになる。
'cpoptions' にフラグ 'm' が含まれていないときは、ジャンプ中に文字を入
力するとカーソルがすぐに元の場所に戻る。
マッチの表示時のカーソルの形状や点滅方法については、
'guicursor' の
"sm" の項目を参照。
オプション
'matchpairs' によって対応する文字を指定することができる。対
応する括弧を探すときは
'rightleft' と
'revins' が適用される。
カーソル下の括弧に対応する括弧を強調させる方法については matchparen プ
ラグインを参照
|pi_paren.txt|。
Note: このオプションの省略形式の名前の使用には、保護者への説明が望まれ
るので注意(笑)
*'showmode'* *'smd'* *'noshowmode'* *'nosmd'*
'showmode' 'smd' 切替 (Vimの既定値: オン、Viの既定値: オフ)
グローバル
Insertモード、ReplaceモードまたはVisualモードで最終行にメッセージを表
示する。このメッセージの強調表示の設定には、オプション
'highlight' の
フラグ 'M' を使うこと。
|XIM| が使用可能なときは、メッセージに "XIM" が含まれる。しかしこれは
実際に XIM が起動しているということではない。特に
'imactivatekey' が設
定されていないときは注意。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'showtabline'* *'stal'*
'showtabline' 'stal' 数値 (既定では 1)
グローバル
{Vi にはない}
{Vimが |+windows| 機能付きでコンパイルされたときのみ
利用可能}
このオプションは、いつタブページのラベルを表示するかを指定する。
0: 表示しない
1: 2個以上のタブページがあるときのみ表示
2: 常に表示
これは GUI 版と非 GUI 版両方に適用される。
タブページについて詳しくは
|tab-page| を参照。
*'sidescroll'* *'ss'*
'sidescroll' 'ss' 数値 (既定では 0)
グローバル
{Vi にはない}
水平スクロールの刻み幅。オプション
'wrap' がオフでカーソルが画面外に出
るときのみ使われる。
値が 0 のときはカーソルを画面の中央に置くようにスクロールする。
遅いターミナルを使っているときは、大きい値または 0 に設定すること。速
いターミナルを使っているときは小さい値または 1 に設定すること。コマン
ド "zh" と "zl" には使われない。
*'sidescrolloff'* *'siso'*
'sidescrolloff' 'siso' 数値 (既定では 0)
グローバル
{Vi にはない}
オプション
'nowrap' がオフのとき、カーソルの右または左には、最低でもこ
の数だけの列が表示される。
'sidescroll' を 1 以上に設定しているときにこ
のオプションも 1 以上にすると、水平スクロールをしている周辺のテキスト
が見えるようになる (行頭の近くにいるとき以外)。とても大きい値 (999等)
にすると、カーソルの置かれた列は常にウィンドウの中央に表示される (行頭
の近くにいるとき以外)。
NOTE: このオプションは、オプション
'compatible' がオンのときは 0 にな
るので注意。
例: 次の例のように、このオプションを
'sidescroll' と
'listchars' と一
緒に設定し、カーソルを "extends" の文字の上に決して来ないようにし
てみる。
*'smartcase'* *'scs'* *'nosmartcase'* *'noscs'*
'smartcase' 'scs' 切替 (既定ではオフ)
グローバル
{Vi にはない}
検索パターンが大文字を含んでいたらオプション
'ignorecase' を上書きする。
検索パターンがキーボードから打ち込まれたときに
'ignorecase' がオンの場
合にのみ使われる。適用されるコマンドは "/", "?", "n", "
N", ":g", ":s"
である。"*", "#", "gd" やタグ検索などには適用されない。"*" や "#" の後
で "/" を使い、検索パターンの履歴を呼び出して
<Enter> を打ち込むことで、
'smartcase' の効果を適用することができる。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'smartindent'* *'si'* *'nosmartindent'* *'nosi'*
'smartindent' 'si' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
{Vimが |+smartindent| 機能付きでコンパイルされたとき
のみ有効}
新しい行を作ったときに高度な自動インデント smart autoindenting を行う。
C言語系のプログラミング言語で有効だが、他のプログラミング言語にも使え
る。オプション
'cindent' でも似たことができ、より多くの場面で適切に動
作するが、
'cindent' の方がこちらより厳密である。
|C-indenting| を参照。
'cindent' か
'indentexpr' がオンのときは
'si' をオンにしても効果はな
い。
'indentexpr' を使うとさらに高度な動作が実現できる。
'smartindent' を使うときは、
'autoindent' もオンに設定するべきである。
インデントは、以下のときに自動的に挿入される。
- '{' で終わる行で新しい行を作ったとき。
-
'cinwords' 内のキーワードで始まる行の次に新しい行を作ったとき。
- '}' で始まる行の上に新しい行を作ったとき (コマンド "O" のみ)。
新しい行の先頭に '}' を入力すると、そこのインデントは対応する '{' と等
しくなる。
新しく作った行の最初の文字が '#' のとき、その行のインデントは取り除か
れ、'#' は最前列に置かれる。次の行のインデントは '#' の行の前と同じに
なる。こうしてほしくないなら、次のマッピングを使うこと。
":inoremap # X^H#"
ここで ^H は
CTRL-V CTRL-H と打ち込むと入力される。
コマンド ">>" を使ったとき、'#' で始まる行は右に移動しない。
NOTE:
'smartindent' は、
'compatible' がオンのときはオフに設定されるの
で注意。また
'paste' がオンのときは高度なインデントは使えないことも注意。
*'smarttab'* *'sta'* *'nosmarttab'* *'nosta'*
'smarttab' 'sta' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンのときは、行頭の余白内で
<Tab> を打ち込むと、
'shiftwidth' の数だけ
空白が挿入される。他の場所では
'tabstop' または
'softtabstop' の数だけ
空白が挿入される。
<BS> を使うと行頭の
'shiftwidth' 分のスペースを削除
する。
オフのときは、
<Tab> を打ち込むと常に
'tabstop' または
'softtabstop' の
数だけ空白が挿入される。
'shiftwidth' はテキストを右左にずらすときのみ
使われる
|shift-left-right|。
挿入される文字 (タブ文字または空白) は
'expandtab' によって変わる。
|ins-expandtab| も参照。
'expandtab' がオフのときは、
<Tab> を打ち込む
と空白の数が最小になる (訳注: できる限り空白をタブ文字で置き換える)。
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'softtabstop'* *'sts'*
'softtabstop' 'sts' 数値 (既定では 0)
バッファについてローカル
{Vi にはない}
<Tab> の挿入や
<BS> の使用等の編集操作をするときに、
<Tab> が対応する空
白の数。(訳注: このオプションの長さの)
<Tab> が挿入される「ように思え
る」が、実は空白と
<Tab> の両方が混ざって使われている。このオプション
は、
'tabstop' を標準の 8 に設定したまま、それが
'softtabstop' の値に設
定されているかのように編集作業をしたいときに便利である。しかしコマンド
"x" 等は実際の文字に対して動作する。
このオプションが 0 になると、この機能は無効になる (訳注: 一番分かりや
すい違いは、
<BS> を打ち込んだときにどんな文字も1文字ずつ消えていく)。
このオプションは、
'paste' がオンのときは 0 になる。
|ins-expandtab| も参照。
'expandtab' がオフのときは、
<Tab> を打ち込むと
空白の数が最小になる (訳注: できる限り空白をタブ文字で置き換える)。
'cpoptions' にフラグ 'L' を含めると、
'list' がオンのとき、タブの扱い方
が変わる。
NOTE: このオプションは、オプション
'compatible' がオンのときは 0 にな
るので注意。
(訳注:
'shiftwidth' は自動インデントやコマンド "<<", ">>" でずれる幅。
'softtabstop' は
<Tab> や
<BS> を打ち込んだときにカーソルが動く幅。
'tabstop' は画面上でタブ文字が占める幅の設定)
*'spell'* *'nospell'*
'spell' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ利
用可能}
これがオンのときはスペルチェックが行われる。
|spell| を参照。
その言語は
'spelllang' で指定する。
*'spellcapcheck'* *'spc'*
'spellcapcheck' 'spc' 文字列 (既定では "[.?!]\_[\])'" \t]\+")
バッファについてローカル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ利
用可能}
文の末尾を見つけるのに使うパターン。その次の単語が大文字で始まるかどう
かチェックされる。大文字でなければ、その単語が SpellCap
|hl-SpellCap|
で強調される (その単語がスペリングミスともみなされていなければ)。
このチェックを行いたくなければ、このオプションを空にすること。
'spell' がオンのときだけ適用される。
特殊な文字について注意すること。スペースとバックスラッシュを含める方法
については
|option-backslash| を参照。
言語に応じて自動的にこのオプションをオンにする方法については
|set-spc-auto| を参照。
*'spellfile'* *'spf'*
'spellfile' 'spf' 文字列 (既定では空)
バッファについてローカル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ利
用可能}
コマンド
|zg|,
|zw| で単語を追加するための単語リストファイルの名前。こ
のファイル名の末尾は ".
{encoding}.add" でなければならない。ここにパス
を含める必要がある。そうしないと、カレントディレクトリにそのファイルが
作られる。
*E765*
このオプションの値はファイル名のコンマ区切りのリストであってもよい。
コマンド
|zg| と
|zw| に与えるカウントによって、そのリストのどれにアク
セスするかを指定することができる。これによって、個人用の単語リストファ
イルとプロジェクト用の単語リストファイルを使い分けることができる。
このオプションが空なのに単語が追加されたときは、Vim が自動的に値を設定
する: 書き込み可能な最初の
'runtimepath' のディレクトリを使用する。そ
こに "spell" というディレクトリがなければ作成する。ファイル名には
'spelllang' に現れる最初の言語名が使われ、地域名は無視される。
そうして作られる ".spl" ファイルがスペルチェックに作られる。このファイ
ルは
'spelllang' に入っていなくてもよい。
普通は全ての地域に対して1つのファイルが使われるが、望むなら地域名を追
加することもできる。しかしその場合、
'spellfile' がそのファイル名に設定
されているときだけ使われる。
'spelllang' のエントリに対しては地域名を省
いたファイルだけが使われる。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'spelllang'* *'spl'*
'spelllang' 'spl' 文字列 (既定では "en")
バッファについてローカル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ利
用可能}
コンマ区切りの単語リスト名のリスト。オプション
'spell' がオンのとき、
これらの言語に対してスペルチェックが行われる。例:
こうすると US 英語、オランダ語、医学用語が認識される。認識されない単語
は強調される。
単語リスト名はコンマやドットを含んではならない。2文字の言語名と詳細を
区切るのにダッシュを使うことが推奨される。つまり、"en-rare" は頻度の低
い(rare)英語となる。
地域名は最後に書いて、"_xx" という形でなければならない。ここで "xx" は
小文字で2文字の地域名である。複数の地域名を列挙することもできる:
"en_us, en_ca" とすると US 英語とカナダ英語の両方に対応する。しかし
オーストラリア、ニュージーランド、英国に固有の単語には対応しない。
*E757*
特別な場合として、.spl ファイルの名前をそのまま指定することができる。
その名前の最初の "_xx" は除去され、地域名として使われる (_xx はアン
ダースコア、2文字、そしてその後にアルファベットでないものが続くことを
意味する)。これは主にテスト用のためである。正しいエンコーディングが使
われているかどうか Vim はチェックしないので、ユーザが確認しなければな
らない。
'encoding' が設定されると、単語リストは再読み込みされる。そのため、2度
読み込むのを避けるため、
'encoding' の後で
'spelllang' を設定するとよい。
関係するスペルファイルがどう探されるかについてはここで説明されている:
|spell-load|.
プラグイン
|spellfile.vim| が動作しているならば、
'runtimepath'に.splファ
イルが見つからない言語名が指定されたとき、このプラグインによりユーザに
対してファイルをダウンロードするかどうか問い合わせが行われる。
このオプションの設定が成功すると、
'runtimepath' の"spell/LANG.vim" が
読み込まれる。"LANG" は
'spelllang' の値の最初のコンマ、ドット、アンダー
スコアまでの部分である。
|set-spc-auto| を参照。
*'spellsuggest'* *'sps'*
'spellsuggest' 'sps' 文字列 (既定では "best")
グローバル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ利
用可能}
スペリング候補の方法を指定する。コマンド
|z=| と関数
|spellsuggest()|
の両方に適用される。次の要素のコンマ区切りのリストになる:
best 英語にもっともよく対応している内部メソッド。「高速に」
似た相異点を発見し、音の近さによるスコア判定を少しして
順序を改善する。
double 2つの方法を用い、その結果を混合させる内部メソッド。第
一の方法は「高速」で、第二の方法は候補と修正対象の音が
どれだけ似ているかを計算する。これは言語が sound
folding を指定するときだけ機能する。時間がかかるかもし
れず、必ずしもよい結果を出すとは限らない。
fast 文字の挿入、削除、交換など、単純な相異だけを判定する内
部メソッド。単純なタイプミスに対してよく機能する。
{number} |z=| でリストされる候補の最大数。
|spellsuggest()| には
適用されない。候補の数は決して
'lines' の値 - 2 を超え
ない。
file:{filename}
{filename} を読み込む。そのファイルにはスラッシュで
区切られた2つの列が書いていなければならない。第1列に間
違った単語が書かれ、第2列に候補となる正しい単語が書か
れている。
例:
theribal/terrible
内部メソッドでは候補リストの上の方には出てこない、あり
がちなミスのためにこれを使う。スラッシュを含まない行は
無視されるのでコメントとすることができる。
このファイルは全ての言語に対して使われる。
expr:
{expr} 式
{expr} を評価する。スペースによるトラブルを避けるた
め、関数を使うこと。
|v:val| が間違ってつづられた単語を
保持する。この式を評価した結果が候補とスコアからなるリ
ストのリストにならなければならない。
例:
[[
'the', 33], [
'that', 44]]
'verbose' をオンにして
|z=| を使うと内部メソッドが使う
スコアを見ることができる。スコアは低いほどよい。
一時的に
'spellsuggest' から "expr:" の部分を除くなら
ば
|spellsuggest()| を呼び出してもよい。
オプション
'verbose' が非0になっていない限り、エラーは
警告無しに無視される。
"best", "double", "fast" は、どれか1つだけ指定できる。他のものはどんな
順序で何回指定してもよい。例:
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'splitbelow'* *'sb'* *'nosplitbelow'* *'nosb'*
'splitbelow' 'sb' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+windows| 機能付きでコンパイルされたときのみ
有効}
オンのとき、ウィンドウを横分割すると新しいウィンドウはカレントウィンド
ウの下に開かれる
|:split|。
*'splitright'* *'spr'* *'nosplitright'* *'nospr'*
'splitright' 'spr' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+vertsplit| 機能付きでコンパイルされたときの
み有効}
オンのとき、ウィンドウを縦分割すると新しいウィンドウはカレントウィンド
ウの右に開かれる
|:vsplit|。
*'startofline'* *'sol'* *'nostartofline'* *'nosol'*
'startofline' 'sol' 切替 (既定ではオン)
グローバル
{Vi にはない}
オンのときは、以下のコマンドで移動すると、カーソルは行内の最初の非空白
文字に移動する。オフのときは、カーソルは (可能ならば) 同じ列に置かれる。
適用されるコマンド:
CTRL-D,
CTRL-U,
CTRL-B,
CTRL-F, "G", "H", "M",
"L", gg, 行単位で行うときの "d", "<<", ">>", カウントを指定したときの
"%"、バッファ変更コマンド (
CTRL-^, :bnext, :bNext 等)、行番号のみのEx
コマンド (例えば ":25" や ":+")。
バッファ変更コマンドの場合は、カーソルはそのバッファが最後に編集された
ときの列に置かれる。
NOTE: このオプションは、オプション
'compatible' がオンのときはオンにな
るので注意。
(訳注: 実際の動作はドキュメントとかなり違う。移動先が1列目の場合と余白
以外の最初の文字の場合が混在している。ただ、オンのときはカーソルが元い
た列を無視して先頭の「方に」移動するのは確か)
*'statusline'* *'stl'* *E540* *E542*
'statusline' 'stl' 文字列 (既定では空)
グローバルまたは
ウィンドウについてローカル
|global-local|
{Vi にはない}
{Vimが |+statusline| 機能付きでコンパイルされたときの
み有効}
値が空でないとき、このオプションはステータス行の表示内容を設定する。
|status-line| も参照。
値は、普通のテキストに挟まれた関数 printf 形式の項目からなる。項目の形
式は以下の通りである。
%-0
{minwid}.
{maxwid}{item}
{item} 以外の欄は指定しなくてもよい。パーセント記号そのものを表示する
には "%%" とする。80個までの項目を指定できる。
*E541*
このオプションの先頭が "%!" である場合は式とみなされ、評価した結果がオ
プションの値となる。例:
この結果が %{} を含んでいると、それも評価される。
オプションを評価している間にエラーが発生すると、それ以降のエラーを避け
るためにオプションに空が設定される。そうしないと画面更新がループに陥っ
てしまう。
Note このオプションが設定されているとき (さらにオプション
'laststatus'
が 2 であるとき) は、
'ruler' にはコマンド
|CTRL-G| の出力を設定する効
果しかないことに注意。
欄 意味
- その項目を左寄せする。minwid が項目の長さより大きい場合は、
既定では右寄せになる。
0 数値の頭に0を表示する。欄 '-' が優先する。
minwid 項目の長さの最小値。余白の穴埋めは '-' と '0' で設定する。
50以下でなければならない。
maxwid 項目の長さの最大値。文字列の項目の切り詰めでは '<' が左に
表示される。数値の項目は maxwid-2 文字に切り詰められ、それ
に ">数" が続く。ここで "数" は表示されなかった文字数であ
り、指数表記に似ている。
item 以下で説明するアルファベット1文字。
以下は、指定可能なステータス行の item の説明である。"item" の2文字目は
その item の種類を表す。
N 数値
S 文字列
F 以下で説明するフラグ
- 実際に表示されるものではない
item 意味
f S バッファ内のファイルのパス(入力された通り、またはカレントディレ
クトリに対する相対パス)
F S バッファ内のファイルのフルパス。
t S バッファ内のファイルのファイル名 (パスを除く)。
m F 修正フラグ。表示されるのは "[+]"。
'modifiable' がオフのときは
"[-]"
M F 修正フラグ。表示されるのは ",+" または ",-"。
r F 読み込み専用フラグ。表示されるのは "[RO]"。
R F 読み込み専用フラグ。表示されるのは ",RO"。
h F ヘルプバッファフラグ。表示されるのは "[ヘルプ]"。
H F ヘルプバッファフラグ。表示されるのは ",HLP"。
w F プレビューウィンドウフラグ。表示されるのは "[プレビュー]"。
W F プレビューウィンドウフラグ。表示されるのは ",PRV"。
y F バッファ内のファイルのタイプ。例えば "[vim]"。
'filetype' を参照。
Y F バッファ内のファイルのタイプ。例えば ",VIM"。
'filetype' を参照。
{Vimが |+autocmd| 機能付きでコンパイルされたときのみ有効}
q S "[Quickfix List]"、"[Location List]" または空文字。
k S 他言語用マッピング
|:lmap| が使われているとき、変数
"b:keymap_name" または
'keymap' を "
<keymap>" と表示する。
n
N バッファ番号。
b
N カーソル下の文字の文字コードの10進数表現。
B
N 同上、ただし16進数表現。
o
N カーソル下の文字がファイル内で何バイト目であるか。先頭では1。
覚え方: ファイル先頭からの隔たり (に1を足したもの)
{Vimが |+byte_offset| 機能付きでコンパイルされたときのみ有効}
O
N 同上、ただし16進数表現。
N N 印刷時のページ番号 (
'printheader' 内でのみ有効)。
l
N 何行目にカーソルがあるか。
L
N バッファ内の総行数。
c
N 何列目にカーソルがあるか。
v
N 画面上の何列目にカーソルがあるか。
V
N 画面上の何列目にカーソルがあるか。表示形式は -
{num}。値が 'c' と
等しければ表示されない。
p
N 現在行がファイル内の何％の位置にあるか (
|CTRL-G| と同様)
P S 現在表示されているウィンドウ内のテキストが、ファイル内の何％の位
置にあるか。これは
'ruler' で説明されているものに似ている。値は
常に3文字である (訳注: 日本語版では全角2文字になりうる)。
a S 既定のタイトルと同様の引数ファイルリストを
"(
{current} of
{max})" と表示する。ファイル引数の数が0または1の
ときは空。
{ NF '%{' と '}' の間の expression を評価し、結果に置き換える。
閉じ括弧 '}' の前には '%' がつかないことに注意。
( - 項目グループの開始。グループ内の項目全てに対する幅と寄せ方の設定
に使える。どこかで %) で閉じられなければならない。
) - 項目グループの終了。欄 width は指定できない。
T
N 'tabline' 用: ラベル「タブページ
N」の開始。最後のラベルの後に
%T を書くこと。この情報はマウスクリックに使われる。
X
N 'tabline' 用: ラベル「タブ
N を閉じる」の開始。ラベルの後に %X
を書くこと。例: %3Xclose%X。%999X は「カレントタブを閉じる」を
意味する。この情報はマウスクリックに使われる。
< - 行が長すぎるときに切り詰める位置。既定では先頭。欄 width は指定
できない。
= - 左寄せ項目と右寄せ項目の区切り。欄 width は指定できない。
# - 強調グループを設定する。この後に名前を書き、その後にまた # を書く。
つまり、%#HLname# と書くと、強調グループ HLname になる。カレン
トウィンドウ以外のステータスラインに対しても同じ強調が施される。
* - 使われる強調表示グループを User
{N} に設定する。ここで
{N} は欄
minwid から取られる。例えば %1* と設定する。%* や %0* で通常の強
調表示を復元する。強調表示グループ User
{N} と StatusLine の違い
は、非カレントウィンドウのステータス行の強調表示を設定するグルー
プの StatusLineNC に適用される。数
N は 1 以上 9 以下である。
|hl-User1..9| を参照。
フラグを表示するとき、そのフラグがプレインテキストの直後にあるな
ら、その先頭にカンマがある場合は削除される。そうすることによって以下の
例のようなフラグの使い方をしたとき、きれいに表示されるようになっている。
あるグループ内の全ての項目が空文字列 (つまり設定されていないフラグ) に
なり、かつそのグループに minwid が指定されていなかったときは、グループ
全体が空になる。これにより、次のようなグループは、フラグがどれも設定さ
れていないときは全く表示されない。
気を付けてほしいのは、expression はステータス行が表示されるたびに評価
されるということだ。あるバッファまたはウィンドウのステータス行が描画さ
れている最中は、一時的にそのバッファまたはウィンドウがカレントバッファ
またはカレントウィンドウに設定され、そこで expression が評価される。変
数 "actual_curbuf" は、本当のカレントバッファで関数 'bufnr()' が返す値
に設定される。
オプション
'statusline' は
|sandbox| の中でも評価することができる。
|sandbox-option| を参照。
'statusline' を評価している間にテキストを変更したり他のウィンドウにジャ
ンプすることは許されていない
|textlock|。
ステータス行が望みの時点 (例えば expression 内で使われる変数の設定をし
た後) で更新されていないときは、オプションを値を変えずに設定し直すこと
で更新させることができる。例:
全て数字で返された結果は、表示用の数値と見なされる。それ以外の結果はフ
ラグ列と解釈され、上記の方法が適用される。
ステータス行で expression を使うときはエラーに気を付けること。Vimの描
画機構が使い物にならなくなるかもしれない！行き詰まってしまったならば、
プロンプトを表示させるために ':' か 'Q' を打ち込む。そしてVimを終了し
たら "vim -u NONE" として (訳注: エラーを起こす設定を読み込まないよう
にして) ユーザのファイル .vimrc か何かを編集し、正常に戻す。
例:
'ruler' がオンのときの標準のステータス行に似せる
同上、しかしカーソル下の文字の10/16進表現を表示する ("ga" のように)
カーソルが置かれているバイト数、カーソル下の文字のコード、修正フラグを
赤で表示
圧縮ファイルが読み込まれたとき、フラグ ,GZ を表示するには次のようにす
る。まず
として、さらに (訳注: 自動解凍を行う役割の)
|:autocmd| 内で
および
を設定し、最後に次の関数を定義する。
*'suffixes'* *'su'*
'suffixes' 'su' 文字列 (既定では ".bak,~,.o,.h,.info,.swp,.obj")
グローバル
{Vi にはない}
この拡張子を持つファイルは、ワイルドカードに複数のファイルがマッチした
ときの優先度が低くなる。
|suffixes| を参照。拡張子はコンマで区切って指
定する。コンマの後の空白は無視される。またドットは拡張子の始まりと見な
される。ドットやコンマが区切りと見なされないようにするには、前に '\'
を置くこと。値に空白や '\' を含める方法については、
|option-backslash|
を参照。
ファイルを完全に無視するには、オプション
'wildignore' を参照。
リストに拡張子を追加するときにはコマンド
|:set+=|、リストから拡張子を
除くときには
|:set-=| を使うのがよい。こうすると将来のヴァージョンで異
なった既定値が使われるようになったときに、問題が起きるのを防げる。
*'suffixesadd'* *'sua'*
'suffixesadd' 'sua' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+file_in_path| 機能付きでコンパイルされたとき
のみ有効}
値は拡張子のコンマ区切りのリスト。その拡張子は "gf", "[I" 等のコマンド
で検索されるファイルのものである。例:
*'swapfile'* *'swf'* *'noswapfile'* *'noswf'*
'swapfile' 'swf' 切替 (既定ではオン)
バッファについてローカル
{Vi にはない}
バッファでスワップファイルを使用する。このオプションは、特定のバッファ
でスワップファイルを使いたくないときにはオフに設定できる。例えば root
ユーザさえもアクセスしてはならない機密情報等でオフにする。
注意: テキストは全てメモリ内に格納される。
- この手段は大きいファイルに使わないこと。
- クラッシュからの回復ができなくなる！
スワップファイルが作られるのはオプション
'updatecount' が非0 で、
'swapfile' がオンのときだけである。
'swapfile' がオフになったときは、カレントバッファのスワップファイルは
すぐに削除される。
'swapfile' がオンで、
'updatecount' が非0 のときは、
スワップファイルはすぐに作られる。
|swap-file| と
'swapsync' も参照。
このオプションは、
'bufhidden' と
'buftype' と共に、特別な種類のバッファ
を指定するのに使われる。
|special-buffers| を参照。
*'swapsync'* *'sws'*
'swapsync' 'sws' 文字列 (既定では "fsync")
グローバル
{Vi にはない}
値が空でないときは、書き込みの後にディスク上のスワップファイルの内容が
同調される。これにはいくらか時間がかかる。ビジー状態のUnixシステムでは
特にそうだ。
値が空のときは、スワップファイルの一部はメモリ内のままで、ディスクに書
き込まれないかもしれない。システムがクラッシュすると、仕事の成果が余計
ひどく失われるかもしれない。
Unixでは、Vimが求めなくとも時折システムが同調を行うので、これを空にす
ることの不利益は小さい。システムによってはスワップファイルは全く書き込
まれない。Unixシステムでは、値を "sync" にすると既定の関数 fsync() で
はなく関数 sync() を呼び出すが、システムによってはそちらの方がよい。
実ファイルに対してはオプション
'fsync' が適用される。
*'switchbuf'* *'swb'*
'switchbuf' 'swb' 文字列 (既定では "")
グローバル
{Vi にはない}
バッファを切り替えるときの動作を調節する。
指定可能なキーワードは以下の通りである (コンマ区切りのリストにする)。
useopen これが含まれたときは、指定されたバッファを開いているウィ
ンドウがあれば、そこにジャンプする。含まれないときは、
他のウィンドウを調べない。
この設定は
|quickfix| 関係のコマンドでエラーにジャンプ
するとき (":cc", ":cn", "cp" 等で) に影響する。また
":sbuffer", ":sbnext", ":sbrewind" 等のバッファ関係の
ウィンドウ分割コマンド全てにも影響する。
usetab "useopen"と同様だが、他のタブページで開かれているウィ
ンドウも考慮する。
split これが含まれていると、
|quickfix| コマンドでエラーを表
示するときに、バッファを読み込む前にカレントウィンドウ
を分割する。
含まれていないときは、分割はされない。カレントウィンド
ウが使われる。
newtab "split" と同様だが、新しいタブページを開く。"split" と
両方指定された場合はこちらが優先される。
*'synmaxcol'* *'smc'*
'synmaxcol' 'smc' 数値 (既定では 3000)
バッファについてローカル
{Vi にはない}
{Vimが|+syntax|機能付きでコンパイルされたときのみ有効}
構文アイテムを検索する桁数の最大値。長い行において、この桁以降のテキス
トは強調されない。また構文の状態がクリアされるため、これ以下の行は正し
く強調されない可能性がある。
これは長い行を持つXMLファイルの描画が非常に遅くなるのを避けるために役
に立つ。
ゼロにするとその制限がなくなる。
*'syntax'* *'syn'*
'syntax' 'syn' 文字列 (既定では "")
バッファについてローカル
{Vi にはない}
{Vimが |+syntax| 機能付きでコンパイルされたときのみ有
効}
このオプションが設定されたとき、コマンド ":syntax off" で構文強調表示
が無効にされていない限り、値の名前の構文定義が読み込まれる。
このオプションは、その時点以外では使われている構文定義を常に反映する訳
ではない (常に反映するのは変数 b:current_syntax)。
このオプションは、構文が自動的に認識されないファイルのモードラインで使
うのが最も便利である。例えば、IDLファイルでは次のようにする。
/* vim: set syntax=idl : */
このオプションの値にドットを含めると、ファイルタイプの区切りとなる。
例:
/* vim: set syntax=c.doxygen : */
こうするとまず最初に"c"の構文を使い、次に"doxygen"の構文を使うようにな
る。2番目のファイルタイプは追加として読み込まれるように準備されていな
ければならない。そうでないとスキップされる。ドットは1つ以上現れてもよ
い。カレントファイルに対する構文強調表示を無効にするにはこうする。
オプション
'filetype' に従って、構文強調表示を開始するにはこうする。
'syntax' の設定時に実際起きることは、autocommand のイベント Syntax が、
このオプションの値を引数にして発生するということだ。
'cpoptions' のフラグ 's' や 'S' に関わらず、このオプションの値は別のバッ
ファにはコピーされない。
通常のファイル名文字だけが使える。"/\*?[|<>"は不正である。
*'tabline'* *'tal'*
'tabline' 'tal' 文字列 (既定では"")
グローバル
{Vi にはない}
{Vimが|+windows|機能付きでコンパイルされたときのみ有
効}
このオプションが空でないとき、Vimウィンドウの上にあるタブページ行の表
示内容を指定する。空のときは、既定のタブページ行が使われる。より詳しく
は
|setting-tabline|を参照。
タブページ行はオプション
'showtabline'で指定されたとき、またGUIのタブ行
がないときだけ表示される。
'guioptions'に'e'が入っていて、GUIがタブ行に
対応しているときは代わりに
'guitablabel'が使われる。
Note: この二つのタ
ブページ行はかなり異なる。
このオプションの値は
'statusline'と同じように評価される。
|tabpagenr()|,
|tabpagewinnr()|,
|tabpagebuflist()|を使えば表示されるテキストを把握す
ることができる。1番目のラベルには"%1T"、2番目のラベルには"%2T"など。閉
じラベルにはアイテム"%X"を使う。
アクティブなタブページは1つだけである。他のタブページは表示されず、そ
の中のウィンドウにジャンプすることはできない。
*'tabpagemax'* *'tpm'*
'tabpagemax' 'tpm' 数値 (既定では 10)
グローバル
{Vi にはない}
{Vimが|+windows|機能付きでコンパイルされたときのみ有
効}
コマンドライン引数
|-p|や":tab all"で開かれるタブページの最大数。
|tabpage|
*'tabstop'* *'ts'*
'tabstop' 'ts' 数値 (既定では 8)
バッファについてローカル
ファイル内の
<Tab> が対応する空白の数。コマンド
|:retab| とオプション
'softtabstop' も参照 (訳注: このオプション説明の最後も参照)。
Note:
'tabstop' を 8 以外の数に設定すると、多くの場合で (例えば印刷時)
ユーザのファイルが間違って表示されうるので注意。
Vimでは、タブの主な使い方には以下の4種類がある。
1.
'tabstop' を常に 8 に保ち、
'softtabstop' と
'shiftwidth' を 4 (また
は 3 等の好きな値) に設定し、
'expandtab' をオフにする。するとVimは
タブと空白の両方を使うが、
<Tab> と
<BS> を打ち込むと、タブが 4 (ま
たは 3) 文字ごとに現れているかのように表示される。
2.
'tabstop' と
'shiftwidth' を好きなように設定し、
'expandtab' をオン
にする。この方法では常に空白が挿入される。
'tabstop' が変更されても、
整形されたテキストはめちゃめちゃにならない。
3.
'tabstop' と
'shiftwidth' を好きなように設定し、再びファイルを編集
するときにはモードライン
|modeline| でこれらを設定する。ファイルの
編集にVimを使うときのみ有効。
4. 常に
'tabstop' と
'shiftwidth' を等しく設定し、
'expandtab' をオフに
する。すると (1回目のインデントのみだが) どのタブ幅でもうまく働く。
こうするにしても、余白より後の最初の文字より後にタブ文字を挿入する
ときは、空白文字として挿入されるようにするとよいだろう。そうしない
と、
'tabstop' が変更されたときに、整形されたコメントの形がおかしく
なる。
(訳注:
'shiftwidth' は自動インデントやコマンド "<<", ">>" でずれる幅。
'softtabstop' は
<Tab> や
<BS> を打ち込んだときにカーソルが動く幅。
'tabstop' は画面上でタブ文字が占める幅の設定)
*'tagbsearch'* *'tbs'* *'notagbsearch'* *'notbs'*
'tagbsearch' 'tbs' 切替 (既定ではオン)
グローバル
{Vi にはない}
タグを検索するとき (例えば
|:ta| コマンド)、Vim は tags ファイル内で二
分探索か線形探索のどちらかを使用する。二分探索はタグの検索が「大幅に」
速くなるが、タグファイルが適切に整列されていないときには線形探索の方が
より多くのタグを発見できる。
Vim は普通はタグファイルが整列されているか、整列されていないことが明示
されているものと想定している。そうなっていない場合は
'tagbsearch' オプ
ションをオフに設定する必要がある。
'tagbsearch' がオンのときは、最初に tags ファイル内で二分探索が使われ
る。特定の状況下では、Vim は特定のファイルに対しては線形探索を使った
り、全てのファイルを線形探索で再試行したりする。
'tagbsearch' がオフの
ときは線形探索のみが使われる。
タグファイルの先頭に、それが整列されていないことを示す行があったとき
は、そのファイルでは線形探索が使われる。
['0' の前後の余白は、単一の
<Tab> でなければならない]
二分探索が完了し、
'tags' で列挙されたどのファイルからもマッチが見つか
らなかった場合、
'ignorecase' がオンであるか、もしくはその検索がタグ名
による検索ではなくパターンによる検索であれば、線形探索を使って検索が再
試行される。
整列されていないタグファイル内のタグや、大文字と小文字の違いのあるマッ
チは、再試行でのみ見つかるだろう。
タグファイルが大文字・小文字を無視して整列されていることを示しているな
ら、
'ignorecase' のための線形探索はしなくてもよくなる。それには
"!_TAG_FILE_SORTED" 行の値として '2' を使う。ほとんどの Unix では
"sort" にオプション -f をつけることで大文字・小文字を無視してタグファ
イルを整列することができる。そのコマンドは次のようになる: "sort -f -o
tags tags"。"Exuberant ctags" のバージョン 5.x 以降 (少なくとも 5.5 以
降) ではオプション --sort=foldcase をつけることでこれと同様のことがで
きる。
Note: これが機能するために文字は大文字にまとめられる。
'tagbsearch' がオフの場合、完全なマッチがあるときはタグの検索はより遅
くなるが、完全なマッチがないときは検索はより速くなる。整列されていない
タグファイル内のタグは
'tagbsearch' がオフでないと見つからないかもしれ
ない。
タグファイルが整列されていない、あるいは間違った順に整列されている
(ASCII コード順になっていない) ときは、
'tagbsearch' をオフにするべきで
ある。またはタグファイル内に上記の行が含まれていなければならない。
このオプションは、マッチするすべてのタグを検索するようなコマンド (例え
ばコマンドライン補完や ":help") には影響しない。
{Vi: ヴァージョンによっては常に二分探索を使う}
*'taglength'* *'tl'*
'taglength' 'tl' 数値 (既定では 0)
グローバル
非0 のときは、タグ名のうち、前からこの値の文字数までが意味を持つ。
*'tagrelative'* *'tr'* *'notagrelative'* *'notr'*
'tagrelative' 'tr' 切替 (Vimの既定値: オン、Viの既定値: オフ)
グローバル
{Vi にはない}
オンのとき、タグファイルを別のディレクトリから使うと、そのタグファイル
でのタグ名は、タグファイルのあるディレクトリに対して相対的になる。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'tags'* *'tag'* *E433*
'tags' 'tag' 文字列 (既定では "./tags,tags",
|+emacs_tags| 機能付きでコンパイルされたとき
の既定値: "./tags,./TAGS,tags,TAGS")
グローバル／バッファについてローカル
|global-local|
タグを使うコマンドで必要とするタグファイルの名前の、空白またはコンマ区
切りのリスト。ファイル名に空白やコンマを使うときは、'\' を前に置くこと
(値に空白や '\' を含める方法については、
|option-backslash| を参照)。
ファイル名が "./" で始まるときは、'.' はカレントファイルのパスに置き換
えられる。ただしそれはオプション
'cpoptions' にフラグ 'd' が含まれてい
ないときのみである。環境変数は展開される
|:set_env|。
|tags-option| も
参照。
"*" や "**" などのワイルドカードを使い、ディレクトリツリーの下に向かっ
てタグファイルを検索できる。
|file-searching| を参照。例えば、
"/lib/**/tags" なら "/lib" 以下の "tags" という名前がすべて検索され
る。ファイル名自体にはワイルドカードを含めることはできない (そのまま使
われる)。例えば "/lib/**/tags?" なら "tags?" という名前のファイルが検
索される。
{Vimが |+path_extra|機能付きでコンパイルされたときのみ有
効}
関数
|tagfiles()|を使うと実際に使われるファイル名のリストを取得すること
ができる。
Vimが
|+emacs_tags| 機能付きでコンパイルされたときは、Emacs形式のタグ
ファイルも利用できる。形式は自動的に認識される。そのときの既定値は、大
文字と小文字の区別がないシステム (MS-Windows) 以外では
"./tags,./TAGS,tags,TAGS" となる。
|emacs-tags|
リストにファイル名を追加するときにはコマンド
|:set+=|、リストからファ
イル名を除くときにはコマンド
|:set-=| を使うのがよい。こうすると将来の
ヴァージョンで異なった既定値が使われるようになったときに、問題が起きる
のを防げる。
{Vi: 既定値は "tags /usr/lib/tags"}
*'tagstack'* *'tgst'* *'notagstack'* *'notgst'*
'tagstack' 'tgst' 切替 (既定ではオン)
グローバル
{Vi のヴァージョンによってはこれがないものもある}
オンのときは、タグスタック
|tagstack| が通常通りに使われる。オフのとき
は、引数付きのコマンド ":tag" または ":tselect" は、タグをタグスタック
にプッシュしない。 その後に引数無しの ":tag" や、":pop" 等のタグスタッ
クを使うコマンドを使うと、修正されていないタグスタックが使われるが、ア
クティブな項目へのポインタは変更される。
このオプションをオンにするのは、":tag" をマッピング内で使っていて、タ
グスタックを変更すべきでないときに便利である。
*'term'* *E529* *E530* *E531*
'term' 文字列 (既定では $TERM、それが失敗したら
GUI版では: "builtin_gui"
Amigaでは: "amiga"
BeOSでは: "beos-ansi"
Macでは: "mac-ansi"
MiNTでは: "vt52"
MS-DOSでは: "pcterm"
OS/2では: "os2ansi"
Unixでは: "ansi"
VMSでは: "ansi"
Win32では: "win32")
グローバル
ターミナルの名前。ターミナル制御文字の選択に使われる。環境変数は展開さ
れる
|:set_env|。
例:
|termcap| を参照。
*'termbidi'* *'tbidi'*
*'notermbidi'* *'notbidi'*
'termbidi' 'tbidi' 切替 (既定ではオフ、"mlterm" のときはオン)
グローバル
{Vi にはない}
{Vimが |+arabic| 機能付きでコンパイルされたときのみ有
効}
端末がテキストの双方向性 (Bi-directionality) (Unicode による定義) をサ
ポートしていることを示す。端末はいくつかの言語 (例えばアラビア語) で必
要とされている変形文字 (shaping) も処理することが期待される。
このオプションをオンなっている場合、
'arabic' をオンに設定しても
'rightleft' はオンにならず、そして
'arabicshape' の値は無視されます。
Note:
'termbidi' を設定するとすぐに
'arabicshape' が無視されるようにな
りますが、
'rightleft' は自動的には変更されません。
このオプションは GUI を開始するとリセットされます。
詳細は
|arabic.txt| を参照してください。
*'termencoding'* *'tenc'*
'termencoding' 'tenc' 文字列 (既定では ""; GTK+ 2 GUI では"utf-8";
Macintosh GUI では"macroman")
グローバル
{Vimが |+multi_byte| 機能付きでコンパイルされたときの
み有効}
{Vi にはない}
ターミナルで使われるエンコーディング名。このオプションは、どの文字エン
コーディングをキーボードが生成し、どの文字エンコーディングをディスプレ
イが理解できるかを指定する。GUI版ではキーボードにのみ適用される (ディ
スプレイにはオプション
'encoding' が使われる)。Macで
'macatsui'がオフに
なっているときは例外で、
'termencoding'は"macroman"になる。
Win32 のコンソール版では、コンソールのコードページがANSIコードページで
ないなら場合、その値が既定値となる。
*E617*
Note: これはGTK+ 2 GUIには適用されない。GUIの初期化に成功した後で強制
的に
'termencoding'が"utf-8"に設定される。
これを他の値に設定しようとしても失敗し、エラーメッセージが表示される。
Win32 GUIでは
'termencoding'は入力された文字に対しては適用されない。
Win32では常にユニコード文字が渡されるからである。
空のときは、
'encoding' で指定されたエンコーディングが使われる。これが
通常の値である。
'termencoding' と
'encoding' の組み合わせが全て正しいわけではない。
|encoding-table| を参照。
このオプションの値は、内部変換または関数 iconv() でサポートされていな
ければならない。iconv() が値を扱えないときは、変換はなされず、非ASCII
文字で問題が生じるだろう。
例: ユーザは euc-jp (日本語) に設定されたロケールで作業していて、UTF-8
のファイルを編集したいとする。
ユーザのシステムがUTF-8のロケールをサポートしていないときは、ユーザが
このように設定する必要がある。
*'terse'* *'noterse'*
'terse' 切替 (既定ではオフ)
グローバル
オンのときは、オプション
'shortmess' にフラグ 's' を追加する (こうする
とファイルの端まで検索してしまったときのメッセージが表示されなくなる)。
オフのときは、オプション
'shortmess' からフラグ 's' を取り除く。
{Vi では多くのメッセージを切り詰める}
*'textauto'* *'ta'* *'notextauto'* *'nota'*
'textauto' 'ta' 切替 (Vimの既定値: オン、Viの既定値: オフ)
グローバル
{Vi にはない}
このオプションは時代遅れである。オプション
'fileformats' を使うこと。
後方互換性のため、
'textauto' がオンのときは、
'fileformats' はシステム
の既定値に設定される。
'textauto' がオフになったときは、
'fileformats'
は空になる。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'textmode'* *'tx'* *'notextmode'* *'notx'*
'textmode' 'tx' 切替 (MS-DOS, Win32とOS/2では: 既定ではオン、
他のシステムでは: 既定ではオフ)
バッファについてローカル
{Vi にはない}
このオプションは時代遅れである。オプション
'fileformat' を使うこと。
後方互換性のため、
'textmode' がオンのときは、
'fileformats' は "dos" に
なる。
'textmode' がオフのときは、
'fileformats' は "unix" になる。
*'textwidth'* *'tw'*
'textwidth' 'tw' 数値 (既定では 0)
バッファについてローカル
{Vi にはない}
入力されているテキストの最大幅。行がそれより長くなると、この幅を超えな
いように空白の後で改行される。値を 0 に設定すると無効になる。オプショ
ン
'textwidth' が 0 のときは、
'wrapmargin' が使われる場合がある。
'formatoptions' と
|ins-textwidth| を参照。
'formatexpr'が設定されている場合、その値を使って改行される。
NOTE: このオプションは、オプション
'compatible' がオンのときは 0 にな
るので注意。
*'thesaurus'* *'tsr'*
'thesaurus' 'tsr' 文字列 (既定では "")
グローバル／バッファについてローカル
|global-local|
{Vi にはない}
同義語補完コマンド
|i_CTRL-X_CTRL-T| で単語の検索に使われるファイルの
名前の、コンマ区切りのリスト。そのファイルの各行には、似た意味の単語を
キーワードを構成しない文字で (空白がよい) 区切ったものが並ぶ。行長の最
大値は 510 バイトである。
これに使われるファイルを得るには、
http://www.hyphenologist.co.uk で
wordlist FAQ を調べること。
ファイル名にコンマを含めるときは、その前に '\' を置くこと。コンマの後
の空白は無視されるが、それ以外では空白はそのままファイル名に含まれる。
値に空白や '\' を含める方法については、
|option-backslash| を参照。
リストにディレクトリを追加するときには
|:set+=|、リストからディレクト
リを除くときには
|:set-=| を使うのがよい。こうすると将来のヴァージョン
で異なった既定値が使われるようになったときに、問題が起きるのを防げる。
安全上の問題のため、このオプションにバッククォート '`' は使えない。
*'tildeop'* *'top'* *'notildeop'* *'notop'*
'tildeop' 'top' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンのとき、ティルデコマンド "~" が operator のように使用できる。
(訳注: 普通ティルデは、打ち込まれた時点でカーソル下のアルファベットの
大文字／小文字を変換するが、このオプションがオンのときは、"d" 等のよう
に範囲を指定されるまで変換しない。このオプションがオフでも、
"g~
{motion}" なら範囲を指定できる。
|case| を参照)
NOTE: このオプションは、オプション
'compatible' がオンのときはオフにな
るので注意。
*'timeout'* *'to'* *'notimeout'* *'noto'*
'timeout' 'to' 切替 (既定ではオン)
グローバル
*'ttimeout'* *'nottimeout'*
'ttimeout' 切替 (既定ではオフ)
グローバル
{Vi にはない}
これら2個のオプションは共に、Vimがマッピングされたキー列やキーコードの
一部を受け取ったときの動作を決定する。
'timeout' 'ttimeout' 動作
オフ オフ タイムアウト (時間切れ) を設けない
オン オンまたはオフ マッピングとキーコードにタイムアウトあり
オフ オン キーコードにタイムアウトあり
両方オフのときは、完全なマッピングやキー列を受け取るか、受け取った文字
列に対応するマッピングやキー列はないと明らかになるまで、Vimは待つ。例
えば "vl" をマッピングして 'v' を入力したとき、'v' の次に 'l' が来るか
どうか判断するには次の文字が入力されることが必要である。
どちらかがオンのとき、Vimは次の文字が入力されるまで約1秒待つ。その後入
力された文字をそれぞれ単一の文字として解釈する。待ち時間はオプション
'timeoutlen' で設定できる。
遅いターミナルや非常にビジーなシステムでは、時間切れを設けるとカーソル
キーの動作がおかしくなることがある。両方オフのときは、
<Esc> で始まるキー
コードがあるとVimは
<Esc> が入力された後ずっと待ち状態になる。ユーザは
<Esc> を2回打ち込まなければならない。キーコードに問題はないが、マッピ
ングされたキー列を1秒でタイムアウトにされたくなければ、
'ttimeout' をオ
ン、
'timeout' をオフにすること。
NOTE: オプション
'ttimeout' は、オプション
'compatible' がオンのときは
オフになるので注意。
*'timeoutlen'* *'tm'*
'timeoutlen' 'tm' 数値 (既定では 1000)
グローバル
{Vi のヴァージョンによってはないものもある}
*'ttimeoutlen'* *'ttm'*
'ttimeoutlen' 'ttm' 数値 (既定では -1)
グローバル
{Vi にはない}
キーコードやマッピングされたキー列が完了するのを待つ時間 (ミリ秒単位)。
すでにコマンドの一部がタイプされているとき、
CTRL-\ CTRL-Nと
CTRL-\
CTRL-Gにも適用される。
普通オプション
'timeoutlen' のみが使われ、
'ttimeoutlen' は -1 に設定さ
れる。キーコードに対して異なった待ち時間を設定したいときは、
'ttimeoutlen' を非負の値に設定すること。
ttimeoutlen マッピング待ち キーコード待ち
負
'timeoutlen' 'timeoutlen'
0以上
'timeoutlen' 'ttimeoutlen'
タイムアウト (時間切れ) になるのは、
'timeout' と
'ttimeout' でそう設定
されているときのみである。便利な設定は次の通り。
(マッピングは3秒、キーコードは0.1秒で時間切れ)
*'title'* *'notitle'*
'title' 切替 (既定ではオフ、
タイトルが復元できるときにはオン)
グローバル
{Vi にはない}
{Vimが |+title| 機能付きでコンパイルされたときのみ有
効}
オンのとき、ウィンドウのタイトルがオプション
'titlestring' の値 (空で
なければ) になる。空の場合は次のようになる。
filename [+=-] (path) - VIM
ここでの意味は以下の通り。
filename 編集されているファイルの名前
- ファイルが変更できない、つまり
'ma' がオフであ
ることを表す
+ ファイルが変更を受けたことを表す
= ファイルが読み込み専用であることを表す
=+ ファイルが読み込み専用であるが変更を受けたこと
を表す
(path) 編集されているファイルのパス
- VIM サーバ名、変数
|v:servername| の値または "VIM"
ターミナルがウィンドウタイトルを設定できるもののときのみ有効である
(現在のところAmigaとWin32のコンソール版、全てのGUI版と
't_IS' が空でな
いターミナルのみ --- これらは既定では Unix xterm と iris-ansi であり、
このときターミナルオプション
't_IS' は組み込み termcap から取られる)。
*X11*
Vimが HAVE_X11 が定義された状態でコンパイルされた場合は、可能ならば元
のタイトルが復元される。HAVE_X11 が定義されていたら、コマンド
":version" の出力には "+X11" が含まれ、定義されていなかったら "-X11"
が含まれる。これはアイコン名
'icon' にも働く。
しかしVimが引数
|-X| 付きで起動した場合は、タイトルは復元されない (GUI
版を除く)。
タイトルを復元できないときは、
'titleold' がタイトルになる。その場合は
Vimの外でタイトルを復元したいと思うかもしれない。ネットワーク越しに
xterm を使っているときは、次のコマンドが使える。
rsh マシン名 xterm -display $DISPLAY &
すると環境変数 $WINDOWID の値が受け継がれ、ウィンドウのタイトルは、Vim
の終了後に戻るべき状態に戻る。
*'titlelen'*
'titlelen' 数値 (既定では 85)
グローバル
{Vi にはない}
{Vimが |+title| 機能付きでコンパイルされたときのみ有
効}
ウィンドウタイトルが占める列の割合 (パーセント単位)。タイトルがこれよ
り長かったときは、パス名の後ろの部分のみが表示される。この切り詰めを示
すためには、パス名の前に文字 '<' が表示される。
割合で指定しているため、タイトルが占める長さはウィンドウの幅に従って調
整できる。しかし完全にその通りになる訳ではない。それは実際に利用できる
文字数は、使われているフォントやタイトルバー内の他のものによっても変わ
るからだ。値が 0 のときは、フルパスが使われる。フルパスを使わないとき
は 1 以上 30000 以下の数を指定する。
このオプションはオプション
'titlestring' にも使われる。
*'titleold'*
'titleold' 文字列 (既定では "Vim を使ってくれてありがとう")
グローバル
{Vi にはない}
{Vimが |+title| 機能付きでコンパイルされたときのみ有
効}
このオプションの値は、Vimの終了時に元のウィンドウタイトルが復元できな
い場合のタイトルに使われる。オプション
'title' がオンであるか
'titlestring' が空でないときのみ有効である。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'titlestring'*
'titlestring' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+title| 機能付きでコンパイルされたときのみ有
効}
空でないとき、ウィンドウタイトルに使われる。オプション
'title' がオン
のときのみ有効である。
ターミナルがウィンドウタイトルを設定できるもののときのみ有効である (現
在のところAmigaとWin32のコンソール版、全てのGUI版とターミナルオプショ
ン
't_IS' が空でないターミナルのみ)。
Vimが HAVE_X11 が定義された状態でコンパイルされた場合は、可能ならば元
のタイトルが復元される
|X11|。
値に関数 printf 形式の '%' による書式指定が含まれているときは、
'statusline' と同じ方法で展開される。例:
'titlelen' の値は、利用できる場所の中で項目を中央や右にそろえるために
使われる。
ファイル名を最初に表示したい人は、こう設定する。
Note (ファイル名を除いた) パスを得るため、 "%{ }" と expression を使っ
ていることに注意。"%( %)" は、区切りの空白を必要なときだけ加えるために
使われている。
NOTE:
'titlestring' に特殊な文字 (例えば文字
<CR> や文字
<NL>) を使う
と、表示がおかしくなることがあるので注意。
{Vimが |+statusline| 機能付きでコンパイルされたときのみ有効}
*'toolbar'* *'tb'*
'toolbar' 'tb' 文字列 (既定では "icons,tooltips")
グローバル
{Vimの |+GUI_GTK|版, |+GUI_Athena|版, |+GUI_Motif|版,
|+GUI_Photon|版のみ}
ツールバーの様々な設定を行う。指定可能な値は以下の通り。
icons ツールバーのボタンにアイコンが表示される。
text ツールバーのボタンに名前が表示される。
horiz ツールバーのボタンのアイコンとテキストが水平に
配置される。|GTK+ 2 GUIでのみ利用可能|
tooltips ツールバーのボタンでツールティップが表示される。
ツールティップとは、マウスカーソルがツールバーのボタン上にしばらく置か
れたときに飛び出す、ヘルプテキストのことである。
ツールバーにアイコンと名前を両方表示したいときは、このように設定する。
MotifとAthenaでは両方同時には表示できない。両方求められると、アイコン
だけが表示される。
オプション
'toolbar' が空であるか、適切な値が一つもないときは、このオ
プションは無視される。ツールバーを無効にしたいときは、
'guioptions' を
設定する必要がある。例:
|gui-toolbar| も参照。
*'toolbariconsize'* *'tbis'*
'toolbariconsize' 'tbis' 文字列 (既定では "small")
グローバル
{Vi にはない}
{GTK+ 2 GUI版でのみ利用可能}
ツールバーのアイコンのサイズを制御する。設定可能な値は次の通り:
tiny 最も小さいツールバーのアイコンを使用する。
small 小さいツールバーのアイコンを使用する(既定値)。
medium 中程度のツールバーのアイコンを使用する。
large 大きいツールバーのアイコンを使用する。
各種アイコンサイズのピクセル単位での正確な大きさは、使用しているテーマ
に依存する。共通の大きさはlarge=32x32、medium=24x24、small=20x20、
tiny=16x16である。
'toolbariconsize'が空のときは、ユーザの設定または現在使用しているテー
マによって決定されるグローバルなデフォルトサイズが使用される。
*'ttybuiltin'* *'tbi'* *'nottybuiltin'* *'notbi'*
'ttybuiltin' 'tbi' 切替 (既定ではオン)
グローバル
{Vi にはない}
オンのときは、外部の termcap の前に組み込みの termcap を探す。
オフのときは、外部の termcap の後に組み込みの termcap を探す。
このオプションが変更されたときは、変更を有効にするため、次にオプション
'term' を設定する必要がある。例:
|termcap| も参照。
関連情報: このオプションは既定ではオンである。それは普通、組み込み
termcap のエントリの方が良いものだからだ (多くのシステムでおかしな
xterm エントリが含まれている...)。
*'ttyfast'* *'tf'* *'nottyfast'* *'notf'*
'ttyfast' 'tf' 切替 (既定ではオフ、
'term' が xterm, hpterm, sun-cmd, screen,
rxvt, dtterm, iris-ansi のときはオン、
DOSのコンソール版でもオン)
グローバル
{Vi にはない}
高速ターミナル接続を行う。再描画のとき、行挿入／削除コマンドを使う代わ
りに、より多くの文字が画面に送られる。複数のウィンドウが開かれて
いたり、ターミナルが部分スクロールをサポートしていないとき、再描画が滑
らかになる。
また折り返された行のそれぞれの行末で、文字の extra writing (訳注: 何の
ことだか分からない。どなたかご教授願います) を有効にする。これは xterm
等のターミナルで、マウスを使ってコピーやペーストをするときに役立つ。
(訳注: "tty" とは、昔のコンピュータに使われていたテレタイプ (TeleTYpe)
端末 (コンソールみたいなもの) から来た言葉である)
*'ttymouse'* *'ttym'*
'ttymouse' 'ttym' 文字列 (既定値は
'term' によって異なる)
グローバル
{Vi にはない}
{VimのUnix版とVMS版でのみ使用可能で、GUI版では無効。
Vimが |+mouse| 機能付きでコンパイルされたときのみ有効}
マウスコードが、このオプションで指定したターミナル名に従って認識される。
現在のところ、以下のターミナル名を設定できる。
*xterm-mouse*
xterm xterm 風にマウスを扱う。マウスが生成するコードは
"
<Esc>[Mscr" である。ここで "scr" は次のような3バイト
のコードである。
"s" = ボタンの状態
"c" = 桁数足す 33
"r" = 行数足す 33
これは223桁までしか機能しないことに注意。解決策につい
ては"dec"を参照。
xterm2 "xterm" と動作が似ているが、ドラッグ中もマウス位置を返
すような xterm に対して働く。こちらの方がずっと動作が
速く、正確である。これを使うには、ユーザの xterm が最
低でもパッチレベルが 88 で XFree 3.3.3 に対応していな
ければならない。Vimがこれを自動認識する方法については、
以下を参照。
*netterm-mouse*
netterm NetTerm 風にマウスを扱う。マウスが生成するコードは
"
<Esc>}r,c
<CR>" である。ここで "r,c" は、それぞれ
行数と列数を表す10進数である。
*dec-mouse*
dec DEC terminal 風にマウスを扱う。マウスが生成するのは、
"
<Esc>[" で始まるかなり複雑なコードである。
Xtermが"--enable-dec-locator"つきでconfigureされている
ならば、Xtermでもこれを利用できる。
*jsbterm-mouse*
jsbterm JSB term 風にマウスを扱う。
*pterm-mouse*
pterm QNX pterm 風にマウスを扱う。
*urxvt-mouse*
urxvt urxvt (rxvt-unicode) 風にマウスを扱う。
マウスを使用するには、コンパイル時に
|+mouse_xterm|,
|+mouse_dec|,
|+mouse_netterm| 等のどれかの機能を有効にしておかなければならない。
本当に認識されるのは "xterm(2)" のみである。NetTerm のマウスコードは、
コンパイル時に有効にされていれば必ず認識される。DEC terminal のマウス
コードは、コンパイル時に有効にされ、かつオプション
'ttymouse' が
"xterm" でないときのみ認識される (xterm と DEC のマウスコードが競合す
るため)。
このオプションが自動的に "xterm" に設定されるのは、
'term' が "xterm"
で始まり、かつ
'ttymouse' がすでに "xterm" または "xterm2" でないとき
である。このオプションの主な使い方は、ターミナル名が "xterm" で始まら
ないが、そのターミナルが xterm 風のマウスコードを認識できるときに、値
を "xterm" に設定する、というものである。
"xterm2" に自動設定されるのは、xterm のヴァージョンが 95 以上であると
報告されたときである。この設定は、機能
|+termresponse| がコンパイル時
に有効になっており、かつターミナルオプション
|t_RV| が xterm のヴァー
ジョンナンバーを求めるエスケープシーケンスに設定されていたときのみであ
る。そうでないときはユーザが "xterm2" と設定しなければならない。
'ttymouse' を "xterm2" に自動的に設定したくないときは、次のように
|t_RV| を空にすること。
*'ttyscroll'* *'tsl'*
'ttyscroll' 'tsl' 数値 (既定では 999)
グローバル
画面をスクロールする行数の最大値。この行数以上スクロールするときは、ウィ
ンドウが再描画される。スクロールがとても遅いが再描画は遅くないようなター
ミナルでは、表示を高速化するため、このオプションを 3 等の小さい数にす
るとよい。
*'ttytype'* *'tty'*
'ttytype' 'tty' 文字列 (既定値は $TERM によって決まる)
グローバル
上記のオプション
'term' の別名。
*'undodir'* *'udir'*
'undodir' 'udir' 文字列 (既定値は ".")
グローバル
{Vi にはない}
{Vimが |+persistent_undo| 機能付きでコンパイルされた
ときのみ有効}
アンドゥファイル用のディレクトリをカンマ区切りのリストで指定します。
書式についての詳細は
|'backupdir'| を参照。
"." はファイルのディレクトリを意味します。アンドゥファイルの名前は例え
ば "file.txt" なら ".file.txt.un~" になります。
別ディレクトリに保存される場合は、アンドゥファイルの名前は対象のファイ
ルの絶対パスのパス区切り文字を "%" で置換した名前になります。
保存するとき: 最初に見つかった、存在するディレクトリが使われます。"."
は常に有効なので "." 以降に指定されたディレクトリは使用されません。
読み込むとき: アンドゥファイルを探すためにすべてのエントリが試行されま
す。最初に見つかったファイルが使用されます。見つかったファイルが読めな
かったりエラーが発生したりしても、それ以降のエントリは使用されません。
|undo-persistence| 参照。
*'undofile'* *'udf'*
'undofile' 'udf' 切替 (既定ではオフ)
バッファについてローカル
{Vi にはない}
{Vimが |+persistent_undo| 機能付きでコンパイルされた
ときのみ有効}
オンにすると、バッファをファイルに保存したときにアンドゥ履歴がアンドゥ
ファイルに自動的に保存され、そして、後でそのファイルを開いたときにアン
ドゥファイルからアンドゥ履歴が復元されます。
アンドゥファイルが保存されるディレクトリは
'undodir' で設定します。
この機能の詳細は
|undo-persistence| を参照してください。
'undoreload' の処理の過程でファイルが読み込まれるときはアンドゥファイ
ルは読み込まれません。
警告: この機能は追加されたばかりです。自己責任で使ってください!
*'undolevels'* *'ul'*
'undolevels' 'ul' 数値 (既定では 100、
Unix, VMS, Win32, OS/2での既定値は 1000)
グローバル
{Vi にはない}
アンドゥ可能な変更の最大値。アンドゥをするための情報はメモリに蓄えられ
るため、大きい数を設定するとメモリの消費量も多くなる (にも関わらず、単
一の変更には無制限にメモリを利用できる)。
Vi互換にするには、次のように 0 にすること。アンドゥは 1 回だけ可能で、
もう 1 回 "u" を使うとアンドゥがアンドゥ (訳注: リドゥ) される。
しかしVi互換にするには、オプション
'cpoptions' にフラグ 'u' を追加して
もよい。こうするとコマンド
CTRL-R でリドゥできる。
|undo-two-ways| も参照。
アンドゥを無効にするには、次のように負の値にすること。
これは 1 回の変更でもメモリを使い果たしそうなときに役立つ。
|clear-undo| も参照。
*'undoreload'* *'ur'*
'undoreload' 'ur' 数値 (既定は 10000)
グローバル
{Vi にはない}
リロードするときにアンドゥのためにバッファ全体を保存する。これは ":e!"
コマンドを実行したときや、バッファが Vim の外で変更されたためにそれを
リロードするときに使用されます。
|FileChangedShell|
保存は、オプションの値が負数に設定されているか、行数が設定値より少ない
場合にのみ実行されます。
リロードのアンドゥを無効化するにはこのオプションをゼロに設定します。
リロードのためにアンドゥが保存されるときは、アンドゥファイルは読み込ま
れません。
Note: この機能によってバッファ全体がメモリに保持されます。メモリ不足が
起こる場合はこのオプションに小さい値を設定してください。
*'updatecount'* *'uc'*
'updatecount' 'uc' 数値 (既定では 200)
グローバル
{Vi にはない}
この回数だけ文字を打ち込むと、スワップファイルがディスクに書き込まれる。
0 にすると、スワップファイルは全く作られない (復旧に関する章
|crash-recovery| を参照)。Vimを引数 "-n" 付きで起動すると、オプション
'updatecount' を 0 に設定できる。
|startup| を参照。読み込み専用モード
で編集しているときは、このオプションは 10000 に初期化される。
'swapfile' により、スワップファイルをバッファごとに無効化できる。
'updatecount' が 0 から 非0 に変更されたときは、
'swapfile' がオンになっ
ている全てのバッファで、スワップファイルが作られる。
'updatecount' が 0
になったときは、既存のスワップファイルは削除されない。
'swapsync' も参照。
'buftype' が "nofile" や "nowrite" であるようなバッファでは、このオプ
ションの意味はない。
*'updatetime'* *'ut'*
'updatetime' 'ut' 数値 (既定では 4000)
グローバル
{Vi にはない}
この時間の間 (ミリ秒単位) 入力がなければ、スワップファイルがディスクに
書き込まれる (
|crash-recovery| を参照)。また autocommand のイベント
|CursorHold| にも使われる。
*'verbose'* *'vbs'*
'verbose' 'vbs' 数値 (既定では 0)
グローバル
{Vi にはないが、Viのヴァージョンによっては切替型のオプ
ション verbose がある}
値が 0 より大きいとき、Vimは実行中の動作に関するメッセージを表示する。
現在のところ、以下のメッセージが表示される。
1以上 ファイル viminfo が読み書きされたとき
2以上 コマンド ":source" でファイルを読み込んだとき
5以上 検索されたタグファイルとインクルードファイル全て
8以上 autocommand のグループが実行されたファイル
9以上 実行された autocommand 全て
12以上 実行された関数全て
13以上 例外が発生／捕捉／終了／破棄されたとき
14以上 ":finally"節において保留されている全て
15以上 実行された Ex コマンド全て (200 文字から後は切り捨て)
このオプションは、引数 "-V" でも設定できる。
|-V| を参照。
このオプションは、コマンド
|:verbose| でも設定できる。
'verbosefile'が設定されている場合、verboseのメッセージは表示されない。
*'verbosefile'* *'vfile'*
'verbosefile' 'vfile' 文字列 (既定では "")
グローバル
{Vi にはない}
このオプションが空でないとき、全てのメッセージはこの名前のファイルに書
き出される。ファイルが既に存在するときは、そこに追加される。
ファイルへの書き出しはVimが終了したときか、または
'verbosefile'が空に設
定されたとき終了する。書き込みはバッファされるので出力が欠けることがあ
る。
'verbosefile'を新しい値に設定すると、最初に空に設定したのと同じことに
なる。
|:redir|との違いは、
'verbosefile'が設定されているとき冗長なメッ
セージは画面に表示されないことである。
*'viewdir'* *'vdir'*
'viewdir' 'vdir' 文字列 (Amiga, MS-DOS, OS/2とWin32での既定値:
"$VIM/vimfiles/view",
Unixでの既定値: "~/.vim/view",
Macintoshでの既定値: "$VIM:vimfiles:view"
VMSでの既定値: "sys$login:vimfiles/view"
RiscOSでの既定値: "Choices:vimfiles/view")
グローバル
{Vi にはない}
{Vimが |+mksession| 機能付きでコンパイルされたときの
み有効}
コマンド
|:mkview| によるファイルを格納するディレクトリの名前。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'viewoptions'* *'vop'*
'viewoptions' 'vop' 文字列 (既定では "folds,options,cursor")
グローバル
{Vi にはない}
{Vimが |+mksession| 機能付きでコンパイルされたときの
み有効}
コマンド
|:mkview| の効果を変更する。値はキーワードのコンマ区切りのリ
ストである。キーワードは、ある項目の保存と復元を有効にする。
キーワード 復元される項目
cursor ファイル／ウィンドウ内のカーソル位置
folds 手動で作られた折り畳み、折り畳みの開閉の区別、折り畳み
関連のローカルなオプション
options ウィンドウまたはバッファについてローカルなオプションと
マッピング (ローカルなオプションのグローバルな値は含め
ない)
slash ファイル名内の '\' がスラッシュに置換される
unix WindowsやDOS上でも、Unix形式の end-of-line (1個の
<NL>) を使う
"slash" と "unix" は、Windows上でビューファイルをUnixと共有するときに
便利である。Unix版のVimはdos形式のスクリプトを読み込めないが、Windows
版のVimはunix形式のスクリプトを読み込めるからだ。
*'viminfo'* *'vi'* *E526* *E527* *E528*
'viminfo' 'vi' 文字列 (Viの既定値は "", Vimの既定値は、
MS-DOS, WindowsとOS/2では: '100,<50,s10,h,rA:,rB:,
Amigaでは: '100,<50,s10,h,rdf0:,rdf1:,rdf2:
他のシステムでは: '100,<50,s10,h)
グローバル
{Vi にはない}
{Vimが |+viminfo| 機能付きでコンパイルされたときの
み有効}
値が空でないとき、viminfo ファイルが起動に先立って読み込まれ、また終了
時に書き出される (
|viminfo-file| を参照)。値は指定部のコンマ区切りのリ
ストである。指定部には、効果を指定するフラグ1文字の次に、その値を指定
する数または文字列を指定する。指定されなかったものについては、既定値が
使われる。フラグとその動作の一覧は、以下の通りである。
フラグ 動作
*viminfo-!*
! これが含まれると、アルファベットの大文字で始まり、小文字を含ま
ないグローバル変数を保存・復元する。つまり "KEEPTHIS" と
"K_L_M" は保存されるが、"KeepThis" と "_K_L_M" は保存されない。
入れ子になったリストと辞書は正しく復元されず、空文字列になる。
*viminfo-quote*
" 各レジスタで保存される行数の最大値。これはフラグ'<'の古い表記
である。この表記の不利点は、エスケープのために"を前に書かない
といけないことである。そうしないとコメントの開始と見なされてし
まう！
*viminfo-%*
% これが含まれると、バッファリストを保存・復元する。Vimの起動時
にファイル名が引数に含まれていると、バッファリストは復元されな
い。 Vimの起動時にファイル名が引数に含まれていないと、バッファ
リストが viminfo ファイルから復元される。ファイル名のないバッ
ファとヘルプ用バッファは、viminfo ファイルには書き込まれない。
このフラグの後に続けて数値を書くと、保存されるバッファ数の最大
値を指定することができる。数値が書かれていない場合、全てのバッ
ファが保存される。
*viminfo-'*
' マークが復元されるファイル履歴の最大値。オプション
'viminfo'
が空でないときは、常にこれを設定しなければならない。
また、このオプションを設定するとジャンプリスト
|jumplist|と
|changelist| も viminfo ファイルに蓄えられることになる。
*viminfo-/*
/ 保存される検索パターンの履歴の最大値。非0 の値を指定すると、前
回の検索パターンと置換パターンも保存される。これが含まれないと
きは、
'history' の値が使われる。
*viminfo-:*
: 保存されるコマンドライン履歴の最大値。これが含まれないときは、
'history' の値が使われる。
*viminfo-<*
< 各レジスタで保存される行数の最大値。0 にすると、レジスタは保存
されなくなる。'"'はこのフラグの古い表記である。
下記のフラグ's'も参照: 's'はKbyte単位で最大値を指定する。
*viminfo-@*
@ 保存される input-line 履歴の最大値。これが含まれないときは、
'history' の値が使われる。
*viminfo-c*
c これが含まれると、viminfo ファイル内のテキストを、書き込まれた
ときのエンコーディングから現在のエンコーディングに変換する。
|viminfo-encoding| (訳注: および
'encoding') を参照。
*viminfo-f*
f ファイルマークを保存するかどうか。0 を指定すると、ファイルマー
ク ('0 から '9, 'A から 'Z) は保存されない。これが含まれなかっ
たり、値が非0 のときは、みな保存される。 '0 は (終了時やコマン
ド ":wviminfo" の実行時の) カーソル位置の保存に使われる。
*viminfo-h*
h viminfo ファイルの読み込み時に、
'hlsearch' を無効にする。含ま
れないときは、最後の検索コマンド以来、コマンド ":nohlsearch"
が使われたかどうかによる。
*viminfo-n*
n これでファイル viminfo の名前を指定する。名前は 'n' のすぐ後に
続けて指定する。
'viminfo' の最後に指定しなければならない！Vim
の開始時に引数 "-i" が指定されると、それで指定されたファイル名
がここで指定されたものを上書きする。環境変数は、オプションの設
定時ではなく、ファイルの読み込み時に展開される。
*viminfo-r*
r リムーバブル・メディア (訳注: フロッピ、CD-ROM等の取り外せる記
憶装置。この中身は取り替えてしまえば全く変わるので、ファイル履
歴の意味がない) の指定。引数は文字列 (次の ',' まで) である。
これは複数個指定できる。それぞれがマーク履歴の対象外になるパス
の先頭部を指定する。これはリムーバブル・メディアを避けるためで
ある。 MS-DOSでは "ra:,rb:", Amigaでは "rdf0:,rdf1:,rdf2:" と
するとよい。ここに一時ファイルを指定することもできる(Unixの例:
"r/tmp")。大文字と小文字の区別はない。それぞれの 'r' の引数の
最大長は 50 文字である。
*viminfo-s*
s Kbyte単位でのフラグの最大値。0のときレジスタは保存されない。現
在のところこれはレジスタにのみ適用される。既定値の"s10"の状態
では、10Kbyteを超えるテキストを持つレジスタは除外される。上記
のフラグ'<'も参照: '<'は行数で制限値を指定する。
例:
'50 最近編集した 50 ファイル内のマークは保存される。
<1000 レジスタの中身 (それぞれ 1000 行まで) は保存される。
s100 100Kbyteを超えるテキストを持つレジスタは保存されない。
:0 コマンドラインの履歴は保存されない。
n~/vim/viminfo 使用するファイル名は "~/vim/viminfo" である。
'/' がない '/' が指定されていないので、既定値が使われる。つまり全
ての検索履歴や前回の検索パターン、置換パターンが保存さ
れる。
'%' がない バッファリストは、保存も復元もされない。
'h' がない
'hlsearch' による強調表示は復元される。
'viminfo'を空の値から他の値へ変更するとき、
|:rviminfo|を使うと、そのファ
イルの中身を読み込むことができる。これは自動的には行われない。
安全上の理由から、このオプションをモードライン
|modeline|やサンドボック
ス
|sandbox|の中で設定することはできない。
*'virtualedit'* *'ve'*
'virtualedit' 've' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+virtualedit| 機能付きでコンパイルされたとき
のみ有効}
値は、以下のキーワードのコンマ区切りのリストである。
block Visual blockモードで仮想編集を有効にする。
insert Insertモードで仮想編集を有効にする。
all 全てのモードで仮想編集を有効にする。
onemore 行末の1文字先までカーソルを移動できるようにする。
仮想編集とは、実際に文字がないところにもカーソルを置けるようにすること
である。つまりタブ文字の内部や行末より後ろにカーソルを移動できる。
Visualモードで長方形を選択するときや、表を編集するときに便利である。
(訳注: フリーカーソルモードとも呼ばれる)
"onemore"は同じではない。"onemore"は単にカーソルを行の最後の文字の直後
まで移動できるようにするだけである。これによっていくつかのコマンドがよ
り一貫性を持つようになる。以前は、空行では常にカーソルは行末を越えてい
た。しかしこれはVi互換からはほど遠い。これを設定すると動かなくなるプラ
グインやVimスクリプトもあるかもしれない。例えば
|l|でカーソルが最後の文
字の後に移動できるためである。よく注意して使うこと！
コマンド
|$|はカーソルを行の最後の文字へ移動させる。最後の文字を越えは
しない。そのため、
|$|によってカーソルが左へ移動することもありえる。
"all"と"onemore"を同時に設定することは意味がないが、そのように設定して
も警告は出ない。
*'visualbell'* *'vb'* *'novisualbell'* *'novb'* *beep*
'visualbell' 'vb' 切替 (既定ではオフ)
グローバル
{Vi にはない}
ビープ音に、実際は音でなくビジュアルベル (訳注: 画面フラッシュ) を使う。
ビジュアルベルに使われるターミナルコードは、ターミナルオプション
't_vb' で指定される。音もフラッシュも使いたくないならば、次のようにす
ること (訳注: しかしエラーが分からなくなるという諸刃の剣)。
Note: GUIが開始するとき、
't_vb' は既定値に設定されることに注意。
|gvimrc| ファイルで再設定する必要があるだろう。GUI 版では、
't_vb' の既
定値は "
<Esc>|f" であり、画面の色を 20 ミリ秒だけ反転させる。違った時
間を設定したいときは、 "
<Esc>|40f" とすること。ここで 40 の所にはミリ
秒単位で時間を設定する。
Amigaではこのオプションは無効で、常に画面フラッシュが使われる。
'errorbells' も参照。
*'warn'* *'nowarn'*
'warn' 切替 (既定ではオン)
グローバル
バッファが変更される間にシェルコマンドが使われたら、警告メッセージを表
示する。
*'weirdinvert'* *'wiv'* *'noweirdinvert'* *'nowiv'*
'weirdinvert' 'wiv' 切替 (既定ではオフ)
グローバル
{Vi にはない}
このオプションは termcap オプション
't_xs' と同じ効果を持つ。これは
Vim version 4.x との後方互換性のためのものである。
このオプションをオンにすると、
't_xs' が非0 になる。またこのオプション
をオフにすると、
't_xs' が 0 になる。GUI版では効果がない。
*'whichwrap'* *'ww'*
'whichwrap' 'ww' 文字列 (Vimの既定値: "b,s"、Viの既定値: "")
グローバル
{Vi にはない}
カーソルを左右させるキーのうち、ここで指定したものでは、カーソルが行頭
／末にあるときに前／次行に移動できるようになる。以下のキーでこれを有効
にするには、文字を連結すること (訳注: はて？以下の文字を値に加えろとい
うことか？)。
フラグ キー モード
b
<BS> NormalとVisual
s
<Space> NormalとVisual
h "h" NormalとVisual (非推奨)
l "l" NormalとVisual (非推奨)
<
<Left> NormalとVisual
>
<Right> NormalとVisual
~ "~" Normal
[
<Left> InsertとReplace
]
<Right> InsertとReplace
例:
こうすると、カーソルキーでのみ行末／頭の移動ができる。
移動キーが削除オペレータや変更オペレータと共に使われたときは、
<EOL> も
文字に含まれる。このためカーソルが行末を通るときは、"3h" の動きと
"3dh" の動きは異なる。これは "x" と "X" にも当てはまる。それは、それら
のコマンドは "dl" と "dh" と同様に働くからだ。これを使うときは、バック
スペースでカーソル前の文字を削除できるようにするため、マッピング
":map
<BS> X" を使うとよい。
値に 'l' が含まれているとき、行末でオペレータの後にlを使うと、カーソル
が次行に移動しない。これによって"dl", "cl", "yl"などが普通に動作する。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'wildchar'* *'wc'*
'wildchar' 'wc' 数値 (Vimの既定値:
<Tab>、Viの既定値:
CTRL-E)
グローバル
{Vi にはない}
コマンドラインで、オプション
'wildmode' で指定したようにワイルドカード
を展開するために打ち込まなければならない文字。
より詳しくは
|cmdline-completion| を参照。
その文字はマクロ内では認識されない。それには
'wildcharm' を参照。
このオプションは数値オプションだが、次のように特殊キーも設定できる。
NOTE: このオプションは、オプション
'compatible' がオンのときはViの既定
値に、オフのときはVimの既定値になるので注意。
*'wildcharm'* *'wcm'*
'wildcharm' 'wcm' 数値 (既定では空 (0))
グローバル
{Vi にはない}
このオプションはオプション
'wildchar' と全く同様に働くが、こちらはマク
ロ内でも認識される点が異なっている。
|ex-edit-index| を探せば、このオプ
ションに適した「予備」コマンドラインキーが見つかるだろう。普通、ユーザ
が実際に
'wildcharm' で指定されたキーを打ち込むことはない。自動的に補
完モードを呼び出すマッピング内でのみ使うこと。例えば次のようにする。
こうすると ":ss" と打ち込んだ後でコマンド
CTRL-P や
CTRL-N が使える。
*'wildignore'* *'wig'*
'wildignore' 'wig' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが |+wildignore| 機能付きでコンパイルされたときの
み有効}
ファイルパターンのリスト。パターンのどれかにマッチしたファイルは、ファ
イル／ディレクトリ名の補完時に無視される。また、フラグを与えて無効化し
ない限り、
|expand()|,
|glob()|,
|globpath()| の結果に影響する。
パターンは
|:autocmd| と同様のものである。
|autocmd-patterns| を参照。
オプション
'suffixes' も参照。
例:
リストにパターンを追加するときにはコマンド
|:set+=|、リストからパター
ンを除くときにはコマンド
|:set-=| を使うのがよい。こうすると将来のヴァー
ジョンで異なった既定値が使われるようになったときに、問題が起きるのを防
げる。
*'wildignorecase'* *'wic'* *'nowildignorecase'* *'nowic'*
'wildignorecase' 'wic' 切替 (既定ではオフ)
グローバル
{Vi にはない}
オンのとき、ファイル名やディレクトリを補完するときに大文字と小文字が無
視される。元からファイル名の大文字と小文字を無視しているシステムでは効
果は無い。ワイルドカードの展開にシェルが使用されるとき (特殊文字が含ま
れているとき) はこのオプションは適用されない。
*'wildmenu'* *'wmnu'* *'nowildmenu'* *'nowmnu'*
'wildmenu' 'wmnu' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+wildmenu| 機能付きでコンパイルされたときのみ
有効}
オンのとき、コマンドライン補完が拡張モードで行われる。オプション
'wildchar' で指定されたキー (普通
<Tab>) を打ち込むと補完を開始し、コ
マンドラインのすぐ上に可能性のあるマッチが表示され、最初のマッチが強調
表示される (ステータス行があるときは、それを上書きする)。
<Tab> や
CTRL-P /
CTRL-N 等の前／次のマッチを表示するキーは、強調部分を適切なマッ
チに移動させる。
'wildmode' が有効なときは、"full" が指定されたところで "wildmenu" モー
ドが使われる。"longest" と "list" では "wildmenu" モードは開始されない。
1行に収め切れない程マッチがあるときは、(訳注: その後にマッチがあるなら)
文字 ">" が右端に表示され、(訳注: その前にマッチがあるなら) 文字 "<"
が左端に表示される。ステータス行は必要に応じてスクロールする。
"wildmenu" モードは、補完候補の選択に使われないキーが打ち込まれた時点
で終了する。
"wildmenu" が使われているとき、以下のキーは特別な働きを持つ。
<Left> <Right> - 前／次のマッチを選択 (
CTRL-P/
CTRL-N と同じ)
<Down> - ファイル／メニュー名補完時: サブディレクトリ／メニュー
に移動する。
<CR> - メニュー補完時、カーソルがドットの直後にあるとき: サ
ブメニューに移動する。
<Up> - ファイル／メニュー名補完時: 親ディレクトリ／メニュー
に移動する。
これにより、メニューがコンソールから扱える
|console-menus|。
<Left> や
<Right> キーで、別のマッチに移動するのではなく、カーソルを移
動させたいときは、次のようにする。
現在のマッチの表示には、強調表示グループ "WildMenu" が使われる
|hl-WildMenu|。
*'wildmode'* *'wim'*
'wildmode' 'wim' 文字列 (Vimの既定値は "full")
グローバル
{Vi にはない}
オプション
'wildchar' で指定されたキーで開始する補完モード。値は、キー
ワードの4個までのコンマ区切りのリストである。それぞれのキーワードで、
連続して
'wildchar' を使ったときの動作を指定する。1個目のキーワードが
'wildchar' を1回目に使ったときの動作を指定し、2個目のキーワードが2回目
の動作を指定、等となる。
指定可能なキーワードは、以下の通りである。
"" 最初のマッチのみを補完する。
"full" 次のマッチを完全に補完する。最後のマッチの次には元の文
字列が使われ、その次は再び最初のマッチが補完される。
"longest" 共通する最長の文字列までが補完される。それ以上長い文字
列を補完できないときは、次の候補に移る。
"longest:full" "longest" と似ているが、
'wildmenu' が有効ならばそれを
開始する。
"list" 複数のマッチがあるときは、全てのマッチを羅列する。
"list:full" 複数のマッチがあるときは、全てのマッチを羅列し、最初の
マッチを補完する。
"list:longest" 複数のマッチがあるときは、全てのマッチを羅列し、共通す
る最長の文字列までが補完される。
マッチが1個しかないときは、どの場合でも完全に補完される。
例:
最初のマッチ、次のマッチ...を完全に補完する (既定値)
共通する最長の文字列を補完し、次からマッチを完全に補完する
全てのマッチを羅列し、そして最初のマッチを完全に補完する
補完せずに全てのマッチを羅列し、次からマッチを完全に補完する
共通する最長の文字列を補完し、次から他の候補を羅列する
より詳しくは
|cmdline-completion| を参照。
*'wildoptions'* *'wop'*
'wildoptions' 'wop' 文字列 (既定では "")
グローバル
{Vi にはない}
{Vimが|+wildignore|機能付きでコンパイルされたときのみ
有効}
コマンドライン補完の挙動を変える単語のリスト。
現在のところ1つの単語だけが設定できる:
tagfile
CTRL-Dでマッチするタグを一覧表示するとき、タグの種類と
そのタグのファイル名が表示される。1行につき1つのマッチ
が表示される。よく使われるタグの種類は次の通り:
d #define マクロ
f 関数
|cmdline-completion|も参照。
*'winaltkeys'* *'wak'*
'winaltkeys' 'wak' 文字列 (既定では "menu")
グローバル
{Vi にはない}
{VimのWin32版、Motif版、GTK版、Photon GUI版でのみ有効}
GUI版では、メニュー内で下線付きで表示されている文字とALTキーを組み合わ
せて使うことで、メニューの項目にアクセスできるものがある。これはマッピ
ングや特殊な文字の入力にALTキーを使うことと衝突する。このオプションは、
そのときの動作を指定する。
no ALTキーをメニューに使わない。ALTキーを使った組み合わせはマッピ
ングに使えるが、自動的にメニューの操作に使われることはない。こ
のときメニューの操作は、コマンド
|:simalt| で可能である。
yes ALTキーの扱いはウィンドウシステムに任される。ALTキーとのキーの
組み合わせは、マッピングには使えない。
menu メニューのショートカットキーになっている文字と組み合わせてALT
キーを使うとウィンドウシステムが扱うが、他のキーはマッピングに
使える。
オプション
'guioptions' からフラグ 'm' が取り除かれ、メニューが無効に
なっていると、ALT キーはメニューには全く使われない。
このオプションは
<F10>には適用されない; Win32版とGTK版では、マッピング
されていない限り
<F10>を押すとメニューが選択される。
*'window'* *'wi'*
'window' 'wi' 数値 (既定では: 画面の高さ - 1)
グローバル
ウィンドウの高さ。Vimウィンドウの高さと混同しないこと。そちらには
'lines'を使う。
ウィンドウが1つだけで、このオプションの値が
'lines' - 1 より小さいとき、
|CTRL-F|と
|CTRL-B|でスクロールする行数に影響する。
'window' - 2 行(ただ
し最小値は1行)だけ画面がスクロールする。
'window'が
'lines' - 1 に等しいとき、
CTRL-Fと
CTRL-Bは折り返された行を考
慮したより賢い方法でスクロールする。
Vimウィンドウをリサイズするとき、このオプションの値が1より小さいか
'lines'以上ならば
'lines' - 1 に設定される。
{Vi はこのオプションによって表示する行の数も決定する}
*'winheight'* *'wh'* *E591*
'winheight' 'wh' 数値 (既定では 1)
グローバル
{Vi にはない}
{Vimが |+windows| 機能付きでコンパイルされたときのみ
有効}
カレントウィンドウの行数の最小値。これは絶対的な最小値ではなく、余裕の
ないときには行数はこれよりも少なくなる。この指定より小さいウィンドウに
フォーカスが移動すると、他のウィンドウの行数を減らしてそのウィンドウを
大きくする。
通常の編集時には
'winheight' を小さい値にしておくこと。
値を 999 にすると、常にカレントウィンドウが画面のほとんどを占め、ほか
のウィンドウは
'winminheight' の高さになる。
(ただしこうすると":all"を使ったときウィンドウが2つしか作られないとい
う難点もある)。"vim -o 1 2 3 4" としたとき2個のウィンドウしか作られな
いのを避けるには、イベント
|VimEnter| を使って、スタートアップが行われ
た後にこのオプションを設定すればよい:
最小値は1。
カレントウィンドウの高さを変更するコマンドの後では、ウィンドウの高さは
調整されない。
'winheight' はカレントウィンドウに適用される。他のウィンドウの高さの最
小値の設定には、
'winminheight' を使うこと。
*'winfixheight'* *'wfh'* *'nowinfixheight'* *'nowfh'*
'winfixheight' 'wfh' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが|+windows|機能付きでコンパイルされたときのみ有
効}
'equalalways'をオンにしてウィンドウを開閉したとき、ウィンドウの高さを
保つ。
|CTRL-W_=|に対しても同様。
|preview-window|と
|quickfix-window|に
対してはデフォルトでオンになる。
これをオンにしていても、利用できる高さが不足している場合には高さが変わ
る。
*'winfixwidth'* *'wfw'* *'nowinfixwidth'* *'nowfw'*
'winfixwidth' 'wfw' 切替 (既定ではオフ)
ウィンドウについてローカル
{Vi にはない}
{Vimが|+windows|機能付きでコンパイルされたときのみ利
用可能}
'equalalways'がオンになっていてウィンドウを開閉したとき、ウィンドウの
幅を保つ。
|CTRL-W_=|に対しても同様。
これをオンにしていても、利用できる幅が不足している場合には幅が変わる。
*'winminheight'* *'wmh'*
'winminheight' 'wmh' 数値 (既定では 1)
グローバル
{Vi にはない}
{Vimが |+windows| 機能付きでコンパイルされたときのみ
有効}
カレントウィンドウではないウィンドウの高さの最小値。これは絶対的な最小
値であり、ウィンドウは決してこれより低くはならない。
0 に設定すると、ウィンドウは必要に応じて高さゼロに「潰される」 (つまり、
ステータス行のみになる)。ウィンドウがアクティブになると、高さは最低 1
行にはなる (カーソルの居場所が必要なため)。
カレントウィンドウの高さの最小値の設定には、
'winheight' を使うこと。
このオプションの効果があるのは、ウィンドウを小さくするときだけである。
大きな値を使わないこと。そうするとウィンドウを幾つも開いたときにエラー
になる。値は 0 から 3 までが適当である。
*'winminwidth'* *'wmw'*
'winminwidth' 'wmw' 数値 (既定では 1)
グローバル
{Vi にはない}
{Vimが |+vertsplit| 機能付きでコンパイルされたときの
み有効}
カレントウィンドウではないウィンドウの幅の最小値。これは絶対的な最小値
であり、ウィンドウは決してこれより狭くはならない。
0 に設定すると、ウィンドウは必要に応じて幅ゼロに「潰される」 (つまり、
垂直分割の区切りのみになる)。ウィンドウがアクティブになると、幅は最低
1 列にはなる (カーソルの居場所が必要なため)。
カレントウィンドウの幅の最小値の設定には、
'winwidth' を使うこと。
このオプションの効果があるのは、ウィンドウを小さくするときだけである。
大きな値を使わないこと。そうするとウィンドウを幾つも開いたときにエラー
になる。値は 0 から 12 までが適当である。
*'winwidth'* *'wiw'* *E592*
'winwidth' 'wiw' 数値 (既定では 20)
グローバル
{Vi にはない}
{Vimが |+vertsplit| 機能付きでコンパイルされたときの
み有効}
カレントウィンドウの列数の最小値。これは絶対的な最小値ではなく、余裕の
ないときには列数はこれよりも少なくなる。カレントウィンドウの列数が指定
したものより少ないときは、他のウィンドウの列数を減らしてそれを増やす。
カレントウィンドウが常に画面を埋めるようにするには、999 に設定すること。
普通の編集時には小さい値に設定すること。
カレントウィンドウの幅を変更するコマンドの後では、ウィンドウの幅は調整
されない。
'winwidth' はカレントウィンドウに適用される。他のウィンドウの幅の最小
値の設定には、
'winminwidth' を使うこと。
*'wrap'* *'nowrap'*
'wrap' 切替 (既定ではオン)
ウィンドウについてローカル
{Vi にはない}
このオプションは、テキストの表示方法を変える。これはバッファ内のテキス
トには変更を与えない。それについてはオプション
'textwidth' を参照。
オンのときは、ウィンドウの幅より長い行は折り返され、次の行に続けて表示
される。オフのときは、折り返しは行われず、長い行は一部のみが表示される。
カーソルが表示されていない部分に移動すると、画面は水平スクロールする。
行の分割は、必要であれば単語の中ででも行われる。折り返しを単語の境界で
行うには、
'linebreak' を参照。
水平スクロールをもっと便利にするには、次のようにしてみるとよい。
'sidescroll'、
'listchars' や
|wrap-off| を参照。
オプション
'diff' がオンの場合、モードライン
|modeline| からこのオプ
ションを設定することはできない。
*'wrapmargin'* *'wm'*
'wrapmargin' 'wm' 数値 (既定では 0)
バッファについてローカル
ウィンドウの右端からこの文字数だけ離れたところで折り返しが始まる。この
境界を超えてテキストを入力すると、
<EOL> が挿入され、挿入は次行に続く。
'number'や
'foldcolumn'など幅をとるオプションを使用していると、テキスト
の幅がこの値より少なくなる。これはVi互換の動作である。
オプション
'textwidth' が非0 のときは、このオプションは使われない。
'formatoptions' と
|ins-textwidth| も参照。
{Vi: 少し不便な、違った動
作をする}
*'wrapscan'* *'ws'* *'nowrapscan'* *'nows'*
'wrapscan' 'ws' 切替 (既定ではオン)
*E384* *E385*
グローバル
検索がファイル末尾まで進んだら、ファイル先頭から再び検索する。スペリン
グミスを検索する
|]s|と
|[s|にも適用される。
*'write'* *'nowrite'*
'write' 切替 (既定ではオン)
グローバル
{Vi にはない}
ファイルの書き込みを有効にする。オフのときは、書き込みができない。読込
専用モードに使える。ただしファイルの編集は可能である。コマンドライン引
数
|-m| や
|-M| を使ってオフに設定できる。テキストをフィルタにかけるこ
とも可能であり、一時ファイルの書き込みも可能である。
*'writeany'* *'wa'* *'nowriteany'* *'nowa'*
'writeany' 'wa' 切替 (既定ではオフ)
グローバル
いかなるファイルも "!" なしに書き込みができる。
*'writebackup'* *'wb'* *'nowritebackup'* *'nowb'*
'writebackup' 'wb' 切替 (
|+writebackup| 機能付きでコンパイルされたなら
既定値はオン、そうでないなら既定値はオフ)
グローバル
{Vi にはない}
ファイルの上書きの前にバックアップを作る。オプション
'backup' がオンで
ない限り、バックアップは上書きに成功した後削除される。ユーザのファイル
システムがほとんど一杯ならばこのオプションをオフにすること。他の説明は
|backup-table| を参照。
'backupskip' のパターンがマッチしたら、バックアップは作られない。
NOTE: このオプションは、オプション
'compatible' がオンのときは既定値に
なるので注意。
*'writedelay'* *'wd'*
'writedelay' 'wd' 数値 (既定では 0)
グローバル
{Vi にはない}
打ち込まれた文字が画面に送られるまでの遅延時間を、1万分の1秒単位
で指定する。非0 のときは、文字は画面に一つ一つ送られる。MS-DOSの
pcterm では動作しない。これはデバッグ用のオプションである。
vim:tw=78:ts=8:ft=help:norl: