Merge pull request #1372 from vim-jp/hh-update-eval

Update eval.{txt,jax}

Author: h-east

doc/eval.jax

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim バージョン 9.0.  Last change: 2023 Jun 01
+*eval.txt*	For Vim バージョン 9.0.  Last change: 2023 Nov 05
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -34,6 +34,7 @@ Note: 式の評価はコンパイル時に無効化できる。無効化され
 11. +eval機能が無効		|no-eval-feature|
 12. サンドボックス		|eval-sandbox|
 13. テキストロック		|textlock|
+14. Vim script ライブラリ	|vim-script-library|
 
 テストのサポートは |testing.txt| を参照。
 プロファイリングは |profiling| に記録されている。
@@ -4656,4 +4657,37 @@ Vimの現在の処理を混乱させたり破壊してしまうような動作
 	- ウィンドウを閉じたりVimを終了したり
 	- その他
 
+==============================================================================
+14. Vim script ライブラリ				*vim-script-library*
+
+Vim には、ランタイムやスクリプト作成者が使用できる Vim script ライブラリがバン
+ドルされている。現時点ではごく少数の関数しか含まれていないが、時間の経過ととも
+に拡張される可能性がある。
+
+関数は |Vim9-script| として使用可能である。旧来の vim script (Vim 9.0 以外の
+バージョンおよび Neovim で使用される) でも使用できる。
+
+							*dist#vim* *dist#vim9*
+関数は、オートロードされたプリフィックス "dist#vim" (旧来の Vim script および
+Neovim の場合) と、Vim9 script の場合 "dist#vim9" を使用する。
+
+以下の関数が使用可能:
+
+dist#vim#IsSafeExecutable(filetype, executable) ~
+dist#vim9#IsSafeExecutable(filetype:string, executable:string): bool ~
+
+この関数は、ファイルタイプと実行可能ファイルを受け取り、与えられた実行ファイル
+を実行しても安全かどうかをチェックする。セキュリティ上の理由から、ユーザーは
+Vim にランダムな実行可能ファイルを実行させたくない場合や、"<filetype>_exec" 変
+数 (|plugin_exec|) を設定して特定のファイルタイプに対する実行を禁止している場
+合がある。
+
+|true| または |false| を返し、プラグインが指定された実行可能ファイルを実行する
+必要があるかどうかを示す。次の引数を取る:
+
+	引数		型 ~
+
+	filetype	string
+	executable	string
+
  vim:tw=78:ts=8:noet:ft=help:norl:

en/eval.txt

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim version 9.0.  Last change: 2023 Jun 01
+*eval.txt*	For Vim version 9.0.  Last change: 2023 Nov 05
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -36,6 +36,7 @@ a remark is given.
 11. No +eval feature		|no-eval-feature|
 12. The sandbox			|eval-sandbox|
 13. Textlock			|textlock|
+14. Vim script library		|vim-script-library|
 
 Testing support is documented in |testing.txt|.
 Profiling is documented at |profiling|.
@@ -4801,5 +4802,37 @@ This is not allowed when the textlock is active:
 	- closing a window or quitting Vim
 	- etc.
 
+==============================================================================
+14. Vim script library					*vim-script-library*
+
+Vim comes bundled with a Vim script library, that can be used by runtime,
+script authors.  Currently, it only includes very few functions, but it may
+grow over time.
+
+The functions are available as |Vim9-script| as well as using legacy vim
+script (to be used for non Vim 9.0 versions and Neovim).
+
+							*dist#vim* *dist#vim9*
+The functions make use of the autoloaded prefix "dist#vim" (for legacy Vim script and
+Neovim) and "dist#vim9" for Vim9 script.
+
+The following functions are available:
+
+dist#vim#IsSafeExecutable(filetype, executable) ~
+dist#vim9#IsSafeExecutable(filetype:string, executable:string): bool ~
+
+This function takes a filetype and an executable and checks whether it is safe
+to execute the given executable.  For security reasons users may not want to
+have Vim execute random executables or may have forbidden to do so for
+specific filetypes by setting the "<filetype>_exec" variable (|plugin_exec|).
+
+It returns |true| or |false| to indicate whether the plugin should run the given
+exectuable.  It takes the following arguments:
+
+	argument	type ~
+
+	filetype	string
+	executable	string
+
 
  vim:tw=78:ts=8:noet:ft=help:norl: