From bfeefc474a3ed25852491a93e1e5610774f4de8c Mon Sep 17 00:00:00 2001 From: Christian Brabandt Date: Mon, 2 Jun 2025 19:56:57 +0200 Subject: [PATCH] runtime(doc): clarify the effect of exclusive single char selections closes: #17410 Co-authored-by: zeertzjq Signed-off-by: Christian Brabandt --- runtime/doc/builtin.txt | 6 +++++- runtime/doc/options.txt | 13 +++++++++---- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index 8cce98a3fd..3105a3d7d2 100644 --- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -1,4 +1,4 @@ -*builtin.txt* For Vim version 9.1. Last change: 2025 Jun 01 +*builtin.txt* For Vim version 9.1. Last change: 2025 Jun 02 VIM REFERENCE MANUAL by Bram Moolenaar @@ -5042,6 +5042,10 @@ getregion({pos1}, {pos2} [, {opts}]) *getregion()* - It is evaluated in current window context, which makes a difference if the buffer is displayed in a window with different 'virtualedit' or 'list' values. + - When specifying an exclusive selection and {pos1} and {pos2} + are equal, the returned list contains a single character as + if selection is inclusive, to match the behavior of an empty + exclusive selection in Visual mode. Examples: > :xnoremap diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index cc0a5e6527..5c6fbfbef1 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 9.1. Last change: 2025 Jun 01 +*options.txt* For Vim version 9.1. Last change: 2025 Jun 02 VIM REFERENCE MANUAL by Bram Moolenaar @@ -7199,9 +7199,14 @@ A jump table for the options with a short description can be found at |Q_op|. the end of line the line break still isn't included. When "exclusive" is used, cursor position in visual mode will be adjusted for inclusive motions |inclusive-motion-selection-exclusive|. - Note that when "exclusive" is used and selecting from the end - backwards, you cannot include the last character of a line, when - starting in Normal mode and 'virtualedit' empty. + + Note: + - When "exclusive" is used and selecting from the end backwards, you + cannot include the last character of a line, when starting in Normal + mode and 'virtualedit' empty. + - when "exclusive" is used with a single character visual selection, + Vim will behave as if the 'selection' is inclusive (in other words, + you cannot visually select an empty region). The 'selection' option is set by the |:behave| command.