Skip to content

Commit 375d86d

Browse files
h-easth-east
authored
Merge pull request #1505 from vim-jp/hh-update-starting
Update starting.{txt,jax}
2 parents 8cea0e6 + d4c2cc1 commit 375d86d

File tree

2 files changed

+129
-51
lines changed

2 files changed

+129
-51
lines changed

‎doc/starting.jax

Lines changed: 64 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*starting.txt* For Vim バージョン 9.1. Last change: 2024 Mar 13
1+
*starting.txt* For Vim バージョン 9.1. Last change: 2024 May 02
22

33

44
VIMリファレンスマニュアル by Bram Moolenaar
@@ -92,21 +92,21 @@ filename 1つ以上のファイル名が与えられた場合。まずは最初
9292

9393
起動時のモードはプログラム名を "vim" とは別の名前にすることで指定できる。それ
9494
は次のようにオプションを与えたのと同じである:
95-
ex vim -e Exモードで起動 (|Ex-mode|を参照)。 *ex*
96-
exim vim -E 改良版Exモードで起動 (|Ex-mode|を参照)。 *exim*
97-
(通常はインストールされない)
98-
view vim -R 読み込み専用モードで起動 (|-R|を参照)。 *view*
99-
gvim vim -g GUIで起動 (|gui|を参照)。 *gvim*
100-
gex vim -eg GUIのEXモードで起動。 *gex*
101-
gview vim -Rg GUIの読み込み専用モードで起動。 *gview*
102-
rvim vim -Z "vim" の制限モードで起動 (|-Z|を参照)。 *rvim*
103-
rview vim -RZ "view" の制限モード。 *rview*
104-
rgvim vim -gZ "gvim" の制限モード。 *rgvim*
105-
rgview vim -RgZ "gview" の制限モード。 *rgview*
106-
evim vim -y 簡易操作のVim (|-y|を参照) *evim*
107-
eview vim -yR "evim" と同じ。読み込み専用モード。 *eview*
108-
vimdiff vim -d 差分モードで起動|diff-mode|
109-
gvimdiff vim -gd 差分モードで起動|diff-mode|
95+
ex vim -e Exモードで起動 (|Ex-mode| を参照)。 *ex*
96+
exim vim -E 改良版Exモードで起動 (|Ex-mode| を参照)。 *exim*
97+
(通常はインストールされない)
98+
view vim -R 読み込み専用モードで起動 (|-R| を参照)。 *view*
99+
gvim vim -g GUIで起動 (|gui| を参照)。 *gvim*
100+
gex vim -eg GUIのEXモードで起動。 *gex*
101+
gview vim -Rg GUIの読み込み専用モードで起動。 *gview*
102+
rvim vim -Z "vim" の制限モードで起動 (|-Z| を参照)。 *rvim*
103+
rview vim -RZ "view" の制限モード。 *rview*
104+
rgvim vim -gZ "gvim" の制限モード。 *rgvim*
105+
rgview vim -RgZ "gview" の制限モード。 *rgview*
106+
evim vim -y 簡易操作のVim: set 'insertmode' (|-y| を参照) *evim*
107+
eview vim -yR "evim" と同じ。読み込み専用モード。 *eview*
108+
vimdiff vim -d 差分モードで起動 |diff-mode|
109+
gvimdiff vim -gd 差分モードで起動 |diff-mode|
110110

111111
これらの別名の後ろに付けられる文字は無視される。例えばGUIで起動するのに
112112
"gvim-8" という名前を付けることができる。もちろんその名前で実行可能なファイル
@@ -790,7 +790,8 @@ Evimでは以下のオプションが標準設定から変更される:
790790
して、"vimrc" はVim特有のものである。|vimrc-intro|も参照。
791791

792792
個人の初期化ファイルの配置場所:
793-
Unix $HOME/.vimrc、$HOME/.vim/vimrc
793+
Unix $HOME/.vimrc、$HOME/.vim/vimrc、
794+
$XDG_CONFIG_HOME/vim/vimrc
794795
MS-Windows $HOME/_vimrc、$HOME/vimfiles/vimrc、
795796
$VIM/_vimrc
796797
Amiga s:.vimrc、home:.vimrc、home:vimfiles:vimrc、
@@ -833,15 +834,16 @@ Evimでは以下のオプションが標準設定から変更される:
833834
I 環境変数VIMINIT(|compatible-default|も参照) (*)
834835
その内容はExコマンドとして解釈される。
835836
II ユーザーvimrcファイル:
836-
"$HOME/.vimrc" (for Unix) (*)
837-
"$HOME/.vim/vimrc" (for Unix) (*)
838-
"s:.vimrc" (for Amiga) (*)
839-
"home:.vimrc" (for Amiga) (*)
840-
"home:vimfiles:vimrc" (for Amiga) (*)
841-
"$VIM/.vimrc" (for Amiga) (*)
842-
"$HOME/_vimrc" (for Win32) (*)
843-
"$HOME/vimfiles/vimrc" (for Win32) (*)
844-
"$VIM/_vimrc" (for Win32) (*)
837+
"$HOME/.vimrc" (for Unix) (*)
838+
"$HOME/.vim/vimrc" (for Unix) (*)
839+
"$HOME/.config/vim/vimrc" (for Unix) (*)
840+
"s:.vimrc" (for Amiga) (*)
841+
"home:.vimrc" (for Amiga) (*)
842+
"home:vimfiles:vimrc" (for Amiga) (*)
843+
"$VIM/.vimrc" (for Amiga) (*)
844+
"$HOME/_vimrc" (for Win32) (*)
845+
"$HOME/vimfiles/vimrc" (for Win32) (*)
846+
"$VIM/_vimrc" (for Win32) (*)
845847
"$HOME/config/settings/vim/vimrc" (for Haiku) (*)
846848

847849
Note: UnixとAmigaでは、".vimrc" がなかった場合には、MS-DOS互換
@@ -1053,6 +1055,42 @@ defaults.vim を読み込みたい場合には、上で示した例のように
10531055
skip_defaults_vim を行うと良い。
10541056

10551057

1058+
*xdg-base-dir* *$XDG_CONFIG_HOME*
1059+
XDG ベースディレクトリ仕様 ~
1060+
1061+
XDG ベースディレクトリ仕様は、アプリケーションで使用される構成ファイルの標準的
1062+
な場所を定義することを目的としている。これは主に、ユーザーのホームディレクトリ
1063+
にすべてをダンプする従来の動作を防ぐために行われる。仕様は以下からオンラインで
1064+
参照できる。
1065+
https://specations.freedesktop.org/basedir-spec/latest/
1066+
1067+
この標準構成ディレクトリの場所は、環境変数を使用してユーザーが構成できるが、こ
1068+
れらの変数が設定されていない場合に備えてフォールバックも提供する必要がある。
1069+
1070+
これは、これらのディレクトリの完全な一覧ではない:
1071+
環境変数 デフォルトの場所 説明 ~
1072+
`$XDG_CACHE_HOME` $HOME/.cache 一時的なデータファイル群
1073+
`$XDG_CONFIG_HOME` $HOME/.config 設定ファイル群
1074+
`$XDG_DATA_HOME` $HOME/.local/share 永続的なデータファイル群
1075+
`$XDG_STATE_HOME` $HOME/.local/state 状態データファイル群
1076+
1077+
Vim は `$XDG_CONFIG_HOME` ディレクトリのみを使用し、その他のディレクトリは (ま
1078+
だ) さまざまな設定ファイルや状態ファイルに使用されない。
1079+
1080+
*xdg-vimrc*
1081+
Unix システムの Vim は、その構成について `$XDG_CONFIG_HOME/vim/vimrc` を参照す
1082+
る (|vimrc| を参照) が、他の初期化ファイルが `$HOME` または `$HOME/.vim` に見
1083+
つからない場合にのみそれを取得する (したがって、この機能は後方互換性がある)。
1084+
但し、`$XDG_CONFIG_HOME/vim/` ディレクトリを使用するように移行する場合は、
1085+
`~/.vimrc` および `~/.vim/vimrc` ファイルを移動する必要がある。
1086+
1087+
*xdg-runtime*
1088+
|xdg-vimrc| が使用される場合、'runtimepath' および 'packpath' オプションはそれ
1089+
に応じて変更され、|xdg-base-dir| を尊重する: >
1090+
1091+
"$XDG_CONFIG_HOME/vim,$VIMRUNTIME,/after,$XDG_CONFIG_HOME/vim/after"
1092+
<
1093+
10561094
トロイの木馬を回避する ~
10571095
*trojan-horse*
10581096
現在のディレクトリにある "vimrc" や "exrc" を読み込むときに、'secure' オプショ

‎en/starting.txt

Lines changed: 65 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*starting.txt* For Vim version 9.1. Last change: 2024 Mar 13
1+
*starting.txt* For Vim version 9.1. Last change: 2024 May 02
22

33

44
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -93,20 +93,20 @@ filename One or more file names. The first one will be the current
9393

9494
The startup mode can be changed by using another name instead of "vim", which
9595
is equal to giving options:
96-
ex vim -e Start in Ex mode (see |Ex-mode|). *ex*
97-
exim vim -E Start in improved Ex mode (see |Ex-mode|). *exim*
98-
(normally not installed)
99-
view vim -R Start in read-only mode (see |-R|). *view*
100-
gvim vim -g Start the GUI (see |gui|). *gvim*
101-
gex vim -eg Start the GUI in Ex mode. *gex*
102-
gview vim -Rg Start the GUI in read-only mode. *gview*
103-
rvim vim -Z Like "vim", but in restricted mode (see |-Z|) *rvim*
104-
rview vim -RZ Like "view", but in restricted mode. *rview*
105-
rgvim vim -gZ Like "gvim", but in restricted mode. *rgvim*
106-
rgview vim -RgZ Like "gview", but in restricted mode. *rgview*
107-
evim vim -y Easy Vim: set 'insertmode' (see |-y|) *evim*
108-
eview vim -yR Like "evim" in read-only mode *eview*
109-
vimdiff vim -d Start in diff mode |diff-mode|
96+
ex vim -e Start in Ex mode (see |Ex-mode|). *ex*
97+
exim vim -E Start in improved Ex mode (see |Ex-mode|). *exim*
98+
(normally not installed)
99+
view vim -R Start in read-only mode (see |-R|). *view*
100+
gvim vim -g Start the GUI (see |gui|). *gvim*
101+
gex vim -eg Start the GUI in Ex mode. *gex*
102+
gview vim -Rg Start the GUI in read-only mode. *gview*
103+
rvim vim -Z Like "vim", but in restricted mode (see |-Z|) *rvim*
104+
rview vim -RZ Like "view", but in restricted mode. *rview*
105+
rgvim vim -gZ Like "gvim", but in restricted mode. *rgvim*
106+
rgview vim -RgZ Like "gview", but in restricted mode. *rgview*
107+
evim vim -y Easy Vim: set 'insertmode' (see |-y|) *evim*
108+
eview vim -yR Like "evim" in read-only mode *eview*
109+
vimdiff vim -d Start in diff mode |diff-mode|
110110
gvimdiff vim -gd Start in diff mode |diff-mode|
111111

112112
Additional characters may follow, they are ignored. For example, you can have
@@ -811,7 +811,8 @@ accordingly. Vim proceeds in this order:
811811
name. Also see |vimrc-intro|.
812812

813813
Places for your personal initializations:
814-
Unix $HOME/.vimrc or $HOME/.vim/vimrc
814+
Unix $HOME/.vimrc, $HOME/.vim/vimrc
815+
or $XDG_CONFIG_HOME/vim/vimrc
815816
MS-Windows $HOME/_vimrc, $HOME/vimfiles/vimrc
816817
or $VIM/_vimrc
817818
Amiga s:.vimrc, home:.vimrc, home:vimfiles:vimrc
@@ -853,15 +854,16 @@ accordingly. Vim proceeds in this order:
853854
I The environment variable VIMINIT (see also |compatible-default|) (*)
854855
The value of $VIMINIT is used as an Ex command line.
855856
II The user vimrc file(s):
856-
"$HOME/.vimrc" (for Unix) (*)
857-
"$HOME/.vim/vimrc" (for Unix) (*)
858-
"s:.vimrc" (for Amiga) (*)
859-
"home:.vimrc" (for Amiga) (*)
860-
"home:vimfiles:vimrc" (for Amiga) (*)
861-
"$VIM/.vimrc" (for Amiga) (*)
862-
"$HOME/_vimrc" (for Win32) (*)
863-
"$HOME/vimfiles/vimrc" (for Win32) (*)
864-
"$VIM/_vimrc" (for Win32) (*)
857+
"$HOME/.vimrc" (for Unix) (*)
858+
"$HOME/.vim/vimrc" (for Unix) (*)
859+
"$HOME/.config/vim/vimrc" (for Unix) (*)
860+
"s:.vimrc" (for Amiga) (*)
861+
"home:.vimrc" (for Amiga) (*)
862+
"home:vimfiles:vimrc" (for Amiga) (*)
863+
"$VIM/.vimrc" (for Amiga) (*)
864+
"$HOME/_vimrc" (for Win32) (*)
865+
"$HOME/vimfiles/vimrc" (for Win32) (*)
866+
"$VIM/_vimrc" (for Win32) (*)
865867
"$HOME/config/settings/vim/vimrc" (for Haiku) (*)
866868

867869
Note: For Unix and Amiga, when ".vimrc" does not exist,
@@ -1085,6 +1087,44 @@ defaults.vim from your .vimrc, first unlet skip_defaults_vim, as in the
10851087
example above.
10861088

10871089

1090+
*xdg-base-dir* *$XDG_CONFIG_HOME*
1091+
XDG Base Directory Specification ~
1092+
1093+
The XDG Base Directory Specification aims to define a standard location for
1094+
configuration files used by applications. This is mainly done to prevent
1095+
the legacy behavior of dumping everything into the user's home directory.
1096+
The specification can be found online at
1097+
https://specifications.freedesktop.org/basedir-spec/latest/
1098+
1099+
The location of this standard configuration directory is configurable by the
1100+
user, using an environment variable but should also give fallback in case those
1101+
variables weren't set.
1102+
1103+
This is not an exhaustive list of those directories:
1104+
Environment var Default location Description ~
1105+
`$XDG_CACHE_HOME` $HOME/.cache Ephemeral data files
1106+
`$XDG_CONFIG_HOME` $HOME/.config Configuration files
1107+
`$XDG_DATA_HOME` $HOME/.local/share Persistent data files
1108+
`$XDG_STATE_HOME` $HOME/.local/state State data files
1109+
1110+
Vim will only use the `$XDG_CONFIG_HOME` directory, the others are not
1111+
(yet) used for its various configuration and state files.
1112+
1113+
*xdg-vimrc*
1114+
Vim, on Unix systems, will look at `$XDG_CONFIG_HOME/vim/vimrc` for its
1115+
configuration (see |vimrc|) but it will source it only if no other
1116+
initialization file is found in `$HOME` or `$HOME/.vim` (thus making this
1117+
feature backward compatible). However, if you want to migrate to use
1118+
`$XDG_CONFIG_HOME/vim/` directory, you will have to move away your `~/.vimrc`
1119+
and `~/.vim/vimrc` file.
1120+
1121+
*xdg-runtime*
1122+
When the |xdg-vimrc| is used the 'runtimepath' and 'packpath' options will be
1123+
modified accordingly to respect the |xdg-base-dir|: >
1124+
1125+
"$XDG_CONFIG_HOME/vim,$VIMRUNTIME,/after,$XDG_CONFIG_HOME/vim/after"
1126+
<
1127+
10881128
Avoiding trojan horses ~
10891129
*trojan-horse*
10901130
While reading the "vimrc" or the "exrc" file in the current directory, some

0 commit comments

Comments
 (0)