Merge pull request #251 from mnishz/editing_for_Vim_8.1

Update editing from Vim 8.0 to 8.1

Author: h-east

doc/editing.jax

@@ -1,4 +1,4 @@
-*editing.txt*   For Vim バージョン 8.0.  Last change: 2017 Aug 21
+*editing.txt*   For Vim バージョン 8.1.  Last change: 2018 Mar 29
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -419,6 +419,14 @@ Note "/inc" とマッチする必要がないため、"/sys" を含むパスが
 Unix などではファイル名の引数にバッククォート '`' も使える。例: >
 	:next `find . -name ver\\*.c -print`
 	:view `ls -t *.patch  \| head -n1`
+Vim はバッククォート内のコマンドをシェルで実行し、その標準出力を Vim コマンド
+の引数とする。(シェルからのエラーメッセージは破棄される。)
+Vim が何のシェルコマンドを実行しているか確認するためには、'verbose' オプション
+に 4 を設定する。シェルコマンドが 0 以外の終了コードを返した場合、エラーメッ
+セージが表示され Vim コマンドは中断される。これを防ぐためには、次のようにして
+シェルが常に 0 を返すようにする。 >
+	:next `find . -name ver\\*.c -print \|\| true`
+
 アスタリスク '*' の前の '\' は、シェルが find を実行する前に "ver*.c" を展開し
 てしまうのを防ぐために必要となる。シェルのパイプ記号 "|" の前のバックスラッシ
 ュは Vim がコマンドの終わりとしてパースするのを防ぐ。
@@ -640,8 +648,7 @@ Vim の開始時に複数のファイル名を与えると、それらは引数
 			重複検査はないので、1個のファイルを引数リストに2回加え
 			ることもできる。
 			現在編集中のファイルは変更されない。
-			{Vi にはない} {Vimが |+listcmds| 機能付きでコンパイル
-			されたときのみ有効}
+			{Vi にはない}
 			Note 次の方法が使えることに注意。 >
 				:args ## x
 <			これは項目 "x" を追加し、新たなリストを並び替える。
@@ -655,8 +662,7 @@ Vim の開始時に複数のファイル名を与えると、それらは引数
 			されたときでも、それをそのままに保つ。
 			例: >
 				:argdel *.obj
-<			{Vi にはない} {Vimが |+listcmds| 機能付きでコンパイル
-			されたときのみ有効}
+<			{Vi にはない}
 
 :[range]argd[elete]	引数リストから {range} の範囲のファイルを削除する。
 			例: >
@@ -671,8 +677,7 @@ Vim の開始時に複数のファイル名を与えると、それらは引数
 <			引数リストから全てのファイルを削除する。
 			範囲の上限が大きすぎるときは、最後の引数までが削除され
 			る。
-			{Vi にはない} {Vimが |+listcmds| 機能付きでコンパイル
-			されたときのみ有効}
+			{Vi にはない}
 
 							*:argu* *:argument*
 :[count]argu[ment] [count] [++opt] [+cmd]
@@ -681,16 +686,14 @@ Vim の開始時に複数のファイル名を与えると、それらは引数
 			Vimがカレントバッファを放棄 |abandon| したくないときに
 			は失敗する。
 			|++opt| と |+cmd| も参照。
-			{Vi にはない} {Vimが |+listcmds| 機能付きでコンパイル
-			されたときのみ有効}
+			{Vi にはない}
 
 :[count]argu[ment]! [count] [++opt] [+cmd]
 			引数リスト内で [count] 番目のファイルを編集する。カレ
 			ントバッファに対するいかなる変更も失われる。[count] が
 			省かれると現在の項目を編集する。
 			|++opt| と |+cmd| も参照。
-			{Vi にはない} {Vimが |+listcmds| 機能付きでコンパイル
-			されたときのみ有効}
+			{Vi にはない}
 
 :[count]n[ext] [++opt] [+cmd]			*:n* *:ne* *:next* *E165* *E163*
 			引数リストの中で [count] 個次のファイルを編集する。
@@ -817,7 +820,6 @@ Unix およびその他いくつかのシステムではバッククォートも
 ローカルな引数リスト
 
 {Vi にはない}
-{Vimが |+windows| 機能と |+listcmds| 機能付きでコンパイルされたときのみ有効}
 
 							*:arglocal*
 :argl[ocal]		グローバルな引数リストのローカルなコピーを作る。
@@ -870,8 +872,7 @@ Unix およびその他いくつかのシステムではバッククォートも
 			でオートコマンドのイベント Syntax を指定することでそれ
 			を無効化できる。こうすると各ファイルの処理がかなり高速
 			になる。
-			{Vi にはない} {Vimが |+listcmds| 機能付きでコンパイル
-			されたときのみ有効}
+			{Vi にはない}
 			|:windo|、|:tabdo|、|:bufdo|、|:cdo|、|:ldo|、|:cfdo|、
 			|:lfdo|も参照。
 
@@ -896,7 +897,7 @@ Note: オプション 'write' がオフのときは、どのファイルも書
 
 							*:w* *:write*
 						*E502* *E503* *E504* *E505*
-						*E512* *E514* *E667* *E796*
+						*E512* *E514* *E667* *E796* *E949*
 :w[rite] [++opt]	バッファ全体をカレントファイルに書き込む。これはファイ
 			ルに対する変更点を保存するときの普通の方法である。
 			オプション 'readonly' がオンであるかファイルに書き込め
@@ -947,6 +948,9 @@ Note: オプション 'write' がオフのときは、どのファイルも書
 に失敗した後に ":w #" でもう一度試したいときに使える。オプション'cpoptions' か
 らフラグ 'A' を取り除くとこれを無効化できる。
 
+Note: 書き込みには 'fsync' オプションが関係してくる。設定されている場合には書
+き込みがより遅くなるかもしれない。(しかしより安全である。)
+
 							*:sav* *:saveas*
 :sav[eas][!] [++opt] {file}
 			カレントファイルをファイル名 {file} として保存し、カレ
@@ -1190,7 +1194,8 @@ ZQ			変更点を確かめずに終了する (コマンド ":q!" と同様)。
 :wqa[ll]! [++opt]
 :xa[ll]!	変更点のあるバッファを、読込専用であっても全て書き込み、Vimを
 		終了する。ファイル名のないバッファや何らかの理由で書き込めない
-		バッファがあるときは、Vimを終了しない。 {Vi にはない}
+		バッファ、またはジョブが実行中の端末があるときは、Vimを終了し
+		ない。 {Vi にはない}
 
 ==============================================================================
 6. ダイアログ						*edit-dialogs*

en/editing.txt

@@ -1,4 +1,4 @@
-*editing.txt*   For Vim version 8.0.  Last change: 2017 Aug 21
+*editing.txt*   For Vim version 8.1.  Last change: 2018 Mar 29
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -424,6 +424,15 @@ On Unix and a few other systems you can also use backticks for the file name
 argument, for example: >
 	:next `find . -name ver\\*.c -print`
 	:view `ls -t *.patch  \| head -n1`
+Vim will run the command in backticks using the 'shell' and use the standard
+output as argument for the given Vim command (error messages from the shell
+command will be discarded).
+To see what shell command Vim is running, set the 'verbose' option to 4. When
+the shell command returns a non-zero exit code, an error message will be
+displayed and the Vim command will be aborted. To avoid this make the shell
+always return zero like so: >
+       :next `find . -name ver\\*.c -print \|\| true`
+
 The backslashes before the star are required to prevent the shell from
 expanding "ver*.c" prior to execution of the find program.  The backslash
 before the shell pipe symbol "|" prevents Vim from parsing it as command
@@ -650,8 +659,7 @@ list of the current window.
 			There is no check for duplicates, it is possible to
 			add a file to the argument list twice.
 			The currently edited file is not changed.
-			{not in Vi} {not available when compiled without the
-			|+listcmds| feature}
+			{not in Vi}
 			Note: you can also use this method: >
 				:args ## x
 <			This will add the "x" item and sort the new list.
@@ -665,8 +673,7 @@ list of the current window.
 			when it's deleted from the argument list.
 			Example: >
 				:argdel *.obj
-<			{not in Vi} {not available when compiled without the
-			|+listcmds| feature}
+<			{not in Vi}
 
 :[range]argd[elete]	Delete the {range} files from the argument list.
 			Example: >
@@ -681,8 +688,7 @@ list of the current window.
 <			Removes all the files from the arglist.
 			When the last number in the range is too high, up to
 			the last argument is deleted.
-			{not in Vi} {not available when compiled without the
-			|+listcmds| feature}
+			{not in Vi}
 
 							*:argu* *:argument*
 :[count]argu[ment] [count] [++opt] [+cmd]
@@ -691,16 +697,14 @@ list of the current window.
 			when changes have been made and Vim does not want to
 			|abandon| the current buffer.
 			Also see |++opt| and |+cmd|.
-			{not in Vi} {not available when compiled without the
-			|+listcmds| feature}
+			{not in Vi}
 
 :[count]argu[ment]! [count] [++opt] [+cmd]
 			Edit file [count] in the argument list, discard any
 			changes to the current buffer.  When [count] is
 			omitted the current entry is used.
 			Also see |++opt| and |+cmd|.
-			{not in Vi} {not available when compiled without the
-			|+listcmds| feature}
+			{not in Vi}
 
 :[count]n[ext] [++opt] [+cmd]			*:n* *:ne* *:next* *E165* *E163*
 			Edit [count] next file.  This fails when changes have
@@ -823,7 +827,6 @@ fourth file in the argument list.  This happens when you do ":e file".
 LOCAL ARGUMENT LIST
 
 {not in Vi}
-{not available when compiled without the |+windows| or |+listcmds| features}
 
 							*:arglocal*
 :argl[ocal]		Make a local copy of the global argument list.
@@ -875,8 +878,7 @@ USING THE ARGUMENT LIST
 			autocommand event is disabled by adding it to
 			'eventignore'.  This considerably speeds up editing
 			each file.
-			{not in Vi} {not available when compiled without the
-			|+listcmds| feature}
+			{not in Vi}
 			Also see |:windo|, |:tabdo|, |:bufdo|, |:cdo|, |:ldo|,
 			|:cfdo| and |:lfdo|
 
@@ -900,7 +902,7 @@ Note: When the 'write' option is off, you are not able to write any file.
 
 							*:w* *:write*
 						*E502* *E503* *E504* *E505*
-						*E512* *E514* *E667* *E796*
+						*E512* *E514* *E667* *E796* *E949*
 :w[rite] [++opt]	Write the whole buffer to the current file.  This is
 			the normal way to save changes to a file.  It fails
 			when the 'readonly' option is set or when there is
@@ -956,6 +958,9 @@ used, for example, when the write fails and you want to try again later with
 ":w #".  This can be switched off by removing the 'A' flag from the
 'cpoptions' option.
 
+Note that the 'fsync' option matters here.  If it's set it may make writes
+slower (but safer).
+
 							*:sav* *:saveas*
 :sav[eas][!] [++opt] {file}
 			Save the current buffer under the name {file} and set
@@ -1199,7 +1204,8 @@ MULTIPLE WINDOWS AND BUFFERS				*window-exit*
 :wqa[ll]! [++opt]
 :xa[ll]!	Write all changed buffers, even the ones that are readonly,
 		and exit Vim.  If there are buffers without a file name or
-		which cannot be written for another reason, Vim will not quit.
+		which cannot be written for another reason, or there is a
+		terminal with a running job, Vim will not quit.
 		{not in Vi}
 
 ==============================================================================