runtime(doc): add a note about inclusive motions and exclusive selection
related: #16202
Signed-off-by: Christian Brabandt <cb@256bit.org>
diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt
index 2637480..8fe7024 100644
--- a/runtime/doc/motion.txt
+++ b/runtime/doc/motion.txt
@@ -1,4 +1,4 @@
-*motion.txt* For Vim version 9.1. Last change: 2024 Oct 06
+*motion.txt* For Vim version 9.1. Last change: 2024 Dec 14
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -93,6 +93,13 @@
end of the motion is moved to the end of the previous line and the motion
becomes inclusive. Example: "}" moves to the first line after a paragraph,
but "d}" will not include that line.
+
+ *inclusive-motion-selection-exclusive*
+When 'selection' is "exclusive", |Visual| mode is active and an inclusive
+motion has been used, the cursor position will be adjusted by another
+character to the right, so that visual selction includes the expected text and
+can be acted upon.
+
*exclusive-linewise*
2. If the motion is exclusive, the end of the motion is in column 1 and the
start of the motion was at or before the first non-blank in the line, the
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 4024d20..7c32384 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt* For Vim version 9.1. Last change: 2024 Dec 07
+*options.txt* For Vim version 9.1. Last change: 2024 Dec 14
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -7018,6 +7018,8 @@
selection.
When "old" is used and 'virtualedit' allows the cursor to move past
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.
diff --git a/runtime/doc/tags b/runtime/doc/tags
index 6b4cd63..0f8b205 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -8404,6 +8404,7 @@
include-search tagsrch.txt /*include-search*
inclusion helphelp.txt /*inclusion*
inclusive motion.txt /*inclusive*
+inclusive-motion-selection-exclusive motion.txt /*inclusive-motion-selection-exclusive*
incomp-small-6 version6.txt /*incomp-small-6*
incompatible-5 version5.txt /*incompatible-5*
incompatible-6 version6.txt /*incompatible-6*