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 2637480ae9bf71426cc3ebf01a78b83572776473..8fe70241e92d223b518b1f22be1ff096419a37aa 100644 (file)
--- 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 4024d20c50d2fac21a012cdbdb7d0c571a934a50..7c32384e14fb25da1362ece10eeb495d1155eece 100644 (file)
--- 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 6b4cd63e48264a2ebb3508a1ad555ecfc0e93e7c..0f8b2051f4598d814a2ce0cad962304fbfe6ccef 100644 (file)
--- 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*