summaryrefslogtreecommitdiff
path: root/runtime
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2017-04-30 16:36:05 +0200
committerBram Moolenaar <Bram@vim.org>2017-04-30 16:36:05 +0200
commit45d2cca1ea3f90fc70ad99d0c6812a9d8536303c (patch)
tree1dfacd4b467fd8b197410514fc0bb307de6869cb /runtime
parent8f77c5a4ec756f3f866bd6b18feb6fca6f2a2e91 (diff)
downloadvim-git-45d2cca1ea3f90fc70ad99d0c6812a9d8536303c.tar.gz
patch 8.0.0591: changes to eval functionality not documentedv8.0.0591
Problem: Changes to eval functionality not documented. Solution: Include all the changes.
Diffstat (limited to 'runtime')
-rw-r--r--runtime/doc/eval.txt33
1 files changed, 21 insertions, 12 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 56aa25521..141f586bb 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 Apr 22
+*eval.txt* For Vim version 8.0. Last change: 2017 Apr 29
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -4584,6 +4584,7 @@ getqflist([{what}]) *getqflist()*
If the optional {what} dictionary argument is supplied, then
returns only the items listed in {what} as a dictionary. The
following string items are supported in {what}:
+ context get the context stored with |setqflist()|
nr get information for this quickfix list; zero
means the current quickfix list
title get the list title
@@ -4595,6 +4596,7 @@ getqflist([{what}]) *getqflist()*
returned.
The returned dictionary contains the following entries:
+ context context information stored with |setqflist()|
nr quickfix list number
title quickfix list title text
winid quickfix |window-ID| (if opened)
@@ -5265,9 +5267,14 @@ job_stop({job} [, {how}]) *job_stop()*
0 if "how" is not supported on the system.
Note that even when the operation was executed, whether the
job was actually stopped needs to be checked with
- job_status().
- The status of the job isn't checked, the operation will even
- be done when Vim thinks the job isn't running.
+ |job_status()|.
+
+ If the status of the job is "dead", the signal will not be
+ sent. This is to avoid to stop the wrong job (esp. on Unix,
+ where process numbers are recycled).
+
+ When using "kill" Vim will assume the job will die and close
+ the channel.
{only available when compiled with the |+job| feature}
@@ -6982,6 +6989,7 @@ setqflist({list} [, {action}[, {what}]]) *setqflist()*
only the items listed in {what} are set. The first {list}
argument is ignored. The following items can be specified in
{what}:
+ context any Vim type can be stored as a context
nr list number in the quickfix stack
title quickfix list title text
Unsupported keys in {what} are ignored.
@@ -10675,18 +10683,19 @@ missing: >
To execute a command only when the |+eval| feature is disabled requires a trick,
as this example shows: >
- if 1
- nnoremap : :"
- endif
- normal :set history=111<CR>
- if 1
- nunmap :
- endif
+
+ silent! while 0
+ set history=111
+ silent! endwhile
+
+When the |+eval| feature is available the command is skipped because of the
+"while 0". Without the |+eval| feature the "while 0" is an error, which is
+silently ignored, and the command is executed.
The "<CR>" here is a real CR character, type CTRL-V Enter to get it.
When the |+eval| feature is available the ":" is remapped to add a double
-quote, which has the effect of commenting-out the command. without the
+quote, which has the effect of commenting-out the command. Without the
|+eval| feature the nnoremap command is skipped and the command is executed.
==============================================================================