Mercurial > vim

comparison runtime/doc/terminal.txt @ 12064:407a475c67fd v8.0.0912

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.0.0912: cannot run a job in a hidden terminal commit https://github.com/vim/vim/commit/8cad930a259a05a95c7d0c527a5881d5f9a59057 Author: Bram Moolenaar <Bram@vim.org> Date: Sat Aug 12 14:32:32 2017 +0200 patch 8.0.0912: cannot run a job in a hidden terminal Problem: Cannot run a job in a hidden terminal. Solution: Add option "hidden" and ++hidden.
author Christian Brabandt <cb@256bit.org>
date Sat, 12 Aug 2017 14:45:04 +0200
parents 9897241c08b5
children b80c0172d1a8
comparison
equal deleted inserted replaced
12063:2372e456e821 12064:407a475c67fd
1 *terminal.txt* For Vim version 8.0. Last change: 2017 Aug 10 1 *terminal.txt* For Vim version 8.0. Last change: 2017 Aug 12
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
101 *term++close* *term++open* 101 *term++close* *term++open*
102 Supported [options] are: 102 Supported [options] are:
103 ++close The terminal window will close 103 ++close The terminal window will close
104 automatically when the job terminates. 104 automatically when the job terminates.
105 ++open When the job terminates and no window 105 ++open When the job terminates and no window
106 show it, a window will be opened. 106 shows it, a window will be opened.
107 Note that this can be interruptive. 107 Note that this can be interruptive.
108 ++curwin Open the terminal in the current
109 window, do not split the current
110 window. Fails if the current buffer
111 cannot be |abandon|ed.
112 ++hidden Open the terminal in a hidden buffer,
113 no window will be used.
114
115 If you want to use more options use the |term_start()|
116 function.
108 117
109 When the buffer associated with the terminal is wiped out the job is killed, 118 When the buffer associated with the terminal is wiped out the job is killed,
110 similar to calling `job_stop(job, "kill")` 119 similar to calling `job_stop(job, "kill")`
111 120
112 By default the 'bufhidden' option of the buffer will be set to "hide". 121 By default the 'bufhidden' option of the buffer will be set to "hide".
113 So long as the job is running: If the window is closed the buffer becomes 122 So long as the job is running: If the window is closed the buffer becomes
114 hidden. The command will not be stopped. The `:buffer` command can be used 123 hidden. The command will not be stopped. The `:buffer` command can be used
115 to turn the current window into a terminal window. If there are unsaved 124 to turn the current window into a terminal window. If there are unsaved
116 changes this fails, use ! to force, as usual. 125 changes this fails, use ! to force, as usual.
126
127 To have a background job run without a window, and open the window when it's
128 done, use options like this: >
129 :term ++hidden ++open make
130 Note that the window will open at an unexpected moment, this will interrupt
131 what you are doing.
132
117 *E947* 133 *E947*
118 So long as the job is running, the buffer is considered modified and Vim 134 So long as the job is running, the buffer is considered modified and Vim
119 cannot be quit easily, see |abandon|. 135 cannot be quit easily, see |abandon|.
120 136
121 When the job has finished and no changes were made to the buffer: closing the 137 When the job has finished and no changes were made to the buffer: closing the