summaryrefslogtreecommitdiffstats
path: root/runtime/doc/eval.txt
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2007-02-04 01:58:18 +0000
committerBram Moolenaar <Bram@vim.org>2007-02-04 01:58:18 +0000
commit48b66fb5a7197c79c05de133dddc8563cc942d9b (patch)
treebdb029523ae3cc017db31b6821ec42236145ee12 /runtime/doc/eval.txt
parent86ea76404e0f1d41aa14dd7b4302bed4f503ef58 (diff)
updated for version 7.0-191v7.0.191
Diffstat (limited to 'runtime/doc/eval.txt')
-rw-r--r--runtime/doc/eval.txt17
1 files changed, 12 insertions, 5 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 7c928ea84a..22421bb5cf 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -2897,12 +2897,14 @@ getqflist() *getqflist()*
vcol non-zero: "col" is visual column
zero: "col" is byte index
nr error number
+ pattern search pattern used to locate the error
text description of the error
type type of the error, 'E', '1', etc.
valid non-zero: recognized error message
When there is no error list or it's empty an empty list is
- returned.
+ returned. Quickfix list entries with non-existing buffer
+ number are returned with "bufnr" set to zero.
Useful application: Find pattern matches in multiple files and
do something with them: >
@@ -4371,7 +4373,10 @@ setqflist({list} [, {action}]) *setqflist()*
Non-dictionary items in {list} are ignored. Each dictionary
item can contain the following entries:
- filename name of a file
+ bufnr buffer number; must be the number of a valid
+ buffer
+ filename name of a file; only used when "bufnr" is not
+ present or it is invalid.
lnum line number in the file
pattern search pattern used to locate the error
col column number
@@ -4384,11 +4389,13 @@ setqflist({list} [, {action}]) *setqflist()*
The "col", "vcol", "nr", "type" and "text" entries are
optional. Either "lnum" or "pattern" entry can be used to
locate a matching error line.
- If the "filename" entry is not present or neither the "lnum"
- or "pattern" entries are present, then the item will not be
- handled as an error line.
+ If the "filename" and "bufnr" entries are not present or
+ neither the "lnum" or "pattern" entries are present, then the
+ item will not be handled as an error line.
If both "pattern" and "lnum" are present then "pattern" will
be used.
+ Note that the list is not exactly the same as what
+ |getqflist()| returns.
If {action} is set to 'a', then the items from {list} are
added to the existing quickfix list. If there is no existing