update insert.jax in order to follow the latest documents

Use 7.3.524 as the base version. (Issue #56)

Author: k-takata

doc/insert.jax

@@ -1,4 +1,4 @@
-*insert.txt*    For Vim バージョン 7.3.  Last change: 2012 Jan 26
+*insert.txt*    For Vim バージョン 7.3.  Last change: 2012 May 18
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -368,8 +368,11 @@ CTRL-Oコマンドは時々副作用を生じる: カーソルが行末を越え
 あることに注意。
 
 CTRL-O コマンドでノーマルモードに移動できるが、そこでさらにインサートモードに
-入ってもモードは入れ子にならない。例えば "a<C-O>a" と入力してから <Esc> を押す
-とノーマルモードに帰ってくる。<Esc> を二回押す必要はない。
+入っても、通常はモードは入れ子にならない。例えば "a<C-O>a" と入力してから
+<Esc> を押すとノーマルモードに帰ってくる。<Esc> を二回押す必要はない。
+例外は、例えばマッピングを実行しているときやスクリプトを source しているときな
+ど、コマンドを入力していないときである。このとき、マッピングは一時的に挿入モー
+ドに切り替わるように働く。
 
 Shiftキーを押しながらのカーソルキー操作は、全ての端末で可能なわけではない。
 
@@ -381,7 +384,12 @@ CTRL-G u を使う例: >
 	:inoremap <C-H> <C-G>u<C-H>
 
 これは undo できるバックスペースキーを再定義している。これで以前の入力を変
-更することなく CTRL-O u を使ってバックスペースの結果を元に戻せる。
+更することなく CTRL-O u を使ってバックスペースの結果を元に戻せる。もう一つの
+例: >
+
+	:inoremap <CR> <C-]><C-G>u<CR>
+
+これは改行ごとに undo を分割する。また、それを行う前に短縮入力の展開も行う。
 
 CTRL-O は undo 位置を分割する。つまり、その前後に入力したテキストが別々にundo 
 されるようになる。これを避けたい場合(マッピングの中などで)は CTRL-R =
@@ -947,9 +955,12 @@ CTRL-P			カーソルの直前と同じ文字で始まる単語を、'complete'
 これらの関数は補完するテキストの始点の桁番号を返す責任を負う。桁番号は 0 以上
 "col('.')" 未満でなければならない。この桁番号はカーソルの直前の文字列を含み、
 補完候補の一部となる文字列を含む。この桁とカーソル位置の間のテキストが補完さ
-れ、候補で置き換わることになる。補完を行えないときは -1 を返すと、補完はキャン
-セルされ、エラーメッセージが表示される。メッセージなしでキャンセルしたい場合は
--2 を返す。
+れ、候補で置き換わることになる。
+
+特別な戻り値:
+   -1 補完を行えない場合。補完はキャンセルされ、エラーメッセージが表示される。
+   -2 メッセージなしでキャンセルし、補完モードに留まりたい場合。
+   -3 メッセージなしでキャンセルし、補完モードから抜けたい場合。
 
 2番目の形での呼び出しでは、次の引数が与えられる:
    a:findstart  0