Mercurial > vim

comparison runtime/doc/terminal.txt @ 12833:db9ffed7e1fc v8.0.1293

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.0.1293: setting a breakpoint in the terminal debugger sometimes fails commit https://github.com/vim/vim/commit/60e73f2acc890f07056fa1bea8dbe89d26918b3e Author: Bram Moolenaar <Bram@vim.org> Date: Sun Nov 12 18:02:06 2017 +0100 patch 8.0.1293: setting a breakpoint in the terminal debugger sometimes fails Problem: Setting a breakpoint in the terminal debugger sometimes fails. Solution: Interrupt the program if needed. Set the interface to async.
author Christian Brabandt <cb@256bit.org>
date Sun, 12 Nov 2017 18:15:04 +0100
parents f690da1b3c04
children 32531a3eab1f
comparison
equal deleted inserted replaced
12832:3b4c04beb913 12833:db9ffed7e1fc
1 *terminal.txt* For Vim version 8.0. Last change: 2017 Nov 09 1 *terminal.txt* For Vim version 8.0. Last change: 2017 Nov 12
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
58 When the keyboard focus is in the terminal window, typed keys will be sent to 58 When the keyboard focus is in the terminal window, typed keys will be sent to
59 the job. This uses a pty when possible. You can click outside of the 59 the job. This uses a pty when possible. You can click outside of the
60 terminal window to move keyboard focus elsewhere. 60 terminal window to move keyboard focus elsewhere.
61 61
62 CTRL-W can be used to navigate between windows and other CTRL-W commands, e.g.: 62 CTRL-W can be used to navigate between windows and other CTRL-W commands, e.g.:
63 CTRL-W CTRL-W move focus to the next window 63 CTRL-W CTRL-W move focus to the next window
64 CTRL-W : enter an Ex command 64 CTRL-W : enter an Ex command
65 See |CTRL-W| for more commands. 65 See |CTRL-W| for more commands.
66 66
67 Special in the terminal window: *CTRL-W_.* *CTRL-W_N* 67 Special in the terminal window: *CTRL-W_.* *CTRL-W_N*
68 CTRL-W . send a CTRL-W to the job in the terminal 68 CTRL-W . send a CTRL-W to the job in the terminal
78 the job. For example: 78 the job. For example:
79 'termkey' CTRL-W move focus to the next window 79 'termkey' CTRL-W move focus to the next window
80 'termkey' : enter an Ex command 80 'termkey' : enter an Ex command
81 'termkey' 'termkey' send 'termkey' to the job in the terminal 81 'termkey' 'termkey' send 'termkey' to the job in the terminal
82 'termkey' . send a CTRL-W to the job in the terminal 82 'termkey' . send a CTRL-W to the job in the terminal
83 'termkey' N go to terminal Normal mode, see below 83 'termkey' N go to terminal Normal mode, see below
84 'termkey' CTRL-N same as CTRL-W N 84 'termkey' CTRL-N same as CTRL-W N
85 'termkey' CTRL-C same as |t_CTRL-W_CTRL-C| 85 'termkey' CTRL-C same as |t_CTRL-W_CTRL-C|
86 *t_CTRL-\_CTRL-N* 86 *t_CTRL-\_CTRL-N*
87 The special key combination CTRL-\ CTRL-N can be used to switch to Normal 87 The special key combination CTRL-\ CTRL-N can be used to switch to Normal
88 mode, just like this works in any other mode. 88 mode, just like this works in any other mode.
284 Since the terminal emulator simulates an xterm, only escape sequences that 284 Since the terminal emulator simulates an xterm, only escape sequences that
285 both Vim and xterm recognize will be available in the terminal window. If you 285 both Vim and xterm recognize will be available in the terminal window. If you
286 want to pass on other escape sequences to the job running in the terminal you 286 want to pass on other escape sequences to the job running in the terminal you
287 need to set up forwarding. Example: > 287 need to set up forwarding. Example: >
288 tmap <expr> <Esc>]b SendToTerm("\<Esc>]b") 288 tmap <expr> <Esc>]b SendToTerm("\<Esc>]b")
289 func SendToTerm(what) 289 func SendToTerm(what)
290 call term_sendkeys('', a:what) 290 call term_sendkeys('', a:what)
291 return '' 291 return ''
292 endfunc 292 endfunc
293 293
294 294
295 Unix ~ 295 Unix ~
296 *terminal-unix* 296 *terminal-unix*
297 On Unix a pty is used to make it possible to run all kinds of commands. You 297 On Unix a pty is used to make it possible to run all kinds of commands. You
445 445
446 446
447 Stepping through code ~ 447 Stepping through code ~
448 *termdebug-stepping* 448 *termdebug-stepping*
449 Put focus on the gdb window to type commands there. Some common ones are: 449 Put focus on the gdb window to type commands there. Some common ones are:
450 - CTRL-C interrupt the program 450 - CTRL-C interrupt the program
451 - next execute the current line and stop at the next line 451 - next execute the current line and stop at the next line
452 - step execute the current line and stop at the next statement, entering 452 - step execute the current line and stop at the next statement,
453 functions 453 entering functions
454 - finish execute until leaving the current function 454 - finish execute until leaving the current function
455 - where show the stack 455 - where show the stack
456 - frame N go to the Nth stack frame 456 - frame N go to the Nth stack frame
457 - continue continue execution 457 - continue continue execution
458 458
459 In the window showing the source code some commands can used to control gdb: 459 In the window showing the source code these commands can used to control gdb:
460 :Break set a breakpoint at the current line; a sign will be displayed 460 :Run [args] run the program with [args] or the previous arguments
461 :Delete delete a breakpoint at the current line 461 :Arguments {args} set arguments for the next :Run
462 :Step execute the gdb "step" command 462
463 :Over execute the gdb "next" command (:Next is a Vim command) 463 :Break set a breakpoint at the current line; a sign will be displayed
464 :Finish execute the gdb "finish" command 464 :Delete delete a breakpoint at the current line
465 :Continue execute the gdb "continue" command 465
466 :Step execute the gdb "step" command
467 :Over execute the gdb "next" command (:Next is a Vim command)
468 :Finish execute the gdb "finish" command
469 :Continue execute the gdb "continue" command
470 :Stop interrupt the program
466 471
467 The plugin adds a window toolbar with these entries: 472 The plugin adds a window toolbar with these entries:
468 Step :Step 473 Step :Step
469 Next :Over 474 Next :Over
470 Finish :Finish 475 Finish :Finish
471 Cont :Continue 476 Cont :Continue
472 Eval :Evaluate 477 Stop :Stop
478 Eval :Evaluate
473 This way you can use the mouse to perform the most common commands. 479 This way you can use the mouse to perform the most common commands.
474 480
475 481
476 Inspecting variables ~ 482 Inspecting variables ~
477 *termdebug-variables* 483 *termdebug-variables*