WIP: catch up 7.4.1194

catchup-7.4.1194.md

@@ -0,0 +1,71 @@
+# 7.4.1194 に追いつくプロジェクト
+
+ここらでいっちょ最新に追いつこうぜ、というプロジェクト。最低限、新機能のド
+キュメントを未翻訳のままでも、日本語ファイルに組み入れてしまう。
+
+最近Vim本体の更新が激しいので、多少のズレはでてしまうが、まずは気にせず1194を
+ターゲットにする。
+
+## 流れ
+
+1.  英語ファイルを全部更新 (終わった!)
+2.  1の差分を見ながら、日本語ファイルに英文のまま反映 (最低限の目標:終わった!)
+3.  2の差分を翻訳 (できたらココまでやりたい)
+4.  このファイルを削除
+
+## ファイル一覧
+
+### 英文だけは反映済み
+
+以上は変更点が100行未満なので、翻訳しやすいはず。
+
+    doc/autocmd.jax
+    doc/change.jax
+    doc/develop.jax
+    doc/editing.jax
+    doc/fold.jax
+    doc/hangulin.jax
+    doc/if_lua.jax    # 100行超えたけど、内容的に大したことない
+    doc/if_mzsch.jax
+    doc/if_perl.jax
+    doc/if_pyth.jax
+    doc/if_ruby.jax
+    doc/if_tcl.jax
+    doc/insert.jax
+    doc/map.jax
+    doc/netbeans.jax
+    doc/pattern.jax
+    doc/quickref.jax
+    doc/repeat.jax
+    doc/spell.jax
+    doc/tagsrch.jax
+    doc/term.jax
+    doc/usr_02.jax    # 行数は多いけど、まとまった書き換えで、楽そう
+    doc/usr_03.jax
+    doc/usr_41.jax
+    doc/various.jax
+
+こっから先は100行超えるので、嫌。
+
+    doc/eval.jax
+    doc/options.jax
+    doc/pi_netrw.jax  # 地獄
+    doc/syntax.jax
+    doc/windows.jax
+
+### 完訳!
+
+    doc/cmdline.jax
+    doc/filetype.jax
+    doc/help.jax
+    doc/index.jax
+    doc/mlang.jax
+    doc/os_os2.jax
+    doc/quickfix.jax
+    doc/usr_29.jax
+    doc/usr_43.jax
+    doc/vi_diff.jax
+
+### その他/深い事情があって断念したもの
+
+まだない

doc/autocmd.jax

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim バージョン 7.4.  Last change: 2014 Aug 22
+*autocmd.txt*   For Vim バージョン 7.4.  Last change: 2015 Dec 05
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -514,6 +514,8 @@ ColorScheme			カラースキームを読み込んだ後。 |:colorscheme|
 							*CompleteDone*
 CompleteDone			挿入モード補完が完了したとき。補完が実行されて
 				も中止されても発行される。 |ins-completion|
+				The |v:completed_item| variable contains
+				information about the completed item.
 
 							*CursorHold*
 CursorHold			'updatetime' の時間の間、ユーザーがキーを押さ
@@ -529,6 +531,11 @@ CursorHold			'updatetime' の時間の間、ユーザーがキーを押さ
 				い。
 				レコーディングの最中にはCursorHoldイベントは発
 				生しない。|q|
+							*<CursorHold>*
+				Internally the autocommand is triggered by the
+				<CursorHold> key. In an expression mapping
+				|getchar()| may see this character.
+
 				Note: このイベントには対話的なコマンドは使えな
 				いことに注意。「続けるには」プロンプトは現れず、
 				スクリーンは必要に応じて直接更新される。
@@ -942,6 +949,13 @@ WinLeave			ウィンドウを離れる前。次に入るウィンドウで他の
 ==============================================================================
 6. パターン					*autocmd-patterns* *{pat}*
 
+The {pat} argument can be a comma separated list.  This works as if the
+command was given with each pattern separately.  Thus this command: >
+	:autocmd BufRead *.txt,*.info set et
+Is equivalent to: >
+	:autocmd BufRead *.txt set et
+	:autocmd BufRead *.info set et
+
 ファイルパターン {pat} がファイル名とマッチするかどうかは、2通りの方法で調べら
 れる。
 1. パターンに '/' が含まれないとき: Vimはファイル名の後ろの部分からのみマッチ
@@ -1045,7 +1059,7 @@ Note: パスの途中だけにマッチさせ、ルートディレクトリに
 例: >
     :au CursorHold <buffer>  echo 'hold'
     :au CursorHold <buffer=33>  echo 'hold'
-    :au CursorHold <buffer=abuf>  echo 'hold'
+    :au BufNewFile * au CursorHold <buffer=abuf>  echo 'hold'
 
 自動コマンドに対するコマンドは全てバッファローカルな自動コマンドに対しても機能
 する。パターンの代わりに特別な文字列を使う。例: >
@@ -1104,6 +1118,9 @@ Note: パスの途中だけにマッチさせ、ルートディレクトリに
 :aug[roup] {name}		後に続くコマンド ":autocmd" のためのグループ名
 				を定義する。{name} を "end" や "END" にすると
 				既定のグループが選ばれる。
+				To avoid confusion, the name should be
+				different from existing {event} names, as this
+				most likely will not do what you intended.
 
 						*:augroup-delete* *E367*
 :aug[roup]! {name}		自動コマンドのグループ {name} を削除する。その

doc/change.jax

@@ -1,4 +1,4 @@
-*change.txt*    For Vim バージョン 7.4.  Last change: 2015 Sep 06
+*change.txt*    For Vim バージョン 7.4.  Last change: 2016 Jan 19
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -404,8 +404,14 @@ CTRL-X			カーソルの下または後の数字またはアルファベット
 			される (そのため効果的に [count] ごとに減少する配列を
 			作ることができる)。 {Vi にはない}
 
-コマンド CTRL-A と CTRL-X は(符号付)10進数と符号なし8進／16進数、アルファベッ
-トに対し機能する。この動作はオプション 'nrformats' に依存する。
+The CTRL-A and CTRL-X commands can work for:
+- signed and unsigned decimal numbers
+- unsigned binary, octal and hexadecimal numbers
+- alphabetic characters
+
+This depends on the 'nrformats' option:
+- When 'nrformats' includes "bin", Vim assumes numbers starting with '0b' or
+  '0B' are binary.
 - 'nrformats' が "octal" を含むときは、Vimは '0' で始まり、'8' や '9' を含まな
   い数字を8進数として取り扱う。他の数は10進数とみなされ、マイナス符号が付いて
   もよい。カーソルが数の上にあれば、コマンドはその数に適用される。そうでなけれ
@@ -418,9 +424,9 @@ CTRL-X			カーソルの下または後の数字またはアルファベット
   を変更する。これはアルファベットのインデックスつきのリストを作るときに便利で
   ある。
 
-10進数では先頭の負の符号は増加/減少に対して考慮される。8進数と16進数では考慮さ
-れない。
-符号を無視するには CTRL-A または CTRL-X を使う前に数字をビジュアル選択する。
+10進数では先頭の負の符号は増加/減少に対して考慮される。しかし2進数、8進数およ
+び16進数では考慮されない。符号を無視するには CTRL-A または CTRL-X を使う前に数
+字をビジュアル選択する。
 
 ゼロから始まる数 (全ての8進数、16進数を含む) に対して、Vimはできる限りその数の
 文字数を保とうとする。"0077" 上で CTRL-A を使うと "0100" となり、"0x100" 上で
@@ -432,6 +438,10 @@ CTRL-X を使うと "0x0ff" となる。
 Note: 'nrformats' が "octal" を含んでいるとき、0で始まる10進数は、8進数と区別
 しづらいため、意図しない結果になる可能性がある。
 
+Note similarly, when 'nrformats' includes "bin", binary numbers with a leading
+'0x' or '0X' can be interpreted as hexadecimal rather than binary since '0b'
+are valid hexadecimal digits.
+
 コマンド CTRL-A はマクロ内でたいへん便利である。例: 番号付きリストを作るには、
 次の方法を使う。
 
@@ -836,6 +846,36 @@ NOTE: 以前のバージョンでは CTRL-V が特別に扱われていた。こ
 	:s/\([ab]\)\|\([cd]\)/\1x/g   "a b c d" を "ax bx x x" に置換
 <
 
+		*:sc* *:sce* *:scg* *:sci* *:scI* *:scl* *:scp* *:sg* *:sgc*
+		*:sge* *:sgi* *:sgI* *:sgl* *:sgn* *:sgp* *:sgr* *:sI* *:si*
+		*:sic* *:sIc* *:sie* *:sIe* *:sIg* *:sIl* *:sin* *:sIn* *:sIp*
+		*:sip* *:sIr* *:sir* *:sr* *:src* *:srg* *:sri* *:srI* *:srl*
+		*:srn* *:srp*
+2-letter and 3-letter :substitute commands ~
+
+     List of :substitute commands
+     |      c    e    g    i    I    n    p    l    r
+     | c  :sc  :sce :scg :sci :scI :scn :scp :scl  ---
+     | e
+     | g  :sgc :sge :sg  :sgi :sgI :sgn :sgp :sgl :sgr
+     | i  :sic :sie  --- :si  :siI :sin :sip  --- :sir
+     | I  :sIc :sIe :sIg :sIi :sI  :sIn :sIp :sIl :sIr
+     | n
+     | p
+     | l
+     | r  :src  --- :srg :sri :srI :srn :srp :srl :sr
+
+Exceptions:
+     :scr  is  `:scriptnames`
+     :se   is  `:set`
+     :sig  is  `:sign`
+     :sil  is  `:silent`
+     :sn   is  `:snext`
+     :sp   is  `:split`
+     :sl   is  `:sleep`
+     :sre  is  `:srewind`
+
+
 式で置換する					*sub-replace-expression*
 						*sub-replace-\=* *s/\=*
 
@@ -939,7 +979,7 @@ NOTE: 以前のバージョンでは CTRL-V が特別に扱われていた。こ
 
 :reg[isters] {arg}	{arg} に指定された名前付きレジスタおよび番号付きレジス
 			タを表示する。例: >
-				:dis 1a
+				:reg 1a
 <			レジスタ '1' と 'a' が表示される。{arg} の中では空白を
 			用いてよい。 {Vi にはない}
 
@@ -1647,18 +1687,26 @@ Vimはソート関数とソートコマンドを備えている。ソート関
 |uniq()| を参照。
 
 							*:sor* *:sort*
-:[range]sor[t][!] [i][u][r][n][x][o] [/{pattern}/]
+:[range]sor[t][!] [b][f][i][n][o][r][u][x] [/{pattern}/]
 			[range]の行をソートする。範囲が指定されない場合は全行
 			をソートする。
 
 			[!]をつけると順序が逆になる。
 
 			[i]をつけると大文字・小文字を区別しない。
 
+			Options [n][f][x][o][b] are mutually exclusive.
+
 			[n]をつけると行の({pattern}のマッチの後ろまたは内側
 			の)最初の10進数の数字でソートする。
 			数字が '-' で始まる場合、マイナスとみなされる。
 
+			With [f] sorting is done on the Float in the line.
+			The value of Float is determined similar to passing
+			the text (after or inside a {pattern} match) to
+			str2float() function. This option is available only
+			if Vim was compiled with Floating point support.
+
 			[x]をつけると行の({pattern}のマッチの後ろまたは内側
 			の)最初の16進数の数字でソートする。"0x" と "0X" は無視
 			される。
@@ -1667,10 +1715,13 @@ Vimはソート関数とソートコマンドを備えている。ソート関
 			[o]をつけると行の({pattern}のマッチの後ろまたは内側
 			の)最初の8進数の数字でソートする。
 
-			[u]をつけると連続する同一行の最初の行だけを残す。
-			([i]がつくと大文字・小文字を無視する)
-			このフラグがつかない場合、連続する同一行はそのままの順
-			序で残される。
+			With [b] sorting is done on the first binary number in
+			the line (after or inside a {pattern} match).
+
+			[u]をつけると (u は unique=「一意の」という意味に基づ
+			く) 連続する同一行の最初の行だけを残す。([i]がつくと大
+			文字・小文字を無視する) このフラグがつかない場合、連続
+			する同一行はそのままの順序で残される。
 			Note: 行頭に行末の空白があると異なる行とみなされる。
 
 			/pattern/が指定され、フラグ[r]がない場合は{pattern}に

doc/cmdline.jax

@@ -1,4 +1,4 @@
-*cmdline.txt*   For Vim バージョン 7.4.  Last change: 2015 Sep 25
+*cmdline.txt*   For Vim バージョン 7.4.  Last change: 2015 Dec 17
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -95,6 +95,11 @@ CTRL-E または <End>				*c_CTRL-E* *c_<End>* *c_End*
 							*c_<LeftMouse>*
 <LeftMouse>	カーソルをマウスでクリックした所へ移動する
 
+							*c_<MiddleMouse>*
+<MiddleMouse>	クリップボード(X11 ではプライマリ選択)の内容を貼り付ける。これ
+		は CTRL-R * を使った動作に似ているが、行間に CR は挿入されな
+		い。
+
 CTRL-H						*c_<BS>* *c_CTRL-H* *c_BS*
 <BS>		カーソル前の文字を削除する (<BS> キーが思い通り働かないときは
 		|:fixdel| を参照)。

doc/develop.jax

@@ -1,4 +1,4 @@
-*develop.txt*   For Vim バージョン 7.4.  Last change: 2014 Mar 27
+*develop.txt*   For Vim バージョン 7.4.  Last change: 2016 Jan 19
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -168,13 +168,28 @@ Vimのソースコードに変更を加える際、守るべきルールがあ
 MAKING CHANGES						*style-changes*
 
 コードに変更を加える基本的なステップは:
-1. ドキュメントを調整する。最初にこれをやることで、あなたの行う変更がユーザー
+1. Get the code from github.  That makes it easier to keep your changed
+   version in sync with the main code base (it may be a while before your
+   changes will be included).  You do need to spend some time learning git,
+   it's not the most user friendly tool.
+2. ドキュメントを調整する。最初にこれをやることで、あなたの行う変更がユーザー
    に与える影響について、おおまかな印象をもつことができる。
-2. ソースコードに変更を加える。
-3. 変更がリストされた項目に影響を与えていないか、../doc/todo.txtをチェックす
+3. ソースコードに変更を加える。
+4. 変更がリストされた項目に影響を与えていないか、../doc/todo.txtをチェックす
    る。
-4. 無修正のコードとドキュメントに対するパッチを、"diff -c" によって得る。
-5. 変更に関する注意書きを作り、パッチに含める。
+5. Make a patch with "git diff".  You can also create a pull request on
+   github, but it's the diff that matters.
+6. Make a note about what changed, preferably mentioning the problem and the
+   solution.  Send an email to the vim-dev maillist with an explanation and
+   include the diff. Or create a pull request on github.
+
+
+C COMPILER						*style-compiler*
+
+The minimal C compiler version supported is C89, also known as ANSI C.
+Later standards don't add much and C89 is the widest supported.
+
+One restriction that this implies: no // comments, only /* comments */.
 
 
 USE OF COMMON FUNCTIONS					*style-functions*
@@ -200,7 +215,7 @@ NAMES							*style-names*
 
 関数の名前に31文字より長い名前は使えない。(VMSのために)
 
-"delete" という名前の変数を使わないこと。C++で問題となる。
+"delete" や "this" という名前の変数を使わないこと。C++で問題となる。
 
 Vimができる限り多くのシステム上で走るという必要上、システムによってすでに定義
 されている名前を使うことは避けねばならない。これは、問題となることが知られて
@@ -290,6 +305,25 @@ OK:	    do
 		a = 1;
 	    while (cond);
 
+間違い:	    if (cond) {
+               cmd;
+               cmd;
+	    } else {
+               cmd;
+               cmd;
+	    }
+
+OK:	    if (cond)
+            {
+               cmd;
+               cmd;
+	    }
+	    else
+	    {
+               cmd;
+               cmd;
+	    }
+
 
 関数は次のようにして始める:
 
@@ -303,9 +337,9 @@ OK:	/*
 	 * 戻り値の説明。
 	 */
 	    int
-	function_name(arg1, arg2)
-	    int		arg1;		/* short comment about arg1 */
-	    int		arg2;		/* short comment about arg2 */
+	function_name(
+	    int		arg1,		/* short comment about arg1 */
+	    int		arg2)		/* short comment about arg2 */
 	{
 	    int		local;		/* comment about local */