From 3cb2b3776700988e0c9d4ea37d0b05e371e2bbfd Mon Sep 17 00:00:00 2001 From: Christian Brabandt Date: Thu, 11 Apr 2024 21:21:51 +0200 Subject: runtime(doc): clarify behaviour or :argadd and :argedit related: #14464 Signed-off-by: Christian Brabandt --- runtime/doc/editing.txt | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt index d0f8938562..a5d3c29372 100644 --- 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: > -- cgit v1.2.3