Merge pull request #278 from mnishz/starting_for_Vim_8.1

Update starting from Vim 8.0 to 8.1

Author: k-takata

doc/starting.jax

@@ -1,4 +1,4 @@
-*starting.txt*  For Vim バージョン 8.0.  Last change: 2017 Jul 15
+*starting.txt*  For Vim バージョン 8.1.  Last change: 2018 May 05
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -53,13 +53,14 @@ filename	1つ以上のファイル名が与えられた場合。まずは最初
 		ノーマルモードで起動する場合: >
 			vim -
 			ex -v -
-<		新しいバッファに、標準入力を読み込んで編集を始める。このコマン
-		ドを使用するとまず標準入力を読み込み、それから標準エラー出力を
-		読み込む。例: >
+<		新しいバッファに、標準入力を読み込んで編集を始める。コマンドは
+		通常であれば標準入力から読み込まれるが、この場合代わりに標準エ
+		ラー出力から読み込まれる。例: >
 			find . -name "*.c" -print | vim -
-<		バッファには未保存のテキストが含まれるので、「変更(modified)」
-		のマークがつけられる。ただし読み込み専用モードで起動する場合は
-		除く。例: >
+<		{訳注: 以下の文はすべて "view -" に対する説明と思われる。}
+		簡単に終了できるよう、バッファに「変更(modified)」のマークは付
+		けられない。バッファの内容を思いがけず失いたくない場合は、変更
+		とマークするよう気を付けること。例: >
 			ls | view -
 <
 		Exモードで起動する場合: >
@@ -124,7 +125,8 @@ UNIXでは通常、Vimという名前の実行可能ファイルが一つあり
 VMSでは全てのオプション引数は小文字であるとみなされる。大文字を指定するにはス
 ラッシュを前に置く。つまり "-R" でリカバリモード、"-/R" で読み込み専用となる。
 
---help							*-h* *--help*
+--help							*-h* *--help* *-?*
+-?
 -h		使用法(ヘルプ)を表示して終了する。{Vi にはない}
 		そのテキストを保存するには|info-message|を参照。
 
@@ -419,7 +421,9 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 							*--not-a-term*
 --not-a-term	入力と出力(もしくはどちらか一方)が端末に接続されていないと、
 		ユーザーが知っていることをVimに伝える。これにより警告が表示さ
-		れ2秒間の遅延が発生するのを避けられる。{Vi にはない}
+		れ2秒間の遅延が発生するのを避けられる。
+		"Reading from stdin..." のメッセージを避けることもできる。
+		{Vi にはない}
 
 							*--ttyfail*
 --ttyfail	標準入力か標準出力が端末(tty)でない場合、すぐに終了する。
@@ -499,11 +503,13 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 		{Vi にはない}
 
 							*--clean*
---clean		"-u DEFAULTS -i NONE" と同じ:
+--clean		"-u DEFAULTS -U NONE -i NONE" と同じ:
 		- ファイルや環境変数からの初期化はスキップされる。
 		- |defaults.vim| スクリプトが読み込まれる。これは
 		  'nocompatible' を含む: Vim のデフォルトを使う。
+		- |gvimrc| スクリプトは読み込まれない。
 		- viminfo ファイルは読み書きされない。
+		- ホームディレクトリは 'runtimepath' から除外される。
 							*-x*
 -x		ファイルの読み書き時に暗号化を施す。暗号の鍵としてオプション
 		'key' に設定された値を使用する。全ての書き込みは、テキストに対
@@ -851,6 +857,9 @@ Evimでは以下のオプションが標準設定から変更される:
      (*) このファイルを使用するか環境変数を使用した場合、自動的に 'compatible'
 	 オプションがオフに設定される。|compatible-default|を参照。
 
+     Note: |mzscheme| インターフェイスを使用する場合は、vimrc ファイルの読み込
+     みの後に初期化される。それより後に 'mzschemedll' を変更しても効果はない。
+
 4. プラグインスクリプトを読み込む				*load-plugins*
 	次のコマンドと同じことを実行する: >
 		:runtime! plugin/**/*.vim
@@ -979,7 +988,6 @@ Vim が起動すると、オプション 'compatible' がオンに設定され
 - 環境変数 "VIMINIT" が設定されている
 - 起動引数 "-N" が指定されている
 - 起動引数 "--clean" が指定されている
-  これは vimrc ファイルが無くても機能する
 - |defaults.vim| がロードされる
 - gvimrc が見つかる
 
@@ -1004,10 +1012,10 @@ Vim 起動時に 'compatible' の値に起こるのと同様の作用となる
 .vimrc ファイルが無い際のデフォルト ~
 							*defaults.vim*
 Vim を普通に起動してユーザー vimrc ファイルが見つからない場合には、
-$VIMRUTIME/defaults.vim スクリプトが読みこまれる。このスクリプトは'compatible'
-をオフにし、シンタックスハイライトを有効にする他、幾つかのことを実施する。詳細
-はそのスクリプトを参照せよ。NOTE: これは正確には Vim 8.0 からではなく 7.4.2111
-から導入された。
+$VIMRUNTIME/defaults.vim スクリプトが読みこまれる。このスクリプトは
+'compatible' をオフにし、シンタックスハイライトを有効にする他、幾つかのことを
+実施する。詳細はそのスクリプトを参照せよ。NOTE: これは正確には Vim 8.0 からで
+はなく 7.4.2111 から導入された。
 
 これはVimの新規ユーザーにとって良く機能する。自分で .vimrc を作る際には、その
 最上部のほうに以下の2行を追加することが推奨される: >
@@ -1383,7 +1391,7 @@ Note: .vimrcファイルを作成するときにはオプション 'compatible'
 5. ファイルにおけるカーソルとスクロールの位置を復元する。閉じた折畳みがあると
    うまく機能しない。
 6. ローカルなカレントディレクトリを復元する。グローバルなカレントディレクトリ
-   と違っている場合のみ。
+   と違っている場合、かつ 'viewoptions' が "curdir" を含んでいる場合のみ。
 {訳注: |current-directory|}
 
 Note: ビューとセッションは完璧ではない:
@@ -1493,12 +1501,13 @@ Note: Unixにおける注意点:
 - viminfoファイルには入力したテキストや、使用したコマンドが記載されているの
   で、他人に覗かれないように保護(パーミッション設定)したほうが良い。
 - 複数のユーザーでviminfoファイルを共有したい時(例えば他のユーザーへ "su" する
-  時など)には、グループもしくは全員にviminfoファイルへの書き込み権限を与える。
-  Vimが新しくviminfoファイルを保存するときに、その設定を維持する。しかし、誰に
-  でもviminfoファイルを読ませたり書かせたりすべきではないし、注意が必要。
+  時など)には、グループもしくは全員にviminfoファイルへの書き込み権限を与えるこ
+  とができる。Vimはそのviminfoファイルを置き換えるときに権限を維持する。しか
+  し、あなたのviminfoファイルを誰にでも読ませたり書かせたりしないように注意す
+  ること！
 - 現在の "本当" のユーザーによって書き込み不能なviminfoファイルは、Vimは決して
   上書きしない。これは "su" でrootユーザーになった時、しかし$HOMEがまだ通常ユー
-  ザーのホームディレクトリのままの時の支援となる。そうでないとVimはroot所有の、
+  ザーのホームディレクトリのままの時の助けとなる。そうでないとVimはroot所有の、
   他の誰にも読めないviminfoファイルを作成してしまう。
 - viminfo ファイルはシンボリックリンクであってはならない。セキュリティ上の問題
   を避けるためである。

en/starting.txt

@@ -1,4 +1,4 @@
-*starting.txt*  For Vim version 8.0.  Last change: 2017 Jul 15
+*starting.txt*  For Vim version 8.1.  Last change: 2018 May 05
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -58,9 +58,9 @@ filename	One or more file names.  The first one will be the current
 		that is read from stdin.  The commands that would normally be
 		read from stdin will now be read from stderr.  Example: >
 			find . -name "*.c" -print | vim -
-<		The buffer will be marked modified, because it contains text
-		that needs to be saved.  Except when in readonly mode, then
-		the buffer is not marked modified.  Example: >
+<		The buffer will not be marked as modified, so that it's easy
+		to exit.  Be careful to mark it as modified if you don't want
+		to accidentally lose it.  Example: >
 			ls | view -
 <
 		Starting in Ex mode: >
@@ -127,7 +127,8 @@ argument.
 On VMS all option arguments are assumed to be lowercase, unless preceded with
 a slash.  Thus "-R" means recovery and "-/R" readonly.
 
---help							*-h* *--help*
+--help							*-h* *--help* *-?*
+-?
 -h		Give usage (help) message and exit.  {not in Vi}
 		See |info-message| about capturing the text.
 
@@ -421,7 +422,9 @@ a slash.  Thus "-R" means recovery and "-/R" readonly.
 							*--not-a-term*
 --not-a-term	Tells Vim that the user knows that the input and/or output is
 		not connected to a terminal.  This will avoid the warning and
-		the two second delay that would happen. {not in Vi}
+		the two second delay that would happen.
+		Also avoids the "Reading from stdin..." message.
+		{not in Vi}
 
 							*--ttyfail*
 --ttyfail	When the stdin or stdout is not a terminal (tty) then exit
@@ -508,12 +511,14 @@ a slash.  Thus "-R" means recovery and "-/R" readonly.
 		{not in Vi}
 
 							*--clean*
---clean		Equal to "-u DEFAULTS -i NONE":
+--clean		Equal to "-u DEFAULTS -U NONE -i NONE":
 		- initializations from files and environment variables is
 		  skipped
 		- the |defaults.vim| script is loaded, which implies
 		  'nocompatible': use Vim defaults
+		- no |gvimrc| script is loaded
 		- no viminfo file is read or written
+		- the home directory is excluded from 'runtimepath'
 							*-x*
 -x		Use encryption to read/write files.  Will prompt for a key,
 		which is then stored in the 'key' option.  All writes will
@@ -873,6 +878,9 @@ accordingly.  Vim proceeds in this order:
      (*) Using this file or environment variable will cause 'compatible' to be
 	 off by default.  See |compatible-default|.
 
+     Note: When using the |mzscheme| interface, it is initialized after loading
+     the vimrc file.  Changing 'mzschemedll' later has no effect.
+
 4. Load the plugin scripts.					*load-plugins*
 	This does the same as the command: >
 		:runtime! plugin/**/*.vim
@@ -1005,14 +1013,13 @@ Vi compatible default value ~
 When Vim starts, the 'compatible' option is on.  This will be used when Vim
 starts its initializations.  But as soon as:
 - a user vimrc file is found, or
-- a vimrc file in the current directory, or
+- a vimrc file in the current directory is found, or
 - the "VIMINIT" environment variable is set, or
 - the "-N" command line argument is given, or
 - the "--clean" command line argument is given, or
-  even when no vimrc file exists.
 - the |defaults.vim| script is loaded, or
-- gvimrc file was found,
-then it will be set to 'nocompatible'.
+- a gvimrc file was found,
+then the option will be set to 'nocompatible'.
 
 Note that this does NOT happen when a system-wide vimrc file was found.
 
@@ -1038,13 +1045,13 @@ giving the mapping.
 Defaults without a .vimrc file ~
 							*defaults.vim*
 If Vim is started normally and no user vimrc file is found, the
-$VIMRUTIME/defaults.vim script is loaded.  This will set 'compatible' off,
+$VIMRUNTIME/defaults.vim script is loaded.  This will set 'compatible' off,
 switch on syntax highlighting and a few more things.  See the script for
 details.  NOTE: this is done since Vim 8.0, not in Vim 7.4. (it was added in
 patch 7.4.2111 to be exact).
 
 This should work well for new Vim users.  If you create your own .vimrc, it is
-recommended to add this line somewhere near the top: >
+recommended to add these lines somewhere near the top: >
 	unlet! skip_defaults_vim
 	source $VIMRUNTIME/defaults.vim
 Then Vim works like before you had a .vimrc. Copying $VIMRUNTIME/vimrc_example
@@ -1415,7 +1422,7 @@ The output of ":mkview" contains these items:
 5. The scroll position and the cursor position in the file.  Doesn't work very
    well when there are closed folds.
 6. The local current directory, if it is different from the global current
-   directory.
+   directory and 'viewoptions' contains "curdir".
 
 Note that Views and Sessions are not perfect:
 - They don't restore everything.  For example, defined functions, autocommands
@@ -1527,7 +1534,7 @@ Notes for Unix:
   you have worked with.
 - If you want to share the viminfo file with other users (e.g. when you "su"
   to another user), you can make the file writable for the group or everybody.
-  Vim will preserve this when writing new viminfo files.  Be careful, don't
+  Vim will preserve this when replacing the viminfo file.  Be careful, don't
   allow just anybody to read and write your viminfo file!
 - Vim will not overwrite a viminfo file that is not writable by the current
   "real" user.  This helps for when you did "su" to become root, but your