[BBDB] ChangeLog 2011-12-11

2011-12-11 Thread Roland Winkler
The build process now uses autoconf. Except for typos and other
unintended mistakes an up-to-date installation guide is in the file
INSTALL.

To match common naming conventions the autogenerated file
bbdb-autoloads.el has been renamed to bbdb-loaddefs.el. This is now
the file you need to load in your init file to make BBDB known to
your emacs. To avoid unexpected confusion, `make' throws an error if
it finds an old file bbdb-autoloads.el.

If you download BBDB from savannah, you need autoconf to start a
proper build of BBDB. (The repository does not contain the
autogenerated `configure' script that will be distributed with a
proper release.) If you do not have autoconf installed, you can
compile BBDB using lisp/makefile-temp as a temporary workaround.
See INSTALL.

The repository now has a zeroth version of a BBDB info manual, see
the ./doc directory. I added these files to the repository at such an
early stage of the info manual so that the configure and make files
need not be modified once more to add support for the info manual.

The repository now has a directory ./tex with the TeX files required
by the command bbdb-print.

BBDB now contains a file lisp/bbdb-ispell.el that provides ispell
support for the names in BBDB by exporting these names to your
personal ispell dictionaries. Thanks to Ivan Kanis.

As usual, please let me know if you find any mistakes or unexpected
behavior. The autoconf support probably has some rough edges.


2011-12-11  Roland Winkler  wink...@gnu.org
* INSTALL, Makefile.in, aclocal.m4, configure.ac, install-sh:
* lisp/Makefile.in, doc/Makefil.in, doc/bbdb.texi:
* doc/doclicense.texi, doc/gpl.texi, tex/Makefile.in:
* tex/bbdb-cols.tex, tex/bbdb-print-brief.tex, tex/bbdb-print.tex:
New files.
* lisp/makefile-temp: Renamed from lisp/Makefile.
* README: Updated.

* lisp/bbdb-ispell.el: Header updated.  Prefix bbdb-spell replaced
by bbdb-ispell.
(bbdb-ispell): New custom group.
(bbdb-ispell-dictionary-list): Renamed from bbdb-spell-dictionary.
(bbdb-ispell-field-list): Renamed from bbdb-spell-field.
(bbdb-ispell-export): Merged with bbdb-spell-add-word.
(bbdb-ispell-collect-words): Renamed from
bbdb-spell-export-field. Merged with bbdb-spell-append-word.

2011-12-11  Ivan Kanis ivan.ka...@googlemail.com
* lisp/bbdb-ispell.el: New file

--
Learn Windows Azure Live!  Tuesday, Dec 13, 2011
Microsoft is holding a special Learn Windows Azure training event for 
developers. It will provide a great way to learn Windows Azure and what it 
provides. You can attend the event by watching it streamed LIVE online.  
Learn more at http://p.sf.net/sfu/ms-windowsazure
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Re: export bbdb fields to ispell personal dictionary

2011-12-11 Thread Roland Winkler
On Fri Dec 9 2011 Ivan Kanis wrote:
 I am pleased to release version 1.1 of bbdb spell.

Thank you! I included the file in the repository. Also I made a few
more changes to match naming conventions and to have separate
functions only when they are needed.

The default value of bbdb-ispell-dictionary-list is now '(default)
because my aspell complained it did not have a french dictionary.
Also I removed address from the default of bbdb-ispell-field-list
because these words are probably used yet more rarely elsewhere.

(dolist (bar foo)
  ...)
 
 I thought inclusion of cl was frowned upon. I have made the changes and
 the code is much nicer to read. Thanks for the suggestion.

There is also a `dolist' in subr.el (good enough for most purposes).

  - Check the code of `ispell-word' for how to avoid the `sit-for'.
(I guess there should really be a function in ispell for that
purpose that could be used by other packages, but it does not exist.)
 
 I have changed it to (ispell-accept-output 1) it looks nicer but it's
 probably doing the same thing.

I changed the code so that it sends another word to ispell. This
gives us an explicit response to wait for.

Thanks again for contributing to BBDB.

Roland

--
Learn Windows Azure Live!  Tuesday, Dec 13, 2011
Microsoft is holding a special Learn Windows Azure training event for 
developers. It will provide a great way to learn Windows Azure and what it 
provides. You can attend the event by watching it streamed LIVE online.  
Learn more at http://p.sf.net/sfu/ms-windowsazure
___
bbdb-info@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bbdb-info
BBDB Home Page: http://bbdb.sourceforge.net/


Initial doco patch

2011-12-11 Thread Philip Hudson
Herewith a first-pass attempt at a doco patch. I don't really expect  
this to be merged, it's more for discussion to give me guidance on  
what to do in edge/corner cases.


checkdoc-minor-mode by its nature is inflexible. This patch treats it  
as our master rather than our servant, which leads to some contrived  
doc strings in order to get a clean bill of health from checkdoc.


diff --git a/lisp/bbdb.el b/lisp/bbdb.el
index 44c4181..497be70 100644
--- a/lisp/bbdb.el
+++ b/lisp/bbdb.el
@@ -166,8 +166,8 @@ When nil, ask.
   :type 'boolean)
 
 (defcustom bbdb-read-only nil
-  If t then BBDB will not modify `bbdb-file'
-If you have more than one emacs running at the same time, you might want
+  If t then BBDB will not modify `bbdb-file'.
+If you have more than one Emacs running at the same time, you might want
 to set this to t in all but one of them.
   :group 'bbdb
   :type '(choice (const :tag Database is read-only t)
@@ -259,8 +259,7 @@ Note that this can be called more than once if the BBDB is 
reverted.
   :type 'hook)
 
 (defcustom bbdb-initialize-hook nil
-  Hook run (with no arguments) when the BBDB initialization function
-`bbdb-initialize' is run.
+  No-argument hook run after the BBDB initialization function 
`bbdb-initialize'.
   :group 'bbdb
   :type 'hook)
 
@@ -319,10 +318,10 @@ OPTION-ALIST specifies the options for the layout.  Valid 
options are:
  (display-p . FUNCTION)  +   +  nil
 
 - toggle: controls if this layout is included when toggeling the layout
-- order: defines a user specific order for the fields, where `t' is a place
+- order: defines a user specific order for the fields, where t is a place
   holder for all remaining fields
 - omit: is a list of notes fields which should not be displayed
-  or `t' to exclude all fields except those listed in the order option
+  or t to exclude all fields except those listed in the order option
 - name-end: sets the column where the name should end in one-line layout.
 - indentation: sets the level of indentation for multi-line display.
 - primary: controls wether only the primary mail is shown or all are shown.
@@ -408,7 +407,7 @@ layout function, the multi-line layout will be used.
 (defcustom bbdb-case-fold-search (default-value 'case-fold-search)
   Value of `case-fold-search' used by BBDB and friends.
 This variable lets the case-sensitivity of the BBDB commands
-be different from standard commands like `isearch-forward'.
+be different from standard commands like command `isearch-forward'.
   :group 'bbdb-record-display
   :type 'boolean)
 
@@ -944,10 +943,11 @@ manipulation which is performed before any database 
access.)
  (const :tag Do not ignore redundant addresses nil)))
 
 (defcustom bbdb-message-caching t
-  Whether caching of the message-record association should be used
-for the interfaces which support it (VM, MH, and RMAIL).  This can speed
-things up a lot.  One implication of this variable being t is that
-`bbdb-notice-mail-hook' and `bbdb-notice-record-hook' will not be called
+  Whether to cache the message-record association for supporting interfaces.
+These are VM, MH, and RMAIL.
+
+This can speed things up a lot.  One implication of this variable being t is
+that `bbdb-notice-mail-hook' and `bbdb-notice-record-hook' will not be called
 each time a message is selected, but only the first time.
 Likewise, if selecting a message would generate a question
 \(whether to add an address, change the name, etc) you will only be asked
@@ -1011,6 +1011,9 @@ Hook is run with one argument, the record.
(if value (append (list (car value)) (cadr value)
 
 (defun bbdb-alist-with-header-match (widget value)
+  TODO Fill in.
+Argument WIDGET ???
+Argument VALUE ???
   (widget-group-match widget
   (widget-apply widget :value-to-internal value)))
 
@@ -1204,21 +1207,21 @@ weights more than 100 will be in the end.
 Allowed values are those allowed for `mail-user-agent'.
   :group 'bbdb-sendmail
   :type '(radio (function-item :tag Message package
-  :format %t\n
-  message-user-agent)
-   (function-item :tag Mail package
-  :format %t\n
-  sendmail-user-agent)
-   (function-item :tag Emacs interface to MH
-  :format %t\n
-  mh-e-user-agent)
-   (function-item :tag Message with full Gnus features
-  :format %t\n
-  gnus-user-agent)
-   (function-item :tag VM
-  :format %t\n
-  vm-user-agent)
-   (function :tag Other)
+   :format %t\n
+   message-user-agent)
+(function-item :tag Mail package
+   :format %t\n
+   sendmail-user-agent)
+