Mercurial > vim
changeset 11414:c95c5ddc3b0d v8.0.0591
patch 8.0.0591: changes to eval functionality not documented
commit https://github.com/vim/vim/commit/45d2cca1ea3f90fc70ad99d0c6812a9d8536303c
Author: Bram Moolenaar <Bram@vim.org>
Date: Sun Apr 30 16:36:05 2017 +0200
patch 8.0.0591: changes to eval functionality not documented
Problem: Changes to eval functionality not documented.
Solution: Include all the changes.
| author | Christian Brabandt <cb@256bit.org> |
|---|---|
| date | Sun, 30 Apr 2017 16:45:03 +0200 |
| parents | a3d6075a35ad |
| children | 9a99bb6c075d |
| files | runtime/doc/eval.txt src/version.c |
| diffstat | 2 files changed, 23 insertions(+), 12 deletions(-) [+] |
line wrap: on
line diff
--- 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}]]) 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. ==============================================================================