runtime(doc): Update help syntax, match :autocmd options
Commit:
https://github.com/vim/vim/commit/31ec66403d1976a67a95b3774c7c1b9062381e8d
Author: Doug Kearns <dougkea...@gmail.com>
Date: Sun Jul 20 10:34:32 2025 +0200
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 <dougkea...@gmail.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>
diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt
index 270cc9e24..af9f39e23 100644
--- 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 73cb70b96..522c03379 100644
--- 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 "
" to start a new line. Use "
" 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 fd5c421fe..b90c01b1d 100644
--- 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 bd238376f..c53c0cb90 100644
--- a/runtime/syntax/help.vim
+++ b/runtime/syntax/help.vim
@@ -113,6 +113,7 @@ syn match helpSpecial "^
[>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]"
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to vim_dev+unsubscr...@googlegroups.com.
To view this discussion visit
https://groups.google.com/d/msgid/vim_dev/E1udPfN-00GqMQ-43%40256bit.org.
