From 6107e12f76d3f7ea3136b04d8856b3f9ebc97e1d Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 2 Jun 2018 14:01:18 +0300 Subject: [PATCH] Improve documentation of comment styles * doc/lispref/syntax.texi (Syntax Flags): Define the "a" style. (Bug#31624) --- doc/lispref/syntax.texi | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi index 44a7730c7ab..71c97fdae8c 100644 --- a/doc/lispref/syntax.texi +++ b/doc/lispref/syntax.texi @@ -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: -- 2.11.4.GIT