[Emacs-diffs] Changes to emacs/lispref/syntax.texi

[Richard M. Stallman]

Index: emacs/lispref/syntax.texi
diff -u emacs/lispref/syntax.texi:1.21 emacs/lispref/syntax.texi:1.22
--- emacs/lispref/syntax.texi:1.21      Thu Oct 11 21:31:01 2001
+++ emacs/lispref/syntax.texi   Sun Nov 25 05:57:45 2001
@@ -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