From 45d2cca1ea3f90fc70ad99d0c6812a9d8536303c Mon Sep 17 00:00:00 2001 From: Bram Moolenaar Date: Sun, 30 Apr 2017 16:36:05 +0200 Subject: patch 8.0.0591: changes to eval functionality not documented Problem: Changes to eval functionality not documented. Solution: Include all the changes. --- runtime/doc/eval.txt | 33 +++++++++++++++++++++------------ src/version.c | 2 ++ 2 files changed, 23 insertions(+), 12 deletions(-) diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 56aa255214..141f586bb3 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 - 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 "" 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. ============================================================================== diff --git a/src/version.c b/src/version.c index 3177f7734a..45f80ee544 100644 --- a/src/version.c +++ b/src/version.c @@ -764,6 +764,8 @@ static char *(features[]) = static int included_patches[] = { /* Add new patch number below this line */ +/**/ + 591, /**/ 590, /**/ -- cgit v1.2.3