Mercurial > vim
diff runtime/doc/eval.txt @ 12427:fc3e2d5614dd v8.0.1093
patch 8.0.1093: various small quickfix issues
commit https://github.com/vim/vim/commit/b4d5fbabc99917a8069ba32a60c2d73d4f60e128
Author: Bram Moolenaar <Bram@vim.org>
Date: Mon Sep 11 19:31:28 2017 +0200
patch 8.0.1093: various small quickfix issues
Problem: Various small quickfix issues.
Solution: Remove ":" prefix from title set by a user. Add the qf_id2nr().
function. Add a couple more tests. Update documentation.
(Yegappan Lakshmanan)
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Mon, 11 Sep 2017 19:45:04 +0200 |
parents | d0cf7f71b95b |
children | 805f7fd40e0d |
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 Aug 13 +*eval.txt* For Vim version 8.0. Last change: 2017 Sep 11 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1449,7 +1449,7 @@ v:beval_text The text under or after the but a dot and "->" before the position is included. When on a ']' the text before it is used, including the matching '[' and word before it. When on a Visual area within one line the - highlighted text is used. + highlighted text is used. Also see |<cexpr>|. Only valid while evaluating the 'balloonexpr' option. *v:beval_winnr* *beval_winnr-variable* @@ -3301,7 +3301,7 @@ count({comp}, {expr} [, {ic} [, {start}] When {ic} is given and it's |TRUE| then case is ignored. When {comp} is a string then the number of not overlapping - occurences of {expr} is returned. + occurrences of {expr} is returned. *cscope_connection()* @@ -3467,7 +3467,7 @@ escape({string}, {chars}) *escape()* :echo escape('c:\program files\vim', ' \') < results in: > c:\\program\ files\\vim -< Also see |shellescape()|. +< Also see |shellescape()| and |fnameescape()|. *eval()* eval({string}) Evaluate {string} and return the result. Especially useful to @@ -3887,7 +3887,7 @@ float2nr({expr}) *float2nr()* When the value of {expr} is out of range for a |Number| the result is truncated to 0x7fffffff or -0x7fffffff (or when 64-bit Number support is enabled, 0x7fffffffffffffff or - -0x7fffffffffffffff. NaN results in -0x80000000 (or when + -0x7fffffffffffffff). NaN results in -0x80000000 (or when 64-bit Number support is enabled, -0x8000000000000000). Examples: > echo float2nr(3.95) @@ -4657,12 +4657,12 @@ getqflist([{what}]) *getqflist()* If "nr" is not present then the current quickfix list is used. If both "nr" and a non-zero "id" are specified, then the list specified by "id" is used. - To get the number of lists in the quickfix stack, set 'nr' to - '$' in {what}. The 'nr' value in the returned dictionary + To get the number of lists in the quickfix stack, set "nr" to + "$" in {what}. The "nr" value in the returned dictionary contains the quickfix stack size. - When 'text' is specified, all the other items are ignored. The - returned dictionary contains the entry 'items' with the list - of entries. + When "lines" is specified, all the other items except "efm" + are ignored. The returned dictionary contains the entry + "items" with the list of entries. In case of error processing {what}, an empty dictionary is returned. @@ -6967,6 +6967,7 @@ setline({lnum}, {text}) *setline()* :for [n, l] in [[5, 'aaa'], [6, 'bbb'], [7, 'ccc']] : call setline(n, l) :endfor + < Note: The '[ and '] marks are not set. setloclist({nr}, {list}[, {action}[, {what}]]) *setloclist()* @@ -7164,16 +7165,17 @@ setreg({regname}, {value} [, {options}]) :call setreg('a', "1\n2\n3", 'b5') < This example shows using the functions to save and restore a - register (note: you may not reliably restore register value - without using the third argument to |getreg()| as without it - newlines are represented as newlines AND Nul bytes are - represented as newlines as well, see |NL-used-for-Nul|). > + register: > :let var_a = getreg('a', 1, 1) :let var_amode = getregtype('a') .... :call setreg('a', var_a, var_amode) - -< You can also change the type of a register by appending +< Note: you may not reliably restore register value + without using the third argument to |getreg()| as without it + newlines are represented as newlines AND Nul bytes are + represented as newlines as well, see |NL-used-for-Nul|. + + You can also change the type of a register by appending nothing: > :call setreg('a', '', 'al') @@ -8145,7 +8147,7 @@ term_start({cmd}, {options}) *term_st are supported: all timeout options "stoponexit" - "out_cb", "err_cb" + "callback", "out_cb", "err_cb" "exit_cb", "close_cb" "in_io", "in_top", "in_bot", "in_name", "in_buf" "out_io", "out_name", "out_buf", "out_modifiable", "out_msg" @@ -8165,6 +8167,7 @@ term_start({cmd}, {options}) *term_st "curwin" use the current window, do not split the window; fails if the current buffer cannot be |abandon|ed + "hidden" do not open a window "term_finish" What to do when the job is finished: "close": close any windows "open": open window if needed @@ -8562,7 +8565,7 @@ win_getid([{win} [, {tab}]]) *win_get Get the |window-ID| for the specified window. When {win} is missing use the current window. With {win} this is the window number. The top window has - number 1. + number 1. Use `win_getid(winnr())` for the current window. Without {tab} use the current tab, otherwise the tab with number {tab}. The first tab has number one. Return zero if the window cannot be found.