Merge pull request #1325 from vim-jp/hh-update-terminal

Update terminal.{txt,jax}

Author: h-east

doc/terminal.jax

@@ -1,4 +1,4 @@
-*terminal.txt*	For Vim バージョン 9.0.  Last change: 2022 Nov 10
+*terminal.txt*	For Vim バージョン 9.0.  Last change: 2023 Aug 23
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -39,6 +39,7 @@
       セッション例			|termdebug-example|
       コードをステップ実行する		|termdebug-stepping|
       変数を検査する			|termdebug-variables|
+      スタックフレームの移動		|termdebug-frames|
       その他のコマンド			|termdebug-commands|
       イベント				|termdebug-events|
       プロンプトモード			|termdebug-prompt|
@@ -1363,14 +1364,28 @@ gdbは各ブレークポイントに番号を与えます。Vim内では、赤
 `:Evaluate` は `:Ev` に短縮できます。
 
 
+スタックフレームの移動 ~
+				*termdebug-frames* *:Frame* *:Up* *:Down*
+ `:Frame` [frame]	フレームを選択する。[frame] は、フレーム番号、アドレ
+			ス、または関数名 (デフォルト: カレントフレーム)
+ `:Up` [count]		[count] フレーム上へ (デフォルト: 1; カレントを呼び出
+			したフレーム)
+ `+`			同上 (無効にするには |termdebug_map_plus| を参照)
+ `:Down` [count]	[count] フレーム下へ (デフォルト: 1; カレントによって
+			呼び出されるフレーム)
+ `-`			同上 (無効にするには |termdebug_map_minus| を参照)
+
+
 その他のコマンド ~
 							*termdebug-commands*
  *:Gdb*	     gdb ウィンドウに移動する
  *:Program*    デバッグ中のプログラムウィンドウに移動する
  *:Source*     ソースコードウィンドウにジャンプする、ウィンドウがなければ作成
-	       する
+	     する
  *:Asm*	     逆アセンブルウィンドウにジャンプする、ウィンドウがなければ作成す
 	     る
+ *:Var*	     ローカル変数と引数変数のあるウィンドウにジャンプし、なければ作成
+	     する。このウィンドウは、プログラムが停止されるたびに更新される
 
 イベント ~
 							*termdebug-events*
@@ -1433,21 +1448,38 @@ g:termdebug_config がない場合は、以下を使用できます: >
 	let g:termdebug_use_prompt = 1
 <
 						*termdebug_map_K*
-K は通常 :Evaluate にマッピングされています。これが不要な場合は: >
+K は通常 |:Evaluate| にマッピングされています。これが不要な場合は: >
 	let g:termdebug_config['map_K'] = 0
 g:termdebug_config がない場合は、以下を使用できます: >
 	let g:termdebug_map_K = 0
-
+<
+						*termdebug_map_minus*
+- は通常 |:Down| にマッピングされています。これが不要な場合は: >
+	let g:termdebug_config['map_minus'] = 0
+<
+						*termdebug_map_plus*
++ は通常 |:Up| にマッピングされています。これが不要な場合は: >
+	let g:termdebug_config['map_plus'] = 0
 <
 						*termdebug_disasm_window*
-Asm ウィンドウをデフォルトで表示させたい場合、このフラグに1を設定します。
-"disasm_window_height" エントリを使用してウィンドウの高さを設定できます: >
+Asm ウィンドウをデフォルトで表示させたい場合、"disasm_window" フラグに 1 を設
+定します。"disasm_window_height" エントリを使用してウィンドウの高さを設定でき
+ます: >
 	let g:termdebug_config['disasm_window'] = 1
 	let g:termdebug_config['disasm_window_height'] = 15
 g:termdebug_config がない場合は、以下を使用できます: >
 	let g:termdebug_disasm_window = 15
 1以上の任意の値を設定でき、その値が Asm ウィンドウの高さになります。
 
+						*termdebug_variables_window*
+Var ウィンドウをデフォルトで表示させたい場合、このフラグを 1 に設定します。
+"variables_window_height" エントリを使用してウィンドウの高さを設定できます: >
+	let g:termdebug_config['variables_window'] = 1
+	let g:termdebug_config['variables_window_height'] = 15
+g:termdebug_config がない場合は、以下を使用できます: >
+	let g:termdebug_variables_window = 15
+1 以上の任意の値を設定でき、その値が Var ウィンドウの高さになります。
+
 通信 ~
 						*termdebug-communication*
 Vim が gdb と通信するために他に隠されたバッファを利用します。バッファ名は "gdb
@@ -1528,6 +1560,20 @@ g:termdebug_config がない場合は、以下を使用できます: >
 	let g:termdebug_popup = 0
 
 
+デフォルトの目印の変更 ~
+							*termdebug_signs*
+Termdebug はブレークポイントを表すために、signcolumn のブレークポイント ID の
+最後の 2 文字を使用します。例えば、ブレークポイント ID 133 は `33` と表示され
+ます。
+
+ブレークポイントの目印をカスタマイズしたい場合: >
+	let g:termdebug_config['sign'] = '>>'
+g:terminal_config がまだない場合は、以下を使用できます: >
+	let g:termdebug_config = {'sign': '>>'}
+
+この後、ブレークポイントはサイン欄に `>>` と表示されます。
+
+
 ウィンドウツールバー ~
 							*termdebug_winbar*
 デフォルトでは、マウスが有効な場合、Termdebug プラグインはウィンドウツールバー

en/terminal.txt

@@ -1,4 +1,4 @@
-*terminal.txt*	For Vim version 9.0.  Last change: 2022 Nov 10
+*terminal.txt*	For Vim version 9.0.  Last change: 2023 Aug 23
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -38,6 +38,7 @@ If the result is "1" you have it.
       Example session				|termdebug-example|
       Stepping through code			|termdebug-stepping|
       Inspecting variables			|termdebug-variables|
+      Navigating stack frames			|termdebug-frames|
       Other commands				|termdebug-commands|
       Events					|termdebug-events|
       Prompt mode				|termdebug-prompt|
@@ -1376,6 +1377,18 @@ This is similar to using "print" in the gdb window.
 You can usually shorten `:Evaluate` to `:Ev`.
 
 
+Navigating stack frames ~
+				*termdebug-frames* *:Frame* *:Up* *:Down*
+ `:Frame` [frame]	select frame [frame], which is a frame number,
+			address, or function name (default: current frame)
+ `:Up` [count]		go up [count] frames (default: 1; the frame that
+			called the current)
+ `+`			same (see |termdebug_map_plus| to disable)
+ `:Down` [count]	go down [count] frames (default: 1; the frame called
+			by the current)
+ `-`			same (see |termdebug_map_minus| to disable)
+
+
 Other commands ~
 							*termdebug-commands*
  *:Gdb*	     jump to the gdb window
@@ -1384,6 +1397,9 @@ Other commands ~
 	     isn't one
  *:Asm*	     jump to the window with the disassembly, create it if there
 	     isn't one
+ *:Var*	     jump to the window with the local and argument variables,
+             create it if there isn't one. This window updates whenever the
+             program is stopped
 
 Events ~
 							*termdebug-events*
@@ -1446,20 +1462,37 @@ If there is no g:termdebug_config you can use: >
 	let g:termdebug_use_prompt = 1
 <
 						*termdebug_map_K*
-The K key is normally mapped to :Evaluate. If you do not want this use: >
+The K key is normally mapped to |:Evaluate|. If you do not want this use: >
 	let g:termdebug_config['map_K'] = 0
 If there is no g:termdebug_config you can use: >
 	let g:termdebug_map_K = 0
+<
+						*termdebug_map_minus*
+The - key is normally mapped to |:Down|. If you do not want this use: >
+	let g:termdebug_config['map_minus'] = 0
+<
+						*termdebug_map_plus*
+The + key is normally mapped to |:Up|. If you do not want this use: >
+	let g:termdebug_config['map_plus'] = 0
 <
 						*termdebug_disasm_window*
-If you want the Asm window shown by default, set the flag to 1.
-the "disasm_window_height" entry can be used to set the window height: >
+If you want the Asm window shown by default, set the "disasm_window" flag to
+1.  The "disasm_window_height" entry can be used to set the window height: >
 	let g:termdebug_config['disasm_window'] = 1
 	let g:termdebug_config['disasm_window_height'] = 15
 If there is no g:termdebug_config you can use: >
 	let g:termdebug_disasm_window = 15
 Any value greater than 1 will set the Asm window height to that value.
 
+						*termdebug_variables_window*
+If you want the Var window shown by default, set the flag to 1.
+the "variables_window_height" entry can be used to set the window height: >
+	let g:termdebug_config['variables_window'] = 1
+	let g:termdebug_config['variables_window_height'] = 15
+If there is no g:termdebug_config you can use: >
+	let g:termdebug_variables_window = 15
+Any value greater than 1 will set the Var window height to that value.
+
 Communication ~
 						*termdebug-communication*
 There is another, hidden, buffer, which is used for Vim to communicate with
@@ -1499,7 +1532,7 @@ The function will be called with the list of arguments so far, and a second
 argument that is the name of the pty.
 							*gdb-version*
 Only debuggers fully compatible with gdb will work.  Vim uses the GDB/MI
-interface.  The "new-ui" command  requires gdb version 7.12 or later.  if you
+interface.  The "new-ui" command requires gdb version 7.12 or later.  If you
 get this error:
 	Undefined command: "new-ui". Try "help".~
 Then your gdb is too old.
@@ -1541,6 +1574,20 @@ If there is no g:termdebug_config you can use: >
 	let g:termdebug_popup = 0
 
 
+Change default signs ~
+							*termdebug_signs*
+Termdebug uses the last two characters of the breakpoint ID in the
+signcolumn to represent breakpoints. For example, breakpoint ID 133
+will be displayed as `33`.
+
+If you want to customize the breakpoint signs: >
+	let g:termdebug_config['sign'] = '>>'
+If there is no g:terminal_config yet you can use: >
+	let g:termdebug_config = {'sign': '>>'}
+
+After this, breakpoints will be displayed as `>>` in the signcolumn.
+
+
 Window toolbar ~
 							*termdebug_winbar*
 By default the Termdebug plugin creates a window toolbar if the mouse is