Mercurial > vim
changeset 34463:4944acf6b46f
runtime(doc): some improvements to getregion() docs (#14122)
Commit: https://github.com/vim/vim/commit/87410ab3f556121dfb3b30515f40c5f079edd004
Author: zeertzjq <zeertzjq@outlook.com>
Date: Sat Mar 2 06:00:23 2024 +0800
runtime(doc): some improvements to getregion() docs (https://github.com/vim/vim/issues/14122)
- 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>
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Fri, 01 Mar 2024 23:15:06 +0100 |
parents | dec52278add8 |
children | 9702c63dd040 |
files | runtime/doc/builtin.txt |
diffstat | 1 files changed, 12 insertions(+), 13 deletions(-) [+] |
line wrap: on
line diff
--- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -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 @@ -4281,32 +4281,31 @@ getregion({pos1}, {pos2} [, {opts}]) * The optional argument {opts} is a Dict and supports the following items: - type Specify the selection type + type Specify the region's selection type (default: "v"): "v" for |characterwise| mode "V" for |linewise| mode "<CTRL-V>" for |blockwise-visual| mode - exclusive If |true|, use exclusive selection - for the end position 'selection'. + exclusive If |TRUE|, use exclusive selection + for the end position + (default: follow 'selection') You can get the last selection type by |visualmode()|. If Visual mode is active, use |mode()| to get the Visual mode (e.g., in a |:vmap|). - This function uses the line and column number from the - specified position. - It is useful to get text starting and ending in different - columns, such as |characterwise-visual| selection. + This function is useful to get text starting and ending in + different columns, such as a |characterwise-visual| selection. Note that: - Order of {pos1} and {pos2} doesn't matter, it will always return content from the upper left position to the lower right position. - - If 'virtualedit' is enabled and selection is past the end of - line, resulting lines are filled with blanks. - - If the selection starts or ends in the middle of a multibyte - character, it is not included but its selected part is - substituted with spaces. + - If 'virtualedit' is enabled and the region is past the end + of the lines, resulting lines are padded with spaces. + - If the region is blockwise and it starts or ends in the + middle of a multi-cell character, it is not included but + its selected part is substituted with spaces. - If {pos1} or {pos2} is not current in the buffer, an empty list is returned.