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

2 files changed, 9 insertions, 0 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 4cf74c06f78..2a5394adc7a 100644
--- 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 a5a37c3d20f..62c3befa908 100644
--- 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)))