-
Notifications
You must be signed in to change notification settings - Fork 33
/
Copy pathoptions.jax
8867 lines (8109 loc) · 505 KB
/
options.jax
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
*options.txt* For Vim バージョン 8.0. Last change: 2016 Sep 13
VIMリファレンスマニュアル 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& 全てのオプションを既定値に設定する。ただし以下のオプ
ションについては変更しない。
t_ で始まる端末用のオプション全部
'columns'
'cryptmethod'
'encoding'
'key'
'lines'
'term'
'ttymouse'
'ttytype'
警告: これにはたくさんの副作用があるだろう。
{Vi にはない}
*:set-args* *E487* *E521*
:se[t] {option}={value} または
:se[t] {option}:{value}
数値および文字列オプションの値を {value} に設定する。
数値オプションの値は、10進数、(0x を頭に付けて) 16進数、
または ('0' を頭に付けて) 8進数で指定できる。
オプション '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 ai nosi sw=3 ts=3
引数の中にエラーがあると、エラーメッセージが現れ、エラーの元になったオプション
以降は無視される。
*:set-verbose*
オプション 'verbose' の値が非0 なら、オプションの値を表示するとき、同時に、そ
のオプションが最後に設定されたのはどこであったかも分かる。例: >
:verbose set shiftwidth cindent?
shiftwidth=4 ~
Last set from modeline ~
cindent |
Last set from /usr/local/share/vim/vim60/ftplugin/c.vim
これは特定のオプション名が指定されたときのみ機能する。コマンド ":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> の形式を使うこと: >
:set <t_#4>=^[Ot
これは特殊なコードを普通のキーに変換する際にも使われる。例えば Alt-b が <Esc>b
を出力するなら、次のようにすること。 >
:set <M-b>=^[b
(ここで ^[ は本物の <Esc> である。入力には CTRL-V <Esc> を使うこと)
マッピングの利点は、どんなときにも機能することである。
キーコードを定義することができる。例: >
:set t_xy=^[foo;
未知のキーコード名を使っても警告は表示されない。これらのキーコードに対してマッ
プを定義できる: >
:map <t_xy> something
< *E846*
キーコードが設定されていない場合、それは存在しないのと同じである。その値を取得
しようとするとエラーになる: >
:set t_kb=
:set t_kb
E846: Key code not set: t_kb
t_xxの形のオプションは安全上の理由により、モードライン|modeline|やサンドボック
ス|sandbox|では設定できない。
コマンド ":set" によるリスト表示の外見は、Viとは違う。長い文字列オプションはリ
ストの終わりに現れる。オプションの数も極めて多い。コマンド "set all" による表
示は、画面に収まらないだろう。そうしたとき、Vimは「継続」プロンプト
|more-prompt| を出す。
*option-backslash*
文字列オプションの値に空白を含めるには、空白の前に '\' を置く必要がある。値に
'\' を含めるには、2個繰り返す。結果的には、オプションの値の中の '\' の数は半分
になる (端数は切り捨て)。
例をいくつか挙げる。 >
:set tags=tags\ /usr/tags の結果は "tags /usr/tags"
:set tags=tags\\,file の結果は "tags\,file"
:set tags=tags\\\ file の結果は "tags\ file"
文字 "|" によって、コマンド ":set" を後に続くコマンドと分けることができる。文
字列オプションの値に "|" を含めるには、代わりに "\|" を使うこと。次の例ではオ
プション 'titlestring' の値を "hi|there" に設定している。 >
:set titlestring=hi\|there
しかし次の例では、2個のオプション 'titlestring', 'iconstring' をそれぞれ "hi",
"there" に設定している。 >
:set titlestring=hi|set iconstring=there
また、ダブルクォート文字はコメントを開始する。オプションの値に '"' を含めるに
は '\"' と書くこと。次の例は 'titlestring' を 'hi "there"' に設定する: >
:set titlestring=hi\ \"there\"
MS-DOSとWin32では、ファイル名の中の '\' は大抵は取り除かれない。正確に言うと、
値にファイル名を取るオプション (環境変数が展開されるもの) では、通常のファイル
名に使われる文字の前の '\' は取り除かれない。しかし、特別な文字 (空白、'\' そ
のもの、コンマ等) の前の '\' は、上で説明した通りの働きをする。
オプションの値が "\\" で始まるときは、特別な状態になる。 >
:set dir=\\マシン名\パス の結果は "\\マシン名\パス"
:set dir=\\\\マシン名\\パス の結果は "\\マシン名\パス"
:set dir=\\パス\\ファイル の結果は "\\パス\ファイル" (間違い!)
最初の例では、始まりの部分の '\' はそのまま保たれている。しかし2番目の例では、
'\' の数は半分になっている。つまり、'\' をそのまま保ちたいときでも、半分にした
いときでも、どちらがよいか指定できることが分かる。3番目の結果は、おそらく希望
通りのものではないだろう。このやり方は避けること。
*add-option-flags* *remove-option-flags*
*E539* *E550* *E551* *E552*
値がフラグのリストからなるオプションもある。そういったオプションにフラグを追加
したいとき、既存の値を変更したくないならば、こうすること。 >
:set guioptions+=a
オプションからフラグを取り除くには、こうすること。 >
:set guioptions-=a
これはオプション 'guioptions' からフラグ 'a' を取り除く。
Note フラグは1個ずつ追加したり取り除いたりするよう注意。オプション
'guioptions' が "ab" という値であるとき、"set guioptions-=ba" は機能しない。な
ぜなら、"ba" という文字列は現れていないからである。
*:set_env* *expand-env* *expand-environment-var*
特定の文字列オプションでは環境変数が展開される。'$' とそれに続く環境変数名が、
その値に置き換えられる (その環境変数が存在するとき)。環境変数が存在しないとき、
'$' とそれに続く変数名は変更を受けない。識別子に使えない non-id 文字 (英字、数
字、'_' 以外) なら、どれでも環境変数名の後に続けることができる。識別子に使えな
い文字とそれに続く文字は、環境変数の値の後ろにそのまま追加される。例: >
:set term=$TERM.new
:set path=/usr/$INCLUDE,$HOME/include,.
コマンド ":set opt-=値" でオプションから文字列を取り除いたり、コマンド ":set
opt+=値" でオプションに文字列を追加したりするときには、環境変数の展開が行われ
てからそうした操作がなされる。
ローカルオプションの扱い *local-options*
いくつかのオプションは、1つのウィンドウや1つのバッファのみに適用される。それぞ
れのウィンドウやバッファは、そうしたオプションの独自のコピーを保持しているため、
独自の値を持つことができる。これにより、あるウィンドウ内では 'list' オプション
をオンにするが、他のウィンドウではオフにする、ということが可能になる。またオプ
ション 'shiftwidth' を、あるバッファ内では 3 にし、他では 4 にすることもできる。
以降では、特定の状況下でそれらのローカルオプションがどうなるかを説明する。実際
には、それらを全て知る必要はない。なぜなら、Vimはおそらくユーザーが予想する通
りにオプションの値を使うからである。残念ながら、ユーザーの予想通りに働くのは、
いくらか複雑なことである...
ウィンドウを分割すると、ローカルオプションは新しいウィンドウにコピーされて引き
継がれる。そのため、ウィンドウを分割した直後には、2つのウィンドウの内容は同じ
ように見える。
新しいバッファを編集するとき、そのバッファのローカルオプションは初期化されなけ
ればならない。その以前のカレントバッファのローカルオプションは、そのバッファの
みに適用すべきものかもしれないので、新しいバッファには適用されない。その代わり、
バッファについてローカルなオプションにはそれぞれグローバルな値があり、新しいバッ
ファにはそれが適用される。コマンド ":set" によって、ローカルな値とグローバルな
値の両方が変更される。コマンド "setlocal" はローカルな値のみを変更するので、そ
れで指定した値は新しいバッファには適用されない。
すでに編集されているバッファを編集するときは、最後に閉じられたウィンドウ内のロ
ーカルオプションが再び使われる。このバッファがこのウィンドウ内ですでに編集され
ていたなら、そのときの値が再び用いられる。そうでなければ、そのバッファが最後に
編集されて閉じられたウィンドウ内の値が用いられる。
特定のバッファの種類についてウィンドウ内のローカルオプションを設定することも可
能である。同じウィンドウ内で別のバッファを編集するときは、ウィンドウについてロー
カルなオプションを使い続けたくはないだろう。そのためVimはウィンドウについてロー
カルなオプションのグローバルな値を記憶しており、別のバッファの編集時にはそれを
用いる。ウィンドウはそれぞれ、それらの値の独自のコピーを持っている。そのため、
それらのオプションはウィンドウについてはローカルであるが、そのウィンドウ内の全
てのバッファについてグローバルである。それらを用いて、次のようなことが可能であ
る。 >
:e 一つ目
:set list
:e 二つ目
こうするとオプション 'list' はバッファ "二つ目" にも適用される。コマンド
":set list" により、グローバルな値もオンになったからである。 >
:set nolist
:e 一つ目
:setlocal list
:e 二つ目
今度はバッファ "二つ目" ではオプション 'list' はオフである。なぜならコマンド
":set nolist" がグローバルな値をオフにしたが、コマンド ":setlocal list" はバッ
ファ "一つ目" についてローカルな値をオンにしただけで、":e 二つ目" ではグローバ
ルな値が適用されるからである。 Note 次にこうすると >
:e 一つ目
最後にバッファ "一つ目" を編集したときの通りにオプション 'list' の値が戻る。
ウィンドウについてローカルなオプションはバッファ毎に記憶される。バッファがロー
ドされていなくても同様に記憶されている。ただし、バッファが破棄 (|:bwipe|) され
たときは設定は消える。
*: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' は両方に適用される。そこでウィンド
ウの片方で >
:set makeprg=gmake
とすると、別のウィンドウでも同じ値が用いられる。別のウィンドウに移って
オプション 'makeprg' を設定する必要はない。
しかし、新しいウィンドウでPerlのソースファイルの編集を始めると、'makeprg' に別
の値を設定したくなる。しかしCソースに適用された値を変えたくはない。そんなとき
には次のようにする。 >
:setlocal makeprg=perlmake
次のようにローカルな値を空にすると、グローバルな値に戻る。 >
:setlocal makeprg=
ただし、この方法は文字列オプションにしか使えない。切替オプションには、次のよう
に "<" フラグを使う必要がある。 >
:setlocal autoread<
Note: 非切替オプションの変更で "<" を使うと、グローバルな値がローカルな値にコ
ピーされるが、それはグローバルな値を使うようにするのとは少し違うことに注意 (こ
れは後でグローバルな値が変更されたときに問題になる。{訳注: グローバルな値が変
更されても、"<" でコピーした値までは変更されない。あくまでもローカルな値だか
ら})。次を使うこともできる: >
:set path<
これは 'path' のローカルな値を空にし、グローバルな値が使われるようにする。すな
わち、次と同じことをする: >
:setlocal path=
Note: 将来、値にグローバルとローカルの区別のあるオプションが増えたら、グローバ
ルオプションにコマンド ":setlocal" を使ったときの結果が変わるかもしれない。
ファイルタイプの設定
:setf[iletype] {filetype} *:setf* *:setfiletype*
{filetype} に対してオプション 'filetype' を設定する。
ただし autocommand の中 (入れ子になっているときは、外
側も含めて) でまだ実行されていないときのみ有効である。
これは以下のコマンドの略である。 >
:if !did_filetype()
: setlocal filetype={filetype}
:endif
< このコマンドは 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系のシステムでは "~user" も使える。これは "user" というユーザーのホームディ
レクトリに置き換えられる。例: >
:set path=~mool/include,/usr/include,.
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 に加えればよい。 >
:fixdel
< これはバックスペースのキーコードが実際に何であっても有
効である。
バックスペースのキーコードが違っていたら、以下のように
する。 >
:if &term == "termname"
: set t_kb=^V<BS>
: fixdel
:endif
< ここで "^V" は CTRL-V、 "<BS>" はバックスペースを表す
(実際に「^」「V」などのキーを押さないこと)。"termname"
にはユーザーの使うターミナル名を当てはめる。
<Delete> キーが奇妙なキーコード列 (CTRL-? でも CTRL-H
でもない) を送るときは、コマンド ":fixdel" ではなく以
下の方法を使う。 >
:if &term == "termname"
: set t_kD=^V<Delete>
:endif
< ここで "^V" は CTRL-V、 "<BS>" はデリートキーを表す
(実際に「^」「V」などのキーを押さないこと)。"termname"
にはあなたの使うターミナルの種類を当てはめる。
*Linux-backspace*
Note Linuxについての注意: 既定ではバックスペースキーは
CTRL-? を送るが、これは違っている。これを修正するには、
ファイル rc.local に次の行を加える。 >
echo "keycode 14 = BackSpace" | loadkeys
<
*NetBSD-backspace*
Note NetBSDについての注意: バックスペースキーが正しい
キーコードを送らないとき、これを試すこと。 >
xmodmap -e "keycode 22 = BackSpace"
< 有効だったら、ファイル .Xmodmap に次の行を加えること。 >
keysym 22 = BackSpace
< これを有効にするには、再起動する必要がある。
==============================================================================
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 ~
vim: tw=77 ~
2つ目の形式は次の通りである (Viのバージョンによってはこの形式と互換性がある)。
[text]{white}{vi:|vim:|Vim:|ex:}[white]se[t] {options}:[text]
[text] 任意のテキスト、なくても良い
{white} 1個以上の余白 (<Space> または <Tab>)
{vi:|vim:|Vim:|ex:} "vi:" か "vim:" か "Vim:" か "ex:" という文字列
[white] 空白、なくても良い
se[t] "set " または "se " という文字列 (NOTE 終わりの空白に注意)
{options} オプション設定が空白で区切られて並んだもので、コマンド
":set" の引数である
: コロン
[text] 任意のテキスト、なくても良い
例:
/* vim: set ai tw=75: */ ~
/* Vim: set ai tw=75: */ ~
{vi:|vim:|Vim:|ex:} の前には空白が必要である。これが "lex:" 等の普通の言葉を誤
認する可能性を低めている。ただし例外があり、 "vi:" と "vim:"は行頭に来てもよい
(バージョン3.0との互換性のため)。"ex:" が行頭に来ると、モードラインとは見なさ
れない ("example:" の略かもしれないから)。
*modeline-local*
オプションは ":setlocal" などで設定できる。そうして設定した値は、そのバッファ
とそれを開いているウィンドウにのみ適用される。モードラインからグローバルオプショ
ンを設定することは不可能ではないが、普通そういうことはしない。2つのウィンドウ
を開いていて、それぞれのファイルが同じグローバルオプションを違う値に設定しよう
としたときは、後に開かれたウィンドウが優先される。
既に読み込まれているファイルを開くときは、モードラインからはウィンドウローカル
なオプションだけが設定される。つまり、ファイルを開いた後に手動でバッファローカ
ルなオプションを変更したら、そのバッファを別なウィンドウで開いてもそのオプショ
ンは変更されないが、ウィンドウローカルなオプションは変更される。
*modeline-version*
モードラインの内容が、Vimのバージョンによって使用可能だったり不可能だったりす
る場合には、"vim:" または "Vim:" のところでバージョンを指定できる。
vim{vers}: バージョン {vers} 以降 (そのバージョンを含む)
vim<{vers}: バージョン {vers} より前
vim={vers}: バージョン {vers} のみ
vim>{vers}: バージョン {vers} より後 (そのバージョンを含まない)
{vers} に 700 を指定するとVim 7.0を表す (メジャー・バージョンナンバーの100倍足
すマイナー・バージョンナンバー)。
例えば、Vim 7.0でのみモードラインを使うにはこうする:
/* vim700: set foldmethod=marker */ ~
Vim 7.2より新しいバージョンでのみモードラインを使うにはこうする:
/* vim>702: set cole=2: */ ~
"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 を定義すればよい。例: >
au BufReadPost * if getline(1) =~ "VAR" | call SetVar() | endif
そして "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" で設定できるかどうか判定するにはこのようにする: >
if exists('&foo')
これは隠しオプションに対してもtrueを返す。オプション "foo" が本当にサポートさ
れているかを判定するにはこのようにする: >
if exists('+foo')
<
*E355*
|Q_op| にはオプションの短い説明付きの表があり、そこからヘルプにジャンプできる。
*'aleph'* *'al'* *aleph* *Aleph*
'aleph' 'al' 数値 (既定値はMS-DOSでは128、それ以外では224)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
ヘブライ語アルファベットの最初の文字を表すASCIIコード。挿入モード(オプ
ション 'hkmap' がオンのとき) と コマンドラインモード (CTRL-_ を打ち込
んだとき) の両方において、ヘブライモードのキーボード配列をマッピングす
るルーチンは、[aleph..aleph+26] の範囲のヘブライ文字を出力する。
'aleph'=128 はPCコード、'aleph'=224 は ISO 8859-8 に使われる。
|rileft.txt| を参照。
*'allowrevins'* *'ari'* *'noallowrevins'* *'noari'*
'allowrevins' 'ari' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+rightleft| 機能付きでコンパイルされたときの
み有効}
挿入モードとコマンドラインモードで CTRL-_ を使用可能にする。これは既定
ではオフになっている。ユーザーが間違って SHIFT-_ ではなく CTRL-_ を打
ち込み、右から左に書いていくモードに入って抜けられなくなる事態を防ぐた
めである。オプション 'revins' を参照。
NOTE: このオプションは、オプション 'compatible' がオンのときはオフにな
るので注意。
*'altkeymap'* *'akm'* *'noaltkeymap'* *'noakm'*
'altkeymap' 'akm' 切替 (既定ではオフ)
グローバル
{Vi にはない}
{Vimが |+farsi| 機能付きでコンパイルされたときのみ有
効}
オンのとき、2番目の言語がペルシアになる。オプション 'allowrevins' がオ
ンならば、挿入モードでは CTRL-_ でペルシアと英語のキーボードマップを切
り替えられる。
オフのとき、キーボードマップはヘブライ語と英語で切り替えられる。これは
普通の状態、つまり英語モード (左から右に書く言語のモード) と既定の第2
言語であるペルシアまたはヘブライ語モード (右から左に書く言語のモード)
を切り替えた上でVimを開始するのに便利である。|farsi.txt| を参照。
*'ambiwidth'* *'ambw'*
'ambiwidth' 'ambw' 文字列 (既定では "single")
グローバル
{Vi にはない}
{Vimが|+multi_byte|機能付きでコンパイルされたときのみ
有効}
'encoding' が "utf-8" などUnicodeエンコーディングのときのみ効果がある。
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)を参照。
Vim が |+termresponse| 機能付きでコンパイルされ、|t_u7| にカーソル位置
取得のためのエスケープシーケンスが設定されているとき、このオプションの
値は Vim の起動時に自動的に設定される。
*'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") で確認できる}
これがオンであるとファイルを開くとき、バッファを切り替えるとき、バッファ
を削除するとき、ウィンドウを開閉するときに毎回作業ディレクトリが変更さ
れる。開かれた／選択されたファイルを含んでいるディレクトリがカレント
ディレクトリになる。
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' 切替 (既定ではオフ)
バッファについてローカル
新しい行を開始したとき (挿入モードで <CR> を打ち込むか、コマンド "o"
や "O" を使ったとき)、新しい行のインデントを現在行と同じくする。新しい
行で <BS> か CTRL-D 以外を打ち込まずに <Esc>、CTRL-O か <CR> を打ち込
むと、その行のインデントは削除される。'cpoptions' にフラグ 'I' が入っ
ていないかぎり、カーソルを他の行に移動させても同様である。
オプション 'autoindent' がオンのときは、テキストの整形処理 (コマンド
"gq" を使ったり、挿入モードで 1行の文字数がオプション 'textwidth' で指
定した数に届いたとき) には最初の行のインデントが使われる。
オプション 'smartindent' かオプション 'cindent' がオンのときは、インデ
ントの方法は違ってくる。
オプション 'autoindent' はオプション 'paste' がセットされたらリセット
され、オプション 'paste' がリセットされたら復元される。
{Vi との微妙な違い: <Esc> または <CR> を打ち込んでインデントが削除され
た後、上下に移動した後のカーソル位置は削除されたインデントの後ろになる。
Viでは削除されたインデントの中のどこかになる}
*'autoread'* *'ar'* *'noautoread'* *'noar'*
'autoread' 'ar' 切替 (既定ではオフ)
グローバル／バッファについてローカル |global-local|
{Vi にはない}
ファイルがVimの内部では変更されてないが、Vimの外部で変更されたことが判
明したとき、自動的に読み直す。ファイルが削除されたときにはこのようには
ならない。 |timestamp|
このオプションがローカルな値を持つとき、再びグローバルな値を使うように
するには次のようにする。 >
:set autoread<
<
*'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' を次のようにして既定値に戻したとき、 >
:set 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 内で設定される。おそらく、設定はターミナ
ルの名前に依存する。例: >
:if &term == "pcterm"
: set background=dark
:endif
< このオプションが設定されると、強調表示の既定の設定が変更される。他の設
定を使いたいなら、'background' を設定した「後」にコマンド ":highlight"
を置くこと。
このオプションはファイル "$VIMRUNTIME/syntax/syntax.vim" 内でも、構文
強調表示のための色を選択するのに使われる。このオプションを設定した後は
syntax.vim を再読み込みしないと結果が分からない。これにはコマンド
":syntax on" を実行すればよい。
*'backspace'* *'bs'*
'backspace' 'bs' 文字列 (既定では ""、|defaults.vim| 内で
"indent,eol,start" にセットされる)
グローバル
{Vi にはない}
挿入モードでの <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")
グローバル／バッファについてローカル |global-local|
{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~