procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of comment styles

Browse source 
* doc/lispref/syntax.texi (Syntax Flags): Define the "a" style.
(Bug#31624)
This commit is contained in:
Eli Zaretskii 2018-06-02 14:01:18 +03:00
parent fb45125c80
commit 6107e12f76
1 changed files with 7 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
doc/lispref/syntax.texi
View file

@ -339,11 +339,13 @@ same style will be recognized. For a two-character comment delimiter,
@cindex comment style
Emacs supports several comment styles simultaneously in any one syntax
table. A comment style is a set of flags @samp{b}, @samp{c}, and
@samp{n}, so there can be up to 8 different comment styles.
Each comment delimiter has a style and only matches comment delimiters
of the same style. Thus if a comment starts with the comment-start
sequence of style ``bn'', it will extend until the next matching
comment-end sequence of style ``bn''.
@samp{n}, so there can be up to 8 different comment styles, each one
named by the set of its flags. Each comment delimiter has a style and
only matches comment delimiters of the same style. Thus if a comment
starts with the comment-start sequence of style ``bn'', it will extend
until the next matching comment-end sequence of style ``bn''. When
the set of flags has neither flag @samp{b} nor flag @samp{c} set, the
resulting style is called the ``a'' style.
The appropriate comment syntax settings for C++ can be as follows: