mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2026-07-21 08:31:47 +00:00
Code Issues Packages Projects Releases Wiki Activity

vim-patch:93eb081: runtime(doc): Clarify visual mark behavior in getpos(), setpos() (#37223)

Browse Source 
Add documentation notes explaining that visual marks '< and '> have
different behaviors in getpos() and setpos().

Also fix a small typo.

closes: vim/vim#19070

93eb081eee

Co-authored-by: Larson, Eric <numeric.larson@gmail.com>
This commit is contained in:
zeertzjq
2026-01-04 07:46:15 +08:00
committed by GitHub
parent db210dd2a4
commit 715015d3b2
3 changed files with 39 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
runtime/doc/vimfn.txt
View File

@@ -3930,6 +3930,11 @@ getpos({expr}) *getpos()*
within the line. To get the character position in the line,
use |getcharpos()|.
The visual marks |'<| and |'>| refer to the beginning and end
of the visual selection relative to the buffer. Note that
this differs from |setpos()|, where they are relative to the
cursor position.
Note that for '< and '> Visual mode matters: when it is "V"
(visual line mode) the column of '< is zero and the column of
'> is a large number equal to |v:maxcol|.
@@ -9149,9 +9154,14 @@ setpos({expr}, {list}) *setpos()*
preferred column is not set. When it is present and setting a
mark position it is not used.
Note that for '< and '> changing the line number may result in
the marks to be effectively be swapped, so that '< is always
before '>.
Note that for |'<| and |'>| changing the line number may
result in the marks to be effectively swapped, so that |'<| is
always before |'>|.
The visual marks |'<| and |'>| refer to the beginning and end
of the visual selection relative to the cursor position.
Note that this differs from |getpos()|, where they are
relative to the buffer.
Returns 0 when the position could be set, -1 otherwise.
An error message is given if {expr} is invalid.

16
runtime/lua/vim/_meta/vimfn.lua generated
View File

@@ -3532,6 +3532,11 @@ function vim.fn.getpid() end
--- within the line. To get the character position in the line,
--- use |getcharpos()|.
---
--- The visual marks |'<| and |'>| refer to the beginning and end
--- of the visual selection relative to the buffer. Note that
--- this differs from |setpos()|, where they are relative to the
--- cursor position.
---
--- Note that for '< and '> Visual mode matters: when it is "V"
--- (visual line mode) the column of '< is zero and the column of
--- '> is a large number equal to |v:maxcol|.
@@ -8333,9 +8338,14 @@ function vim.fn.setmatches(list, win) end
--- preferred column is not set. When it is present and setting a
--- mark position it is not used.
---
--- Note that for '< and '> changing the line number may result in
--- the marks to be effectively be swapped, so that '< is always
--- before '>.
--- Note that for |'<| and |'>| changing the line number may
--- result in the marks to be effectively swapped, so that |'<| is
--- always before |'>|.
---
--- The visual marks |'<| and |'>| refer to the beginning and end
--- of the visual selection relative to the cursor position.
--- Note that this differs from |getpos()|, where they are
--- relative to the buffer.
---
--- Returns 0 when the position could be set, -1 otherwise.
--- An error message is given if {expr} is invalid.

16
src/nvim/eval.lua
View File

@@ -4406,6 +4406,11 @@ M.funcs = {
within the line. To get the character position in the line,
use |getcharpos()|.
The visual marks |'<| and |'>| refer to the beginning and end
of the visual selection relative to the buffer. Note that
this differs from |setpos()|, where they are relative to the
cursor position.
Note that for '< and '> Visual mode matters: when it is "V"
(visual line mode) the column of '< is zero and the column of
'> is a large number equal to |v:maxcol|.
@@ -10108,9 +10113,14 @@ M.funcs = {
preferred column is not set. When it is present and setting a
mark position it is not used.
Note that for '< and '> changing the line number may result in
the marks to be effectively be swapped, so that '< is always
before '>.
Note that for |'<| and |'>| changing the line number may
result in the marks to be effectively swapped, so that |'<| is
always before |'>|.
The visual marks |'<| and |'>| refer to the beginning and end
of the visual selection relative to the cursor position.
Note that this differs from |getpos()|, where they are
relative to the buffer.
Returns 0 when the position could be set, -1 otherwise.
An error message is given if {expr} is invalid.