runtime(doc): clarify behaviour or :argadd and :argedit

related: #14464

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

diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt
index d0f8938562f1ba23de8802e5020da1708dce1d38..a5d3c293721d25018d60582477742de93246ef82 100644 (file)
--- a/runtime/doc/editing.txt
+++ b/runtime/doc/editing.txt
@@ -1,4 +1,4 @@
-*editing.txt*   For Vim version 9.1.  Last change: 2024 Jan 14
+*editing.txt*   For Vim version 9.1.  Last change: 2024 Apr 11
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -660,7 +660,10 @@ list of the current window.
                        Add {name}s to the argument list and edit it.
                        When {name} already exists in the argument list, this
                        entry is edited.
-                       This is like using |:argadd| and then |:edit|.
+                       This is like using |:argadd| and then |:edit| (with
+                       the small exception that |:edit| does not change the
+                       argument list, so the argument list pointer isn't
+                       changed).
                        Spaces in filenames have to be escaped with "\".
                        [count] is used like with |:argadd|.
                        If the current file cannot be |abandon|ed {name}s will
@@ -679,12 +682,12 @@ list of the current window.
                        If the argument list is "a b c", and "b" is the
                        current argument, then these commands result in:
                                command         new argument list ~
-                               :argadd x       a b x c
-                               :0argadd x      x a b c
-                               :1argadd x      a x b c
-                               :$argadd x      a b c x
+                               :argadd x       a  [b]  x  c
+                               :0argadd x      x   a  [b] c
+                               :1argadd x      a   x  [b] c
+                               :$argadd x      a  [b]  c  x
                        And after the last one:
-                               :+2argadd y     a b c x y
+                               :+2argadd y     a  [b]  c  x  y
                        There is no check for duplicates, it is possible to
                        add a file to the argument list twice.  You can use
                        |:argdedupe| to fix it afterwards: >