patch 8.0.0864: cannot specify the name of a terminal
Problem: Cannot specify the name of a terminal.
Solution: Add the "term_name" option. (Yasuhiro Matsumoto, closes #1936)
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index ff9dac2..261b5ca 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt* For Vim version 8.0. Last change: 2017 Aug 03
+*eval.txt* For Vim version 8.0. Last change: 2017 Aug 05
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -8008,7 +8008,23 @@
Returns the buffer number of the terminal window.
When opening the window fails zero is returned.
- {options} are not implemented yet.
+ {options} are similar to what is used for |job_start()|, see
+ |job-options|. However, not all options can be used. These
+ are supported:
+ all timeout options
+ "stoponexit"
+ "out_cb", "err_cb"
+ "exit_cb", "close_cb"
+ "in_io", "in_top", "in_bot", "in_name", "in_buf"
+ "out_io", "out_name", "out_buf", "out_modifiable", "out_msg"
+ "err_io", "err_name", "err_buf", "err_modifiable", "err_msg"
+ However, at least one of stdin, stdout or stderr must be
+ connected to the terminal. When I/O is connected to the
+ terminal then the callback function for that part is not used.
+
+ There is one extra option:
+ "term_name" name to use for the buffer name, instead of
+ the command name.
term_wait({buf}) *term_wait()*
Wait for pending updates of {buf} to be handled.