Update builtin.{txt,jax}

Author: h-east

doc/builtin.jax

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Nov 01
+*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Nov 06
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -513,9 +513,9 @@ prop_type_list([{props}])	リスト	プロパティタイプ一覧を取得
 pum_getpos()			辞書	ポップアップメニューが表示されている場
 					合、位置とサイズを取得
 pumvisible()			数値	ポップアップメニューが表示されているか
-py3eval({expr})			任意	|python3| の式を評価する
-pyeval({expr})			任意	|Python| の式を評価する
-pyxeval({expr})			任意	|python_x| の式を評価する
+py3eval({expr}[, {locals}])	任意	|python3| の式を評価する
+pyeval({expr}[, {locals}])	任意	|Python| の式を評価する
+pyxeval({expr}[, {locals}])	任意	|python_x| の式を評価する
 rand([{expr}])			数値	疑似乱数を取得する
 range({expr} [, {max} [, {stride}]])
 				リスト	{expr}から{max}までの要素のリスト
@@ -7982,9 +7982,14 @@ pumvisible()						*pumvisible()*
 		戻り値の型: |Number|
 
 
-py3eval({expr})						*py3eval()*
+py3eval({expr}[, {locals}])				*py3eval()*
 		Python の式 {expr} を評価して、結果を Vim のデータ形式にして返
 		す。
+		{locals} |Dictionary| が指定されている場合は、式で使用できる
+		ローカル変数のセットを定義する。キーは変数名で、値は変数の値で
+		ある。|Dictionary| と |List| の値は参照され、式によって
+		(|python-bindeval| が使用されたかのように) 更新される場合があ
+		る。
 		数値と文字列はそのまま返る (ただし文字列はコピーされ、Unicode
 		から 'encoding' に変換される)。
 		リストは Vim の |List| 型に変換される。
@@ -7994,15 +7999,17 @@ py3eval({expr})						*py3eval()*
 
 		|method| としても使用できる: >
 			GetExpr()->py3eval()
+			'b",".join(l)'->py3eval({'l': ['a', 'b', 'c']})
 <
 		戻り値の型: any。{expr} による
 
 		{|+python3| 機能付きでコンパイルされたときのみ利用可能}
 
 							*E858* *E859*
-pyeval({expr})						*pyeval()*
+pyeval({expr}[, {locals}])				*pyeval()*
 		Python の式 {expr} を評価して、結果を Vim のデータ形式にして返
 		す。
+		{locals} については |py3eval()| を参照。
 		数値と文字列はそのまま返る (ただし文字列はコピーされる)。
 		リストは Vim の |List| 型に変換される。
 		辞書は Vim の |Dictionary| 型に変換される。文字列ではない辞書
@@ -8016,9 +8023,10 @@ pyeval({expr})						*pyeval()*
 
 		{|+python| 機能付きでコンパイルされたときのみ利用可能}
 
-pyxeval({expr})						*pyxeval()*
+pyxeval({expr}[, {locals}])				*pyxeval()*
 		Python の式 {expr} を評価して、結果を Vim のデータ形式にして返
 		す。
+		{locals} については |py3eval()| を参照。
 		Python 2 または 3 を使用する。|python_x| と 'pyxversion' を参
 		照。
 		|pyeval()|, |py3eval()| も参照。

en/builtin.txt

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim version 9.1.  Last change: 2024 Nov 01
+*builtin.txt*	For Vim version 9.1.  Last change: 2024 Nov 06
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -467,9 +467,9 @@ prop_type_get({name} [, {props}])
 prop_type_list([{props}])	List	get list of property types
 pum_getpos()			Dict	position and size of pum if visible
 pumvisible()			Number	whether popup menu is visible
-py3eval({expr})			any	evaluate |python3| expression
-pyeval({expr})			any	evaluate |Python| expression
-pyxeval({expr})			any	evaluate |python_x| expression
+py3eval({expr}[, {locals}])	any	evaluate |python3| expression
+pyeval({expr}[, {locals}])	any	evaluate |Python| expression
+pyxeval({expr}[, {locals}])	any	evaluate |python_x| expression
 rand([{expr}])			Number	get pseudo-random number
 range({expr} [, {max} [, {stride}]])
 				List	items from {expr} to {max}
@@ -8127,9 +8127,14 @@ pumvisible()						*pumvisible()*
 		Return type: |Number|
 
 
-py3eval({expr})						*py3eval()*
+py3eval({expr}[, {locals}])				*py3eval()*
 		Evaluate Python expression {expr} and return its result
 		converted to Vim data structures.
+		If a {locals} |Dictionary| is given, it defines set of local
+		variables available in the expression. The keys are variable
+		names and the values are the variable values. |Dictionary| and
+		|List| values are referenced, and may be updated by the
+		expression (as if |python-bindeval| was used).
 		Numbers and strings are returned as they are (strings are
 		copied though, Unicode strings are additionally converted to
 		'encoding').
@@ -8141,15 +8146,17 @@ py3eval({expr})						*py3eval()*
 
 		Can also be used as a |method|: >
 			GetExpr()->py3eval()
+			'b",".join(l)'->py3eval({'l': ['a', 'b', 'c']})
 <
 		Return type: any, depending on {expr}
 
 		{only available when compiled with the |+python3| feature}
 
 							*E858* *E859*
-pyeval({expr})						*pyeval()*
+pyeval({expr}[, {locals}])				*pyeval()*
 		Evaluate Python expression {expr} and return its result
 		converted to Vim data structures.
+		For {locals} see |py3eval()|.
 		Numbers and strings are returned as they are (strings are
 		copied though).
 		Lists are represented as Vim |List| type.
@@ -8165,9 +8172,10 @@ pyeval({expr})						*pyeval()*
 
 		{only available when compiled with the |+python| feature}
 
-pyxeval({expr})						*pyxeval()*
+pyxeval({expr}[, {locals}])				*pyxeval()*
 		Evaluate Python expression {expr} and return its result
 		converted to Vim data structures.
+		For {locals} see |py3eval()|.
 		Uses Python 2 or 3, see |python_x| and 'pyxversion'.
 		See also: |pyeval()|, |py3eval()|