bug#21635: 24.5; dabbrev: customizable variable dabbrev-friend-buffer-function not documented in Emacs manual

bug#21635: 24.5; dabbrev: customizable variable dabbrev-friend-buffer-function not documented in Emacs manual

[phs]

$ emacs -Q -l dabbrev --eval="(describe-variable 
'dabbrev-friend-buffer-function)"

Unless I am mistaken, there is no mention of 
dabbrev-friend-buffer-function in the
Emacs manual. This symbol, if bound, should contain a function that 
given a buffer
argument will tell if the buffer should be searched while 
dabbrev-expand'ing.

Further dabbrev-friend-buffer-function is initially bound to 
dabbrev--same-major-mode-p, with the effect that
only buffers with same major mode are searched through. This behaviour, 
while often welcome, can be treacherous at times,
and is not documented in the manual.

This may have a connection with bug #17899

In GNU Emacs 24.5.1 (x86_64-apple-darwin13.4.0, NS apple-appkit-1265.21)
  of 2015-04-10 on builder10-9.porkrind.org
Windowing system distributor `Apple', version 10.3.1404
Configured using:
  `configure --with-ns '--enable-locallisppath=/Library/Application
  Support/Emacs/${version}/site-lisp:/Library/Application 
Support/Emacs/site-lisp''

Important settings:
   value of $LC_ALL: en_US
   value of $LANG: en_US
   locale-coding-system: utf-8-unix

-- 
Philippe SCHNOEBELEN,       	                  www.lsv.ens-cachan.fr/~phs
LSV, CNRS UMR 8643 & ENS de Cachan   		  Tel: (+33/0) 147 407 530
"Algebraic symbols are used when you do not know what you are talking about"

bug#21635: 24.5; dabbrev: customizable variable dabbrev-friend-buffer-function not documented in Emacs manual

[Glenn Morris]

As a general comment, the manual does not try to exhaustively list all options.
I am not a dabbrev user, so have no idea how important this one is.

bug#21635: 24.5; dabbrev: customizable variable dabbrev-friend-buffer-function not documented in Emacs manual

[Stefan Kangas]

phs <phs@lsv.ens-cachan.fr> writes:

> Unless I am mistaken, there is no mention of
> dabbrev-friend-buffer-function in the Emacs manual.

Glenn Morris <rgm@gnu.org> writes:

> As a general comment, the manual does not try to exhaustively list all options.
> I am not a dabbrev user, so have no idea how important this one is.

Unfortunately I don't use dabbrev either.  But I can see that no one has
replied here in five years, which is perhaps some kind of indication.

Does anyone else have an opinion here?

Best regards,
Stefan Kangas

bug#21635: 24.5; dabbrev: customizable variable dabbrev-friend-buffer-function not documented in Emacs manual

[Stefan Kangas]

tags 21635 notabug wontfix
close 21635
thanks

Stefan Kangas <stefan@marxist.se> writes:

> phs <phs@lsv.ens-cachan.fr> writes:
>
>> Unless I am mistaken, there is no mention of
>> dabbrev-friend-buffer-function in the Emacs manual.
>
> Glenn Morris <rgm@gnu.org> writes:
>
>> As a general comment, the manual does not try to exhaustively list all options.
>> I am not a dabbrev user, so have no idea how important this one is.
>
> Unfortunately I don't use dabbrev either.  But I can see that no one has
> replied here in five years, which is perhaps some kind of indication.
>
> Does anyone else have an opinion here?

No one voiced an opinion within 7 weeks, so I'm closing this bug now.