adam/vim
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

runtime(doc): some improvements to getregion() docs (#14122)

Browse Source 
- Mention the default selection behavior
- Remove useless sentence
- Correct description about space padding

Signed-off-by: zeertzjq <zeertzjq@outlook.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
zeertzjq
2024-03-02 06:00:23 +08:00
committed by GitHub
parent 8fad5d5887
commit 87410ab3f5
1 changed files with 12 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
runtime/doc/builtin.txt
View File

@ -1,4 +1,4 @@
*builtin.txt* For Vim version 9.1. Last change: 2024 Feb 28 *builtin.txt* For Vim version 9.1. Last change: 2024 Mar 01
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -4281,32 +4281,31 @@ getregion({pos1}, {pos2} [, {opts}]) *getregion()*
The optional argument {opts} is a Dict and supports the The optional argument {opts} is a Dict and supports the
following items: following items:
type Specify the selection type type Specify the region's selection type
(default: "v"): (default: "v"):
"v" for |characterwise| mode "v" for |characterwise| mode
"V" for |linewise| mode "V" for |linewise| mode
"<CTRL-V>" for |blockwise-visual| mode "<CTRL-V>" for |blockwise-visual| mode
exclusive If |true|, use exclusive selection exclusive If |TRUE|, use exclusive selection
for the end position 'selection'. for the end position
(default: follow 'selection')
You can get the last selection type by |visualmode()|. You can get the last selection type by |visualmode()|.
If Visual mode is active, use |mode()| to get the Visual mode If Visual mode is active, use |mode()| to get the Visual mode
(e.g., in a |:vmap|). (e.g., in a |:vmap|).
This function uses the line and column number from the This function is useful to get text starting and ending in
specified position. different columns, such as a |characterwise-visual| selection.
It is useful to get text starting and ending in different
columns, such as |characterwise-visual| selection.
Note that: Note that:
- Order of {pos1} and {pos2} doesn't matter, it will always - Order of {pos1} and {pos2} doesn't matter, it will always
return content from the upper left position to the lower return content from the upper left position to the lower
right position. right position.
- If 'virtualedit' is enabled and selection is past the end of - If 'virtualedit' is enabled and the region is past the end
line, resulting lines are filled with blanks. of the lines, resulting lines are padded with spaces.
- If the selection starts or ends in the middle of a multibyte - If the region is blockwise and it starts or ends in the
character, it is not included but its selected part is middle of a multi-cell character, it is not included but
substituted with spaces. its selected part is substituted with spaces.
- If {pos1} or {pos2} is not current in the buffer, an empty - If {pos1} or {pos2} is not current in the buffer, an empty
list is returned. list is returned.