Update gui_w32.txt and os_win32.txt

Author: k-takata

doc/gui_w32.jax

@@ -1,4 +1,4 @@
-*gui_w32.txt*   For Vim バージョン 8.0.  Last change: 2014 Dec 20
+*gui_w32.txt*   For Vim バージョン 8.0.  Last change: 2017 Oct 27
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -387,37 +387,7 @@ Win32 GUI版ではMotifの「切取メニュー」をエミュレートする。
 ==============================================================================
 7. コマンドライン引数					*gui-w32-cmdargs*
 
-パラメーターの中のコマンドラインの分析は MS Windows で標準化されていない。
-GVim はコマンドラインの分析のロジックを提供しなければならない。このロジック
-はVimをコンパイルするのに使われたシステムが提供するロジックとは異なるだろう。
-この違いはダブルクォート(")の使い方が一般的でないのと関係する。
-引数の "C:\My Music\freude.txt" と "+/Sch\"iller" は同じように扱われる。引数
-"+/Sch""iller" はgvimやvim、それがどのようにコンパイルされたかによって、扱い
-が変わる。
-
-ルール:
-      a) パラメーターは表示可能文字である
-      b) パラメーターはスペースで区切られている
-      c) ダブルクォートで囲めばパラメーターにスペースを含むことができる
-      d) バックスラッシュ(\)が一つ以上の後に続くダブルクォート(")は特別な文
-	字である。バックスラッシュの数を半分に割って小数を切捨てた数に意味が
-	ある。奇数ならバックスラッシュはスペースやタブの効果を変える。偶数な
-	らバックスラッシュはリテラルのダブルクォートを作る。
-
-つまり:
-	"	は特別なダブルクォート
-	\"	はリテラルのダブルクォート
-	\\"	はリテラルのバックスラッシュと特別なダブルクォート
-	\\\"	はリテラルのバックスラッシュとリテラルのダブルクォート
-	\\\\"	はリテラルのバックスラッシュ二つと特別なダブルクォート
-	\\\\\"	はリテラルのバックスラッシュ二つとリテラルのダブルクォート
-	etc.
-
-例: >
-	gvim "C:\My Music\freude" +"set ignorecase" +/"\"foo\\" +\"bar\\\"
-
-は "C:\My Music\freude" を開き、次のコマンドを実行する: >
-	set ignorecase; /"foo\ and /bar\"
+コマンドライン引数はコンソール版と同じ挙動となる。|win32-cmdargs| を参照。
 
 ==============================================================================
 8. その他色々						*gui-w32-various*

doc/os_win32.jax

@@ -1,4 +1,4 @@
-*os_win32.txt*  For Vim バージョン 8.0.  Last change: 2016 Oct 12
+*os_win32.txt*  For Vim バージョン 8.0.  Last change: 2017 Mar 21
 
 
 		  VIMリファレンスマニュアル    by George Reilly
@@ -81,10 +81,45 @@ Vim 実行ファイルのディレクトリが $PATH に追加される。これ
 executable() が 1 を返すときは実際にその実行ファイルが実行可能であるように
 なる。
 
-ファイル名のクォート					*win32-quotes*
-
-ファイル名の中のクォート(もしくは他のコマンドコマンド引数)はバックスラッシュで
-エスケープできる。例。 >
+コマンドライン引数					*win32-cmdargs*
+
+コマンドラインからパラメーターへの解析は MS Windows で標準化されていない。
+Vim と gvim はかつては(7.4.432以前)、それをパースするために異なるロジックを用
+いており、さらにどのコンパイラでコンパイルしたかにも依存していた。現在では Vim
+も gvim も CommandLineToArgvW() Win32 API を使用しており、どちらも同じように動
+作する。
+
+基本的なルール:						*win32-backslashes*
+      a) パラメーターは表示可能文字である
+      b) パラメーターはスペースで区切られている
+      c) ダブルクォートで囲めばパラメーターにスペースを含むことができる
+      d) バックスラッシュ(\)が一つ以上の後に続くダブルクォート(")は特別な文
+	字である。バックスラッシュの数を半分に割って小数を切捨てた数に意味が
+	ある。奇数ならバックスラッシュはスペースやタブの効果を変える。偶数な
+	らバックスラッシュはリテラルのダブルクォートを作る。
+
+つまり:
+	"	は特別なダブルクォート
+	\"	はリテラルのダブルクォート
+	\\"	はリテラルのバックスラッシュと特別なダブルクォート
+	\\\"	はリテラルのバックスラッシュとリテラルのダブルクォート
+	\\\\"	はリテラルのバックスラッシュ二つと特別なダブルクォート
+	\\\\\"	はリテラルのバックスラッシュ二つとリテラルのダブルクォート
+	etc.
+
+例: >
+	gvim "C:\My Music\freude" +"set ignorecase" +/"\"foo\\" +\"bar\\\"
+
+は "C:\My Music\freude" を開き、次のコマンドを実行する: >
+	set ignorecase; /"foo\ and /bar\"
+
+これらのルールは CommandLineToArgvW API のリファレンスにも記載されている:
+    https://msdn.microsoft.com/en-us/library/windows/desktop/bb776391.aspx
+
+							*win32-quotes*
+クォートには追加のルールがある(これらはちゃんとドキュメント化されていない)。
+前述の通り、ファイル名(もしくは他のコマンドライン引数)の中のクォートはバックス
+ラッシュでエスケープできる。例。 >
 	vim -c "echo 'foo\"bar'"
 
 その代わりにクォートを3つ使う事もできる: >
@@ -94,9 +129,9 @@ executable() が 1 を返すときは実際にその実行ファイルが実行
 
 1. 一つの `"` はクォートの始まり。
 2. 他の `"` や `""` はクォートの終わり。もしクォートが `""` で終わっているなら
-   `"` はクォートされた文字列の終わりとして処理される。
+   クォートされた文字列の終わりに `"` が生成される。
 
-例えば引数を1つずつを [] で囲った場合:
+例えば、引数を1つずつ [] で囲った場合:
         "foo"           -> [foo]
         "foo""          -> [foo"]
         "foo"bar        -> [foobar]
@@ -135,7 +170,7 @@ Windows 95/98/ME のサポートはパッチ 8.0.0029 にて削除された。
 6. Windows 3.1での使用					*win32-win3.1*
 
 					*win32s* *windows-3.1* *gui-w32s*
-これらは Windows 3.1 や 3.11 上で実行される Gvim の特別なバージョンであった。
+かつて Windows 3.1 や 3.11 上で動作する gvim の特別なバージョンがあった。
 パッチ 7.4.1363 にてサポートは削除された。
 
 ==============================================================================
@@ -214,10 +249,19 @@ A. できない！ これはNTコンソールの制限である。NT 5.0では
    ドウに対して、同時に点滅頻度を設定できるようになるといわれている。
 
 							*:!start*
-Q. 非同期的に外部コマンドやプログラムを実行するにはどうしたらよいか？
-A. :!を使って外部コマンドを実行している場合、"start" と共に実行できる: >
-	:!start winfile.exe<CR>
-<  "start" を使うと、Vimは他のスクリーンに切り替えたり、新しいコンソールを開い
+Q. 非同期的に外部コマンドやプログラムを実行したり、ドキュメントや URL を既定の
+   プログラムで開くにはどうしたらよいか？
+A. :!を使って外部コマンドを実行している場合、"start" と共に実行できる。例えば
+   notepad を起動するには: >
+	:!start notepad
+<   既定のイメージビューワーで "image.jpg" を開くには: >
+        :!start image.jpg
+<   現在のファイルのフォルダーを Windows エクスプローラーで開くには: >
+        :!start %:h
+<   既定のブラウザーで Vim のホームページを開くには: >
+        :!start http://www.vim.org/
+<
+   "start" を使うと、Vimは他のスクリーンに切り替えたり、新しいコンソールを開い
    たり、プログラムが終了するまで待ったりしなくなる; つまり、走らせるプログラ
    ムは編集中のファイルに何の影響も与えない。:!startで始まったプログラムは、
    Vimの開いたファイルハンドルを受け渡されないため、Vimより早く終了する必要は

en/gui_w32.txt

@@ -1,4 +1,4 @@
-*gui_w32.txt*   For Vim version 8.0.  Last change: 2014 Dec 20
+*gui_w32.txt*   For Vim version 8.0.  Last change: 2017 Oct 27
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -382,38 +382,8 @@ Note that a menu that starts with ']' will not be displayed.
 ==============================================================================
 7. Command line arguments				*gui-w32-cmdargs*
 
-Analysis of a command line into parameters is not standardised in MS Windows.
-Gvim has to provide logic to analyse a command line.  This logic is likely to
-be different from the default logic provided by a compilation system used to
-build vim.  The differences relate to unusual double quote (") usage.
-The arguments "C:\My Music\freude.txt" and "+/Sch\"iller" are handled in the
-same way.  The argument "+/Sch""iller" may be handled different by gvim and
-vim, depending what it was compiled with.
-
-The rules are:
-      a) A parameter is a sequence of graphic characters.
-      b) Parameters are separated by white space.
-      c) A parameter can be enclosed in double quotes to include white space.
-      d) A sequence of zero or more backslashes (\) and a double quote (")
-	is special.  The effective number of backslashes is halved, rounded
-	down.  An even number of backslashes reverses the acceptability of
-	spaces and tabs, an odd number of backslashes produces a literal
-	double quote.
-
-So:
-	"	is a special double quote
-	\"	is a literal double quote
-	\\"	is a literal backslash and a special double quote
-	\\\"	is a literal backslash and a literal double quote
-	\\\\"	is 2 literal backslashes and a special double quote
-	\\\\\"	is 2 literal backslashes and a literal double quote
-	etc.
-
-Example: >
-	gvim "C:\My Music\freude" +"set ignorecase" +/"\"foo\\" +\"bar\\\"
-
-opens "C:\My Music\freude" and executes the line mode commands: >
-	set ignorecase; /"foo\ and /bar\"
+Command line arguments behave the same way as with the console application,
+see |win32-cmdargs|.
 
 ==============================================================================
 8. Various						*gui-w32-various*

en/os_win32.txt

@@ -1,4 +1,4 @@
-*os_win32.txt*  For Vim version 8.0.  Last change: 2016 Oct 12
+*os_win32.txt*  For Vim version 8.0.  Last change: 2017 Mar 21
 
 
 		  VIM REFERENCE MANUAL    by George Reilly
@@ -81,10 +81,45 @@ The directory of the Vim executable is appended to $PATH.  This is mostly to
 make "!xxd" work, as it is in the Tools menu.  And it also means that when
 executable() returns 1 the executable can actually be executed.
 
-Quotes in file names					*win32-quotes*
+Command line arguments					*win32-cmdargs*
+
+Analysis of a command line into parameters is not standardised in MS Windows.
+Vim and gvim used to use different logic to parse it (before 7.4.432), and the
+logic was also depended on what it was compiled with.  Now Vim and gvim both
+use the CommandLineToArgvW() Win32 API, so they behave in the same way.
+
+The basic rules are:					*win32-backslashes*
+      a) A parameter is a sequence of graphic characters.
+      b) Parameters are separated by white space.
+      c) A parameter can be enclosed in double quotes to include white space.
+      d) A sequence of zero or more backslashes (\) and a double quote (")
+	is special.  The effective number of backslashes is halved, rounded
+	down.  An even number of backslashes reverses the acceptability of
+	spaces and tabs, an odd number of backslashes produces a literal
+	double quote.
+
+So:
+	"	is a special double quote
+	\"	is a literal double quote
+	\\"	is a literal backslash and a special double quote
+	\\\"	is a literal backslash and a literal double quote
+	\\\\"	is 2 literal backslashes and a special double quote
+	\\\\\"	is 2 literal backslashes and a literal double quote
+	etc.
 
-Quotes inside a file name (or any other command line argument) can be escaped
-with a backslash.  E.g. >
+Example: >
+	vim "C:\My Music\freude" +"set ignorecase" +/"\"foo\\" +\"bar\\\"
+
+opens "C:\My Music\freude" and executes the line mode commands: >
+	set ignorecase; /"foo\ and /bar\"
+
+These rules are also described in the reference of the CommandLineToArgvW API:
+    https://msdn.microsoft.com/en-us/library/windows/desktop/bb776391.aspx
+
+							*win32-quotes*
+There are additional rules for quotes (which are not well documented).
+As described above, quotes inside a file name (or any other command line
+argument) can be escaped with a backslash.  E.g. >
 	vim -c "echo 'foo\"bar'"
 
 Alternatively use three quotes to get one: >
@@ -135,7 +170,7 @@ you will need to get a version older than that.
 6. Running under Windows 3.1				*win32-win3.1*
 
 					*win32s* *windows-3.1* *gui-w32s*
-There was a special version of Gvim that runs under Windows 3.1 and 3.11.
+There was a special version of gvim that runs under Windows 3.1 and 3.11.
 Support was removed in patch 7.4.1363.
 
 ==============================================================================
@@ -212,10 +247,19 @@ A. You can't!  This is a limitation of the NT console.  NT 5.0 is reported to
    be able to set the blink rate for all console windows at the same time.
 
 							*:!start*
-Q. How can I run an external command or program asynchronously?
-A. When using :! to run an external command, you can run it with "start": >
-	:!start winfile.exe<CR>
-<  Using "start" stops Vim switching to another screen, opening a new console,
+Q. How can I asynchronously run an external command or program, or open a
+   document or URL with its default program?
+A. When using :! to run an external command, you can run it with "start". For
+   example, to run notepad: >
+	:!start notepad
+<   To open "image.jpg" with the default image viewer: >
+        :!start image.jpg
+<   To open the folder of the current file in Windows Explorer: >
+        :!start %:h
+<   To open the Vim home page with the default browser: >
+        :!start http://www.vim.org/
+<
+   Using "start" stops Vim switching to another screen, opening a new console,
    or waiting for the program to complete; it indicates that you are running a
    program that does not affect the files you are editing.  Programs begun
    with :!start do not get passed Vim's open file handles, which means they do