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

related: #14464

Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Christian Brabandt
2024-04-11 21:21:51 +02:00
parent 7fdbd1bb58
commit 3cb2b37767

View File

@ -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 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. Add {name}s to the argument list and edit it.
When {name} already exists in the argument list, this When {name} already exists in the argument list, this
entry is edited. 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 "\". Spaces in filenames have to be escaped with "\".
[count] is used like with |:argadd|. [count] is used like with |:argadd|.
If the current file cannot be |abandon|ed {name}s will 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 If the argument list is "a b c", and "b" is the
current argument, then these commands result in: current argument, then these commands result in:
command new argument list ~ command new argument list ~
:argadd x a b x c :argadd x a [b] x c
:0argadd x x a b c :0argadd x x a [b] c
:1argadd x a x b c :1argadd x a x [b] c
:$argadd x a b c x :$argadd x a [b] c x
And after the last one: 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 There is no check for duplicates, it is possible to
add a file to the argument list twice. You can use add a file to the argument list twice. You can use
|:argdedupe| to fix it afterwards: > |:argdedupe| to fix it afterwards: >