{map,sign}.jax: Update Vim 8.2.2831 translate

Author: tsuyoshicho

doc/map.jax

@@ -1,4 +1,4 @@
-*map.txt*       For Vim バージョン 8.2.  Last change: 2020 Dec 10
+*map.txt*       For Vim バージョン 8.2.  Last change: 2021 Apr 23
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -238,9 +238,12 @@ Note: ":map <script>" と ":noremap <script>" の動作は同じです。コマ
 マップや短縮入力を定義するときに "<expr>" 引数を指定すると、引数が式 (スクリプ
 ト) として扱われます。マップが実行されたときに、式が評価され、その値が {rhs}
 として使われます。例: >
-	:inoremap <expr> . InsertDot()
-InsertDot() 関数の戻り値が挿入されます。カーソルの前のテキストをチェックして、
-ある条件に一致するなら omni 補完を開始する、というようなことができます。
+	:inoremap <expr> . <SID>InsertDot()
+s:InsertDot() 関数の戻り値が挿入されます。カーソルの前のテキストをチェックし
+て、ある条件に一致するなら omni 補完を開始する、というようなことができます。
+グローバルの名前空間の汚染を回避するには、スクリプトローカルの関数を利用するこ
+とが望しいです。RHS内に <SID> を使ってマッピングが定義されたスクリプトを見付け
+られるようにします。
 
 短縮入力では、入力されて短縮入力展開のトリガーとなった文字が |v:char| にセット
 されます。これを使って {lhs} の展開方法を決めることもできます。自分で v:char
@@ -254,7 +257,20 @@ InsertDot() 関数の戻り値が挿入されます。カーソルの前のテ
 	  call popup_create(... arguments ...)
 	  return "\<Ignore>"
 	endfunc
-	nnoremap <expr> <F3> <Sid>OpenPopup()
+	nnoremap <expr> <F3> <SID>OpenPopup()
+
+また、前のコマンドが実行される前に、先行入力を探す時に式が評価されることがある
+ことを覚えておいてください。例えば: >
+	func StoreColumn()
+	  let g:column = col('.')
+	  return 'x'
+	endfunc
+	nnoremap <expr> x StoreColumn()
+	nmap ! f!x
+g:column に "f!" 実行前の値がある、つまり "x" が評価されるのが "f!" の実行前で
+あることに気付くでしょう。
+これは評価のマッピングの文字の前に <Ignore> を挿入することで解決できます: >
+	nmap ! f!<Ignore>x
 
 副作用に注意してください。式は文字の取得中に評価されるため、簡単に異常動作を起
 こせてしまいます。そのため、次のものは制限されます:

doc/sign.jax

@@ -1,4 +1,4 @@
-*sign.txt*      For Vim バージョン 8.2.  Last change: 2020 Oct 28
+*sign.txt*      For Vim バージョン 8.2.  Last change: 2021 Mar 07
 
 
 		VIMリファレンスマニュアル    by Gordon Prieur
@@ -142,6 +142,9 @@
 	texthl={group}
 		テキスト部分に使用されるハイライトグループ。
 
+	例: >
+		:sign define MySign text=>> texthl=Search linehl=DiffText
+<
 
 (定義した)目印を削除する				*:sign-undefine* *E155*
 
@@ -151,7 +154,9 @@
 		既に定義された目印を削除する。{name}という名前の目印がまだ設置
 		されたままの場合はトラブルを引き起こす。
 
-
+		例: >
+			:sign undefine MySign
+<
 
 (定義した)目印を一覧表示する				*:sign-list* *E156*
 
@@ -204,6 +209,10 @@
 		上に同じ。バッファ番号を使用していることが異なる。buffer引数が
 		与えられていない場合は、現在のバッファに目印を設置する。
 
+		例: >
+			:sign place 10 line=99 name=sign3
+			:sign place 10 line=99 name=sign3 buffer=3
+<
 							*E885*
 :sign place {id} name={name} file={fname}
 		ファイル{fname}に{id}で設置された目印を、{name}で定義されてい
@@ -216,10 +225,17 @@
 		ループの目印を選択することができる。任意の "priority={prio}"
 		属性を使用して、既存の目印の優先順位を変更することができる。
 
+		例: >
+			:sign place 23 name=sign1 file=/path/to/edit.py
+<
 :sign place {id} name={name} buffer={nr}
 		上に同じ。バッファ番号を使用していることが異なる。buffer引数が
 		与えられていない場合は、現在のバッファを使用する。
 
+		例: >
+			:sign place 23 name=sign1
+			:sign place 23 name=sign1 buffer=7
+<
 
 (設置した)目印を解除する				*:sign-unplace* *E159*