runtime(doc): clarify the effect of 'startofline' option

fixes: #15794

Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt
index 99fd3e24b510a2930e7c26ba7440a7c24b467a14..2637480ae9bf71426cc3ebf01a78b83572776473 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 05
+*motion.txt*    For Vim version 9.1.  Last change: 2024 Oct 06
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -68,10 +68,12 @@ When doubling the operator it operates on a line.  When using a count, before
 or after the first character, that many lines are operated upon.  Thus `3dd`
 deletes three lines. A count before and after the first character is
 multiplied, thus `2y3y` yanks six lines.
-
+                                               *operator-resulting-pos*
 After applying the operator the cursor is mostly left at the start of the text
 that was operated upon.  For example, "yfe" doesn't move the cursor, but "yFe"
 moves the cursor leftwards to the "e" where the yank started.
+The 'startofline' option applies only to the "d", "<<", "==" and ">>" linewise
+operations.
 
                                                *linewise* *characterwise*
 The operator either affects whole lines, or the characters between the start

diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index d1a069110805fecdf7d57b3edb79db8086f50a7e..f0844e21b0255ee9dd3222c3785ca63a5551ff69 100644 (file)
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -7789,7 +7789,8 @@ A jump table for the options with a short description can be found at |Q_op|.
        non-blank of the line.  When off the cursor is kept in the same column
        (if possible).  This applies to the commands:
        - CTRL-D, CTRL-U, CTRL-B, CTRL-F, "G", "H", "M", "L", "gg"
-       - "d", "<<" and ">>" with a linewise operator
+       - "d", "<<", "==" and ">>" with a linewise operator
+         (|operator-resulting-pos|)
        - "%" with a count
        - buffer changing commands (CTRL-^, :bnext, :bNext, etc.)
        - Ex commands that only has a line number, e.g., ":25" or ":+".

diff --git a/runtime/doc/tags b/runtime/doc/tags
index 489388b864aac1b9807e2bcc404f5999dffed23b..42c7c649ec781cf6bd8ba3da29ac0b7a7a220c50 100644 (file)
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -9293,6 +9293,7 @@ opening-window    windows.txt     /*opening-window*
 operator       motion.txt      /*operator*
 operator-doubled       motion.txt      /*operator-doubled*
 operator-pending-index index.txt       /*operator-pending-index*
+operator-resulting-pos motion.txt      /*operator-resulting-pos*
 operator-variable      eval.txt        /*operator-variable*
 option-backslash       options.txt     /*option-backslash*
 option-list    quickref.txt    /*option-list*