summaryrefslogtreecommitdiffstats
path: root/runtime
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2006-03-03 22:56:30 +0000
committerBram Moolenaar <Bram@vim.org>2006-03-03 22:56:30 +0000
commit65c923adf3589b6c237ac357fcc069085c658a02 (patch)
tree8c379ffd9462f1be67f06f9a9b3712570d219c2e /runtime
parentbfb2d40b6ec0b8fff51bc6fadabf4aaeb383beb8 (diff)
updated for version 7.0213
Diffstat (limited to 'runtime')
-rw-r--r--runtime/doc/eval.txt65
-rw-r--r--runtime/doc/options.txt6
-rw-r--r--runtime/doc/tags3
3 files changed, 58 insertions, 16 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index a35ebab6b9..b2ca199447 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt* For Vim version 7.0aa. Last change: 2006 Mar 02
+*eval.txt* For Vim version 7.0aa. Last change: 2006 Mar 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1845,9 +1845,13 @@ bufname({expr}) *bufname()*
Obsolete name: buffer_name().
*bufnr()*
-bufnr({expr}) The result is the number of a buffer, as it is displayed by
+bufnr({expr} [, {create}])
+ The result is the number of a buffer, as it is displayed by
the ":ls" command. For the use of {expr}, see |bufname()|
- above. If the buffer doesn't exist, -1 is returned.
+ above.
+ If the buffer doesn't exist, -1 is returned. Or, if the
+ {create} argument is present and not zero, a new, unlisted,
+ buffer is created and its number is returned.
bufnr("$") is the last buffer: >
:let last_buffer = bufnr("$")
< The result is a Number, which is the highest buffer number
@@ -2078,9 +2082,8 @@ cursor({list})
Positions the cursor at the column {col} in the line {lnum}.
The first column is one.
When there is one argument {list} this is used as a |List|
- with two or three items {lnum}, {col} and {off}. This is
- useful to move the cursor to a position obtained with
- |getpos()|.
+ with two or three items {lnum}, {col} and {off}. This is like
+ the return value of |getpos()|, but without the first item.
Does not change the jumplist.
If {lnum} is greater than the number of lines in the buffer,
the cursor will be positioned at the last line in the buffer.
@@ -3241,7 +3244,7 @@ line({expr}) The result is a Number, which is the line number of the file
returned)
w0 first line visible in current window
w$ last line visible in current window
- Note that only marks in the current file can be used.
+ Note that a mark in another file can be used.
To get the column number use |col()|. To get both use
|getpos()|.
Examples: >
@@ -3510,9 +3513,14 @@ nr2char({expr}) *nr2char()*
string, thus results in an empty string.
*getpos()*
-getpos({expr}) The result is a |List| with three numbers: [lnum, col, off].
- This is the file position given with {expr}. For the accepted
- positions see |line()|.
+getpos({expr}) Get the position for {expr}. For possible values of {expr}
+ see |line()|.
+ The result is a |List| with four numbers:
+ [bufnum, lnum, col, off]
+ "bufnum" is zero, unless a mark like '0 or 'A is used, then it
+ is the buffer number of the mark.
+ "lnum" and "col" are the position in the buffer. The first
+ column is 1.
The "off" number is zero, unless 'virtualedit' is used. Then
it is the offset in screen columns from the start of the
character. E.g., a position within a Tab or after the last
@@ -3520,7 +3528,8 @@ getpos({expr}) The result is a |List| with three numbers: [lnum, col, off].
This can be used to save and restore the cursor position: >
let save_cursor = getpos(".")
MoveTheCursorAround
- call cursor(save_cursor)
+ call setpos(save_cursor)
+< Also see |setpos()|.
prevnonblank({lnum}) *prevnonblank()*
Return the line number of the first line at or above {lnum}
@@ -3846,13 +3855,14 @@ reverse({list}) Reverse the order of items in {list} in-place. Returns
search({pattern} [, {flags} [, {stopline}]]) *search()*
Search for regexp pattern {pattern}. The search starts at the
cursor position (you can use |cursor()| to set it).
+
{flags} is a String, which can contain these character flags:
'b' search backward instead of forward
'n' do Not move the cursor
'w' wrap around the end of the file
'W' don't wrap around the end of the file
- 's' set the ' mark at the previous location of the
- cursor.
+ 's' set the ' mark at the previous location of the cursor
+ 'c' accept a match at the cursor position
If neither 'w' or 'W' is given, the 'wrapscan' option applies.
If the 's' flag is supplied, the ' mark is set, only if the
@@ -3869,7 +3879,7 @@ search({pattern} [, {flags} [, {stopline}]]) *search()*
When a match has been found its line number is returned.
The cursor will be positioned at the match, unless the 'n'
- flag is used).
+ flag is used.
If there is no match a 0 is returned and the cursor doesn't
move. No error message is given.
To get the column number too use |searchpos()|.
@@ -3930,7 +3940,6 @@ searchpair({start}, {middle}, {end} [, {flags} [, {skip} [, {stopline}]]])
< By leaving {middle} empty the "else" is skipped.
{flags} are used like with |search()|. Additionally:
- 'n' do Not move the cursor
'r' Repeat until no more matches found; will find the
outer pair
'm' return number of Matches instead of line number with
@@ -4083,6 +4092,32 @@ setloclist({nr}, {list} [, {action}]) *setloclist()*
invalid window number {nr}, -1 is returned.
Otherwise, same as setqflist().
+ *setpos()*
+setpos({expr}, {list})
+ Set the position for {expr}. Possible values:
+ . the cursor
+ 'x mark x
+
+ {list} must be a |List| with four numbers:
+ [bufnum, lnum, col, off]
+
+ "bufnum" is the buffer number. Zero can be used for the
+ current buffer. Setting the cursor is only possible for
+ the current buffer. To set a mark in another buffer you can
+ use the |bufnr()| function to turn a file name into a buffer
+ number.
+
+ "lnum" and "col" are the position in the buffer. The first
+ column is 1. Use a zero "lnum" to delete a mark.
+
+ The "off" number is only used when 'virtualedit' is set. Then
+ it is the offset in screen columns from the start of the
+ character. E.g., a position within a Tab or after the last
+ character.
+
+ Also see |getpos()|
+
+
setqflist({list} [, {action}]) *setqflist()*
Create or replace or add to the quickfix list using the items
in {list}. Each item in {list} is a dictionary.
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 96292dc249..43cc7cd7e0 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt* For Vim version 7.0aa. Last change: 2006 Mar 02
+*options.txt* For Vim version 7.0aa. Last change: 2006 Mar 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1629,6 +1629,10 @@ A jump table for the options with a short description can be found at |Q_op|.
menu is only shown when there is more than one match and
sufficient colors are available. |ins-completion-menu|
+ menuone Use the popup menu also when there is only one match.
+ Useful when there is additional information about the
+ match, e.g., what file it comes from.
+
longest Only insert the longest common text of the matches. Use
CTRL-L to add more characters. Whether case is ignored
depends on the kind of completion. For buffer text the
diff --git a/runtime/doc/tags b/runtime/doc/tags
index 7c69055e63..0b1784092e 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -5476,6 +5476,7 @@ hebrew hebrew.txt /*hebrew*
hebrew.txt hebrew.txt /*hebrew.txt*
help various.txt /*help*
help-context help.txt /*help-context*
+help-tags tags 1
help-translated various.txt /*help-translated*
help-xterm-window various.txt /*help-xterm-window*
help.txt help.txt /*help.txt*
@@ -6608,6 +6609,7 @@ setbufvar() eval.txt /*setbufvar()*
setcmdpos() eval.txt /*setcmdpos()*
setline() eval.txt /*setline()*
setloclist() eval.txt /*setloclist()*
+setpos() eval.txt /*setpos()*
setqflist() eval.txt /*setqflist()*
setreg() eval.txt /*setreg()*
setting-guifont gui.txt /*setting-guifont*
@@ -6986,6 +6988,7 @@ tab-page tabpage.txt /*tab-page*
tab-page-commands tabpage.txt /*tab-page-commands*
tab-page-intro tabpage.txt /*tab-page-intro*
tab-page-other tabpage.txt /*tab-page-other*
+tabline-menu tabpage.txt /*tabline-menu*
tabpage tabpage.txt /*tabpage*
tabpage.txt tabpage.txt /*tabpage.txt*
tabpagebuflist() eval.txt /*tabpagebuflist()*