[BBDB] ChangeLog 2012-09-23

[Roland W. <wi...@gn...>]

On Sun Sep 16 2012 Stephen Leake wrote:
> It is not at all obvious that "update" has anything to do with
> "display". In addition, the help for bbdb-mua-auto-update-init
> says nothing about display.

The patch below hopefully clarifies these things. The docstring of
bbdb-mua-auto-update-init now points to bbdb-mua-auto-update which
is the function doing the real work, and the latter mentions
display, too.

Also, I updated the README file for this.

> I suggest that bbdb-initialize call bbdb-mua-auto-update-init with
> the same list of MUA's, but offer a way to then override that. Or
> have bbdb-initialize take two lists, if they are typically
> different.

I have intentionally separated these things, and the reason for this
has long been explained in the docstrings of bbdb-mua-auto-update-init
and bbdb-initialize.

> > Then it doesn't make sense that bbdb-message-pop-up defaults to nil
> > implying that BBDB updates the records silently (probably very
> > confusing for many users).
> 
> Actually, I would expect updates to be silent. More precisely, I
> expect "update" to be orthogonal to "display"; I should be able to
> do either without the other, and control them separately.

That's exactly the purpose of having bbdb-message-pop-up as a
separate user variable. so that you can do the above.

> I suggest bbdb-pop-up-window-size should be 4 (current default is
> 0.5). The typical entry will have a name, an email address, and an
> aka; no need to waste space on blank lines. The focus is on
> reading mail, not reading bbdb entries, so making the mail window
> and the bbdb window the same size is wrong.
> 
> Another alternative is to always shrink the bbdb popup window to
> wrap the content, with a max size of 6 or so. I would probably
> find that annoying; the size of the mail window would keep
> changing.

I am rather hesitant with claims concerning a "typical usage of
BBDB". However, I want to go over this code once more, first of all
to make it more robust such that quit-window restores the window
configuration. From a more technical perspective, this means that I
want to make this code match the standard scheme for setting up a
buffer window. I do not know yet what this will involve. Possibly,
this also includes the possibility to make user customization more
flexible.


2012-09-23  Roland Winkler  <wi...@gn...>
	* lisp/bbdb.el (bbdb-mua-auto-update-p): Doc fix.
	(bbdb-message-pop-up): Change default to t.

	* lisp/bbdb-mua.el (bbdb-mua-auto-update)
	(bbdb-mua-auto-update-init): Doc fix.
	(bbdb-mua-auto-update): Simplify.

	* README: Clarify usage of bbdb-mua-auto-update.


BBDB is available at
http://savannah.nongnu.org/projects/bbdb/
To check it out, use
git clone git://git.savannah.nongnu.org/bbdb.git