dabbrev-select-buffers-function's help unhelpful

[Dan Jacobson]

I'm in help and it says

-------
dabbrev-select-buffers-function's value is 
dabbrev--select-buffers

Documentation:
A function that selects buffers that should be searched by dabbrev.
The function should take no arguments and return a list of buffers to
search for expansions.  Have a look at `dabbrev--select-buffers' for
an example.
--------
I click on the cheery invitation to look at dabbrev--select-buffers
and
--------
dabbrev--select-buffers is a compiled Lisp function in `dabbrev'.
(dabbrev--select-buffers)
not documented
--------
Oh, I see, it is telling me to see the source code.  Ok, then it
should say "see the source code for the function
dabbrev--select-buffers" instead, or else the user clicking on the
inviting hyperlink provided will be disappointed.

By the way, I did look at the source code for that function, an it's
obviously 13 times over my head.  Info doesn't talk about this part.

I want dabbrev-expand to, e.g., include "*Buffer-List*" amongst its
source areas.  How to do that?

By the way, do (apropos "--" nil) and wonder why he has to use such
a special convention.

By the way, looking at
;;; dabbrev.el --- dynamic abbreviation package

;; Copyright (C) 1985, 86, 92, 94, 96, 1997 Free Software Foundation, Inc.

;; Author: Don Morrison
;; Maintainer: Lars Lindberg <Lars.Lindberg@sypro.cap.se>
;; Created: 16 Mars 1992
;; Lindberg's last update version: 5.7

one feels unsure about the date of last change.  I hear now emacs is in
CVS though.
-- 
http://www.geocities.com/jidanni Tel886-4-25854780 e-mail:restore .com.