changeset 41478:026c44f15054

Clarify behavior of forward-comment.

--- a/lispref/syntax.texi	Sun Nov 25 10:09:09 2001 +0000
+++ b/lispref/syntax.texi	Sun Nov 25 10:57:45 2001 +0000
@@ -769,10 +769,18 @@
 one comment or several comments.
 
 @defun forward-comment count
-This function moves point forward across @var{count} comments (backward,
-if @var{count} is negative).  If it finds anything other than a comment
-or whitespace, it stops, leaving point at the place where it stopped.
-It also stops after satisfying @var{count}.
+This function moves point forward across @var{count} complete comments
+(that is, including the starting delimiter and the terminating
+delimiter if any).  It moves backward if @var{count} is negative.  If
+it encounters anything other than a comment or whitespace, it stops,
+leaving point at the place where it stopped.  This includes (for
+instance) finding the end of a comment when moving forward and
+expecting the beginning of one.  The function also stops immediately
+after moving over the specified number of complete comments.
+
+This function cannot tell whether the ``comments'' it traverses are
+embedded within a string.  If they look like comments, it treats them
+as comments.
 @end defun
 
 To move forward over all comments and whitespace following point, use