Merge pull request #1607 from vim-jp/hh-update-builtin

Update builtin.{txt,jax}

doc/builtin.jax

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Jun 17
+*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Jun 23
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -28,8 +28,8 @@ acos({expr})			浮動小数点数	{expr}のアークコサイン
 add({object}, {item})		リスト/Blob	{item}を{object}に追加する
 and({expr}, {expr})		数値	ビット論理積
 append({lnum}, {text})		数値	{lnum}行目に{text}を付け加える
-appendbufline({expr}, {lnum}, {text})
-				数値	バッファ{expr}の{lnum}行目に{text}を付
+appendbufline({buf}, {lnum}, {text})
+				数値	バッファ{buf}の{lnum}行目に{text}を付
 					け加える
 argc([{winid}])			数値	引数内のファイルの数
 argidx()			数値	引数リスト内の現在のインデックス
@@ -73,6 +73,9 @@ balloon_gettext()		文字列	バルーン内のカレントテキストを得る
 balloon_show({expr})		なし	{expr} をバルーン内に表示
 balloon_split({msg})		リスト	{msg} をバルーンで使われるように分割す
 					る
+bindtextdomain({package}, {path})
+				なし	指定されたパスにテキストドメインをバイ
+					ンドする
 blob2list({blob})		リスト	{blob} を数値のリストに変換する
 browse({save}, {title}, {initdir}, {default})
 				文字列	ファイル選択ダイアログを表示
@@ -293,7 +296,8 @@ gettabvar({nr}, {varname} [, {def}])
 gettabwinvar({tabnr}, {winnr}, {name} [, {def}])
 				任意	タブページ{tabnr}の{winnr}の{name}
 gettagstack([{nr}])		辞書	ウィンドウ{nr}のタグスタックを取得
-gettext({text})			文字列	{text} の翻訳の検索
+gettext({text} [, {package}])
+				文字列	{text} の翻訳の検索
 getwininfo([{winid}])		リスト	各ウィンドウに関する情報のリスト
 getwinpos([{timeout}])		リスト	Vim ウィンドウのピクセルでの X および
 					Y 座標
@@ -469,6 +473,8 @@ popup_move({id}, {options})	なし	ポップアップウィンドウ {id} の位
 					セットする
 popup_notification({what}, {options})
 				数値	ポップアップウィンドウの通知を作成する
+popup_setbuf({id}, {buf})	真偽値	ポップアップウィンドウ {id} のバッファ
+					を設定する
 popup_setoptions({id}, {options})
 				なし	ポップアップウィンドウ {id} のオプショ
 					ンを設定する
@@ -572,8 +578,8 @@ searchpos({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]])
 server2client({clientid}, {string})
 				数値	返信文字列を送信する
 serverlist()			文字列	利用可能なサーバーのリストを取得
-setbufline({expr}, {lnum}, {text})
-				数値	バッファ {expr} の {lnum} 行目に {text}
+setbufline({buf}, {lnum}, {text})
+				数値	バッファ {buf} の {lnum} 行目に {text}
 					を設定する
 setbufvar({buf}, {varname}, {val})	バッファ{buf}内の変数{varname}に{val}を
 					セット
@@ -1284,6 +1290,12 @@ balloon_split({msg})					*balloon_split()*
 
 		戻り値の型: list<any> または list<string>
 
+bindtextdomain({package}, {path})			*bindtextdomain()*
+		特定の {package} を {path} にバインドし、|gettext()| 関数を使っ
+		てパッケージの言語固有の翻訳を取得できるようにする。{path} は
+		翻訳のディレクトリ名である。|package-create| を参照。
+
+		戻り値の型: なし
 
 blob2list({blob})					*blob2list()*
 		Blob {blob} の各バイトを数値として保持するリストを返す。例: >
@@ -2597,7 +2609,7 @@ execute({command} [, {silent}])					*execute()*
 		|method| としても使用できる: >
 			GetCommand()->execute()
 <
-		戻り値の型: |Number|
+		戻り値の型: |String|
 
 
 exepath({expr})						*exepath()*
@@ -4944,14 +4956,17 @@ gettagstack([{winnr}])					*gettagstack()*
 		戻り値の型: dict<any>
 
 
-gettext({text})						*gettext()*
+gettext({text} [, {package}])				*gettext()*
 		可能であれば文字列 {text} を翻訳する。
 		これは主に配布する Vim script で使う。
 		メッセージの翻訳を生成するときに {text} が xgettext によって抽
 		出され、翻訳者が .po ファイルで翻訳済みメッセージを追加でき
 		Vim は gettext() が呼ばれた時に翻訳を検索する。
 		{text} はダブルクォートの文字列が望しい、なぜなら xgettext は
 		シングルクォートの文字列でのエスケープを理解しないため。
+		{package} が指定されると、その特定のパッケージの翻訳が検索され
+		る。|bindtextdomain()| 関数を使用して翻訳を検索するパスを指定
+		する必要がある。
 
 		戻り値の型: |String|
 

en/builtin.txt

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim version 9.1.  Last change: 2024 Jun 17
+*builtin.txt*	For Vim version 9.1.  Last change: 2024 Jun 23
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -28,9 +28,9 @@ acos({expr})			Float	arc cosine of {expr}
 add({object}, {item})		List/Blob   append {item} to {object}
 and({expr}, {expr})		Number	bitwise AND
 append({lnum}, {text})		Number	append {text} below line {lnum}
-appendbufline({expr}, {lnum}, {text})
+appendbufline({buf}, {lnum}, {text})
 				Number	append {text} below line {lnum}
-					in buffer {expr}
+					in buffer {buf}
 argc([{winid}])			Number	number of files in the argument list
 argidx()			Number	current index in the argument list
 arglistid([{winnr} [, {tabnr}]]) Number	argument list id
@@ -67,6 +67,8 @@ autocmd_get([{opts}])		List	return a list of autocmds
 balloon_gettext()		String	current text in the balloon
 balloon_show({expr})		none	show {expr} inside the balloon
 balloon_split({msg})		List	split {msg} as used for a balloon
+bindtextdomain({package}, {path})
+				none	bind text domain to specied path
 blob2list({blob})		List	convert {blob} into a list of numbers
 browse({save}, {title}, {initdir}, {default})
 				String	put up a file requester
@@ -153,8 +155,8 @@ diff_filler({lnum})		Number	diff filler lines about {lnum}
 diff_hlID({lnum}, {col})	Number	diff highlighting at {lnum}/{col}
 digraph_get({chars})		String	get the |digraph| of {chars}
 digraph_getlist([{listall}])	List	get all |digraph|s
-digraph_set({chars}, {digraph})	Boolean	register |digraph|
-digraph_setlist({digraphlist})	Boolean	register multiple |digraph|s
+digraph_set({chars}, {digraph})	Bool	register |digraph|
+digraph_setlist({digraphlist})	Bool	register multiple |digraph|s
 echoraw({expr})			none	output {expr} as-is
 empty({expr})			Number	|TRUE| if {expr} is empty
 environ()			Dict	return environment variables
@@ -277,7 +279,8 @@ gettabvar({nr}, {varname} [, {def}])
 gettabwinvar({tabnr}, {winnr}, {name} [, {def}])
 				any	{name} in {winnr} in tab page {tabnr}
 gettagstack([{nr}])		Dict	get the tag stack of window {nr}
-gettext({text})			String	lookup translation of {text}
+gettext({text} [, {package}])
+				String	lookup translation of {text}
 getwininfo([{winid}])		List	list of info about each window
 getwinpos([{timeout}])		List	X and Y coord in pixels of Vim window
 getwinposx()			Number	X coord in pixels of the Vim window
@@ -429,6 +432,7 @@ popup_menu({what}, {options})	Number	create a popup window used as a menu
 popup_move({id}, {options})	none	set position of popup window {id}
 popup_notification({what}, {options})
 				Number	create a notification popup window
+popup_setbuf({id}, {buf})	Bool	set the buffer for the popup window {id}
 popup_setoptions({id}, {options})
 				none	set options for popup window {id}
 popup_settext({id}, {text})	none	set the text of popup window {id}
@@ -525,9 +529,9 @@ searchpos({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]])
 server2client({clientid}, {string})
 				Number	send reply string
 serverlist()			String	get a list of available servers
-setbufline({expr}, {lnum}, {text})
+setbufline({buf}, {lnum}, {text})
 				Number	set line {lnum} to {text} in buffer
-					{expr}
+					{buf}
 setbufvar({buf}, {varname}, {val})
 				none	set {varname} in buffer {buf} to {val}
 setcellwidths({list})		none	set character cell width overrides
@@ -1217,6 +1221,13 @@ balloon_split({msg})					*balloon_split()*
 
 		Return type: list<any> or list<string>
 
+bindtextdomain({package}, {path})			*bindtextdomain()*
+		Bind a specific {package} to a {path} so that the
+		|gettext()| function can be used to get language-specific
+		translations for a package.  {path} is the directory name
+		for the translations. See |package-create|.
+
+		Return type: none
 
 blob2list({blob})					*blob2list()*
 		Return a List containing the number value of each byte in Blob
@@ -2579,7 +2590,7 @@ execute({command} [, {silent}])					*execute()*
 		Can also be used as a |method|: >
 			GetCommand()->execute()
 <
-		Return type: |Number|
+		Return type: |String|
 
 
 exepath({expr})						*exepath()*
@@ -4977,7 +4988,7 @@ gettagstack([{winnr}])					*gettagstack()*
 		Return type: dict<any>
 
 
-gettext({text})						*gettext()*
+gettext({text} [, {package}])				*gettext()*
 		Translate String {text} if possible.
 		This is mainly for use in the distributed Vim scripts.  When
 		generating message translations the {text} is extracted by
@@ -4987,6 +4998,9 @@ gettext({text})						*gettext()*
 		For {text} double quoted strings are preferred, because
 		xgettext does not understand escaping in single quoted
 		strings.
+		When the {package} is specified, the translation is looked up
+		for that specific package. You need to specify the path to
+		look for translations with the |bindtextdomain()| function.
 
 		Return type: |String|