comparison runtime/doc/terminal.txt @ 11814:d3d0db111d17 v8.0.0787

patch 8.0.0787: cannot send CTRL-W command to terminal job commit https://github.com/vim/vim/commit/1f28b4c6a30d1519a8770d16cbb874735ccced97 Author: Bram Moolenaar <Bram@vim.org> Date: Fri Jul 28 13:48:34 2017 +0200 patch 8.0.0787: cannot send CTRL-W command to terminal job Problem: Cannot send CTRL-W command to terminal job. Solution: Make CTRL-W . a prefex for sending a key to the job.
author Christian Brabandt <cb@256bit.org>
date Fri, 28 Jul 2017 14:00:06 +0200
parents edf1a2a247fa
children be40c8a9240d
comparison
equal deleted inserted replaced
11813:a74603a6495c 11814:d3d0db111d17
1 *terminal.txt* For Vim version 8.0. Last change: 2017 Jul 24 1 *terminal.txt* For Vim version 8.0. Last change: 2017 Jul 28
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
31 :term gdb vim 31 :term gdb vim
32 32
33 The job runs asynchronously from Vim, the window will be updated to show 33 The job runs asynchronously from Vim, the window will be updated to show
34 output from the job, also while editing in any other window. 34 output from the job, also while editing in any other window.
35 35
36 Typing ~
37
36 When the keyboard focus is in the terminal window, typed keys will be send to 38 When the keyboard focus is in the terminal window, typed keys will be send to
37 the job. This uses a pty when possible. 39 the job. This uses a pty when possible. You can click outside of the
40 terminal window to move keyboard focus elsewhere.
38 41
39 Navigate between windows with CTRL-W commands (and mouse). 42 Navigate between windows with CTRL-W commands. E.g. CTRL-W CTRL-W moves focus
40 E.g. CTRL-W CTRL-W moves focus to the next window. 43 to the next window. Use "CTRL-W :" to edit an Ex command. Use "CTRL-W ." to
41 Use "CTRL-W :" to edit an Ex command. 44 send a CTRL-W to the job in the terminal.
42 45
43 See option 'termkey' for specifying the key that precedes a Vim command. 46 See option 'termkey' for specifying another key that precedes a Vim command.
44 Default is CTRL-W. 47 Typing 'termkey' twice sends 'termkey' to the job.
48
49 Size ~
45 50
46 See option 'termsize' for controlling the size of the terminal window. 51 See option 'termsize' for controlling the size of the terminal window.
47 (TODO: scrolling when the terminal is larger than the window) 52 (TODO: scrolling when the terminal is larger than the window)
48 53
49 Syntax ~ 54 Syntax ~
50 55
51 :ter[minal][!] [command] *:ter* *:terminal* 56 :ter[minal] [command] *:ter* *:terminal*
52 Open a new terminal window. 57 Open a new terminal window.
53 58
54 If [command] is provided run it as a job and connect 59 If [command] is provided run it as a job and connect
55 the input and output to the terminal. 60 the input and output to the terminal.
56 If [command] is not given the 'shell' option is used. 61 If [command] is not given the 'shell' option is used.