summaryrefslogtreecommitdiffstats
path: root/runtime
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2017-07-30 18:19:46 +0200
committerBram Moolenaar <Bram@vim.org>2017-07-30 18:19:46 +0200
commit22aad2f8806acf390568b8e524e53260a322aaa5 (patch)
treed343828b8d65e5675816fa7c1e6f46670014b475 /runtime
parentf144a3fb73340fe22e08bd1fa77e27c9f55bb0af (diff)
patch 8.0.0817: cannot get the terminal line at the cursorv8.0.0817
Problem: Cannot get the line of a terminal window at the cursor. Solution: Make the row argunt optionsl. (Yasuhiro Matsumoto, closes #1898)
Diffstat (limited to 'runtime')
-rw-r--r--runtime/doc/eval.txt19
1 files changed, 10 insertions, 9 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 9d26f361fa..dee7b64fa1 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 Jul 29
+*eval.txt* For Vim version 8.0. Last change: 2017 Jul 30
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2371,10 +2371,10 @@ tanh({expr}) Float hyperbolic tangent of {expr}
tempname() String name for a temporary file
term_getattr({attr}, {what} Number get the value of attribute {what}
term_getjob({buf}) Job get the job associated with a terminal
-term_getline({buf}, {row}) String get a line of text from a terminal
+term_getline({buf}[, {row}]) String get a line of text from a terminal
term_getsize({buf}) List get the size of a terminal
term_list() List get the list of terminal buffers
-term_scrape({buf}, {row}) List get row of a terminal screen
+term_scrape({buf}[, {row}]) List get row of a terminal screen
term_sendkeys({buf}, {keys}) none send keystrokes to a terminal
term_start({cmd}, {options}) Job open a terminal window and run a job
term_wait({buf}) Number wait for screen to be updated
@@ -7914,12 +7914,13 @@ term_getjob({buf}) *term_getjob()*
Get the Job associated with terminal window {buf}.
{buf} is used as with |term_getsize()|.
-term_getline({buf}, {row}) *term_getline()*
+term_getline({buf} [, {row}]) *term_getline()*
Get a line of text from the terminal window of {buf}.
{buf} is used as with |term_getsize()|.
The first line has {row} zero. When {row} is invalid an empty
- string is returned.
+ string is returned. When {row} is omitted, the cursor line is
+ used.
term_getsize({buf}) *term_getsize()*
Get the size of terminal {buf}. Returns a list with two
@@ -7930,17 +7931,17 @@ term_getsize({buf}) *term_getsize()*
buffer does not exist or is not a terminal window, an empty
list is returned.
-term_list(}) *term_list()*
+term_list() *term_list()*
Return a list with the buffer numbers of all buffers for
terminal windows.
-term_scrape({buf}, {row}) *term_scrape()*
+term_scrape({buf} [, {row}]) *term_scrape()*
Get the contents of {row} of terminal screen of {buf}.
For {buf} see |term_getsize()|.
The first {row} is zero. When {row} is invalid an empty list
- is returned.
-
+ is returned. When {row} is omitted the cursor line is used.
+
Return a List containing a Dict for each screen cell:
"chars" character(s) at the cell
"fg" foreground color as #rrggbb