diff options
author | Bram Moolenaar <Bram@vim.org> | 2017-08-18 22:57:06 +0200 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2017-08-18 22:57:06 +0200 |
commit | 8e539c51c31461fc602071373bdff9edd1aed25f (patch) | |
tree | b98f1e2ae2e88ff5b26b01104ebbea080a590bc1 /runtime | |
parent | f66a2cda2c425c441fc5e20c8f8893c9630e3aaa (diff) |
patch 8.0.0960: job in terminal does not get CTRL-Cv8.0.0960
Problem: Job in terminal does not get CTRL-C, we send a SIGINT instead.
Solution: Don't call may_send_sigint() on CTRL-C. Make CTRL-W CTRL-C end
the job.
Diffstat (limited to 'runtime')
-rw-r--r-- | runtime/doc/terminal.txt | 29 |
1 files changed, 24 insertions, 5 deletions
diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt index ae99107aa8..1f23deb785 100644 --- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -52,6 +52,7 @@ Special in the terminal window: *CTRL-W_.* *CTRL-W_N* CTRL-W " {reg} paste register {reg} *CTRL-W_quote* Also works with the = register to insert the result of evaluating an expression. + CTRL-W CTRL-C ends the job, see below |t_CTRL-W_CTRL-C| See option 'termkey' for specifying another key instead of CTRL-W that will work like CTRL-W. However, typing 'termkey' twice sends 'termkey' to @@ -62,16 +63,29 @@ the job. For example: 'termkey' . send a CTRL-W to the job in the terminal 'termkey' N go to terminal Normal mode, see below 'termkey' CTRL-N same as CTRL-W N + 'termkey' CTRL-C same as |t_CTRL-W_CTRL-C| *t_CTRL-\_CTRL-N* The special key combination CTRL-\ CTRL-N can be used to switch to Normal mode, just like this works in any other mode. + *t_CTRL-W_CTRL-C* +CTRL-W CTRL-C can be typed to forcefully end the job. On MS-Windows a +CTRL-BREAK will also kill the job. +If you type CTRL-C the effect depends on what the pty has been configured to +do. For simple commands this causes a SIGINT to be sent to the job, which +would end it. Other commands may ignore the SIGINT or handle the CTRL-C +themselves (like Vim does). -Size ~ + +Size and color ~ See option 'termsize' for controlling the size of the terminal window. (TODO: scrolling when the terminal is larger than the window) +The terminal uses the 'background' option to decide whether the terminal +window will start with a white or black background. The job running in the +terminal can change the colors. + Syntax ~ @@ -115,8 +129,8 @@ Syntax ~ If you want to use more options use the |term_start()| function. -When the buffer associated with the terminal is wiped out the job is killed, -similar to calling `job_stop(job, "kill")` +When the buffer associated with the terminal is unloaded or wiped out the job +is killed, similar to calling `job_stop(job, "kill")` By default the 'bufhidden' option of the buffer will be set to "hide". So long as the job is running: If the window is closed the buffer becomes @@ -130,7 +144,7 @@ done, use options like this: > Note that the window will open at an unexpected moment, this will interrupt what you are doing. - *E947* + *E947* *E948* So long as the job is running, the buffer is considered modified and Vim cannot be quit easily, see |abandon|. @@ -187,6 +201,8 @@ In Terminal-Normal mode the statusline and window title show "(Terminal)". If the job ends while in Terminal-Normal mode this changes to "(Terminal-finished)". +It is not possible to enter Insert mode from Terminal-Job mode. + Unix ~ @@ -226,7 +242,10 @@ You can download them from the following page: https://github.com/rprichard/winpty -Just put the files somewhere in your PATH. +Just put the files somewhere in your PATH. You can set the 'winptydll' option +to point to the right file, if needed. If you have both the 32-bit and 64-bit +version, rename to winpty32.dll and winpty64.dll to match the way Vim was +build. ============================================================================== 2. Remote testing *terminal-testing* |