1- *syntax.txt* For Vim version 9.1. Last change: 2025 Oct 07
1+ *syntax.txt* For Vim version 9.1. Last change: 2025 Oct 08
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -4284,9 +4284,9 @@ Vim understands three types of syntax items:
42844284
42854285Several syntax ITEMs can be put into one syntax GROUP. For a syntax group
42864286you can give highlighting attributes. For example, you could have an item
4287- to define a "/* .. */" comment and another one that defines a "// .." comment,
4288- and put them both in the "Comment" group. You can then specify that a
4289- "Comment" will be in bold font and have a blue color. You are free to make
4287+ to define a "/* ... */" comment and another one that defines a "// ..."
4288+ comment, and put them both in the "Comment" group. You can then specify that
4289+ a "Comment" will be in bold font and have a blue color. You are free to make
42904290one highlight group for one syntax item, or put all items into one group.
42914291This depends on how you want to specify your highlighting attributes. Putting
42924292each item in its own group results in having to specify the highlighting
@@ -4486,9 +4486,9 @@ DEFINING REGIONS *:syn-region* *:syn-start* *:syn-skip* *:syn-end*
44864486 [keepend]
44874487 [extend]
44884488 [excludenl]
4489- start={start-pattern} ..
4489+ start={start-pattern} ...
44904490 [skip={skip-pattern} ]
4491- end={end-pattern} ..
4491+ end={end-pattern} ...
44924492 [{options} ]
44934493
44944494 This defines one region. It may span several lines.
@@ -4822,7 +4822,7 @@ from its syntax items.
48224822
48234823
48244824 *:syn-contains* *E405* *E406* *E407* *E408* *E409*
4825- contains={group-name} ,..
4825+ contains={group-name} ,...
48264826
48274827The "contains" argument is followed by a list of syntax group names. These
48284828groups will be allowed to begin inside the item (they may extend past the
@@ -4835,7 +4835,7 @@ contains=ALL
48354835 If the only item in the contains list is "ALL", then all
48364836 groups will be accepted inside the item.
48374837
4838- contains=ALLBUT,{group-name} ,..
4838+ contains=ALLBUT,{group-name} ,...
48394839 If the first item in the contains list is "ALLBUT", then all
48404840 groups will be accepted inside the item, except the ones that
48414841 are listed. Example: >
@@ -4845,14 +4845,14 @@ contains=TOP
48454845 If the first item in the contains list is "TOP", then all
48464846 groups will be accepted that don't have the "contained"
48474847 argument.
4848- contains=TOP,{group-name} ,..
4848+ contains=TOP,{group-name} ,...
48494849 Like "TOP", but excluding the groups that are listed.
48504850
48514851contains=CONTAINED
48524852 If the first item in the contains list is "CONTAINED", then
48534853 all groups will be accepted that have the "contained"
48544854 argument.
4855- contains=CONTAINED,{group-name} ,..
4855+ contains=CONTAINED,{group-name} ,...
48564856 Like "CONTAINED", but excluding the groups that are
48574857 listed.
48584858
@@ -4875,7 +4875,7 @@ region where contained items do match. Note that this may also limit the
48754875area that is highlighted
48764876
48774877
4878- containedin={group-name} ... *:syn-containedin*
4878+ containedin={group-name} , ... *:syn-containedin*
48794879
48804880The "containedin" argument is followed by a list of syntax group names. The
48814881item will be allowed to begin inside these groups. This works as if the
@@ -4888,7 +4888,7 @@ neither contains this item via |:syn-contains| nor is named in this item's
48884888Note that a | :syn-transparent | region still enforces its own | :syn-contains |
48894889list.
48904890
4891- The {group-name} ... can be used just like for "contains", as explained above.
4891+ The {group-name} , ... can be used just like for "contains", as explained above.
48924892
48934893This is useful when adding a syntax item afterwards. An item can be told to
48944894be included inside an already existing item, without changing the definition
@@ -4905,7 +4905,7 @@ work.
49054905See also: | :syn-contains | , | :syn-transparent | .
49064906
49074907
4908- nextgroup={group-name} ,.. *:syn-nextgroup*
4908+ nextgroup={group-name} ,... *:syn-nextgroup*
49094909
49104910The "nextgroup" argument is followed by a list of syntax group names,
49114911separated by commas (just like with "contains", so you can also use patterns).
@@ -5161,22 +5161,22 @@ cannot be referred to.
51615161==============================================================================
516251629. Syntax clusters *:syn-cluster* *E400*
51635163
5164- :sy[ntax] cluster {cluster-name} [contains={group-name} ..]
5165- [add={group-name} ..]
5166- [remove={group-name} ..]
5164+ :sy[ntax] cluster {cluster-name} [contains={group-name} ,. ..]
5165+ [add={group-name} ,. ..]
5166+ [remove={group-name} ,. ..]
51675167
51685168This command allows you to cluster a list of syntax groups together under a
51695169single name.
51705170
5171- contains={group-name} ..
5171+ contains={group-name} ,. ..
51725172 The cluster is set to the specified list of groups.
5173- add={group-name} ..
5173+ add={group-name} ,. ..
51745174 The specified groups are added to the cluster.
5175- remove={group-name} ..
5175+ remove={group-name} ,. ..
51765176 The specified groups are removed from the cluster.
51775177
5178- A cluster so defined may be referred to in a contains=.., containedin=..,
5179- nextgroup=.., add=.. or remove=.. list with a "@" prefix. You can also use
5178+ A cluster so defined may be referred to in a contains=... , containedin=. ..,
5179+ nextgroup=... , add=... or remove=. .. list with a "@" prefix. You can also use
51805180this notation to implicitly declare a cluster before specifying its contents.
51815181
51825182Example: >
@@ -5391,7 +5391,7 @@ highlighting. The reduced number of patterns means it will go (much)
53915391faster.]
53925392
53935393 *syn-sync-grouphere* *E393* *E394*
5394- :syntax sync match {sync-group-name} grouphere {group-name} "pattern" ..
5394+ :syntax sync match {sync-group-name} grouphere {group-name} "pattern" ...
53955395
53965396 Define a match that is used for syncing. {group-name} is the
53975397 name of a syntax group that follows just after the match. Parsing
@@ -5400,7 +5400,7 @@ faster.]
54005400 "NONE" can be used for when there is no syntax group after the match.
54015401
54025402 *syn-sync-groupthere*
5403- :syntax sync match {sync-group-name} groupthere {group-name} "pattern" ..
5403+ :syntax sync match {sync-group-name} groupthere {group-name} "pattern" ...
54045404
54055405 Like "grouphere", but {group-name} is the name of a syntax group that
54065406 is to be used at the start of the line where searching for the sync
@@ -5413,8 +5413,8 @@ faster.]
54135413 it's a bit more complicated, because the "/*" and "*/" could appear
54145414 inside a string. That's left as an exercise to the reader...).
54155415
5416- :syntax sync match ..
5417- :syntax sync region ..
5416+ :syntax sync match ...
5417+ :syntax sync region ...
54185418
54195419 Without a "groupthere" argument. Define a region or match that is
54205420 skipped while searching for a sync point.
@@ -5435,7 +5435,7 @@ You can clear all sync settings with: >
54355435 :syntax sync clear
54365436
54375437 You can clear specific sync patterns with: >
5438- :syntax sync clear {sync-group-name} ..
5438+ :syntax sync clear {sync-group-name} ...
54395439
54405440==============================================================================
5441544112. Listing syntax items *:syntax* *:sy* *:syn* *:syn-list*
@@ -5570,7 +5570,7 @@ in their own color.
55705570 Disable the highlighting for one highlight group. It
55715571 is _not_ set back to the default colors.
55725572
5573- :hi[ghlight] [default] {group-name} {key} ={arg} ..
5573+ :hi[ghlight] [default] {group-name} {key} ={arg} ...
55745574 Add a highlight group, or change the highlighting for
55755575 an existing group. If a given color name is not
55765576 recognized, each `colors/lists/ default.vim ` found on
@@ -6209,11 +6209,11 @@ The command also deletes the "b:current_syntax" variable, since no syntax is
62096209loaded after this command.
62106210
62116211To clean up specific syntax groups for the current buffer: >
6212- :syntax clear {group-name} ..
6212+ :syntax clear {group-name} ...
62136213 This removes all patterns and keywords for {group-name} .
62146214
62156215To clean up specific syntax group lists for the current buffer: >
6216- :syntax clear @{grouplist-name} ..
6216+ :syntax clear @{grouplist-name} ...
62176217 This sets {grouplist-name} 's contents to an empty list.
62186218
62196219 *:syntax-off* *:syn-off*
0 commit comments