Update eval.{txt,jax} #2

s/配置/設置/g
s/目印の識別子/目印ID/g

Author: h-east

doc/eval.jax

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim バージョン 8.1.  Last change: 2019 Jan 01
+*eval.txt*	For Vim バージョン 8.1.  Last change: 2019 Jan 06
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -2370,9 +2370,9 @@ 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}])
 				数値	目印を解除する
@@ -3872,20 +3872,24 @@ extend({expr1}, {expr2} [, {expr3}])			*extend()*
 
 feedkeys({string} [, {mode}])				*feedkeys()*
 		{string}中の各文字を、あたかもマッピングまたはユーザーによって
-		タイプされたかのように、処理キューに入れる。デフォルトではこれ
-		らの文字は先行入力バッファの末尾に付け足される。そのためマッピ
-		ングを展開している途中であれば、これらの文字はマッピングを展開
-		した後に来ることになる。他の文字の前に挿入するには、'i' フラグ
-		を使用する。それらはマッピングからの任意の文字の前の挿入の次に
-		実行される。
+		タイプされたかのように、処理キューに入れる。
+		
+		デフォルトではこれらの文字は先行入力バッファの末尾に付け足され
+		る。そのためマッピングを展開している途中であれば、これらの文字
+		はマッピングを展開した後に来ることになる。他の文字の前に挿入す
+		るには、'i' フラグを使用する。それらはマッピングからの任意の文
+		字の前の挿入の次に実行される。
+
 		この関数は、{string}中の文字が処理されるまでは待たない。
+
 		特殊なキーを{string}に含めるにはダブルクォートと "\..." 記法を
 		使う(|expr-quote|を参照)。例えば、feedkeys("\<CR>")は<Enter>
 		キーの押下をシミュレートする。しかしfeedkeys('\<CR>')とすると、
 		この文字の通り5文字を挿入する。
-		{mode}が省略されたときは、挿入されたキーはマップ展開の対象にな
-		る。{mode}は以下の文字フラグを含む文字列:
-		'm'	キーをマップ展開する。これが既定である。
+
+		{mode}は以下の文字フラグを含む文字列:
+		'm'	キーをマップ展開する。これが既定である。{mode}が省略さ
+			れたときは、挿入されたキーはマップ展開の対象になる。
 		'n'	キーをマップ展開しない。
 		't'	キーをタイプされたかのように扱う。そうでない場合は
 			マッピングから展開されたかのように扱われる。これは
@@ -3898,6 +3902,8 @@ feedkeys({string} [, {mode}])				*feedkeys()*
 			をすべて実行できる。Note Vimが挿入モードを終了したとき
 			は、スクリプト続行前の文字入力待ちによる立ち往生を避け
 			るために、<Esc>が入力されたかのように振る舞う。
+			Note コマンドの実行中に feedkeys() を再帰的に呼び出し
+			た場合、最後の呼び出しですべての先行入力が消費される。
 		'!'	'x' と一緒に使用すると挿入モードを終了しない。タイマー
 			が少し後で挿入モードを終了するように設定されているとき
 			にテストで使用できる。CursorHoldIのテストに便利である。
@@ -4263,10 +4269,10 @@ getbufinfo([{dict}])
 			lnum		バッファ内の現在の行番号。
 			loaded		バッファがロードされている場合はTRUE。
 			name		バッファ内のファイルへのフルパス。
-			signs		バッファに配置された目印のリスト。
+			signs		バッファに設置された目印のリスト。
 					各リスト項目は、次のフィールドを含む辞
 					書である:
-					    id	  目印識別子
+					    id	  目印ID
 					    lnum  行番号
 					    name  目印名
 			variables	バッファローカル変数の辞書への参照。
@@ -6516,7 +6522,9 @@ prop_add({lnum}, {col}, {props})
 		   end_lnum	テキスト終端の行番号
 		   end_col	テキストの直後の桁。"length" が与えられた場合
 				は使用されない。{col}と "end_col" が等しい場
-				合、これは幅ゼロのテキストプロパティである。
+				合、および "end_lnum" が省略されるか{lnum}と等
+				しい場合、これは幅ゼロのテキストプロパティであ
+				る。
 		   bufnr	プロパティを追加するバッファ。省略された場合、
 				カレントバッファが使用される
 		   id		プロパティのユーザー定義ID。 省略時は0が使われ
@@ -7233,7 +7241,8 @@ serverlist()					*serverlist()*
 <
 setbufline({expr}, {lnum}, {text})			*setbufline()*
 		バッファ {expr} の行 {lnum} を {text} に設定する。行を挿入する
-		場合には |append()| を使用する。
+		場合には |append()| を使用する。{lnum}内のテキストプロパティは
+		すべて消去される。
 
 		{expr} の使い方については前述の |bufname()| を参照。
 
@@ -7308,7 +7317,8 @@ setfperm({fname}, {mode})				*setfperm()* *chmod*
 setline({lnum}, {text})					*setline()*
 		カレントバッファの{lnum}行目を{text}にする。行を挿入したい場合
 		は |append()| を使う。別のバッファの行を変更したい場合は
-		|setbufline()| を使う。
+		|setbufline()| を使う。{lnum}内のテキストプロパティはすべて消
+		去される。
 
 		{lnum}は|getline()|のときと同じように解釈される。
 		{lnum}が最後の行の次の行の場合、新規行として{text}を追加する。
@@ -7644,17 +7654,18 @@ sign_define({name} [, {dict}])				*sign_define()*
 		更する。これは |:sign-define| コマンドに似ている。
 
 		名前の衝突を避けるために、{name}に一意のテキストを付けること。
-		目印を配置するような{group}はない。
+		目印を設置するような{group}はない。
 
 		{name}は文字列または数値である。任意の{dict}引数は目印属性を指
 		定する。以下の値がサポートされている:
 		   icon		目印用のビットマップファイルへのフルパス。
-		   linehl	目印が配置されている行全体に使用されるハイライ
+		   linehl	目印が設置されている行全体に使用されるハイライ
 				トグループ。
 		   text		アイコンがない場合、またはGUIが使用されていな
 				い場合に表示されるテキスト。
 		   texthl	text項目に使用されるハイライトグループ
-		既存の目印の場合は、属性が更新される。
+		{name}という名前の目印がすでに存在する場合は、その目印の属性が
+		更新される。
 
 		成功すると 0 を返し、失敗すると -1 を返す。
 
@@ -7672,7 +7683,7 @@ sign_getdefined([{name}])				*sign_getdefined()*
 
 		戻り値の各リスト項目は、次のエントリを持つ辞書である:
 		   icon		目印用のビットマップファイルへのフルパス。
-		   linehl	目印が配置されている行全体に使用されるハイライ
+		   linehl	目印が設置されている行全体に使用されるハイライ
 				トグループ。
 		   text		アイコンがない場合、またはGUIが使用されていな
 				い場合に表示されるテキスト。
@@ -7688,37 +7699,39 @@ sign_getdefined([{name}])				*sign_getdefined()*
 			echo sign_getdefined("mySign")
 <
 sign_getplaced([{expr} [, {dict}]])			*sign_getplaced()*
-		バッファまたはすべてのバッファに配置されている目印のリストを返
+		バッファまたはすべてのバッファに設置されている目印のリストを返
 		す。これは |:sign-place-list| コマンドに似ている。
 
-		任意のバッファ名{expr}が指定されている場合、そのバッファに配置
+		任意のバッファ名{expr}が指定されている場合、そのバッファに設置
 		されている目印のリストだけが返される。{expr}の使い方については
 		|bufname()| を参照。任意の{dict}には、以下のエントリを含めるこ
 		とができる。
 		   group	このグループの目印のみを選択する
 		   id		この識別子を持つ目印を選択する
-		   lnum		この行に配置されている目印を選択する。{lnum}の
+		   lnum		この行に設置されている目印を選択する。{lnum}の
 				使い方については |line()| を参照。
 		{group}が '*' の場合、グローバルグループを含むすべてのグループ
 		の目印が返される。 {group}が指定されていないか、空の文字列の場
 		合は、グローバルグループ内の目印のみが返される。引数が指定され
-		ていない場合は、すべてのバッファに配置されているグローバルグ
+		ていない場合は、すべてのバッファに設置されているグローバルグ
 		ループ内の目印が返される。
+		|sign-group| を参照。
 
 		戻り値の各リスト項目は、次のエントリを持つ辞書である:
 			bufnr	目印付きバッファの番号
-			signs	{bufnr}に配置されている目印のリスト。各リスト
+			signs	{bufnr}に設置されている目印のリスト。各リスト
 				項目は、以下の項目を含む辞書である。
 
 		各目印の辞書には、次のエントリが含まれている:
 			group	目印グループ。 グローバルグループの場合は '' に
 				設定する。
-			id	目印の識別子
-			lnum	目印が配置されている行番号
+			id	目印ID
+			lnum	目印が設置されている行番号
 			name	定義されている目印の名前
 			priority	目印の優先度
 
-		失敗した場合は空のリストを返す。
+		失敗した場合、または設置された目印がない場合は、空のリストを返
+		す。
 
 		例: >
 			" eval.c に設置されているグローバルグループの目印のリ
@@ -7741,7 +7754,7 @@ sign_getplaced([{expr} [, {dict}]])			*sign_getplaced()*
 			echo sign_getplaced("a.py", {'group' : 'g1',
 							\  'id' : 20'})
 
-			" 配置されているすべての目印のリストを取得する
+			" 設置されているすべての目印のリストを取得する
 			echo sign_getplaced()
 <
 							*sign_place()*
@@ -7750,27 +7763,28 @@ sign_place({id}, {group}, {name}, {expr} [, {dict}])
 		目印に{id}と{group}を割り当てる。これは |:sign-place| コマンド
 		に似ている。
 
-		目印の識別子{id}がゼロの場合は、新しい識別子が割り当てられる。
-		それ以外の場合は、指定された番号が使用される。{group}は目印グ
-		ループ名である。グローバルサイングループを使用するには、空の文
-		字列を使用する。{group}は{id}の名前空間として機能するため、2つ
-		のグループが同じIDを使用できる。
+		目印ID{id}がゼロの場合は、新しい識別子が割り当てられる。それ以
+		外の場合は、指定された番号が使用される。{group}は目印グループ
+		名である。グローバルサイングループを使用するには、空の文字列を
+		使用する。{group}は{id}の名前空間として機能するため、2つのグ
+		ループが同じIDを使用できる。詳細については|sign-identifier| を
+		参照。
 
 		{name}は定義済みの目印を参照する。
 		{expr}はバッファの名前か番号を参照する。許容値については、
 		|bufname()| を参照。
 
 		任意の{dict}引数は、以下のエントリをサポートする:
-			lnum		目印が配置されるバッファ{expr}の行番
+			lnum		目印が設置されるバッファ{expr}の行番
 					号。許容値については、|line()| を参照。
 			priority	目印の優先順位。詳細については
 					|sign-priority| を参照。
 
 		任意の{dict}が指定されていない場合は、定義されている目印{name}
-		を使用するようにグループ{group}内の配置された目印{id}を変更し
+		を使用するようにグループ{group}内の設置された目印{id}を変更し
 		ます。
 
-		成功した場合は目印の識別子、失敗した場合は -1 を返す。
+		成功した場合は目印ID、失敗した場合は -1 を返す。
 
 		例: >
 			" バッファ json.c の20行目に識別子5で sign1 という名前
@@ -7788,7 +7802,7 @@ sign_place({id}, {group}, {name}, {expr} [, {dict}])
 							\ {'lnum' : 30})
 
 			" バッファ json.c の40行目に 'g3' グループで識別子10の
-			" sign4 という名前の目印を優先順位90で配置する
+			" sign4 という名前の目印を優先順位90で設置する
 			call sign_place(10, 'g3', 'sign4', 'json.c',
 					\ {'lnum' : 40, 'priority' : 90})
 <
@@ -7807,7 +7821,7 @@ sign_undefine([{name}])					*sign_undefine()*
 			call sign_undefine()
 <
 sign_unplace({group} [, {dict}])			*sign_unplace()*
-		配置済みの1つ以上のバッファ内の目印を解除する。これは
+		設置済みの1つ以上のバッファ内の目印を解除する。これは
 		|:sign-unplace| コマンドに似ている。
 
 		{group}は目印グループ名である。グローバルサイングループを使用
@@ -7816,7 +7830,7 @@ sign_unplace({group} [, {dict}])			*sign_unplace()*
 		{group}内の目印は、{dict}内のエントリに基づいて選択される。
 		{dict}の以下の任意のエントリがサポートされている:
 			buffer	バッファの名前または番号。|bufname()| を参照。
-			id	目印の識別子
+			id	目印ID
 		{dict}が指定されていない場合は、{group}内のすべての目印が解除
 		される。
 
@@ -9230,8 +9244,8 @@ undofile({name})					*undofile()*
 		{name} が空の場合 undofile() は空文字列を返す。ファイル名のな
 		いバッファはアンドゥファイルを書かないからである。
 		|:wundo| や |:rundo| と組み合わせて使うと便利だろう。
-		+persistent_undo オプションを無効にしてコンパイルされた場合は
-		この関数は常に空文字列を返す。
+		|+persistent_undo| オプションを無効にしてコンパイルされた場合
+		はこの関数は常に空文字列を返す。
 
 undotree()						*undotree()*
 		アンドゥツリーの現在の状態を辞書で返す。辞書の内容は次のとお

en/eval.txt

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim version 8.1.  Last change: 2019 Jan 01
+*eval.txt*	For Vim version 8.1.  Last change: 2019 Jan 06
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -3945,20 +3945,24 @@ extend({expr1}, {expr2} [, {expr3}])			*extend()*
 feedkeys({string} [, {mode}])				*feedkeys()*
 		Characters in {string} are queued for processing as if they
 		come from a mapping or were typed by the user.
+
 		By default the string is added to the end of the typeahead
 		buffer, thus if a mapping is still being executed the
 		characters come after them.  Use the 'i' flag to insert before
 		other characters, they will be executed next, before any
 		characters from a mapping.
+
 		The function does not wait for processing of keys contained in
 		{string}.
+
 		To include special keys into {string}, use double-quotes
 		and "\..." notation |expr-quote|. For example,
 		feedkeys("\<CR>") simulates pressing of the <Enter> key. But
 		feedkeys('\<CR>') pushes 5 characters.
-		If {mode} is absent, keys are remapped.
+
 		{mode} is a String, which can contain these character flags:
-		'm'	Remap keys. This is default.
+		'm'	Remap keys. This is default.  If {mode} is absent,
+			keys are remapped.
 		'n'	Do not remap keys.
 		't'	Handle keys as if typed; otherwise they are handled as
 			if coming from a mapping.  This matters for undo,
@@ -3972,6 +3976,9 @@ feedkeys({string} [, {mode}])				*feedkeys()*
 			will behave as if <Esc> is typed, to avoid getting
 			stuck, waiting for a character to be typed before the
 			script continues.
+			Note that if you manage to call feedkeys() while
+			executing commands, thus calling it recursively, the
+			all typehead will be consumed by the last call.
 		'!'	When used with 'x' will not end Insert mode. Can be
 			used in a test when a timer is set to exit Insert mode
 			a little later.  Useful for testing CursorHoldI.
@@ -6700,8 +6707,9 @@ prop_add({lnum}, {col}, {props})
 				another line; can be zero
 		   end_lnum	line number for the end of text
 		   end_col	column just after the text; not used when "length"
-				is present; when {col} and "end_col" are equal
-				this is a zero-width text property
+				is present; when {col} and "end_col" are
+				equal, and "end_lnum" is omitted or equal to
+				{lnum}, this is a zero-width text property
 		   bufnr	buffer to add the property to; when omitted
 		   		the current buffer is used
 		   id		user defined ID for the property; when omitted
@@ -7454,7 +7462,8 @@ serverlist()					*serverlist()*
 <
 setbufline({expr}, {lnum}, {text})			*setbufline()*
 		Set line {lnum} to {text} in buffer {expr}.  To insert
-		lines use |append()|.
+		lines use |append()|.  Any text properties in {lnum} are
+		cleared.
 
 		For the use of {expr}, see |bufname()| above.
 
@@ -7534,7 +7543,7 @@ setfperm({fname}, {mode})				*setfperm()* *chmod*
 setline({lnum}, {text})					*setline()*
 		Set line {lnum} of the current buffer to {text}.  To insert
 		lines use |append()|. To set lines in another buffer use
-		|setbufline()|.
+		|setbufline()|.  Any text properties in {lnum} are cleared.
 
 		{lnum} is used like with |getline()|.
 		When {lnum} is just below the last line the {text} will be
@@ -7891,7 +7900,9 @@ sign_define({name} [, {dict}])				*sign_define()*
 		   text		text that is displayed when there is no icon
 				or the GUI is not being used.
 		   texthl	highlight group used for the text item
-		For an existing sign, the attributes are updated.
+
+		If the sign named {name} already exists, then the attributes
+		of the sign are updated.
 
 		Returns 0 on success and -1 on failure.
 
@@ -7944,6 +7955,7 @@ sign_getplaced([{expr} [, {dict}]])			*sign_getplaced()*
 		empty string, then only signs in the global group are
 		returned.  If no arguments are supplied, then signs in the
 		global group placed in all the buffers are returned.
+		See |sign-group|.
 
 		Each list item in the returned value is a dictionary with the
 		following entries:
@@ -7959,7 +7971,8 @@ sign_getplaced([{expr} [, {dict}]])			*sign_getplaced()*
 			name	name of the defined sign
 			priority	sign priority
 
-		Returns an empty list on failure.
+		Returns an empty list on failure or if there are no placed
+		signs.
 
 		Examples: >
 			" Get a List of signs placed in eval.c in the
@@ -7992,7 +8005,8 @@ sign_place({id}, {group}, {name}, {expr} [, {dict}])
 		allocated.  Otherwise the specified number is used. {group} is
 		the sign group name. To use the global sign group, use an
 		empty string.  {group} functions as a namespace for {id}, thus
-		two groups can use the same IDs.
+		two groups can use the same IDs. Refer to |sign-identifier|
+		for more information.
 
 		{name} refers to a defined sign.
 		{expr} refers to a buffer name or number. For the accepted
@@ -9496,7 +9510,7 @@ undofile({name})					*undofile()*
 		If {name} is empty undofile() returns an empty string, since a
 		buffer without a file name will not write an undo file.
 		Useful in combination with |:wundo| and |:rundo|.
-		When compiled without the +persistent_undo option this always
+		When compiled without the |+persistent_undo| option this always
 		returns an empty string.
 
 undotree()						*undotree()*