[Emacs-diffs] master f7adb8a 1/2: Clarify the documentation of nested comments.

[Alan Mackenzie]

branch: master
commit f7adb8a4efa6b95d63433728c1dd0353cde6a2e4
Author: Alan Mackenzie <address@hidden>
Commit: Alan Mackenzie <address@hidden>

    Clarify the documentation of nested comments.
    
    * doc/lispref/syntax.texi (Syntax Flags): State that only comments of the 
same
    style are recognized inside nestable comments.
    (Low-Level Parsing): Clarify that parsing will stop after the start or end 
of
    UNNESTED comments.
---
 doc/lispref/syntax.texi |   15 ++++++++-------
 1 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi
index 19782d0..d5a7eba 100644
--- a/doc/lispref/syntax.texi
+++ b/doc/lispref/syntax.texi
@@ -331,10 +331,10 @@ alternative ``c'' comment style.  For a two-character 
comment
 delimiter, @samp{c} on either character makes it of style ``c''.
 
 @item
address@hidden on a comment delimiter character specifies
-that this kind of comment can be nested.  For a two-character
-comment delimiter, @samp{n} on either character makes it
-nestable.
address@hidden on a comment delimiter character specifies that this kind of
+comment can be nested.  Inside such a comment, only comments of the
+same style will be recognized.  For a two-character comment delimiter,
address@hidden on either character makes it nestable.
 
 @cindex comment style
 Emacs supports several comment styles simultaneously in any one syntax
@@ -899,9 +899,10 @@ The depth starts at 0, or at whatever is given in 
@var{state}.
 If the fourth argument @var{stop-before} is address@hidden, parsing
 stops when it comes to any character that starts a sexp.  If
 @var{stop-comment} is address@hidden, parsing stops when it comes to the
-start of a comment.  If @var{stop-comment} is the symbol
address@hidden, parsing stops after the start of a comment or a
-string, or the end of a comment or a string, whichever comes first.
+start of an unnested comment.  If @var{stop-comment} is the symbol
address@hidden, parsing stops after the start of an unnested
+comment or a string, or the end of an unnested comment or a string,
+whichever comes first.
 
 If @var{state} is @code{nil}, @var{start} is assumed to be at the top
 level of parenthesis structure, such as the beginning of a function