aniani/vim
0
0
Fork 1
mirror of https://github.com/vim/vim.git synced 2025-09-23 03:43:49 -04:00
Code Activity

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

Browse Source 
- 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>
This commit is contained in:
Doug Kearns
2025-07-20 10:34:32 +02:00
committed by Christian Brabandt
parent 88b735973c
commit 31ec66403d
4 changed files with 17 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
runtime/doc/editing.txt
View File

@@ -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 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -656,7 +656,7 @@ list of the current window.
buffer. buffer.
Also see |++opt| and |+cmd|. 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. Add {name}s to the argument list and edit it.
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 |:argded|. 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. edited. No check for duplicates is done.
Also see |++opt| and |+cmd|. Also see |++opt| and |+cmd|.
:[count]arga[dd] {name} .. *:arga* *:argadd* *E479* :[count]arga[dd] {name} ... *:arga* *:argadd* *E479*
:[count]arga[dd] *E1156* :[count]arga[dd] *E1156*
Add the {name}s to the argument list. When {name} is Add the {name}s to the argument list. When {name} is
omitted add the current buffer name to the argument 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 If your current file is a duplicate, your current file
will change to the original file index. 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 Delete files from the argument list that match the
{pattern}s. {pattern} is used like a file pattern, {pattern}s. {pattern} is used like a file pattern,
see |file-pattern|. "%" can be used to delete the see |file-pattern|. "%" can be used to delete the

14
runtime/doc/eval.txt
View File

@@ -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 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -3722,7 +3722,7 @@ text...
improve script readability. improve script readability.
*:ec* *:echo* *: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. first {expr1} starts on a new line.
Also see |:comment|. Also see |:comment|.
Use "\n" to start a new line. Use "\r" to move the 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" :new | redraw | echo "there is a new window"
< <
*:echon* *:echon*
:echon {expr1} .. Echoes each {expr1}, without anything added. Also see :echon {expr1} ... Echoes each {expr1}, without anything added. Also see
|:comment|. |:comment|.
Uses the highlighting set by the `:echohl` command. Uses the highlighting set by the `:echohl` command.
Cannot be followed by a comment. Cannot be followed by a comment.
@@ -3773,7 +3773,7 @@ text...
otherwise all following echo's will be highlighted. otherwise all following echo's will be highlighted.
*:echom* *:echomsg* *: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|. message in the |message-history|.
Spaces are placed between the arguments as with the Spaces are placed between the arguments as with the
`:echo` command. But unprintable characters are `:echo` command. But unprintable characters are
@@ -3805,7 +3805,7 @@ text...
with the +timer and the +popupwin features. with the +timer and the +popupwin features.
*:echoe* *:echoerr* *: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 message in the |message-history|. When used in a
script or function the line number will be added. script or function the line number will be added.
Spaces are placed between the arguments as with the Spaces are placed between the arguments as with the
@@ -3818,7 +3818,7 @@ text...
And to get a beep: > And to get a beep: >
:exe "normal \<Esc>" :exe "normal \<Esc>"
:echoc[onsole] {expr1} .. *:echoc* *:echoconsole* :echoc[onsole] {expr1} ... *:echoc* *:echoconsole*
Intended for testing: works like `:echomsg` but when Intended for testing: works like `:echomsg` but when
running in the GUI and started from a terminal write running in the GUI and started from a terminal write
the text to stdout. the text to stdout.
@@ -3845,7 +3845,7 @@ text...
*:exe* *:execute* *: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. of {expr1} as an Ex command.
Multiple arguments are concatenated, with a space in Multiple arguments are concatenated, with a space in
between. To avoid the extra space use the ".." between. To avoid the extra space use the ".."

4
runtime/doc/syntax.txt
View File

@@ -4353,13 +4353,13 @@ SYNTAX ISKEYWORD SETTING *:syn-iskeyword*
DEFINING KEYWORDS *:syn-keyword* 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. This defines a number of keywords.
{group-name} Is a syntax group name such as "Comment". {group-name} Is a syntax group name such as "Comment".
[{options}] See |:syn-arguments| below. [{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: > Example: >
:syntax keyword Type int long char :syntax keyword Type int long char

4
runtime/syntax/help.vim
View File

@@ -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 "{[-a-zA-Z0-9'"*+/:%#=[\]<>.,]\+}"
syn match helpSpecial "\s\[[-a-z^A-Z0-9_]\{2,}]"ms=s+1 syn match helpSpecial "\s\[[-a-z^A-Z0-9_]\{2,}]"ms=s+1
syn match helpSpecial "<[-a-zA-Z0-9_]\+>" syn match helpSpecial "<[-a-zA-Z0-9_]\+>"
syn match helpSpecial "<buffer=\w\+>"
syn match helpSpecial "<[SCM]-.>" syn match helpSpecial "<[SCM]-.>"
syn match helpNormal "<---*>" syn match helpNormal "<---*>"
syn match helpSpecial "\[range]" syn match helpSpecial "\[range]"
@@ -126,6 +127,9 @@ syn match helpSpecial "\[+num]"
syn match helpSpecial "\[-num]" syn match helpSpecial "\[-num]"
syn match helpSpecial "\[+cmd]" syn match helpSpecial "\[+cmd]"
syn match helpSpecial "\[++opt]" syn match helpSpecial "\[++opt]"
syn match helpSpecial "\[++once]"
syn match helpSpecial "\[++nested]"
syn match helpSpecial "\[++t]"
syn match helpSpecial "\[arg]" syn match helpSpecial "\[arg]"
syn match helpSpecial "\[arguments]" syn match helpSpecial "\[arguments]"
syn match helpSpecial "\[ident]" syn match helpSpecial "\[ident]"