Mention read-regexp in doc of functions that use it

* lisp/dired.el (dired-read-regexp):
* lisp/faces.el (list-faces-display):
* lisp/misearch.el (multi-isearch-read-matching-buffers)
(multi-isearch-read-matching-files):
* lisp/play/cookie1.el (cookie-apropos):
* lisp/progmodes/grep.el (grep-read-regexp): Doc fixes.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index c6498210524769f49a4b3f949f409ed45e66daee..21eeff7bffe05b6a84d804c7d4d1545659a2c4ca 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,12 @@
 2014-02-14  Glenn Morris  <rgm@gnu.org>
 
+       * dired.el (dired-read-regexp):
+       * faces.el (list-faces-display):
+       * misearch.el (multi-isearch-read-matching-buffers)
+       (multi-isearch-read-matching-files):
+       * play/cookie1.el (cookie-apropos):
+       * progmodes/grep.el (grep-read-regexp): Doc fixes.
+
        * textmodes/remember.el (remember): Use frameset-to-register
        rather than frame-configuration-to-register.
 

diff --git a/lisp/dired.el b/lisp/dired.el
index faa39ab5d6c02a69ab02c4394d6ae8dbebf2fe74..b1b22a6a99aa54aa556c1c0f97e38b072e42bf0b 100644 (file)
--- a/lisp/dired.el
+++ b/lisp/dired.el
@@ -3284,6 +3284,7 @@ As always, hidden subdirs are not affected."
   "History list of regular expressions used in Dired commands.")
 
 (defun dired-read-regexp (prompt &optional default history)
+  "Read a regexp using `read-regexp'."
   (read-regexp prompt default (or history 'dired-regexp-history)))
 
 (defun dired-mark-files-regexp (regexp &optional marker-char)

diff --git a/lisp/faces.el b/lisp/faces.el
index ed36522afb1bdb9e8822dbe65193b25259eb6de5..3394c721f04bfd2281fe7a70822cc3e9e3c24aa0 100644 (file)
--- a/lisp/faces.el
+++ b/lisp/faces.el
@@ -1260,7 +1260,7 @@ The sample text is a string that comes from the variable
 
 If REGEXP is non-nil, list only those faces with names matching
 this regular expression.  When called interactively with a prefix
-arg, prompt for a regular expression."
+argument, prompt for a regular expression using `read-regexp'."
   (interactive (list (and current-prefix-arg
                           (read-regexp "List faces matching regexp"))))
   (let ((all-faces (zerop (length regexp)))

diff --git a/lisp/misearch.el b/lisp/misearch.el
index af3b1b45b2b341d212651764acddfe5a0c9ad8f9..64ea40b7a1dfc5ee49d2accdd080af4709d0b976 100644 (file)
--- a/lisp/misearch.el
+++ b/lisp/misearch.el
@@ -239,7 +239,8 @@ set in `multi-isearch-buffers' or `multi-isearch-buffers-regexp'."
     (nreverse bufs)))
 
 (defun multi-isearch-read-matching-buffers ()
-  "Return a list of buffers whose names match specified regexp."
+  "Return a list of buffers whose names match specified regexp.
+Uses `read-regexp' to read the regexp."
   ;; Most code from `multi-occur-in-matching-buffers'
   ;; and `kill-matching-buffers'.
   (let ((bufregexp
@@ -322,8 +323,10 @@ Every next/previous file in the defined sequence is visited by
       (add-to-list 'files file))
     (nreverse files)))
 
+;; A regexp is not the same thing as a file glob - does this matter?
 (defun multi-isearch-read-matching-files ()
-  "Return a list of files whose names match specified wildcard."
+  "Return a list of files whose names match specified wildcard.
+Uses `read-regexp' to read the wildcard."
   ;; Most wildcard code from `find-file-noselect'.
   (let ((filename (read-regexp "Search in files whose names match wildcard")))
     (when (and filename

diff --git a/lisp/play/cookie1.el b/lisp/play/cookie1.el
index 38619b1d26a74d1e5bea8feed9e52a2f427093cb..4d49fca7568f90e720bfc0f1c38367add4c0c08b 100644 (file)
--- a/lisp/play/cookie1.el
+++ b/lisp/play/cookie1.el
@@ -187,6 +187,7 @@ Argument REQUIRE-MATCH non-nil forces a matching cookie."
 
 (defun cookie-apropos (regexp phrase-file &optional display)
   "Return a list of all entries matching REGEXP from PHRASE-FILE.
+Interactively, uses `read-regexp' to read REGEXP.
 Interactively, PHRASE-FILE defaults to `cookie-file', unless that
 is nil or a prefix argument is used.
 If called interactively, or if DISPLAY is non-nil, display a list of matches."

diff --git a/lisp/progmodes/grep.el b/lisp/progmodes/grep.el
index 3c7f936446fe39be84ff6dccf3f522b89c32c059..99629450c1b88d7b02fc9d67569bdbaa4f55a24b 100644 (file)
--- a/lisp/progmodes/grep.el
+++ b/lisp/progmodes/grep.el
@@ -819,7 +819,7 @@ substitution string.  Note dynamic scoping of variables.")
                 t t command))))))
 
 (defun grep-read-regexp ()
-  "Read regexp arg for interactive grep."
+  "Read regexp arg for interactive grep using `read-regexp'."
   (read-regexp "Search for" 'grep-tag-default 'grep-regexp-history))
 
 (defun grep-read-files (regexp)