[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] master f7adb8a 1/2: Clarify the documentation of nested co
From: |
Alan Mackenzie |
Subject: |
[Emacs-diffs] master f7adb8a 1/2: Clarify the documentation of nested comments. |
Date: |
Thu, 10 Mar 2016 11:44:55 +0000 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] master f7adb8a 1/2: Clarify the documentation of nested comments.,
Alan Mackenzie <=