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.