Update eval.{txt,jax}

Author: h-east

doc/eval.jax

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim バージョン 8.1.  Last change: 2018 Dec 18
+*eval.txt*	For Vim バージョン 8.1.  Last change: 2018 Dec 24
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -2274,7 +2274,7 @@ prompt_setcallback({buf}, {expr}) なし	プロンプトコールバック関数
 prompt_setinterrupt({buf}, {text}) なし	プロンプト割り込み関数を設定する
 prompt_setprompt({buf}, {text}) なし	プロンプトテキストを設定する
 prop_add({lnum}, {col}, {props})  なし	テキストプロパティを追加
-prop_clear({lnum} [, {lnum-end} [, {bufnr}]])
+prop_clear({lnum} [, {lnum-end} [, {props}]])
 				なし	全てのテキストプロパティを削除
 prop_find({props} [, {direction}])
 				辞書	テキストプロパティを検索する
@@ -2367,6 +2367,15 @@ shellescape({string} [, {special}])
 				文字列	{string}をシェルコマンド引数として使う
 					ためにエスケープする。
 shiftwidth([{col}])		数値	実際に使用される 'shiftwidth' の値
+sign_define({name} [, {dict}])	数値	目印を定義または更新する
+sign_getdefined([{name}])	リスト	定義されている目印のリストを取得する
+sign_getplaced([{expr} [, {dict}]])
+				リスト	配置されている目印のリストを取得する
+sign_place({id}, {group}, {name}, {expr} [, {dict}])
+				数値	目印を配置する
+sign_undefine([{name}])		数値	目印を削除する
+sign_unplace({group} [, {dict}])
+				数値	目印を解除する
 simplify({filename})		文字列	ファイル名を可能なかぎり簡略化する
 sin({expr})			浮動小数点数	{expr} の正弦(サイン)
 sinh({expr})			浮動小数点数	{expr}のハイパボリックサイン
@@ -6501,8 +6510,8 @@ prop_add({lnum}, {col}, {props})
 			"length"   - テキストの文字の長さ。別の行に続かないプ
 				     ロパティに対してのみ使用できる
 			"end_lnum" - テキスト終端の行番号
-			"end_col"  - テキスト終端の列。"length" が与えられた場
-				     合は使用されない
+			"end_col"  - テキストの最後の桁。"length" が与えられた
+				     場合は使用されない
 			"bufnr"	   - プロパティを追加するバッファ。省略された
 				     場合、カレントバッファが使用される
 			"id"	   - プロパティのユーザー定義ID。 省略時は0が
@@ -6516,6 +6525,10 @@ prop_add({lnum}, {col}, {props})
 		"end_col" を使用する。
 		"length" または "end_col" のどちらも渡されない場合、プロパティ
 		は1文字に適用される。
+		プロパティは、テキストの最後の文字、またはその直後で終わらせる
+		ことができる。最後のケースでは、テキストが行に追加されると、プ
+		ロパティタイプに "end_incl" が設定されていない場合にも、テキス
+		トプロパティのサイズが増える。
 
 		プロパティが追加されたバッファで、"type" が最初に検索される。
 		見つからない場合は、グローバルプロパティタイプが使用される。見
@@ -7625,6 +7638,217 @@ shiftwidth([{col}])						*shiftwidth()*
 		'vartabstop' 設定が有効で、引数{col}が指定されていない場合、桁
 		番号1だと仮定される。
 
+sign_define({name} [, {dict}])				*sign_define()*
+		{name}という名前の新しい目印を定義するか、既存の目印の属性を変
+		更する。これは |:sign-define| コマンドに似ている。
+
+		名前の衝突を避けるために、{name}に一意のテキストを付けること。
+		目印を配置するような{group}はない。
+
+		{name}は文字列または数値である。任意の{dict}引数は目印属性を指
+		定する。以下の値がサポートされている:
+		    icon	目印用のビットマップファイルへのフルパス。
+		    linehl	目印が配置されている行全体に使用されるハイライ
+				トグループ。
+		    text	アイコンがない場合、またはGUIが使用されていな
+				い場合に表示されるテキスト。
+		    texthl	text項目に使用されるハイライトグループ
+		既存の目印の場合は、属性が更新される。
+
+		成功すると 0 を返し、失敗すると -1 を返す。
+
+		例: >
+			call sign_define("mySign", {"text" : "=>", "texthl" :
+					\ "Error", "linehl" : "Search"})
+<
+sign_getdefined([{name}])				*sign_getdefined()*
+		定義済みの目印とその属性のリストを取得する。
+		これは |:sign-list| コマンドに似ている。
+
+		{name}が指定されていない場合は、定義されているすべての目印のリ
+		ストが返される。そうでなければ、指定された目印の属性が返され
+		る。
+
+		戻り値の各リスト項目は、次のエントリを持つ辞書である:
+			icon	目印用のビットマップファイルへのフルパス。
+			linehl	目印が配置されている行全体に使用されるハイライ
+				トグループ。
+			text	アイコンがない場合、またはGUIが使用されていな
+				い場合に表示されるテキスト。
+			texthl	text項目に使用されるハイライトグループ
+
+		目印がなく、{name}が見つからない場合は、空のListを返す。
+
+		例: >
+			" すべての定義済み目印のリストを取得する
+			echo sign_getdefined()
+
+			" mySignという名前の目印の属性を取得する
+			echo sign_getdefined("mySign")
+<
+sign_getplaced([{expr} [, {dict}]])			*sign_getplaced()*
+		バッファまたはすべてのバッファに配置されている目印のリストを返
+		す。これは |:sign-place-list| コマンドに似ている。
+
+		任意のバッファ名{expr}が指定されている場合、そのバッファに配置
+		されている目印のリストだけが返される。{expr}の使い方については
+		|bufname()| を参照。任意の{dict}には、以下のエントリを含めるこ
+		とができる。
+			group	このグループの目印のみを選択する
+			id	この識別子を持つ目印を選択する
+			lnum	この行に配置されている目印を選択する。{lnum}の
+				使い方については |line()| を参照。
+		{group}が '*' の場合、グローバルグループを含むすべてのグループ
+		の目印が返される。 {group}が指定されていない場合は、グローバル
+		グループ内の目印のみが返される。引数が指定されていない場合は、
+		すべてのバッファに配置されているグローバルグループ内の目印が返
+		される。
+
+		戻り値の各リスト項目は、次のエントリを持つ辞書である:
+			bufnr	目印付きバッファの番号
+			signs	{bufnr}に配置されている目印のリスト。各リスト
+				項目は、以下の項目を含む辞書である。
+
+		各目印の辞書には、次のエントリが含まれている:
+			group	目印グループ。 グローバルグループの場合は '' に
+				設定する。
+			id	目印の識別子
+			lnum	目印が配置されている行番号
+			name	定義されている目印の名前
+			priority	目印の優先度
+
+		失敗した場合は空のリストを返す。
+
+		例: >
+			" eval.c に設置されているグローバルグループの目印のリ
+			" ストを取得する
+			echo sign_getplaced("eval.c")
+
+			" eval.c の 'g1' グループに設置されている目印のリスト
+			" を取得する
+			echo sign_getplaced("eval.c", {'group' : 'g1'})
+
+			" eval.c の 10行目に設置されている目印のリストを取得す
+			" る
+			echo sign_getplaced("eval.c", {'lnum' : 10})
+
+			" a.py に設置されている識別子 10 の目印を取得する
+			echo sign_getplaced("a.py", {'id' : 10'})
+
+			" a.py の 'g1' グループ 'g1' に設置されている識別子 20
+			" の目印を取得する
+			echo sign_getplaced("a.py", {'group' : 'g1',
+							\  'id' : 20'})
+
+			" 配置されているすべての目印のリストを取得する
+			echo sign_getplaced()
+<
+							*sign_place()*
+sign_place({id}, {group}, {name}, {expr} [, {dict}])
+		{name}として定義された目印をファイル{expr}の行{lnum}に設置し、
+		目印に{id}と{group}を割り当てる。これは |:sign-place| コマンド
+		に似ている。
+
+		目印の識別子{id}がゼロの場合は、新しい識別子が割り当てられる。
+		それ以外の場合は、指定された番号が使用される。{group}は目印グ
+		ループ名である。グローバルサイングループを使用するには、空の文
+		字列を使用する。{group}は{id}の名前空間として機能するため、2つ
+		のグループが同じIDを使用できる。
+
+		{name}は定義済みの目印を参照する。
+		{expr}はバッファの名前か番号を参照する。許容値については、
+		|bufname()| を参照。
+
+		任意の{dict}引数は、以下のエントリをサポートする:
+			lnum		目印が配置されるバッファ{expr}の行番
+					号。許容値については、|line()| を参照。
+			priority	目印の優先順位。詳細については
+					|sign-priority| を参照。
+
+		任意の{dict}が指定されていない場合は、定義されている目印{name}
+		を使用するようにグループ{group}内の配置された目印{id}を変更し
+		ます。
+
+		成功した場合は目印の識別子、失敗した場合は -1 を返す。
+
+		例: >
+			" バッファ json.c の20行目に識別子5で sign1 という名前
+			" の目印を設置する
+			call sign_place(5, '', 'sign1', 'json.c',
+							\ {'lnum' : 20})
+
+			" バッファ json.c の識別子5が目印 sign2 を使用するよう
+			" に更新する
+			call sign_place(5, '', 'sign2', 'json.c')
+
+			" バッファ json.c の30行目に sign3 という名前の目印を
+			" 新しい識別子で設置する
+			let id = sign_place(0, '', 'sign3', 'json.c',
+							\ {'lnum' : 30})
+
+			" バッファ json.c の40行目に 'g3' グループで識別子10の
+			" sign4 という名前の目印を優先順位90で配置する
+			call sign_place(10, 'g3', 'sign4', 'json.c',
+					\ {'lnum' : 40, 'priority' : 90})
+<
+sign_undefine([{name}])					*sign_undefine()*
+		定義済みの目印{name}を削除する。これは |:sign-undefine| コマン
+		ドに似ている。{name}が指定されていない場合は、定義されているす
+		べての目印を削除する。
+
+		成功すると 0 を返し、失敗すると -1 を返す。
+
+		例: >
+			" mySign という名前の目印を削除する
+			call sign_undefine("mySign")
+
+			" すべての目印を削除する
+			call sign_undefine()
+<
+sign_unplace({group} [, {dict}])			*sign_unplace()*
+		配置済みの1つ以上のバッファ内の目印を解除する。これは
+		|:sign-unplace()| コマンドに似ている。
+
+		{group}は目印グループ名である。グローバルサイングループを使用
+		するには、空の文字列を使用する。{group}が '*' に設定されている
+		場合、グローバルグループを含むすべてのグループが使用される。
+		{group}内の目印は、{dict}内のエントリに基づいて選択される。
+		{dict}の以下の任意のエントリがサポートされている:
+			buffer	バッファの名前または番号。|bufname()| を参照。
+			id	目印の識別子
+		{dict}が指定されていない場合は、{group}内のすべての目印が解除
+		される。
+
+		成功すると 0 を返し、失敗すると -1 を返す。
+
+		例: >
+			" バッファ a.vim から識別子10の目印を解除する
+			call sign_unplace('', {'buffer' : "a.vim", 'id' : 10})
+
+			" バッファ番号3から 'g1' グループの識別子20の目印を解
+			" 除する
+			call sign_unplace('g1', {'buffer' : 3, 'id' : 20})
+
+			" バッファ番号10から 'g2' グループのすべての目印を解除
+			" する
+			call sign_unplace('g2', {'buffer' : 10})
+
+			" すべてのバッファから 'g3' グループの識別子30の目印を
+			" 解除する
+			call sign_unplace('g3', {'id' : 30})
+
+			" バッファ番号5 のすべての目印を解除する
+			call sign_unplace('*', {'buffer' : 5})
+
+			" すべてのバッファから 'g4' グループの目印を解除する
+			call sign_unplace('g4')
+
+			" すべてのバッファから識別子40の目印を解除する
+			call sign_unplace('*', {'id' : 40})
+
+			" すべてのバッファからすべての目印を解除する
+			call sign_unplace('*')
+<
 simplify({filename})					*simplify()*
 		ファイル名を、意味を変えずにできるだけ簡略化する。MS-Windowsで
 		のショートカットやUnixでのシンボリックリンクは解決される。
@@ -8755,8 +8979,9 @@ test_ignore_error({expr})			 *test_ignore_error()*
 		これは、テストにおいて、try/catch を用いてエラーを捕捉できない
 		(以降のコードをスキップするので)場合のみに使うことを意図してい
 		る。
-		{expr} は文字通り用いられ、パターンとしてではない。
-		現在、これを元に戻す方法はない。
+		{expr} はパターンとしてではなく、文字として用いられる。
+		{expr} が文字列 "RESET" の場合、無視されるエラーのリストは空に
+		なる。
 
 test_null_channel()					*test_null_channel()*
 		null の Channel を返す。これはテストのみに使われる。
@@ -10444,8 +10669,8 @@ Vimはこれを見つけると、まず波括弧の中の式を評価し、そ
 			しかし印字不可能な文字は解釈されずに表示される。
 			|:echo|とはかなり異なり、むしろ|:execute|に近い方法で
 			解析がされる。なんらかを表示する前に、まず最初に全ての
-			式が評価し、連結する。式を評価した値は数値か文字列でな
-			ければならない。辞書やリストはエラーとなる。
+			式が数値または文字列に評価されない場合は、string() を
+			使用して文字列に変換する。
 			強調を行うには|:echohl|コマンドを使う。
 			例: >
 		:echomsg "It's a Zizzer Zazzer Zuzz, as you can plainly see."
@@ -10455,9 +10680,9 @@ Vimはこれを見つけると、まず波括弧の中の式を評価し、そ
 :echoe[rr] {expr1} ..	式をエラーメッセージとして表示し、そのメッセージを
 			メッセージ履歴|message-history|に保存する。スクリプト
 			や関数の中で使用されたときは行番号が付け加えられる。
-			|:echo|コマンドと同様に引数の間にスペースが挿入される。
-			try条件文の中で使用されたときは、このメッセージがエ
-			ラー例外として投げられる。(|try-echoerr|を参照)
+			|:echomsg| コマンドと同様に引数の間にスペースが挿入さ
+			れる。try条件文の中で使用されたときは、このメッセージ
+			がエラー例外として投げられる。(|try-echoerr|を参照)
 			例: >
 		:echoerr "This script just failed!"
 <