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
2
2
3
3
4
4
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1253,6 +1253,8 @@ Starting ~
1253
1253
*termdebug-starting*
1254
1254
Load the plugin with this command: >
1255
1255
packadd termdebug
1256
+ When loading the plugin from the | .vimrc | file, add the "!" attribute: >
1257
+ packadd! termdebug
1256
1258
< *:Termdebug*
1257
1259
To start debugging use `:Termdebug ` or `:TermdebugCommand ` followed by the
1258
1260
command name, for example: >
@@ -1528,38 +1530,46 @@ in a buffer with 'buftype' set to "prompt". This works slightly differently:
1528
1530
1529
1531
*termdebug_use_prompt*
1530
1532
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
1532
1534
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
+
1534
1537
<
1538
+ However, the latter form will be deprecated in future releases.
1539
+
1535
1540
Mappings ~
1536
1541
The termdebug plugin enables a few default mappings. All those mappings
1537
1542
are reset to their original values once the termdebug session concludes.
1538
1543
1539
1544
*termdebug_map_K* *termdebug-mappings*
1540
1545
The K key is normally mapped to | :Evaluate | unless a buffer local (| :map-local | )
1541
1546
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
1543
1548
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
1545
1550
<
1551
+ However, the latter form will be deprecated in future releases.
1552
+
1546
1553
*termdebug_map_minus*
1547
1554
The - key is normally mapped to | :Down | unless a buffer local mapping to the -
1548
1555
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
1550
1557
<
1551
1558
*termdebug_map_plus*
1552
1559
The + key is normally mapped to | :Up | unless a buffer local mapping to the +
1553
1560
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
1555
1562
<
1556
1563
*termdebug_disasm_window*
1557
1564
If you want the Asm window shown by default, set the "disasm_window" flag to
1558
1565
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
1560
1567
let g:termdebug_config['disasm_window_height'] = 15
1561
1568
If there is no g:termdebug_config you can use: >
1562
1569
let g:termdebug_disasm_window = 15
1570
+
1571
+ However, the latter form will be deprecated in future releases.
1572
+
1563
1573
Any value greater than 1 will set the Asm window height to that value.
1564
1574
If the current window has enough horizontal space, it will be vertically split
1565
1575
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).
1569
1579
If you want the Var window shown by default, set the "variables_window" flag
1570
1580
to 1. The "variables_window_height" entry can be used to set the window
1571
1581
height: >
1572
- let g:termdebug_config['variables_window'] = 1
1582
+ let g:termdebug_config['variables_window'] = v:true
1573
1583
let g:termdebug_config['variables_window_height'] = 15
1574
1584
If there is no g:termdebug_config you can use: >
1575
1585
let g:termdebug_variables_window = 15
1586
+
1587
+ However, the latter form will be deprecated in future releases.
1588
+
1576
1589
Any value greater than 1 will set the Var window height to that value.
1577
1590
If the current window has enough horizontal space, it will be vertically split
1578
1591
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
1601
1614
If there is no g:termdebug_config you can use: >
1602
1615
let g:termdebugger = "mygdb"
1603
1616
1617
+ However, the latter form will be deprecated in future releases.
1618
+
1604
1619
If the command needs an argument use a List: >
1605
1620
let g:termdebug_config['command'] = ['rr', 'replay', '--']
1606
1621
If there is no g:termdebug_config you can use: >
@@ -1658,6 +1673,7 @@ If you don't want this then disable it with: >
1658
1673
If there is no g:termdebug_config you can use: >
1659
1674
let g:termdebug_popup = 0
1660
1675
1676
+ However, the latter form will be deprecated in future releases.
1661
1677
1662
1678
Change default signs ~
1663
1679
*termdebug_signs*
@@ -1688,6 +1704,8 @@ split: >
1688
1704
If there is no g:termdebug_config you can use: >
1689
1705
let g:termdebug_wide = 163
1690
1706
1707
+ However, the latter form will be deprecated in future releases.
1708
+
1691
1709
This will set 'columns' to 163 when `:Termdebug ` is used. The value is
1692
1710
restored when quitting the debugger.
1693
1711
0 commit comments