[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/syntax.texi
From: |
Richard M. Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/syntax.texi |
Date: |
Sun, 25 Nov 2001 05:57:45 -0500 |
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
- [Emacs-diffs] Changes to emacs/lispref/syntax.texi,
Richard M. Stallman <=