From: Christian Brabandt <cb@256bit.org>
Date: Sat, 14 Dec 2024 19:23:39 +0000 (+0100)
Subject: runtime(doc): add a note about inclusive motions and exclusive selection
X-Git-Tag: v9.1.0926~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ed89206efe404a94e8424ccfe03c978fd93470f1;p=thirdparty%2Fvim.git

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 2637480ae9..8fe70241e9 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 @@ command.  There are however, two general exceptions:
    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 4024d20c50..7c32384e14 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 @@ A jump table for the options with a short description can be found at |Q_op|.
 	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 6b4cd63e48..0f8b2051f4 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -8404,6 +8404,7 @@ inactive-buffer	windows.txt	/*inactive-buffer*
 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*