Update diff.{txt,jax}

Author: h-east

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は差分の出力結果が妥当であるか検証する。妥当でない場合、エラーメッセージを
 得るだろう。起こりうるエラーは:

en/diff.txt

@@ -39,7 +39,9 @@ The second and following arguments may also be a directory name.  Vim will
 then append the file name of the first argument to the directory name to find
 the file.
 
-This only works when a standard "diff" command is available.  See 'diffexpr'.
+By default an internal diff library will be used.  When 'diffopt' or
+'diffexpr' has been set an external "diff" command will be used.  This only
+works when such a diff program is available.
 
 Diffs are local to the current tab page |tab-page|.  You can't see diffs with
 a window in another tab page.  This does make it possible to have several
@@ -344,8 +346,9 @@ between file1 and file2: >
 
 The ">" is replaced with the value of 'shellredir'.
 
-The output of "diff" must be a normal "ed" style diff.  Do NOT use a context
-diff.  This example explains the format that Vim expects: >
+The output of "diff" must be a normal "ed" style diff or a unified diff.  Do
+NOT use a context diff.  This example explains the format that Vim expects for
+the "ed" style diff: >
 
 	1a2
 	> bbb
@@ -384,12 +387,16 @@ Example (this does almost the same as 'diffexpr' being empty): >
 	   endif
 	   silent execute "!diff -a --binary " . opt . v:fname_in . " " . v:fname_new .
 		\  " > " . v:fname_out
+	   redraw!
 	endfunction
 
 The "-a" argument is used to force comparing the files as text, comparing as
 binaries isn't useful.  The "--binary" argument makes the files read in binary
 mode, so that a CTRL-Z doesn't end the text on DOS.
 
+The `redraw!` command may not be needed, depending on whether executing a
+shell command shows something on the display or not.
+
 						*E810* *E97*
 Vim will do a test if the diff output looks alright.  If it doesn't, you will
 get an error message.  Possible causes: