Merge pull request #316 from vim-jp/misc_update1

Misc update1

Author: k-takata

doc/autocmd.jax

@@ -856,6 +856,10 @@ OptionSet			オプションが設定された後。パターンは長い(短縮
 				ットするのは、プラグインの挙動を破壊するため、
 				良くない。この自動コマンドの実行は `:noa` を使
 				うことで抑制することができる。
+
+				自動コマンド内で |:set| を使用しても、イベント
+				は再びトリガーされない。
+
 							*QuickFixCmdPre*
 QuickFixCmdPre			QuickFixコマンドが実行される前 (|:make|,
 				|:lmake|, |:grep|, |:lgrep|, |:grepadd|,

doc/change.jax

@@ -166,8 +166,6 @@ gR			仮想置換モードに入る。打ち込んだ文字が画面上の既存
 			一回で置き換えることができる。入力されたテキストを
 			[count]-1 回繰り返す。詳細は |Virtual-Replace-mode| を
 			参照。
-			{Vimが |+vreplace| 機能付きでコンパイルされたときのみ
-			有効}
 
 							*c*
 ["x]c{motion}		{motion} のテキストを [レジスタ x に入れ] 削除し、挿入
@@ -289,8 +287,6 @@ gr{char}		カーソル下の仮想文字を {char} に置き換える。この
 			置き換える。詳細は |gR| と |Virtual-Replace-mode| を参
 			照。|r| と同様、回数を指定できる。
 			{char} の入力方法は |r| と同様である。
-			{Vimが |+vreplace| 機能付きでコンパイルされたときのみ
-			有効}
 
 							*digraph-arg*
 |r| や |t| 等のノーマルモードコマンドの引数は、1個の文字である。オプション
@@ -693,6 +689,7 @@ g&			`:%s//~/&` と同義 (全ての行に対し、最後の検索パターン
 	とリセットする。
 	{Vi にはないもの: マッチの強調表示、'y' と 'n' 以外の応答}
 
+							*:s_e*
 [e]	検索パターンが何もマッチしなかったとき、エラーメッセージを表示しない。
 	特にマッピング内ではエラーが発生しなかったかのように続行される。これは
 	「パターンは見つかりませんでした」のエラーによるマッピングの中断を防ぐ
@@ -704,33 +701,37 @@ g&			`:%s//~/&` と同義 (全ての行に対し、最後の検索パターン
 		「(割込まれました)」
 	{Vi にはない}
 
+							*:s_g*
 [g]	行中の全てのマッチを置換する。このフラグなしだと、各行の1個目のマッチ
 	のみが置換される。オプション 'edcompatible' がオンのとき、Vimはこのフ
 	ラグを記憶し、指定される度にオン／オフを切り替えるが、新しい検索パター
 	ンが使われるとリセットする。'gdefault' がオンのときは、このフラグはオ
 	ンが既定値になり、フラグ [g] を指定したときにはオフになる。
 
+							*:s_i*
 [i]	パターンの大文字／小文字の区別をしない。オプション 'ignorecase' と
 	'smartcase' は使われない。
 	{Vi にはない}
 
+							*:s_I*
 [I]	パターンの大文字／小文字を区別する。オプション 'ignorecase' と
 	'smartcase' は使われない。
 	{Vi にはない}
 
+							*:s_n*
 [n]	マッチの個数を表示し、実際には置換を行わない。フラグ [c] は無視される。
 	'report' が 0 のときと同じようにマッチが表示される。
 	何個あるか調べるときに便利。|count-items|
 	\= |sub-replace-expression| が使われたときは、式はそれぞれのマッチに対
 	してサンドボックス (|sandbox|) で実行される。
 
-[p]	最後に置換を行った行を表示する。
-	{Vi にはない}
+[p]	最後に置換を行った行を表示する。 *:s_p*
 
-[#]	[p] と同様。行番号をつける。
+[#]	[p] と同様。行番号をつける。 *:s_#*
 
-[l]	[p] と同様だが、|:list| のように表示する。
+[l]	[p] と同様だが、|:list| のように表示する。 *:s_l*
 
+							*:s_r*
 [r]	引数のない `:&` か `:s` との連携でのみ有効。`:&r` は `:~` と同様に動作
 	する。検索パターンが空のとき、最後の置換コマンドや `:global` でのパター
 	ンではなく、最後の検索パターンを使用する。最後に検索パターンを使用した
@@ -1445,7 +1446,7 @@ autoload ディレクトリに置くこと。例、~/.vim/autoload/format.vim: >
 
 その後以下のように整形を有効にすることができる: >
   setlocal formatexpr=format#Format()
->
+
 Note: この関数は、挿入モードから呼ばれた場合に明示的に非ゼロを返す (基本的に
 'textwidth' の制限を超えてテキストが挿入されることを意味する)。これは Vim に内
 部の整形機能に立ち戻って再整形させることになる。

doc/channel.jax

@@ -162,6 +162,10 @@ send を呼ぶたびに毎回コールバックを指定する代わりに、チ
 		    "auto"	メッセージを処理するコールバックがない場合。
 				"close_cb" もこのために考慮されます。
 		    "never"	すべてのメッセージが保存されます。
+
+							*channel-noblock*
+"noblock"	|job-noblock| と同じ効果です。書込みの為だけの事項です。
+
 							*waittime*
 "waittime"	接続がミリ秒単位で待機する時間。負の数は永遠に待ちます。
 
@@ -596,6 +600,19 @@ job_setoptions(job, {options}) を使用して、ジョブの開始後にいく
 			Note: ファイルやバッファに書き込むときやバッファから読
 			み込むときは、NL モードがデフォルトで使用されます。
 
+						*job-noblock*
+"noblock": 1		書き込み時に、非ブロッキング書き込み呼び出しを使用しま
+			す。これは Vim が間に他のメッセージを処理する必要があ
+			る場合に止まるのを回避します。例えば、ジョブが Vim に
+			データを返すとき。これは、`ch_sendraw()` が返されたと
+			きに、すべてのデータがまだ書き込まれていない可能性があ
+			ることを意味します。
+			このオプションはパッチ 8.1.0350 で追加され、以下を使っ
+			て検査します: >
+				if has("patch-8.1.350")
+				  let options['noblock'] = 1
+				endif
+<
 						*job-callback*
 "callback": handler	チャネルの任意の部分で何かを読むためのコールバック。
 						*job-out_cb* *out_cb*

doc/cmdline.jax

@@ -792,11 +792,12 @@ Note: "#<n" 以外は、ユーザーに打ち込まれた通りのファイル
 	   \\#			\#
 |`=| も参照のこと。
 
-			       *:<cword>* *:<cWORD>* *:<cfile>* *<cfile>*
-			       *:<sfile>* *<sfile>* *:<afile>* *<afile>*
-			       *:<abuf>* *<abuf>* *:<amatch>* *<amatch>*
-			       *:<cexpr>* *<cexpr>*
-			       *<slnum>* *E495* *E496* *E497* *E499* *E500*
+			       *:<cword>* *<cword>* *:<cWORD>* *<cWORD>*
+			       *:<cexpr>* *<cexpr>* *:<cfile>* *<cfile>*
+			       *:<afile>* *<afile>* *:<abuf>* *<abuf>*
+			       *:<amatch>* *<amatch>*
+			       *:<sfile>* *<sfile>* *:<slnum>* *<slnum>*
+			       *:<sflnum>* *<sflnum>* *E499* *E500*
 Note: これらは文字通りに打ち込まれる、これらは特別なキーではない！
 	<cword>    カーソル下の word に置き換えられる (|star| と同様)
 	<cWORD>    カーソル下の WORD に置き換えられる (|WORD| を参照)
@@ -807,15 +808,16 @@ Note: これらは文字通りに打ち込まれる、これらは特別なキ
 		   |v:beval_text| のために使われる。
 	<cfile>    カーソル下のパス名に置き換えられる (|gf| が使うものと同様)
 	<afile>    自動コマンドの実行時、操作されているバッファのファイル名ま
-		   たは読み書き用のファイル名に置き換えられる。
+		   たは読み書き用のファイル名に置き換えられる。 *E495*
 	<abuf>     自動コマンドの実行時、カレントバッファの番号に置き換えられ
 		   る (":r file" と ":so file" のときにもカレントバッファの番
 		   号に置き換えられる。読み込まれているファイルはバッファ内に
-		   ない)
+		   ない)  *E496*
 	<amatch>   自動コマンドの実行時、この自動コマンドが実行されたときのマッ
-		   チに置き換えられる。そのファイル名がマッチの検索に使われて
-		   いないときのみ、<afile> と違う値になる (イベント FileType、
-		   Syntax、SpellFileMissing 用)。
+		   チに置き換えられる。 *E497*
+		   そのファイル名がマッチの検索に使われていないときのみ、
+		   <afile> と違う値になる (イベント FileType, Syntax,
+		   SpellFileMissing 用)。
 	<sfile>    コマンド ":source" の実行時、取り込まれたファイルのファイル
 		   名に置き換えられる。  *E498*
 		   関数の実行時はこのように置き換えられる:
@@ -826,6 +828,9 @@ Note: これらは文字通りに打ち込まれる、これらは特別なキ
 		   は無効になることに注意。
 	<slnum>	   コマンド ":source" の実行時、行番号に置き換えられる。 *E842*
 		   関数の中では、関数の先頭からの相対的な行番号になる。
+	<sflnum>   スクリプトを実行すると、行番号に置き換えられる。<slnum> と
+		   異なる点は、<sflnum> がどのような状況でもスクリプト行番号で
+		   置き換えられることである。 *E961*
 
 							 *filename-modifiers*
 *:_%:* *::8* *::p* *::.* *::~* *::h* *::t* *::r* *::e* *::s* *::gs* *::S*
@@ -849,7 +854,8 @@ Note: これらは文字通りに打ち込まれる、これらは特別なキ
 		イル名は修正されない。
 	:.	ファイル名をカレントディレクトリについて相対的な名前に (可能な
 		らば) 切り詰める。ファイル名がカレントディレクトリの下になけれ
-		ば、ファイル名は修正されない。
+		ば、ファイル名は修正されない。しかし、MS-Windowsでは、カレント
+		ドライブであればドライブ名は削除される。
 		最も短く切り詰めるには ":~:." を使う。
 	:h	ファイル名のヘッド (末尾の部分と全ての区切りが除かれたもの)。
 		:e, :r, :t には使えない。

doc/diff.jax

@@ -38,7 +38,9 @@
 2つ目以降の引数にはディレクトリ名を指定することもできる。その際には第1引数の
 ファイル名がそのディレクトリ名に追加され、ファイルを検索するのに利用される。
 
-これは外部コマンドの "diff" が存在する場合にだけ動作する。'diffexpr' 参照。
+デフォルトでは、内部diffライブラリが使用される。'diffopt' または 'diffexpr' が
+設定されていると外部の "diff" コマンドが使用される。これは、そのようなdiffプロ
+グラムが利用可能な場合にのみ機能する。
 
 diff はカレントタブページ |tab-page| にローカルである。他のタブページにある
 ウィンドウとの差分を見ることはできない。これによって、複数の差分を同時に見るこ
@@ -340,8 +342,9 @@ g:diff_translations を 0 に設定する: >
 
 ">" は 'shellredir' の値に置き換えられる。
 
-"diff" の出力は通常の "ed" 形式の差分でなければならない。コンテキスト差分を使
-用してはいけない。この例はVimが求めるフォーマットを示している: >
+"diff" の出力は通常の "ed" 形式の差分またはユニファイド差分でなければならない。
+コンテキスト差分を使用してはいけない。 この例では、Vimが "ed" 形式の差分に求め
+るフォーマットを示している: >
 
 	1a2
 	> bbb
@@ -379,12 +382,16 @@ g:diff_translations を 0 に設定する: >
 	   endif
 	   silent execute "!diff -a --binary " . opt . v:fname_in . " " . v:fname_new .
 		\  " > " . v:fname_out
+	   redraw!
 	endfunction
 
 引数の "-a" は強制的にテキストファイルとして比較するために使われる。バイナリで
 の比較は使いにくい。引数の "--binary" はファイルをバイナリモードで読み込むため
 に使われる。DOSでCTRL-Zをテキストの終わりとしないためである。
 
+シェルコマンドを実行し、ディスプレイに何かが表示されるかどうかによっては、
+`redraw!` コマンドは必要ないかもしれない。
+
 						*E810* *E97*
 Vimは差分の出力結果が妥当であるか検証する。妥当でない場合、エラーメッセージを
 得るだろう。起こりうるエラーは:

doc/editing.jax

@@ -896,8 +896,8 @@ Unix およびその他いくつかのシステムではバッククォートも
 Note: オプション 'write' がオフのときは、どのファイルも書き込めないことに注意。
 
 							*:w* *:write*
-						*E502* *E503* *E504* *E505*
-						*E512* *E514* *E667* *E796* *E949*
+					*E502* *E503* *E504* *E505*
+					*E512* *E514* *E667* *E796* *E949*
 :w[rite] [++opt]	バッファ全体をカレントファイルに書き込む。これはファイ
 			ルに対する変更点を保存するときの普通の方法である。
 			オプション 'readonly' がオンであるかファイルに書き込め

en/autocmd.txt

@@ -864,6 +864,9 @@ OptionSet			After setting an option.  The pattern is
 				plugin. You can always use `:noa` to prevent
 				triggering this autocommand.
 
+				When using |:set| in the autocommand the event
+				is not triggered again.
+
 							*QuickFixCmdPre*
 QuickFixCmdPre			Before a quickfix command is run (|:make|,
 				|:lmake|, |:grep|, |:lgrep|, |:grepadd|,

en/change.txt

@@ -177,8 +177,6 @@ gR			Enter Virtual Replace mode: Each character you type
 			<Tab> may replace several characters at once.
 			Repeat the entered text [count]-1 times.  See
 			|Virtual-Replace-mode| for more details.
-			{not available when compiled without the |+vreplace|
-			feature}
 
 							*c*
 ["x]c{motion}		Delete {motion} text [into register x] and start
@@ -303,8 +301,6 @@ gr{char}		Replace the virtual characters under the cursor with
 			space.  See |gR| and |Virtual-Replace-mode| for more
 			details.  As with |r| a count may be given.
 			{char} can be entered like with |r|.
-			{not available when compiled without the |+vreplace|
-			feature}
 
 						*digraph-arg*
 The argument for Normal mode commands like |r| and |t| is a single character.
@@ -712,6 +708,7 @@ The flags that you can use for the substitute commands:
 	search pattern.
 	{not in Vi: highlighting of the match, other responses than 'y' or 'n'}
 
+							*:s_e*
 [e]     When the search pattern fails, do not issue an error message and, in
 	particular, continue in maps as if no error occurred.  This is most
 	useful to prevent the "No match" error from breaking a mapping.  Vim
@@ -723,33 +720,38 @@ The flags that you can use for the substitute commands:
 		Interrupted
 	{not in Vi}
 
+							*:s_g*
 [g]	Replace all occurrences in the line.  Without this argument,
 	replacement occurs only for the first occurrence in each line.  If
 	the 'edcompatible' option is on, Vim remembers this flag and toggles
 	it each time you use it, but resets it when you give a new search
 	pattern.  If the 'gdefault' option is on, this flag is on by default
 	and the [g] argument switches it off.
 
+							*:s_i*
 [i]	Ignore case for the pattern.  The 'ignorecase' and 'smartcase' options
 	are not used.
 	{not in Vi}
 
+							*:s_I*
 [I]	Don't ignore case for the pattern.  The 'ignorecase' and 'smartcase'
 	options are not used.
 	{not in Vi}
 
+							*:s_n*
 [n]	Report the number of matches, do not actually substitute.  The [c]
 	flag is ignored.  The matches are reported as if 'report' is zero.
 	Useful to |count-items|.
 	If \= |sub-replace-expression| is used, the expression will be
 	evaluated in the |sandbox| at every match.
 
-[p]	Print the line containing the last substitute.
+[p]	Print the line containing the last substitute.  *:s_p*
 
-[#]	Like [p] and prepend the line number.
+[#]	Like [p] and prepend the line number.  *:s_#*
 
-[l]	Like [p] but print the text like |:list|.
+[l]	Like [p] but print the text like |:list|.  *:s_l*
 
+							*:s_r*
 [r]	Only useful in combination with `:&` or `:s` without arguments.  `:&r`
 	works the same way as `:~`:  When the search pattern is empty, use the
 	previously used search pattern instead of the search pattern from the
@@ -1451,7 +1453,7 @@ to the name of an external program for Vim to use for text formatting.  The
 program.
 
                                                         *format-formatexpr*
-The 'formatexpr' option can be set to a Vim Script function that performs
+The 'formatexpr' option can be set to a Vim script function that performs
 reformatting of the buffer.  This should usually happen in an |ftplugin|,
 since formatting is highly dependent on the type of file.  It makes
 sense to use an |autoload| script, so the corresponding script is only loaded
@@ -1485,7 +1487,7 @@ text.  Put it in your autoload directory, e.g. ~/.vim/autoload/format.vim: >
 
 You can then enable the formatting by executing: >
   setlocal formatexpr=format#Format()
->
+
 Note: this function explicitly returns non-zero when called from insert mode
 (which basically means, text is inserted beyond the 'textwidth' limit).  This
 causes Vim to fall back to reformat the text by using the internal formatter.

en/channel.txt

@@ -163,6 +163,9 @@ Use |ch_status()| to see if the channel could be opened.
 				The "close_cb" is also considered for this.
 		    "never"	All messages will be kept.
 
+							*channel-noblock*
+"noblock"	Same effect as |job-noblock|.  Only matters for writing.
+
 							*waittime*
 "waittime"	The time to wait for the connection to be made in
 		milliseconds.  A negative number waits forever.
@@ -594,6 +597,17 @@ See |job_setoptions()| and |ch_setoptions()|.
 			Note: when writing to a file or buffer and when
 			reading from a buffer NL mode is used by default.
 
+						*job-noblock*
+"noblock": 1		When writing use a non-blocking write call.  This
+			avoids getting stuck if Vim should handle other
+			messages in between, e.g. when a job sends back data
+			to Vim.  It implies that when `ch_sendraw()` returns
+			not all data may have been written yet.
+			This option was added in patch 8.1.0350, test with: >
+				if has("patch-8.1.350")
+				  let options['noblock'] = 1
+				endif
+<
 						*job-callback*
 "callback": handler	Callback for something to read on any part of the
 			channel.