runtime(doc): Update help syntax, match :autocmd options

- Match :autocmd options and special buffer pattern.
- Normalise ellipsis (three dots) in Ex command argument lists.

closes: #17793

Signed-off-by: Doug Kearns <dougkearns@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt
index 270cc9e246b631ebd21a7263bee00495678f05fb..af9f39e233d3911af7cd8c96e3ffd8d7a64fed13 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: 2025 Jun 25
+*editing.txt*   For Vim version 9.1.  Last change: 2025 Jul 20
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -656,7 +656,7 @@ list of the current window.
                        buffer.
                        Also see |++opt| and |+cmd|.
 
-:[count]arge[dit][!] [++opt] [+cmd] {name} ..          *:arge* *:argedit*
+:[count]arge[dit][!] [++opt] [+cmd] {name} ...         *:arge* *:argedit*
                        Add {name}s to the argument list and edit it.
                        There is no check for duplicates, it is possible to
                        add a file to the argument list twice |:argded|.
@@ -671,7 +671,7 @@ list of the current window.
                        edited. No check for duplicates is done.
                        Also see |++opt| and |+cmd|.
 
-:[count]arga[dd] {name} ..                     *:arga* *:argadd* *E479*
+:[count]arga[dd] {name} ...                    *:arga* *:argadd* *E479*
 :[count]arga[dd]                                               *E1156*
                        Add the {name}s to the argument list.  When {name} is
                        omitted add the current buffer name to the argument
@@ -702,7 +702,7 @@ list of the current window.
                        If your current file is a duplicate, your current file
                        will change to the original file index.
 
-:argd[elete] {pattern} ..              *:argd* *:argdelete* *E480* *E610*
+:argd[elete] {pattern} ...             *:argd* *:argdelete* *E480* *E610*
                        Delete files from the argument list that match the
                        {pattern}s.  {pattern} is used like a file pattern,
                        see |file-pattern|.  "%" can be used to delete the

diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 73cb70b966108fb9c8f5bb9b45e13538b12d78a8..522c03379e2f2e00001017763b572ea2dc3a8078 100644 (file)
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt*     For Vim version 9.1.  Last change: 2025 Jul 13
+*eval.txt*     For Vim version 9.1.  Last change: 2025 Jul 20
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -3722,7 +3722,7 @@ text...
                        improve script readability.
 
                                                        *:ec* *:echo*
-:ec[ho] {expr1} ..     Echoes each {expr1}, with a space in between.  The
+:ec[ho] {expr1} ...    Echoes each {expr1}, with a space in between.  The
                        first {expr1} starts on a new line.
                        Also see |:comment|.
                        Use "\n" to start a new line.  Use "\r" to move the
@@ -3742,7 +3742,7 @@ text...
                :new | redraw | echo "there is a new window"
 <
                                                        *:echon*
-:echon {expr1} ..      Echoes each {expr1}, without anything added.  Also see
+:echon {expr1} ...     Echoes each {expr1}, without anything added.  Also see
                        |:comment|.
                        Uses the highlighting set by the `:echohl` command.
                        Cannot be followed by a comment.
@@ -3773,7 +3773,7 @@ text...
                        otherwise all following echo's will be highlighted.
 
                                                        *:echom* *:echomsg*
-:echom[sg] {expr1} ..  Echo the expression(s) as a true message, saving the
+:echom[sg] {expr1} ... Echo the expression(s) as a true message, saving the
                        message in the |message-history|.
                        Spaces are placed between the arguments as with the
                        `:echo` command.  But unprintable characters are
@@ -3805,7 +3805,7 @@ text...
                        with the +timer and the +popupwin features.
 
                                                        *:echoe* *:echoerr*
-:echoe[rr] {expr1} ..  Echo the expression(s) as an error message, saving the
+:echoe[rr] {expr1} ... Echo the expression(s) as an error message, saving the
                        message in the |message-history|.  When used in a
                        script or function the line number will be added.
                        Spaces are placed between the arguments as with the
@@ -3818,7 +3818,7 @@ text...
                        And to get a beep: >
                :exe "normal \<Esc>"
 
-:echoc[onsole] {expr1} ..                              *:echoc* *:echoconsole*
+:echoc[onsole] {expr1} ...                             *:echoc* *:echoconsole*
                        Intended for testing: works like `:echomsg` but when
                        running in the GUI and started from a terminal write
                        the text to stdout.
@@ -3845,7 +3845,7 @@ text...
 
 
                                                        *:exe* *:execute*
-:exe[cute] {expr1} ..  Executes the string that results from the evaluation
+:exe[cute] {expr1} ... Executes the string that results from the evaluation
                        of {expr1} as an Ex command.
                        Multiple arguments are concatenated, with a space in
                        between.  To avoid the extra space use the ".."

diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt
index fd5c421fe07119cc125b78f4b1176b1a592e5a92..b90c01b1da5a2e5469a9f9a8e0752079da1cd37a 100644 (file)
--- a/runtime/doc/syntax.txt
+++ b/runtime/doc/syntax.txt
@@ -4353,13 +4353,13 @@ SYNTAX ISKEYWORD SETTING                                *:syn-iskeyword*
 
 DEFINING KEYWORDS                                      *:syn-keyword*
 
-:sy[ntax] keyword {group-name} [{options}] {keyword} .. [{options}]
+:sy[ntax] keyword {group-name} [{options}] {keyword} ... [{options}]
 
        This defines a number of keywords.
 
        {group-name}    Is a syntax group name such as "Comment".
        [{options}]     See |:syn-arguments| below.
-       {keyword} ..    Is a list of keywords which are part of this group.
+       {keyword} ...   Is a list of keywords which are part of this group.
 
        Example: >
   :syntax keyword   Type   int long char

diff --git a/runtime/syntax/help.vim b/runtime/syntax/help.vim
index bd238376fc740f6a1f6b66f13331897eb1509441..c53c0cb906be9b5e118d0e7070f765428831292d 100644 (file)
--- a/runtime/syntax/help.vim
+++ b/runtime/syntax/help.vim
@@ -113,6 +113,7 @@ syn match helpSpecial               "^\t[>enf{}^L:=lbghNEpti+cC/(uUwWkmMjJ)*#P]N\s"ms=s+2,me=
 syn match helpSpecial          "{[-a-zA-Z0-9'"*+/:%#=[\]<>.,]\+}"
 syn match helpSpecial          "\s\[[-a-z^A-Z0-9_]\{2,}]"ms=s+1
 syn match helpSpecial          "<[-a-zA-Z0-9_]\+>"
+syn match helpSpecial          "<buffer=\w\+>"
 syn match helpSpecial          "<[SCM]-.>"
 syn match helpNormal           "<---*>"
 syn match helpSpecial          "\[range]"
@@ -126,6 +127,9 @@ syn match helpSpecial               "\[+num]"
 syn match helpSpecial          "\[-num]"
 syn match helpSpecial          "\[+cmd]"
 syn match helpSpecial          "\[++opt]"
+syn match helpSpecial          "\[++once]"
+syn match helpSpecial          "\[++nested]"
+syn match helpSpecial          "\[++t]"
 syn match helpSpecial          "\[arg]"
 syn match helpSpecial          "\[arguments]"
 syn match helpSpecial          "\[ident]"