Merge pull request #1903 from h-east/update-eval

Update eval.{txt,jax}

Author: h-east

doc/eval.jax

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim バージョン 9.1.  Last change: 2024 Dec 23
+*eval.txt*	For Vim バージョン 9.1.  Last change: 2025 Jan 02
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -1898,7 +1898,8 @@ Note これはつまり、ファイルタイププラグインはバッファご
 
 ☆Vimの定義済変数				*vim-variable* *v:var* *v:*
 							*E963* *E1063*
-一部の変数はユーザーが設定できるが、型を変更することはできない。
+ほとんどの変数は読み取り専用である。ユーザーが設定できる変数については、以下の
+変数の説明に記載されている。型は変更できない。
 
 					*v:argv* *argv-variable*
 v:argv		Vimの起動に使用したコマンドライン引数。これは文字列のリストで
@@ -2111,7 +2112,7 @@ v:event		現在の |autocommand| に関する情報を含む辞書。辞書に
 <
 					*v:exception* *exception-variable*
 v:exception	最も直近に捕捉され、まだ終了していない例外の値。
-		|v:throwpoint|と|throw-variables|を参照。
+		|v:stacktrace|、|v:throwpoint|、|throw-variables| も参照。
 		例: >
 	:try
 	:  throw "oops"
@@ -2481,6 +2482,11 @@ v:sizeofpointer	ポインタのバイト数。Vimがどのようにコンパイ
 		る。これは、テストで期待通りの結果が得られるかどうかを判断する
 		場合にのみ役立つ。
 
+					*v:stacktrace* *stacktrace-variable*
+v:stacktrace	最後にキャッチされて終了していない例外のスタックトレース。ス
+		タックトレースの構造については、|getstacktrace()| を参照。
+		|v:exception|、|v:throwpoint|、|throw-variables| も参照。
+
 					*v:statusmsg* *statusmsg-variable*
 v:statusmsg	最後に表示されたステータスメッセージ。この変数は代入すること
 		が許されている。
@@ -2609,8 +2615,8 @@ v:this_session	最後にロードされたか、セーブされたセッショ
 
 					*v:throwpoint* *throwpoint-variable*
 v:throwpoint	最も直近に捕捉されてまだ終了していない例外が発生した位置。キー
-		ボードから入力されたコマンドは記録されていない。|v:exception|
-		と|throw-variables|も参照。
+		ボードから入力されたコマンドは記録されていない。|v:exception|、
+		|v:stacktrace|、|throw-variables| も参照。
 		例: >
 	:try
 	:  throw "oops"
@@ -3731,9 +3737,10 @@ thrown" を表示する。例外は、順番に ":catch" コマンドに照合
 	:  catch /^\d\+$/
 	:    echo "Number thrown.  Value is" v:exception
 
-また、どこで例外が発生したかも知りたいだろう。これは|v:throwpoint|に保持されて
-いる。Note "v:exception" と "v:throwpoint" は最も直近に捕捉された例外に対し、
-それが終了するまで有効である。
+例外がどこでスローされたかにも興味があるかもしれない。これは |v:throwpoint| に
+保存される。また、スタックトレースは |v:stacktrace| から取得できる。
+Note "v:exception"、"v:stacktrace" および "v:throwpoint" は最も直近に捕捉され
+た例外に対し、それが終了するまで有効であることに注意。
    例: >
 
 	:function! Caught()

en/eval.txt

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim version 9.1.  Last change: 2024 Dec 23
+*eval.txt*	For Vim version 9.1.  Last change: 2025 Jan 02
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -1953,7 +1953,8 @@ variables for each buffer.  Use local buffer variables instead |b:var|.
 
 PREDEFINED VIM VARIABLES			*vim-variable* *v:var* *v:*
 							*E963* *E1063*
-Some variables can be set by the user, but the type cannot be changed.
+Most variables are read-only, when a variable can be set by the user, it will
+be mentioned at the variable description below. The type cannot be changed.
 
 					*v:argv* *argv-variable*
 v:argv		The command line arguments Vim was invoked with.  This is a
@@ -2172,7 +2173,8 @@ v:event		Dictionary containing information about the current
 <
 					*v:exception* *exception-variable*
 v:exception	The value of the exception most recently caught and not
-		finished.  See also |v:throwpoint| and |throw-variables|.
+		finished.  See also |v:stacktrace|, |v:throwpoint|, and
+		|throw-variables|.
 		Example: >
 	:try
 	:  throw "oops"
@@ -2548,6 +2550,12 @@ v:sizeofpointer	Number of bytes in a pointer.  Depends on how Vim was compiled.
 		This is only useful for deciding whether a test will give the
 		expected result.
 
+					*v:stacktrace* *stacktrace-variable*
+v:stacktrace	The stack trace of the exception most recently caught and
+		not finished.  Refer to |getstacktrace()| for the structure of
+		stack trace.  See also |v:exception|, |v:throwpoint|, and
+		|throw-variables|.
+
 					*v:statusmsg* *statusmsg-variable*
 v:statusmsg	Last given status message.  It's allowed to set this variable.
 
@@ -2676,7 +2684,7 @@ v:this_session	Full filename of the last loaded or saved session file.  See
 					*v:throwpoint* *throwpoint-variable*
 v:throwpoint	The point where the exception most recently caught and not
 		finished was thrown.  Not set when commands are typed.  See
-		also |v:exception| and |throw-variables|.
+		also |v:exception|, |v:stacktrace|, and |throw-variables|.
 		Example: >
 	:try
 	:  throw "oops"
@@ -3856,7 +3864,8 @@ in the variable |v:exception|: >
 	:    echo "Number thrown.  Value is" v:exception
 
 You may also be interested where an exception was thrown.  This is stored in
-|v:throwpoint|.  Note that "v:exception" and "v:throwpoint" are valid for the
+|v:throwpoint|.  And you can obtain the stack trace from |v:stacktrace|.
+Note that "v:exception", "v:stacktrace" and "v:throwpoint" are valid for the
 exception most recently caught as long it is not finished.
    Example: >