(dabbrev--select-buffers): Add a doc string.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 4cf74c06f781bc1a1da69fdb785a8d23f1f0e654..2a5394adc7a12c325db0e80638b7ce8eb04d2382 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2001-04-26  Eli Zaretskii  <eliz@is.elta.co.il>
+
+       * dabbrev.el (dabbrev--select-buffers): Add a doc string.
+
 2001-04-25  Gerd Moellmann  <gerd@gnu.org>
 
        * faces.el (tty-handle-reverse-video): Don't set inverse-video.

diff --git a/lisp/dabbrev.el b/lisp/dabbrev.el
index a5a37c3d20f1c972ed3c91dfd4f29963e800e8ca..62c3befa90830faf83944e3fb496cafd23cae6c1 100644 (file)
--- a/lisp/dabbrev.el
+++ b/lisp/dabbrev.el
@@ -651,6 +651,11 @@ See also `dabbrev-abbrev-char-regexp' and \\[dabbrev-completion]."
 ;;; Find all buffers that are considered "friends" according to the
 ;;; function pointed out by dabbrev-friend-buffer-function.
 (defun dabbrev--select-buffers ()
+  "Return a list of all buffers that should be searched for a possible abbrev.
+
+This function makes a list of all the buffers returned by `buffer-list', and
+then filters out every buffer for which `dabbrev-friend-buffer-function',
+if it is bound, returns nil.  The resulting partial list is returned."
   (save-excursion
     (and (window-minibuffer-p (selected-window))
         (set-buffer (dabbrev--minibuffer-origin)))