Mercurial > vim

comparison runtime/doc/eval.txt @ 1065:caa550fe4457 v7.0.191

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated for version 7.0-191
author vimboss
date Sun, 04 Feb 2007 01:58:18 +0000
parents 82b2594be408
children 4c8b90b7a94a
comparison
equal deleted inserted replaced
1064:a8bcc7553263 1065:caa550fe4457
2895 lnum line number in the buffer (first line is 1) 2895 lnum line number in the buffer (first line is 1)
2896 col column number (first column is 1) 2896 col column number (first column is 1)
2897 vcol non-zero: "col" is visual column 2897 vcol non-zero: "col" is visual column
2898 zero: "col" is byte index 2898 zero: "col" is byte index
2899 nr error number 2899 nr error number
2900 pattern search pattern used to locate the error
2900 text description of the error 2901 text description of the error
2901 type type of the error, 'E', '1', etc. 2902 type type of the error, 'E', '1', etc.
2902 valid non-zero: recognized error message 2903 valid non-zero: recognized error message
2903 2904
2904 When there is no error list or it's empty an empty list is 2905 When there is no error list or it's empty an empty list is
2905 returned. 2906 returned. Quickfix list entries with non-existing buffer
2907 number are returned with "bufnr" set to zero.
2906 2908
2907 Useful application: Find pattern matches in multiple files and 2909 Useful application: Find pattern matches in multiple files and
2908 do something with them: > 2910 do something with them: >
2909 :vimgrep /theword/jg *.c 2911 :vimgrep /theword/jg *.c
2910 :for d in getqflist() 2912 :for d in getqflist()
4369 Create or replace or add to the quickfix list using the items 4371 Create or replace or add to the quickfix list using the items
4370 in {list}. Each item in {list} is a dictionary. 4372 in {list}. Each item in {list} is a dictionary.
4371 Non-dictionary items in {list} are ignored. Each dictionary 4373 Non-dictionary items in {list} are ignored. Each dictionary
4372 item can contain the following entries: 4374 item can contain the following entries:
4373 4375
4374 filename name of a file 4376 bufnr buffer number; must be the number of a valid
4377 buffer
4378 filename name of a file; only used when "bufnr" is not
4379 present or it is invalid.
4375 lnum line number in the file 4380 lnum line number in the file
4376 pattern search pattern used to locate the error 4381 pattern search pattern used to locate the error
4377 col column number 4382 col column number
4378 vcol when non-zero: "col" is visual column 4383 vcol when non-zero: "col" is visual column
4379 when zero: "col" is byte index 4384 when zero: "col" is byte index
4382 type single-character error type, 'E', 'W', etc. 4387 type single-character error type, 'E', 'W', etc.
4383 4388
4384 The "col", "vcol", "nr", "type" and "text" entries are 4389 The "col", "vcol", "nr", "type" and "text" entries are
4385 optional. Either "lnum" or "pattern" entry can be used to 4390 optional. Either "lnum" or "pattern" entry can be used to
4386 locate a matching error line. 4391 locate a matching error line.
4387 If the "filename" entry is not present or neither the "lnum" 4392 If the "filename" and "bufnr" entries are not present or
4388 or "pattern" entries are present, then the item will not be 4393 neither the "lnum" or "pattern" entries are present, then the
4389 handled as an error line. 4394 item will not be handled as an error line.
4390 If both "pattern" and "lnum" are present then "pattern" will 4395 If both "pattern" and "lnum" are present then "pattern" will
4391 be used. 4396 be used.
4397 Note that the list is not exactly the same as what
4398 |getqflist()| returns.
4392 4399
4393 If {action} is set to 'a', then the items from {list} are 4400 If {action} is set to 'a', then the items from {list} are
4394 added to the existing quickfix list. If there is no existing 4401 added to the existing quickfix list. If there is no existing
4395 list, then a new list is created. If {action} is set to 'r', 4402 list, then a new list is created. If {action} is set to 'r',
4396 then the items from the current quickfix list are replaced 4403 then the items from the current quickfix list are replaced