Mercurial > vim

comparison runtime/doc/eval.txt @ 11502:46bbef0ee9a6 v8.0.0634

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.0.0634: cannot easily get to the last quickfix list commit https://github.com/vim/vim/commit/875feea6ce223462d55543735143d747dcaf4287 Author: Bram Moolenaar <Bram@vim.org> Date: Sun Jun 11 16:07:51 2017 +0200 patch 8.0.0634: cannot easily get to the last quickfix list Problem: Cannot easily get to the last quickfix list. Solution: Add "$" as a value for the "nr" argument of getqflist() and setqflist(). (Yegappan Lakshmanan)
author Christian Brabandt <cb@256bit.org>
date Sun, 11 Jun 2017 16:15:04 +0200
parents bd6ff5246c71
children 63b0b7b79b25
comparison
equal deleted inserted replaced
11501:2ac2ec9f4160 11502:46bbef0ee9a6
1 *eval.txt* For Vim version 8.0. Last change: 2017 Jun 04 1 *eval.txt* For Vim version 8.0. Last change: 2017 Jun 05
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
4585 If the optional {what} dictionary argument is supplied, then 4585 If the optional {what} dictionary argument is supplied, then
4586 returns only the items listed in {what} as a dictionary. The 4586 returns only the items listed in {what} as a dictionary. The
4587 following string items are supported in {what}: 4587 following string items are supported in {what}:
4588 context get the context stored with |setqflist()| 4588 context get the context stored with |setqflist()|
4589 nr get information for this quickfix list; zero 4589 nr get information for this quickfix list; zero
4590 means the current quickfix list 4590 means the current quickfix list and '$' means
4591 the last quickfix list
4591 title get the list title 4592 title get the list title
4592 winid get the |window-ID| (if opened) 4593 winid get the |window-ID| (if opened)
4593 all all of the above quickfix properties 4594 all all of the above quickfix properties
4594 Non-string items in {what} are ignored. 4595 Non-string items in {what} are ignored.
4595 If "nr" is not present then the current quickfix list is used. 4596 If "nr" is not present then the current quickfix list is used.
4597 To get the number of lists in the quickfix stack, set 'nr' to
4598 '$' in {what}. The 'nr' value in the returned dictionary
4599 contains the quickfix stack size.
4596 In case of error processing {what}, an empty dictionary is 4600 In case of error processing {what}, an empty dictionary is
4597 returned. 4601 returned.
4598 4602
4599 The returned dictionary contains the following entries: 4603 The returned dictionary contains the following entries:
4600 context context information stored with |setqflist()| 4604 context context information stored with |setqflist()|
6989 If the optional {what} dictionary argument is supplied, then 6993 If the optional {what} dictionary argument is supplied, then
6990 only the items listed in {what} are set. The first {list} 6994 only the items listed in {what} are set. The first {list}
6991 argument is ignored. The following items can be specified in 6995 argument is ignored. The following items can be specified in
6992 {what}: 6996 {what}:
6993 context any Vim type can be stored as a context 6997 context any Vim type can be stored as a context
6994 nr list number in the quickfix stack 6998 nr list number in the quickfix stack; zero
6999 means the current quickfix list and '$' means
7000 the last quickfix list
6995 title quickfix list title text 7001 title quickfix list title text
6996 Unsupported keys in {what} are ignored. 7002 Unsupported keys in {what} are ignored.
6997 If the "nr" item is not present, then the current quickfix list 7003 If the "nr" item is not present, then the current quickfix list
6998 is modified. 7004 is modified.
6999 7005
7093 On MS-Windows and MS-DOS, when 'shellslash' is not set, it 7099 On MS-Windows and MS-DOS, when 'shellslash' is not set, it
7094 will enclose {string} in double quotes and double all double 7100 will enclose {string} in double quotes and double all double
7095 quotes within {string}. 7101 quotes within {string}.
7096 Otherwise it will enclose {string} in single quotes and 7102 Otherwise it will enclose {string} in single quotes and
7097 replace all "'" with "'\''". 7103 replace all "'" with "'\''".
7104
7098 When the {special} argument is present and it's a non-zero 7105 When the {special} argument is present and it's a non-zero
7099 Number or a non-empty String (|non-zero-arg|), then special 7106 Number or a non-empty String (|non-zero-arg|), then special
7100 items such as "!", "%", "#" and "<cword>" will be preceded by 7107 items such as "!", "%", "#" and "<cword>" will be preceded by
7101 a backslash. This backslash will be removed again by the |:!| 7108 a backslash. This backslash will be removed again by the |:!|
7102 command. 7109 command.
7110
7103 The "!" character will be escaped (again with a |non-zero-arg| 7111 The "!" character will be escaped (again with a |non-zero-arg|
7104 {special}) when 'shell' contains "csh" in the tail. That is 7112 {special}) when 'shell' contains "csh" in the tail. That is
7105 because for csh and tcsh "!" is used for history replacement 7113 because for csh and tcsh "!" is used for history replacement
7106 even when inside single quotes. 7114 even when inside single quotes.
7107 The <NL> character is also escaped. With a |non-zero-arg| 7115
7108 {special} and 'shell' containing "csh" in the tail it's 7116 With a |non-zero-arg| {special} the <NL> character is also
7117 escaped. When 'shell' containing "csh" in the tail it's
7109 escaped a second time. 7118 escaped a second time.
7119
7110 Example of use with a |:!| command: > 7120 Example of use with a |:!| command: >
7111 :exe '!dir ' . shellescape(expand('<cfile>'), 1) 7121 :exe '!dir ' . shellescape(expand('<cfile>'), 1)
7112 < This results in a directory listing for the file under the 7122 < This results in a directory listing for the file under the
7113 cursor. Example of use with |system()|: > 7123 cursor. Example of use with |system()|: >
7114 :call system("chmod +w -- " . shellescape(expand("%"))) 7124 :call system("chmod +w -- " . shellescape(expand("%")))