Mercurial > vim
diff runtime/doc/terminal.txt @ 12064:407a475c67fd v8.0.0912
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 |
line wrap: on
line diff
--- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -1,4 +1,4 @@ -*terminal.txt* For Vim version 8.0. Last change: 2017 Aug 10 +*terminal.txt* For Vim version 8.0. Last change: 2017 Aug 12 VIM REFERENCE MANUAL by Bram Moolenaar @@ -103,8 +103,17 @@ Syntax ~ ++close The terminal window will close automatically when the job terminates. ++open When the job terminates and no window - show it, a window will be opened. + shows it, a window will be opened. Note that this can be interruptive. + ++curwin Open the terminal in the current + window, do not split the current + window. Fails if the current buffer + cannot be |abandon|ed. + ++hidden Open the terminal in a hidden buffer, + no window will be used. + + 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")` @@ -114,6 +123,13 @@ So long as the job is running: If the wi hidden. The command will not be stopped. The `:buffer` command can be used to turn the current window into a terminal window. If there are unsaved changes this fails, use ! to force, as usual. + +To have a background job run without a window, and open the window when it's +done, use options like this: > + :term ++hidden ++open make +Note that the window will open at an unexpected moment, this will interrupt +what you are doing. + *E947* So long as the job is running, the buffer is considered modified and Vim cannot be quit easily, see |abandon|.