* newcomment.el (comment-search-forward, comment-search-backward): Doc fix.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 30a59aa8912bc125e9642f27cec6b1e0d8c40c42..023e11a9415187b93ac97c7782b7a81c6616548e 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2013-06-18  Glenn Morris  <rgm@gnu.org>
+
+       * newcomment.el (comment-search-forward, comment-search-backward):
+       Doc fix.  (Bug#14376)
+
 2013-06-18  Juanma Barranquero  <lekktu@gmail.com>
 
        * face-remap.el (buffer-face-toggle): Fix typo in docstring.

diff --git a/lisp/newcomment.el b/lisp/newcomment.el
index bcb5f721ae81706da0d7f13980b7da47f9b14e57..19a06bfe8e5a5ab1bbc3a11bb78072cf03eb9c97 100644 (file)
--- a/lisp/newcomment.el
+++ b/lisp/newcomment.el
@@ -446,7 +446,9 @@ in strings will not confuse Emacs.")
   "Find a comment start between point and LIMIT.
 Moves point to inside the comment and returns the position of the
 comment-starter.  If no comment is found, moves point to LIMIT
-and raises an error or returns nil if NOERROR is non-nil."
+and raises an error or returns nil if NOERROR is non-nil.
+
+Ensure that `comment-normalize-vars' has been called before you use this."
   (if (not comment-use-syntax)
       (if (re-search-forward comment-start-skip limit noerror)
          (or (match-end 1) (match-beginning 0))
@@ -484,7 +486,9 @@ and raises an error or returns nil if NOERROR is non-nil."
   "Find a comment start between LIMIT and point.
 Moves point to inside the comment and returns the position of the
 comment-starter.  If no comment is found, moves point to LIMIT
-and raises an error or returns nil if NOERROR is non-nil."
+and raises an error or returns nil if NOERROR is non-nil.
+
+Ensure that `comment-normalize-vars' has been called before you use this."
   ;; FIXME: If a comment-start appears inside a comment, we may erroneously
   ;; stop there.  This can be rather bad in general, but since
   ;; comment-search-backward is only used to find the comment-column (in