Skip to content

Commit d5ec7fc

Browse files
authored
Merge pull request #1636 from vim-jp/hh-update-terminal
Update terminal.{txt,jax}
2 parents 1a56880 + 9a7242e commit d5ec7fc

File tree

2 files changed

+54
-18
lines changed

2 files changed

+54
-18
lines changed

doc/terminal.jax

Lines changed: 27 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*terminal.txt* For Vim バージョン 9.1. Last change: 2024 Jun 20
1+
*terminal.txt* For Vim バージョン 9.1. Last change: 2024 Jul 28
22

33

44
VIMリファレンスマニュアル by Bram Moolenaar
@@ -1241,6 +1241,8 @@ SSH 接続が1つあればリモートで機能します。
12411241
*termdebug-starting*
12421242
以下のコマンドでプラグインを読み込みます: >
12431243
packadd termdebug
1244+
|.vimrc| ファイルからプラグインを読み込む時は、"!" 属性を追加します: >
1245+
packadd! termdebug
12441246
< *:Termdebug*
12451247
デバッグを開始するには `:Termdebug` または `:TermdebugCommand` に続けてコマン
12461248
ド名を入力します。例: >
@@ -1513,10 +1515,13 @@ TermdebugStopPost デバッグの終了後、gdb 関連ウィンドウが閉じ
15131515

15141516
*termdebug_use_prompt*
15151517
プロンプトモードは、|+terminal| 機能が有効な場合でも使用できます: >
1516-
let g:termdebug_config['use_prompt'] = 1
1518+
let g:termdebug_config['use_prompt'] = v:true
15171519
g:termdebug_config がない場合は、以下を使用できます: >
1518-
let g:termdebug_use_prompt = 1
1520+
let g:termdebug_use_prompt = v:true
1521+
15191522
<
1523+
ただし、後者の形式は将来のリリースでは非推奨になります。
1524+
15201525
マッピング ~
15211526
termdebug プラグインは、いくつかのデフォルトマッピングを有効にします。
15221527
termdebug セッションが終了すると、これらのマッピングはすべて元の値にリセットさ
@@ -1525,28 +1530,33 @@ termdebug セッションが終了すると、これらのマッピングはす
15251530
*termdebug_map_K* *termdebug-mappings*
15261531
K へのバッファローカル (|:map-local|) マッピングがすでに存在している場合を除
15271532
き、K キーは通常 |:Evaluate| にマップされています。これが不要な場合は: >
1528-
let g:termdebug_config['map_K'] = 0
1533+
let g:termdebug_config['map_K'] = v:false
15291534
g:termdebug_config がない場合は、以下を使用できます: >
1530-
let g:termdebug_map_K = 0
1535+
let g:termdebug_map_K = v:false
15311536
<
1537+
ただし、後者の形式は将来のリリースでは非推奨になります。
1538+
15321539
*termdebug_map_minus*
15331540
- へのバッファローカルマッピングがすでに存在している場合を除き、- は通常
15341541
|:Down| にマップされています。これが不要な場合は: >
1535-
let g:termdebug_config['map_minus'] = 0
1542+
let g:termdebug_config['map_minus'] = v:false
15361543
<
15371544
*termdebug_map_plus*
15381545
+ へのバッファローカルマッピングがすでに存在している場合を除き、+ は通常 |:Up|
15391546
にマップされています。これが不要な場合は: >
1540-
let g:termdebug_config['map_plus'] = 0
1547+
let g:termdebug_config['map_plus'] = v:false
15411548
<
15421549
*termdebug_disasm_window*
15431550
Asm ウィンドウをデフォルトで表示させたい場合、"disasm_window" フラグに 1 を設
15441551
定します。"disasm_window_height" エントリを使用してウィンドウの高さを設定でき
15451552
ます: >
1546-
let g:termdebug_config['disasm_window'] = 1
1553+
let g:termdebug_config['disasm_window'] = v:true
15471554
let g:termdebug_config['disasm_window_height'] = 15
15481555
g:termdebug_config がない場合は、以下を使用できます: >
15491556
let g:termdebug_disasm_window = 15
1557+
1558+
ただし、後者の形式は将来のリリースでは非推奨になります。
1559+
15501560
1以上の任意の値を設定でき、その値が Asm ウィンドウの高さになります。
15511561
カレントウィンドウに十分な水平方向のスペースがある場合、垂直方向に分割され、
15521562
Asm ウィンドウがソースコードウィンドウと並べて表示されます (高さのオプションは
@@ -1556,10 +1566,13 @@ Asm ウィンドウがソースコードウィンドウと並べて表示され
15561566
Var ウィンドウをデフォルトで表示させたい場合、"variables_window" フラグに 1 を
15571567
設定します。"variables_window_height" エントリを使用してウィンドウの高さを設定
15581568
できます: >
1559-
let g:termdebug_config['variables_window'] = 1
1569+
let g:termdebug_config['variables_window'] = v:true
15601570
let g:termdebug_config['variables_window_height'] = 15
15611571
g:termdebug_config がない場合は、以下を使用できます: >
15621572
let g:termdebug_variables_window = 15
1573+
1574+
ただし、後者の形式は将来のリリースでは非推奨になります。
1575+
15631576
1 以上の任意の値を設定でき、その値が Var ウィンドウの高さになります。
15641577
カレントウィンドウに十分な水平方向のスペースがある場合、垂直方向に分割され、
15651578
Var ウィンドウがソースコードウィンドウと並べて表示されます (高さのオプションは
@@ -1588,6 +1601,8 @@ g:termdebug_config の "debugger" エントリか "g:termdebugger" 変数を変
15881601
g:termdebug_config がない場合は、以下を使用できます: >
15891602
let g:termdebugger = "mygdb"
15901603
1604+
ただし、後者の形式は将来のリリースでは非推奨になります。
1605+
15911606
コマンドに引数が必要な場合はリストを使用してください: >
15921607
let g:termdebug_config['command'] = ['rr', 'replay', '--']
15931608
g:termdebug_config がない場合は、以下を使用できます: >
@@ -1644,6 +1659,7 @@ TermDebugSendCommand() 関数を使用して、任意のウィンドウで動作
16441659
g:termdebug_config がない場合は、以下を使用できます: >
16451660
let g:termdebug_popup = 0
16461661
1662+
ただし、後者の形式は将来のリリースでは非推奨になります。
16471663

16481664
デフォルトの目印の変更 ~
16491665
*termdebug_signs*
@@ -1675,6 +1691,8 @@ Vimのウィンドウ幅 ~
16751691
g:termdebug_config がない場合は、以下を使用できます: >
16761692
let g:termdebug_wide = 163
16771693
1694+
ただし、後者の形式は将来のリリースでは非推奨になります。
1695+
16781696
これは `:Termdebug` を実行した際に 'columns' を 163 に設定します。元の値はデ
16791697
バッガが終了する際に復元されます。
16801698

en/terminal.txt

Lines changed: 27 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*terminal.txt* For Vim version 9.1. Last change: 2024 Jun 20
1+
*terminal.txt* For Vim version 9.1. Last change: 2024 Jul 28
22

33

44
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1253,6 +1253,8 @@ Starting ~
12531253
*termdebug-starting*
12541254
Load the plugin with this command: >
12551255
packadd termdebug
1256+
When loading the plugin from the |.vimrc| file, add the "!" attribute: >
1257+
packadd! termdebug
12561258
< *:Termdebug*
12571259
To start debugging use `:Termdebug` or `:TermdebugCommand` followed by the
12581260
command name, for example: >
@@ -1528,38 +1530,46 @@ in a buffer with 'buftype' set to "prompt". This works slightly differently:
15281530

15291531
*termdebug_use_prompt*
15301532
Prompt mode can be used even when the |+terminal| feature is present with: >
1531-
let g:termdebug_config['use_prompt'] = 1
1533+
let g:termdebug_config['use_prompt'] = v:true
15321534
If there is no g:termdebug_config you can use: >
1533-
let g:termdebug_use_prompt = 1
1535+
let g:termdebug_use_prompt = v:true
1536+
15341537
<
1538+
However, the latter form will be deprecated in future releases.
1539+
15351540
Mappings ~
15361541
The termdebug plugin enables a few default mappings. All those mappings
15371542
are reset to their original values once the termdebug session concludes.
15381543

15391544
*termdebug_map_K* *termdebug-mappings*
15401545
The K key is normally mapped to |:Evaluate| unless a buffer local (|:map-local|)
15411546
mapping to K already exists. If you do not want this use: >
1542-
let g:termdebug_config['map_K'] = 0
1547+
let g:termdebug_config['map_K'] = v:false
15431548
If there is no g:termdebug_config you can use: >
1544-
let g:termdebug_map_K = 0
1549+
let g:termdebug_map_K = v:false
15451550
<
1551+
However, the latter form will be deprecated in future releases.
1552+
15461553
*termdebug_map_minus*
15471554
The - key is normally mapped to |:Down| unless a buffer local mapping to the -
15481555
key already exists. If you do not want this use: >
1549-
let g:termdebug_config['map_minus'] = 0
1556+
let g:termdebug_config['map_minus'] = v:false
15501557
<
15511558
*termdebug_map_plus*
15521559
The + key is normally mapped to |:Up| unless a buffer local mapping to the +
15531560
key already exists. If you do not want this use: >
1554-
let g:termdebug_config['map_plus'] = 0
1561+
let g:termdebug_config['map_plus'] = v:false
15551562
<
15561563
*termdebug_disasm_window*
15571564
If you want the Asm window shown by default, set the "disasm_window" flag to
15581565
1. The "disasm_window_height" entry can be used to set the window height: >
1559-
let g:termdebug_config['disasm_window'] = 1
1566+
let g:termdebug_config['disasm_window'] = v:true
15601567
let g:termdebug_config['disasm_window_height'] = 15
15611568
If there is no g:termdebug_config you can use: >
15621569
let g:termdebug_disasm_window = 15
1570+
1571+
However, the latter form will be deprecated in future releases.
1572+
15631573
Any value greater than 1 will set the Asm window height to that value.
15641574
If the current window has enough horizontal space, it will be vertically split
15651575
and the Asm window will be shown side by side with the source code window (and
@@ -1569,10 +1579,13 @@ the height option won't be used).
15691579
If you want the Var window shown by default, set the "variables_window" flag
15701580
to 1. The "variables_window_height" entry can be used to set the window
15711581
height: >
1572-
let g:termdebug_config['variables_window'] = 1
1582+
let g:termdebug_config['variables_window'] = v:true
15731583
let g:termdebug_config['variables_window_height'] = 15
15741584
If there is no g:termdebug_config you can use: >
15751585
let g:termdebug_variables_window = 15
1586+
1587+
However, the latter form will be deprecated in future releases.
1588+
15761589
Any value greater than 1 will set the Var window height to that value.
15771590
If the current window has enough horizontal space, it will be vertically split
15781591
and the Var window will be shown side by side with the source code window (and
@@ -1601,6 +1614,8 @@ g:termdebug_config or the "g:termdebugger" variable before invoking
16011614
If there is no g:termdebug_config you can use: >
16021615
let g:termdebugger = "mygdb"
16031616
1617+
However, the latter form will be deprecated in future releases.
1618+
16041619
If the command needs an argument use a List: >
16051620
let g:termdebug_config['command'] = ['rr', 'replay', '--']
16061621
If there is no g:termdebug_config you can use: >
@@ -1658,6 +1673,7 @@ If you don't want this then disable it with: >
16581673
If there is no g:termdebug_config you can use: >
16591674
let g:termdebug_popup = 0
16601675
1676+
However, the latter form will be deprecated in future releases.
16611677

16621678
Change default signs ~
16631679
*termdebug_signs*
@@ -1688,6 +1704,8 @@ split: >
16881704
If there is no g:termdebug_config you can use: >
16891705
let g:termdebug_wide = 163
16901706
1707+
However, the latter form will be deprecated in future releases.
1708+
16911709
This will set 'columns' to 163 when `:Termdebug` is used. The value is
16921710
restored when quitting the debugger.
16931711

0 commit comments

Comments
 (0)