;; :after ebdb)
#+end_src
-** COMMENT bbdb
+** bbdb
-#+begin_comment
+Manually install bbdb (=lisp/bbdb= copied from an ELPA-based setup),
+because installing it from source on Emacs 27 using the following
+submodule configuration for some reason doesn’t work and results in
+very strange errors when using any of the functions.
+
+#+begin_src conf :tangle no
[submodule "bbdb"]
path = lib/bbdb
url = https://git.savannah.nongnu.org/git/bbdb.git
- load-path = lisp/elisp
+ load-path = lisp
info-path = doc
build-step = ./autogen.sh
- build-step = ./configure --with-lispdir=elisp
+ build-step = ./configure
build-step = make
build-step = make install
-#+end_comment
+#+end_src
+
+I tried using =borg-elpa= instead of doing it like this, but it added
+2 seconds to my startup time, which is unacceptable to me.
#+begin_src emacs-lisp
(use-package bbdb
+ :load-path "lisp/bbdb"
:init
+ (load (expand-file-name "lisp/bbdb/bbdb-autoloads.el" user-emacs-directory))
(bbdb-mua-auto-update-init 'message)
(setq bbdb-mua-auto-update-p 'query)
(add-hook 'gnus-startup-hook 'bbdb-insinuate-gnus))
--- /dev/null
+*.elc
+*.info
+/bbdb-autoloads.el
+/bbdb-pkg.el
+/TAGS
+/doc/bbdb.pdf
+/doc/bbdb.t2p/
+/doc/texinfo.tex
+/doc/dir
+Makefile
+Makefile.in
+/autom4te.cache/
+/config.*
+/configure
+/aclocal.m4
+/install-sh
+/INSTALL
+/missing
--- /dev/null
+Many people have contributed code included in BBDB.
+
+Abhi Yerra <abhi@berkeley.edu>
+Adam C. Finnefrock <adam@bigbro.biophys.cornell.edu>
+Alex Schroeder <alex@gnu.org>
+Albert L. Ting <alt@artisan.com>
+Barak A. Pearlmutter <barak@cs.nuim.ie>
+Robert Widhopf-Fenk <bbdb@robf.de>
+Boris Goldowsky <boris@gnu.ai.mit.edu>: bbdb-print.el
+David Carlton <carlton@math.mit.edu>
+Christopher Kline <ckline@media.mit.edu>
+Colin Rafferty <colin@xemacs.org>
+Soren Dayton <csdayton@cs.uchicago.edu>
+Didier Verna <didier@xemacs.org>
+Brian Edmonds <edmonds@cs.ubc.ca>
+Christian Egli <christian.egli@sbs.ch>
+Dave Love <fx@gnu.org>
+Greg Troxel <gdt@ir.bbn.com>
+Gijs Hillenius <gijs@hillenius.com>
+Dirk Grunwald <grunwald@cs.colorado.edu>: bbdb-print.el
+Hrvoje Niksic <hniksic@srce.hr>
+Ivan Kanis <ivan.kanis@googlemail.com>: bbdb-ispell
+Jack Repenning <jackr@dblues.wpd.sgi.com>: bbdb-mhe.el
+Simon Josefsson <jas@extundo.com>
+Jeff Bigler <jcb@mit.edu>
+Jeff Mincy <jeff@delphioutpost.com>
+Jim Blandy <jimb@codesourcery.com>
+Jim Blandy <jimb@redhat.com>
+Jochen Küpper <jochen@fhi-berlin.mpg.de>
+John Heidemann <johnh@isi.edu>: bbdb-snarf.el
+Jamie Zawinski <jwz@netscape.com>
+Kees de Bruin <kees_de_bruin@tasking.nl>
+Karl Fogel <kfogel@red-bean.com>
+Fritz Knabe <knabe@ecrc.de>: bbdb-mhe.el
+Kousik Nandy <kousik.nandy@gmail.com>
+Carsten Leonhardt <leo@arioch.oche.de>
+Luigi Semenzato <luigi@paris.cs.berkeley.edu>: bbdb-print.el
+Marco Walther <Marco.Walther@mch.sni.de>
+Stefan Monnier <monnier@iro.umontreal.ca>
+Jean-Yves Perrier <perrier@nagra-kudelski.ch>
+Jens-Ulrik Holger Petersen <petersen@kurims.kyoto-u.ac.jp>
+Philip Hudson <phil.hudson@iname.com>
+Leo Liu <sdl.web@gmail.com>
+Sam Steingold <sds@gnu.org>
+Seth Golub <seth@cs.wustl.edu>
+Matt Simmons <simmonmt@acm.org>
+SL Baur <steve@altair.xemacs.org>
+Kevin Davidson <tkld@quadstone.com>: bbdb-pgp.el
+Todd Kaufmann <toad@cs.cmu.edu>: bbdb-mhe.el
+Tom Tromey <tromey@redhat.com>
+Teodor Zlatanov <tzz@lifelogs.com>
+Waider <waider@waider.ie>
+Christoph Wedler <wedler@fmi.uni-passau.de>
+Roland Winkler <winkler@gnu.org>
+Steve Youngs <youngs@xemacs.org>
+ShengHuo Zhu <zsh@cs.rochester.edu>
+
+
+Local Variables:
+coding: utf-8
+End:
--- /dev/null
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ <program> Copyright (C) <year> <name of author>
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
--- /dev/null
+2017-12-20 Roland Winkler <winkler@gnu.org>
+
+ Add files bbdb-gnus.el and bbdb-vm.el.
+
+2017-12-20 Roland Winkler <winkler@gnu.org>
+
+ Fix declarations for byte compiler. Use file tex-site.el.
+
+2017-11-10 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ Fix copyright headers
+
+2017-11-10 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ Remove files with unclear copyright status; prepare for move to
+ externals/
+
+2017-10-29 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ First cut at adapting BBDB for GNU ELPA
+
+2017-10-17 Roland Winkler <winkler@gnu.org>
+
+ bbdb-parse-records: bug fix
+
+2017-10-11 Roland Winkler <winkler@gnu.org>
+
+ Advertise bbdb-user@nongnu.org
+
+2017-10-11 Roland Winkler <winkler@gnu.org>
+
+ Query before migrating BBDB to new format
+
+2017-10-11 Roland Winkler <winkler@gnu.org>
+
+ bbdb-read-record: Fix calling sequence for calls to set record
+
+2017-08-09 Roland Winkler <winkler@gnu.org>
+
+ New var bbdb-migrate-uuid-xfield
+
+2017-08-09 Roland Winkler <winkler@gnu.org>
+
+ New field uuid. Make creation-date and timestamp immutable
+
+2017-07-25 Roland Winkler <winkler@gnu.org>
+
+ Makefile.am: Fix rule BBDB_ELPA_FILES (Bug#51563)
+
+2017-07-25 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb-tex.el: Improve documentation
+
+2017-07-25 Roland Winkler <winkler@gnu.org>
+
+ bbdb-tex: Bug fix (Bug#51564)
+
+2017-07-22 Roland Winkler <winkler@gnu.org>
+
+ Fix previous patch
+
+2017-07-22 Roland Winkler <winkler@gnu.org>
+
+ bbdb-split: use arg TRIM of split-string with emacs-version >= 24.4.
+
+2017-07-19 Roland Winkler <winkler@gnu.org>
+
+ bbdb-tex: ignore spaces when calling usepackage
+
+2017-07-19 Roland Winkler <winkler@gnu.org>
+
+ bbdb.sty: use RequirePackage
+
+2017-07-19 Roland Winkler <winkler@gnu.org>
+
+ Fix docstring
+
+2017-07-05 Roland Winkler <winkler@gnu.org>
+
+ Use LaTeX for TeXing BBDB
+
+2017-01-31 Roland Winkler <winkler@gnu.org>
+
+ Really discontinue support for GNU Emacs 23
+
+2017-01-30 Roland Winkler <winkler@gnu.org>
+
+ TODO: Extend feature wishlist
+
+2017-01-30 Roland Winkler <winkler@gnu.org>
+
+ README: Add pointer to emacs wiki upgrade page
+
+2017-01-30 Roland Winkler <winkler@gnu.org>
+
+ README, lisp/bbdb-site.el.in: Discontinue support for GNU Emacs 23
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+
+ bbdb-anniv: use diary-goto-entry-function
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+
+ bbdb-anniv-diary-entries: Use cl-flet
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+
+ Use lexical binding for bbdb-anniv.el
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+
+ Discontinue support for GNU Emacs 23
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+
+ Update copyright year
+
+2016-10-02 Roland Winkler <winkler@gnu.org>
+
+ use lexical binding
+
+2016-07-21 Roland Winkler <winkler@gnu.org>
+
+ fix calls of looking-back
+
+2016-07-21 Roland Winkler <winkler@gnu.org>
+
+ Update copyright year
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+
+ Support mu4e-compose-mode and notmuch-message-mode
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+
+ Add support for Wanderlust
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+
+ bbdb-omit-record: bug fix
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+
+ Make bbdb-hashtable a proper hash table
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+
+ New macros bbdb-pushnew
+
+2015-11-14 Roland Winkler <winkler@gnu.org>
+
+ Fix defcustoms
+
+2015-11-08 Roland Winkler <winkler@gnu.org>
+
+ Add new snarfing rule eu for many continental European countries
+
+2015-11-08 Roland Winkler <winkler@gnu.org>
+
+ Simplify re-sorting of records when a record has been changed
+
+2015-09-10 Roland Winkler <winkler@gnu.org>
+
+ Conform to Emacs Lisp package format convention
+
+2015-09-10 Roland Winkler <winkler@gnu.org>
+
+ bbdb-separator-alist: Use two newline characters to separate records
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-search-changed: Fix docstring
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-delete-field-or-record: Use delete for phone and address fields
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-copy-records-as-kill: fix docstring
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+
+ New command bbdb-copy-fields-as-kill
+
+2015-05-23 Roland Winkler <winkler@gnu.org>
+
+ Use equal for comparison when populating lists of labels
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+
+ Add basic support for mu4e mailer
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+
+ Remove variables bbdb/MUA-update-records-p
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+
+ Handle prefix command bbdb-do-all-records more robustly
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+
+ Bugfix: Select (un)displayed records properly
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+
+ Update copyright year in all files
+
+2014-08-30 Roland Winkler <winkler@gnu.org>
+
+ bbdb-print-require: Improve docstring
+
+2014-08-30 Roland Winkler <winkler@gnu.org>
+
+ bbdb-print: Fix messages
+
+2014-08-30 Roland Winkler <winkler@gnu.org>
+
+ bbdb-print-record: Handle xfields the value of which are sexps
+
+2014-08-09 Roland Winkler <winkler@gnu.org>
+
+ bbdb-snarf: always install and display the new record
+
+2014-08-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-add-mail-alias: fix previous change
+
+2014-08-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-add-mail-alias: handle multiple records / multiple aliases
+
+2014-08-01 Roland Winkler <winkler@gnu.org>
+
+ lisp/makefile-temp: fix previous change
+
+2014-07-22 Roland Winkler <winkler@gnu.org>
+
+ Do not load init file or site file for byte compilation
+
+2014-05-15 Roland Winkler <winkler@gnu.org>
+
+ Delete record from bbdb-records if record is undisplayed
+
+2014-05-15 Roland Winkler <winkler@gnu.org>
+
+ Fix and improve previous patch
+
+2014-05-12 Roland Winkler <winkler@gnu.org>
+
+ Only save edited records that got really changed
+
+2014-05-12 Roland Winkler <winkler@gnu.org>
+
+ Create bbdb-pkg.el from bbdb-pkg.el.in
+
+2014-05-06 Roland Winkler <winkler@gnu.org>
+
+ Do not treat bbdb-change-hook special inside bbdb-notice-hooks
+
+2014-05-06 Roland Winkler <winkler@gnu.org>
+
+ Allow arbitrary lisp expressions as values of xfields
+
+2014-05-06 Roland Winkler <winkler@gnu.org>
+
+ bbdb-parse-postcode: Finish immediately if one test succeeds
+
+2014-04-27 Roland Winkler <winkler@gnu.org>
+
+ ready for release 3.1.2
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ Be more careful that empty strings do not pollute the data base
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ Check type of record data structures more carefully
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ lisp/Makefile.am: Include makefile-temp in distribution
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb-site.el.in: Be more verbose about what we want
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ makefile-temp: Obey proper dependencies
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ For vm support, require vm-autoloads
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+
+ bbdb-separator-alist: Treat AKAs consistent with other fields
+
+2014-03-11 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb-site.el: honor pkgdatadir
+
+2014-03-11 Roland Winkler <winkler@gnu.org>
+
+ Install miscellaneous files in the doc directory
+
+2014-03-11 Roland Winkler <winkler@gnu.org>
+
+ m4/package_date.m4: Use "date -u" if "date --rfc-3339" fails
+
+2014-02-28 Roland Winkler <winkler@gnu.org>
+
+ ready for release 3.1
+
+2014-02-28 Roland Winkler <winkler@gnu.org>
+
+ Do not use 'prompt' in a non-emacs sense
+
+2014-02-28 Roland Winkler <winkler@gnu.org>
+
+ Small fixes
+
+2014-02-17 Roland Winkler <winkler@gnu.org>
+
+ bbdb-update-records: eval arg update-p as many times as needed
+
+2014-02-16 Roland Winkler <winkler@gnu.org>
+
+ Bug fix for previous commit
+
+2014-02-15 Roland Winkler <winkler@gnu.org>
+
+ bbdb-update-records: Always evaluate arg update-p twice
+
+2014-01-24 Roland Winkler <winkler@gnu.org>
+
+ Fix ChangLog. Update AUTHORS.
+
+2014-01-23 Roland Winkler <winkler@gnu.org>
+
+ make 'eq the 4th arg of add-to-list
+
+2014-01-23 Roland Winkler <winkler@gnu.org>
+
+ make completion for bbdb-read-string less obtrusive
+
+2014-01-12 Roland Winkler <winkler@gnu.org>
+
+ Make sure the *BBDB* buffer exists
+
+2014-01-12 Roland Winkler <winkler@gnu.org>
+
+ Provide auto completion for streets and postcodes known to BBDB
+
+2014-01-08 Roland Winkler <winkler@gnu.org>
+
+ move mail clean-up to bbdb.el
+
+2014-01-08 Roland Winkler <winkler@gnu.org>
+
+ provide auto completion for address components
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Update copyright year in all files
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Avoid hard-coded references to xfield notes
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ complete previous commit
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ After editing always update display in all BBDB buffers
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Clean up supercite support
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Overhaul bbdb-pgp.el for BBDB 3
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ adapt bbdb-pgp.el for BBDB 3
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ new file lisp/bbdb-pgp.el
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ More flexible editing of xfields
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ use bbdb-initialize for anniversary support
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Clean up handling of redundant email addresses
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Check more carefully/frequently that BBDB is editable
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Small bug fixes
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Display records for messages more flexibly
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ Handle new records more carefully
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+
+ bbdb-snarf-rule-interactive: Use symbol-name
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb-site.el.in: fix typo
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ get authorship right
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ increase version number to 3.0.50
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ new make target elpa
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ m4/package_date.m4: Use git log
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb/sc-consult-attr: Do not use car (Bug#40398)
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb.el: simplify mouse menus
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mua-update-interactive-p: Clarify doc string
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb-file: Use locate-user-emacs-file
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: make command more robust
+
+2013-10-06 Roland Winkler <winkler@gnu.org>
+
+ Clean up lisp/makefile-temp
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+
+ doc/bbdb.texi: Add @dircategory and @direntry
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+
+ m4/package_date.m4: Use more robust output redirection
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+
+ m4/emacs_vm.m4: Fix typo
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+
+ m4/emacs_vm.m4: Define mconditional VM unconditionally
+
+2013-07-27 Roland Winkler <winkler@gnu.org>
+
+ Further clean up of autoconf
+
+2013-07-18 Roland Winkler <winkler@gnu.org>
+
+ Clean up usage of automake and autoconf
+
+2013-07-17 Roland Winkler <winkler@gnu.org>
+
+ INSTALL: fix typos
+
+2013-07-17 Roland Winkler <winkler@gnu.org>
+
+ INSTALL: fix typo
+
+2013-07-17 Roland Winkler <winkler@gnu.org>
+
+ Use Automake
+
+2013-07-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mua-auto-update: Use bbdb-pop-up-layout
+
+2013-07-07 Roland Winkler <winkler@gnu.org>
+
+ Handle a new bbdb-file more carefully
+
+2013-07-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-update-records-p: Fix docstring
+
+2013-05-26 Roland Winkler <winkler@gnu.org>
+
+ Simplify configure.ac and lisp/Makefile.in
+
+2013-05-26 Roland Winkler <winkler@gnu.org>
+
+ Convert VM path to absolute and canonicalize it
+
+2013-05-26 Roland Winkler <winkler@gnu.org>
+
+ Honor bbdb-message-clean-name-function and
+ bbdb-canonicalize-mail-function consistently
+
+2013-04-21 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb-mua.el (bbdb-mua-summary-mark): Bug fix
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb-snarf.el: new file
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb-merge-records: merge also affixes, fix docstring
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ Allow city, postcode, state, and country to be nil when formatting
+ addresses
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb-hash-record, bbdb-change-record: Fix docstring
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb-new-mails-primary: Change default to query
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ Allow bbdb-mua-summary-mark-field to be a function
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb-extract-address-components: new function
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: simplify
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ bbdb/vm-virtual-folder: set vm-virtual-folder-alist properly
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb-sc.el (bbdb/sc-attribution-field): Fix docstring
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+
+ tex/Makefile.in: Acknowledge DESTDIR.
+
+2013-02-16 Roland Winkler <winkler@gnu.org>
+
+ make bbdb-complete-mail and related functions more robust
+
+2013-02-16 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mail-yank: Bind case-fold-search to t
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+
+ bbdb-delete-field-or-record: Handle multiple records.
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+
+ Use inhibit-quit more often.
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+
+ Doc fixes
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+
+ Remove internal variable bbdb-modified
+
+2013-02-02 Roland Winkler <winkler@gnu.org>
+
+ Avoid more carefully that text properties do not accidentally enter BBDB
+
+2013-01-20 Roland Winkler <winkler@gnu.org>
+
+ aclocal.m4: Do not throw an error if tex_dir does not exist
+
+2013-01-20 Roland Winkler <winkler@gnu.org>
+
+ doc/Makefile.in, tex/Makefile.in: Provide the DESTDIR variable
+
+2013-01-13 Roland Winkler <winkler@gnu.org>
+
+ Bug fix: Set bbdb-xfield-labels-list and bbdb-organization-list to nil
+ only once.
+
+2013-01-13 Roland Winkler <winkler@gnu.org>
+
+ Update copyright year
+
+2013-01-13 Roland Winkler <winkler@gnu.org>
+
+ Use completing-read-multiple for editing organization fields
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+
+ minor fix
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+
+ Add supercite support
+
+2012-12-29 Roland Winkler <winkler@gnu.org>
+
+ configure option --with-tex-dir renamed from --with-texmf-dir
+
+2012-12-29 Roland Winkler <winkler@gnu.org>
+
+ Minor fixes
+
+2012-12-29 Roland Winkler <winkler@gnu.org>
+
+ Add MUA Summary support
+
+2012-12-26 Roland Winkler <winkler@gnu.org>
+
+ Small fixes
+
+2012-12-26 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: bug fix
+
+2012-12-26 Roland Winkler <winkler@gnu.org>
+
+ make quit-window restore the window configuration
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+
+ bbdb/vm-auto-add-label: Doc fix and cleanup.
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+
+ README: minor docfix
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+
+ For the user-defined fields of a record replace the generic internal
+ name notes by xfield.
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+
+ bbdb-parse-records): If multiple records have the same name, hash all
+ these records
+
+2012-09-23 Roland Winkler <winkler@gnu.org>
+
+ Add support for RFC-822 mail addresses
+
+2012-09-23 Roland Winkler <winkler@gnu.org>
+
+ Clarify usage of bbdb-mua-auto-update
+
+2012-09-09 Roland Winkler <winkler@gnu.org>
+
+ unified scheme for customizing how BBDB analyzes messages
+
+2012-09-08 Roland Winkler <winkler@gnu.org>
+
+ bbdb-message-header: use gnus-fetch-original-field
+
+2012-09-07 Roland Winkler <winkler@gnu.org>
+
+ make bbdb-accept-name-mismatch more flexible
+
+2012-09-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mua-edit-field: Bug fix
+
+2012-09-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-record-set-field: Bug fix
+
+2012-09-01 Roland Winkler <winkler@gnu.org>
+
+ new macro bbdb-with-print-loadably
+
+2012-08-11 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: clean up with *Completions*
+
+2012-08-11 Roland Winkler <winkler@gnu.org>
+
+ remove broken electricity
+
+2012-08-09 Roland Winkler <winkler@gnu.org>
+
+ remove broken message cache
+
+2012-08-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: use quit-window instead of playing with the window
+ configuration
+
+2012-08-06 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: Revert 2012-07-06 change
+
+2012-08-05 Roland Winkler <winkler@gnu.org>
+
+ bbdb-annotate-message: simplify
+
+2012-08-05 Roland Winkler <winkler@gnu.org>
+
+ update hash table more carefully
+
+2012-08-05 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: rely on set-window-configuration
+
+2012-08-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-merge-records: Improve interactive call and docstring
+
+2012-08-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-merge-records: Handle duplicates properly
+
+2012-08-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: cycle single address
+
+2012-07-20 Roland Winkler <winkler@gnu.org>
+
+ Bug fix bbdb-annotate-message: create new record if update-p has not
+ value update
+
+2012-07-20 Roland Winkler <winkler@gnu.org>
+
+ bbdb-gethash: Allow value of t for arg predicate
+
+2012-07-20 Roland Winkler <winkler@gnu.org>
+
+ bbdb-message-search: Allow args name or mail to be nil
+
+2012-07-19 Roland Winkler <winkler@gnu.org>
+
+ Simplify electric display
+
+2012-07-18 Roland Winkler <winkler@gnu.org>
+
+ bbdb-electric-display-records: Fix previous patch.
+
+2012-07-18 Roland Winkler <winkler@gnu.org>
+
+ bbdb.el: Clean up electric command loop
+
+2012-07-17 Roland Winkler <winkler@gnu.org>
+
+ MUA interface: allow update of existing records only; re-enable message
+ cache
+
+2012-07-12 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mua.el: Fix docstrings
+
+2012-07-09 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mua-*: new arg update-p
+
+2012-07-08 Roland Winkler <winkler@gnu.org>
+
+ bbdb-update-records: Fix previous patch
+
+2012-07-08 Roland Winkler <winkler@gnu.org>
+
+ bbdb-update-records: Make records a list ordered like address-list
+
+2012-07-06 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: Use window-live-p
+
+2012-07-06 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mua-edit-field: Revert previous change
+
+2012-07-06 Sam Steingold <sds@gnu.org>
+
+ * lisp/bbdb-com.el (bbdb-complete-mail): Use `quit-window' instead of
+ `bury-buffer' to get rid of *Completions*.
+
+2012-07-06 Sam Steingold <sds@gnu.org>
+
+ * lisp/bbdb-mua.el (bbdb-mua-edit-field): Edit THE record for THE
+ sender, not all the relevant records.
+
+2012-07-03 Roland Winkler <winkler@gnu.org>
+
+ bbdb-search: also search last_first names
+
+2012-07-01 Roland Winkler <winkler@gnu.org>
+
+ bbdb-get-address-components: name may be nil.
+
+2012-07-01 Roland Winkler <winkler@gnu.org>
+
+ ignore Makefiles and configure files
+
+2012-06-24 Roland Winkler <winkler@gnu.org>
+
+ major update, see ChangeLog
+
+2012-01-02 Roland Winkler <winkler@gnu.org>
+
+ bbdb-auto-notes-rules: Use :set keyword
+
+2012-01-02 Roland Winkler <winkler@gnu.org>
+
+ bbdb-anniv-alist: clarify docstring
+
+2012-01-02 Roland Winkler <winkler@gnu.org>
+
+ Clean up custom-loads
+
+2011-12-18 Roland Winkler <winkler@gnu.org>
+
+ remove leading and trailing whitespace in text properly
+
+2011-12-18 Roland Winkler <winkler@gnu.org>
+
+ do not create backup of bbdb-loaddefs.el
+
+2011-12-18 Roland Winkler <winkler@gnu.org>
+
+ new format `%t' for bbdb-anniv-alist
+
+2011-12-11 Roland Winkler <winkler@gnu.org>
+
+ add autoconf support, add doc and tex dirs
+
+2011-12-11 Roland Winkler <winkler@gnu.org>
+
+ rename lisp/Makefile to lisp/makefile-temp
+
+2011-12-11 Roland Winkler <winkler@gnu.org>
+
+ rename lisp/Makefile to lisp/makefile-temp
+
+2011-12-11 Roland Winkler <winkler@gnu.org>
+
+ new file lisp/bbdb-ispell.el
+
+2011-11-27 Roland Winkler <winkler@gnu.org>
+
+ Minor clarifications in README
+
+2011-11-27 Roland Winkler <winkler@gnu.org>
+
+ Disable VM support by default
+
+2011-11-27 Roland Winkler <winkler@gnu.org>
+
+ Fix typos, update README
+
+2011-11-20 Roland Winkler <winkler@gnu.org>
+
+ major overhaul (part 2)
+
+2011-11-20 Roland Winkler <winkler@gnu.org>
+
+ major overhaul
+
+2011-10-11 Ted Zlatanov <tzz@lifelogs.com>
+
+ * lisp/bbdb.el: Also autoload `bbdb-insinuate-{message,rmail,vm,mh}'
+ from bbdb-*.el so `bbdb-initialize' won't throw an error when passed
+ that symbol.
+
+2011-10-11 Ted Zlatanov <tzz@lifelogs.com>
+
+ * lisp/bbdb.el: Autoload `bbdb-insinuate-gnus' from bbdb-gnus.el so
+ `bbdb-initialize' won't throw an error when passed 'gnus.
+
+2011-10-10 Roland Winkler <winkler@gnu.org>
+
+ improve editing and display of record names, improve merging fields of
+ records, bug fixes
+
+2011-09-22 Roland Winkler <winkler@gnu.org>
+
+ bbdb-pop-up-window: remove Gnus-specific code
+
+2011-09-21 Roland Winkler <winkler@gnu.org>
+
+ bbdb-browse-url: Fix usage of prefix arg.
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+
+ bug fix: lisp/bbdb-com.el (bbdb-add-mail-alias)
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+
+ Use / as search prefix
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+
+ simplify dialing
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+
+ small bug fixes
+
+2011-05-11 Roland Winkler <winkler@gnu.org>
+
+ bbdb-prompt-for-create: Use special-mode
+
+2011-05-11 Roland Winkler <winkler@gnu.org>
+
+ split bbdb-notice-hook into bbdb-notice-mail-hook and
+ bbdb-notice-record-hook
+
+2011-05-08 Roland Winkler <winkler@gnu.org>
+
+ bbdb-display-all-records: Use redisplay.
+
+2011-05-08 Roland Winkler <winkler@gnu.org>
+
+ Fix typos
+
+2011-05-07 Roland Winkler <winkler@gnu.org>
+
+ bbdb-display-current-record: New command
+
+2011-05-07 Roland Winkler <winkler@gnu.org>
+
+ Fix commit 2011-04-30 03:58:01
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+
+ bbdb-parse-internal: Clarify error message.
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+
+ Ignore TAGS files
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+
+ Fix corrupted BBDB files when migrating.
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+
+ Makefile: Use option --batch
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+
+ Rename degree field to affix.
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+
+ New commands bbdb-next-field, bbdb-prev-field.
+
+2011-04-23 Roland Winkler <winkler@gnu.org>
+
+ distinguish 1 and 1.0 in bbdb-pop-up-window-size
+
+2011-04-23 Roland Winkler <winkler@gnu.org>
+
+ bbdb-insinuate-MUA: Fix docstring.
+
+2011-04-23 Roland Winkler <winkler@gnu.org>
+
+ bbdb-mode-map: Do no call set-keymap-parent.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ Use defvar for bbdb-create-hook and bbdb-change-hook
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ Include timezone info in bbdb-time-stamp-format
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ New file TODO
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb.el: Define and use BBDB's own faces
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb.el: Inherit from special-mode
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb.el: Fix indentation of multi-line fields (bug#33101)
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ lisp/bbdb-com.el: Autoload browse-url-url-at-point
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+
+ Call add-hook for bbdb-create-hook and bbdb-change-hook
+
+2011-04-11 Barak A. Pearlmutter <barak+git@cs.nuim.ie>
+
+ cvs to git in README
+
+2011-04-11 Barak A. Pearlmutter <barak+git@cs.nuim.ie>
+
+ git ignore build products
+
+2011-04-11 Roland Winkler <winkler@gnu.org>
+
+ bbdb-complete-mail: Ensure initialization of database
+
+2011-04-10 Roland Winkler <winkler@gnu.org>
+
+ Fix Makefile
+
+2011-04-10 Roland Winkler <winkler@gnu.org>
+
+ Add support for anniversaries. Make bbdb-transpose-fields more robust.
+ Separate formatting functions from display functions. Various bug fixes
+ and improved documentation. Cleanup code.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/rmail-update-records-p): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/gnus-update-records-p): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/mh-update-records-p): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/vm-update-records-p): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/message-update-records-p): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-mua-wrapper): Simplify code.
+ (bbdb-mua-auto-update-init): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-append-display-p, bbdb-append-display)
+ (bbdb-search-invert-p, bbdb-search-invert): Use bbdb-modeline-info.
+ (bbdb-search): Also search for addresses. Simplify codde.
+ (bbdb-search-address): New command.
+ (bbdb-search-phone): Fix prompt.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-modeline-info): New variable.
+ (bbdb-mode): Use it.
+ (bbdb-mode-map): Unify keybindings for search commands.
+ (bbdb-sort-records): Update marker positions correctly.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-migrate-postcodes-to-strings): Renamed from
+ bbdb-migrate-zip-codes-to-strings.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-message-search): Use name only if mail address does not match.
+ (bbdb-parse-postcode): Renamed from bbdb-parse-zip.
+ (bbdb-insert-field): In interactive calls ignore fields that are already
+ present.
+ (bbdb-record-edit-phone): Convert format of phone number if old and new
+ format are different.
+ (bbdb-edit-field): Use new bbdb-record-edit-phone.
+ (bbdb-record-edit-address): Use bbdb-address-format-list.
+ (bbdb-edit-address-street): Renamed from bbdb-address-edit-street. Take
+ arg street instead of address.
+ (bbdb-edit-address-default): Renamed from bbdb-address-edit-default.
+ (bbdb-address-edit-continental): Removed (obsolete).
+ (bbdb-complete-mail-cleanup): Removed. Code merged with
+ bbdb-complete-mail.
+ (bbdb-complete-mail): Return non-nil if valid completion exists.
+ Simplify code.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-print-tex-quote-alist): Fix regexp.
+ (bbdb-print-address-format-list): Renamed from
+ bbdb-print-address-format-alist. Use bbdb-address-format-list as
+ default.
+ (bbdb-print): Use bbdb-format-address.
+ (bbdb-print-address-continental): Removed.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-annotate-message): Use bbdb-string=.
+ (bbdb-mua-wrapper): Also handle mail and message mode.
+ (bbdb-mua-auto-update): Renamed from bbdb-mua-pop-up-bbdb-buffer.
+ Perform auto update even if bbdb-message-pop-up is nil.
+ (bbdb-mua-auto-update-init): Renamed from bbdb-mua-pop-up-init. Doc fix.
+ Use memq instead of member.
+ (bbdb-force-record-create): Removed (obsolete).
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-address-format-list): New variable for customization of address
+ formatting and editing. (renamed from bbdb-address-format-alist).
+ (bbdb-format-address): Use it.
+ (bbdb-format-record-one-line, bbdb-format-record-multi-line): Use
+ bbdb-format-address.
+ (bbdb-address-edit-function, bbdb-format-streets)
+ (bbdb-format-address-continental): Removed. Obsolete because of
+ bbdb-address-format-list.
+ (bbdb-format-record): Use funcall instead of eval.
+ (bbdb-continental-postcode-regexp): Renamed from
+ bbdb-continental-zip-regexp.
+ (bbdb-check-postcode): Renamed from bbdb-check-zip.
+ (bbdb-legal-postcodes): Renamed from bbdb-legal-zip-codes.
+ (bbdb-expand-mail-aliases): Removed.
+ (bbdb-notes-label-list): Renamed from bbdb-notes-names.
+ (bbdb-parse-frobnicate): Calculate value of bbdb-notes-label-list
+ instead of reading it. Use memq instead of member.
+ (bbdb-set-notes-labels): Renamed from bbdb-set-notes-names. Do not write
+ value of bbdb-notes-label-list.
+ (bbdb-set-eq): Removed (obsolete).
+ (bbdb-defstruct): Use defsubst.
+ (bbdb-record-unset-name): Clarify code.
+ (bbdb-initialize): Doc fix.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ Do not attempt to add empty line to bbdb-autloads.el.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ Updated.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ In bbdb-autloads.el, add BBDB lisp directory to load-path.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-pop-up-buffer): Use condition-case, in case split-window fails.
+ (bbdb-records, bbdb-mode, bbdb-version, bbdb-initialize): Add autoload
+ cookie.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-complete-name): Obsolete alias for bbdb-complete-mail.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insinuate-gnus): Code doc updated.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-mua-update-records): For Gnus use gnus-article-buffer.
+ (bbdb-mua-wrapper): New macro.
+ (bbdb-mua-display-records, bbdb-mua-annotate-sender)
+ (bbdb-mua-annotate-recipients, bbdb-mua-edit-notes-sender)
+ (bbdb-mua-edit-notes-recipients): Use it.
+ (bbdb-mua-update-mua): Removed (obsolete because of bbdb-mua-wrapper).
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insinuate-vm): Do not hook in bbdb-mua-pop-up-bbdb-buffer. (Use
+ instead bbdb-mua-pop-up-init.)
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insinuate-mh): Do not hook in bbdb-mua-pop-up-bbdb-buffer. (Use
+ instead bbdb-mua-pop-up-init.)
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insinuate-gnus): Do not hook in bbdb-mua-pop-up-bbdb-buffer. (Use
+ instead bbdb-mua-pop-up-init.)
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insinuate-rmail): Do not hook in bbdb-mua-pop-up-bbdb-buffer.
+ (Use instead bbdb-mua-pop-up-init.)
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insinuate-message, bbdb-insinuate-mail): Do not hook in
+ bbdb-mua-pop-up-bbdb-buffer. (Use instead bbdb-mua-pop-up-init.)
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ Use eval-and-compile.
+ (bbdb-update-records): Avoid name clash with function search in
+ cl-seq.el.
+ (bbdb-message-header-re): New function.
+ (bbdb-accept-message): Use it.
+ (bbdb-get-address-components): Also return MUA.
+ (bbdb-annotate-message): Bug fix. Simplify.
+ (bbdb-mua-pop-up-init): New function.
+ (bbdb-auto-notes): Complete re-write.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ Use eval-and-compile.
+ (bbdb-subint): Moved here from lisp/bbdb.el. Simplified.
+ (bbdb-parse-phone): Return value always includes extension.
+ (bbdb-read-record): Simplified accordingly.
+ (bbdb-prompt-for-new-field): Use phone number style as returned from
+ bbdb-parse-phone.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-message-headers, bbdb-accept-name-mismatch)
+ (bbdb-use-alternate-names): Fix docstring.
+ (bbdb-auto-notes-rules): Renamed from bbdb-auto-notes-alist. New
+ format.
+ (bbdb-auto-notes-ignore-messages): Renamed from
+ bbdb-auto-notes-ignore-all.
+ (bbdb-auto-notes-ignore-headers): Renamed from bbdb-auto-notes-ignore.
+ (bbdb-pop-up-window-size): Fix docstring.
+ (bbdb-horiz-pop-up-window-size): New variable.
+ (bbdb-pop-up-buffer): Use it.
+ (bbdb-auto-notes-rules-expanded): New variable.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ Updated to compile also the new files.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ Initial version.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/rmail-update-records)
+ (bbdb/rmail-pop-up-bbdb-buffer, bbdb/rmail-show-records)
+ (bbdb/rmail-show-sender, bbdb/rmail-show-recipients)
+ (bbdb/rmail-annotate-sender, bbdb/rmail-edit-notes)
+ (bbdb/rmail-summary-show-all-recipients): Obsolete. Use instead generic
+ functions in bbdb-mua.el.
+ (bbdb-insinuate-rmail): Use generic commands. Remove defadvice which
+ has become obsolete because header Messge-ID is used for message
+ caching.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/gnus-update-records)
+ (bbdb/gnus-pop-up-bbdb-buffer, bbdb/gnus-show-records)
+ (bbdb/gnus-show-sender, bbdb/gnus-show-recipients)
+ (bbdb/gnus-annotate-sender, bbdb/gnus-edit-notes)
+ (bbdb/gnus-summary-show-all-recipients): Obsolete. Use instead generic
+ functions in bbdb-mua.el.
+ (bbdb-insinuate-gnus): Use generic commands.
+ (bbdb/gnus-lines-and-from-length): Removed as gnus-optional-headers
+ appears to be obsolete, too.
+ (bbdb/gnus-message-marker-field): New variable.
+ (bbdb-message-marker-field): Declared obsolete.
+ (bbdb/gnus-summary-get-sender, bbdb/gnus-summary-sender-in-bbdb)
+ (bbdb/gnus-nnimap-folder-list-from-bbdb): Simplified.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/vm-header): Remove MIME decoding.
+ (bbdb/vm-update-records, bbdb/vm-pop-up-bbdb-buffer)
+ (bbdb/vm-show-records, bbdb/vm-show-sender)
+ (bbdb/vm-show-recipients, bbdb/vm-annotate-sender)
+ (bbdb/vm-edit-notes): Obsolete. Use instead generic functions in
+ bbdb-mua.el.
+ (bbdb-insinuate-vm): Use generic commands.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-mua, bbdb-message-header): New functions.
+ (bbdb-get-address-components): Use bbdb-message-header. Simplified.
+ (bbdb-update-records): New arg msg-key. Handle message cache. Arg
+ update-p may also be a function.
+ (bbdb-mua-update-records, bbdb-mua-update-mua)
+ (bbdb-mua-update-interactive-p, bbdb-mua-pop-up-bbdb-buffer): New
+ functions.
+ (bbdb-mua-display-records, bbdb-mua-display-sender)
+ (bbdb-mua-display-recipients, bbdb-mua-annotate-sender)
+ (bbdb-mua-annotate-recipients, bbdb-mua-edit-notes-sender)
+ (bbdb-mua-edit-notes-recipients): New commands.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-mail, bbdb-mail-address): Simplified.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-mua-message): New customization group.
+ (bbdb-update-records-p): Value may also be a function.
+ (bbdb-mua-update-interactive-p): New variable.
+ (bbdb-init-forms): Add message and mail mode support. Sendmail is
+ depreciated (use mail instead). Remove outdated support for reportmail,
+ supercite and w3.
+ (bbdb-initialize): Updated accordingly. Do not test presence of features
+ (which is not needed).
+ (bbdb-insinuate-sendmail): Removed (use bbdb-insinuate-mail).
+ ( bbdb-insinuate-message): Moved to bbdb-message.el.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/rmail-update-records-p): Improved default.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/gnus-update-records-p): Improved default.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb/vm-update-records-p): Improved default.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-delete-duplicate-mails, bbdb-display-records-completely)
+ (bbdb-display-records-with-layout, bbdb-copy-records-as-kill): Doc fix.
+ (bbdb-search-duplicates): Improved interactive spec. New arg records.
+ Doc fix
+ (bbdb-delete-field-or-record): Make records a required arg. New arg
+ fields. Doc fix.
+ (bbdb-delete-records, bbdb-toggle-records-layout)
+ (bbdb-sort-addresses, bbdb-sort-phones, bbdb-sort-notes)
+ (bbdb-add-mail-alias): Make records a required arg. Doc fix.
+ (bbdb-mail-address): New command bound to M.
+ (bbdb-mail): Use it. New arg verbose. Fix interactive spec.
+ (bbdb-mail-yank): Renamed from bbdb-yank-addresses. Bug fix.
+ (bbdb-yank-addresses): Declared obsolete.
+ (bbdb-browse-url): Simplify. Doc fix.
+ (bbdb-grab-url): Simplify.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-update-records-p): Fix docstring.
+ (bbdb-message-pop-up): Change default to a less aggressive nil.
+ (bbdb-format-record-one-line): Remove linebreaks from multi-line notes.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-dwim-mail): Fix typo.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-wrap-column): New variable.
+ (bbdb-format-list): Use bbdb-wrap-column and bbdb-separator-alist.
+ (bbdb-layout-alist, bbdb-format-address-continental)
+ (bbdb-format-address-default, bbdb-format-record-multi-line): Change
+ value of indentation such that it becomes the total indentation.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-mail-allow-redundancy): Doc fix.
+ (bbdb-mode-map): Include bbdb-do-all-records in "Use database" submenu.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-record-list): Doc fix.
+ (bbdb-dwim-mail): Arg MAIL may be a number, which will pick the MAILth
+ mail address.
+ (bbdb-mail): New optional arg N to pick Nth mail address.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ ChangeLog
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-dwim-mail): Cleanup code.
+
+2011-03-28 Roland Winkler <winkler@gnu.org>
+
+ (bbdb-insert-record-internal): Handle empty database properly.
+
+2011-03-28 Barak A. Pearlmutter <barak+git@cs.nuim.ie>
+
+ Start v3.x development: flush v2.x, Copyleft, README, ChangeLog, initial
+ code
+
+2011-03-12 Barak A. Pearlmutter <barak+git@cs.nuim.ie>
+
+ un-expand stray expanded CVS keywords introduced in patches
+
+2008-03-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Prompting was not handling the ? properly.
+
+ Also reworked some other odd code.
+
+2008-03-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed a docstring typo.
+
+2008-03-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Now hopefully really do it right for all cases.
+
+ The cases are:
+ - bbdb/mail-auto-create-p nil
+ - bbdb/mail-auto-create-p 'prompt
+ - bbdb/mail-auto-create-p t
+
+2008-03-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Prompting for creation now works again as documented.
+
+ Thanks to Leo for reporting this.
+
+ Also did some docstring fixes.
+
+2008-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ Commit of missing changlog entry for 2007-12-08 Kousik Nandy.
+
+2008-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed CVS keywords, since expansion messes with bzr.
+
+2008-01-29 Didier Verna <didier@xemacs.org>
+
+ Fix for gnus-user-format-function-B
+
+2008-01-29 Didier Verna <didier@xemacs.org>
+
+ Handle recent type change of gnus-ignored-from-addresses
+
+2008-01-29 Didier Verna <didier@xemacs.org>
+
+ Improve bbdb-define-all-aliases docstring
+
+2008-01-29 Didier Verna <didier@xemacs.org>
+
+ Fix infinite loop (misplaced iteration) in bbdb-collect-all-aliases
+
+2007-12-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-dwim-net-address-title-field): New field controlling if a title is
+ prepended to an email address. The default value is 'title.
+
+2007-12-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed two compile time warnings.
+
+2007-11-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Set `bbdb/vm-update-records-mode' to annotating.
+
+ The sexp was never evaluated to 'annotating as VM was clearing the new
+ flag just before BBDBs update functions are called, this will only work
+ in VM 8.1.*!
+
+2007-11-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Minor whitespace cleanup and quoting of "(" in `bbdb-get-addresses' doc
+ string.
+
+ Now really the right source file.
+
+2007-11-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Minor whitespace cleanup and quoting of "(" in `bbdb-get-addresses' doc
+ string.
+
+2007-11-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Normalize and unify names before comparing them.
+
+2007-11-08 Robert Fenk <fenk@users.sourceforge.net>
+
+ Allow to customize `bbdb-file-coding-system', but be warned!
+
+2007-11-08 Robert Fenk <fenk@users.sourceforge.net>
+
+ Patch from Jim Blandy for (bbdb-always-add-addresses): Document new
+ meanings of 'ask', nil, and function symbols and @pxref, not @xref.
+
+2007-11-08 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Added BBDB version of prin1 and prin1-to-string binding
+ print-level and print-length to nil to avoid abbreviation when writing
+ records.
+
+2007-07-03 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-summary-get-author): Added handling of
+ `gnus-ignored-from-addresses' and `gnus-summary-to-prefix'.
+
+2007-06-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Renamed primep to bbdb-primep which calls primep if it exists.
+
+2007-06-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Call bbdb-mail-abbrev-expand-hook after expansion.
+
+ This allows for modifying the expanded stuff or do voodoo based on it.
+
+2007-05-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Make display-buffer work again.
+
+ While the *BBDB* buffer is replacing an existing window instead of
+ poping up it will make special-display work again.
+
+2007-05-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ Ensure we are poping up a *BBDB* buffer when displaying records.
+
+ `bbdb-use-pop-up' is actually checked in the MUA code and no displaying
+ will happen when it is nil.
+
+2007-05-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ Ensure we are poping up the *BBDB* buffer but do it not twice, at least
+ when it is possible.
+
+2007-05-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ Avoid a warning about "... seems to ignore the --datarootdir setting".
+
+2007-05-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: clear the *BBDB* buffer before displaying records.
+
+ Many thanks to Leo for the fix and clarifying this to me.
+
+2007-05-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix for bbdb-display-records-1 if there is no BBDB buffer.
+
+ This was (probably) caused by the last changes to
+ bbdb-pop-up-bbdb-buffer due to honoring bbdb-use-pop-up.
+
+ Thanks to Leo for reporting this.
+
+2007-05-28 Robert Fenk <fenk@users.sourceforge.net>
+
+ Use save-excursion instead with-output-to-temp-buffer to avoid popup.
+
+2007-05-28 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added missing require for vm-undo.el.
+
+2007-05-28 Robert Fenk <fenk@users.sourceforge.net>
+
+ Merge with trunk.
+
+2007-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed links, tagged broken ones and added bbdb2tbird.
+
+2007-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Honor `bbdb-use-pop-up' the right way.
+
+2007-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ No popups when bbdb-use-pop-up is nil.
+
+ This is how the docs say it and how it should be, thus I break
+ compatibility with older versions!
+
+2007-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed compile warnings about not existing variables and functions.
+
+2007-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Cleanup of requires to built without warning.
+
+2007-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Do not care for ancient VM version and simplified MUA directory checks.
+
+2007-05-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ Some cleanup and more docs on magic nets.
+
+2007-05-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed old `bbdb-define-all-aliases' function and variable
+ `bbdb-define-all-aliases-mode'.
+
+2007-05-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ Magic aliases and nets are working now.
+
+2007-05-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ Rewrite of `bbdb-define-all-aliases' using magic aliases.
+
+2007-04-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: in MH split the mh-show-mode buffer not the mh-folder-mode one.
+
+ Thanks to Thomas Baumann for the fix.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Only put hash for (lastname firstname) if they both exist.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Rewrote the function `bbdb-pop-up-bbdb-buffer' to use PREDICATE
+ regardless of the split mode selected by `bbdb-use-pop-up'.
+
+ `bbdb-use-pop-up' can be used to select the split mode.
+
+ Also added the new variable `bbdb-pop-up-target-columns' which is the
+ number of columns for the BBDB buffer window when splitting vertically.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added `bbdb-update-records-mode', `bbdb-get-addresses-headers' and
+ `bbdb-get-only-first-address-p' also to the customize group
+ 'bbdb-noticing-records.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Include also the vm-presentation buffers in the search for a proper
+ pop-up buffer.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ "rmailsum.el" has no provide thus load it instead of requiring it.
+
+ This is a fix from the XEmacs CVS.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed all byte compiler warnings for XEmacs except those about
+ unreferenced variables in the functions `bbdb-format-record' and
+ `bbdb-force-record-create' where I am not quite sure how to fix them .
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Better docstring for `bbdb-update-records'.
+
+2007-04-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed the doc string of bbdb/vm-pop-up-bbdb-buffer.
+
+2007-02-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed all CVS keywords from the sources as they are a pita when
+ gatewaying into another VCS. They were not present in all files
+ anyway.
+
+2007-02-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ Handle sexp/function in bbdb-quiet-about-name-mismatches more
+ gracefully. Also added the readonly field example in the defcustom.
+
+2007-02-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ bbdb-quiet-about-name-mismatches: Can be a function or sexp to allow
+ user tweak-able name updates.
+
+2007-02-14 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb.el (bbdb-use-pop-up): Changed the default to 'horiz.
+ (bbdb-pop-up-display-layout): Changed the default to 'one-line.
+ Some code linting here and there.
+
+ * lisp/bbdb-com.el (bbdb-complete-name-allow-cycling): changed
+ default to t.
+ (bbdb-get-only-first-address-p): changed default to nil.
+ (bbdb-get-addresses): Added a doc string.
+
+2007-02-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ Finally fixed the release date on the homepage.
+
+2007-02-06 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added support for completion on "lastname firstname".
+
+2007-02-06 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed generation of Makefile from Makefile.in.
+
+2007-02-06 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed release date.
+
+2007-02-06 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: Tom Tromey's small makefile patch
+
+ Message-ID: <m3veijazeo.fsf@localhost.localdomain> From: Tom Tromey
+ <tromey@redhat.com> To: bbdb-info@lists.sourceforge.net Date: 03 Feb
+ 2007 11:06:55 -0700 Subject: small makefile patch
+
+2007-01-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ Increased version to '2.36 devo'
+
+2007-01-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added rule to update the web site
+
+2007-01-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added rule to generate bbdb.html manual
+
+2007-01-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ Updated Homepage for 2.35
+
+2007-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ Finally fixed the completion bug reported by Svend Tollak Munk. It was
+ broken by the last bugfix for it. ;-/
+
+2007-01-01 Ronan Waide <waider@waider.ie>
+
+ Patrick Campbell-Preston's fixed version of primep
+
+2006-12-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Applied the patch fixing warnings on obsolete string-to-int for GNU
+ Emacs 22. Thanks to Leo <sdl.web AT gmail.com>.
+
+2006-12-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Reverted changes which slipped in with the previous commit.
+
+2006-12-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix: we must store the callback data for the defadvice
+ choose-completion-string in a buffer local variable, otherwise it breaks
+ completions other than bbdb-complete-name.
+
+2006-12-15 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix for correctly replacing completed string in GNU Emacs when
+ selection a completion for bbdb-complete-name from the completions
+ buffer. This fixes the bug reported in
+ <hddac4kla8w.fsf@decibel.pvv.ntnu.no> by Svend Tollak Munk.
+
+ [We should create the changelog from the CVS log instead of writing it
+ by hand, since it is annoying to write the same log 3 times, e.g. two
+ times for the commit and once in the changelog.]
+
+2006-12-15 Robert Fenk <fenk@users.sourceforge.net>
+
+ Bugfix for correctly replacing completed string in GNU Emacs when
+ selection a completion for bbdb-complete-name from the completions
+ buffer. This fixes the bug reported in
+ <hddac4kla8w.fsf@decibel.pvv.ntnu.no> by Svend Tollak Munk.
+
+2006-10-09 Robert Fenk <fenk@users.sourceforge.net>
+
+ Guard setting of mail-mode-header-syntax-table in
+ bbdb-define-all-aliases, as it has been removed in newer GNU Emacs
+ versions.
+
+2006-10-09 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed call to replace-in-string in bbdb-format-record-one-line-notes.
+
+2006-10-09 Robert Fenk <fenk@users.sourceforge.net>
+
+ Rewrote detection of records with vm-folder field in
+ bbdb/vm-set-auto-folder-alist.
+
+2006-10-09 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added decoding of the header returned by bbdb-extract-field-value.
+
+ This is nice if you have QP encoded stuff in there.
+
+ See the original message <874pw915df.fsf@stalin.home.catap.ru> on this.
+
+2006-05-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ Now the fallback "?" should also be used if no real name could be
+ extracted from the email address.
+
+2006-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-snarf-region): Bugfix where snarfing on a region only containing a
+ net caused an infinite loop. Also try to extract real name from the
+ email address if there was none in the snarf region.
+
+2006-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ Avoid vm-mail-internal if there was no subject since this might
+ circumvent other extensions using an defadvice around vm-mail. I cannot
+ recall the actuall msg-id or person reporting this.
+
+2006-05-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-format-record-one-line-notes): Remove line breaks and trim white
+ space for one line format. Also fixed some doc strings.
+
+2006-05-21 Ronan Waide <waider@waider.ie>
+
+ * fix references to CVS location (Thankyou sourceforge)
+
+2006-05-14 Ronan Waide <waider@waider.ie>
+
+ * lisp/bbdb-w3.el (bbdb-www): use ftp note as the default when www is
+ not present (Sam Steingold)
+
+2006-03-29 Ronan Waide <waider@waider.ie>
+
+ * set buffer coding system to bbdb-file-coding-system when writing the
+ BBDB (Hubert Chan)
+
+2006-02-08 Ronan Waide <waider@waider.ie>
+
+ * do a full path check for emacs/xemacs, otherwise test -x won't work.
+
+2006-02-08 Ronan Waide <waider@waider.ie>
+
+ * add lbdb2bbdb link, plus mild warning at the top of the page.
+
+2006-01-30 Ronan Waide <waider@waider.ie>
+
+ * inverted condition check. Doh.
+
+2006-01-29 Ronan Waide <waider@waider.ie>
+
+ * misunderstood use of 2>&1 in conjunction with message. More hate.
+
+2006-01-29 Ronan Waide <waider@waider.ie>
+
+ * I hate autoconf. Make sure that --disable-vm doesn't accidentally
+ trigger checks for the availability of vm... (also other MTAs)
+
+2006-01-29 Ronan Waide <waider@waider.ie>
+
+ * check if the provided/found emacs program is executable
+
+2006-01-07 Ronan Waide <waider@waider.ie>
+
+ Use all-completions instead of try-completion (Chris Mears)
+
+2005-09-06 Ronan Waide <waider@waider.ie>
+
+ * minor additions to cleanup
+
+2005-09-06 Ronan Waide <waider@waider.ie>
+
+ * add loadpath.el and autom4te.cache
+
+2005-09-06 Ronan Waide <waider@waider.ie>
+
+ * make use of some of the configure mods
+
+2005-09-06 Ronan Waide <waider@waider.ie>
+
+ * move some of the auxilliary package detection and the load-path
+ build in here
+ * check value of VMDIR before trying to build with it
+
+2005-09-06 Ronan Waide <waider@waider.ie>
+
+ * clean up some compiler warnings again
+
+2005-09-05 Ronan Waide <waider@waider.ie>
+
+ * if there's a space in EMACS_PROG, quote the whole string.
+
+2005-09-05 Ronan Waide <waider@waider.ie>
+
+ * discard useless vector for bbdb/rmail-get-header-content
+ * marginally better bbdb/rmail-update-records-mode
+ * add bbdb/rmail-new-flag, which almost works
+
+2005-08-28 Ronan Waide <waider@waider.ie>
+
+ * try and match the VM/Gnus method of updating. Not quite there yet.
+
+2005-08-28 Ronan Waide <waider@waider.ie>
+
+ * move bbdb-extract-address-components-func to bbdb-com. Trying to clean
+ up
+ a circular dependency problem.
+
+2005-08-20 Ronan Waide <waider@waider.ie>
+
+ * a few updates. I really should keep this more up-to-date, though.
+
+2005-08-11 Ronan Waide <waider@waider.ie>
+
+ * remove mule-utf-8 per Dave Love's suggestion
+
+2005-08-11 Ronan Waide <waider@waider.ie>
+
+ * fix the AC_ARG_ENABLE options so that --disable and --enable-foo=no
+ actually works.
+
+2005-08-11 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2005-08-11 Ronan Waide <waider@waider.ie>
+
+ * typo
+
+2005-08-11 Ronan Waide <waider@waider.ie>
+
+ * remove CVS Log tag
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ Fix prompt-for-creation stuff
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ * oops. overbraced.
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ * rewrite the coding cookie on save. This makes sure that the setting
+ of bbdb-file-coding-system is reflected in the file. I'm still not
+ sure that this coding system hacking about is a good idea OR
+ correct, however.
+
+2005-08-02 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Change GNUS to Gnus, assuming nobody cares for GNUS support anymore...
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ * fix docstring for bbdb-invoke-hook-for-value
+
+2005-08-02 Ronan Waide <waider@waider.ie>
+
+ * if bbdb/mail-auto-create-p is set to 'prompt (or a function that
+ returns
+ 'prompt) then prompt the user before creating the record.
+
+2005-07-23 Ronan Waide <waider@waider.ie>
+
+ * remove RCS keywords, replace with Id tag
+
+2005-07-23 Ronan Waide <waider@waider.ie>
+
+ * remove Log tag
+
+2005-07-23 Ronan Waide <waider@waider.ie>
+
+ * nuke RCS tags and replace with an Id tag
+
+2005-07-23 Ronan Waide <waider@waider.ie>
+
+ * sync with XEmacs CVS
+
+2005-07-23 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2005-05-22 Ronan Waide <waider@waider.ie>
+
+ * missed one of the pilotmanager entries
+
+2005-05-22 Ronan Waide <waider@waider.ie>
+
+ * update links for PilotManager
+
+2005-03-19 Ronan Waide <waider@waider.ie>
+
+ * coding system guessing for emacs 22 (Frederik Fouvry)
+
+2005-02-28 Ronan Waide <waider@waider.ie>
+
+ * bbdb/gnus-nnimap-folder-list-from-bbdb:
+ new function from Uwe Brauer
+
+2005-02-22 Ronan Waide <waider@waider.ie>
+
+ * get Gnus data from the raw article buffer (Nix/David Goldberg)
+
+2005-02-22 Ronan Waide <waider@waider.ie>
+
+ * include prefixes in bbdb-name-gubbish
+
+2005-02-13 Ronan Waide <waider@waider.ie>
+
+ * (Manual Record Addition):
+ * add pointer to bbdb-snarf
+
+2005-02-13 Ronan Waide <waider@waider.ie>
+
+ * added new file, with minor abuse to make it work with current BBDB
+
+2004-11-09 Ronan Waide <waider@waider.ie>
+
+ * bury completion buffer when completion is done
+
+2004-10-13 Ronan Waide <waider@waider.ie>
+
+ * Fix bbdb-print-omit-fields text
+ * Update copyright date
+
+2004-10-13 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2004-10-13 Ronan Waide <waider@waider.ie>
+
+ * Correct variable name in comment
+
+2004-10-13 Ronan Waide <waider@waider.ie>
+
+ * Don't open a new window for BBDB if there are no records to display
+
+2004-10-10 Alex Schroeder <kensanata@yahoo.com>
+
+ (Database Fields): New entry for the concept index: mail-alias
+ definition.
+ (Mail Sending Interfaces): New entry for the concept index: mail-alias
+ usage. New subheading: Mailing Lists and Mail Aliases.
+ (Known Bugs): New section on using M-x bbdb-submit-bug-report replacing
+ the old bug reporting section.
+
+2004-10-10 Alex Schroeder <kensanata@yahoo.com>
+
+ *** empty log message ***
+
+2004-08-16 Ronan Waide <waider@waider.ie>
+
+ * Copy in my old add-or-update-phone function. This may actually still
+ work and possibly even be of use to people.
+
+2004-06-07 Ronan Waide <waider@waider.ie>
+
+ * Updates from Frank J. Christophersen <FJC@control.ee.ethz.ch>
+
+2004-05-28 Robert Fenk <fenk@users.sourceforge.net>
+
+ lisp/bbdb.el (bbdb-record-set-net): added a hack to detect that
+ aliases require rebuilding. lisp/bbdb.el (bbdb-mode-map): added
+ del/space binding for scrolling.
+
+2004-05-22 Ronan Waide <waider@waider.ie>
+
+ Update CVS hostname
+
+2004-04-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2004-03-22 Ronan Waide <waider@waider.ie>
+
+ Propagate bbdb-digit change
+
+2004-03-22 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2004-03-22 Ronan Waide <waider@waider.ie>
+
+ * Minor docstring fix (Stefan Monnier)
+ * Catch error if attempting to kill only window in frame (Stefan
+ Monnier)
+
+2004-03-22 Ronan Waide <waider@waider.ie>
+
+ Namespace pollution fix (digit => bbdb-digit) (Stefan Monnier)
+
+2004-03-22 Ronan Waide <waider@waider.ie>
+
+ * restore auto-create behaviour (Robert Widhopf-Fenk)
+
+2004-03-22 Ronan Waide <waider@waider.ie>
+
+ * Bugfix for bug caused by previous patch (Robert Widhopf-Fenk)
+ * Additions to alias generation (Robert Widhopf-Fenk)
+
+2004-02-01 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2004-02-01 Ronan Waide <waider@waider.ie>
+
+ (bbdb-merge-interactively): If the specified value of 'nets' isn't a
+ list, make it so.
+
+2004-01-23 Ronan Waide <waider@waider.ie>
+
+ Handle surnames with prefixes (Adrian Lanz <lanz@fowi.ethz.ch>)
+
+2003-12-12 Ronan Waide <waider@waider.ie>
+
+ Redoing last fix, since some other changes slipped in accidentally
+
+2003-10-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-10-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb.el
+ (bbdb-annotate-message-sender): Honor create-p when creating new
+ records
+ if a similar record already exists.
+ * lisp/bbdb-com.el
+ (bbdb-edit-current-field): Handle field detection gracefully at
+ line-end of
+ one-line display. (reported by Dan Jacobson)
+ (bbdb-help): Added colons to separate help items and thus avoid
+ confusion
+ (reported by Dan Jacobson)
+ (bbdb-prompt-for-create): Slightly changed the semantics of the
+ returned
+ value to honor create-p.
+ (bbdb-annotate-message-sender): Honor create-p for creating new records
+ if a
+ similar record already exists.
+
+2003-10-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-split-method): Honor Resent-* headers if present. (Reported
+ by Thomas Gerds)
+
+2003-08-11 Ronan Waide <waider@waider.ie>
+
+ One more tiny fix from Jochen
+
+2003-08-08 Ronan Waide <waider@waider.ie>
+
+ More fixes from Jochen
+
+2003-08-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-08-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-dwim-net-address-allow-redundancy):
+ (bbdb-dwim-net-address): *shurg* added 'netonly thus allowing to
+ have no real-names being shown for expanded aliases and completed
+ names.
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ Patch from Jochen Küpper <bbdb@jochen-kuepper.de>:
+ - No error if mailcrypt isn't available.
+ - (bbdb/pgp-quiet): Added.
+ - (bbdb/pgp-hook-fun): Be quite if bbdb/pgp-quiet is set.
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ * bbdb-default-area-code: fix customize hook to recognize integers
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ * Rewrite doco for bbdb-electric-p to make it a little clearer.
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ * Use GREP and GREPCONTEXT autoconfs
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ * Added a check for grep, and a test to figure out grep's context
+ argument
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ * Added a record to test completion stuff
+
+2003-08-05 Ronan Waide <waider@waider.ie>
+
+ * Updated to reflect small change in completion logic
+
+2003-07-24 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-07-24 Robert Fenk <fenk@users.sourceforge.net>
+
+ Patch to support sending mail via gnus (from Scott Lawrence)
+
+2003-07-24 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-07-24 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-update-records): Ignore empty/broken
+ addresses, e.g. extraction on "foo@bar.baz<>" results in (nil nil)
+ which should be ignored. (reported by "Neil W. Van Dyke)
+
+2003-07-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-07-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-annotate-message-sender): Invoke the
+ prompt-to-create hook just if it has a value. (fixes MH not
+ honoring 'promt for bbdb/mail-auto-create-p)
+
+2003-07-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-07-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-force-record-create): A fix for the mhe-mode case (from Vladimir
+ G. Ivanovic)
+
+2003-06-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-06-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-user-menu-commands): Is defcustom now instead of defvar.
+ (build-bbdb-menu): If bbdb-user-menu-commands is a functionp we
+ call it in order to get a menu.
+
+2003-06-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-pop-up-bbdb-buffer): Some fixes for special
+ cases of the multiple *BBDB* buffers hack.
+
+2003-06-09 Ronan Waide <waider@waider.ie>
+
+ use fboundp, not boundp, to check highlight-headers-x-face
+
+2003-05-19 Ronan Waide <waider@waider.ie>
+
+ * Fix bug in bbdb-default-area-code :type section
+
+2003-04-09 Ronan Waide <waider@waider.ie>
+
+ Whoops. Last one was an erroneus commit. This is Dave Love's patch
+
+2003-04-09 Ronan Waide <waider@waider.ie>
+
+ Dave Love patch
+
+2003-04-02 Robert Fenk <fenk@users.sourceforge.net>
+
+ Did a rollback of the changes related to replacing
+ with-output-to-temp-buffer. We use it now again and treat it as a Emacs
+ bug.
+
+2003-03-28 Ronan Waide <waider@waider.ie>
+
+ Remove references to Info-directory, since it's no longer valid
+
+2003-03-28 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2003-03-28 Ronan Waide <waider@waider.ie>
+
+ Call bbdb-complete-name-hooks after name completion
+
+2003-03-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ This is the real fix for broken mail-abbrev-expansion.
+
+2003-03-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-03-15 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-03-15 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-records-1): erase buffer when
+ appending, since we are redisplaying the records, not just one.
+ (bbdb-multiple-buffers-default): Default/example function for *BBDB*
+ buffer name generation.
+ (bbdb-pop-up-bbdb-buffer): code move to bbdb-multiple-buffers-default
+
+2003-03-15 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed extra parens, did not see the error during compilation. ;/
+ Thanks David S. G. ;c)
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ Also recognize vm-mode for bbdb-multiple-buffers.
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ Droped support for GNUS versions <= 3.14
+
+ Files: lisp/bbdb-gnus.el
+ lisp/bbdb-hooks.el
+ lisp/bbdb.el
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ Files: ChangeLog
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-frob-mode-line): show the BBDB buffer name.
+ (bbdb-display-records-1): removed call to bbdb-pop-up-bbdb-buffer to
+ avoid problems with special-display-*, still we are not back to the old
+ behavior, i.e. if calling BBDB from an frame without *BBDB* buffer while
+ other frames are displaying it we will not get it on the current frame,
+ but that is how it used to be.
+ (bbdb-multiple-buffers): Yet another new variable. Enables the creation
+ of multiple *BBDB* buffers.
+ (bbdb-pop-up-bbdb-buffer): if bbdb-multiple-buffers is enabled created
+ new *BBDB: <BUFNAME>* buffer and set it up correctly.
+
+ Files: lisp/bbdb.el
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-header-start): There is no gnus-subject-mode, its called
+ gnus-summary-mode.
+
+ Files: lisp/bbdb-hooks.el
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-summary-show-all-recipients): Throwing away old code and use
+ bbdb/gnus-update-records now.
+ (bbdb/gnus-update-records): Do not toggle headers to gain access to the
+ hidden headers, since gnus-fetch-field is doing this for us.
+
+ Files: lisp/bbdb-gnus.el
+
+2003-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ Files: ChangeLog
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-records-1): call bbdb-pop-up-buffer to ensure we get a
+ buffer in the current frame.
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-update-records): use gnus-fetch-field instead of
+ mail-fetch-field. Fixes problems reported by Klaus Zeitler.
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-records-1): Do not use the function
+ with-output-to-temp-buffer since on recent GNU Emacses the local
+ variables get killed.
+ (bbdb-encache-message): Fix from Dan Debertin to avoid caching of
+ nil, i.e. empty record list, causing problems later.
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-set-auto-folder-alist): added missing
+ local vars to avoid cluttering global namespace.CVS:
+ ----------------------------------------------------------------------
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/mh-update-record): Do a sanity check
+ to avoid adding a nil record to the cache causing trouble
+ afterwards.
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-snarf-extract-label): added safety check
+ for backward movement.
+ (bbdb-snarf-region): Added label completion for phones and
+ addresses.CVS:
+ ----------------------------------------------------------------------
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-delete-current-record): fixed docs and
+ bbdb-apply-next-command-to-all-records handling. Removed ".el" from VM
+ loads to allow Emacs
+ also loading .elc files if they are present.
+ (bbdb-edit-current-field): mark mail-aliases for rebuilt when we are
+ editing the aliases field of a record.
+ (bbdb-add-or-remove-mail-alias): mark mail-aliases for rebuilt
+ when creating new records or deleting a record.
+ (bbdb-prompt-for-create): delete help window when it is not needed
+ anymore.
+
+2003-03-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2003-01-31 Alex Schroeder <kensanata@yahoo.com>
+
+ (bbdb-mode): Tiny change to the doc string by David S Goldberg
+ <david.goldberg6@verizon.net>.
+
+2003-01-31 Alex Schroeder <kensanata@yahoo.com>
+
+ (bbdb-resort-database): Make interactive.
+
+2003-01-31 Alex Schroeder <kensanata@yahoo.com>
+
+ *** empty log message ***
+
+2003-01-30 Ronan Waide <waider@waider.ie>
+
+ mapc->bbdb-mapc. Thanks to Greg Troxel.
+
+2003-01-30 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2003-01-02 Ronan Waide <waider@waider.ie>
+
+ (bbdb-complete-name) Fix for the fix.
+
+2003-01-02 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2003-01-02 Ronan Waide <waider@waider.ie>
+
+ * lisp/bbdb-com.el (bbdb-complete-name):
+ Fix completion in the case of multiple addresses matching from a
+ single record. Basically behaves as if you'd matched on the
+ primary name.
+
+2002-12-25 Alex Schroeder <kensanata@yahoo.com>
+
+ *** empty log message ***
+
+2002-12-25 Alex Schroeder <kensanata@yahoo.com>
+
+ (bbdb-phones-label-list): Doc.
+ (bbdb-addresses-label-list): Doc.
+ (bbdb-label-completion-list): Doc.
+ (bbdb-label-completion-default): Doc.
+ (bbdb-data-completion-list): Doc.
+ (bbdb-data-completion-default): Doc.
+
+2002-12-24 Alex Schroeder <kensanata@yahoo.com>
+
+ *** empty log message ***
+
+2002-12-24 Alex Schroeder <kensanata@yahoo.com>
+
+ (bbdb-complete-name): Handle the case where the only exact match does
+ not have a net field, instead of looping forever.
+
+2002-12-24 Alex Schroeder <kensanata@yahoo.com>
+
+ *** empty log message ***
+
+2002-12-24 Alex Schroeder <kensanata@yahoo.com>
+
+ (bbdb-display-layout-alist): Extended custom type to include primary and
+ test, and fixed phone to phones, and address to addresses.
+ (bbdb-format-record-layout-one-line): Take primary into account.
+ (bbdb-format-record-layout-multi-line): Take primary into account.
+ (bbdb-format-record): Take test into account, use multi-line layout
+ function if none was found.
+
+2002-12-24 Alex Schroeder <kensanata@yahoo.com>
+
+ (bbdb-display-record-with-layout): New.
+ (bbdb-toggle-all-records-display-layout): Print layout used.
+
+2002-11-02 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-10-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-10-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-set-auto-folder-alist): Some fixes for
+ the generation of vm-auto-folder-alist when using a function as
+ folder name.
+
+2002-10-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-layout):
+ (bbdb-pop-up-display-layout): Fixed a toggling bug reported by
+ Patrick Campbell-Preston.
+ (bbdb-display-layout-alist): Fixed docs and added layout
+ pop-up-multi-line to the list of layouts.
+
+2002-10-20 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-10-18 Ronan Waide <waider@waider.ie>
+
+ allows bbdb-pgp.el to be configured to use message.el MML tags to
+ perform the signing and encryption, instead of only plain Mailcrypt
+ which is not MIME-aware. (Michael Shields)
+
+2002-09-17 Ronan Waide <waider@waider.ie>
+
+ Treat bbdb-canonicalize-net-hook as an actual hook. Some prompting &
+ code from Micha Wiedenmann. NB documentation not yet updated.
+
+2002-09-17 Ronan Waide <waider@waider.ie>
+
+ Added dircategory (Jochen Küpper)
+
+2002-08-19 Ronan Waide <waider@waider.ie>
+
+ Jim Blandy: bugfix in bbdb-complete-name
+
+2002-08-19 Ronan Waide <waider@waider.ie>
+
+ Jim Blandy's fix for migrating notes.
+
+2002-08-14 Ronan Waide <waider@waider.ie>
+
+ Patch from Simon Josefsson to correct a typo & a custom error
+
+2002-07-08 Ronan Waide <waider@waider.ie>
+
+ Defanged a commented-out line with a redirection in it.
+
+2002-07-03 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-07-03 Ronan Waide <waider@waider.ie>
+
+ Remove comment about bbdb-complete-name-allow-cycling not working in
+ GNUmacs.
+
+2002-07-03 Ronan Waide <waider@waider.ie>
+
+ Fix from Eli Tziperman to fix expunging
+
+2002-06-30 Ronan Waide <waider@waider.ie>
+
+ Cleaner version of ignoring the testing directory if it's not there.
+
+2002-06-30 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-06-30 Ronan Waide <waider@waider.ie>
+
+ (bbdb-read-new-ftp-site-record): Parse URL or ange-ftp style
+ names
+ for username and directory.
+
+2002-06-30 Ronan Waide <waider@waider.ie>
+
+ Don't try to finger if there are no addresses
+
+2002-06-29 Ronan Waide <waider@waider.ie>
+
+ Colin Rafferty contribution.
+
+2002-06-29 Ronan Waide <waider@waider.ie>
+
+ Allow '.' as a separator in phone numbers (Howard Melman)
+
+2002-06-29 Ronan Waide <waider@waider.ie>
+
+ Don't escape '.' in [] (Howard Melman)
+
+2002-06-29 Ronan Waide <waider@waider.ie>
+
+ Don't configure the testing directory if it doesn't exist.
+
+2002-06-28 Robert Fenk <fenk@users.sourceforge.net>
+
+ From: Andre Srinivasan <andre@slamdunknetworks.com> Organization: Slam
+ Dunk Networks To: bbdb-info@lists.sourceforge.net Date: 6 Jun 2002
+ 17:06:47 -0700 Subject: Minor bug fix to bbdb-define-all-aliases
+
+ Added a downcase as fix.
+
+2002-06-28 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-05-12 Ronan Waide <waider@waider.ie>
+
+ Dave Love's big patch. See ChangeLog for full details.
+
+2002-04-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-04-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-play-sound): argument NUM is integer now, i.e. before it was not
+ correct, since (char-int ?0) is 49 and not 0. ;/
+ (bbdb-sound-player): If set use this programm, otherwise try
+ native sound support.
+ (bbdb-dial-number): Calculate the right integer, i.e. do not use
+ char-int.
+
+2002-04-18 Ronan Waide <waider@waider.ie>
+
+ Require cl, because we can't guarantee it'll be loaded.
+
+2002-04-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-04-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (build-bbdb-insert-field-menu): Added record to
+ the arguments for bbdb-insert-new-field.
+
+ Bug report: From: Joerg Jaspert
+ <joerg+Mailinglisten.Emacs.BBDB@german.ath.cx> Organization: Goliath-BBS
+ To: bbdb-info@lists.sourceforge.net Date: Thu, 18 Apr 2002 18:23:17
+ +0200 Subject: Cant insert any field using the Mouse
+
+2002-04-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-04-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-read-new-record): Added completion for labels.
+
+2002-04-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ lisp/bbdb-vm.el (bbdb/vm-show-all-recipients), (bbdb/vm-show-sender),
+ lisp/bbdb-gnus.el (bbdb/gnus-show-sender),
+ (bbdb/gnus-show-all-recipients):
+ Fixed */show-all-reciepients to always do what it should do!
+
+ BUGFIX FOR the following report:
+
+ From: Gerd Boerrigter <gerd.boerrigter@gmx.net> To:
+ bbdb-info@lists.sourceforge.net Date: Thu, 18 Apr 2002 10:59:50 +0200
+ Subject: bbdb/gnus-show-all-recipients only uses first entry
+
+2002-04-03 Ronan Waide <waider@waider.ie>
+
+ Nasty hack to get around string-match tripping over things that look
+ like regexps in bbdb-merge-strings
+
+2002-04-01 Ronan Waide <waider@waider.ie>
+
+ highlight-headers-hack-x-face-p is a variable, not a function (Jeff
+ Miller)
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ Add a few more VM-related notes.
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ Remove fontifying messages, since they're not around long enough to be
+ read and only serve to obliterate other messages.
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ Added testing/Makefile
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ Needed by makefile
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ Rewrote bbdb-dial documentation Updated copyright and version notices
+
+2002-03-20 Ronan Waide <waider@waider.ie>
+
+ Added Testing for dial functions Added Makefile.in
+
+2002-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-redisplay-one-record): Care for the case when a record is
+ not present any more in the BBDB buffer.
+ (bbdb-insert-new-field): get the current records before doing
+ anything else to ensure that we do not lose the context.
+
+2002-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-03-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name): Create a popup buffer before displaying records in
+ order
+ to make sure it has the right size & position .
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-test/switch-to-test-db): Restore old BBDB after exiting recusive
+ edit.
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ use the function
+ buffer-substring-no-properties instead of buffer-substring
+ to ensure that we do not add some garbage into BBDB.
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ removed defuns for bbdb-orig-rmail-expunge
+ and bbdb-orig-undigestify-rmail-message since they seem to cause
+ problems and are not required.
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name): fixed completion bug for case where name and
+ primary net
+ are identical.
+
+2002-03-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ 2002-03-12 Robert Fenk <Robert.Fenk@gmx.de>
+
+ * bbdb-test.el (bbdb-test/switch-to-test-bbdb): Fixed bugs.
+ (bbdb-test/bbdb-completion-type): Added "First Last" case to
+ name-or-primary (reported by ET <eli@beach.weizmann.ac.il>)
+
+2002-03-11 Ronan Waide <waider@waider.ie>
+
+ Documentation fix
+
+2002-03-11 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-03-11 Ronan Waide <waider@waider.ie>
+
+ Only invoke bbdb-notice-hook if we actually noticed something
+
+2002-03-03 Ronan Waide <waider@waider.ie>
+
+ Change warning message to reflect the fact that it's /message/ that
+ can't be found, not Gnus.
+
+2002-03-03 Ronan Waide <waider@waider.ie>
+
+ Use gnus-original-article-buffer instead of gnus-article-buffer
+
+2002-03-03 Ronan Waide <waider@waider.ie>
+
+ (bbdb-dial-number):
+ memq takes two args, not three! prologue:
+ add autoload for bbdb-fontify-buffer
+
+2002-03-03 Ronan Waide <waider@waider.ie>
+
+ * lisp/bbdb-com.el (bbdb dialing stuff):
+ Documentation fixes.
+ (bbdb-dial-number):
+ According to what docs I can find, it's quite okay to pass * and #
+ to a modem as part of a dial string
+ (bbdb-next-event):
+ Made work on emacs (using read-event instead of next-event)
+ (bbdb-play-sound):
+ New function: plays a sound using internal feature, if available,
+ otherwise it falls back to an external sound player.
+ (bbdb-dial-local-prefix-alist):
+ Fix default mapping to allow a string or an integer for default
+ area code.
+ * lisp/bbdb-com.el (bbdb-search-invert-set):
+ Documentation fix
+
+2002-02-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-02-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-format-address-default):
+ (bbdb-format-address-continental): do not ouput the label. This
+ is done by `bbdb-format-record-layout-multi-line'
+
+ (bbdb-format-record-layout-multi-line): Fixed buggy setting of
+ text-property for 'bbdb-field for addresses amd phones.
+
+2002-02-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ Variable renaming.
+
+2002-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-format-record-layout-multi-line):
+ (bbdb-format-record-layout-one-line): Set text-property bbdb-field with
+ element 'field-name for labels of phones and addresses.
+
+2002-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-set-auto-folder-alist): Fixed some comments and creation of
+ vm-auto-folder-alist to match headers in the order of
+ (bbdb/vm-set-auto-folder-alist-headers): a new variable.
+
+2002-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-fontify-buffer): Use test properties also for name, company and
+ labels
+ of phones and addresses. Highlight them also in one-line layout.
+
+2002-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-address-edit-continental): Asking for the ZIP code before the city
+ and
+ do not ask for a state.
+ (bbdb-redisplay-one-record): Remove
+ text-property bbdb-field before redisplaying to avoid extending the
+ new properties. Remove bbdb-field text-properties before redisplaying.
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-define-all-aliases): Fixed warning message for records
+ without net, but with alias field.
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/sc-consult-attr): Fixed to really use
+ recipient when logged in user sent this.
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-fontify-buffer): Fixed fontification to
+ use text-properties (bbdb-field) rather than regexps, which fixes
+ indentations problems with non standard indentation.
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-layout-alist): Fixed the docs, typos and default values.
+
+2002-01-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-phones): Prompt indicates inverted search now.
+ (bbdb-update-records): No useless "Updating of BBDB records
+ finished" message any more.
+
+2002-01-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ Avoid compiler warning on bbdb-append-records-p.
+
+2002-01-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-delete-current-record): honor the bbdb-do-all-records-p!
+
+2002-01-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb): Reflect inverted search in search prompt.
+ (bbdb-search-invert): New variable.
+ (bbdb-search-invert-p): New function.
+ (bbdb-search-invert-set): New function.
+ (bbdb-search): Use bbdb-search-invert-p to maybe invert the search
+ result.
+
+2002-01-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-mode-map): Bind bbdb-search-invert-set to "!"
+
+2002-01-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed placement of point when deleting a record.
+
+2002-01-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ In Gnus go to the original article buffer for fetching headers.
+
+2002-01-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fixed bug in efficient redisplay of one record
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Patch from
+
+ From: "Jochen Küpper" <jochen@unc.edu> Date: 18 Jan 2002 10:57:17 -0500
+ Subject: configure.ac
+
+ There is a mismatch between default rmail support in
+ './configure--help' and actual happenings. I removed the line to build
+ rmail on default and also fixed some slight display problems for default
+ options.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Some enhancements for convenient testing.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed the old elide stuff docs. Added some new docs. STILL MISSING:
+ *display-layout* docs.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed the old elide code stuff.
+ (bbdb-display-records-1): see bbdb-fontify-buffer.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-fontify-buffer): is now more efficent
+ when redisplaying records. button2 work now again as intended.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-fontify-buffer): is now more efficent
+ (bbdb-append-records): (prefix) command (like "*") bound
+ to "+" which forces the display/search command to add its content to
+ the BBDB buffer rather than replacing it.
+ Appending can be once, always or a given number of times.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Fix for fontification of records without a name. Submitted by "Rooke,
+ Philip" <Philip.Rooke@cmck.com>
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-redisplay-one-record): Try to preserve the position during
+ redisplay.
+ (bbdb-add-next-search-results):
+ (bbdb-add-next-search-results-p):
+ (bbdb-add-next-search-results): A prefix command (like "*") bound
+ to "+" which forces the next display command to add its content to
+ the BBDB buffer rather than replacing it.
+ (bbdb-completion-check-record): removed the dependency on
+ `bbdb-case-fold-search' since completions from the bbdb-hashtable
+ are always lower case.
+ (bbdb-complete-name): fixed cycling when the
+ current completion is equal to one of the nets.
+ Added code for C-u M-TAB which lists all possible nets of current
+ completed addess. Fixed some special cases by rewriting some
+ "complex" parts of the code.
+ I personally want to thank the new testing code, here
+ When will this function finnaly do exactly what it should do?
+ (bbdb-define-all-aliases-mode): new variable controling special
+ aliases, i.e. alias<NUMBER> & alias*.
+ (bbdb-define-all-aliases): (XEmacs only sofar) Clear abbrev-table
+ before defining abbreves and honor new aliases-mode.
+ Automatice rebuilt of aliases if necessary.
+ (bbdb-add-or-remove-mail-alias): after adding or removing an
+ alias, set a flag for rebuilting..
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-records-1): enable appending of records.
+ (bbdb-search-intertwingle): Search also for records when no name
+ was given, but just a net.
+ (bbdb-mode-map): bbdb-add-next-search-results bound to +
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-extract-address-component-regexps): Fixed regexp.
+ (bbdb-rfc822-addresses): Fixed autoload string.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ removed binding of unused variabe `error'.
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-test/switch-to-test-bbdb): use a own known
+ version of a DB for testing, since then we know what to expect
+ as result.
+ (bbdb-test/run-all): Checks now also for the docstring of the var,
+ so we may have testing vars which do not interfere with other
+ vars used in bbdb-test.el.
+ (bbdb-test/run-one-test): Fixed frob* stuff to be more save by
+ using a macros for binding in a let statement. When running tests
+ this avoids having spoiled the global variables, i.e. after
+ running a test the var does not have its original value, but the
+ last test value. Additionally test functions may get more
+ arguments, see bbdb-test/bbdb-complete-name, or even none.
+ (bbdb-test/bbdb-complete-name): Added test for the output (common
+ prefix) + completion list.
+ Get the completions by flet bbdb-display-completion-list, which is
+ saver than grabbing them from the buffer.
+ (bbdb-test/bbdb-completion-type): Added more tests + completion
+ list tests.
+ !! Tests are desinged for the BBDB in the testing dir.!!
+
+2002-01-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ BBDB used for the tests in bbd-test.el
+
+2002-01-18 Ronan Waide <waider@waider.ie>
+
+ Fix autoload
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ BBDB-2.35 - Let the games begin.
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ Updated manual for 2.34
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ 2.34 release changes
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ 2.34 Release. Whee!
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ New file
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ Merged in some changes from the mailing list. Note, this is still
+ experimental.
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ Don't fset things that aren't ours Last of compiler warning cleanup
+ Fixed one more completion bug
+
+2002-01-15 Ronan Waide <waider@waider.ie>
+
+ Ignore 'testing' directory when making tarball
+
+2002-01-14 Ronan Waide <waider@waider.ie>
+
+ Conditionalise the rmail load
+
+2002-01-14 Ronan Waide <waider@waider.ie>
+
+ Make X/Emacs compatibility less intrusive
+
+2002-01-13 Ronan Waide <waider@waider.ie>
+
+ Don't force VM on people, even if it is a great mailer...
+
+2002-01-10 Ronan Waide <waider@waider.ie>
+
+ Last few fixes (hopefully) to completion
+
+2002-01-10 Ronan Waide <waider@waider.ie>
+
+ Make bbdb-rfc822-addresses the default address parser Remove
+ test-harness code to elsewhere (i.e. not in user code!)
+
+2002-01-10 Ronan Waide <waider@waider.ie>
+
+ Changed the workaround for set-keymap-prompt, as it seemed to be
+ clashing with VM. Ideally, all this Emacs/XEmacs stuff should go in a
+ separate file, or at least all in one part of bbdb.el.
+
+2002-01-06 Ronan Waide <waider@waider.ie>
+
+ Edits from Karl Fogel (see Changelog)
+
+2002-01-06 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2002-01-06 Ronan Waide <waider@waider.ie>
+
+ Compiler cleanup
+
+2002-01-06 Ronan Waide <waider@waider.ie>
+
+ Put the 'custom' hacks in bbdb-autoloads Less noise while building
+
+2002-01-06 Ronan Waide <waider@waider.ie>
+
+ Compiler cleanup
+
+2002-01-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2002-01-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-extract-address-component-regexps):
+ Replaced the call of bbdb-clean-username by a call to
+ mail-extract-address-components in order to handle addresses of
+ the form "Lastname, Fistname" and "Firstnam Lastname, Jr" in the
+ right way.
+ (bbdb-test/bbdb-extract-address-components): New test function to
+ check if everything is working as it should.
+
+2002-01-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed the faulty ;; swap Lastname, Firstname introdice by the last
+ commit.
+
+2002-01-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ bbdb-complete-name): fixed cycling when the
+ current completion is equal to one of the nets.
+ Added code for C-u M-TAB which lists all possible nets of current
+ completed addess. (code was lost during rewrite)
+
+2002-01-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-clean-username): Swap last/first name if written as "Lastname,
+ Fistname".
+
+2002-01-03 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name): fixed cycling for nets differing only in
+ upper/lower case.
+ The call to (member ...) fails if the current net (which is downcased)
+ has upper case in the list of the nets of the record.
+
+2002-01-01 Ronan Waide <waider@waider.ie>
+
+ Fixed two bugs in completion
+
+2001-12-27 Ronan Waide <waider@waider.ie>
+
+ Allow mew as an option for sending mail Fix small bug in cycling code
+ bbdb-completing-read-one-record handles no selection correctly
+
+2001-12-27 Ronan Waide <waider@waider.ie>
+
+ Add MEW as an option for bbdb-send-mail-style
+
+2001-12-27 Ronan Waide <waider@waider.ie>
+
+ Now compiles cleanly (under GNU Emacs, at least)
+
+2001-12-27 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-12-26 Ronan Waide <waider@waider.ie>
+
+ bbdb-complete-name: Mostly rewritten. New version is more consistent
+ about completions, smaller, and more commented.
+
+2001-12-26 Ronan Waide <waider@waider.ie>
+
+ New function. More stringent version of bbdb-search-simple, intended for
+ internal bbdb use only
+
+2001-12-12 Ronan Waide <waider@waider.ie>
+
+ Fix display of string-only notes (patch from list, name not handy,
+ sorry!) Change bbdb-canonicalize-nets-hook's type to :function (Adrian
+ Aichner)
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Sane defaults for autoconf stuff. See ChangeLog
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Documentation fix Move bbdb/vm-set-auto-folder-alist-field to
+ mua-specific custom group
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Allow '+' in mail addresses Catch unparseable addresses in
+ bbdb-rfc822-addresses
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Added link to bbdb-expire
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Documentation fixes Dead Code removal
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Patch from Alex Schroeder autoload mode maps from message & sendmail
+
+2001-11-19 Ronan Waide <waider@waider.ie>
+
+ Patch from Alex Schroeder
+
+2001-11-08 Ronan Waide <waider@waider.ie>
+
+ Trying to fix multiple-match completion behaviour
+
+2001-10-14 Ronan Waide <waider@waider.ie>
+
+ (bbdb/gnus-pop-up-bbdb-buffer): Move the call to bbdb-display-records
+ back inside the (when...) I had two bug reports for this (Sudesh Joseph
+ and Michael Totschnig).
+
+2001-10-14 Ronan Waide <waider@waider.ie>
+
+ Added Nix's patch to make inside-bbdb-notice-hook work as
+ advertised, also other bbdb-expire support.
+ (bbdb-search-simple):
+ Try company name if record name is unset, before falling back to
+ "". (Martin Schwenke)
+
+2001-10-14 Ronan Waide <waider@waider.ie>
+
+ (bbdb-complete-name): Restored the original code to handle making sure
+ primary addresses get picked first, since the code I'd replaced it with
+ had some dubious side-effects.
+
+ (bbdb-create-internal): Documentation fix. (Ueli Schläpfer)
+
+2001-10-06 Ronan Waide <waider@waider.ie>
+
+ Forgot to remove a debugging (error...) statement
+
+2001-09-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-09-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-create-hook), (bbdb-notice-hook):
+ Added a note that hook functions might use the new variables
+ bbdb-update-address-class and bbdb-update-address-header to obtain
+ information about the currently processed email address.
+
+2001-09-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-auto-notes-alist): Additional element
+ type to allow actions also on recipients of an message
+ (bbdb-auto-notes-hook): Fixed to perfom auto-note actions only for
+ authors of a message. Support for new features of
+ bbdb-auto-notes-alist. Honor bbdb-silent-running.
+
+2001-09-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-get-header-content): VM specific header
+ extraction function.
+ (bbdb/vm-update-records): bbdb-get-addresses instead of
+ bbdb/vm-get-addresses which was removed.
+ (bbdb/vm-show-all-recipients),
+ (bbdb/vm-show-sender), (bbdb/vm-show-records): modified to use new
+ style of bbdb-get-addresses-headers
+
+2001-09-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-update-records): uses
+ bbdb-get-addresses instead of bbdb/gnus-get-addresses which was
+ removed.
+ (bbdb/gnus-show-sender), (bbdb/gnus-show-all-recipients),
+ (bbdb/gnus-show-records): modified to use new style of
+ bbdb-get-addresses-headers
+
+2001-09-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-get-addresses-headers): merged
+ bbdb-get-addresses-from-headers and bbdb-get-addresses-to-headers
+ into this variable.
+ (bbdb-get-addresses): new generic function for extraction of email
+ addresses from header, which is used by Gnus and VM
+ (bbdb-update-address-class), (bbdb-update-address-header): new
+ variable providing additional information to hook functions about
+ the currently processed email address.
+
+2001-09-16 Ronan Waide <waider@waider.ie>
+
+ Fixed bogus fset (fsetting variable instead of 'variable)
+ (bbdb-hack-x-face):
+ use bbdb-find-face, not find-face
+
+2001-09-16 Ronan Waide <waider@waider.ie>
+
+ (bbdb-initialize):
+ Fixed vm entry. vm-load-hook no longer exists!
+ (bbdb-mode):
+ Removed references to bbdb-elide-record
+
+2001-09-11 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-09-11 Robert Fenk <fenk@users.sourceforge.net>
+
+ Appliend fixed according to change log
+
+2001-09-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-layout-alist): replaced by the nice version
+ provieded by Alex Schroeder <alex@gnu.org>
+ (bbdb-annotate-message-sender): calling of
+ bbdb-create-hook functions moved to the end of function
+
+2001-09-04 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-08-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-08-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-auto-notes-alist): applied posted patch of better customization.
+
+2001-08-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ replaced occureneces of bbdb-elided-display and
+ bbdb-pop-up-elided-display.
+
+2001-08-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (build-bbdb-menu): Fix menus to use new display
+ layout toggeling functions.
+
+2001-08-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-change-records-state-and-redisplay),
+ (bbdb-toggle-all-records-display-layout),
+ (bbdb-toggle-records-display-layout),
+ (bbdb-display-all-records-completely),
+ (bbdb-display-record-completely): modified functions for toggeling
+ the display layout of records. Old functions bbdb-elide-record
+ and bbdb-unelide-records have been removed.
+
+2001-08-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-display-layout-alist): variable controling options for
+ display layouts, support for user defines format functions still
+ missing.
+ (bbdb-display-layout): variable controling the default display layout
+ (bbdb-pop-up-display-layout): variable controling the default display
+ layout for pop-up buffers.
+ (bbdb-elided-display), (bbdb-pop-up-elided-display): are obsolete
+ variables now.
+ (bbdb-elided-display-sanity-setup): function which sets up the
+ layout variables from the obsolete bbdb-elided-display and
+ bbdb-pop-up-elided-display variables. Might be removed along with
+ the variables in the future.
+ (bbdb-format-record): rewitten to support multiple
+ layouts according to bbdb-display-layout-alist
+ (bbdb-format-record-layout-multi-line),
+ (bbdb-format-record-layout-one-line),
+ (bbdb-format-record-one-line-*): Function specific to certain
+ layouts.
+
+2001-08-22 Ronan Waide <waider@waider.ie>
+
+ Added .tar.gz to .cvsignore Added a whole bunch of stuff to the FAQ
+
+2001-08-14 Ronan Waide <waider@waider.ie>
+
+ Fix for bbdb-hack-x-face
+
+2001-08-03 Ronan Waide <waider@waider.ie>
+
+ Clean up some compiler stuff. Remove the things that are defined in cl,
+ and load cl instead.
+
+2001-08-03 Ronan Waide <waider@waider.ie>
+
+ Make BBDB respect the order of your net: fields, so that you get the
+ first completion on the line.
+
+2001-08-03 Ronan Waide <waider@waider.ie>
+
+ Allow bbdb-rfc822-addresses to take an optional parameter, so it should
+ now work precisely as I'd originally intended.
+
+2001-08-03 Ronan Waide <waider@waider.ie>
+
+ Fixes to make bbdb/srv-add-phone more useful.
+
+2001-08-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-08-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-unelide-record),
+ (bbdb-elide-record-internal): Modified for more convenient
+ toggeling of the omitted display mode.
+
+2001-07-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-07-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-elide-all-records): New function for the BBDB menu
+ (bbdb-unelide-record): New function for showing fileds hidden by
+ `bbdb-display-omit-fields'
+ (bbdb-record-edit-field-internal): Added location arg and company
+ field.
+ (bbdb-current-field): Simpified it ti use text-properties for
+ field recognition
+ (bbdb-record-edit-company): New function for editing the records
+ company
+ (bbdb-record-edit-address): Fixed the docs
+ (bbdb-record-edit-phone): Added optional location arg
+ (bbdb-prompt-for-create): Use characters instead of integers for
+ the key-presses and avoid calling char-int.
+
+2001-07-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-field-shown-p): Changed the defsubst to a defun.
+ (bbdb-format-record-elided), (bbdb-format-record-full): Replace
+ bbdb-format-record. They add text-properties to the fields in
+ order to know fields for editing.
+ (bbdb-display-omit-fields): New variable which is a list fields
+ omitted during full display of a record.
+ (bbdb-display-fields-order): New variable specifying to order of
+ fields for during full display of a record.
+ (bbdb-format-elided-phones), (bbdb-format-elided-net): Formating
+ functions for elided display.
+
+2001-07-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ (build-bbdb-menu): Added an "(Un)Elide All
+ Records entry" and content of variable
+ `global-bbdb-menu-commands'
+ moved into the defun.
+ (bbdb-user-menu-commands): New variable with user menu commands
+ appended to default menu.
+ (build-bbdb-menu): Add extra menu entry for displaying all fields
+ when `bbdb-display-omit-fields' is set.
+ (bbdb-menu): Added detection of fields for menu commands.
+
+2001-07-09 Ronan Waide <waider@waider.ie>
+
+ I'm sorry, and I'll not rag on folk again for breaking one Emacs or the
+ other. Well, until next time.
+
+2001-07-08 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-07-08 Ronan Waide <waider@waider.ie>
+
+ More work on the completion-of-labels stuff. NB I've changed some
+ variable names. Sorry if you actually used this already, but hey.
+ Bleeding edge.
+
+2001-07-08 Ronan Waide <waider@waider.ie>
+
+ More work on the completion-of-labels stuff. NB I've changed some
+ variable names. Sorry if you actually used this already, but hey.
+ Bleeding edge.
+
+2001-07-08 Ronan Waide <waider@waider.ie>
+
+ Made quieter, so it's easier to see compilation problems Fixed
+ gnuserv/bbdb-srv build
+
+2001-07-07 Ronan Waide <waider@waider.ie>
+
+ Use bbdb-extract-field-value Minor compiler cleanup
+
+2001-07-07 Ronan Waide <waider@waider.ie>
+
+ Use bbdb-extract-address-components-func
+
+2001-07-07 Ronan Waide <waider@waider.ie>
+
+ 19.34 support mods.
+
+ Use bbdb-extract-address-components-func.
+
+2001-07-07 Ronan Waide <waider@waider.ie>
+
+ New customization variable: bbdb-extract-address-components-func - this
+ tells BBDB what function you'd like to use to attempt parsing of the
+ mail addresses.
+
+ New function for use with the above: bbdb-rfc822-addresses. Brute force,
+ but does a pretty good job.
+
+ Fixed some comment and documentation typos.
+
+2001-07-07 Ronan Waide <waider@waider.ie>
+
+ Added link to jwz's message describing palm/bbdb conflicts
+
+2001-07-01 Ronan Waide <waider@waider.ie>
+
+ Whoops. eval-and-compile, not eval-when-compile.
+
+2001-06-30 Ronan Waide <waider@waider.ie>
+
+ Linked FAQ
+
+2001-06-30 Ronan Waide <waider@waider.ie>
+
+ Added a few more bits.
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ bbdb/mh-cache-key: cope with big inode numbers
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ Added Robert Fenk's bbdb/vm-force-create
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ Added link to freshmeat page
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ Cleaned up a whole bunch of compiler warnings through judicious use of
+ eval-and-compile or eval-when-compile. If anyone has a good opinion on
+ use of these functions, please cast enlightenment in my direction.
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ Rearranged the compiled quieting to actually be more-or-less the right
+ thing, i.e. it loads packages instead of defining arbitrary variables.
+
+ Put in Matan Ninio's "From: " fix.
+
+2001-06-28 Ronan Waide <waider@waider.ie>
+
+ bbdb-search-simple: don't use bbdb-record-name's result if it's empty.
+
+2001-06-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-mhe.el (bbdb/mh-update-record):
+ * lisp/bbdb-rmail.el (bbdb-insinuate-rmail):
+ Fixed the faulty use of bbdb/prompt-for-create-p.
+
+2001-06-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-06-12 Ronan Waide <waider@waider.ie>
+
+ Fix to yesterday's fixed URL. Not my fault, honest.
+
+2001-06-12 Ronan Waide <waider@waider.ie>
+
+ Initial cut. This has been sitting on my drive for almost a year;
+ perhaps if I put it in CVS I'll be "encouraged" to develop it further.
+
+2001-06-11 Ronan Waide <waider@waider.ie>
+
+ Better fix for char-int thing. This one works, for starters. Serves me
+ right for that comment about code testing.
+
+2001-06-10 Ronan Waide <waider@waider.ie>
+
+ Obsolete; contents rolled into bbdb-gnus.el
+
+2001-06-10 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-06-10 Ronan Waide <waider@waider.ie>
+
+ Fixed URL for Martin Schwenke.
+
+2001-06-10 Ronan Waide <waider@waider.ie>
+
+ (bbdb-prompt-for-create): Fixed some XEmacsisms to work with
+ GNUmacs. PLEASE TEST YOUR CODE AGAINST BOTH EMACS VARIANTS BEFORE
+ CHECKING IT IN.
+ (bbdb-address-edit-default): If no data is entered for the address,
+ enter a spurious country name. This is a temporary hack to get
+ around a problem in address display when the address has no data.
+ (general): Fixed the occasional documentation typo.
+ Added completion for Phone and Address labels.
+ Added bbdb-default-country as an attempt to stop you from entering
+ blank addresses. Also because it was requested at some point.
+
+2001-06-10 Ronan Waide <waider@waider.ie>
+
+ Allow specifying a list of completions, which causes completing-read
+ to be invoked instead of read-string.
+
+2001-06-05 Ronan Waide <waider@waider.ie>
+
+ Fix tarball build
+
+2001-06-05 Didier Verna <didier@xemacs.org>
+
+ aclocal.m4, configure.ac: Upgrade to Autoconf 2.50.
+
+2001-06-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-vm.el (bbdb/vm-update-records):
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records):
+ Subject: bbdb-get-only-first-address-p patches
+
+2001-06-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-05-31 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-gnus.el (bbdb/gnus-get-addresses): Fixed the bug which
+ was not really fixed with the commit from the 2001-03-29.
+
+2001-05-23 Didier Verna <didier@xemacs.org>
+
+ aclocal.m4: fix Emacs detection problem when
+ configuring from an Emacs shell buffer.
+
+2001-05-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/news-auto-create-p):
+ (bbdb/mail-auto-create-p):
+ Fixed a typo.
+
+2001-05-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-05-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-update-records): Fixed a typo.
+
+2001-05-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-05-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name):
+ (bbdb-complete-name-hooks): Instead of dinging when completing a
+ complete address (and with cycling disabled) call theses hook
+ functions.
+
+2001-05-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-05-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-invoke-hook-for-value): Fix: Return symbols BUT CALL FUNCTIONS!
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/news-auto-create-p): When set to 'promt then ask the user before
+ automatically creating a record.
+ (bbdb-invoke-hook-for-value): Return symbols just as they are, do not
+ eval them.
+ (bbdb*prompt-for-auto-create-p): Removed the variable and packed its
+ functionality into the bbdb/*-auto-create-p variables.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-update-records): Fixed documentation.
+ (bbdb/vm-update-records-mode): Removed extra quote from the defcustom
+ arguments.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/rmail-pop-up-bbdb-buffer): Remove the BBDB buffer window when
+ empty.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-unmigrate-zip-codes-to-strings): Fixed the faulty use of let
+ instead of let*.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-extract-address-components): Allow also nil as name or email
+ address, not only strings.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-ignore-selected-messages-confirmation): Added the missing default
+ value nil.
+ (bbdb-force-record-create): New hook function for automatic adding of
+ addresses when replying to a message.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-update-records-mode): Removed extra quote from the defcustom
+ arguments.
+ (bbdb/gnus-update-records): Fixed documentation.
+
+2001-05-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-update-records-mode): Removed extra quote from the defcustom
+ arguments.
+ (bbdb-update-records): Fixed search for nets and documentation.
+
+2001-04-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-04-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ Renamed the variables bbdb-pop-up-elided-display-name-end and
+ bbdb-pop-up-elided-display-fields to bbdb-elided-display-name-end and
+ bbdb-elided-display-fields, as they are not related to the pop-up
+ feature.
+
+2001-04-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ lisp/bbdb-gui.el (bbdb-fontify-buffer): lisp/bbdb.el
+ (bbdb-elided-display-fields):
+ Renamed the variables bbdb-pop-up-elided-display-name-end and
+ bbdb-pop-up-elided-display-fields to bbdb-elided-display-name-end and
+ bbdb-elided-display-fields, as they are not related to the pop-up
+ feature.
+
+2001-04-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-04-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added missing docs for the variables bbdb-pop-up-elided-display-name-end
+ and bbdb-pop-up-elided-display-fields
+
+2001-04-16 Ronan Waide <waider@waider.ie>
+
+ BSD Compatibility fix! Make sure RM is set in Makefiles.
+
+2001-04-16 Ronan Waide <waider@waider.ie>
+
+ Whoops. Stray quote mark.
+
+2001-04-15 Ronan Waide <waider@waider.ie>
+
+ Added John F. Whitehead's default mail domain patch. Hack around some
+ silliness in GNU Emacs completion code
+
+2001-04-15 Ronan Waide <waider@waider.ie>
+
+ Added emacs-version to bug report text. Added John F. Whitehead's
+ default-domain patch.
+
+2001-03-30 Ronan Waide <waider@waider.ie>
+
+ Fix list-vs-not bug in bbdb/gnus-edit-notes
+
+2001-03-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-29 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/gnus-get-addresses): Fixed a bug in getting the header content.
+ !mail-fetch-field requires a final newline!
+
+2001-03-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-26 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb.el (bbdb-message-cache-lookup):
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records):
+ * lisp/bbdb-vm.el (bbdb/vm-update-records):
+ YABugfix: first record was lost when looking it up from the
+ cache.
+
+2001-03-26 Ronan Waide <waider@waider.ie>
+
+ Added instructions for running from CVS and from source. Removed
+ direction to copy .tex and .el files as they're not required
+ for a working installation.
+
+2001-03-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb.el (bbdb-message-cache-lookup):
+ Removed the faulty single record code for Rmail/MHE
+
+ * lisp/bbdb-mhe.el (bbdb/mh-update-record):
+ Bugfix for new caching functions
+
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records):
+ Another bugfix: check for nil before caching
+
+2001-03-25 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-gnus.el (bbdb/gnus-show-sender):
+ * lisp/bbdb-vm.el (bbdb/vm-show-sender):
+ Show recipients if we find no senders
+
+ * lisp/bbdb-vm.el (bbdb/gnus-show-records):
+ * lisp/bbdb-vm.el (bbdb/vm-show-records):
+ Also show the records of uninteresting senders
+
+2001-03-25 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-03-25 Ronan Waide <waider@waider.ie>
+
+ Fix some bugs related to new message caching functions.
+
+2001-03-23 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-03-23 Ronan Waide <waider@waider.ie>
+
+ (bbdb-search-simple): Fix silly bug with list-walking (Daniel Pittman)
+
+2001-03-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-23 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-vm.el (bbdb/vm-update-records):
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records):
+ * lisp/bbdb-com.el (bbdb-update-records): honor the right
+ offer-to-create flag and removed the faulty *-auto-create-p
+ which was added by the last commit.
+
+2001-03-22 Ronan Waide <waider@waider.ie>
+
+ Fix the priority stuff. You should be able to highlight individual
+ fields and edit them on GNU Emacs again.
+
+2001-03-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-show-records): bbdb/mail-auto-create-p
+ is loacally set to t in order to force creation of records when
+ explicitly showing them.
+
+2001-03-22 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-prompt-for-create): bugfid for XEmacs introduced with the GNU
+ Emacs fix
+
+2001-03-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-prompt-for-create): fix a bug with GNU Emacs.
+
+2001-03-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-20 Ronan Waide <waider@waider.ie>
+
+ Remove what was presumably a debug occurrence of (message...)
+
+2001-03-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-19 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-update-records): honors now bbdb-gag-messages; fixed the overall
+ number
+ in the progress message.
+
+2001-03-19 Ronan Waide <waider@waider.ie>
+
+ (bbdb-header-start): Check for vm-presentation-mode as well as vm-mode
+ and vm-summary-mode (Nicolas Rennert)
+
+2001-03-18 Ronan Waide <waider@waider.ie>
+
+ bbdb/gnus-get-addresses: gnus-ignored-from-addresses is not defined in
+ the Gnus that comes with Emacs 20.7. Check for boundness before using.
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ Variable/function changes as documented in the ChangeLog entry
+ 2001-03-17 Robert Fenk <fenk@forwiss.de>
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-redisplay-records): unused variable condition removed
+
+ (bbdb-delete-current-field-or-record): unused variable do-all-p removed
+
+ (bbdb-refile-record): called with a prefix arg it tries to merge
+ with the corresponding duplicate record
+
+ (bbdb-display-completion-list): Use the call back
+ 'bbdb-complete-clicked-name when running in Xemacs, thus to
+ further complete after the user selects a completion.
+
+ (bbdb-complete-name):
+ (bbdb-complete-name-full-completion): new variable controlling
+ whether completion shows expanded entries or not. This avoids
+ the need for subsequent completions, but might generate more
+ completion alternatives.
+
+ (bbdb-prompt-for-create):
+ (bbdb-prompt-for-create):
+ (bbdb-get-help-window):
+ (bbdb-update-records): functions used to update BBDB records from
+ headers of messages in Gnus and VM (RMail and MHE may eventually
+ follow). Those functions have been renamed and moved from
+ bbdb-vm.el to this location.
+
+ (bbdb-update-records-mode):
+ (bbdb-offer-to-create):
+ (bbdb-address):
+ (bbdb-get-addresses-from-headers):
+ (bbdb-get-addresses-to-headers):
+ (bbdb-get-addresses-headers):
+ (bbdb-get-only-first-address-p): variables for generic
+ update-records support in Gnus and VM. Those variables have been
+ renamed and moved from bbdb-vm.el to this location.
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-merge-file): unused variable 'live-records removed
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-pop-up-elided-display):
+ (bbdb-pop-up-elided-display): changed to require no unbound
+ bbdb-pop-up-elided-display
+
+ (bbdb-message-cache-lookup):
+ (bbdb-encache-message): Once again functions to replace the old
+ macros. This was necessary as the old macros were not sufficient
+ for the new update mechanism, were we have a list of records.
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-load-touchtones): unused variale 'error removed
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-vm.el (bbdb/vm-get-addresses): was formally bbdb/vm-get-from
+ (bbdb/vm-get-from-headers):
+ (bbdb/vm-get-only-first-from-p):
+ (bbdb/vm-message-cache-lookup):
+ (bbdb/vm-encache-message): have been removed, global variables and
+ functions are used now
+
+ (bbdb/vm-show-sender): when called with a prefix call
+ bbdb/vm-show-all-recipients instead, so we use the same binding
+ for getting both.
+ (bbdb/vm-show-records): new function doing the bbdb/vm-show-*
+ thing and caring for updating the records.
+
+ (bbdb/vm-snarf-all):
+ (bbdb/vm-snarf-all-headers): have been removed as the
+ bbdb/vm-show-* function provide the same functionality
+
+ * lisp/bbdb-gnus.el: the same changes as for bbdb-vm.el
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-snarf-region): Unused variables
+ 'country and 'namebegin removed
+
+ (bbdb-snarf-nice-real-name-regexp):
+ (bbdb-snarf-nice-real-name): removed and calls replaced by
+ bbdb-clean-username which is more sophisticated
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-mhe.el:
+ * lisp/bbdb-rmail.el: uses the new caching functions + some
+ other minor changes
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ Definition of some variable in order to avoid warnings during
+ compilation
+
+2001-03-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Forgot to change the release date. (Urban Boquist)
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Bumped version again, for new developer version.
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Version number update for release.
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Updates for BBDB 2.32
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Add a buffer-coding tag. (Yair Friedman)
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Initial cut at this (Yair Friedman)
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Require bbdb-com (for bbdb-parse-phone-number) Stop from loading .bbdb
+ when compiling!
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ Mark bbdb/sc-default for autoload. Not sure this is entirely the right
+ thing.
+
+2001-03-04 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ set max-lisp-eval-depth. From "Yair Friedman (Jerusalem)"
+ <YAIRFR@amdocs.com>
+
+2001-03-04 Ronan Waide <waider@waider.ie>
+
+ ">>" and ">" transposed. (Yair Friedman)
+
+2001-03-03 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-03-03 Ronan Waide <waider@waider.ie>
+
+ bbdb-search-simple: check that the name actually matchs (not company)
+
+2001-03-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ bbdb.el (bbdb-submit-bug-report): A function for submitting bug
+ reports, which should make it easier for reportes and maintaines
+ to give and have all necessary information. Additional variables
+ may have to be add and a remark in the documentation to use this
+ function when reporting problems.
+
+2001-03-01 Ronan Waide <waider@waider.ie>
+
+ More bits, possibly incompatible with 2.00.06. Use at own risk.
+
+2001-02-25 Ronan Waide <waider@waider.ie>
+
+ I corrected something that wasn't a bug. (provide.. ) was in the right
+ place.
+
+2001-02-25 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-02-25 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ texinfo-format-buffer knows detailmenu. Thanks to Yair Friedman
+ (Jerusalem)" <YAIRFR@amdocs.com>.
+
+2001-02-25 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ *** empty log message ***
+
+2001-02-25 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ * texinfo/bbdb.texinfo: Format it so that texinfo-format-buffer
+ can parse it.
+
+ * texinfo/infohack.el: New.
+
+ * texinfo/Makefile.in (Makefile): Add.
+ (bbdb.info): Use batch-makeinfo if there is no makeinfo.
+
+2001-02-25 Ronan Waide <waider@waider.ie>
+
+ Shouldn't have been in here in the first place. Sorry 'bout that.
+
+2001-02-23 Ronan Waide <waider@waider.ie>
+
+ call `bbdb/gnus-pop-up-bbdb-buffer' instead of `bbdb/gnus-update-record'
+ (bbdb/gnus-pop-up-bbdb-buffer): use `gnus-buffer-configuration' instead
+ of the obsolete `gnus-window-configuration'.
+
+2001-02-21 Ronan Waide <waider@waider.ie>
+
+ Restore old bbdb-message-cache macros as replacement functions were
+ buggy.
+
+2001-02-21 Sam Steingold <sds@goems.com>
+
+ (bbdb-gui): new user option
+
+2001-02-21 Sam Steingold <sds@goems.com>
+
+ do not add bbdb-fontify-buffer to bbdb-list-hook (done in bbdb.el)
+
+2001-02-21 Ronan Waide <waider@waider.ie>
+
+ Use add-hook to load bbdb-gui by side-effect
+
+2001-02-21 Ronan Waide <waider@waider.ie>
+
+ Put the (provide 'bbdb-autoloads) line in the right place.
+
+2001-02-21 Ronan Waide <waider@waider.ie>
+
+ Stop BBDB from adding AKAs when you tell it you don't want them.
+
+2001-02-20 Sam Steingold <sds@goems.com>
+
+ (bbdb-extent-face): use `overlay-get', not `extent-property'
+ (bbdb-set-extent-face): use `overlay-put', not `set-extent-property'
+
+2001-02-20 Sam Steingold <sds@goems.com>
+
+ Fixed the overlay bug in GNU Emacs. As documented, 3 is higher priority
+ than 2!
+ (bbdb-main-extent-priority): new variable
+ (bbdb-fontify-buffer): use it Also, do not quote lambdas since they are
+ not compiled
+ when quoted (at least in GNU Emacs!)
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Now that I've fixed bbdb-gui properly, reenable the load hook.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Final few tweaks to function names to avoid upsetting things.
+
+2001-02-19 Sam Steingold <sds@goems.com>
+
+ (bbdb-list-extents): use `nconc', not `append',
+ since we know that the lists are new
+ (bbdb-extent-property, bbdb-highlight-extent,
+ bbdb-extent-start-position, bbdb-extent-end-position): define
+ [were undefined due to a typo]
+ (bbdb-set-extent-begin-glyph, bbdb-set-extent-end-glyph):
+ `fset' to `ignore' insted of redefining with `defun'
+
+2001-02-19 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ Makefile.in (bbdb-autoloads.el): Change the order.
+
+2001-02-19 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ * lisp/Makefile.in (bbdb-autoloads.el): Insert (provide
+ 'bbdb-autoloads) when generated by FSF Emacs.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Temporarily disable loading of bbdb-gui, since there's an interaction
+ bug with VM right now. Non-serious, but annoying.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ VM appears to get upset with bbdb-extent-at switching around buffers.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Automatically pull in the GUI stuff, now that I seem to have caught all
+ the typos.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Faulty bracing in touchtone code.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Final typo correction, I promise.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ More typo. Thanks to Dan Pittman for spotting these.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ whoops. typo.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ doco typo fixo
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ bbdb-electric-p defaults to off. require 'bbdb-autoloads instead of
+ loading them. bbdb-whois moved from M-w to W so you can do copies in
+ *BBDB* moved some XEmacs-stuff to bbdb-gui, where it's Emacs-agnostic
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Moved font and menu stuff to bbdb-gui.el
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Added target for bbdb-gui
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Menu and font hackery. Works in Emacs as well as XEmacs.
+
+2001-02-19 Ronan Waide <waider@waider.ie>
+
+ Quick fix for LN_S not being defined. Perhaps it's even the correct fix.
+
+2001-02-14 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-14 Robert Fenk <fenk@users.sourceforge.net>
+
+ bbdb/vm-update-records): Fixed bug of calling
+ message with wrong argument.
+
+2001-02-14 Ronan Waide <waider@waider.ie>
+
+ Whoops. Missed a close paren.
+
+2001-02-14 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-02-14 Ronan Waide <waider@waider.ie>
+
+ Some more defcustom stuff (Alex Schroeder)
+
+2001-02-14 Ronan Waide <waider@waider.ie>
+
+ Some defvars changed to defcustoms bbdb-add-or-remove-mail-alias
+ documented in mode help (Alex Schroeder)
+
+2001-02-14 Ronan Waide <waider@waider.ie>
+
+ Documentation for zipcode stuff (Alex Schroeder)
+
+2001-02-14 Ronan Waide <waider@waider.ie>
+
+ Empty string is a valid Zip code (Alex Schroeder)
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ - display-message macro removed
+ - fix defcustom type for bbdb-pop-up-elided-display-fields
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-update-records): replaced display-message calls by
+ message calls which is more portable.
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ Applied ShengHuos patch to fix the customize problems caused by defining
+ 'characterp as a mcaro im GNU Emacs
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-13 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name):
+ (bbdb-complete-name-allow-cycling): Allow to enable/disable the
+ cycling of nets. Default is disabled, as there are some strange
+ problems with GNU Emacs.
+
+2001-02-11 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ * lisp/bbdb-snarf.el (replace-in-string): Fix the argument order
+ of replace-regexp-in-string.
+
+2001-02-10 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-02-10 Ronan Waide <waider@waider.ie>
+
+ Seems like the change to bbdb-undisplay-records fixes the VM window
+ problem.
+
+2001-02-10 Ronan Waide <waider@waider.ie>
+
+ Fixed bbdb-undisplay-records. bbdb-buffer-name is /not/ a buffer!
+
+2001-02-08 Sam Steingold <sds@goems.com>
+
+ doc fix
+
+2001-02-08 Sam Steingold <sds@goems.com>
+
+ doc fixes
+
+2001-02-08 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-annotate-message-sender):
+ Applied bugfix for adding new net addresses, which was broken by
+ the new featue of creating a new record if the address does not
+ belong to the existing record.
+ (bbdb-display-records):
+ (bbdb-display-records-1):
+ run the hooks 'bbdb-list-hook in bbdb-display-records-1, instead
+ of bbdb-display-records, in order to call them also for electric
+ display.
+
+2001-02-08 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-07 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-02-07 Ronan Waide <waider@waider.ie>
+
+ (ding) if there's nothing in mail-abbrevs either.
+
+2001-02-07 Ronan Waide <waider@waider.ie>
+
+ Only call the sit-for bugfix in fsfemacs.
+
+2001-02-07 ShengHuo ZHU <zsh@cs.rochester.edu>
+
+ Use field-separator.
+
+2001-02-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name): Fxed bug which showed
+ its effect only with GNU Emacs.
+ (bbdb-add-or-remove-mail-alias): Better prompt.
+
+2001-02-07 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-05 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-05 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-hooks.elc): removed need to load VM.
+
+2001-02-05 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-05 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed faulty replace-in-string.
+
+2001-02-03 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-annotate-message-sender): Changed the creation of new "duplicate
+ records to
+ honor the value of bbdb-always-add-addresses.
+
+2001-02-03 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-03 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-message-cache-lookup), (bbdb-encache-message):
+ Replaced the unreadable macros by a function in order to use it
+ also for bbdb-vm.el.
+ (bbdb-decache-message): new function to remove an element from the
+ cache.
+ (bbdb-annotate-message-sender): Added creation of a new "duplicate"
+ record when the given email address does not belong to the
+ existing one.
+
+2001-02-02 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-find-duplicates): Fixes records without a
+ name and adds additional messages in order to understand the
+ duplicates.
+
+2001-02-02 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-02 Didier Verna <didier@xemacs.org>
+
+ XEmacs Package installation fixes
+
+2001-02-02 Didier Verna <didier@xemacs.org>
+
+ makefile for utils dir
+
+2001-02-02 Didier Verna <didier@xemacs.org>
+
+ makefile for tex dir
+
+2001-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-mode-map): Added elide-records binding
+ for button2
+
+2001-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ bbdb-mail-abbrev-expand-hook): honor the
+ pop-up settings, e.g. bbdb-pop-up-target-lines
+
+2001-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-02-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ * lisp/bbdb-vm.el (bbdb/vm-pop-up-bbdb-buffer): Fixed the pop-up
+ behaviour.
+
+2001-01-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ lisp/bbdb-com.el (bbdb-complete-name): Fixes completion problem
+ slipped into with revision 1.89
+
+2001-01-29 Ronan Waide <waider@waider.ie>
+
+ Added autoload cookie for bbdb-ignore-selected-messages-hook
+
+2001-01-29 Ronan Waide <waider@waider.ie>
+
+ Include configure in ignored files.
+
+2001-01-25 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-01-25 Ronan Waide <waider@waider.ie>
+
+ Updates for 2.2
+
+2001-01-25 Ronan Waide <waider@waider.ie>
+
+ Updates for 2.2 release
+
+2001-01-25 Ronan Waide <waider@waider.ie>
+
+ Changed version to 2.3, which is now the official developer release.
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Added distclean target
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Removed test targets as they weren't helpful Added some new cleaning
+ targets, including distclean
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ New cleanup targets
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Define caddar if it's not found. Yeesh. How hard is it to do
+ (car (cdr ...)) anyway?
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Add-ons that didn't make it to the current release.
+
+2001-01-24 Sam Steingold <sds@goems.com>
+
+ (replace-in-string): Emacs 21 has `replace-regexp-in-string' - use it!
+
+2001-01-24 Sam Steingold <sds@goems.com>
+
+ ignore Makefiles
+
+2001-01-24 Sam Steingold <sds@goems.com>
+
+ initial checkin
+
+2001-01-24 Sam Steingold <sds@goems.com>
+
+ lisp/bbdb-merge.el (bbdb-merge-file): bugfix:\r the parameter for
+ `match-fun' is `rec', not `r'
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Use geektools.com instead of rs.internic.net Slightly smarter parsing of
+ results
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Add support for M-TAB to expand mail aliases
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Don't look for email completions when there are none!
+
+2001-01-24 Ronan Waide <waider@waider.ie>
+
+ Don't load touchtones if the touchtones directory is unset.
+
+2001-01-22 Ronan Waide <waider@waider.ie>
+
+ Check that an AKA is not already in the list before adding it
+
+2001-01-18 Ronan Waide <waider@waider.ie>
+
+ Minor typo fix
+
+2001-01-18 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2001-01-18 Ronan Waide <waider@waider.ie>
+
+ * Proper fix for VM windowing bug
+
+2001-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2001-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name):
+ If the completion is done then cycle thru the nets or when called
+ with a prefix arg then display a list of all nets.
+ (bbdb-dial-local-prefix-alist):
+ Used to replace parts of the number depending on a regexp.
+ (bbdb-modem-dial): command used for dialing with the modem.
+ (bbdb-modem-device): the modem device
+ (bbdb-dial-number): new function which performs the dialing of a
+ number. Depending on the settings it uses the play command,
+ native Xemacs sound support or the modem device.
+ (bbdb-dial): modified in order to use the new stuff
+
+2001-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-sounds-directory):
+ (bbdb-sound-volume):
+ (bbdb-load-touchtones):
+ Added variables & functions for Xemacs native sound support
+ used by bbdb-dialing stuff
+
+2001-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-www-grab-homepage):
+ Fix to read just one record not a list of records
+
+2001-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-update-record):
+ Restored old behavior of returning one record
+ (bbdb/vm-update-records-mode):
+ (bbdb/vm-update-records):
+ Enhanced in order to allow annotating only new messages, which is
+ now the default. This avoids the annoying questions repetition
+ weather to add records for unknown persons after restarting a
+ VM session.
+
+2001-01-17 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-always-add-addresses): Docfix
+
+2001-01-08 Ronan Waide <waider@waider.ie>
+
+ Minor change to make it work again.
+
+2001-01-08 Ronan Waide <waider@waider.ie>
+
+ Corrected pointers to mailing lists.
+
+2001-01-08 Didier Verna <didier@xemacs.org>
+
+ configure script from autoconf 2.13
+
+2001-01-08 Didier Verna <didier@xemacs.org>
+
+ Autoconf support
+
+2001-01-08 Didier Verna <didier@xemacs.org>
+
+ Autoconf support documentation
+
+2001-01-08 Didier Verna <didier@xemacs.org>
+
+ removed files for autoconf support
+
+2001-01-08 Didier Verna <didier@xemacs.org>
+
+ new files for autoconf support
+
+2001-01-08 Ronan Waide <waider@waider.ie>
+
+ Fixed commented-out items in TODO section.
+
+2001-01-08 Ronan Waide <waider@waider.ie>
+
+ Added Bill Carpenter-provided function
+ 'bbdb-ignore-selected-messages-confirmation'
+
+2001-01-03 Ronan Waide <waider@waider.ie>
+
+ (bbdb-dial) Change docstring for bbdb-dial Remove check for window
+ system
+
+2001-01-03 Ronan Waide <waider@waider.ie>
+
+ * Removed some things from the TODO list
+ * Removed the Log section
+ * Added xref from BBDB Mailing Lists to Using BBDB to implement Mailing
+ Lists
+ * A few other minor tweaks
+
+2001-01-03 Ronan Waide <waider@waider.ie>
+
+ Updated the links section; some other minor changes.
+
+2000-12-31 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-12-31 Ronan Waide <waider@waider.ie>
+
+ (bbdb-undisplay-records) Don't try to use *BBDB* buffer if it doesn't
+ exist.
+
+2000-12-18 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-12-18 Ronan Waide <waider@waider.ie>
+
+ * Added definition for cadar.
+ * Docu typo in bbdb-elided-display
+ * If bbdb-display-records isn't appending, clear the buffer
+ * bbdb-undisplay-records erases the buffer
+ * bbdb-insinuate-message now hooks on message-setup-hook
+
+2000-12-18 Ronan Waide <waider@waider.ie>
+
+ Small change to get around an apparent emacs windowing bug.
+
+2000-11-27 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-11-27 Ronan Waide <waider@waider.ie>
+
+ Alex's zipcode changes. WARNING: New database format.
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ Just minor fixes.
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-fontify-buffer): Fixed fontification
+ for elided display.
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ ((fboundp 'display-message)): added macro for
+ display-message (for GNU Emacs) used for progress reports in
+ bbdb-vm.el
+ (bbdb-format-record): fixed display for elided display
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-update-records): Uses display-message
+ for progress report and honor bbdb-silent-running.
+ (bbdb/vm-snarf-all): removed faulty "second" call of
+ bbdb-update-records
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-extract-address-component-regexps):
+ added recognition of true names form addresses like
+ Robert.Fenk@gmx.de, in order to avoid creation of duplicate
+ records.
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-extract-field-value): added
+ (case-fold-search t) as headers should be checked case insensitive
+
+2000-11-16 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-show-all-recipients): simplified the function and added missing
+ headers
+
+2000-11-07 Ronan Waide <waider@waider.ie>
+
+ Doc fix (Martin Buchholz)
+
+2000-11-06 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-11-06 Ronan Waide <waider@waider.ie>
+
+ Respect value of bbdb-use-pop-up.
+
+2000-11-06 Ronan Waide <waider@waider.ie>
+
+ Corrected mirror link.
+
+2000-11-02 Ronan Waide <waider@waider.ie>
+
+ Define characterp if it's not already bound. Used in bbdb-vm.
+
+2000-11-02 Sam Steingold <sds@goems.com>
+
+ (bbdb-hashtable-size): call `bbdb-records' only when it is defined
+
+2000-11-01 Sam Steingold <sds@goems.com>
+
+ (bbdb-hashtable-size): new custom variable
+ (primep): define if not defined already
+ (bbdb-records): use `bbdb-hashtable-size' when initializing
+ `bbdb-hashtable'
+
+2000-10-30 Robert Fenk <fenk@users.sourceforge.net>
+
+ (display-message 'progress mess) does not exist for FSF Emacs, therefore
+ we polluted the message log by calling (message mess).
+
+2000-10-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2000-10-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-fontify-buffer): changed in order to meet flexible
+ `bbdb-pop-up-elided-display-name-end'.
+
+2000-10-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-update-records): Searching for existing records is limited to
+ the
+ net, as a search for a name may no return the right record.
+ Adding of new records can be controlled similar to query-replace,
+ with y,!,n,s,q
+ The new variable `bbdb/prompt-for-create-p' can be set to `t' in
+ order to force VM to ask the user before adding a new BBBD record,
+ caused by the automatic update of the popup buffer.
+
+2000-10-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/prompt-for-create-p):
+ The new variable `bbdb/prompt-for-create-p' can be set to `t' in
+ order to force VM, Gnus, MHE, RMAIL to ask the user before adding a
+ new BBBD record, caused by the automatic update of the popup buffer.
+ (bbdb-pop-up-elided-display-name-end): A new variable which
+ controls for elided display where the "name - company" pair
+ usually ends and where we start to display phone numbers and the
+ like.
+ (bbdb-pop-up-elided-display-fields): A new variable controlling
+ what fields are displayed in elided display. Users may write
+ their own formating functions. (kind of experimental by now)
+
+2000-10-27 Robert Fenk <fenk@users.sourceforge.net>
+
+ The new variable `bbdb/prompt-for-create-p' can be set to `t' in order
+ to force VM, Gnus, MHE, RMAIL to ask the user before adding a new BBBD
+ record, caused by the automatic update of the popup buffer.
+
+2000-10-27 Ronan Waide <waider@waider.ie>
+
+ Fixed silly bug that stopped auto-noticing from working at all. Doh.
+
+2000-10-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name): minor bugfix for cycling of addresses.
+
+2000-10-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2000-10-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-extract-address-components): added an optional argument
+ `ignore-errors'.
+
+2000-10-20 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-complete-name): If there are multiple nets and the address is
+ already
+ completed then cycle trough the list of nets.
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ Fix to allow building with Martin Schwenke's gnuserv.
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ Fixed to work with newer version of gnuserv provided by Martin Schwenke
+ and downloadable from
+ http://linuxcare.com.au/people/martins/hacks/emacs/
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ Cleaned up some of the customization stuff. Fixed handling of
+ vm-uninteresting-senders
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ Cleaned up some of the customization stuff.
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ Added Brian Edmonds' filing hackery, modified to fit in bbdb's concept
+ of a namespace. Cleaned up some compiler noise.
+
+2000-10-15 Ronan Waide <waider@waider.ie>
+
+ Fixed the compose-mail selection for bbdb-send-mail-style. Thanks to
+ Raymond Scholz for pointing out that it wasn't actually working.
+
+2000-09-20 Ronan Waide <waider@waider.ie>
+
+ Fix primary-or-name search to pay attention to bbdb-case-fold-search
+ when checking names. (bug report: Eli Tziperman)
+
+2000-09-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2000-09-12 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb/vm-snarf-all): fixed wrong documentation
+
+2000-09-12 Ronan Waide <waider@waider.ie>
+
+ Added "BBDB Development Team" to the list at the start. Fixed 'missing
+ node' problem with older versions of makeinfo. Added Kai's example of
+ working around the ispell key-mapping conflict.
+
+2000-09-11 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-09-11 Ronan Waide <waider@waider.ie>
+
+ Reinstated 2.00.06 behaviour of creating a record if necessary when :
+ is pressed Added new function, bbdb/vm-show-all-recipients, to do the
+ necessary
+ fandango to show recipients for the current message. Map it to
+ something in vm-mode-map if you wish to use it. I'd suggest "'".
+
+2000-09-08 Sam Steingold <sds@goems.com>
+
+ (bbdbq-mk): new function
+
+2000-09-08 Ronan Waide <waider@waider.ie>
+
+ Daniel Pittman's patch does indeed override Alex's!
+
+2000-09-07 Ronan Waide <waider@waider.ie>
+
+ Daniel Pittman's autoload patch. May make Alex's patch obsolete.
+
+2000-09-07 Ronan Waide <waider@waider.ie>
+
+ Alex Coventry's patch to fix compile-vs-runtime autoloads
+
+2000-09-03 Ronan Waide <waider@waider.ie>
+
+ Default completed name to an empty string to avoid error
+
+2000-08-29 Ronan Waide <waider@waider.ie>
+
+ Check if vm-summary-uninteresting-senders is a string before using it
+
+2000-08-28 Ronan Waide <waider@waider.ie>
+
+ Changed [(meta...)] keybindings to "\M-..."
+
+2000-08-28 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-08-28 Ronan Waide <waider@waider.ie>
+
+ Fix for bbdb-autoloads.el and Xemacs
+
+2000-08-28 Ronan Waide <waider@waider.ie>
+
+ Moved bbdb-insinuate-message out to bbdb.el to prevent gnus startup
+ looping
+
+2000-08-28 Ronan Waide <waider@waider.ie>
+
+ Moved bbdb-insinuate-message into this file to prevent gnus startup
+ looping Changed \M-\t to [(meta tab)]
+
+2000-08-25 Ronan Waide <waider@waider.ie>
+
+ Added link to Martin's bbdb-gnokii.el
+
+2000-08-25 Ronan Waide <waider@waider.ie>
+
+ Updated the HTML version of the manual. Fixed broken stylesheet
+ reference in web page. Added link for Noah Friedman's copy of jwz's
+ bbdb-pilot.el Fixed link to Alex's page.
+
+2000-08-25 Ronan Waide <waider@waider.ie>
+
+ Cache the fact that you didn't want to create an entry for someone, so
+ you don't get prompted repeatedly. Also removed changelog from file.
+
+2000-08-21 Ronan Waide <waider@waider.ie>
+
+ Fix an error in VM doco that prevented file from building
+
+2000-08-21 Robert Fenk <fenk@users.sourceforge.net>
+
+ Removed the faulty autoload.
+
+2000-08-19 Ronan Waide <waider@waider.ie>
+
+ Rearrange Lastname, Firstname even if it's not in quotes.
+
+2000-08-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ Restored the previous version of bbdb-annotate-message-sender, since the
+ change was not exactly doing what it should do.
+
+2000-08-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ *** empty log message ***
+
+2000-08-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ `bbdb-annotate-message-sender' was changed in order to ask the user for
+ adding new addresses to net only if `create-p' is `t'.
+
+2000-08-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ `bbdb/vm-get-only-first-from-p' was renamed to
+ `bbdb/vm-get-first-from-p' which is more self explanatory.
+
+ The default value of `bbdb/vm-get-only-first-from-p' is `t' in order to
+ keep
+ the old BBDB behavior.
+
+ `bbdb/vm-get-from' was partially rewritten in order to make it more
+ readable.
+
+2000-08-18 Robert Fenk <fenk@users.sourceforge.net>
+
+ * texinfo/bbdb.texinfo (VM Features): Documentation of new VM
+ features.
+
+2000-08-18 Ronan Waide <waider@waider.ie>
+
+ Fixed a minor bug related to retrieving empty records from cache
+
+2000-08-14 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb-com.el: require `cl' at compile time for `flet'
+ (bbdb-add-or-remove-mail-alias): use `let', not `setq'
+ (bbdb-send-mail-internal): fixed call to `vm-mail-internal'
+
+2000-08-12 Ronan Waide <waider@waider.ie>
+
+ Don't return an empty string as the name or address, return nil.
+
+2000-08-11 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb.el (bbdb-save-db): fixed the calling sequence of
+ `y-or-n-p-with-timeout'
+
+2000-08-11 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb-snarf.el (bbdb-extract-address-components): use
+ `bbdb-warn' instead of `warn'
+ (replace-in-string): check for `boundp', not `functionp'
+ (bbdb-snarf-nice-real-name-regexp, bbdb-snarf-nice-real-name): doc fix
+
+ * lisp/bbdb.el: removed the `defsubst' kludge - we do not support emaxen
+ without `defsubst' anyway; also pacify the compiler a little bit
+
+2000-08-11 Ronan Waide <waider@waider.ie>
+
+ Check if bbdb-file-remote is set before trying to use it.
+
+2000-08-10 Sam Steingold <sds@goems.com>
+
+ Remote DB synchronization:
+ (bbdb-file-remote, bbdb-file-remote-save-always): new user variables
+ (bbdb-buffer): a function now; copy `bbdb-file-remote' to
+ `bbdb-file' when it is newer
+ (bbdb-write-file-hook-fn): maybe write `bbdb-file-remote'
+
+ junk removal:
+ (bbdb-modified-p): dumped
+ (bbdb-read-string): removed minibuffer-resizing code: all supported
+ emaxen can resize minibuffers themselves
+
+2000-08-10 Sam Steingold <sds@goems.com>
+
+ (save-current-buffer): fset to `save-excursion' if not present
+ (with-current-buffer): defmacro if not present
+ (bbdb-save-buffer-excursion): dumped
+ (bbdb-with-db-buffer, bbdb-records, bbdb-write-file-hook-fn): use
+ `with-current-buffer' instead of `bbdb-save-buffer-excursion'
+
+2000-08-10 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb.el (bbdb-join): dropped an unused variable
+
+2000-08-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ Documentation of new features (somehow incomplete by now).
+
+ Files: texinfo/bbdb.texinfo
+
+2000-08-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-quiet-about-name-mismatches): if a number it will be the number of
+ seconds to sit-for when displaying the notification about a name
+ mismatch.
+ (bbdb-join): inverse function of bbdb-split.
+ (bbdb-annotate-message-sender): tries to guess a reasonable default name
+ when creating new records.
+
+ Files: lisp/bbdb.el
+
+2000-08-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ T(bbdb/vm-get-from): uses now bbdb-extract-address-components to extract
+ all recipients and uses vm-summary-uninteresting-senders for ignoring
+ senders, which is more consistently with respect VM. One can set the
+ variable
+ `bbdb/vm-get-from-headers' and `bbdb/vm-get-first-from-p' in order to
+ control what headers are processed and what is display is what order.
+ (bbdb/vm-message-cache-lookup):
+ (bbdb/vm-encache-message): We use our own caching functions instead of
+ the bbdb default functions since we are handling a set of records and
+ not a single one.
+ (bbdb/vm-update-record): is now just a call to
+ (bbdb/vm-update-records): which performs the actual work of finding and
+ updating records.
+ (bbdb/vm-set-auto-folder-alist): Is a function from Mark Thomas
+ <mthomas@jprc.com> which sets `vm-auto-folder-alist' according to the
+ field `bbdb/vm-set-auto-folder-alist-field'.
+
+ Files: lisp/bbdb-vm.el
+
+2000-08-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-snarf-nice-real-name-regexp): regexp matching unwanted characters
+ used by
+ (bbdb-snarf-nice-real-name): removes unwanted characters from real
+ names/email addresses.
+ (bbdb-extract-address-component-regexps): alist of regexps and
+ transformation-instructions used by
+ (bbdb-extract-address-components): is for the extraction of full name
+ and email address from headers. This function is a bit more
+ configurable than `mail-extract-address-components' and it will return a
+ list of all found address components. Some note about why to use this
+ extract-function.
+ `bbdb-show-all-recipients' uses `bbdb-split' ,but this will not work for
+ email addresses like
+ "Boss, Hugo" <hugo@boss.com> or hugop@boss.com (Hugo Boss) On the
+ otherside `mail-extr.el' returns just the first mail address, but we may
+ be interrested also in the other addresses within one header.
+ Furthermore this function is configureable to do smart parsing ...
+
+ Files: lisp/bbdb-snarf.el
+
+2000-08-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ (bbdb-define-all-aliases): Records without a net nolonger cause a error,
+ one will get just a waring when not running in silent mode.
+ (bbdb-delete-current-field-or-record): added handling of "*" in order to
+ delete multiple records and 'noprompt'.
+ (bbdb-send-mail-internal): added missing call of vm hooks.
+ (bbdb-add-or-remove-mail-alias): returns all mail aliases in a format
+ suitable for completing read.
+ (bbdb-add-or-remove-mail-alias): convenience function for adding or
+ removing mail aliases from one or multiple records. This makes it much
+ simpler to define groups.
+
+ Files: lisp/bbdb-com.el
+
+2000-08-10 Robert Fenk <fenk@users.sourceforge.net>
+
+ Files: ChangeLog
+
+2000-08-10 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb.el (bbdb-annotate-notes): `regexp-quote' the annotation
+ before matching it on existing notes
+
+2000-08-05 Ronan Waide <waider@waider.ie>
+
+ When converting the streets to a list, delete "nil" as well as "".
+
+2000-08-03 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb.el (bbdb-notes-default-separator): new user option
+ (bbdb-annotate-notes): use it
+ (notes, company): put `field-separator' property
+ * lisp/bbdb-hooks.el (bbdb-auto-notes-hook): search the whole notes
+ string for the new note before adding
+
+2000-08-03 Ronan Waide <waider@waider.ie>
+
+ fixed a build problem with the autoloads file.
+
+2000-08-01 Ronan Waide <waider@waider.ie>
+
+ last fix (honest) to the bbdb-yadda-mismatch thing.
+
+2000-08-01 Ronan Waide <waider@waider.ie>
+
+ Finally I understand the machinations of
+ bbdb-quiet-about-name-mismatches. Apologies for the confusion.
+
+2000-08-01 Robert Fenk <fenk@users.sourceforge.net>
+
+ Added setting of variable autoload-package-name and deletion of
+ bbdb-autoloads.el file before creation in order to create it with the
+ right featurep and contents. Otherwise it was not working correctly with
+ my Xemacs.
+
+2000-08-01 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-08-01 Ronan Waide <waider@waider.ie>
+
+ Add compose-mail as an option for bbdb-send-mail-style (Kai Großjohann)
+
+2000-08-01 Ronan Waide <waider@waider.ie>
+
+ Added Howard Melman's VM labelling code. It's switched off by default;
+ use (add-hook 'bbdb-notice-hook 'bbdb/vm-auto-add-label) to enable it.
+
+2000-08-01 Ronan Waide <waider@waider.ie>
+
+ Added Thomas DeWeese's May 19 (!) fix for bbdb-build-name.
+
+2000-07-27 Sam Steingold <sds@goems.com>
+
+ dropped bbdb-add-hook
+
+2000-07-27 Sam Steingold <sds@goems.com>
+
+ limited `bbdb-init-forms' to hooks to protect the innocent
+
+2000-07-25 Sam Steingold <sds@goems.com>
+
+ (bbdb-init-forms): new variable
+ (bbdb-initialize): use it
+
+2000-07-25 Sam Steingold <sds@goems.com>
+
+ use auto-generated autoloads consistently
+
+2000-07-24 Sam Steingold <sds@goems.com>
+
+ added some autoload cookies
+
+2000-07-21 Sam Steingold <sds@goems.com>
+
+ removed TABs. this, finally, passed weblint!
+
+2000-07-21 Ronan Waide <waider@waider.ie>
+
+ Fixed some badness on the web page New version of the bbdb manual, split
+ per section.
+
+2000-07-21 Ronan Waide <waider@waider.ie>
+
+ ShengHuo Zhou's patch to update this for v5 file format
+
+2000-07-21 Ronan Waide <waider@waider.ie>
+
+ Removed a debug (message...) form
+
+2000-07-21 Ronan Waide <waider@waider.ie>
+
+ Added robert fenk's patch to use bbdb-popup in gnus.
+
+2000-07-21 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-07-21 Ronan Waide <waider@waider.ie>
+
+ More bbdb-silent-running edits.
+
+2000-07-20 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb-com.el (bbdb-finger): use `bbdb-get-record'
+ * lisp/bbdb-whois.el (bbdb-whois): use `bbdb-get-record'
+ * lisp/bbdb-ftp.el (bbdb-ftp): use `bbdb-get-record'
+
+2000-07-20 Sam Steingold <sds@goems.com>
+
+ a couple more keybindings...
+
+2000-07-20 Sam Steingold <sds@goems.com>
+
+ added project home to quicklinks
+
+2000-07-18 Sam Steingold <sds@goems.com>
+
+ mail-abbrevs/aliases handling
+
+2000-07-14 Sam Steingold <sds@goems.com>
+
+ untabified
+
+2000-07-14 Ronan Waide <waider@waider.ie>
+
+ * Fixed bbdb-quiet-about-mismatches logic
+ * Added new variable, bbdb-silent-running, to suppress informational
+ messages and queries. Not all messages are suppressed by this yet,
+ though.
+
+2000-07-13 Sam Steingold <sds@goems.com>
+
+ erroneously dropped a setq in the last commit; reinstate it.
+
+2000-07-13 Sam Steingold <sds@goems.com>
+
+ minor doc fixes to comply with the standards
+
+2000-07-13 Sam Steingold <sds@goems.com>
+
+ added bbdb-write-file-hooks user variable
+
+2000-07-13 Sam Steingold <sds@goems.com>
+
+ added `bbdb-write-file-hooks' user variable
+
+2000-07-11 Sam Steingold <sds@goems.com>
+
+ (bbdb-migrate-record-lambda): `mapcar', not `mapc' here!
+
+2000-07-11 Sam Steingold <sds@goems.com>
+
+ clean-up as per weblint
+
+2000-07-10 Sam Steingold <sds@goems.com>
+
+ revert the last patch (`mapc' is more efficient than `mapcar')
+
+2000-07-10 Sam Steingold <sds@goems.com>
+
+ emacs 21 has `mapc'; define it when we don't have it.
+
+2000-07-09 Ronan Waide <waider@waider.ie>
+
+ GNUmacs doesn't have "mapc".
+
+2000-07-09 Ronan Waide <waider@waider.ie>
+
+ Get install-pkg to ignore CVS directories as well as SCCS and RCS.
+
+2000-07-05 Sam Steingold <sds@goems.com>
+
+ rewrote migration in a modular way
+
+2000-07-05 Sam Steingold <sds@goems.com>
+
+ code readability
+
+2000-07-05 Sam Steingold <sds@goems.com>
+
+ (parse-bbdb-internal): bind, not setq the version.
+
+2000-07-03 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Fixed typo.
+
+2000-07-03 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Fixed ftp address. Added thanks. Synced ml info to Web.
+
+2000-07-03 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Various little info changes, including ml info, TeX output changes,
+ thanks. Added info-directory information. Added detailed node list.
+
+2000-06-30 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Build bbdb-merge.elc
+
+2000-06-30 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Minor fixes.
+
+2000-06-30 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Ignore info files.
+
+2000-06-30 Sam Steingold <sds@goems.com>
+
+ (bbdb-format-streets): use `mapc', not `mapcar'
+
+2000-06-30 Sam Steingold <sds@goems.com>
+
+ (bbdb-format-streets): fixed for the new BBDB format (5)
+
+2000-06-30 Sam Steingold <sds@goems.com>
+
+ (bbdb-migrate): re-wrote using `mapcar' instead of `append' this is
+ linear instead of quadratic and avoids much consing
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ Fixed bbdb-current-field properly. Note that if you define a new address
+ formatting function, this code may not work correctly.
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ Fixed obi-wan error in bbdb-current-field. NB this is fixed for the
+ default display address. I need to tweak further for continental address
+ display, maybe.
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ * Trying another way to get the from field, since the Presentation
+ buffer hack seems to be somewhat unusable.
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ * Fixed docstring for bbdb-quiet-about-name-mismatches
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ * Documented changes in database structure
+ * Changed web address, email addresses
+ * Some minor typos corrected & details added
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ * Added CVS revision discards to tarball exclude list.
+
+2000-06-14 Ronan Waide <waider@waider.ie>
+
+ * made notes merging use bbdb-merge-strings.
+
+2000-05-29 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-05-25 Ronan Waide <waider@waider.ie>
+
+ Fixed a broken link & updated the archive information
+
+2000-05-25 Ronan Waide <waider@waider.ie>
+
+ Updated some of the test targets
+
+2000-05-02 Sam Steingold <sds@goems.com>
+
+ * lisp/bbdb.el, lisp/bbdb-com.el: define `unless' and `when' if
+ necessary, do not quote `lambda' in code, do quote (`') functions and
+ variables in doc strings.
+ * lisp/bbdb.el (bbdb-get-field): new helper function.
+ * lisp/bbdb-com.el (bbdb-notes-sort-order): new variable
+ (bbdb-sort-notes, bbdb-sort-phones, bbdb-sort-addresses): new functions,
+ suitable for `bbdb-change-hook'.
+ (bbdb-get-record): new helper function.
+ * lisp/bbdb-w3.el (bbdb-www): do not browse to multiple URLs
+ simultaneously, allow multiple URLs for the same record instead.
+ (bbdb-www-grab-homepage): add the URL if there is such a fields already.
+
+2000-05-01 Ronan Waide <waider@waider.ie>
+
+ * "API" is a little more settled, also a little more obvious.
+ * Making use of more of the existing functions in bbdb-com
+
+2000-05-01 Ronan Waide <waider@waider.ie>
+
+ * Tweaked layout and added a CVS revision tag.
+
+2000-05-01 Ronan Waide <waider@waider.ie>
+
+ Initial checkin
+
+2000-05-01 Ronan Waide <waider@waider.ie>
+
+ Initial checkin
+
+2000-05-01 Ronan Waide <waider@waider.ie>
+
+ Initial creation of the BITS tree
+
+2000-04-21 Ronan Waide <waider@waider.ie>
+
+ * documentation corrections
+ * Added timestamp compare to bbdb-refile-notes-generate-alist
+
+2000-04-21 Ronan Waide <waider@waider.ie>
+
+ * Refined so it works a little better, particularly with mergeing
+ timestamps
+ * Added bbdb-merge-file, so you can now import another bbdb and merge
+ it.
+
+2000-04-19 Ronan Waide <waider@waider.ie>
+
+ * First cut at merging with a view towards syncing, as opposed to
+ simply cramming everything together a la refile.
+
+2000-04-17 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ *** empty log message ***
+
+2000-04-17 Ronan Waide <waider@waider.ie>
+
+ omitted bracket on unmigrate for v5->v4
+
+2000-04-16 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ bbdb-print documentation Fix \bigbf
+
+2000-04-16 Ronan Waide <waider@waider.ie>
+
+ * Added 5->4 unmigration
+
+2000-04-15 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Adopt TeX-output of streets to new file-format v5.
+
+2000-04-15 Ronan Waide <waider@waider.ie>
+
+ * Fixed misplaced bracket in street migration code.
+
+2000-04-13 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Fix comment regarding mailing lists.
+
+2000-04-13 Jochen Küpper <bbdb@jochen-kuepper.de>
+
+ Improved TeX output (fonts, breaks).
+
+2000-04-13 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-04-13 Ronan Waide <waider@waider.ie>
+
+ * Address layout patch, including Euro addresses and the streets->list
+ thing
+
+2000-04-13 Ronan Waide <waider@waider.ie>
+
+ * Added keymap C-: for bbdb/gnus-summary-show-all-recipients
+
+2000-04-13 Ronan Waide <waider@waider.ie>
+
+ * Thomas's duplicates patch
+
+2000-04-13 Ronan Waide <waider@waider.ie>
+
+ * Thomas' duplicates patch
+ * streets modification
+
+2000-04-12 Ronan Waide <waider@waider.ie>
+
+ * commented out enough to get it working with the streets -> list mod.
+
+2000-04-12 Ronan Waide <waider@waider.ie>
+
+ * Added v5 migration. NB no back-migration yet.
+
+2000-04-12 Ronan Waide <waider@waider.ie>
+
+ * Thomas Deweese's multiple-same-name-records patch
+ * "streets" is now a list, not street1 street2 street3
+ * relaxed zip checking a little.
+ * new function: bbdb-add-new-field. allows you to programatically
+ add properties to the bbdb file.
+
+2000-04-12 Ronan Waide <waider@waider.ie>
+
+ Cleanup work
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ * Autoload cookie for bbdb-header-start
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ * Country patch
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ * Colin's show-all-recipients
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ * Country patch
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ Initial.
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ * Country patch
+
+2000-04-05 Ronan Waide <waider@waider.ie>
+
+ * Added Alex's BBDB v4 format migration (country field)
+
+2000-03-31 Ronan Waide <waider@waider.ie>
+
+ (bbdb/vm-get-from): If there's a presentation buffer, get the address
+ from there, since it will be MIME-decoded.
+
+2000-03-30 Ronan Waide <waider@waider.ie>
+
+ *** empty log message ***
+
+2000-03-30 Ronan Waide <waider@waider.ie>
+
+ (bbdb-annotate-notes): do not add a repeated annotation (Sam Steingold)
+
+2000-03-30 Ronan Waide <waider@waider.ie>
+
+ Added gareth rees' patch to improve bbdb-mode documentation.
+
+2000-03-30 Ronan Waide <waider@waider.ie>
+
+ Added Noah Friedman's patch to make completion work as documented.
+
+2000-03-30 Ronan Waide <waider@waider.ie>
+
+ Fixed xref entries per mail from gareth rees.
+
+1999-01-26 Matt Simmons <simmonmt@acm.org>
+
+ Don't freak out on 0-line Article buffers (pgnus)
+
+1999-01-26 Matt Simmons <simmonmt@acm.org>
+
+ Make e-mail addresses scale properly
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Add autoload cookie for bbdb-snarf-region
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Added bbdb/gnus-snarf-signature
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Set-text-properties to nil in bbdb-string-trim
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Protect mark in bbdb-redisplay-records
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Use Info-directory-list
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Nil out hooks to keep view-mode from interfering with bbdb-mode
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Don't use concat with integers
+
+1999-01-25 Matt Simmons <simmonmt@acm.org>
+
+ Added bbdb/gnus-snarf-signature
+
+1999-01-01 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1999-01-01 Matt Simmons <simmonmt@acm.org>
+
+ BBDB 2.00.05
+
+1999-01-01 Matt Simmons <simmonmt@acm.org>
+
+ Fold in 1.8.1.x subtree
+
+1999-01-01 Matt Simmons <simmonmt@acm.org>
+
+ Added instructions for those without make
+
+1998-12-31 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-12-31 Matt Simmons <simmonmt@acm.org>
+
+ Customize bbdb-snarf-web-prop, make it use the www field instead of web.
+
+1998-12-31 Matt Simmons <simmonmt@acm.org>
+
+ Run the bbdb-load-hook after the bbdb provide.
+
+1998-12-31 Matt Simmons <simmonmt@acm.org>
+
+ Protect against null record
+
+1998-12-31 Matt Simmons <simmonmt@acm.org>
+
+ bbdb-version should insert the version into the current buffer if
+ invoked with a prefix.
+
+1998-12-30 Matt Simmons <simmonmt@acm.org>
+
+ Let bbdb-current-field handle blank users
+
+1998-12-05 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-12-05 Matt Simmons <simmonmt@acm.org>
+
+ Allow redundant expansions
+
+1998-12-05 Matt Simmons <simmonmt@acm.org>
+
+ bbdb/gnus-show-sender should refer to summary buffer, not article
+ buffer.
+
+1998-12-05 Matt Simmons <simmonmt@acm.org>
+
+ Honor bbdb-user-mail-names.
+
+1998-12-05 Matt Simmons <simmonmt@acm.org>
+
+ Remove extent-data
+
+1998-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Correct escaping of mailing list address
+
+1998-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Change mailing list address
+
+1998-10-17 Matt Simmons <simmonmt@acm.org>
+
+ Patch to convert default area code protection from condition-case to
+ integerp.
+
+1998-10-17 Matt Simmons <simmonmt@acm.org>
+
+ Removed RCS logs in comments. Applied patch to protect bbdb-info-file,
+ and to protect against non-integer default area code
+
+1998-10-10 Matt Simmons <simmonmt@acm.org>
+
+ From slbaur - Switch from `screen' functions to `frame' functions
+
+1998-10-10 Matt Simmons <simmonmt@acm.org>
+
+ From slbaur: set-extent-attribute -> set-extent-property,
+ set-extent-data -> set-extent-property
+
+1998-10-10 Matt Simmons <simmonmt@acm.org>
+
+ From slbaur - Use new name for set-window-buffer-dedicated.
+
+1998-10-10 Matt Simmons <simmonmt@acm.org>
+
+ From slbaur: Don't pass an integer to concat. Format dates with number
+ format - not string - so we get leading zeros.
+
+1998-10-10 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Added EOL list, EOL'd advertized-bbdb-delete-current-field-or-record and
+ GNUS support. Documented new bindings in *BBDB* buffer.
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Colin Rafferty's patch adding autoload cookies back. Changed prompts for
+ bbdb-phones, bbdb-net, bbdb-company, bbdb-name and bbdb to make them
+ more intuitive. Started to remove support for
+ advertized-bbdb-delete-current-field-or-record. Fixed error in comment.
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Changed documentation for bbdb-load-hook, added bbdb-initialize hook.
+ Began to remove support for
+ advertized-bbdb-delete-current-field-or-record. Moved everything except
+ the insinuation code out of bbdb-initialize. Added bbdb-mode-search-map
+ for search commands in BBDB buffer prefixed by S. Added more bindings
+ to BBDB buffer
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Updated the XEmacs packaging version number
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Fix for compatibility with more makes
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Colin Rafferty's patch adding autoload cookies back, regenerated
+ auto-autoloads file.
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Colin Rafferty's patch adding autoload cookies back. Made
+ `format-time-string' take two arguments for XEmacs 19.15.
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Colin Rafferty's patch adding autoload cookies back
+
+1998-04-11 Matt Simmons <simmonmt@acm.org>
+
+ Colin Rafferty's patch adding autoload cookies back
+
+1998-03-16 Matt Simmons <simmonmt@acm.org>
+
+ Released 2.00
+
+1998-03-16 Matt Simmons <simmonmt@acm.org>
+
+ intermediate
+
+1998-03-13 Matt Simmons <simmonmt@acm.org>
+
+ This is for version 2.00
+
+1998-03-13 Matt Simmons <simmonmt@acm.org>
+
+ Colin's fix for properly counting the size of notes fields
+
+1998-03-13 Matt Simmons <simmonmt@acm.org>
+
+ Colin's change for migration error message
+
+1998-03-13 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Finished revision
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Fixed defface standin. Created widget (bbdb-alist-with-header) for
+ bbdb-auto-notes-alist customization fix. Changed defaults for
+ bbdb-create-hook and bbdb-change-hook to create timestamp and
+ creation-date fields. Added autoload for bbdb-srv.
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Fix for Carsten Leonhardt to not die if XEmacs compiled without
+ scrollbar support
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ buffer-disable-undo doesn't always return the argument
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Protecting bbdb-default-area-code
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Fixed customization of bbdb-auto-notes-alist
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Colin's new refiling code, protecting default-area-code
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Finally fixed that damn 19.34 :link problem - needed to put OTHERDIR
+ stuff first in the load-path before loading bbdb.el.
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Added comment about the Custom requirement for building Gnus support
+ under 19.34
+
+1998-03-10 Matt Simmons <simmonmt@acm.org>
+
+ Removed my paths, added comments about the Custom requirement for
+ building Gnus support under 19.34
+
+1998-02-24 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Support for OTHERDIR, rearranged flags to Emacs so we can use
+ bbdb-split-string (19.34 doesn't have split-string)
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Fixed intro comments. Use add-hook, not bbdb-add-hook
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Created deffaces standing macro, added to bbdb-initialize for bbdb-print
+ and bbdb-ftp, added autoload for bbdb-com, use native add-hook if we
+ can, fset it to bbdb-add-hook otherwise.
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Use add-hook, not bbdb-add-hook
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Moved key binding to bbdb.el, changed default of bbdb-print-elide, fixed
+ problem with nil bbdb-default-area-code
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Use add-hook
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ We use add-hook now
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Alphabetized MUA directory variables, added OTHERDIR variable
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Changed comments for Gnus/GNUS-specific stuff and for stuff that thought
+ it was specific but is really not. bbdb/gnus-summary-author-in-bbdb now
+ uses `bbdb-message-marker-field' as it said it did. Using add-hook
+ instead of bbdb-add-hook.
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Intro rewrite to say that EFS is also OK as a prereq
+
+1998-02-23 Matt Simmons <simmonmt@acm.org>
+
+ Almost finished doc rewrite
+
+1998-02-22 Matt Simmons <simmonmt@acm.org>
+
+ Initial revision
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Changed to `setq' to `add-hook' in setup instructions. Added to
+ Internals section.
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Fixed bug
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Added deploy target. Added migrate.el
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Added define-widget definition for users without Custom. Added Custom
+ groups for utilities (print, finger, etc). Moved migration code to
+ bbdb-migrate.el. Commented some code (mostly code dealing with the
+ manipulation of the internal database representation). Added code to
+ `bbdb-initialize' that allows for the selective insinuation of the BBDB
+ into various external packages.
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Removed autoloads
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Added `part of BBDB' to copyright. Customized variables.
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Removed autoloads and added provide for bbdb-w3
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Rearranged copyright and customized variables
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Customized variables, removed autoloads, and added provide of bbdb-sc
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Changed setup documentation and added RCS ID and Log strings
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Customized variables and removed autoloads
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Initial revision
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Added provide of bbdb-hooks. Fixed custom specs (added cons type
+ instead of group where appropriate). Replaced bbdb-time-string function
+ with bbdb-time-internal-format variable.
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Removed autoloads and when statements
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Customized variables (into utilities-ftp group). Added provide.
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Fixed copyright, moved customized finger variables into utilities-finger
+ group (from finger). Removed autoloads.
+
+1998-01-06 Matt Simmons <simmonmt@acm.org>
+
+ Removed all autoloads except for the `bbdb-initialize' one. The removal
+ was done because bbdb-initialize a) must be called before anything else
+ in the BBDB will work and b) contains all of the autoloads found in
+ auto-autoloads anyway.
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Startup code documentation
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Reintroduced for BBDB 1.57Aunoff
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Documented new startup procedure
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Initial revision
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Removed `BBDB database' per jwz, added prerequisites section, more
+ description of special fields, and dissection of record format in
+ internals section
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ We now distribute *.info*, so removed its deletion from clean target.
+ Created reallyclean target to get rid of *.info*
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Added migration code, customized variables, created record-copying
+ function, moved automatically-executing code into bbdb-initialize
+ function, documented defstruct.
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Soren Dayton's fix to correct tilde printing
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Customized, added sshteingold@cctrading.com's change to time-string
+ function to use a format string.
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Customized variables, changed some comments, changed user format code
+ error message
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Added sshteingold@cctrading.com's date-based database-manipulation
+ functions. Customized variables.
+
+1997-12-01 Matt Simmons <simmonmt@acm.org>
+
+ Autoloads for date functions in bbdb-com.el
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Welcome to the family. Moved the automatically running code into
+ functions. Generalized attribution field.
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Added bbdb-warn and code to avoid it for XEmacs users. Reformatted
+ autoloads (again). Autoloads for sc.
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ bbdb/rmail-annotate-sender now takes REPLACE argument
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ bbdb/mh-annotate-sender now takes REPLACE argument
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ bbdb/vm-annotate-sender now takes REPLACE argument
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Added REPLACE argument to bbdb/gnus-annotate-sender. Variable to catch
+ changes to bbdb/gnus-score-default. Commented out most of score
+ insinuation code. Variable aliases. Added in-bbdb format letter.
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Support for bbdb-sc. Housekeeping for others.
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Fixed package install - `foo 'bar` (as opposed to `foo 'bar'`) works in
+ Bourne shell, but not in others. That and it's not exactly intuitive.
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Support for bbdb-sc.el
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ Rewrite Part 2 (through MUA-specific features)
+
+1997-11-02 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ New autoloads. Override bbdb-display-completion-list for XEmacs users
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ Rewrite part 1
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ Build the dvi if the user wants
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ Installation timing change: .el before .elc. Tried to optimize install
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ finger-host fixes. New function `bbdb-xemacs-display-completion-list'
+ is an XEmacs version of `bbdb-display-completion-list', which is a
+ wrapper for display-completion-list.
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ Use browse-url-browser-function rather than a funcall
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ Integration of Brian Edmonds <edmonds@cs.ubc.ca>'s gnus-bbdb.el. Got
+ scoring and summary buffer stuff. Need to do splitting
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ Fix name completion bug (original fix by Marco Walther
+ <Marco.Walther@mch.sni.de>, mangled beyond recognition by Matt Simmons
+ <simmonmt@acm.org> Docs for bbdb-finger by Christoph Wedler
+ <wedler@fmi.uni-passau.de>
+
+1997-10-26 Matt Simmons <simmonmt@acm.org>
+
+ autoloads for new functions in bbdb-xemacs and bbdb-gnus
+
+1997-10-16 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-12 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-12 Matt Simmons <simmonmt@acm.org>
+
+ Changed VM, GNUS, and MHE definitions. If the corresponding DIR
+ variables are set, the (the DIR vars) are added to load-path. The
+ relevant el files are then loaded using the load-path. This allows
+ VMDIR, et al to be unset if the packages live in load-path by default.
+ Added bbdb-snarf and bbdb-w3. Made the bbdb-srv and bbdb-reportmail
+ skip messages more informative for the poor souls (FSF Emacs users) who
+ can't use them. Added a check for itimer, since apparently some FSF
+ Emacs users have installed gnuserv - without itimer, bbdb-srv still
+ won't compile.
+
+1997-10-12 Matt Simmons <simmonmt@acm.org>
+
+ Added bbdb-insinuate-w3 to set keyboard map correctly. Merged
+ bbdb-www-netscape into bbdb-www using browse-url-browser-function to
+ differentiate.
+
+1997-10-12 Matt Simmons <simmonmt@acm.org>
+
+ Autoloads for bbdb-www, bbdb-snarf, bbdb-insinuate-message
+
+1997-10-12 Matt Simmons <simmonmt@acm.org>
+
+ Added documentation and keymap definition for bbdb-www. Added autoloads
+ for bbdb-www (and friends), bbdb-snarf, and bbdb-insinuate-message
+
+1997-10-12 Matt Simmons <simmonmt@acm.org>
+
+ Kees de Bruin <kees_de_bruin@tasking.nl>'s patch to make VM use
+ canonicalized net address instead of default address.
+
+1997-10-11 Matt Simmons <simmonmt@acm.org>
+
+ Created bbdb-insinuate-message to set M-t binding in message-mode so I
+ don't have to load gnus first.
+
+1997-10-11 Matt Simmons <simmonmt@acm.org>
+
+ Message-mode fixes from Kees de Bruin <kees_de_bruin@tasking.nl>
+
+1997-10-11 Matt Simmons <simmonmt@acm.org>
+
+ Removed my paths from VMDIR and MHEDIR. Seems I had broken the
+ documented 'if these are blank and the packages live on load-path, Emacs
+ will find them' behavior by dying if VMDIR, MHEDIR and GNUSDIR weren't
+ set. It's fixed now.
+
+1997-10-11 Matt Simmons <simmonmt@acm.org>
+
+ Modifications mailed in by David Carlton <carlton@math.mit.edu>. They
+ look to be mostly adaptations for netscape
+
+1997-10-11 Matt Simmons <simmonmt@acm.org>
+
+ Initial revision
+
+1997-10-11 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ BBDB 1.53unoff
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ Initial revision
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ Fixed for new grand reorg. Rewrote XEmacs package installation code.
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ Version number format changes
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ jwz patches to support caller ID script, mail/news classification
+ routine, make sure *BBDB* is bottommost buffer
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ New version of bbdb-print from Boris Goldowsky <boris@gnu.ai.mit.edu>
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ Jamie Zawinski <jwz@netscape.com>'s comment change about the new area
+ codes that aren't restricted to [012] in the second digit.
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ Initial revision
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-10-06 Matt Simmons <simmonmt@acm.org>
+
+ New version of bbdb-print from Boris Goldowsky
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ Some reformatting, removal of mail-abbrev and mail-extr, fixed gnus path
+ stuff (since gnus is no longer distributed with xemacs-20.3
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ Fix to accomodate nil gnus-single-article-buffer
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ Added check for EFS (there must be a better way that what I did, but I
+ really don't want to be reduced to checking version strings.
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ Fixed area code parsing for new US area codes. Patches integrated: use
+ of message-mail for sending mail, finger-host record for fingering
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ Began to fix some obsolete functions to shut up the compiler, integrated
+ some patches (see ChangeLog) to allow use of message-mail for sending
+ mail and nil names.
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
+1997-09-28 Matt Simmons <simmonmt@acm.org>
+
+ *** empty log message ***
+
--- /dev/null
+2017-10-17 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-parse-records): Bug fix, hash record after
+ checking for duplicates.
+
+2017-10-11 Roland Winkler <winkler@gnu.org>
+ * configure.ac: Use it.
+ * lisp/bbdb.el: Mention new mailing list bbdb-user@nongnu.org.
+
+2017-10-11 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-parse-records): Query before migrating BBDB
+ to new format.
+ (bbdb-delete-record-internal, bbdb-insert-record-internal)
+ (bbdb-overwrite-record-internal): Barf if buffer is read-only.
+
+2017-10-11 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-search, bbdb-split-maybe): Fix docstring.
+ (bbdb-read-record): Fix calling sequence for calls to set record.
+
+2017-08-09 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-migrate.el (bbdb-migrate-uuid-xfield): New variable.
+
+2017-08-09 Roland Winkler <winkler@gnu.org>
+ New field uuid. Make creation-date and timestamp immutable.
+ * lisp/bbdb.el (bbdb-create-hook, bbdb-change-hook): Use
+ defcustom.
+ (bbdb-merge-records-function): New variable.
+ (bbdb-layout-alist): Omit uuid.
+ (bbdb-xfields-sort-order, bbdb-merge-xfield-function-alist):
+ Ignore creation-date and timestamp.
+ (bbdb-file-format): Bump to 9.
+ (bbdb-record-type): Include uuid, creation-date and timestamp.
+ (bbdb-uuid-table): New variable.
+ (bbdb-timestamp, bbdb-creation-date): Declare obsolete.
+ (bbdb-uuid): New function.
+ (bbdb-hash-record): Hash uuid.
+ (bbdb-record-field, bbdb-record-set-field, bbdb-buffer)
+ (bbdb-display-record-one-line, bbdb-display-record-multi-line)
+ (bbdb-display-record): Handle uuid, creation-date and timestamp.
+ (bbdb-change-record): Use uuid.
+ * lisp/bbdb-com.el (bbdb-search): Use keywords for args. Handle
+ uuid, creation-date and timestamp. New option :bool.
+ (bbdb, bbdb-search-name, bbdb-search-organization)
+ (bbdb-search-address, bbdb-search-mail, bbdb-search-phone)
+ (bbdb-search-xfields, bbdb-mail-aliases, bbdb-get-mail-aliases):
+ Change accordingly.
+ (bbdb-compare-records): Compare any fields.
+ (bbdb-timestamp-older, bbdb-timestamp-newer, bbdb-creation-older)
+ (bbdb-creation-newer): Fix interactive spec.
+ (bbdb-creation-no-change): Use bbdb-record-timestamp.
+ (bbdb-read-record): Use bbdb-empty-record.
+ (bbdb-create): Fix call of bbdb-change-record.
+ (bbdb-split-maybe): New function.
+ (bbdb-create-internal): Use keywords for args.
+ (bbdb-edit-field, bbdb-edit-foo, bbdb-merge-records): Handle uuid,
+ creation-date and timestamp.
+ (bbdb-delete-records): Ignore records not known to BBDB.
+ * lisp/bbdb-snarf.el (bbdb-snarf)
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Fix call of
+ bbdb-change-record.
+ * lisp/bbdb-migrate.el (bbdb-migration-features): Remove.
+ (bbdb-peel-the-onion): Merge with bbdb-migrate.
+ (bbdb-migrate): Handle format 9.
+ (bbdb-migrate-alist): Rename from bbdb-migration-spec.
+ (bbdb-migrate-record-lambda): Merge with bbdb-migrate-lambda.
+ (bbdb-migrate-lambda): Rename from bbdb-migrate-versions-lambda.
+ (bbdb-migrate-postcode-to-string): Rename from
+ bbdb-migrate-postcodes-to-strings. Simplify.
+ (bbdb-migrate-dates): Rename from bbdb-migrate-change-dates.
+ Simplify.
+ (bbdb-migrate-add-country): Rename from
+ bbdb-migrate-add-country-field.
+ (bbdb-undocumented-variables): Handle byte-obsolete-variable.
+
+2017-07-25 Roland Winkler <winkler@gnu.org>
+ * Makefile.am: Fix rule BBDB_ELPA_FILES. (Bug#51563)
+
+2017-07-25 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-tex.el: Improve documentation.
+
+2017-07-25 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-tex.el (bbdb-tex): Bug fix. (Bug#51564)
+
+2017-07-21 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-split): Fix previous patch.
+
+2017-07-21 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-split): Use arg TRIM of split-string with
+ emacs-version >= 24.4.
+
+2017-07-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-tex.el (bbdb-tex): Allow empty space when calling
+ \usepackage.
+
+2017-07-19 Roland Winkler <winkler@gnu.org>
+ * tex/bbdb.sty: Use \RequirePackage.
+
+2017-07-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-tex.el (bbdb-tex-alist): Improve docstring.
+
+2017-07-03 Roland Winkler <winkler@gnu.org>
+ Use LaTeX for TeXing BBDB.
+ * lisp/bbdb-tex.el: Replacement for lisp/bbdb-print.el.
+ * lisp/bbdb-site.el.in (bbdb-tex-path): Renamed from
+ bbdb-print-tex-path. Allow new value t.
+ * lisp/bbdb.el (bbdb-utilities-tex): Renamed from
+ bbdb-utilities-print.
+ (bbdb-separator-alist): New element tex-name. Fix docstring.
+ * lisp/makefile-temp, lisp/Makefile.am: Use bbdb-tex.
+ * tex/bbdb-print-brief.tex, tex/bbdb-cols.tex, tex/bbdb-print.tex:
+ Removed.
+ * tex/bbdb.sty: New file.
+ * tex/Makefile.am: Update accordingly.
+
+2017-01-31 Roland Winkler <winkler@gnu.org>
+ * README: Really discontinue support for GNU Emacs 23.
+
+2017-01-30 Barak A. Pearlmutter <barak@pearlmutter.net>
+ * TODO: Extend feature wishlist.
+
+2017-01-30 Barak A. Pearlmutter <barak@pearlmutter.net>
+ * README: Add pointer to emacs wiki upgrade page.
+
+2017-01-30 Roland Winkler <winkler@gnu.org>
+ * README, lisp/bbdb-site.el.in: Discontinue support for GNU Emacs
+ 23.
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el (bbdb-anniv-diary-entries): Propertize the
+ strings passed to diary-add-to-list.
+ (bbdb-anniv-goto-entry): New function used as
+ diary-goto-entry-function.
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el (bbdb-anniv-diary-entries): Use cl-flet.
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el: Use lexical binding.
+ * lisp/bbdb-anniv.el (bbdb-anniv-diary-entries): Use lexical
+ environment for eval.
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+ Discontinue support for old GNU Emacs 23.
+ * lisp/bbdb.el (bbdb-buffer, bbdb-revert):
+ * lisp/bbdb-com.el (bbdb-complete-mail): Update accordingly.
+
+2017-01-28 Roland Winkler <winkler@gnu.org>
+ Update copyright year in all files.
+
+2016-10-02 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el, lisp/bbdb-gnus.el, lisp/bbdb-ispell.el:
+ * lisp/bbdb-message.el, lisp/bbdb-mhe.el, lisp/bbdb-migrate.el:
+ * lisp/bbdb-mu4e.el, lisp/bbdb-mua.el, lisp/bbdb-pgp.el:
+ * lisp/bbdb-print.el, lisp/bbdb-rmail.el, lisp/bbdb-sc.el:
+ * lisp/bbdb-site.el.in, lisp/bbdb-snarf.el, lisp/bbdb-vm.el:
+ * lisp/bbdb-wl.el, lisp/bbdb.el: Use lexical binding.
+
+ * lisp/bbdb.el (bbdb-alist-with-header): Start name of unused
+ variables with underscore.
+ (bbdb-display-record-multi-line, bbdb-display-records): Remove
+ unused variable.
+ * lisp/bbdb-com.el (bbdb-omit-record):
+ * lisp/bbdb-snarf.el (bbdb-snarf-surrounding-space)
+ (bbdb-snarf-empty-lines):
+ * lisp/bbdb-migrate.el (bbdb-undocumented-variables): Start name
+ of unused variables with underscore.
+ * lisp/bbdb-mua.el (bbdb-get-address-components):
+ * lisp/bbdb-print.el (bbdb-print-record): Remove unused variable.
+ * lisp/bbdb-gnus.el: Autoload message-make-domain.
+ (bbdb/gnus-score-as-text): Start name of unused variables with
+ underscore.
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-display-record-one-line)
+ * lisp/bbdb-snarf.el (bbdb-snarf-label, bbdb-snarf-phone-nanp):
+ Use 2nd arg of looking-back.
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+ Update copyright year in all files.
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-mode-alist): Add support for
+ mu4e-compose-mode and notmuch-message-mode which are derived from
+ message-mode.
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+ * m4/emacs_wl.m4: New file
+ * configure.ac: Use it.
+ * NEWS, README: Document support for Wanderlust
+
+2016-07-20 David Maus <dmaus@dmaus.name>
+ Add basic support for Wanderlust.
+ * lisp/Makefile.am, lisp/makefile-temp: Support Wanderlust.
+ * lisp/bbdb-mua.el (bbdb-mua-mode-alist, bbdb-mua)
+ (bbdb-message-header, bbdb-mua-update-records, bbdb-mua-wrapper):
+ Add support for Wanderlust.
+ (bbdb-mua-auto-update-init): Add wanderlust to list of auto-update
+ muas.
+ * lisp/bbdb.el (bbdb-init-forms): Add support for Wanderlust.
+ * lisp/bbdb-wl.el: New file.
+
+2016-07-20 Marco Wahl <marcowahlsoft@gmail.com>
+ * lisp/bbdb-com.el (bbdb-omit-record): Fix arg list of
+ bbdb-redisplay-record.
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+ Make bbdb-hashtable a proper hash table.
+ * lisp/bbdb.el (bbdb-hashtable): Use make-hash-table.
+ (bbdb-puthash, bbdb-gethash, bbdb-remhash, bbdb-buffer)
+ * lisp/bbdb-com.el (bbdb-completion-predicate)
+ (bbdb-completing-read-records, bbdb-complete-mail): Use it.
+
+2016-07-20 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-add-to-list): Remove.
+ (bbdb-pushnew, bbdb-pushnewq, bbdb-pushnewt): New macros.
+ (bbdb-record-set-xfield, bbdb-record-set-field)
+ (bbdb-merge-concat-remove-duplicates, bbdb-parse-records)
+ (bbdb-change-record)
+ * lisp/bbdb-com.el (bbdb-mail-aliases, bbdb-get-mail-aliases)
+ (bbdb-add-mail-alias)
+ * lisp/bbdb-mua.el (bbdb-update-records): Use them.
+
+2015-11-14 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-auto-revert, bbdb-dedicated-window)
+ (bbdb-default-domain, bbdb-mua-pop-up)
+ (bbdb-horiz-pop-up-window-size, bbdb-xfields-sort-order)
+ (bbdb-mua-summary-unification-list, bbdb-mail-avoid-redundancy)
+ * lisp/bbdb-snarf.el (bbdb-snarf-address-us-country)
+ (bbdb-snarf-address-eu-country)
+ * lisp/bbdb-anniv.el (bbdb-anniv-alist)
+ * lisp/bbdb-vm.el (bbdb/vm-virtual-real-folders)
+ * lisp/bbdb-gnus.el (bbdb/gnus-score-default)
+ (bbdb/gnus-split-myaddr-regexp, bbdb/gnus-split-private-field)
+ (bbdb/gnus-split-public-field)
+ * lisp/bbdb-sc.el (bbdb-sc-update-attrib-p): Fix defcustom.
+
+2015-11-08 Roland Winkler <winkler@gnu.org>
+ Add new snarfing rule eu for many continental European countries.
+ Improve snarfing algorithm.
+ * lisp/bbdb-snarf.el (bbdb-snarf-rule-alist): Add new rule eu.
+ (bbdb-snarf-phone-nanp-regexp, bbdb-snarf-postcode-us-regexp)
+ (bbdb-snarf-url-regexp): Improve regexp. Use first subexpression.
+ (bbdb-snarf-mail-regexp): New variable.
+ (bbdb-snarf-mail): Use it.
+ (bbdb-snarf-address-us-country): New variable.
+ (bbdb-snarf-address-us): Use it. Check whether we actually
+ snarfed an address.
+ (bbdb-snarf-phone-eu-regexp, bbdb-snarf-postcode-eu-regexp)
+ (bbdb-snarf-address-eu-country): New variables.
+ (bbdb-snarf-label): Use save-match-data.
+ (bbdb-snarf-phone-nanp): Use save-match-data. Reverse order of
+ snarfed phone numbers.
+ (bbdb-snarf-phone-eu, bbdb-snarf-address-eu): New functions.
+
+2015-11-08 Roland Winkler <winkler@gnu.org>
+ Simplify re-sorting of records when a record has been changed.
+ Re-display re-sorted records.
+ * lisp/bbdb.el (bbdb-need-to-sort): Removed.
+ (bbdb-record-set-name): Simplify accordingly.
+ (bbdb-record-set-sortkey): Always evaluate new sortkey.
+ (bbdb-record-sortkey): Simplify accordingly.
+ (bbdb-change-record): Sort records if we have a new sort key.
+ (bbdb-redisplay-record-globally): Rename from
+ bbdb-maybe-update-display. New optional arg sort.
+ (bbdb-delete-record-internal, bbdb-insert-record-internal): Do not
+ unset sort key.
+ (bbdb-display-records): Put point at beginning of buffer.
+ (bbdb-redisplay-record): New optional arg sort. Throw error if
+ record was not displayed previously.
+ (bbdb-sort-records): Clarify status message. Redisplay sorted
+ records.
+ * lisp/bbdb-com.el (bbdb-fix-records): Sort records.
+ (bbdb-create, bbdb-create-internal, bbdb-merge-records): Use nil
+ for unused second arg of bbdb-change-record.
+ (bbdb-edit-field, bbdb-transpose-fields): Do not worry about
+ re-sorting records.
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Use nil
+ for unused second arg of bbdb-change-record.
+
+2015-09-10 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el, lisp/bbdb-mu4e.el, lisp/bbdb-print.el:
+ * lisp/bbdb-snarf.el, lisp/bbdb-com.el, lisp/bbdb-message.el:
+ * lisp/bbdb-mua.el, lisp/bbdb-rmail.el, lisp/bbdb-gnus.el:
+ * lisp/bbdb-mhe.el, lisp/bbdb-pgp.el, lisp/bbdb-sc.el:
+ * lisp/bbdb-vm.el, lisp/bbdb-ispell.el, lisp/bbdb-migrate.el:
+ * lisp/bbdb-site.el.in, lisp/bbdb.el: Conform to Emacs Lisp
+ package format convention.
+ (Bug#45910)
+
+2015-09-10 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-separator-alist): Use two newline characters
+ to separate records.
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-search-changed): Fix docstring.
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-delete-field-or-record): Use delete for
+ phone and address fields.
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-copy-records-as-kill): Fix docstring.
+ Delete unused local variable marker.
+
+2015-09-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-copy-fields-as-kill): New command.
+ * lisp/bbdb.el (bbdb-separator-alist, bbdb-mode-map): Update
+ accordingly.
+
+2015-05-23 Eric Abrahamsen <eric@ericabrahamsen.net>
+ * lisp/bbdb.el (bbdb-record-set-field, bbdb-parse-records): Use
+ equal for comparison when populating lists of labels.
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+ Add basic support for mu4e mailer.
+ * NEWS, README: Update accordingly.
+ * m4/emacs_mu4e.m4: New file.
+ * configure.ac: Use it.
+ * lisp/bbdb-mu4e.el: New file.
+ * lisp/Makefile.am, lisp/makefile-temp: Compile it.
+ * lisp/bbdb.el (bbdb-init-forms): Add entry for mu4e.
+ (bbdb-initialize): Update docstring.
+ * lisp/bbdb-mua.el: Define mu4e~view-buffer-name.
+ (bbdb-mua-mode-alist): Add element for mu4e.
+ (bbdb-mua): Update docstring.
+ (bbdb-mua-update-records, bbdb-mua-wrapper): Handle mu4e.
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+ Remove variables bbdb/MUA-update-records-p.
+ * lisp/bbdb-mua.el (bbdb-update-records): Rely only on arg
+ update-p.
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records-p): Remove.
+ * lisp/bbdb-message.el (bbdb/mail-update-records-p)
+ (bbdb/message-update-records-p): Remove.
+ * lisp/bbdb-mh.el (bbdb/mh-update-records-p): Remove.
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records-p): Remove.
+ * lisp/bbdb-vm.el (bbdb/vm-update-records-p): Remove.
+ * README, NEWS: Update accordingly.
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+ Handle prefix command bbdb-do-all-records more robustly.
+ * lisp/bbdb.el (bbdb-do-all-records): New variable.
+ (bbdb-modeline-info): Add two new slots.
+ (bbdb-mode): Use them.
+ * lisp/bbdb-com.el (bbdb-prefix-message): New function.
+ (bbdb-do-all-records, bbdb-do-records): Use variable
+ bbdb-do-all-records.
+ (bbdb-append-display-p): Update displayed message.
+ (bbdb-append-display): Use bbdb-prefix-message.
+ (bbdb-search-invert): Ditto. Simplify.
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-redisplay-record): Display an undisplayed
+ record only if we do not want to delete it.
+ (bbdb-maybe-update-display): Only consider records that are
+ already displayed. Improve docstring.
+
+2015-05-22 Roland Winkler <winkler@gnu.org>
+ Update copyright year in all files.
+
+2014-08-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-print.el (bbdb-print-require): Improve docstring.
+
+2014-08-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-print.el (bbdb-print): Clarify prompt for file name.
+ Issue message on what to do with TeX file.
+
+2014-08-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-print.el (bbdb-print-record): Handle xfields the value
+ of which are sexps.
+
+2014-08-09 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-snarf.el (bbdb-snarf): Always install and display the
+ new record.
+
+2014-08-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-mail-alias-list): New function.
+ (bbdb-add-mail-alias): Handle multiple records via * prefix.
+ Allow addition or deletion of multiple aliases per record. Fix
+ docstring.
+
+2014-08-01 Roland Winkler <winkler@gnu.org>
+ * lisp/makefile-temp: Fix previous change.
+
+2014-07-22 Roland Winkler <winkler@gnu.org>
+ * lisp/Makefile.am: Do not load init files or site files for byte
+ compilation (Bug#42482). Use long options.
+ * lisp/makefile-temp: Ditto. New variable emacs_compile.
+
+2014-05-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-redisplay-record): Delete record from
+ bbdb-records if record is undisplayed.
+ * lisp/bbdb-com.el (bbdb-omit-record): Simplify. Handle records at
+ beginning and end of bbdb-buffer properly.
+
+2014-05-15 Roland Winkler <winkler@gnu.org>
+ Fix and improve previous patch.
+ * lisp/bbdb.el (bbdb-update-unchanged-records): Renamed from
+ bbdb-save-unchanged-records.
+ (bbdb-with-print-loadably): Put at beginning of bbdb.el.
+ (bbdb-change-record): Return record only if we updated it.
+ * lisp/bbdb-com.el (bbdb-touch-records): Use
+ bbdb-update-unchanged-records.
+ (bbdb-insert-field, bbdb-edit-field): Issue message if record
+ remained unchanged.
+
+2014-05-12 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-change-record): If an editing command did not
+ change a record compared to its value in bbdb-buffer, do not call
+ bbdb-change-hook and do not save it.
+ (bbdb-save-unchanged-records): New internal variable.
+ * lisp/bbdb-com.el (bbdb-touch-records): New command.
+
+2014-05-12 Roland Winkler <winkler@gnu.org>
+ * lisp/makefile-temp: Create bbdb-pkg.el from bbdb-pkg.el.in.
+
+2014-05-06 Roland Winkler <winkler@gnu.org>
+ Do not treat bbdb-change-hook special when inside
+ bbdb-notice-mail-hook or bbdb-notice-record-hook.
+ * lisp/bbdb.el (bbdb-notice-mail-hook, bbdb-notice-record-hook):
+ Update docstring.
+ (bbdb-notice-hook-pending): Remove.
+ (bbdb-change-record): Always call bbdb-change-hook if a record was
+ changed.
+ * lisp/bbdb-mua.el (bbdb-update-records, bbdb-annotate-message):
+ Change accordingly.
+
+2014-05-06 Roland Winkler <winkler@gnu.org>
+ Allow arbitrary lisp expressions as values of xfields.
+ * lisp/bbdb.el (bbdb-record-type): Update accordingly.
+ (bbdb-string-trim): New optional arg null.
+ (bbdb-record-xfield-intern): Return xfield value unmodified if it
+ is not a string.
+ (bbdb-record-xfield-string): New function.
+ (bbdb-record-xfield-split): Throw error if xfield value is not a
+ string.
+ (bbdb-record-set-xfield, bbdb-record-set-field)
+ (bbdb-merge-xfield, bbdb-display-record-one-line)
+ (bbdb-display-record-multi-line)
+ * lisp/bbdb-com.el (bbdb-search, bbdb-read-field)
+ (bbdb-edit-field, bbdb-read-xfield): Allow xfield values that are
+ not a string.
+ (bbdb-add-mail-alias): Simplify.
+
+2014-05-06 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-parse-postcode): Finish immediately if one
+ test succeeds.
+
+2014-04-27 Roland Winkler <winkler@gnu.org>
+ * configure.ac: Increase BBDB version number to 3.1.2.
+ * NEWS: Update for release.
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+ Be more careful that empty strings do not pollute the data base.
+ * lisp/bbdb.el (bbdb-list-strings): New function.
+ (bbdb-record-set-field): Use it.
+ (bbdb-record-set-xfield): Clean up.
+ * lisp/bbdb-com.el (bbdb-fix-records): New command.
+ (bbdb-read-organization, bbdb-complete-mail): Check emacs version
+ properly.
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+ Check type of record data structures more carefully.
+ * lisp/bbdb.el (bbdb-check-type): Simplify. New arg `extended'.
+ * lisp/bbdb-com.el (bbdb-create-internal): Bug fix.
+
+2014-04-12 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ * lisp/Makefile.am: Include makefile-temp in distribution.
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-site.el.in: Be more verbose about what we want.
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+ * lisp/makefile-temp: Obey proper dependencies. Clean up.
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-vm.el, m4/emacs_vm.m4: Require vm-autoloads.
+
+2014-04-12 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-separator-alist): Treat AKAs consistent with
+ other fields.
+
+2014-03-11 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ Generate lisp/bbdb-site.el via lisp/Makefile as pkgdatadir is only
+ known at "make" time.
+ * configure.ac: Remove lisp/bbdb-site.el from autoconfig files.
+ Increase BBDB version number to 3.1.1
+ * lisp/Makefile.am: Generate lisp/bbdb-site.el.
+ * lisp/bbdb-site.el.in: Initialize bbdb-print-tex-path with a
+ placeholder for pkgdatadir.
+
+2014-03-11 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ * Makefile.am: Install files COPYING, ChangeLog, AUTHORS, NEWS,
+ README, and TODO in the doc directory.
+ * doc/Makefile.am: Install bbdb.pdf in the doc directory.
+
+2014-03-11 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ * m4/package_date.m4: Use "date -u" if "date --rfc-3339" fails.
+
+2014-02-28 Roland Winkler <winkler@gnu.org>
+ * configure.ac: Increase BBDB version number to 3.1.
+ * README: Update accordingly. Fix typos.
+ * Makefile.am: Include autogen.sh in distribution.
+ * lisp/Makefile.am: Include lisp/bbdb-pkg.el in distribution.
+ * lisp/makefile-temp: Include lisp/bbdb-pkg.el.
+
+2014-02-28 Roland Winkler <winkler@gnu.org>
+ Do not use `prompt' in a non-emacs sense.
+ * lisp/bbdb.el: Do not autoload bbdb-search and bbdb-search-prompt
+ when compiling.
+ (bbdb-auto-revert, bbdb-silent, bbdb-default-domain)
+ (bbdb-default-area-code, bbdb-offer-to-create)
+ (bbdb-update-records-address): Fix docstring.
+
+ * lisp/bbdb-com.el (bbdb-search-read): Renamed from
+ bbdb-search-prompt.
+ (bbdb, bbdb-search-name, bbdb-search-organization)
+ (bbdb-search-address, bbdb-search-mail, bbdb-search-phone)
+ (bbdb-search-xfields): Change accordingly.
+ (bbdb-read-record, bbdb-create, bbdb-completing-read-records): Fix
+ docstring.
+ (bbdb-read-field): Renamed from bbdb-prompt-for-new-field. Use
+ arg flag instead of current-prefix-arg. Add docstring.
+ (bbdb-insert-field): Change accordingly. Fix docstring.
+ (bbdb-edit-foo): Change accordingly.
+
+ * lisp/bbdb-mua.el (bbdb-query-create): Renamed from
+ bbdb-prompt-for-create.
+ (bbdb-update-records)
+ * lisp/bbdb.el (bbdb-insert-field-menu): Change accordingly.
+
+2014-02-28 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el: Do not autoload bbdb-search and bbdb-search-prompt
+ when compiling.
+ (bbdb-address-format-list, bbdb-buffer, bbdb-revert-buffer)
+ * lisp/bbdb-com.el (bbdb-complete-mail): Fix docstring.
+
+2014-02-17 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): If value of arg update-p
+ is a function, evaluate it repeatedly as many times as needed.
+
+2014-02-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): Bug fix for previous
+ commit. Allow value of update-p being create, too.
+
+2014-02-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): Always evaluate arg
+ update-p twice if its value is a function.
+
+2014-01-23 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-puthash, bbdb-record-set-xfield)
+ (bbdb-record-set-field, bbdb-parse-records, bbdb-change-record):
+ Bugfix, make 'eq the 4th arg of add-to-list.
+
+2014-01-23 Stefan Monnier <monnier@iro.umontreal.ca>
+ * lisp/bbdb.el (bbdb-read-string): In
+ minibuffer-local-completion-map remove the binding of SPC to
+ minibuffer-complete-word and of ? to minibuffer-completion-help.
+
+2014-01-12 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-pop-up-window-simple): New function.
+ (bbdb-pop-up-window): Use it. Make sure the *BBDB* buffer exists.
+ Use display-buffer as an alternative to pop-up-buffer if the
+ *BBDB* buffer is not selected. Use the tallest window even if
+ bbdb-pop-up-window-size is 1.0.
+ (bbdb-pop-up-window-size): Fix docstring accordingly.
+ * lisp/bbdb-com.el (bbdb-complete-mail-cleanup): Do not call
+ bbdb-pop-up-window before we created for sure the *BBDB* buffer.
+
+2014-01-12 Roland Winkler <winkler@gnu.org>
+ Provide auto completion for streets and postcodes known to BBDB.
+ * lisp/bbdb.el (bbdb-street-list, bbdb-postcode-list): New
+ internal variables.
+ (bbdb-record-set-xfield, bbdb-parse-records)
+ * lisp/bbdb-com.el (bbdb-record-edit-address)
+ (bbdb-edit-address-default): Use them.
+
+2014-01-08 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-canonical-hosts, bbdb-canonicalize-mail-1)
+ (bbdb-message-clean-name-default): Move here from bbdb-mua.el.
+
+2014-01-08 Roland Winkler <winkler@gnu.org>
+ Provide auto completion for cities, states and countries known to
+ BBDB.
+ * lisp/bbdb.el (bbdb-city-list, bbdb-state-list)
+ (bbdb-country-list): New internal variables.
+ (bbdb-add-to-list): New function.
+ (bbdb-puthash, bbdb-merge-concat-remove-duplicates)
+ (bbdb-change-record): Use add-to-list.
+ (bbdb-record-set-xfield, bbdb-parse-records): Use add-to-list and
+ bbdb-add-to-list. Collect cities, states and countries known to
+ BBDB.
+ * lisp/bbdb-com.el (bbdb-record-edit-address)
+ (bbdb-edit-address-default): Provide auto completion for cities,
+ states and countries.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Update copyright year in all files.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Avoid hard-coded references to xfield notes.
+ * lisp/bbdb.el (bbdb-default-xfield, bbdb-edit-foo)
+ (bbdb-annotate-field, bbdb-mua-edit-field): New variables.
+ (bbdb-auto-notes-rules): Fix docstring.
+ * lisp/bbdb-com.el (bbdb-edit-foo): New command.
+ (bbdb-search, bbdb-read-record): Use bbdb-default-xfield.
+ (bbdb-insert-field): Do not handle initial value.
+ (bbdb-prompt-for-new-field): Replace arg init by arg record to
+ handle initial value here.
+ * lisp/bbdb.el (bbdb-insert-field-menu): Change accordingly.
+ * lisp/bbdb-mua.el (bbdb-annotate-record): Use
+ bbdb-annotate-field. Allow empty strings for removing an xfield.
+ (bbdb-mua-annotate-field-interactive): New function.
+ (bbdb-mua-annotate-sender, bbdb-mua-annotate-recipients): Use it.
+ New optional arg field.
+ (bbdb-mua-edit-field-interactive, bbdb-mua-edit-field)
+ (bbdb-mua-edit-field-sender, bbdb-mua-edit-field-recipients): Use
+ variable bbdb-mua-edit-field.
+ (bbdb-mua-edit-field-recipients): Use bbdb-default-xfield.
+ * lisp/bbdb-snarf.el (bbdb-snarf-notes): Use bbdb-default-xfield.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ After editing always update display in all BBDB buffers.
+ * lisp/bbdb.el (bbdb-delete-record-internal): Rename optional arg
+ remhash to completely. Undisplay record if non-nil.
+ (bbdb-maybe-update-display): Update record in all BBDB buffers.
+ (bbdb-change-record): Call it.
+ (bbdb-redisplay-records): Remove.
+ (bbdb-undisplay-records): New optional arg all-buffers.
+ (bbdb-revert-buffer): Use it.
+ * lisp/bbdb-com.el (bbdb-insert-field, bbdb-transpose-fields)
+ (bbdb-delete-field-or-record, bbdb-delete-records)
+ (bbdb-merge-records, bbdb-sort-addresses, bbdb-sort-phones)
+ (bbdb-sort-xfields, bbdb-add-mail-alias)
+ * lisp/bbdb-mua.el (bbdb-mua-edit-field): Do not call
+ bbdb-maybe-update-display.
+ * README: update accordingly.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Clean up supercite support.
+ * lisp/bbdb.el (bbdb-utilities-sc): New custom group
+ (bbdb-initialize): Update docstring.
+ * lisp/bbdb-sc.el: Update doc.
+ (bbdb-sc-attribution-field): Rename from
+ bbdb/sc-attribution-field, keeping the old name as obsolete alias.
+ (bbdb-sc-update-records-p): New variable.
+ (bbdb-sc-update-attrib-p): Rename from bbdb/sc-replace-attr-p.
+ (bbdb-sc-last-attrib): Rename from bbdb/sc-last-attribution. Make
+ it internal variable.
+ (bbdb-sc-set-attrib): Rename from bbdb/sc-set-attr, keeping the
+ old name as obsolete alias.
+ (bbdb-sc-update-from): Rename from bbdb/sc-default, keeping the
+ old name as obsolete alias.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Overhaul lisp/bbdb-pgp.el for BBDB 3.
+ * lisp/bbdb-pgp.el (bbdb-pgp-field): Rename from bbdb/pgp-field.
+ (bbdb-pgp-default): Rename from bbdb/pgp-default-action.
+ (bbdb-pgp-ranked-actions, bbdb-pgp-headers)
+ (bbdb-pgp-method-alist): New variables.
+ (bbdb/pgp-quiet): Obsolete.
+ (bbdb-pgp-method): Rename from bbdb/pgp-method. Include support
+ for PGP-auto format.
+ (bbdb-read-xfield-pgp-mail): New function.
+ (bbdb-pgp): Rename from bbdb/pgp-sign. Make it a command.
+ Consider all message recipients in bbdb-pgp-headers. Use
+ bbdb-pgp-ranked-actions, bbdb-pgp-headers, and
+ bbdb-pgp-method-alist.
+ * lisp/bbdb.el (bbdb-utilities-pgp): New custom group
+ (bbdb-init-forms): Add init form for bbdb-pgp.
+ (bbdb-initialize): Update docstring accordingly.
+ * lisp/Makefile.am, lisp/makefile-temp: Support
+ lisp/bbdb-pgp.el.
+
+2014-01-03 Gijs Hillenius <gijs@hillenius.com>
+ * lisp/bbdb-pgp.el: Adapt for BBDB 3. Remove outdated mailcrypt
+ interface.
+ (bbdb/pgp-method): New default mml-pgpmime.
+ (bbdb/pgp-get-pgp): Use bbdb-message-search and bbdb-record-field.
+
+2014-01-03 Kevin Davidson <tkld@quadstone.com>
+ * lisp/bbdb-pgp.el: New file (taken from BBDB 2).
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ More flexible editing of xfields.
+ * lisp/bbdb.el (bbdb-read-string): Rename optional arg default to
+ init. New optional arg require-match.
+ * lisp/bbdb-com.el (bbdb-read-organization)
+ (bbdb-record-edit-address, bbdb-completing-read-mails): Rename
+ optional arg default to init.
+ (bbdb-insert-field): Simplify.
+ (bbdb-read-xfield): New function.
+ (bbdb-prompt-for-new-field, bbdb-edit-field): Use it.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-init-forms): Add init form for anniv.
+ (bbdb-initialize): Update docstring accordingly.
+ * lisp/bbdb-anniv.el: Update doc accordingly.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Clean up handling of redundant email addresses.
+ * lisp/bbdb.el (bbdb-ignore-redundant-mails): Rename from
+ bbdb-canonicalize-redundant-mails, keeping the latter as obsolete
+ alias.
+ (bbdb-add-mails, bbdb-canonicalize-mail-function): Fix docstring.
+ * lisp/bbdb-com.el (bbdb-mail-redundant-re): New function
+ (bbdb-delete-redundant-mails): Move here from lisp/bbdb-mua.el.
+ Merge with command bbdb-delete-duplicate-mails and make the latter
+ an obsolete alias. New optional args query and update.
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Use
+ bbdb-mail-redundant-re and bbdb-delete-redundant-mails.
+ (bbdb-mail-redundant-p): Remove.
+ (bbdb-canonical-hosts): Update docstring.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Check more carefully/frequently that BBDB is editable.
+ * lisp/bbdb.el (bbdb-editable): Move here from lisp/bbdb-com.el.
+ Revert BBDB buffer if possible.
+ * lisp/bbdb.el (bbdb-record-set-field)
+ * lisp/bbdb-com.el (bbdb-read-record, bbdb-create-internal)
+ (bbdb-merge-records, bbdb-sort-addresses, bbdb-sort-phones)
+ (bbdb-sort-xfields)
+ * lisp/bbdb-snarf.el (bbdb-snarf): Check that BBDB is editable.
+ * lisp/bbdb-mua.el (bbdb-update-records): Obey bbdb-read-only.
+ (bbdb-annotate-message): Ignore bbdb-read-only.
+ (bbdb-auto-notes): Check that BBDB is editable.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-check-name, bbdb-extract-address-components):
+ Fix docstring.
+ * lisp/bbdb-com.el (bbdb-search-duplicates): Fix warning message.
+ Sort records.
+ * lisp/bbdb-mua.el (bbdb-auto-notes)
+ (bbdb-mua-update-interactive-p): Fix docstring.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Display records for messages more flexibly.
+ * lisp/bbdb-mua.el (bbdb-update-records, bbdb-mua-update-records):
+ New optional arg sort.
+ (bbdb-mua-display-records): New optional arg all.
+ (bbdb-mua-display-all-records): New command.
+ (bbdb-mua-display-all-recipients): Renamed from
+ bbdb-display-all-recipients.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ Handle new records more carefully.
+ * lisp/bbdb.el (bbdb-empty-record): New function.
+ (bbdb-change-record): Use bbdb-create-hook. Fix docstring.
+ (bbdb-insert-record-internal, bbdb-overwrite-record-internal): Fix
+ docstring.
+ * lisp/bbdb-com.el (bbdb-create): Do not use bbdb-create-hook.
+ (bbdb-create-internal): Make arg name optional and allow a nil
+ value. Check validity of arguments only if new arg check is
+ non-nil.
+ (bbdb-merge-records): Return record.
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Use bbdb-empty-record.
+ Handle case that arg create-p is a function. Do not use
+ bbdb-create-hook.
+ * lisp/bbdb-snarf.el (bbdb-snarf): Use bbdb-empty-record. Return
+ record. Do not use bbdb-create-hook.
+
+2014-01-03 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-snarf.el (bbdb-snarf-rule-interactive): Use
+ symbol-name.
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * configure.ac: Increase BBDB version number to 3.0.50.
+
+2013-11-16 Christian Egli <christian.egli@sbs.ch>
+ * Makefile.am: New target elpa.
+ * lisp/bbdb-pkg.el.in: New file for elpa.
+ * configure.ac, .gitignore: Handle it.
+ * lisp/Makefile.am: Define CLEANFILES and EXTRA_DIST.
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * m4/package_date.m4: Use git log.
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-sc.el: Fix documentation.
+ (bbdb/sc-consult-attr): Do not use car.
+ (Bug#40398)
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-field-menu): Use format. Call
+ bbdb-browse-url for url xfields.
+ (bbdb-mouse-menu): Use format.
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mua-update-interactive-p): Clarify doc string.
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-file): Use locate-user-emacs-file.
+
+2013-11-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Only complete inside a
+ syntactically correct mail header.
+
+2013-10-06 Roland Winkler <winkler@gnu.org>
+ * lisp/makefile-temp: Add commentary. Copy bbdb-site.el.in to
+ bbdb-site.el. Clean up.
+
+ * README: Clean up.
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+ * doc/bbdb.texi: Add @dircategory and @direntry.
+ (Bug#38794)
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+ * m4/package_date.m4: Use more robust output redirection.
+ (Bug#39579)
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+ * m4/emacs_vm.m4: Fix typo.
+
+2013-07-28 Roland Winkler <winkler@gnu.org>
+ * m4/emacs_vm.m4: Define conditional VM unconditionally.
+
+2013-07-27 Roland Winkler <winkler@gnu.org>
+ * m4/emacs_vm.m4, m4/package_date.m4: New files.
+ * configure.ac: Use them. Use brackets for AC_PREREQ. Define
+ macro directory. Use Automake options -Wall and gnu.
+ * autgogen.sh: Simplify. Use option --force.
+ * lisp/bbdb-site.el.in: Renamed from lisp/bbdb-version.el.in.
+ Define bbdb-print-tex-path.
+ * lisp/bbdb.el, lisp/bbdb-print.el, lisp/Makefile.am: Update
+ accordingly.
+ * .gitignore: Cover more files.
+ * INSTALL: Remove. Merge with README.
+ * README: Update accordingly.
+
+2013-07-18 Roland Winkler <winkler@gnu.org>
+ Clean up usage of automake and autoconf.
+ * lisp/bbdb-version.el.in: New file.
+ * lisp/bbdb.el, lisp/Makefile.am: Use it.
+ * configure.ac: Use AC_CONFIG_SRCDIR. Require Automake 1.13.
+ Test for presence of Emacs. Configure lisp/bbdb-version.el.
+ * .gitignore: Ignore aclocal.m4, doc/texinfo.tex, install-sh,
+ lisp/bbdb-version.el, and missing.
+ * aclocal.m4, install-sh: Removed.
+
+2013-07-17 Roland Winkler <winkler@gnu.org>
+ Use Automake. (Thanks to Christian Egli <christian.egli@sbs.ch>)
+ * Makefile.am, lisp/Makefile.am, doc/Makefile.am, tex/Makefile.am,
+ autogen.sh, AUTHORS, NEWS: New files.
+ * Makefile.in, lisp/Makefile.in, doc/Makefile.in, tex/Makefile.in:
+ Removed.
+ * configure.ac: Use automake.
+ * INSTALL: Update accordingly.
+ * .gitignore: Ignore Makefile.in.
+
+ * lisp/bbdb-print.el (bbdb-print-tex-path): New variable.
+ (bbdb-print): Use it.
+
+2013-07-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-auto-update): Use bbdb-pop-up-layout.
+
+2013-07-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-buffer): Simplify. Avoid creating auto-save
+ files for bbdb-file till it contains at least one record.
+ * lisp/bbdb.el (bbdb-revert-buffer): Handle the case that we did
+ not yet create bbdb-file.
+
+2013-07-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-update-records-p): Fix docstring.
+
+2013-05-26 Roland Winkler <winkler@gnu.org>
+ * configure.ac: Remove option --enable-developer.
+ * lisp/Makefile.in, lisp/makefile-temp: Remove HUSHMAKE and
+ PUSHPATH. Use emacs options --quick and --directory.
+
+2013-05-26 Roland Winkler <winkler@gnu.org>
+ * aclocal.m4: Convert VM path to absolute and canonicalize it. Use
+ more verbose error message.
+
+2013-05-26 Roland Winkler <winkler@gnu.org>
+ Use new function bbdb-extract-address-components which honors
+ bbdb-message-clean-name-function and
+ bbdb-canonicalize-mail-function.
+
+ * lisp/bbdb.el (bbdb-clean-address-components)
+ (bbdb-extract-address-components): New functions.
+ (bbdb-decompose-bbdb-address): Renamed from
+ bbdb-extract-address-components.
+ (bbdb-puthash-mail): Use it.
+
+ * lisp/bbdb-com.el (bbdb-message-search): Do nothing if both args
+ are nil.
+ (bbdb-complete-mail, bbdb-complete-mail-cleanup): Use
+ bbdb-extract-address-components.
+
+ * lisp/bbdb-mua.el (bbdb-get-address-components)
+ (bbdb-mua-summary-unify, bbdb-mua-summary-mark): Use
+ bbdb-extract-address-components.
+ (bbdb-canonicalize-mail): Remove.
+
+ * lisp/bbdb-snarf.el (bbdb-snarf-name-mail)
+ (bbdb-snarf-mail-address): Use bbdb-extract-address-components.
+
+ * lisp/bbdb-sc.el (bbdb/sc-consult-attr, bbdb/sc-default): Use
+ bbdb-extract-address-components.
+
+ * lisp/bbdb-vm.el (vm-summary-function-B): Simplify.
+ (bbdb/vm-alternate-full-name): Use
+ bbdb-extract-address-components.
+
+2013-04-21 Leo Liu <sdl.web@gmail.com>
+ * lisp/bbdb-mua.el (bbdb-mua-summary-mark): Do not call
+ bbdb-mua-summary-mark-field as a function if it is not a function.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-utilities-snarf): New custom group.
+ * lisp/bbdb-snarf.el: New file.
+ * lisp/Makefile.in, lisp/makefile-temp: Compile it.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-merge-records): Fix docstring. Merge
+ also affixes. Do not enforce multi-line layout for display.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-format-address-default, bbdb-format-address):
+ Allow city, postcode, state, and country to be nil.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-hash-record, bbdb-change-record): Fix
+ docstring.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-new-mails-primary): Change default to query.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-summary-unify)
+ (bbdb-mua-summary-mark): Allow bbdb-mua-summary-mark-field to be a
+ function.
+ * lisp/bbdb.el (bbdb-mua-summary-mark-field): Fix docstring.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-extract-address-components): New function.
+ (bbdb-puthash-mail): Use it.
+ * lisp/bbdb-com.el (bbdb-dwim-mail): Use it.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Simplify. Do not throw
+ error messages that prevent other completion functions to take
+ over.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-vm.el (bbdb/vm-auto-folder-field)
+ (bbdb/vm-virtual-folder-field, bbdb/vm-auto-folder)
+ (bbdb/vm-auto-add-label-list, bbdb/vm-auto-add-label-field): Fix
+ docstring.
+ (bbdb/vm-virtual-folder): Check more carefully whether
+ vm-virtual-folder-alist contains already what we want to add. Fix
+ docstring.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-sc.el (bbdb/sc-attribution-field): Fix docstring.
+
+2013-04-13 Roland Winkler <winkler@gnu.org>
+ * tex/Makefile.in: Acknowledge DESTDIR.
+
+2013-02-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mail-name-format, bbdb-mail-name): New
+ user variables.
+ * lisp/bbdb-com.el (bbdb-dwim-mail): Use them. Always quote the
+ name part of a mail address if necessary.
+ (bbdb-quoted-string-syntax-table): New internal variable.
+ (bbdb-complete-mail): Use it to find starting point for
+ completion. Before proper cycling, reformat the original mail
+ address to match an element of dwim-completions. Use
+ completion-ignore-case instead of downcase. Do not use trimmed
+ pattern. Issue warning message if attempting to create a
+ *Completions* buffer with GNU Emacs older than 23.2. Use the
+ default value of completion-list-insert-choice-function to locally
+ bind this variable.
+ (bbdb-complete-mail-cleanup): New arg beg. Use indent-relative.
+
+ * lisp/bbdb-print.el (bbdb-print-name-format, bbdb-print-name):
+ New user variables.
+ (bbdb-print-record): Use them,
+
+2013-02-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-mail-yank): Bind case-fold-search to t.
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-delete-field-or-record): Handle multiple
+ records.
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-delete-record-internal)
+ (bbdb-insert-record-internal, bbdb-overwrite-record-internal): Use
+ inhibit-quit.
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-changed-records, bbdb-hashtable): Doc fix.
+
+2013-02-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-modified): Removed.
+ (bbdb-buffer, bbdb-after-save, bbdb-delete-record-internal)
+ (bbdb-insert-record-internal, bbdb-overwrite-record-internal)
+ (bbdb-sort-records): Do not set bbdb-modified.
+ (bbdb-mode): Use buffer-modified-p.
+
+2013-02-02 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mail-user-agent): Use non-nil default taken
+ from mail-user-agent.
+ (bbdb-lastname-re, bbdb-lastname-suffix-re): New user variables.
+ (bbdb-divide-name): Use them. Pass first and last name through
+ bbdb-string-trim.
+
+ * lisp/bbdb-mua.el (bbdb-canonicalize-mail): Always pass mail
+ through bbdb-string-trim.
+ (bbdb-canonicalize-mail-1): Always pass mail through
+ bbdb-string-trim.
+ (bbdb-canonical-hosts): Use regxp-opt instead of regexp-quote.
+ (bbdb-message-clean-name-default): Re-arrange clean-up steps. Use
+ substring-no-properties.
+
+2013-01-20 Roland Winkler <winkler@gnu.org>
+ * aclocal.m4: Do not throw an error if tex_dir does not exist.
+
+2013-01-20 Roland Winkler <winkler@gnu.org>
+ * doc/Makefile.in, tex/Makefile.in: Provide the DESTDIR variable.
+ (Bug#38124)
+
+2013-01-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-parse-records): Set bbdb-xfield-labels-list
+ and bbdb-organization-list to nil only once.
+
+2013-01-13 Roland Winkler <winkler@gnu.org>
+ Update copyright year in all files.
+
+2013-01-13 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-organization-list): New variable.
+ (bbdb-record-set-field): Use it. Update bbdb-phone-label-list,
+ bbdb-address-label-list, and bbdb-xfield-label-list.
+ ((bbdb-set-xfield-labels): Removed
+ (bbdb-record-set-xfield): Set bbdb-xfield-labels-list explicitly.
+ (bbdb-label-completion-list): Removed.
+ (bbdb-parse-records): Do not set bbdb-phone-label-list and
+ bbdb-address-label-list in a circular way. Set
+ bbdb-organization-list.
+
+ * lisp/bbdb-com.el: Require crm.
+ (bbdb-crm-local-completion-map): New variable.
+ (bbdb-read-organization): New function.
+ (bbdb-read-record, bbdb-prompt-for-new-field): Use it. Directly
+ use bbdb-phone-label-list and bbdb-address-label-list.
+ Do not call bbdb-set-xfield-labels, which was redundant.
+ (bbdb-edit-field): Use bbdb-read-organization and
+ bbdb-record-field.
+ (bbdb-record-edit-address): Use bbdb-address-label-list directly.
+ (bbdb-record-edit-phone): Use bbdb-phone-label-list directly.
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+ * configure.ac: Option --with-tex-dir renamed from
+ --with-texmf-dir.
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-sc.el: New file
+ * lisp/Makefile.in, lisp/makefile-temp, lisp/bbdb.el
+ (bbdb-init-forms, bbdb-initialize): Use it.
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+ * INSTALL: List all BBDB configure options.
+ * aclocal.m4, tex/Makefile.in: Option --with-tex-dir renamed from
+ --with-texmf-dir.
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-gnus.el: Do not use eval-and-compile.
+ (bbdb/gnus-split-myaddr-regexp): Do not use obsolete variable
+ gnus-local-domain.
+ (bbdb/gnus-split-private-field, bbdb/gnus-split-public-field): Fix
+ docstring.
+
+ * lisp/bbdb-vm.el, lisp/bbdb-message.el, lisp/bbdb-mhe.el: Do not
+ use eval-and-compile.
+
+2012-12-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mua-summary-unification-list)
+ (bbdb-mua-summary-mark-field, bbdb-mua-summary-mark)
+ (bbdb-mua-summary-unify-format-letter)
+ (bbdb-mua-summary-mark-format-letter): New user variables.
+
+ * lisp/bbdb-mua.el (bbdb-mua-summary-unify)
+ (bbdb-mua-summary-mark): New functions.
+
+ * lisp/bbdb-gnus.el (bbdb/gnus-summary-mark-known-posters)
+ (bbdb/gnus-mark-known-posters)
+ (bbdb/gnus-summary-known-poster-mark)
+ (bbdb/gnus-summary-show-bbdb-names)
+ (bbdb/gnus-header-show-bbdb-names)
+ (bbdb/gnus-summary-prefer-bbdb-data)
+ (bbdb/gnus-summary-prefer-real-names)
+ (bbdb/gnus-header-prefer-real-names)
+ (bbdb/gnus-summary-user-format-letter)
+ (bbdb/gnus-summary-in-bbdb-format-letter)
+ (bbdb/gnus-message-marker-field, bbdb/gnus-summary-get-sender)
+ (bbdb/gnus-summary-sender-in-bbdb): Removed.
+ (bbdb-insinuate-gnus): Use bbdb-mua-summary-unify and
+ bbdb-mua-summary-mark.
+
+2012-12-27 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-wrapper): Add edebug support.
+ Suggested by Leo <sdl.web@gmail.com>.
+
+ * lisp/bbdb-gnus (bbdb-insinuate-gnus): Fix keybindings for
+ gnus-article-mode. Suggested by Leo <sdl.web@gmail.com>.
+
+ * lisp/bbdb-com.el (bbdb-grab-url): Fail early if no URL at point.
+ Suggested by Leo <sdl.web@gmail.com>.
+
+2012-12-26 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Check every record from
+ the completion list for each possible completion.
+
+2012-12-26 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-dedicated-window): New user variable.
+ (bbdb-mua-pop-up): Renamed from bbdb-message-pop-up. Doc fix.
+ (bbdb-mua-pop-up-window-size): New variable.
+ (bbdb-pop-up-window-size): Doc fix. Allow value t.
+ (bbdb-pop-up-window): Use it. Simplify. Use
+ display-buffer-record-window / set-window-dedicated-p so that the
+ BBDB window is popped up such that quit-window can delete it.
+ Suggested by Martin Rudalics.
+ (bbdb-display-records): Clean up.
+
+ * lisp/bbdb-mua.el (bbdb-mua-mode-alist): New variable.
+ (bbdb-mua): Use it.
+ (bbdb-mua-window-p): New function.
+ (bbdb-mua-display-records, bbdb-mua-edit-field)
+ (bbdb-mua-auto-update): Use it.
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-vm.el: (bbdb/vm-auto-add-label-list)
+ (bbdb/vm-auto-add-label-field): Doc fix.
+ (bbdb/vm-auto-add-label): Doc fix and cleanup.
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+ * README: Minor docfix.
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el, lisp/bbdb-com.el, lisp/bbdb-mua.el:
+ * lisp/bbdb-print.el, lisp/bbdb-anniv.el, lisp/bbdb-ispell.el:
+ * lisp/bbdb-migrate.el, lisp/bbdb-vm.el, lisp/bbdb-gnus.el: For
+ the user-defined fields of a record replace the generic internal
+ name `notes' by `xfield'.
+
+ * lisp/bbdb.el (bbdb-layout-alist, bbdb-name-format, bbdb-image)
+ (bbdb-default-domain, bbdb-auto-notes-rules)
+ (bbdb-mail-alias-field, bbdb-name-face-alist, bbdb-record-type)
+ (bbdb-timestamp, bbdb-creation-date)
+ (bbdb-display-name-organization): Doc fix.
+ (bbdb-xfields-sort-order): Renamed from bbdb-notes-sort-order
+ (bbdb-merge-xfield-function-alist): Renamed from
+ bbdb-merge-notes-function-alist
+ (bbdb-xfield-label-list): Renamed from bbdb-notes-label-list.
+ (bbdb-record-xfields): Renamed from bbdb-record-Notes.
+ (bbdb-record-set-xfields): Renamed from bbdb-record-set-Notes.
+ (bbdb-record-xfield): Renamed from bbdb-record-note.
+ (bbdb-record-set-xfield): Renamed from bbdb-record-set-note.
+ (bbdb-record-xfield-intern): Renamed from bbdb-record-note-intern.
+ (bbdb-record-xfield-split): Renamed from bbdb-record-note-split
+ (bbdb-set-xfield-labels): Renamed from bbdb-set-notes-labels
+ (bbdb-merge-xfield): Renamed from bbdb-merge-note.
+
+ * lisp/bbdb-com.el (bbdb-search, bbdb, bbdb-compare-records)
+ (bbdb-create-internal, bbdb-edit-field): Doc fix.
+ (bbdb-search-xfields): Renamed from bbdb-search-notes.
+ (bbdb-message-search): Make search more robust.
+ (bbdb-sort-xfields): Renamed from bbdb-sort-notes.
+
+2012-12-25 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-parse-records): If multiple records have the
+ same name, hash all these records.
+ (bbdb-allow-duplicates): Doc fix.
+
+2012-09-23 Roland Winkler <winkler@gnu.org>
+ Add more complete support for mail entries containing RFC-822
+ addresses such as "John Smith <smith@foo.com>" in the record of
+ Johnathan Smith.
+
+ * lisp/bbdb.el (bbdb-defstruct): Doc fix. Improve doc string of
+ functions defined via this macro.
+ (bbdb-cache-mail-aka, bbdb-cache-mail-canon): New elements of
+ bbdb-record-cache.
+ (bbdb-record-mail-aka, bbdb-record-mail-canon): New functions.
+ (bbdb-hash-p): New function.
+ (bbdb-gethash): Use it.
+ (bbdb-puthash-mail): New function.
+ (bbdb-hash-record): Use it.
+ (bbdb-record-field): Renamed from bbdb-record-get-field.
+ New field values mail-canon, mail-aka and aka-all. Doc fix.
+ (bbdb-record-get-field): Obsolete function alias.
+ (bbdb-record-set-field): Doc fix. Update hash for mail entries
+ such as "John Smith <smith@foo.com>".
+ (bbdb-delete-record-internal): Use canonical mail addresses and
+ all AKAs when cleaning up the hash.
+
+ * lisp/bbdb-com.el (bbdb-search): Use bbdb-record-field.
+ (bbdb-search-duplicates): Use bbdb-record-mail-canon.
+ (bbdb-message-search): Simplify.
+ (bbdb-edit-field): Doc fix.
+ (bbdb-ident-point, bbdb-transpose-fields)
+ (bbdb-delete-field-or-record): Use bbdb-record-field.
+ (bbdb-completion-predicate): Use bbdb-hash-p.
+ (bbdb-complete-mail): Compare with all AKAs. A plain message
+ search should be sufficient.
+
+ * lisp/bbdb-mual.el (bbdb-annotate-message): Compare with
+ canonical mail addresses.
+
+ * lisp/bbdb-ispell.el (bbdb-ispell-export): Use bbdb-record-field.
+
+ * README: Notes for BBDB lisp hackers added.
+
+2012-09-23 Roland Winkler <winkler@gnu.org>
+ * 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.
+
+2012-09-09 Roland Winkler <winkler@gnu.org>
+ Provide unified scheme for customizing how BBDB analyzes messages.
+
+ * lisp/bbdb.el (bbdb-add-name): Renamed from
+ bbdb-accept-name-mismatch.
+ (bbdb-add-aka): Renamed from bbdb-use-alternate-names.
+ (bbdb-new-mails-primary): Renamed from
+ bbdb-new-mails-always-primary.
+ (bbdb-add-name, bbdb-add-aka, bbdb-add-mails)
+ (bbdb-new-mails-primary): Unify set of allowed values.
+ (bbdb-add-job, bbdb-eval-spec): New functions.
+ (bbdb-mode): Update docstring.
+
+ * lisp/bbdb-com.el (bbdb-merge-records): Use bbdb-add-aka.
+
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Use bbdb-add-name,
+ bbdb-add-aka, bbdb-add-mails, and bbdb-new-mails-primary.
+
+2012-09-08 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-message-header): Use
+ gnus-fetch-original-field so that bbdb-select-message does not get
+ fooled by an apparent absence of some headers.
+
+2012-09-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-accept-name-mismatch): Allow value being a
+ regexp or function.
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Use these new values.
+
+2012-09-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-edit-field): Bug fix.
+
+2012-09-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-record-set-field): Bug fix.
+
+2012-09-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-with-print-loadably): New macro.
+ (bbdb-insert-record-internal, bbdb-overwrite-record-internal)
+ (bbdb-sort-records): Use it.
+
+2012-08-11 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail-cleanup): New function.
+ (bbdb-complete-mail): Use it. In particular, clean up also when
+ using *Completions* buffer.
+
+2012-08-11 Roland Winkler <winkler@gnu.org>
+ Remove electric mode that was not providing any new functionality
+ to BBDB. Also see GNU Emacs Bug#11983.
+
+ * lisp/bbdb.el (bbdb-electric, bbdb-inside-electric-display)
+ (bbdb-quit-window, bbdb-electric-display-records)
+ (bbdb-electric-throw, bbdb-quit-window)
+ (bbdb-display-records-internal): Remove.
+ (bbdb-display-records): Remove arg electric. Merge with
+ bbdb-display-records-internal.
+ (bbdb-redisplay-records): Use bbdb-display-records.
+
+ * lisp/bbdb-com.el (bbdb-mail, bbdb-mail-address, bbdb-info):
+ Remove electricity.
+ (bbdb-mail-abbrev-expand-hook): Use bbdb-display-records.
+
+ * lisp/bbdb-mua.el (bbdb-mua-display-records)
+ (bbdb-mua-auto-update): Use bbdb-display-records.
+
+2012-08-09 Roland Winkler <winkler@gnu.org>
+ Remove message cache that was broken. There were two problems
+ with it. The cache did not distinguish between records associated
+ with the senders and recipients. So if a call of
+ bbdb-mua-display-sender was followed by, say, a call of
+ bbdb-mua-display-recipients the second call also returned the
+ senders. Second, the cache used assq to identify message keys to
+ operate fast. Yet most MUAs only provide strings as message keys.
+
+ * lisp/bbdb.el (bbdb-message-all-addresses)
+ (bbdb-notice-mail-hook, bbdb-notice-record-hook): Fix docstring.
+ (bbdb-message-caching, bbdb-message-cache): Remove.
+ (bbdb-buffer): Remove cache flushing.
+
+ * lisp/bbdb-mua.el (bbdb-update-records): Remove arg msg-key.
+ Remove caching of records.
+ (bbdb-message-get-cache, bbdb-message-set-cache)
+ (bbdb-message-rem-cache): Remove.
+ (bbdb-mua-update-records): Remove arg msg-key from calls of
+ bbdb-update-records.
+
+2012-08-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Use quit-window instead
+ of current-window-configuration and set-window-configuration.
+ * lisp/bbdb.el (bbdb-complete-mail-saved-window-config): Remove.
+
+2012-08-06 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Revert 2012-07-06 change.
+
+2012-08-05 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Simplify.
+
+2012-08-05 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-suppress-changed-records-recording): Remove.
+ (bbdb-puthash, bbdb-gethash, bbdb-remhash): Ignore keys that are
+ empty strings or nil.
+ (bbdb-hash-record): Explicitly hash name.
+ (bbdb-change-record, bbdb-delete-record-internal)
+ (bbdb-insert-record-internal, bbdb-overwrite-record-internal):
+ Operate on hash table and bbdb-changed-records list only when
+ necessary.
+
+ * lisp/bbdb-com.el (bbdb-delete-records): Remove record from hash
+ table.
+ (bbdb-merge-records): Do not add new-record to the list of changed
+ records, which is done already by bbdb-change-record.
+
+2012-08-05 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Do not call quit-window.
+ Instead, rely on set-window-configuration that it does what we
+ want.
+
+2012-08-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-merge-records): Improve interactive call
+ and docstring.
+
+2012-08-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-allow-duplicates, bbdb-hash-update)
+ (bbdb-record-set-field): Fix docstring.
+ * lisp/bbdb-com.el (bbdb-merge-records): Do not through an error
+ when merging the old and new record results in duplicate AKAs and
+ email addresses.
+
+2012-07-31 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): When a single record
+ matches, analyze more carefully which mail address to use. Cycle
+ even if the record contains only one mail address, yet
+ bbdb-dwim-mail gives us something different from what we have.
+ Search correctly for RFC 822 addresses containing a full name.
+
+2012-07-20 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Simplify. Create new
+ record if update-p has not value update.
+
+2012-07-20 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-gethash): Allow value of t for arg predicate.
+
+2012-07-20 Sam Steingold <sds@gnu.org>
+ * lisp/bbdb-com.el (bbdb-message-search): Allow args name or mail
+ to be nil.
+
+2012-07-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el: Simplify previous patch.
+ (bbdb-electric-execute, bbdb-electric-quit, bbdb-electric-quit):
+ Remove.
+ (bbdb-display-records): Simplify.
+ (bbdb-electric-display-records): Fix docstring. Simplify. Remove
+ optional args select and horiz-p that interfere with
+ Electric-pop-up-window.
+
+2012-07-18 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-electric-display-records): Fix previous
+ patch.
+
+2012-07-18 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el: Autoload bbdb-search and bbdb-search-prompt.
+ (bbdb-display-records): Make records a required arg. Do not
+ redefine keys. Pass optional args to
+ bbdb-electric-display-records.
+ (bbdb-electric-display-records): New optional args layout, append,
+ select, and horiz-p. Make it a command. Redefine SPC key
+ temporarily. Simplify.
+
+2012-07-17 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mua-update-interactive-p)
+ (bbdb-mua-auto-update-p, bbdb-update-records-p): Update docstring.
+ (bbdb-canonicalize-mail-function): Update docstring.
+ (bbdb-message-caching): Use default nil till caching is fixed.
+ (bbdb-cache-deleted-p, bbdb-cache-set-deleted-p)
+ (bbdb-record-deleted-p, bbdb-record-set-deleted-p): Removed.
+ (bbdb-display-name-organization): Use memq.
+
+ * lisp/bbdb-mua.el (bbdb-mua, bbdb-message-header): Use memq.
+ (bbdb-get-address-components): Allow mail to be nil. Use
+ member-ignore-case.
+ (bbdb-update-records): New value update for arg update-p. Use
+ memq.
+ (bbdb-message-get-cache): Simplify.
+ (bbdb-message-set-cache): Remove old value from cache.
+ (bbdb-annotate-message): New value update for arg update-p.
+ Operate on all records found by bbdb-message-search. Return list
+ of records. Use member-ignore-case.
+ (bbdb-mua-update-records): Use memq.
+ (bbdb-auto-notes): Use member-ignore-case and assoc-string.
+
+ * lisp/bbdb-com.el (bbdb-read-name, bbdb-insert-field): Use memq.
+ (bbdb-complete-mail): Use member-ignore-case.
+
+ * lisp/bbdb-message.el (bbdb/message-update-records-p)
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records-p)
+ * lisp/bbdb-mhe.el (bbdb/mh-update-records-p)
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records-p)
+ * lisp/bbdb-vm.el (bbdb/vm-update-records-p): Update
+ docstring.
+
+ * lisp/bbdb-print.el (bbdb-print-record): Do not use
+ bbdb-record-deleted-p.
+
+ * README: Update usage of update-p.
+
+2012-07-12 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-get-address-components)
+ (bbdb-message-get-cache, bbdb-message-set-cache)
+ (bbdb-message-rem-cache, bbdb-mua-annotate-sender)
+ (bbdb-mua-annotate-recipients, bbdb-mua-edit-field)
+ (bbdb-canonical-hosts, bbdb-canonicalize-mail-1)
+ (bbdb-mail-redundant-p, bbdb-delete-redundant-mails)
+ (bbdb-message-clean-name-default): Fix docstring.
+
+2012-07-09 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-annotate-sender)
+ (bbdb-mua-annotate-recipients, bbdb-mua-edit-field)
+ (bbdb-mua-edit-field-sender, bbdb-mua-edit-field-recipients): New arg
+ update-p.
+ (bbdb-mua-edit-field-interactive): Handle arg update-p.
+
+2012-07-08 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): Fix previous patch.
+
+2012-07-08 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): Make records a list
+ ordered like address-list.
+
+2012-07-06 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Use window-live-p.
+
+2012-07-06 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-edit-field): Revert previous change.
+ Do not use hard-coded bindings for user variables.
+
+2012-07-06 Sam Steingold <sds@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Use `quit-window' instead
+ of `bury-buffer' to get rid of *Completions*.
+
+2012-07-06 Sam Steingold <sds@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-edit-field): Edit THE record for THE
+ sender, not all the relevant records.
+
+2012-07-03 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-record-name, bbdb-record-name-lf): Fix
+ docstring.
+ * lisp/bbdb-com.el (bbdb-search): Also search last_first names.
+ Fix docstring.
+ (bbdb-message-search): Fix docstring.
+
+2012-07-01 Sam Steingold <sds@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-get-address-components): name may be nil.
+
+2012-07-01 Sam Steingold <sds@gnu.org>
+ * .gitignore: ignore Makefiles and configure files;
+ bbdb-autoloads.el -> bbdb-loaddefs.el.
+
+2012-06-24 Sam Steingold <sds@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): Use bbdb-message-search
+ instead of bbdb-search when `update-p' is `search' so that all
+ senders are displayed.
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Do not offer to
+ replace the name if it is already an AKA.
+
+ * lisp/bbdb.el (bbdb-label-completion-list): Use symbol-value
+ instead of eval for symbols.
+ * lisp/bbdb-mua.el (bbdb-update-records): Ditto.
+
+2012-06-24 Philip Hudson <phil.hudson@iname.com>
+ * lisp/bbdb.el (bbdb-read-only, bbdb-initialize-hook)
+ (bbdb-mode-hook, bbdb-layout-alist, bbdb-case-fold-search)
+ (bbdb-message-caching, bbdb-complete-mail-allow-cycling)
+ (bbdb-after-save-hook, bbdb-completion-display-record)
+ (bbdb-update-records-address, bbdb-warn, bbdb-split, bbdb-concat)
+ (bbdb-read-string, bbdb-current-record, bbdb-debug)
+ (bbdb-timestamp, bbdb-creation-date, bbdb-gethash)
+ (bbdb-hash-record, bbdb-record-name, bbdb-record-name-lf)
+ (bbdb-record-sortkey, bbdb-record-set-sortkey, bbdb-record-marker)
+ (bbdb-record-set-marker, bbdb-record-deleted-p)
+ (bbdb-record-set-deleted-p, bbdb-merge-concat)
+ (bbdb-merge-string-least, bbdb-merge-string-most)
+ (bbdb-phone-string, bbdb-error-retry, bbdb-display-list)
+ (bbdb-display-record-one-line, bbdb-display-record-multi-line)
+ (bbdb-display-records, bbdb-display-records-internal)
+ (bbdb-redisplay-record, bbdb-pop-up-window)
+ (bbdb-electric-display-records, bbdb-electric-throw)
+ (bbdb-electric-quit, bbdb-quit-window, bbdb-mouse-menu, bbdb-save)
+ (bbdb-offer-to-create bbdb-lastname-suffixes)
+ (bbdb-update-records-p, bbdb-new-mails-always-primary): Fix
+ docstring.
+ (bbdb-mail-user-agent): Untabify.
+
+2012-06-24 Roland Winkler <winkler@gnu.org>
+ Update copyright notices.
+
+ * lisp/bbdb.el (bbdb-allow-duplicates): Rename from
+ bbdb-no-duplicates to match the unchanged docstring of this
+ variable.
+ (bbdb-record-Notes): Rename from bbdb-record-notes to avoid name
+ clashes.
+ (bbdb-puthash): Do not hash empty strings.
+ (bbdb-gethash): New arg predicate.
+ (bbdb-check-name): New function.
+ (bbdb-record-set-name): For args first and last allow new value t.
+ Use bbdb-check-name.
+ (bbdb-record-name, bbdb-record-name-lf): Use it.
+ (bbdb-record-set-field): Use it. Simplify.
+ (bbdb-label-completion-default, bbdb-data-completion-list)
+ (bbdb-data-completion-default): Remove unused function.
+ (bbdb-buffer): Handle here that bbdb-file might have changed on
+ disk and auto-save file could be newer than bbdb-file instead of
+ bbdb-records doing this.
+ (bbdb-revert-buffer): Fix docstring. Use prefix arg as in
+ revert-buffer. Use variable bbdb-buffer instead of function
+ bbdb-buffer to avoid recursion.
+ (bbdb-parse-records): Rename from bbdb-parse-internal. Add
+ docstring. Do not polute buffer-undo-list when reading bbdb-file.
+ Use unwind-protect. Merge with bbdb-parse-frobnicate. Handle
+ bbdb-allow-duplicates properly.
+ (bbdb-with-db-buffer): Add docstring.
+ (bbdb-display-record-one-line, bbdb-display-record-multi-line):
+ Simplify.
+ (bbdb-pop-up-window): Fix docstring.
+ (bbdb-sendmail-menu): Add docstring.
+ (bbdb-electric-quit): Rename from bbdb-electric-done.
+ (bbdb-electric-display-records): Simplify.
+
+ * lisp/bbdb-com.el (bbdb-editable): Fix docstring. Check more
+ carefully without reverting.
+ (bbdb-message-search): Use bbdb-buffer.
+ (bbdb-read-record): Use bbdb-buffer and bbdb-check-name.
+ (bbdb-create-internal): Fix docstring. Use bbdb-check-name.
+ (bbdb-edit-field): Merge with bbdb-record-edit-name.
+ (bbdb-record-edit-name): Remove.
+ (bbdb-completion-predicate): Bug fix.
+ (bbdb-complete-mail): Use bbdb-buffer and
+ bbdb-completion-predicate.
+ (bbdb-search-duplicates, bbdb-message-search)
+ (bbdb-create-internal): Use arg predicate of bbdb-gethash.
+
+ * lisp/bbdb.el (bbdb-gethash): New arg predicate.
+ (bbdb-check-name, bbdb-record-set-field, bbdb-parse-records) Use
+ it.
+ * lisp/bbdb-com.el (bbdb-search-duplicates, bbdb-message-search)
+ (bbdb-create-internal): Use it.
+
+ * lisp/bbdb-mua.el (bbdb-message-get-cache): Use bbdb-buffer.
+
+ * lisp/bbdb.el (bbdb-message-clean-name-function)
+ (bbdb-message-mail-as-name): New variables.
+ * lisp/bbdb-mua.el (bbdb-get-address-components)
+ (bbdb-annotate-message): Use them.
+ (bbdb-message-clean-name-default): Rename from
+ bbdb-message-clean-name. Clean names properly, too.
+
+ * tex/Makefile.in (install-TeX): Bug fix (Bug#108041).
+
+2012-01-02 Sam Steingold <sds@gnu.org>
+ * lisp/bbdb.el (bbdb-auto-notes-rules): Use :set keyword to reset
+ `bbdb-auto-notes-rules-expanded' when `bbdb-auto-notes-rules' is set.
+
+2012-01-02 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el (bbdb-anniv-list): Clarify docstring.
+
+2012-01-02 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el: Do not use custom-loads for bbdb-mua.el and
+ bbdb-com.el. Use symbols for custom-loads.
+ (bbdb-utilities-ispell): Group renamed and moved here from
+ bbdb-ispell.el.
+ (bbdb-utilities-print): Group renamed from bbdb-print.
+ (bbdb-utilities-dialing): Group renamed from bbdb-dialing.
+ * lisp/bbdb-ispell.el, lisp/bbdb-print.el: Updated accordingly.
+
+2011-12-18 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el (bbdb-anniv-diary-entries): Remove leading
+ and trailing whitespace in text properly.
+
+2011-12-18 Roland Winkler <winkler@gnu.org>
+ * lisp/Makefile.in: Do not create backup file for
+ bbdb-loaddefs.el.
+
+2011-12-18 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-anniv.el (bbdb-anniv-alist): New format specification
+ `%t'.
+ (bbdb-anniv-diary-entries): Use it. Handle diary's backup forms
+ in a better way.
+
+2011-12-11 Roland Winkler <winkler@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.kanis@googlemail.com>
+ * lisp/bbdb-ispell.el: New file
+
+2011-11-27 Roland Winkler <winkler@gnu.org>
+ * README: Updated.
+
+ * lisp/bbdb.el: Revert change from 2011-10-11. Loading
+ bbdb-autoloads.el is sufficient.
+
+ * lisp/Makefile: It no longer supports VM by default, but you need
+ to enable it.
+
+2011-11-27 Leo <sdl.web@gmail.com>
+ * lisp/bbdb.el (bbdb-image-suffixes): Fix typo.
+
+2011-11-20 Roland Winkler <winkler@gnu.org>
+ * README: Updated.
+
+ * lisp/bbdb.el (bbdb-message-try-all-headers)
+ (bbdb-user-mail-address-re): Clarify doc string.
+ (bbdb-defstruct): Do not update bbdb-mail-aliases-need-rebuilt.
+ (bbdb-record-set-note): Update bbdb-mail-aliases-need-rebuilt.
+ (bbdb-record-set-name): Update name in cache and hash.
+ (bbdb-record-unset-name): Removed (obsolete).
+ (bbdb-hash-update): New function.
+ (bbdb-record-set-field): Use it.
+ (bbdb-records): Initiate variable bbdb-records.
+ (bbdb-parse-internal): Use bbdb-goto-first-record.
+ (bbdb-goto-first-record): Move backward only if we found a first
+ record.
+
+ * lisp/bbdb-com.el (bbdb-insert-field)
+ (bbdb-delete-field-or-record): Use bbdb-record-set-field.
+ (bbdb-edit-field): New optional arg value. Handle affix,
+ organization, mail, aka, and note fields directly.
+ (bbdb-record-edit-affix, bbdb-record-edit-organziation)
+ (bbdb-record-edit-mail, bbdb-record-edit-aka)
+ (bbdb-record-edit-note): Removed.
+
+ * lisp/bbdb.el (bbdb-mail-avoid-redundancy) Renamed from
+ bbdb-mail-allow-redundancy.
+ * lisp/bbdb-com.el (bbdb-dwim-mail): Update it accordingly.
+
+ * lisp/bbdb.el (bbdb-update-records-p): Change default to less
+ agressive `search'.
+ (bbdb-mua-auto-update-p): New variable
+ * lisp/bbdb-mua.el (bbdb-mua-auto-update): Use it.
+ (bbdb-update-records): Resolve arg update-p up to two times.
+ * lisp/bbdb-message.el (bbdb/message-update-records-p)
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records-p)
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records-p)
+ * lisp/bbdb-mhe.el (bbdb/mh-update-records-p)
+ * lisp/bbdb-vm.el (bbdb/vm-update-records-p): Doc fix.
+
+ * lisp/bbdb-mua.el (bbdb-annotate-record): Convert annotation into
+ list if field is affix, organization, mail or aka.
+ (bbdb-mua-edit-field-interactive): New function.
+ (bbdb-mua-edit-field): New command.
+ (bbdb-mua-edit-field-sender, bbdb-mua-edit-field-recipients): Use
+ it.
+
+ * lisp/bbdb.el (bbdb-image, bbdb-image-path, bbdb-image-suffixes):
+ New variables.
+ (bbdb-display-name-organization): Use them to display images for
+ BBDB records. Suggested by Ivan Kanis <apple@kanis.fr>.
+
+ * lisp/bbdb-migrate.el (bbdb-undocumented-variables): New command.
+
+2011-10-11 Teodor Zlatanov <tzz@lifelogs.com>
+
+ * lisp/bbdb.el: Autoload `bbdb-insinuate-gnus' from bbdb-gnus.el
+ so `bbdb-initialize' won't throw an error when passed 'gnus.
+ Ditto 'message, 'rmail, 'vm, and 'mh-e.
+
+2011-10-10 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-name-format, bbdb-read-name-format)
+ (bbdb-name-face-alist): New user variables.
+ (bbdb-record-name-lf): New function.
+ (bbdb-display-name-organization): Use bbdb-name-format for
+ customizable display of name. Use note field name-face for
+ customizable font-locking of name of a record.
+ (bbdb-layout-list): Omit name-format and name-face
+ for multi-line and pop-up-multi-line format.
+ (bbdb-separator-alist): New default values for name-first-last and
+ name-last-first.
+ (bbdb-record-set-name): Use them.
+ * lisp/bbdb-com.el (bbdb-read-name): New function.
+ (bbdb-read-record, bbdb-record-edit-name): Use it. New optional
+ arg first-and-last.
+
+ * lisp/bbdb.el: (bbdb-merge-notes-function): Removed (obsolete).
+ (bbdb-record-type): New internal variable.
+ (bbdb-check-type): Moved here from lisp/bbdb-com.el. Use the
+ pseudo-code of bbdb-record-type.
+ (bbdb-record-get-field, bbdb-merge-concat)
+ (bbdb-merge-concat-remove-duplicates, bbdb-merge-string-least)
+ (bbdb-merge-string-most, bbdb-merge-lists, bbdb-divide-name)
+ (bbdb-parse-postcode): Moved here from lisp/bbdb-com.el.
+ (bbdb-merge-note): Rewrite.
+ (bbdb-record-set-field): Moved here from lisp/bbdb-com.el. New
+ optional args check and merge.
+ (bbdb-record-note-intern): New function.
+ (bbdb-record-set-note): Throw error if the name of a note field
+ equals the name of any other record field.
+ (bbdb-parse-frobnicate): Include all note fields in
+ bbdb-notes-label-list.
+ * lisp/bbdb-com.el (bbdb-create-internal): Use bbdb-check-type.
+ (bbdb-merge-records-internal): Removed (merged with
+ bbdb-merge-records).
+ (bbdb-merge-records): Use bbdb-record-set-field.
+ * lisp/bbdb-mua.el (bbdb-annotate-record): Renamed from
+ bbdb-annotate-note. Use bbdb-record-set-field.
+
+ * lisp/bbdb.el (bbdb-initialize): Do not require bbdb-autoloads.
+
+ * lisp/bbdb.el (bbdb-phone-string): Fix error message.
+
+ * lisp/bbdb.el (bbdb-error-retry): Use progn.
+
+ * lisp/bbdb.el (bbdb-message-try-all-headers): New user variable.
+ * lisp/bbdb-mua.el (bbdb-get-address-components): Use it.
+
+ * lisp/bbdb-print.el (bbdb-print): Do not use \catcode.
+
+2011-09-22 Leo <sdl.web@gmail.com>
+ * lisp/bbdb.el (bbdb-pop-up-window): Remove Gnus-specific code
+ which is not required anymore by recent versions of Gnus.
+
+2011-09-21 Leo <sdl.web@gmail.com>
+ * lisp/bbdb-com.el (bbdb-browse-url): Fix usage of prefix arg.
+
+2011-09-19 Leo <sdl.web@gmail.com>
+ * lisp/bbdb-com.el (bbdb-add-mail-alias): Fix completion list used
+ in interactive calls for deleting an alias.
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mode-map): Use / as search prefix.
+
+2011-09-19 Abhi Yerra <abhi@berkeley.edu>
+ * lisp/bbdb.el (bbdb-dial-function): New variable.
+ (bbdb-sound-player, bbdb-sound-files, bbdb-modem-dial)
+ (bbdb-modem-device, bbdb-sound-volume): Removed (obsolete).
+
+ * lisp/bbdb-com.el (bbdb-dial-number): Use browse-url and
+ bbdb-dial-function.
+ (bbdb-play-sound): Removed (obsolete)
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-dial): First remove extension. Simplify.
+
+2011-09-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-version): Do not use interactive-p.
+
+ * lisp/bbdb-message.el: Require sendmail for mail-mode-map.
+
+ * lisp/bbdb-anniv.el (number): Use with-no-warnings.
+
+ * lisp/bbdb-com.el (bbdb-divide-name): Fix regexp for matching
+ last name prefixes.
+
+2011-05-11 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-update-records): Fix previous patch.
+ (bbdb-prompt-for-create): Use special-mode.
+
+2011-05-11 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-notice-mail-hook): Rename from
+ bbdb-notice-hook.
+ (bbdb-notice-record-hook): New variable.
+ (bbdb-notice-hook-pending): Update doc string.
+
+ * lisp/bbdb-mua.el (bbdb-update-records): Call
+ bbdb-notice-record-hook.
+ (bbdb-annotate-message): Use bbdb-notice-mail-hook.
+
+ * lisb/bbdb-vm.el (bbdb/vm-auto-add-label): Update doc string.
+
+2011-05-08 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-display-all-records): Use redisplay. Why
+ needed?
+
+2011-05-08 Leo <sdl.web@gmail.com>
+ * lisp/bbdb-com.el (bbdb-merge-records-internal): Fix typo
+
+2011-05-08 Leo <sdl.web@gmail.com>
+ * lisp/bbdb-mua.el (bbdb-auto-notes): Fix typo
+
+2011-05-07 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-display-current-record): New command.
+ (bbdb-display-all-records): Improve docstring.
+
+ * lisp/bbdb.el (bbdb-mode-map): Key bindings for
+ bbdb-display-all-records and bbdb-display-current-record.
+
+2011-04-29 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ * lisp/bbdb.el (bbdb-init-forms): Fix typo.
+ (bbdb-parse-internal): Clarify error message.
+
+2011-04-29 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ * lisp/bbdb-migrate.el (bbdb-peel-the-onion): New function.
+ (bbdb-migrate): Use it for cleaning up corrupted BBDB files.
+
+2011-04-29 Barak A. Pearlmutter <barak@cs.nuim.ie>
+ * lisp/Makefile: Use option --batch. New target TAGS.
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el, lisp/bbdb-com.el, lisp/bbdb-migrate.el,
+ lisp/bbdb-print.el: Rename degree field to affix.
+
+2011-04-29 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-display-name-organization): Include name in
+ text property.
+ (bbdb-scan-property): New function.
+ (bbdb-next-record, bbdb-prev-record): Use it.
+ (bbdb-next-field, bbdb-prev-field): New commands bound to "N" and
+ "P".
+
+2011-04-23 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-pop-up-window): Rename from
+ bbdb-pop-up-buffer.
+ * lisp/bbdb.el (bbdb-display-records-internal)
+ * lisp/bbdb-com.el (bbdb-complete-mail): Use new name.
+
+2011-04-23 Leo <sdl.web@gmail.com>
+ * lisp/bbdb.el (bbdb-pop-up-buffer): Distinguish 1 and 1.0 in
+ bbdb-pop-up-window-size.
+
+2011-04-23 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-message.el (bbdb-insinuate-message)
+ (bbdb-insinuate-mail)
+ * lisp/bbdb-rmail.el (bbdb-insinuate-rmail)
+ * lisp/bbdb-gnus.el (bbdb-insinuate-gnus)
+ * lisp/bbdb-mhe.el (bbdb-insinuate-mh)
+ * lisp/bbdb-vm.el (bbdb-insinuate-vm): Fix docstring.
+
+2011-04-23 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mode-map): Do no call set-keymap-parent which
+ is done already by define-derived-mode. Reported by Sam Steingold
+ <sds@gnu.org>. Add menu binding for revert-buffer.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-create-hook, bbdb-change-hook): Use defvar.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-time-stamp-format): Includes timezone info.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * TODO: New file.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-faces): Group of faces used by BBDB.
+ (bbdb-name, bbdb-organization, bbdb-field-name): New faces.
+ (bbdb-display-name-organization, bbdb-display-record-one-line)
+ (bbdb-display-record-multi-line): Use them.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mode-map): Inherit from special-mode-map.
+ (bbdb-quit-window): Renamed from bbdb-bury-buffer. Use
+ quit-window.
+ (bbdb-mode): Use define-derived-mode.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-indent-string): New function.
+ (bbdb-display-record-multi-line): Use it. (Bug#33101)
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el: Autoload browse-url-url-at-point.
+
+2011-04-16 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-create-hook, bbdb-change-hook): Call
+ add-hook for the default hook functions.
+
+2011-04-11 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-com.el (bbdb-complete-mail): Ensure initialization of
+ the database.
+
+2011-04-10 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-utilities-anniv): New customization group.
+ (bbdb-create-hook, bbdb-change-hook)
+ (bbdb-after-change-hook, bbdb-notice-hook)
+ (bbdb-default-separator): Improve doc string.
+ (bbdb-separator-alist): Improve doc string. Include entries for
+ anniversaries.
+ (bbdb-records): Use make-variable-buffer-local.
+ (bbdb-current-field): Do not remove field-name.
+ (bbdb-record-note): Simplified.
+ (bbdb-record-note-n): Removed.
+ (bbdb-record-note-split): New function.
+ (bbdb-record-set-note): Improved documentation.
+ (bbdb-format-note, bbdb-record-format-note): New function.
+ (bbdb-display-text): Renamed from bbdb-format-text.
+ (bbdb-display-list): Renamed from bbdb-format-list.
+ (bbdb-display-name-organization): Renamed from
+ bbdb-format-name-organization.
+ (bbdb-display-record-one-line): Renamed from
+ bbdb-format-record-one-line. Unify text properties.
+ (bbdb-display-record-multi-line): Renamed from
+ bbdb-format-record-multi-line. Unify text properties.
+ (bbdb-display-record-full-multi-line): Renamed from
+ bbdb-format-record-full-multi-line.
+ (bbdb-display-record-pop-up-multi-line): Renamed from
+ bbdb-format-record-pop-up-multi-line.
+ (bbdb-display-record): Renamed from bbdb-format-record.
+ (bbdb-parse-internal, bbdb-parse-frobnicate): Simplified search
+ for first record.
+ (bbdb-delete-record-internal, bbdb-overwrite-record-internal):
+ Disentangle code.
+
+ * lisp/bbdb-com.el (bbdb-editable): Throw error if *BBDB* buffer
+ is out of sync with database.
+ (bbdb-search): Use suffix -re for all args that are regular
+ expressions.
+ (bbdb-delete-duplicate-mails, bbdb-sort-addresses)
+ (bbdb-sort-phones, bbdb-sort-notes): New optional arg update.
+ (bbdb-record-edit-note): Renamed from bbdb-record-edit-notes.
+ (bbdb-list-transpose, bbdb-ident-point): New functions.
+ (bbdb-transpose-fields): Use them. Make code more robust such
+ that it can be applied to any subfields of the same type.
+ (bbdb-field-equal, bbdb-next-field): Removed (obsolete).
+ (bbdb-mail-aliases, bbdb-get-mail-aliases, bbdb-add-mail-alias)
+ (bbdb-browse-url): Use bbdb-record-note-split.
+
+ * lisp/bbdb-mua.el (bbdb-mua-wrapper): Do not use
+ rmail-select-summary.
+ (bbdb-mua-auto-update): Bug fix.
+
+ * lisp/bbdb-rmail.el (bbdb-insinuate-rmail)
+ * lisp/bbdb-mhe.el (bbdb-insinuate-mh): Bind to
+ bbdb-mua-edit-notes-sender.
+
+ * lisp/bbdb-vm.el (bbdb/vm-auto-folder, bbdb/vm-virtual-folder)
+ (bbdb/vm-auto-add-label): Use bbdb-record-note-split.
+
+ * lisp/bbdb-print.el (bbdb-print-omit-fields): Remove `omit'.
+
+ * lisp/bbdb-anniv.el: New file.
+
+ * lisp/Makefile: Honor lisp/bbdb-anniv.el.
+
+2011-03-05 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-modeline-info): New variable.
+ (bbdb-mode): Use it.
+ (bbdb-mode-map): Unify keybindings for search commands.
+ (bbdb-sort-records): Update marker positions correctly.
+
+ * lisp/bbdb-com.el (bbdb-append-display-p, bbdb-append-display)
+ (bbdb-search-invert-p, bbdb-search-invert): Use
+ bbdb-modeline-info.
+ (bbdb-search): Also search for addresses. Simplify codde.
+ (bbdb-search-address): New command.
+ (bbdb-search-phone): Fix prompt.
+
+ * lisp/bbdb-mua.el (bbdb-mua-wrapper): Simplify code.
+ (bbdb-mua-auto-update-init): Doc fix.
+
+ * lisp/bbdb-message.el (bbdb/message-update-records-p)
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records-p)
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records-p)
+ * lisp/bbdb-mhe.el (bbdb/mh-update-records-p)
+ * lisp/bbdb-vm.el (bbdb/vm-update-records-p): Doc fix.
+
+2011-02-27 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-address-format-list): New variable for
+ customization of address formatting and editing. (renamed
+ from bbdb-address-format-alist).
+ (bbdb-format-address): Use it.
+ (bbdb-format-record-one-line, bbdb-format-record-multi-line): Use
+ bbdb-format-address.
+ (bbdb-address-edit-function, bbdb-format-streets)
+ (bbdb-format-address-continental): Removed. Obsolete because of
+ bbdb-address-format-list.
+ (bbdb-format-record): Use funcall instead of eval.
+ (bbdb-continental-postcode-regexp): Renamed from
+ bbdb-continental-zip-regexp.
+ (bbdb-check-postcode): Renamed from bbdb-check-zip.
+ (bbdb-legal-postcodes): Renamed from bbdb-legal-zip-codes.
+ (bbdb-expand-mail-aliases): Removed.
+ (bbdb-notes-label-list): Renamed from bbdb-notes-names.
+ (bbdb-parse-frobnicate): Calculate value of bbdb-notes-label-list
+ instead of reading it. Use memq instead of member.
+ (bbdb-set-notes-labels): Renamed from bbdb-set-notes-names. Do not
+ write value of bbdb-notes-label-list.
+ (bbdb-set-eq): Removed (obsolete).
+ (bbdb-defstruct): Use defsubst.
+ (bbdb-record-unset-name): Clarify code.
+ (bbdb-initialize): Doc fix.
+
+ * lisp/bbdb-com.el (bbdb-message-search): Use name only if mail
+ address does not match.
+ (bbdb-parse-postcode): Renamed from bbdb-parse-zip.
+ (bbdb-insert-field): In interactive calls ignore fields that are
+ already present.
+ (bbdb-record-edit-phone): Convert format of phone number if old
+ and new format are different.
+ (bbdb-edit-field): Use new bbdb-record-edit-phone.
+ (bbdb-record-edit-address): Use bbdb-address-format-list.
+ (bbdb-edit-address-street): Renamed from
+ bbdb-address-edit-street. Take arg street instead of address.
+ (bbdb-edit-address-default): Renamed from
+ bbdb-address-edit-default.
+ (bbdb-address-edit-continental): Removed (obsolete).
+ (bbdb-complete-mail-cleanup): Removed. Code merged with
+ bbdb-complete-mail.
+ (bbdb-complete-mail): Return non-nil if valid completion
+ exists. Simplify code.
+
+ * lisp/bbdb-mua.el (bbdb-annotate-message): Use bbdb-string=.
+ (bbdb-mua-wrapper): Also handle mail and message mode.
+ (bbdb-mua-auto-update): Renamed from bbdb-mua-pop-up-bbdb-buffer.
+ Perform auto update even if bbdb-message-pop-up is nil.
+ (bbdb-mua-auto-update-init): Renamed from
+ bbdb-mua-pop-up-init. Doc fix. Use memq instead of member.
+ (bbdb-force-record-create): Removed (obsolete).
+
+ * lisp/bbdb-migrate.el (bbdb-migrate-postcodes-to-strings):
+ Renamed from bbdb-migrate-zip-codes-to-strings.
+
+ * lisp/bbdb-print.el (bbdb-print-tex-quote-alist): Fix regexp.
+ (bbdb-print-address-format-list): Renamed from
+ bbdb-print-address-format-alist. Use bbdb-address-format-list as
+ default.
+ (bbdb-print): Use bbdb-format-address.
+ (bbdb-print-address-continental): Removed.
+
+2011-01-17 Roland Winkler <winkler@gnu.org>
+ * lisp/Makefile: Do not attempt to add empty line to
+ bbdb-autloads.el.
+
+2011-01-16 Roland Winkler <winkler@gnu.org>
+ * README: Updated.
+
+ * lisp/Makefile: In bbdb-autloads.el, add BBDB lisp directory to
+ load-path.
+
+ * lisp/bbdb.el (bbdb-pop-up-buffer): Use condition-case, in case
+ split-window fails.
+ (bbdb-records, bbdb-mode, bbdb-version, bbdb-initialize): Add
+ autoload cookie.
+
+2011-01-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-mua-update-records): For Gnus use
+ gnus-article-buffer.
+ (bbdb-mua-wrapper): New macro.
+ (bbdb-mua-display-records, bbdb-mua-annotate-sender)
+ (bbdb-mua-annotate-recipients, bbdb-mua-edit-notes-sender)
+ (bbdb-mua-edit-notes-recipients): Use it.
+ (bbdb-mua-update-mua): Removed (obsolete because of
+ bbdb-mua-wrapper).
+
+ * lisp/bbdb-gnus.el (bbdb-insinuate-gnus): Code doc updated.
+
+ * lisp/bbdb-com.el (bbdb-complete-name): Obsolete alias for
+ bbdb-complete-mail.
+
+2011-01-06 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-message-headers, bbdb-accept-name-mismatch)
+ (bbdb-use-alternate-names): Fix docstring.
+ (bbdb-auto-notes-rules): Renamed from bbdb-auto-notes-alist. New
+ format.
+ (bbdb-auto-notes-ignore-messages): Renamed from
+ bbdb-auto-notes-ignore-all.
+ (bbdb-auto-notes-ignore-headers): Renamed from
+ bbdb-auto-notes-ignore.
+ (bbdb-pop-up-window-size): Fix docstring.
+ (bbdb-horiz-pop-up-window-size): New variable.
+ (bbdb-pop-up-buffer): Use it.
+ (bbdb-auto-notes-rules-expanded): New variable.
+
+ * lisp/bbdb-com.el: Use eval-and-compile.
+ (bbdb-subint): Moved here from lisp/bbdb.el. Simplified.
+ (bbdb-parse-phone): Return value always includes extension.
+ (bbdb-read-record): Simplified accordingly.
+ (bbdb-prompt-for-new-field): Use phone number style as returned
+ from bbdb-parse-phone.
+
+ * lisp/bbdb-mua.el: Use eval-and-compile.
+ (bbdb-update-records): Avoid name clash with function search in
+ cl-seq.el.
+ (bbdb-message-header-re): New function.
+ (bbdb-accept-message): Use it.
+ (bbdb-get-address-components): Also return MUA.
+ (bbdb-annotate-message): Bug fix. Simplify.
+ (bbdb-mua-pop-up-init): New function.
+ (bbdb-auto-notes): Complete re-write.
+
+ * lisp/bbdb-message.el (bbdb-insinuate-message)
+ (bbdb-insinuate-mail)
+ * lisp/bbdb-rmail.el (bbdb-insinuate-rmail)
+ * lisp/bbdb-gnus.el (bbdb-insinuate-gnus)
+ * lisp/bbdb-mhe.el (bbdb-insinuate-mh)
+ * lisp/bbdb-vm.el (bbdb-insinuate-vm): Do not hook in
+ bbdb-mua-pop-up-bbdb-buffer. (Use instead bbdb-mua-pop-up-init.)
+
+2010-12-15 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mua-message): New customization group.
+ (bbdb-update-records-p): Value may also be a function.
+ (bbdb-mua-update-interactive-p): New variable.
+ (bbdb-init-forms): Add message and mail mode support. Sendmail is
+ deprecated (use mail instead). Remove outdated support for
+ reportmail, supercite and w3.
+ (bbdb-initialize): Updated accordingly. Do not test presence of
+ features (which is not needed).
+ (bbdb-insinuate-sendmail): Removed (use bbdb-insinuate-mail).
+ ( bbdb-insinuate-message): Moved to bbdb-message.el.
+
+ * lisp/bbdb-com.el (bbdb-mail, bbdb-mail-address): Simplified.
+
+ * lisp/bbdb-mua.el (bbdb-mua, bbdb-message-header): New functions.
+ (bbdb-get-address-components): Use bbdb-message-header.
+ Simplified.
+ (bbdb-update-records): New arg msg-key. Handle message cache.
+ Arg update-p may also be a function.
+ (bbdb-mua-update-records, bbdb-mua-update-mua)
+ (bbdb-mua-update-interactive-p, bbdb-mua-pop-up-bbdb-buffer): New
+ functions.
+ (bbdb-mua-display-records, bbdb-mua-display-sender)
+ (bbdb-mua-display-recipients, bbdb-mua-annotate-sender)
+ (bbdb-mua-annotate-recipients, bbdb-mua-edit-notes-sender)
+ (bbdb-mua-edit-notes-recipients): New commands.
+
+ * lisp/bbdb-vm.el (bbdb/vm-header): Remove MIME decoding.
+ (bbdb/vm-update-records, bbdb/vm-pop-up-bbdb-buffer)
+ (bbdb/vm-show-records, bbdb/vm-show-sender)
+ (bbdb/vm-show-recipients, bbdb/vm-annotate-sender)
+ (bbdb/vm-edit-notes): Obsolete. Use instead generic functions in
+ bbdb-mua.el.
+ (bbdb-insinuate-vm): Use generic commands.
+
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records)
+ (bbdb/gnus-pop-up-bbdb-buffer, bbdb/gnus-show-records)
+ (bbdb/gnus-show-sender, bbdb/gnus-show-recipients)
+ (bbdb/gnus-annotate-sender, bbdb/gnus-edit-notes)
+ (bbdb/gnus-summary-show-all-recipients): Obsolete. Use instead
+ generic functions in bbdb-mua.el.
+ (bbdb-insinuate-gnus): Use generic commands.
+ (bbdb/gnus-lines-and-from-length): Removed as
+ gnus-optional-headers appears to be obsolete, too.
+ (bbdb/gnus-message-marker-field): New variable.
+ (bbdb-message-marker-field): Declared obsolete.
+ (bbdb/gnus-summary-get-sender, bbdb/gnus-summary-sender-in-bbdb)
+ (bbdb/gnus-nnimap-folder-list-from-bbdb): Simplified.
+
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records)
+ (bbdb/rmail-pop-up-bbdb-buffer, bbdb/rmail-show-records)
+ (bbdb/rmail-show-sender, bbdb/rmail-show-recipients)
+ (bbdb/rmail-annotate-sender, bbdb/rmail-edit-notes)
+ (bbdb/rmail-summary-show-all-recipients): Obsolete. Use instead
+ generic functions in bbdb-mua.el.
+ (bbdb-insinuate-rmail): Use generic commands. Remove defadvice
+ which has become obsolete because header Messge-ID is used for
+ message caching.
+
+ * lisp/bbdb-mhe.el, lisp/bbdb-message.el: New files.
+
+ * lisp/Makefile: Updated to compile also the new files.
+
+2010-11-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-update-records-p): Fix docstring.
+ (bbdb-message-pop-up): Change default to a less aggressive nil.
+ (bbdb-format-record-one-line): Remove linebreaks from multi-line
+ notes.
+
+ * lisp/bbdb-com.el (bbdb-delete-duplicate-mails)
+ (bbdb-display-records-completely)
+ (bbdb-display-records-with-layout, bbdb-copy-records-as-kill): Doc
+ fix.
+ (bbdb-search-duplicates): Improved interactive spec. New arg
+ records. Doc fix
+ (bbdb-delete-field-or-record): Make records a required arg. New
+ arg fields. Doc fix.
+ (bbdb-delete-records, bbdb-toggle-records-layout)
+ (bbdb-sort-addresses, bbdb-sort-phones, bbdb-sort-notes)
+ (bbdb-add-mail-alias): Make records a required arg. Doc fix.
+ (bbdb-mail-address): New command bound to M.
+ (bbdb-mail): Use it. New arg verbose. Fix interactive spec.
+ (bbdb-mail-yank): Renamed from bbdb-yank-addresses. Bug fix.
+ (bbdb-yank-addresses): Declared obsolete.
+ (bbdb-browse-url): Simplify. Doc fix.
+ (bbdb-grab-url): Simplify.
+
+ * lisp/bbdb-vm.el (bbdb/vm-update-records-p)
+ * lisp/bbdb-gnus.el (bbdb/gnus-update-records-p)
+ * lisp/bbdb-rmail.el (bbdb/rmail-update-records-p): Improved default.
+
+2010-11-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-wrap-column): New variable.
+ (bbdb-format-list): Use bbdb-wrap-column and bbdb-separator-alist.
+ (bbdb-layout-alist, bbdb-format-address-continental)
+ (bbdb-format-address-default, bbdb-format-record-multi-line):
+ Change value of indentation such that it becomes the total
+ indentation.
+
+ * lisp/bbdb-com.el (bbdb-dwim-mail): Fix typo.
+
+2010-10-17 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-mail-allow-redundancy): Doc fix.
+ (bbdb-mode-map): Include bbdb-do-all-records in "Use database"
+ submenu.
+
+ * lisp/bbdb-com.el (bbdb-record-list): Doc fix.
+ (bbdb-dwim-mail): Arg MAIL may be a number,
+ which will pick the MAILth mail address.
+ (bbdb-mail): New optional arg N to pick Nth mail address.
+
+2010-09-30 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-insert-record-internal): Handle empty
+ database properly.
+ * lisp/bbdb-com.el (bbdb-dwim-mail): Cleanup code.
+
+2010-09-19 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb-mua.el (bbdb-prompt-for-create): Quit with C-g.
+ (bbdb-annotate-message) Call UPDATE-P only if record is not yet
+ defined.
+
+2010-08-28 Roland Winkler <winkler@gnu.org>
+ * Relicense all BBDB files to GPLv3 or later. Update email
+ address to winkler@gnu.org.
+
+ * lisp/bbdb.el (bbdb-completion-list): Element name replaced by
+ fl-name and lf-name.
+
+ * lisp/bbdb-com.el (bbdb-insert-field): Use remq instead of delq.
+ (bbdb-complete-mail): Do not use trimmed version of the pattern
+ for partial completion. Distinguish fl-name and lf-name.
+
+2010-08-01 Roland Winkler <winkler@gnu.org>
+ * lisp/bbdb.el (bbdb-message-caching): Renamed from
+ bbdb-message-caching-enabled.
+ (bbdb-create-hook): Renamed from bbdb-create-hooks.
+ (bbdb-change-hook): Renamed from bbdb-change-hooks.
+ (bbdb-after-change-hook): Renamed from bbdb-after-change-hooks.
+ (bbdb-notice-hook): Renamed from bbdb-notice-hooks.
+ (bbdb-accept-message-alist): Renamed from
+ bbdb-accept-messages-alist.
+ (bbdb-ignore-message-alist): Renamed from
+ bbdb-ignore-messages-alist.
+ (bbdb-update-records-p): New user var.
+ (bbdb-notice-hook-pending): Renamed from bbdb-inside-notice-hooks.
+ (bbdb-user-mail-address-re): Renamed from bbdb-user-mail-names.
+ (bbdb-mail-allow-redundancy): Renamed from
+ bbdb-dwim-mail-allow-redundancy.
+ (bbdb-check-auto-save-file): Renamed from
+ bbdb-notice-auto-save-file.
+ (bbdb-completion-list): Renamed from bbdb-completion-alist.
+ (bbdb-mail-alias): Renamed from bbdb-mail-alias-mode.
+ (bbdb-mail-user-agent): Replacement for bbdb-user-style.
+ (bbdb-compose-mail): Renamed from bbdb-mail-internal.
+ (bbdb-default-separator): Renamed from
+ bbdb-notes-default-separator.
+ (bbdb-separator-alist): Renamed from bbdb-notes-separator-alist.
+ (bbdb-concat): Renamed from bbdb-join.
+
+ * lisp/bbdb-com.el (bbdb-grab-url): Renamed from
+ bbdb-url-grab-url.
+
+ * lisp/bbdb-mua.el: New file. Content merged from bbdb-com.el and
+ bbdb-hooks.el
+ (bbdb-get-address-components): Changed calling sequence.
+ (bbdb-message-header): Renamed from bbdb-message-field.
+ (bbdb-accept-message): Renamed from bbdb-ignore-most-messages.
+ (bbdb-ignore-message): Renamed from bbdb-ignore-some-messages.
+ (bbdb-select-message): Renamed from
+ bbdb-ignore-selected-messages-hook.
+ (bbdb-auto-notes): Renamed from bbdb-auto-notes-hook.
+ (bbdb-canonicalize-mail-1): Renamed from
+ bbdb-sample-canonicalize-mail-function.
+
+ * lisp/bbdb-print.el (bbdb-print-file): Renamed from
+ bbdb-print-file-name.
+ (bbdb-print-tex-quote-alist): New var.
+ (bbdb-print-address-format-alist): Renamed from
+ bbdb-address-print-format-alist.
+ (bbdb-print-record): Renamed from bbdb-print-format-record.
+ (bbdb-print-address-continental): Renamed from
+ bbdb-print-format-address-continental.
+ (bbdb-print-address-default): Renamed from
+ bbdb-print-format-address-default.
+ (bbdb-print-phone): Renamed from bbdb-print-phone-string.
+
+ * lisp/bbdb-vm.el (bbdb/vm-auto-folder): Renamed from
+ bbdb/vm-auto-folder-alist.
+ (bbdb/vm-virtual-folder): Renamed from
+ bbdb/vm-virtual-folder-alist.
+
+;; Local Variables:
+;; coding: utf-8
+;; End:
+
+ Copyright (C) 2010-2017 Roland Winkler <winkler@gnu.org>
+
+ This file is part of the Insidious Big Brother Database (aka BBDB),
+
+ BBDB is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ BBDB is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with BBDB. If not, see <http://www.gnu.org/licenses/>.
--- /dev/null
+# Rules to generate the files that need to go into the ELPA package.
+
+# Copied and adapted from AUCTeX's GNUmakefile.
+
+MAKEINFO=makeinfo
+INSTALL_INFO=install-info
+
+MANUALS=bbdb
+INFO_FILES=$(MANUALS:=.info)
+
+# FIXME: Currently these files need to be stored in the elpa.git repository
+# because the elpa.gnu.org scripts don't know how to build the Info file
+# from the Texinfo file.
+GENERATED_FILES=dir $(INFO_FILES)
+
+elpa: $(GENERATED_FILES)
+
+clean:
+ rm -f $(GENERATED_FILES)
+
+TEXI_SOURCES:=$(wildcard doc/*.texi)
+$(INFO_FILES): %.info: $(TEXI_SOURCES)
+ cd doc; $(MAKEINFO) --no-split $*.texi
+ mv doc/$*.info $@
+
+dir: $(INFO_FILES)
+ for f in $(INFO_FILES); do $(INSTALL_INFO) --info-dir=. $$f; done
--- /dev/null
+BBDB NEWS -- history of user-visible changes.
+
+Copyright (C) 2013-2017 Roland Winkler <winkler@gnu.org>
+See the end of the file for license conditions.
+
+This file is about changes in BBDB version 3.
+
+* BBDB 3.2
+** BBDB 3.2 requires GNU Emacs 24 or newer.
+Support for GNU Emacs 23 has been discontinued.
+
+** Support for Mu4e and Wanderlust has been added.
+
+** Incompatible Changes in BBDB 3.2
+
+*** The variables bbdb/MUA-update-records-p have been removed.
+This includes the variables bbdb/gnus-update-records-p,
+bbdb/mail-update-records-p, bbdb/message-update-records-p,
+bbdb/mh-update-records-p, bbdb/rmail-update-records-p,
+bbdb/vm-update-records-p.
+
+These fall-back variables collided with the user variables
+bbdb-mua-update-interactive-p and bbdb-mua-auto-update-p.
+Use function bbdb-mua to define your own function to get
+MUA-specific values.
+
+* BBDB 3.1.2
+** Bug fix release
+** New command bbdb-fix-records
+
+
+* BBDB 3.1.1
+** Updated autoconf and automake scripts
+** Lisp code in 3.1.1 is identical to lisp code in 3.1.
+
+
+* BBDB 3.1
+Initial release
+
+
+\f
+----------------------------------------------------------------------
+This file is part of the Insidious Big Brother Database (aka BBDB),
+
+BBDB is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+BBDB is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+\f
+Local variables:
+mode: outline
+paragraph-separate: "[ \f]*$"
+end:
--- /dev/null
+Copyright (C) 2010-2017 Roland Winkler <winkler@gnu.org>
+See the end of the file for license conditions.
+
+BBDB is the Insidious Big Brother Database for GNU Emacs.
+It provides an address book for email and snail mail addresses,
+phone numbers and the like. It can be linked with various Emacs mail
+clients (Message and Mail mode, Rmail, Gnus, MH-E, Mu4e, VM, and
+Wanderlust). BBDB is fully customizable.
+
+BBDB is available at
+http://savannah.nongnu.org/projects/bbdb/
+To check it out, use
+git clone git://git.savannah.nongnu.org/bbdb.git
+
+Questions, comments, suggestions, and bug reports may be directed to
+the BBDB mailing list at bbdb-user@nongnu.org.
+To subscribe to this list, go to
+https://lists.nongnu.org/mailman/listinfo/bbdb-user.
+
+==================================================================
+Installation: (see also the generic file INSTALL)
+
+To compile and install BBDB with `make':
+
+0) (BBDB development version only)
+
+ Configure the configure process:
+
+ Run `autogen.sh' in the top directory of the BBDB code.
+ This creates the `configure' script required for step 1).
+
+1) Configure the build process:
+
+ Run the `configure' script in the top directory of the BBDB code.
+ This performs a number of checks on your system and generates the
+ Makefiles accordingly. You need at least GNU Emacs 24.
+
+ The `configure' script comes with various options:
+
+ `--with-mu4e-dir=DIR' specifies the path where Mu4e can be found.
+ Without this option the resulting BBDB build does not support Mu4e.
+
+ `--with-vm-dir=DIR' specifies the path where VM can be found.
+ Without this option the resulting BBDB build does not support VM.
+
+ `--with-wl-dir=DIR' specifies the path where Wanderlust can be found.
+ Without this option the resulting BBDB build does not support WL.
+
+ `--with-lispdir=DIR' specifies where to install the lisp files.
+
+ Use `configure --help' to see all available options.
+
+2) Build BBDB:
+
+ To build BBDB type 'make'.
+
+ If you use the BBDB development version, but you do not have autoconf,
+ go to the lisp directory and type 'make --makefile=./makefile-temp'.
+
+3) Install BBDB:
+
+ To install BBDB type `make install'.
+ This installs all files in their usual system directories.
+ You can override these defaults via respective options
+ for the configure script.
+
+ The TeX files in the tex directories are installed in ${datadir}
+ which defaults to /usr/local/share/bbdb/. These files are only
+ used by BBDB. They need not be made known to your local TeX
+ installation. See the user variable bbdb-print-tex-path below.
+
+ `make install' is not required to run BBDB.
+
+4) Activate BBDB:
+
+ i) If the BBDB lisp files are in a directory
+ "/path/to/bbdb/lisp" you can use in your emacs init file
+
+ (require 'bbdb-loaddefs "/path/to/bbdb/lisp/bbdb-loaddefs.el")
+
+ This adds "/path/to/bbdb/lisp" to the load-path; so it is all
+ you need to make BBDB known to your Emacs.
+
+ ii) The user variable bbdb-print-tex-path should point to the directory
+ where the BBDB TeX files reside (default /usr/local/share/bbdb).
+
+===============================================================================
+Usage notes
+
+BBDB 3 is the first release of BBDB after a long time.
+Up to BBDB 3.1.2 it requires GNU Emacs 23 or newer.
+More recent versions require GNU Emacs 24 or newer.
+
+The code of BBDB 3 is still under development.
+While it should work reliably, users of previous versions of BBDB
+are advised that the format of the BBDB database file has changed.
+Migration to the new format should happen automatically.
+Yet it is recommended to make a copy of the old file, in case
+something unexpected happens or you might want to go back.
+
+As compared with BBDB 2.xx, many variables, functions, and commands
+have changed in BBDB 3. Most likely you will have to review your
+customizations carefully. You may want to call bbdb-undocumented-variables
+to identify outdated (i.e., now usually undocumented) variables in
+your init file. Those upgrading from BBDB 2.xx may also find this
+Emacs wiki page helpful: https://www.emacswiki.org/emacs/UpgradeBBDB
+All user variables for the core of BBDB 3 are listed at the beginning
+of bbdb.el. Some extensions of BBDB 3 define their user variables
+at the beginning of the respective files.
+
+Generally the default values for user variables are chosen such that they make
+BBDB the least aggressive. You can customize this behavior in many ways.
+See below for an overview.
+
+The BBDB info manual is still awaiting a more complete overhaul.
+
+
+BBDB interface with mail user agents (MUAs)
+===========================================
+
+BBDB can interface with various mail user agents (MUAs).
+These include Rmail, Gnus, VM, MH-E, Mu4e, Wanderlust, Message and Mail mode.
+This lets you
+
+ - display the BBDB records for the sender and/or recipients of a
+ message you are viewing
+
+ - create or update the BBDB records for the sender and/or
+ recipients of a message
+
+ - add annotations to the BBDB records for the sender and/or
+ recipients of a message
+
+There are two ways for BBDB to interface with MUAs:
+
+Interactive commands
+--------------------
+
+Call bbdb-initialize (usually in your init file) to initialize
+the MUA interfaces based on interactive commands
+
+MUA commands include
+
+ bbdb-mua-display-records, bbdb-mua-display-sender, bbdb-mua-display-recipients
+ bbdb-annotate-record, bbdb-mua-annotate-sender, bbdb-mua-annotate-recipients
+ bbdb-mua-edit-field, bbdb-mua-edit-field-sender, bbdb-mua-edit-field-recipients
+
+These MUA commands operate either on existing records only. Or they
+can create new records.
+
+They are all controlled by bbdb-mua-update-interactive-p.
+This is a cons pair (WITHOUT-PREFIX . WITH-PREFIX).
+The car is used if the command is called without a prefix.
+The cdr is used if the command is called with a prefix (and if the prefix
+ is not used for another purpose).
+
+WITHOUT-PREFIX and WITH-PREFIX may take the values
+(here ADDRESS is an email address found in a message):
+ nil Do nothing.
+ search Search for existing records matching ADDRESS.
+ update Search for existing records matching ADDRESS;
+ update name and mail field if necessary.
+ query Search for existing records matching ADDRESS;
+ query for creation of a new record if the record does not exist.
+ create or t Search for existing records matching ADDRESS;
+ create a new record if it does not yet exist.
+ a function This functions will be called with no arguments.
+ It should return one of the above values (see below).
+ read Read the value interactively.
+
+BBDB 2 also used MUA-specific variables bbdb/MUA-update-records-mode
+to control its interfaces with MUAs. Use function bbdb-mua to define
+your own function to get MUA-specific values.
+
+Noninteractive functions
+------------------------
+
+Call bbdb-mua-auto-update-init (usually in your init file)
+to hook BBDB's hook function bbdb-mua-auto-update into the MUAs.
+
+bbdb-mua-auto-update automatically updates the BBDB records for the
+sender and/or recipients of a message. If bbdb-mua-pop-up is non-nil,
+the matching records are also displayed in a continuously updated BBDB window,
+
+The behavior of bbdb-mua-auto-update is controlled by bbdb-mua-auto-update-p.
+This may take the same values as bbdb-mua-update-interactive-p (except read).
+Binding this to a function is often most helpful for noninteractive use.
+For example, you may want to bind bbdb-mua-auto-update-p to the function
+bbdb-select-message, see bbdb-accept-message-alist and
+bbdb-ignore-message-alist. If a message is accepted by bbdb-select-message,
+the actual action performed by BBDB (i.e., the return value of
+bbdb-select-message) is given by bbdb-update-records-p.
+
+==================================================================
+
+Notes for BBDB lisp hackers:
+----------------------------
+
+If you write your own functions and commands to modify BBDB records,
+do not call the low-level functions bbdb-record-set-* such as
+bbdb-record-set-aka, bbdb-record-set-mail etc. The recommended
+sequence of calls is
+
+- one or multiple calls of bbdb-record-set-field for the respective
+ fields to be changed. This not only sets the fields, but it also
+ ensures the integrity of the database. Also, this makes your code
+ more robust with respect to possible future changes of BBDB's
+ innermost internals.
+
+- a call of bbdb-change-record which updates the database after a
+ change of record and redisplays the records.
+
+- To display newly created records call bbdb-display-records.
+
+==================================================================
+
+Copyright (C) 2010-2017 Roland Winkler <winkler@gnu.org>
+
+This file is part of the Insidious Big Brother Database (aka BBDB),
+
+BBDB is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+BBDB is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with BBDB. If not, see <http://www.gnu.org/licenses/>.
--- /dev/null
+BBDB todo List -*-outline-*-
+
+Copyright (C) 2011-2017 Roland Winkler <winkler@gnu.org>
+See the end of the file for license conditions.
+
+* Bug fixes
+
+* Release BBDB v3.
+
+** Facilitate update BBDB v2.x to v3
+ Compile list of changes BBDB v3 versus v2.x.
+ Which variables / functions / commands / key bindings / concepts
+ in v3 have replaced which ones from v2?
+
+ Is it possible / meaningful to set up a file bbdb-v2.el with
+ aliases for v2 variable and function names mapping to the names
+ used in v3?
+
+** Update / rewrite texinfo manual
+
+** Copyright
+ Identify contributors. Assign copyright to FSF.
+
+** Get BBDB on the GNU ELPA
+
+** Write BBDB tests using ERT
+
+* Features
+
+** Command bbdb-copy-fields-as-kill
+
+** Prioritize BBDB records
+ 2011-04-11 Sam Steingold <sds@gnu.org>
+ Records with low priority are not considered for printing etc.
+
+** Prioritize email addresses of a record
+ 2011-04-11 Sam Steingold <sds@gnu.org>
+ Records with low priority are still considered for identifying
+ old emails and news messages. But they are ignored for new
+ emails (e.g., completion).
+
+** Import / export BBDB records (e.g. vcard or its XML derivative)
+ 2011-04-05 Leo <sdl.web@gmail.com>
+ See https://github.com/trebb/bbdb-vcard (latest commit Apr 2010)
+ or its fork
+ https://github.com/tohojo/bbdb-vcard (latest commit Jul 2015)
+
+** Import from Google Contacts (aka Gmail contacts)
+ 2016-10-24 Barak A. Pearlmutter <barak@pearlmutter.net>
+ See https://github.com/tohojo/bbdb-vcard (last commit Sep 2015)
+ which imports only name and email.
+ See also the ASynK program, http://asynk.io/,
+ https://github.com/skarra/ASynK (last commit May 2016),
+ which is a python program that does bi-directional sync between
+ bbdb, Google Contacts, MS Outlook, MS Exchange, and CardDAV.
+
+** Incremental search of BBDB records like bbdb-
+ 2016-10-24 Barak A. Pearlmutter <barak@pearlmutter.net>
+ The bbdb- package adds a lovely incremental search facility to bbdb.
+ See https://github.com/aki2o/bbdb- (last commit Feb 2014) which includes
+ a gif showing an incremental search, selection of three records,
+ and their being blasted into the To: and Cc: fields in an email
+ composition buffer.
+
+** Allow splitting of bbdb-file into multiple files
+
+** bbdb-narrow-display: Inverse of bbdb-append-display
+
+* Internals
+
+** Remove bbdb-auto-notes-rules-expanded?
+ 2011-05-05 Leo <sdl.web@gmail.com>
+
+\f
+Copyright (C) 2011-2017 Roland Winkler <winkler@gnu.org>
+
+This file is part of the Insidious Big Brother Database (aka BBDB),
+
+BBDB is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+BBDB is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with BBDB. If not, see <http://www.gnu.org/licenses/>.
--- /dev/null
+;;; bbdb-anniv.el --- get anniversaries from BBDB -*- lexical-binding: t -*-
+
+;; Copyright (C) 2011-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; Anniversaries are stored in xfields as defined via `bbdb-anniv-alist'.
+;; Each such field may contain multiple anniversaries entries with separators
+;; defined via `bbdb-separator-alist' (newlines by default).
+;; Each anniversary entry is a string DATE followed by optional TEXT.
+;; DATE may take the same format as the date of ordinary diary entries.
+;; In particular, `calendar-date-style' is obeyed via `diary-date-forms'.
+;; If `bbdb-anniv-alist' has a non-nil FORM for this type of anniversary,
+;; FORM is used to display the anniversary entry in the diary buffer.
+;; If FORM is nil, TEXT is used instead to display the anniversary entry
+;; in the diary buffer.
+;;
+;; To display BBDB anniversaries in the Emacs diary,
+;; call `bbdb-initialize' with arg `anniv'.
+;;
+;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+(require 'diary-lib)
+(eval-when-compile
+ (require 'cl-lib))
+
+(defcustom bbdb-anniv-alist
+ '((birthday . "%n's %d%s birthday")
+ (wedding . "%n's %d%s wedding anniversary")
+ (anniversary))
+ "Alist of rules for formatting anniversaries in the diary buffer.
+Each element is of the form (LABEL . FORM).
+LABEL is the xfield where this type of anniversaries is stored.
+FORM is a format string with the following substitutions:
+ %n name of the record
+ %d number of years
+ %s ordinal suffix (st, nd, rd, th) for the year.
+ %t the optional text following the date string in field LABEL.
+If FORM is nil, use the text following the date string in field LABEL
+as format string."
+ :type '(repeat (cons :tag "Rule"
+ (symbol :tag "Label")
+ (choice (string)
+ (const nil))))
+ :group 'bbdb-utilities-anniv)
+
+;; `bbdb-anniv-diary-entries' becomes a member of `diary-list-entries-hook'.
+;; When this hook is run by `diary-list-entries', the variable `original-date'
+;; is bound to the value of arg DATE of `diary-list-entries'.
+;; Also, `number' is arg NUMBER of `diary-list-entries'.
+;; `diary-list-entries' selects the entries for NUMBER days starting with DATE.
+
+(defvar original-date) ; defined in diary-lib
+(with-no-warnings (defvar number)) ; defined in diary-lib
+
+;;;###autoload
+(defun bbdb-anniv-diary-entries ()
+ "Add anniversaries from BBDB records to `diary-list-entries'.
+This obeys `calendar-date-style' via `diary-date-forms'.
+To enable this feature, put the following into your .emacs:
+
+ \(add-hook 'diary-list-entries-hook 'bbdb-anniv-diary-entries)"
+ ;; Loop over NUMBER dates starting from ORGINAL-DATE.
+ (let* ((num-date (1- (calendar-absolute-from-gregorian original-date)))
+ (end-date (+ num-date number)))
+ (while (<= (setq num-date (1+ num-date)) end-date)
+ (let* ((date (calendar-gregorian-from-absolute num-date))
+ (dd (calendar-extract-day date))
+ (mm (calendar-extract-month date))
+ (yy (calendar-extract-year date))
+ ;; We construct a regexp that only uses shy groups,
+ ;; except for the part of the regexp matching the year.
+ ;; This way we can grab the year from the date string.
+ (year "\\([0-9]+\\)\\|\\*")
+ (dayname (format "%s\\|%s\\.?" (calendar-day-name date)
+ (calendar-day-name date 'abbrev)))
+ (lex-env `((day . ,(format "0*%d" dd))
+ (month . ,(format "0*%d" mm)) (year . ,year)
+ (dayname . ,dayname)
+ (monthname . ,(format "%s\\|%s" (calendar-month-name mm)
+ (calendar-month-name mm 'abbrev)))))
+ ;; Require that the matched date is at the beginning of the string.
+ (fmt (format "\\`%s?\\(?:%%s\\)"
+ (regexp-quote diary-nonmarking-symbol)))
+ date-forms)
+
+ (cl-flet ((fun (date-form)
+ (push (cons (format fmt
+ (mapconcat (lambda (form) (eval form lex-env))
+ (if (eq (car date-form) 'backup)
+ (cdr date-form) date-form)
+ "\\)\\(?:"))
+ (eq (car date-form) 'backup))
+ date-forms)))
+ (mapc #'fun diary-date-forms)
+
+ ;; The anniversary of February 29 is considered to be March 1
+ ;; in non-leap years. So we search for February 29, too.
+ (when (and (= mm 3) (= dd 1)
+ (not (calendar-leap-year-p yy)))
+ (setq lex-env `((day . "0*29") (month . "0*2") (year . ,year)
+ (dayname . ,dayname)
+ (monthname . ,(format "%s\\|%s" (calendar-month-name 2)
+ (calendar-month-name 2 'abbrev)))))
+ (mapc #'fun diary-date-forms)))
+
+ (dolist (record (bbdb-records))
+ (dolist (rule bbdb-anniv-alist)
+ (dolist (anniv (bbdb-record-xfield-split record (car rule)))
+ (let ((date-forms date-forms)
+ (anniv-string (concat anniv " X")) ; for backup forms
+ (case-fold-search t)
+ form yr text)
+ (while (setq form (pop date-forms))
+ (when (string-match (car form) anniv-string)
+ (setq date-forms nil
+ yr (match-string 1 anniv-string)
+ yr (if (and yr (string-match-p "[0-9]+" yr))
+ (- yy (string-to-number yr))
+ 100) ; as in `diary-anniversary'
+ ;; For backup forms we should search backward in
+ ;; anniv-string from (match-end 0) for "\\<".
+ ;; That gets too complicated here!
+ ;; Yet for the default value of `diary-date-forms'
+ ;; this would matter only if anniv-string started
+ ;; with a time. That is rather rare for anniversaries.
+ ;; Then we may simply step backward by one character.
+ text (substring anniv-string (if (cdr form) ; backup
+ (1- (match-end 0))
+ (match-end 0))
+ -1)
+ text (replace-regexp-in-string "\\`[ \t]+" "" text)
+ text (replace-regexp-in-string "[ \t]+\\'" "" text))
+ (if (cdr rule)
+ (setq text (replace-regexp-in-string "%t" text (cdr rule))))
+ ;; Add the anniversaries to `diary-entries-list'.
+ (if (and (numberp yr) (< 0 (length text)))
+ (diary-add-to-list
+ date
+ ;; `diary-add-to-list' expects an arg SPECIFIER for being
+ ;; able to jump to the location of the entry in the diary
+ ;; file. Here we only have BBDB records. So we use
+ ;; an empty string for SPECIFIER, but instead we `propertize'
+ ;; the STRING passed to `diary-add-to-list'.
+ (propertize
+ (format
+ ;; Text substitution similar to `diary-anniversary'.
+ (replace-regexp-in-string "%n" (bbdb-record-name record) text)
+ yr (diary-ordinal-suffix yr))
+ 'diary-goto-entry (list 'bbdb-display-records (list record)))
+ ""))))))))))))
+
+;; based on `diary-goto-entry'
+(defun bbdb-anniv-goto-entry (button)
+ "Jump to the diary entry for the BUTTON at point.
+The character at point may have a text property `diary-goto-entry'
+which should be a list (FUNCTION ARG1 ARG2 ...). Then call FUNCTION
+with args ARG1, ARG2, ... to locate the entry. Otherwise follow
+the rules used by `diary-goto-entry'."
+ (let* ((fun-call (get-text-property (overlay-start button)
+ 'diary-goto-entry))
+ (locator (button-get button 'locator))
+ (marker (car locator))
+ markbuf file)
+ (cond (fun-call
+ (apply (car fun-call) (cdr fun-call)))
+ ;; If marker pointing to diary location is valid, use that.
+ ((and marker (setq markbuf (marker-buffer marker)))
+ (pop-to-buffer markbuf)
+ (goto-char (marker-position marker)))
+ ;; Marker is invalid (eg buffer has been killed).
+ ((and (setq file (cadr locator))
+ (file-exists-p file)
+ (find-file-other-window file))
+ (when (eq major-mode (default-value 'major-mode)) (diary-mode))
+ (goto-char (point-min))
+ (if (re-search-forward (format "%s.*\\(%s\\)"
+ (regexp-quote (nth 2 locator))
+ (regexp-quote (nth 3 locator)))
+ nil t)
+ (goto-char (match-beginning 1))))
+ (t
+ (message "Unable to locate this diary entry")))))
+
+;; `diary-goto-entry-function' is rather inflexible if multiple packages
+;; want to use it for its purposes: this variable can be hijacked
+;; only once. Here our function `bbdb-anniv-goto-entry' should work
+;; for other packages, too.
+(setq diary-goto-entry-function 'bbdb-anniv-goto-entry)
+
+(provide 'bbdb-anniv)
+
+;;; bbdb-anniv.el ends here
--- /dev/null
+;;; bbdb-com.el --- user-level commands of BBDB -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; This file contains most of the user-level interactive commands for BBDB.
+;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'mailabbrev)
+
+(eval-and-compile
+ (autoload 'build-mail-aliases "mailalias")
+ (autoload 'browse-url-url-at-point "browse-url"))
+
+(require 'crm)
+(defvar bbdb-crm-local-completion-map
+ (let ((map (make-sparse-keymap)))
+ (set-keymap-parent map crm-local-completion-map)
+ (define-key map " " 'self-insert-command)
+ map)
+ "Keymap used for BBDB crm completions.")
+
+(defun bbdb-get-records (prompt)
+ "If inside the *BBDB* buffer get the current records.
+In other buffers ask the user."
+ (if (string= bbdb-buffer-name (buffer-name))
+ (bbdb-do-records)
+ (bbdb-completing-read-records prompt)))
+
+;; Note about the arg RECORDS of various BBDB commands:
+;; - Usually, RECORDS is a list of records. (Interactively,
+;; this list of records is set up by `bbdb-do-records'.)
+;; - If these commands are used, e.g., in `bbdb-create-hook' or
+;; `bbdb-change-hook', they will be called with one arg, a single record.
+;; So depending on context the value of RECORDS will be a single record
+;; or a list of records, and we want to handle both cases.
+;; So we pass RECORDS to `bbdb-record-list' to handle both cases.
+(defun bbdb-record-list (records &optional full)
+ "Ensure that RECORDS is a list of records.
+If RECORDS is a single record turn it into a list.
+If FULL is non-nil, assume that RECORDS include display information."
+ (if records
+ (if full
+ (if (vectorp (car records)) (list records) records)
+ (if (vectorp records) (list records) records))))
+
+;; Note about BBDB prefix commands:
+;; `bbdb-do-all-records', `bbdb-append-display' and `bbdb-search-invert'
+;; are fake prefix commands. They need not precede the main commands.
+;; Also, `bbdb-append-display' can act on multiple commands.
+
+(defun bbdb-prefix-message ()
+ "Display a message about selected BBDB prefix commands."
+ (let ((msg (bbdb-concat " " (elt bbdb-modeline-info 1)
+ (elt bbdb-modeline-info 3)
+ (elt bbdb-modeline-info 5))))
+ (unless (string= "" msg) (message "%s" msg))))
+
+;;;###autoload
+(defun bbdb-do-all-records (&optional arg)
+ "Command prefix for operating on all records currently displayed.
+With prefix ARG a positive number, operate on all records.
+With prefix ARG a negative number, operate on current record only.
+This only works for certain commands."
+ (interactive "P")
+ (setq bbdb-do-all-records
+ (or (and (numberp arg) (< 0 arg))
+ (and (not (numberp arg)) (not bbdb-do-all-records))))
+ (aset bbdb-modeline-info 4 (if bbdb-do-all-records "all"))
+ (aset bbdb-modeline-info 5
+ (if bbdb-do-all-records
+ (substitute-command-keys
+ "\\<bbdb-mode-map>\\[bbdb-do-all-records]")))
+ (bbdb-prefix-message))
+
+;;;###autoload
+(defun bbdb-do-records (&optional full)
+ "Return list of records to operate on.
+Normally this list includes only the current record.
+It includes all currently displayed records if the command prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records] is used.
+If FULL is non-nil, the list of records includes display information."
+ (if bbdb-do-all-records
+ (progn
+ (setq bbdb-do-all-records nil)
+ (aset bbdb-modeline-info 4 nil)
+ (aset bbdb-modeline-info 5 nil)
+ (if full bbdb-records (mapcar 'car bbdb-records)))
+ (list (bbdb-current-record full))))
+
+;;;###autoload
+(defun bbdb-append-display-p ()
+ "Return variable `bbdb-append-display' and reset."
+ (let ((job (cond ((eq t bbdb-append-display))
+ ((numberp bbdb-append-display)
+ (setq bbdb-append-display (1- bbdb-append-display))
+ (if (zerop bbdb-append-display)
+ (setq bbdb-append-display nil))
+ t)
+ (bbdb-append-display
+ (setq bbdb-append-display nil)
+ t))))
+ (cond ((numberp bbdb-append-display)
+ (aset bbdb-modeline-info 0
+ (format "(add %dx)" bbdb-append-display)))
+ ((not bbdb-append-display)
+ (aset bbdb-modeline-info 0 nil)
+ (aset bbdb-modeline-info 1 nil)))
+ job))
+
+;;;###autoload
+(defun bbdb-append-display (&optional arg)
+ "Toggle appending next searched records in the *BBDB* buffer.
+With prefix ARG \\[universal-argument] always append.
+With ARG a positive number append for that many times.
+With ARG a negative number do not append."
+ (interactive "P")
+ (setq bbdb-append-display
+ (cond ((and arg (listp arg)) t)
+ ((and (numberp arg) (< 1 arg)) arg)
+ ((or (and (numberp arg) (< arg 0)) bbdb-append-display) nil)
+ (t 'once)))
+ (aset bbdb-modeline-info 0
+ (cond ((numberp bbdb-append-display)
+ (format "(add %dx)" bbdb-append-display))
+ ((eq t bbdb-append-display) "Add")
+ (bbdb-append-display "add")
+ (t nil)))
+ (aset bbdb-modeline-info 1
+ (if bbdb-append-display
+ (substitute-command-keys
+ "\\<bbdb-mode-map>\\[bbdb-append-display]")))
+ (bbdb-prefix-message))
+
+(defsubst bbdb-layout-prefix ()
+ "Set the LAYOUT arg interactively using the prefix arg."
+ (cond ((eq current-prefix-arg 0) 'one-line)
+ (current-prefix-arg 'multi-line)
+ (t bbdb-layout)))
+
+(defun bbdb-search-invert-p ()
+ "Return variable `bbdb-search-invert' and set it to nil.
+To set it again, use command `bbdb-search-invert'."
+ (let ((result bbdb-search-invert))
+ (setq bbdb-search-invert nil)
+ (aset bbdb-modeline-info 2 nil)
+ (aset bbdb-modeline-info 3 nil)
+ result))
+
+;;;###autoload
+(defun bbdb-search-invert (&optional arg)
+ "Toggle inversion of the next search command.
+With prefix ARG a positive number, invert next search.
+With prefix ARG a negative number, do not invert next search."
+ (interactive "P")
+ (setq bbdb-search-invert
+ (or (and (numberp arg) (< 0 arg))
+ (and (not (numberp arg)) (not bbdb-search-invert))))
+ (aset bbdb-modeline-info 2 (if bbdb-search-invert "inv"))
+ (aset bbdb-modeline-info 3 (if bbdb-search-invert
+ (substitute-command-keys
+ "\\<bbdb-mode-map>\\[bbdb-search-invert]")))
+ (bbdb-prefix-message))
+
+(defmacro bbdb-search (records &rest spec)
+ "Search RECORDS for fields matching SPEC.
+The following keywords are supported in SPEC to search fields in RECORDS
+matching the regexps RE:
+
+:name RE Match RE against first-last name.
+:name-fl RE Match RE against last-first name.
+:all-names RE Match RE against first-last, last-first, and aka.
+:affix RE Match RE against affixes.
+:aka RE Match RE against akas.
+:organization RE Match RE against organizations.
+:mail RE Match RE against mail addresses.
+:xfield RE Match RE against `bbdb-default-xfield'.
+ RE may also be a cons (LABEL . REGEXP).
+ Then REGEXP is matched against xfield LABEL.
+ If LABEL is '* then RE is matched against all xfields.
+:creation-date RE Match RE against creation-date.
+:timestamp RE Match RE against timestamp.
+
+Each of these keywords may appear multiple times.
+Other keywords:
+
+:bool BOOL Combine the search for multiple fields using BOOL.
+ BOOL may be either `or' (match either field)
+ or `and' (match all fields) with default `or'.
+
+To reverse the search, bind `bbdb-search-invert' to t.
+See also `bbdb-message-search' for fast searches using `bbdb-hashtable'
+but not allowing for regexps.
+
+For backward compatibility, SPEC may also consist of the optional args
+ NAME ORGANIZATION MAIL XFIELD PHONE ADDRESS
+which is equivalent to
+ :all-names NAME :organization ORGANIZATION :mail MAIL
+ :xfield XFIELD :phone PHONE :address ADDRESS
+This usage is discouraged."
+ (when (not (keywordp (car spec)))
+ ;; Old format for backward compatibility
+ (unless (get 'bbdb-search 'bbdb-outdated)
+ (put 'bbdb-search 'bbdb-outdated t)
+ (message "Outdated usage of `bbdb-search'")
+ (sit-for 2))
+ (let (newspec val)
+ (dolist (key '(:all-names :organization :mail :xfield :phone :address))
+ (if (setq val (pop spec))
+ (push (list key val) newspec)))
+ (setq spec (apply 'append newspec))))
+
+ (let* ((count 0)
+ (sym-list (mapcar (lambda (_)
+ (make-symbol
+ (format "bbdb-re-%d" (setq count (1+ count)))))
+ spec))
+ (bool (make-symbol "bool"))
+ (not-invert (make-symbol "not-invert"))
+ (matches (make-symbol "matches"))
+ keyw re-list clauses)
+ (set bool ''or) ; default
+
+ ;; Check keys.
+ (while (keywordp (setq keyw (car spec)))
+ (setq spec (cdr spec))
+ (pcase keyw
+ (`:name
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(string-match ,sym (bbdb-record-name record)) clauses)))
+
+ (`:name-lf
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(string-match ,sym (bbdb-record-name-lf record)) clauses)))
+
+ (`:all-names
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(or (string-match ,sym (bbdb-record-name record))
+ (string-match ,sym (bbdb-record-name-lf record))
+ (let ((akas (bbdb-record-field record 'aka-all))
+ aka done)
+ (while (and (setq aka (pop akas)) (not done))
+ (setq done (string-match ,sym aka)))
+ done))
+ clauses)))
+
+ (`:affix
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(let ((affixs (bbdb-record-field record 'affix-all))
+ affix done)
+ (if affix
+ (while (and (setq affix (pop affixs)) (not done))
+ (setq done (string-match ,sym affix)))
+ ;; so that "^$" matches records without affix
+ (setq done (string-match ,sym "")))
+ done)
+ clauses)))
+
+ (`:aka
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(let ((akas (bbdb-record-field record 'aka-all))
+ aka done)
+ (if aka
+ (while (and (setq aka (pop akas)) (not done))
+ (setq done (string-match ,sym aka)))
+ ;; so that "^$" matches records without aka
+ (setq done (string-match ,sym "")))
+ done)
+ clauses)))
+
+ (`:organization
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(let ((organizations (bbdb-record-organization record))
+ org done)
+ (if organizations
+ (while (and (setq org (pop organizations)) (not done))
+ (setq done (string-match ,sym org)))
+ ;; so that "^$" matches records without organizations
+ (setq done (string-match ,sym "")))
+ done)
+ clauses)))
+
+ (`:phone
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(let ((phones (bbdb-record-phone record))
+ ph done)
+ (if phones
+ (while (and (setq ph (pop phones)) (not done))
+ (setq done (string-match ,sym
+ (bbdb-phone-string ph))))
+ ;; so that "^$" matches records without phones
+ (setq done (string-match ,sym "")))
+ done)
+ clauses)))
+
+ (`:address
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(let ((addresses (bbdb-record-address record))
+ a done)
+ (if addresses
+ (while (and (setq a (pop addresses)) (not done))
+ (setq done (string-match ,sym
+ (bbdb-format-address a 2))))
+ ;; so that "^$" matches records without addresses
+ (setq done (string-match ,sym "")))
+ done)
+ clauses)))
+
+ (`:mail
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(let ((mails (bbdb-record-mail record))
+ (bbdb-case-fold-search t) ; there is no case for mails
+ m done)
+ (if mails
+ (while (and (setq m (pop mails)) (not done))
+ (setq done (string-match ,sym m)))
+ ;; so that "^$" matches records without mail
+ (setq done (string-match ,sym "")))
+ done)
+ clauses)))
+
+ (`:xfield
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(cond ((stringp ,sym)
+ ;; check xfield `bbdb-default-xfield'
+ ;; "^$" matches records without notes field
+ (string-match ,sym
+ (or (bbdb-record-xfield-string
+ record bbdb-default-xfield) "")))
+ ((eq (car ,sym) '*)
+ ;; check all xfields
+ (let ((labels bbdb-xfield-label-list) done tmp)
+ (while (and (not done) labels)
+ (setq tmp (bbdb-record-xfield-string record (car labels))
+ done (and tmp (string-match (cdr ,sym)
+ tmp))
+ labels (cdr labels)))
+ done))
+ (t ; check one field
+ (string-match (cdr ,sym)
+ (or (bbdb-record-xfield-string
+ record (car ,sym)) ""))))
+ clauses)))
+
+ (`:creation-date
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(string-match ,sym (bbdb-record-creation-date record))
+ clauses)))
+
+ (`:timestamp
+ (let ((sym (pop sym-list)))
+ (push `(,sym ,(pop spec)) re-list)
+ (push `(string-match ,sym (bbdb-record-timestamp record))
+ clauses)))
+
+ (`:bool
+ (set bool (pop spec)))
+
+ ;; Do we need other keywords?
+
+ (_ (error "Keyword `%s' undefines" keyw))))
+
+ `(let ((case-fold-search bbdb-case-fold-search)
+ (,not-invert (not (bbdb-search-invert-p)))
+ ,@re-list ,matches)
+ ;; Are there any use cases for `bbdb-search' where BOOL is only
+ ;; known at run time? A smart byte compiler will hopefully
+ ;; simplify the code below if we know BOOL already at compile time.
+ ;; Alternatively, BOOL could also be a user function that
+ ;; defines more complicated boolian expressions. Yet then we loose
+ ;; the efficiency of `and' and `or' that evaluate its arguments
+ ;; as needed. We would need instead boolian macros that the compiler
+ ;; can analyze at compile time.
+ (if (eq 'and ,(symbol-value bool))
+ (dolist (record ,records)
+ (unless (eq ,not-invert (not (and ,@clauses)))
+ (push record ,matches)))
+ (dolist (record ,records)
+ (unless (eq ,not-invert (not (or ,@clauses)))
+ (push record ,matches))))
+ (nreverse ,matches))))
+
+(defun bbdb-search-read (&optional field)
+ "Read regexp to search FIELD values of records."
+ (read-string (format "Search records%s %smatching regexp: "
+ (if field (concat " with " field) "")
+ (if bbdb-search-invert "not " ""))))
+
+;;;###autoload
+(defun bbdb (regexp &optional layout)
+ "Display all records in the BBDB matching REGEXP
+in either the name(s), organization, address, phone, mail, or xfields."
+ (interactive (list (bbdb-search-read) (bbdb-layout-prefix)))
+ (let ((records (bbdb-search (bbdb-records) :all-names regexp
+ :organization regexp :mail regexp
+ :xfield (cons '* regexp)
+ :phone regexp :address regexp :bool 'or)))
+ (if records
+ (bbdb-display-records records layout nil t)
+ (message "No records matching '%s'" regexp))))
+
+;;;###autoload
+(defun bbdb-search-name (regexp &optional layout)
+ "Display all records in the BBDB matching REGEXP in the name
+\(or ``alternate'' names\)."
+ (interactive (list (bbdb-search-read "names") (bbdb-layout-prefix)))
+ (bbdb-display-records (bbdb-search (bbdb-records) :all-names regexp) layout))
+
+;;;###autoload
+(defun bbdb-search-organization (regexp &optional layout)
+ "Display all records in the BBDB matching REGEXP in the organization field."
+ (interactive (list (bbdb-search-read "organization") (bbdb-layout-prefix)))
+ (bbdb-display-records (bbdb-search (bbdb-records) :organization regexp)
+ layout))
+
+;;;###autoload
+(defun bbdb-search-address (regexp &optional layout)
+ "Display all records in the BBDB matching REGEXP in the address fields."
+ (interactive (list (bbdb-search-read "address") (bbdb-layout-prefix)))
+ (bbdb-display-records (bbdb-search (bbdb-records) :address regexp)
+ layout))
+
+;;;###autoload
+(defun bbdb-search-mail (regexp &optional layout)
+ "Display all records in the BBDB matching REGEXP in the mail address."
+ (interactive (list (bbdb-search-read "mail address") (bbdb-layout-prefix)))
+ (bbdb-display-records (bbdb-search (bbdb-records) :mail regexp) layout))
+
+;;;###autoload
+(defun bbdb-search-phone (regexp &optional layout)
+ "Display all records in the BBDB matching REGEXP in the phones field."
+ (interactive (list (bbdb-search-read "phone") (bbdb-layout-prefix)))
+ (bbdb-display-records
+ (bbdb-search (bbdb-records) :phone regexp) layout))
+
+;;;###autoload
+(defun bbdb-search-xfields (field regexp &optional layout)
+ "Display all BBDB records for which xfield FIELD matches REGEXP."
+ (interactive
+ (let ((field (completing-read "Xfield to search (RET for all): "
+ (mapcar 'list bbdb-xfield-label-list) nil t)))
+ (list (if (string= field "") '* (intern field))
+ (bbdb-search-read (if (string= field "")
+ "any xfield"
+ field))
+ (bbdb-layout-prefix))))
+ (bbdb-display-records (bbdb-search (bbdb-records) :xfield (cons field regexp))
+ layout))
+(define-obsolete-function-alias 'bbdb-search-notes 'bbdb-search-xfields "3.0")
+
+;;;###autoload
+(defun bbdb-search-changed (&optional layout)
+ ;; FIXME: "changes" in BBDB lingo are often called "modifications"
+ ;; in Emacs lingo
+ "Display records which have been changed since BBDB was last saved."
+ (interactive (list (bbdb-layout-prefix)))
+ (if (bbdb-search-invert-p)
+ (let (unchanged-records)
+ (dolist (record (bbdb-records))
+ (unless (memq record bbdb-changed-records)
+ (push record unchanged-records)))
+ (bbdb-display-records unchanged-records layout))
+ (bbdb-display-records bbdb-changed-records layout)))
+
+(defun bbdb-search-prog (fun &optional layout)
+ "Search records using function FUN.
+FUN is called with one argument, the record, and should return
+the record to be displayed or nil otherwise."
+ (bbdb-display-records (delq nil (mapcar fun (bbdb-records))) layout))
+
+\f
+;; clean-up functions
+
+;; Sometimes one gets mail from foo@bar.baz.com, and then later gets mail
+;; from foo@baz.com. At this point, one would like to delete the bar.baz.com
+;; address, since the baz.com address is obviously superior.
+
+(defun bbdb-mail-redundant-re (mail)
+ "Return a regexp matching redundant variants of email address MAIL.
+For example, \"foo@bar.baz.com\" is redundant w.r.t. \"foo@baz.com\".
+Return nil if MAIL is not a valid plain email address.
+In particular, ignore addresses \"Joe Smith <foo@baz.com>\"."
+ (let* ((match (string-match "\\`\\([^ ]+\\)@\\(.+\\)\\'" mail))
+ (name (and match (match-string 1 mail)))
+ (host (and match (match-string 2 mail))))
+ (if (and name host)
+ (concat (regexp-quote name) "@.*\\." (regexp-quote host)))))
+
+(defun bbdb-delete-redundant-mails (records &optional query update)
+ "Delete redundant or duplicate mails from RECORDS.
+For example, \"foo@bar.baz.com\" is redundant w.r.t. \"foo@baz.com\".
+Duplicates may (but should not) occur if we feed BBDB automatically.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+If QUERY is non-nil (as in interactive calls, unless we use a prefix arg)
+query before deleting the redundant mail addresses.
+If UPDATE is non-nil (as in interactive calls) update the database.
+Otherwise, this is the caller's responsiblity.
+
+Noninteractively, this may be used as an element of `bbdb-notice-record-hook'
+or `bbdb-change-hook'. However, see also `bbdb-ignore-redundant-mails',
+which is probably more suited for your needs."
+ (interactive (list (bbdb-do-records) (not current-prefix-arg) t))
+ (bbdb-editable)
+ (dolist (record (bbdb-record-list records))
+ (let (mails redundant okay)
+ ;; We do not look at the canonicalized mail addresses of RECORD.
+ ;; An address "Joe Smith <foo@baz.com>" can only be entered manually
+ ;; into BBDB, and we assume that this is what the user wants.
+ ;; Anyway, if a mail field contains all the elements
+ ;; foo@baz.com, "Joe Smith <foo@baz.com>", "Jonathan Smith <foo@baz.com>"
+ ;; we do not know which address to keep and which ones to throw.
+ (dolist (mail (bbdb-record-mail record))
+ (if (assoc-string mail mails t) ; duplicate mail address
+ (push mail redundant)
+ (push mail mails)))
+ (let ((mail-re (delq nil (mapcar 'bbdb-mail-redundant-re mails)))
+ (case-fold-search t))
+ (if (not (cdr mail-re)) ; at most one mail-re address to consider
+ (setq okay (nreverse mails))
+ (setq mail-re (concat "\\`\\(?:" (mapconcat 'identity mail-re "\\|")
+ "\\)\\'"))
+ (dolist (mail mails)
+ (if (string-match mail-re mail) ; redundant mail address
+ (push mail redundant)
+ (push mail okay)))))
+ (let ((form (format "redundant mail%s %s"
+ (if (< 1 (length redundant)) "s" "")
+ (bbdb-concat 'mail (nreverse redundant)))))
+ (when (and redundant
+ (or (not query)
+ (y-or-n-p (format "Delete %s: " form))))
+ (unless query (message "Deleting %s" form))
+ (bbdb-record-set-field record 'mail okay)
+ (when update
+ (bbdb-change-record record)))))))
+(define-obsolete-function-alias 'bbdb-delete-duplicate-mails
+ 'bbdb-delete-redundant-mails "3.0")
+
+(defun bbdb-search-duplicates (&optional fields)
+ "Search all records that have duplicate entries for FIELDS.
+The list FIELDS may contain the symbols `name', `mail', and `aka'.
+If FIELDS is nil use all these fields. With prefix, query for FIELDS.
+The search results are displayed in the BBDB buffer."
+ (interactive (list (if current-prefix-arg
+ (list (intern (completing-read "Field: "
+ '("name" "mail" "aka")
+ nil t))))))
+ (setq fields (or fields '(name mail aka)))
+ (let (hash ret)
+ (dolist (record (bbdb-records))
+
+ (when (and (memq 'name fields)
+ (bbdb-record-name record)
+ (setq hash (bbdb-gethash (bbdb-record-name record)
+ '(fl-name lf-name aka)))
+ (> (length hash) 1))
+ (setq ret (append hash ret))
+ (message "BBDB record `%s' has duplicate name."
+ (bbdb-record-name record))
+ (sit-for 0))
+
+ (if (memq 'mail fields)
+ (dolist (mail (bbdb-record-mail-canon record))
+ (setq hash (bbdb-gethash mail '(mail)))
+ (when (> (length hash) 1)
+ (setq ret (append hash ret))
+ (message "BBDB record `%s' has duplicate mail `%s'."
+ (bbdb-record-name record) mail)
+ (sit-for 0))))
+
+ (if (memq 'aka fields)
+ (dolist (aka (bbdb-record-aka record))
+ (setq hash (bbdb-gethash aka '(fl-name lf-name aka)))
+ (when (> (length hash) 1)
+ (setq ret (append hash ret))
+ (message "BBDB record `%s' has duplicate aka `%s'"
+ (bbdb-record-name record) aka)
+ (sit-for 0)))))
+
+ (bbdb-display-records (sort (delete-dups ret)
+ 'bbdb-record-lessp))))
+
+(defun bbdb-fix-records (records)
+ "Fix broken RECORDS.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'."
+ (interactive (list (bbdb-do-records)))
+ (bbdb-editable)
+ (dolist (record (bbdb-record-list records))
+ ;; For the fields which take a list of strings (affix, organization,
+ ;; aka, and mail) `bbdb=record-set-field' calls `bbdb-list-strings'
+ ;; which removes all elements from such a list which are not non-empty
+ ;; strings. This should fix most problems with these fields.
+ (bbdb-record-set-field record 'affix (bbdb-record-affix record))
+ (bbdb-record-set-field record 'organization (bbdb-record-organization record))
+ (bbdb-record-set-field record 'aka (bbdb-record-aka record))
+ (bbdb-record-set-field record 'mail (bbdb-record-mail record))
+ (bbdb-change-record record))
+ (bbdb-sort-records))
+
+(defun bbdb-touch-records (records)
+ "Touch RECORDS by calling `bbdb-change-hook' unconditionally.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'."
+ (interactive (list (bbdb-do-records)))
+ (bbdb-editable)
+ (let ((bbdb-update-unchanged-records t))
+ (dolist (record (bbdb-record-list records))
+ (bbdb-change-record record))))
+
+;;; Time-based functions
+
+(defmacro bbdb-compare-records (cmpval label compare)
+ "Builds a lambda comparison function that takes one argument, RECORD.
+RECORD is returned if (COMPARE VALUE CMPVAL) is t, where VALUE
+is the value of field LABEL of RECORD."
+ `(lambda (record)
+ (let ((val (bbdb-record-field record ,label)))
+ (if (and val (,compare val ,cmpval))
+ record))))
+
+(defsubst bbdb-string> (a b)
+ (not (or (string= a b)
+ (string< a b))))
+
+;;;###autoload
+(defun bbdb-timestamp-older (date &optional layout)
+ "Display records with timestamp older than DATE.
+DATE must be in yyyy-mm-dd format."
+ (interactive (list (read-string "Timestamp older than: (yyyy-mm-dd) ")
+ (bbdb-layout-prefix)))
+ (bbdb-search-prog (bbdb-compare-records date 'timestamp string<) layout))
+
+;;;###autoload
+(defun bbdb-timestamp-newer (date &optional layout)
+ "Display records with timestamp newer than DATE.
+DATE must be in yyyy-mm-dd format."
+ (interactive (list (read-string "Timestamp newer than: (yyyy-mm-dd) ")
+ (bbdb-layout-prefix)))
+ (bbdb-search-prog (bbdb-compare-records date 'timestamp bbdb-string>) layout))
+
+;;;###autoload
+(defun bbdb-creation-older (date &optional layout)
+ "Display records with creation-date older than DATE.
+DATE must be in yyyy-mm-dd format."
+ (interactive (list (read-string "Creation older than: (yyyy-mm-dd) ")
+ (bbdb-layout-prefix)))
+ (bbdb-search-prog (bbdb-compare-records date 'creation-date string<) layout))
+
+;;;###autoload
+(defun bbdb-creation-newer (date &optional layout)
+ "Display records with creation-date newer than DATE.
+DATE must be in yyyy-mm-dd format."
+ (interactive (list (read-string "Creation newer than: (yyyy-mm-dd) ")
+ (bbdb-layout-prefix)))
+ (bbdb-search-prog (bbdb-compare-records date 'creation-date bbdb-string>) layout))
+
+;;;###autoload
+(defun bbdb-creation-no-change (&optional layout)
+ "Display records that have the same timestamp and creation-date."
+ (interactive (list (bbdb-layout-prefix)))
+ (bbdb-search-prog
+ ;; RECORD is bound in `bbdb-compare-records'.
+ (bbdb-compare-records (bbdb-record-timestamp record)
+ 'creation-date string=)
+ layout))
+
+;;; Parsing phone numbers
+;; XXX this needs expansion to handle international prefixes properly
+;; i.e. +353-number without discarding the +353 part. Problem being
+;; that this will necessitate yet another change in the database
+;; format for people who are using north american numbers.
+
+(defsubst bbdb-subint (string num)
+ "Used for parsing phone numbers."
+ (string-to-number (match-string num string)))
+
+(defun bbdb-parse-phone (string &optional style)
+ "Parse a phone number from STRING and return a list of integers the form
+\(area-code exchange number extension).
+This is both lenient and strict in what it will parse - whitespace may
+appear (or not) between any of the groups of digits, parentheses around the
+area code are optional, as is a dash between the exchange and number, and
+a '1' preceeding the area code; but there must be three digits in the area
+code and exchange, and four in the number (if they are present).
+All of these are unambigously parsable:
+
+ ( 415 ) 555 - 1212 x123 -> (415 555 1212 123)
+ (415)555-1212 123 -> (415 555 1212 123)
+ (1-415) 555-1212 123 -> (415 555 1212 123)
+ 1 (415)-555-1212 123 -> (415 555 1212 123)
+ 555-1212 123 -> (0 555 1212 123)
+ 555 1212 -> (0 555 1212 0)
+ 415 555 1212 -> (415 555 1212 0)
+ 1 415 555 1212 -> (415 555 1212 0)
+ 5551212 -> (0 555 1212 0)
+ 4155551212 -> (415 555 1212 0)
+ 4155551212123 -> (415 555 1212 123)
+ 5551212x123 -> (0 555 1212 123)
+ 1234 -> (0 0 0 1234)
+
+Note that \"4151212123\" is ambiguous; it could be interpreted either as
+\"(415) 121-2123\" or as \"415-1212 x123\".
+
+Return a list containing four numbers or one string."
+
+ ;; RW: Missing parts of NANP numbers are replaced by zeros.
+ ;; Is this always correct? What about an extension zero?
+ ;; Should we use nil instead of zeros?
+ (unless style (setq style bbdb-phone-style))
+ (let ((area-regexp (concat "(?[ \t]*\\+?1?[ \t]*[-\(]?[ \t]*[-\(]?[ \t]*"
+ "\\([2-9][0-9][0-9]\\)[ \t]*)?[-./ \t]*"))
+ (main-regexp (concat "\\([1-9][0-9][0-9]\\)[ \t]*[-.]?[ \t]*"
+ "\\([0-9][0-9][0-9][0-9]\\)[ \t]*"))
+ (ext-regexp "x?[ \t]*\\([0-9]+\\)[ \t]*"))
+ (cond ((not (eq style 'nanp))
+ (list (bbdb-string-trim string)))
+ ((string-match ;; (415) 555-1212 x123
+ (concat "^[ \t]*" area-regexp main-regexp ext-regexp "$") string)
+ (list (bbdb-subint string 1) (bbdb-subint string 2)
+ (bbdb-subint string 3) (bbdb-subint string 4)))
+ ;; (415) 555-1212
+ ((string-match (concat "^[ \t]*" area-regexp main-regexp "$") string)
+ (list (bbdb-subint string 1) (bbdb-subint string 2)
+ (bbdb-subint string 3) 0))
+ ;; 555-1212 x123
+ ((string-match (concat "^[ \t]*" main-regexp ext-regexp "$") string)
+ (list 0 (bbdb-subint string 1) (bbdb-subint string 2)
+ (bbdb-subint string 3)))
+ ;; 555-1212
+ ((string-match (concat "^[ \t]*" main-regexp "$") string)
+ (list 0 (bbdb-subint string 1) (bbdb-subint string 2) 0))
+ ;; x123
+ ((string-match (concat "^[ \t]*" ext-regexp "$") string)
+ (list 0 0 0 (bbdb-subint string 1)))
+ ;; We trust the user she knows what she wants
+ (t (list (bbdb-string-trim string))))))
+
+(defun bbdb-message-search (name mail)
+ "Return list of BBDB records matching NAME and/or MAIL.
+First try to find a record matching both NAME and MAIL.
+If this fails try to find a record matching MAIL.
+If this fails try to find a record matching NAME.
+NAME may match FIRST_LAST, LAST_FIRST or AKA.
+
+This function performs a fast search using `bbdb-hashtable'.
+NAME and MAIL must be strings or nil.
+See `bbdb-search' for searching records with regexps."
+ (when (or name mail)
+ (bbdb-buffer) ; make sure database is loaded and up-to-date
+ (let ((mrecords (if mail (bbdb-gethash mail '(mail))))
+ (nrecords (if name (bbdb-gethash name '(fl-name lf-name aka)))))
+ ;; (1) records matching NAME and MAIL
+ (or (and mrecords nrecords
+ (let (records)
+ (dolist (record nrecords)
+ (mapc (lambda (mr) (if (and (eq record mr)
+ (not (memq record records)))
+ (push record records)))
+ mrecords))
+ records))
+ ;; (2) records matching MAIL
+ mrecords
+ ;; (3) records matching NAME
+ nrecords))))
+
+(defun bbdb-read-record (&optional first-and-last)
+ "Read and return a new BBDB record.
+Does not insert it into the database or update the hashtables,
+but does ensure that there will not be name collisions."
+ (bbdb-editable)
+ (let ((record (bbdb-empty-record)))
+ (let (name)
+ (bbdb-error-retry
+ (setq name (bbdb-read-name first-and-last))
+ (bbdb-check-name (car name) (cdr name)))
+ (bbdb-record-set-firstname record (car name))
+ (bbdb-record-set-lastname record (cdr name)))
+
+ ;; organization
+ (bbdb-record-set-organization record (bbdb-read-organization))
+
+ ;; mail
+ (bbdb-record-set-mail
+ record (bbdb-split 'mail (bbdb-read-string "E-Mail Addresses: ")))
+ ;; address
+ (let (addresses label address)
+ (while (not (string= ""
+ (setq label
+ (bbdb-read-string
+ "Snail Mail Address Label [RET when done]: "
+ nil
+ bbdb-address-label-list))))
+ (setq address (make-vector bbdb-address-length nil))
+ (bbdb-record-edit-address address label t)
+ (push address addresses))
+ (bbdb-record-set-address record (nreverse addresses)))
+
+ ;; phones
+ (let (phones phone-list label)
+ (while (not (string= ""
+ (setq label
+ (bbdb-read-string
+ "Phone Label [RET when done]: " nil
+ bbdb-phone-label-list))))
+ (setq phone-list
+ (bbdb-error-retry
+ (bbdb-parse-phone
+ (read-string "Phone: "
+ (and (integerp bbdb-default-area-code)
+ (format "(%03d) "
+ bbdb-default-area-code))))))
+ (push (apply 'vector label phone-list) phones))
+ (bbdb-record-set-phone record (nreverse phones)))
+
+ ;; `bbdb-default-xfield'
+ (let ((xfield (bbdb-read-xfield bbdb-default-xfield)))
+ (unless (string= "" xfield)
+ (bbdb-record-set-xfields
+ record (list (cons bbdb-default-xfield xfield)))))
+
+ record))
+
+(defun bbdb-read-name (&optional first-and-last dfirst dlast)
+ "Read name for a record from minibuffer.
+FIRST-AND-LAST controls the reading mode:
+If it is 'first-last read first and last name separately.
+If it is 'last-first read last and first name separately.
+If it is 'fullname read full name at once.
+If it is t read name parts separately, obeying `bbdb-read-name-format' if possible.
+Otherwise use `bbdb-read-name-format'.
+DFIRST and DLAST are default values for the first and last name.
+Return cons with first and last name."
+ (unless (memq first-and-last '(first-last last-first fullname))
+ ;; We do not yet know how to read the name
+ (setq first-and-last
+ (if (and first-and-last
+ (not (memq bbdb-read-name-format '(first-last last-first))))
+ 'first-last
+ bbdb-read-name-format)))
+ (let ((name (cond ((eq first-and-last 'last-first)
+ (let (fn ln)
+ (setq ln (bbdb-read-string "Last Name: " dlast)
+ fn (bbdb-read-string "First Name: " dfirst))
+ (cons fn ln)))
+ ((eq first-and-last 'first-last)
+ (cons (bbdb-read-string "First Name: " dfirst)
+ (bbdb-read-string "Last Name: " dlast)))
+ (t
+ (bbdb-divide-name (bbdb-read-string
+ "Name: " (bbdb-concat 'name-first-last
+ dfirst dlast)))))))
+ (if (string= (car name) "") (setcar name nil))
+ (if (string= (cdr name) "") (setcdr name nil))
+ name))
+
+;;;###autoload
+(defun bbdb-create (record)
+ "Add a new RECORD to BBDB.
+When called interactively read all relevant info.
+Do not call this from a program; call `bbdb-create-internal' instead."
+ (interactive (list (bbdb-read-record current-prefix-arg)))
+ (bbdb-change-record record)
+ (bbdb-display-records (list record)))
+
+(defsubst bbdb-split-maybe (separator string)
+ "Split STRING into list of substrings bounded by matches for SEPARATORS.
+If STRING is a list, return STRING. Throw error if STRING is neither a string
+nor a list."
+ (cond ((stringp string)
+ (bbdb-split separator string))
+ ((listp string) string)
+ (t (error "Cannot convert %s to list" string))))
+
+;;;###autoload
+(defun bbdb-create-internal (&rest spec)
+ "Add a new record to the database and return it.
+
+The following keywords are supported in SPEC:
+:name VAL String or a cons cell (FIRST . LAST), the name of the person.
+ An error is thrown if VAL is already in use
+ and `bbdb-allow-duplicates' is nil.
+:affix VAL List of strings.
+:aka VAL List of strings.
+:organization VAL List of strings.
+:mail VAL String with comma-separated mail address
+ or a list of strings.
+ An error is thrown if a mail address in MAIL is already
+ in use and `bbdb-allow-duplicates' is nil.
+:phone VAL List of phone-number objects. A phone-number is a vector
+ [\"label\" areacode prefix suffix extension-or-nil]
+ or [\"label\" \"phone-number\"]
+:address VAL List of addresses. An address is a vector of the form
+ \[\"label\" (\"line1\" \"line2\" ... ) \"City\"
+ \"State\" \"Postcode\" \"Country\"].
+:xfields VAL Alist associating symbols with strings.
+:uuid VAL String, the uuid.
+:creation-date VAL String, the creation date.
+:check If present, throw an error if a field value is not
+ syntactically correct."
+ (bbdb-editable)
+ (let ((record (bbdb-empty-record))
+ (record-type (cdr bbdb-record-type))
+ (check (prog1 (memq :check spec)
+ (setq spec (delq :check spec))))
+ keyw)
+
+ ;; Check keys.
+ (while (keywordp (setq keyw (car spec)))
+ (setq spec (cdr spec))
+ (pcase keyw
+ (`:name
+ (let ((name (pop spec)))
+ (cond ((stringp name)
+ (setq name (bbdb-divide-name name)))
+ (check (bbdb-check-type name '(or (const nil)
+ (cons string string))
+ t)))
+ (let ((firstname (car name))
+ (lastname (cdr name)))
+ (bbdb-check-name firstname lastname) ; check for duplicates
+ (bbdb-record-set-firstname record firstname)
+ (bbdb-record-set-lastname record lastname))))
+
+ (`:affix
+ (let ((affix (bbdb-split-maybe 'affix (pop spec))))
+ (if check (bbdb-check-type affix (bbdb-record-affix record-type) t))
+ (bbdb-record-set-affix record affix)))
+
+ (`:organization
+ (let ((organization (bbdb-split-maybe 'organization (pop spec))))
+ (if check (bbdb-check-type
+ organization (bbdb-record-organization record-type) t))
+ (bbdb-record-set-organization record organization)))
+
+ (`:aka
+ (let ((aka (bbdb-split-maybe 'aka (pop spec))))
+ (if check (bbdb-check-type aka (bbdb-record-aka record-type) t))
+ (bbdb-record-set-aka record aka)))
+
+ (`:mail
+ (let ((mail (bbdb-split-maybe 'mail (pop spec))))
+ (if check (bbdb-check-type mail (bbdb-record-mail record-type) t))
+ (unless bbdb-allow-duplicates
+ (dolist (elt mail)
+ (if (bbdb-gethash elt '(mail))
+ (error "%s is already in the database" elt))))
+ (bbdb-record-set-mail record mail)))
+
+ (`:phone
+ (let ((phone (pop spec)))
+ (if check (bbdb-check-type phone (bbdb-record-phone record-type) t))
+ (bbdb-record-set-phone phone record)))
+
+ (`:address
+ (let ((address (pop spec)))
+ (if check (bbdb-check-type address (bbdb-record-address record-type) t))
+ (bbdb-record-set-address record address)))
+
+ (`:xfields
+ (let ((xfields (pop spec)))
+ (if check (bbdb-check-type xfields (bbdb-record-xfields record-type) t))
+ (bbdb-record-set-xfields record xfields)))
+
+ (`:uuid
+ (let ((uuid (pop spec)))
+ (if check (bbdb-check-type uuid (bbdb-record-uuid record-type) t))
+ (bbdb-record-set-uuid record uuid)))
+
+ (`:creation-date
+ (let ((creation-date (pop spec)))
+ (if check (bbdb-check-type
+ creation-date (bbdb-record-creation-date record-type) t))
+ (bbdb-record-set-creation-date record creation-date)))
+
+ (_ (error "Keyword `%s' undefined" keyw))))
+
+ (bbdb-change-record record)))
+
+;;;###autoload
+(defun bbdb-insert-field (record field value)
+ "For RECORD, add a new FIELD with value VALUE.
+Interactively, read FIELD and VALUE; RECORD is the current record.
+A non-nil prefix arg is passed on to `bbdb-read-field' as FLAG (see there)."
+ (interactive
+ (let* ((_ (bbdb-editable))
+ (record (or (bbdb-current-record)
+ (error "Point not on a record")))
+ (list (append bbdb-xfield-label-list
+ '(affix organization aka phone address mail)))
+ (field "")
+ (completion-ignore-case t)
+ (present (mapcar 'car (bbdb-record-xfields record))))
+ (if (bbdb-record-affix record) (push 'affix present))
+ (if (bbdb-record-organization record) (push 'organization present))
+ (if (bbdb-record-mail record) (push 'mail present))
+ (if (bbdb-record-aka record) (push 'aka present))
+ (dolist (field present)
+ (setq list (remq field list)))
+ (setq list (mapcar 'symbol-name list))
+ (while (string= field "")
+ (setq field (downcase (completing-read "Insert Field: " list))))
+ (setq field (intern field))
+ (if (memq field present)
+ (error "Field \"%s\" already exists" field))
+ (list record field (bbdb-read-field record field current-prefix-arg))))
+
+ (cond (;; affix
+ (eq field 'affix)
+ (if (bbdb-record-affix record)
+ (error "Affix field exists already"))
+ (if (stringp value)
+ (setq value (bbdb-split 'affix value)))
+ (bbdb-record-set-field record 'affix value))
+ ;; organization
+ ((eq field 'organization)
+ (if (bbdb-record-organization record)
+ (error "Organization field exists already"))
+ (if (stringp value)
+ (setq value (bbdb-split 'organization value)))
+ (bbdb-record-set-field record 'organization value))
+ ;; phone
+ ((eq field 'phone)
+ (bbdb-record-set-field record 'phone
+ (nconc (bbdb-record-phone record)
+ (list value))))
+ ;; address
+ ((eq field 'address)
+ (bbdb-record-set-field record 'address
+ (nconc (bbdb-record-address record)
+ (list value))))
+ ;; mail
+ ((eq field 'mail)
+ (if (bbdb-record-mail record)
+ (error "Mail field exists already"))
+ (if (stringp value)
+ (setq value (bbdb-split 'mail value)))
+ (bbdb-record-set-field record 'mail value))
+ ;; AKA
+ ((eq field 'aka)
+ (if (bbdb-record-aka record)
+ (error "Alternate names field exists already"))
+ (if (stringp value)
+ (setq value (bbdb-split 'aka value)))
+ (bbdb-record-set-field record 'aka value))
+ ;; xfields
+ ((assq field (bbdb-record-xfields record))
+ (error "Xfield \"%s\" already exists" field))
+ (t
+ (bbdb-record-set-xfield record field value)))
+ (unless (bbdb-change-record record)
+ (message "Record unchanged")))
+
+(defun bbdb-read-field (record field &optional flag)
+ "For RECORD read new FIELD interactively.
+- The phone number style is controlled via `bbdb-phone-style'.
+ A prefix FLAG inverts the style,
+- If a mail address lacks a domain, append `bbdb-default-domain'
+ if this variable non-nil. With prefix FLAG do not alter the mail address.
+- The value of an xfield is a string. With prefix FLAG the value may be
+ any lisp object."
+ (let* ((init-f (intern-soft (concat "bbdb-init-" (symbol-name field))))
+ (init (if (and init-f (functionp init-f))
+ (funcall init-f record))))
+ (cond (;; affix
+ (eq field 'affix) (bbdb-read-string "Affix: " init))
+ ;; organization
+ ((eq field 'organization) (bbdb-read-organization init))
+ ;; mail
+ ((eq field 'mail)
+ (let ((mail (bbdb-read-string "Mail: " init)))
+ (if (string-match "^mailto:" mail)
+ (setq mail (substring mail (match-end 0))))
+ (if (or (not bbdb-default-domain)
+ flag (string-match "[@%!]" mail))
+ mail
+ (concat mail "@" bbdb-default-domain))))
+ ;; AKA
+ ((eq field 'aka) (bbdb-read-string "Alternate Names: " init))
+ ;; Phone
+ ((eq field 'phone)
+ (let ((bbdb-phone-style
+ (if flag (if (eq bbdb-phone-style 'nanp) nil 'nanp)
+ bbdb-phone-style)))
+ (apply 'vector
+ (bbdb-read-string "Label: " nil bbdb-phone-label-list)
+ (bbdb-error-retry
+ (bbdb-parse-phone
+ (read-string "Phone: "
+ (and (integerp bbdb-default-area-code)
+ (format "(%03d) "
+ bbdb-default-area-code))))))))
+ ;; Address
+ ((eq field 'address)
+ (let ((address (make-vector bbdb-address-length nil)))
+ (bbdb-record-edit-address address nil t)
+ address))
+ ;; xfield
+ ((or (memq field bbdb-xfield-label-list)
+ ;; New xfield
+ (y-or-n-p
+ (format "\"%s\" is an unknown field name. Define it? " field))
+ (error "Aborted"))
+ (bbdb-read-xfield field init flag)))))
+
+;;;###autoload
+(defun bbdb-edit-field (record field &optional value flag)
+ "Edit the contents of FIELD of RECORD.
+If point is in the middle of a multi-line field (e.g., address),
+then the entire field is edited, not just the current line.
+For editing phone numbers or addresses, VALUE must be the phone number
+or address that gets edited. An error is thrown when attempting to edit
+a phone number or address with VALUE being nil.
+
+- The value of an xfield is a string. With prefix FLAG the value may be
+ any lisp object."
+ (interactive
+ (save-excursion
+ (bbdb-editable)
+ ;; when at the end of the line take care of it
+ (if (and (eolp) (not (bobp)) (not (bbdb-current-field)))
+ (backward-char 1))
+ (let* ((field-l (bbdb-current-field))
+ (field (car field-l))
+ (value (nth 1 field-l)))
+ (unless field (error "Point not in a field"))
+ (list (bbdb-current-record)
+ (if (memq field '(name affix organization aka mail phone address
+ uuid creation-date timestamp))
+ field ; not an xfield
+ (elt value 0)) ; xfield
+ value current-prefix-arg))))
+ (let (edit-str)
+ (cond ((memq field '(firstname lastname xfields))
+ ;; FIXME: We could also edit first and last names.
+ (error "Field `%s' not editable this way." field))
+ ((eq field 'name)
+ (bbdb-error-retry
+ (bbdb-record-set-field
+ record 'name
+ (bbdb-read-name
+ (if flag
+ ;; Here we try to obey the name-format xfield for
+ ;; editing the name field. Is this useful? Or is this
+ ;; irritating overkill and we better obey consistently
+ ;; `bbdb-read-name-format'?
+ (or (bbdb-record-xfield-intern record 'name-format)
+ flag))
+ (bbdb-record-firstname record)
+ (bbdb-record-lastname record)))))
+
+ ((eq field 'phone)
+ (unless value (error "No phone specified"))
+ (bbdb-record-edit-phone (bbdb-record-phone record) value))
+ ((eq field 'address)
+ (unless value (error "No address specified"))
+ (bbdb-record-edit-address value nil flag))
+ ((eq field 'organization)
+ (bbdb-record-set-field
+ record field
+ (bbdb-read-organization
+ (bbdb-concat field (bbdb-record-organization record)))))
+ ((setq edit-str (assq field '((affix . "Affix")
+ (mail . "Mail") (aka . "AKA"))))
+ (bbdb-record-set-field
+ record field
+ (bbdb-split field (bbdb-read-string
+ (format "%s: " (cdr edit-str))
+ (bbdb-concat field
+ (bbdb-record-field record field))))))
+ ((eq field 'uuid)
+ (bbdb-record-set-field
+ record 'uuid (bbdb-read-string "uuid (edit at your own risk): " (bbdb-record-uuid record))))
+ ((eq field 'creation-date)
+ (bbdb-record-set-creation-date
+ record (bbdb-read-string "creation-date: " (bbdb-record-creation-date record))))
+ ;; The timestamp is set automatically whenever we save a modified record.
+ ;; So any editing gets overwritten.
+ ((eq field 'timestamp)) ; do nothing
+ (t ; xfield
+ (bbdb-record-set-xfield
+ record field
+ (bbdb-read-xfield field (bbdb-record-xfield record field) flag))))
+ (cond ((eq field 'timestamp)
+ (message "timestamp not editable"))
+ ((bbdb-change-record record))
+ (t (message "Record unchanged")))))
+
+(defun bbdb-edit-foo (record field &optional nvalue)
+ "For RECORD edit some FIELD (mostly interactively).
+FIELD may take the same values as the elements of the variable `bbdb-edit-foo'.
+If FIELD is 'phone or 'address, NVALUE should be an integer in order to edit
+the NVALUEth phone or address field; otherwise insert a new phone or address
+field.
+
+Interactively, if called without a prefix, the value of FIELD is the car
+of the variable `bbdb-edit-foo'. When called with a prefix, the value
+of FIELD is the cdr of this variable. Then use minibuffer completion
+to select the field."
+ (interactive
+ (let* ((_ (bbdb-editable))
+ (record (bbdb-current-record))
+ (tmp (if current-prefix-arg (cdr bbdb-edit-foo) (car bbdb-edit-foo)))
+ (field (if (memq tmp '(current-fields all-fields))
+ ;; Do not require match so that we can define new xfields.
+ (intern (completing-read
+ "Edit field: " (mapcar 'list (if (eq tmp 'all-fields)
+ (append '(name affix organization aka mail phone address uuid creation-date)
+ bbdb-xfield-label-list)
+ (append (if (bbdb-record-affix record) '(affix))
+ (if (bbdb-record-organization record) '(organization))
+ (if (bbdb-record-aka record) '(aka))
+ (if (bbdb-record-mail record) '(mail))
+ (if (bbdb-record-phone record) '(phone))
+ (if (bbdb-record-address record) '(address))
+ (mapcar 'car (bbdb-record-xfields record))
+ '(name uuid creation-date))))))
+ tmp))
+ ;; Multiple phone and address fields may use the same label.
+ ;; So we cannot use these labels to uniquely identify
+ ;; a phone or address field. So instead we number these fields
+ ;; consecutively. But we do use the labels to annotate the numbers
+ ;; (available starting from GNU Emacs 24.1).
+ (nvalue (cond ((eq field 'phone)
+ (let* ((phones (bbdb-record-phone record))
+ (collection (cons (cons "new" "new phone #")
+ (mapcar (lambda (n)
+ (cons (format "%d" n) (bbdb-phone-label (nth n phones))))
+ (number-sequence 0 (1- (length phones))))))
+ (completion-extra-properties
+ `(:annotation-function
+ (lambda (s) (format " (%s)" (cdr (assoc s ',collection)))))))
+ (if (< 0 (length phones))
+ (completing-read "Phone field: " collection nil t)
+ "new")))
+ ((eq field 'address)
+ (let* ((addresses (bbdb-record-address record))
+ (collection (cons (cons "new" "new address")
+ (mapcar (lambda (n)
+ (cons (format "%d" n) (bbdb-address-label (nth n addresses))))
+ (number-sequence 0 (1- (length addresses))))))
+ (completion-extra-properties
+ `(:annotation-function
+ (lambda (s) (format " (%s)" (cdr (assoc s ',collection)))))))
+ (if (< 0 (length addresses))
+ (completing-read "Address field: " collection nil t)
+ "new"))))))
+ (list record field (and (stringp nvalue)
+ (if (string= "new" nvalue)
+ 'new
+ (string-to-number nvalue))))))
+
+ (if (memq field '(firstname lastname name-lf aka-all mail-aka mail-canon))
+ (error "Field `%s' illegal" field))
+ (let ((value (if (numberp nvalue)
+ (nth nvalue (cond ((eq field 'phone) (bbdb-record-phone record))
+ ((eq field 'address) (bbdb-record-address record))
+ (t (error "%s: nvalue %s meaningless" field nvalue)))))))
+ (if (and (numberp nvalue) (not value))
+ (error "%s: nvalue %s out of range" field nvalue))
+ (if (or (memq field '(name uuid creation-date))
+ (and (eq field 'affix) (bbdb-record-affix record))
+ (and (eq field 'organization) (bbdb-record-organization record))
+ (and (eq field 'mail) (bbdb-record-mail record))
+ (and (eq field 'aka) (bbdb-record-aka record))
+ (assq field (bbdb-record-xfields record))
+ value)
+ (bbdb-edit-field record field value)
+ (bbdb-insert-field record field
+ (bbdb-read-field record field)))))
+
+(defun bbdb-read-xfield (field &optional init sexp)
+ "Read xfield FIELD with optional INIT.
+This calls bbdb-read-xfield-FIELD if it exists."
+ (let ((read-fun (intern-soft (format "bbdb-read-xfield-%s" field))))
+ (cond ((fboundp read-fun)
+ (funcall read-fun init))
+ ((and (not sexp) (string-or-null-p init))
+ (bbdb-read-string (format "%s: " field) init))
+ (t (read-minibuffer (format "%s (sexp): " field)
+ (prin1-to-string init))))))
+
+(defun bbdb-read-organization (&optional init)
+ "Read organization."
+ (if (string< "24.3" (substring emacs-version 0 4))
+ (let ((crm-separator
+ (concat "[ \t\n]*"
+ (cadr (assq 'organization bbdb-separator-alist))
+ "[ \t\n]*"))
+ (crm-local-completion-map bbdb-crm-local-completion-map))
+ (completing-read-multiple "Organizations: " bbdb-organization-list
+ nil nil init))
+ (bbdb-split 'organization (bbdb-read-string "Organizations: " init))))
+
+(defun bbdb-record-edit-address (address &optional label ignore-country)
+ "Edit ADDRESS.
+If LABEL is nil, edit the label sub-field of the address as well.
+If the country field of ADDRESS is nonempty and IGNORE-COUNTRY is nil,
+use the rule from `bbdb-address-format-list' matching this country.
+Otherwise, use the default rule according to `bbdb-address-format-list'."
+ (unless label
+ (setq label (bbdb-read-string "Label: "
+ (bbdb-address-label address)
+ bbdb-address-label-list)))
+ (let ((country (or (bbdb-address-country address) ""))
+ new-addr edit)
+ (unless (or ignore-country (string= "" country))
+ (let ((list bbdb-address-format-list)
+ identifier elt)
+ (while (and (not edit) (setq elt (pop list)))
+ (setq identifier (car elt))
+ (if (or (and (listp identifier)
+ (member-ignore-case country identifier))
+ (and (functionp identifier)
+ (funcall identifier address)))
+ (setq edit (nth 1 elt))))))
+ (unless edit
+ (setq edit (nth 1 (assq t bbdb-address-format-list))))
+ (unless edit (error "No address editing function defined"))
+ (if (functionp edit)
+ (setq new-addr (funcall edit address))
+ (setq new-addr (make-vector 5 ""))
+ (dolist (elt (string-to-list edit))
+ (cond ((eq elt ?s)
+ (aset new-addr 0 (bbdb-edit-address-street
+ (bbdb-address-streets address))))
+ ((eq elt ?c)
+ (aset new-addr 1 (bbdb-read-string
+ "City: " (bbdb-address-city address)
+ bbdb-city-list)))
+ ((eq elt ?S)
+ (aset new-addr 2 (bbdb-read-string
+ "State: " (bbdb-address-state address)
+ bbdb-state-list)))
+ ((eq elt ?p)
+ (aset new-addr 3
+ (bbdb-error-retry
+ (bbdb-parse-postcode
+ (bbdb-read-string
+ "Postcode: " (bbdb-address-postcode address)
+ bbdb-postcode-list)))))
+ ((eq elt ?C)
+ (aset new-addr 4
+ (bbdb-read-string
+ "Country: " (or (bbdb-address-country address)
+ bbdb-default-country)
+ bbdb-country-list))))))
+ (bbdb-address-set-label address label)
+ (bbdb-address-set-streets address (elt new-addr 0))
+ (bbdb-address-set-city address (elt new-addr 1))
+ (bbdb-address-set-state address (elt new-addr 2))
+ (bbdb-address-set-postcode address (elt new-addr 3))
+ (if (string= "" (bbdb-concat "" (elt new-addr 0) (elt new-addr 1)
+ (elt new-addr 2) (elt new-addr 3)
+ (elt new-addr 4)))
+ ;; User did not enter anything. this causes a display bug.
+ ;; The following is a temporary fix. Ideally, we would simply discard
+ ;; the entire address, but that requires bigger hacking.
+ (bbdb-address-set-country address "Emacs")
+ (bbdb-address-set-country address (elt new-addr 4)))))
+
+(defun bbdb-edit-address-street (streets)
+ "Edit list STREETS."
+ (let ((n 0) street list)
+ (while (not (string= "" (setq street
+ (bbdb-read-string
+ (format "Street, line %d: " (1+ n))
+ (nth n streets) bbdb-street-list))))
+ (push street list)
+ (setq n (1+ n)))
+ (reverse list)))
+
+;; This function can provide some guidance for writing
+;; your own address editing function
+(defun bbdb-edit-address-default (address)
+ "Function to use for address editing.
+The sub-fields and the prompts used are:
+Street, line n: (nth n street)
+City: city
+State: state
+Postcode: postcode
+Country: country"
+ (list (bbdb-edit-address-street (bbdb-address-streets address))
+ (bbdb-read-string "City: " (bbdb-address-city address) bbdb-city-list)
+ (bbdb-read-string "State: " (bbdb-address-state address)
+ bbdb-state-list)
+ (bbdb-error-retry
+ (bbdb-parse-postcode
+ (bbdb-read-string "Postcode: " (bbdb-address-postcode address)
+ bbdb-postcode-list)))
+ (bbdb-read-string "Country: " (or (bbdb-address-country address)
+ bbdb-default-country)
+ bbdb-country-list)))
+
+(defun bbdb-record-edit-phone (phones phone)
+ "For list PHONES edit PHONE number."
+ ;; Phone numbers are special. They are vectors with either
+ ;; two or four elements. We do not know whether after editing PHONE
+ ;; we still have a number requiring the same format as PHONE.
+ ;; So we take all numbers PHONES of the record so that we can
+ ;; replace the element PHONE in PHONES.
+ (setcar (memq phone phones)
+ (apply 'vector
+ (bbdb-read-string "Label: "
+ (bbdb-phone-label phone)
+ bbdb-phone-label-list)
+ (bbdb-error-retry
+ (bbdb-parse-phone
+ (read-string "Phone: " (bbdb-phone-string phone)))))))
+
+;; (bbdb-list-transpose '(a b c d) 1 3)
+(defun bbdb-list-transpose (list i j)
+ "For LIST transpose elements I and J destructively.
+I and J start with zero. Return the modified LIST."
+ (if (eq i j)
+ list ; ignore that i, j could be invalid
+ (let (a b c)
+ ;; Travel down LIST only once
+ (if (> i j) (setq a i i j j a)); swap
+ (setq a (nthcdr i list)
+ b (nthcdr (- j i) a)
+ c (car b))
+ (unless b (error "Args %i, %i beyond length of list." i j))
+ (setcar b (car a))
+ (setcar a c)
+ list)))
+
+(defun bbdb-ident-point (&optional point)
+ "Return identifier (RECNUM FIELD NUM) for position POINT.
+If POINT is nil use current value of point.
+RECNUM is the number of the record (starting from zero).
+FIELD is the field type.
+If FIELD's value is a list, NUM is the position of the subfield within FIELD.
+If any of these terms is not defined at POINT, the respective value is nil."
+ (unless point (setq point (point)))
+ (let ((recnum (get-text-property point 'bbdb-record-number))
+ (field (get-text-property point 'bbdb-field)))
+ (cond ((not field)
+ (list recnum nil nil))
+ ((eq (car field) 'name)
+ (list recnum 'name nil))
+ ((not (nth 1 field))
+ (list recnum (car field) nil))
+ (t
+ (let* ((record (car (nth recnum bbdb-records)))
+ (fields (bbdb-record-field record (car field)))
+ (val (nth 1 field))
+ (num 0) done elt)
+ ;; For xfields we only check the label because the rest of VAL
+ ;; can be anything. (xfields are unique within a record.)
+ (if (eq 'xfields (car field))
+ (setq val (car val)
+ fields (mapcar 'car fields)))
+ (while (and (not done) (setq elt (pop fields)))
+ (if (eq val elt)
+ (setq done t)
+ (setq num (1+ num))))
+ (unless done (error "Field %s not found" val))
+ (list recnum (car field) num))))))
+
+;;;###autoload
+(defun bbdb-transpose-fields (arg)
+ "Transpose previous and current field of a BBDB record.
+With numeric prefix ARG, take previous field and move it past ARG fields.
+With region active or ARG 0, transpose field point is in and field mark is in.
+
+Both fields must be in the same record, and must be of the same basic type
+\(that is, you can use this command to change the order in which phone numbers
+or email addresses are listed, but you cannot use it to make an address appear
+before a phone number; the order of field types is fixed).
+
+If the current field is the name field, transpose first and last name,
+irrespective of the value of ARG."
+ ;; This functionality is inspired by `transpose-lines'.
+ (interactive "p")
+ (bbdb-editable)
+ (let* ((ident (bbdb-ident-point))
+ (record (and (car ident) (car (nth (car ident) bbdb-records))))
+ num1 num2)
+ (cond ((not (car ident))
+ (error "Point not in BBDB record"))
+ ((not (nth 1 ident))
+ (error "Point not in BBDB field"))
+ ((eq 'name (nth 1 ident))
+ ;; Transpose firstname and lastname
+ (bbdb-record-set-name record (bbdb-record-lastname record)
+ (bbdb-record-firstname record)))
+ ((not (integerp arg))
+ (error "Arg `%s' not an integer" arg))
+ ((not (nth 2 ident))
+ (error "Point not in a transposable field"))
+ (t
+ (if (or (use-region-p) (zerop arg))
+ (let ((ident2 (bbdb-ident-point
+ (or (mark) (error "No mark set in this buffer")))))
+ (unless (and (eq (car ident) (car ident2))
+ (eq (cadr ident) (cadr ident2))
+ (integerp (nth 2 ident2)))
+ (error "Mark (or point) not on transposable field"))
+ (setq num1 (nth 2 ident)
+ num2 (nth 2 ident2)))
+ (setq num1 (1- (nth 2 ident))
+ num2 (+ num1 arg))
+ (if (or (< (min num1 num2) 0)
+ (>= (max num1 num2) (length (bbdb-record-field
+ record (nth 1 ident)))))
+ (error "Cannot transpose fields of different types")))
+ (bbdb-record-set-field
+ record (nth 1 ident)
+ (bbdb-list-transpose (bbdb-record-field record (nth 1 ident))
+ num1 num2))))
+ (bbdb-change-record record)))
+
+;;;###autoload
+(defun bbdb-delete-field-or-record (records field &optional noprompt)
+ "For RECORDS delete FIELD.
+If FIELD is the `name' field, delete RECORDS from datanbase.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records',
+and FIELD is the field point is on.
+If prefix NOPROMPT is non-nil, do not confirm deletion."
+ ;; The value of FIELD is whatever `bbdb-current-field' returns.
+ ;; This way we can identify more accurately what really needs
+ ;; to be done.
+ (interactive
+ (list (bbdb-do-records) (bbdb-current-field) current-prefix-arg))
+ (bbdb-editable)
+ (unless field (error "Not a field"))
+ (setq records (bbdb-record-list records))
+ (let* ((type (car field))
+ (type-x (if (eq type 'xfields)
+ (car (nth 1 field))
+ type)))
+ (if (eq type 'name)
+ (bbdb-delete-records records noprompt)
+ (if (memq type '(firstname lastname))
+ (error "Cannot delete field `%s'" type))
+ (dolist (record records)
+ (when (or noprompt
+ (y-or-n-p (format "delete this `%s' field (of %s)? "
+ type-x (bbdb-record-name record))))
+ (cond ((memq type '(phone address))
+ (bbdb-record-set-field
+ record type
+ ;; We use `delete' which deletes all phone and address
+ ;; fields equal to the current one. This works for
+ ;; multiple records.
+ (delete (nth 1 field)
+ (bbdb-record-field record type))))
+ ((memq type '(affix organization mail aka))
+ (bbdb-record-set-field record type nil))
+ ((eq type 'xfields)
+ (bbdb-record-set-xfield record type-x nil))
+ (t (error "Unknown field %s" type)))
+ (bbdb-change-record record))))))
+
+;;;###autoload
+(defun bbdb-delete-records (records &optional noprompt)
+ "Delete RECORDS.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+If prefix NOPROMPT is non-nil, do not confirm deletion."
+ (interactive (list (bbdb-do-records) current-prefix-arg))
+ (bbdb-editable)
+ (let ((all-records (bbdb-with-db-buffer bbdb-records)))
+ (dolist (record (bbdb-record-list records))
+ (cond ((not (memq record all-records))
+ ;; Possibly we changed RECORD before deleting it.
+ ;; Otherwise, do nothing if RECORD is unknown to BBDB.
+ (setq bbdb-changed-records (delq record bbdb-changed-records)))
+ ((or noprompt
+ (y-or-n-p (format "Delete the BBDB record of %s? "
+ (or (bbdb-record-name record)
+ (car (bbdb-record-mail record))))))
+ (bbdb-delete-record-internal record t)
+ (setq bbdb-changed-records (delq record bbdb-changed-records)))))))
+
+;;;###autoload
+(defun bbdb-display-all-records (&optional layout)
+ "Show all records.
+If invoked in a *BBDB* buffer point stays on the currently visible record.
+Inverse of `bbdb-display-current-record'."
+ (interactive (list (bbdb-layout-prefix)))
+ (let ((current (ignore-errors (bbdb-current-record))))
+ (bbdb-display-records (bbdb-records) layout)
+ (when (setq current (assq current bbdb-records))
+ (redisplay) ; Strange display bug??
+ (goto-char (nth 2 current)))))
+ ;; (set-window-point (selected-window) (nth 2 current)))))
+
+;;;###autoload
+(defun bbdb-display-current-record (&optional layout)
+ "Narrow to current record. Inverse of `bbdb-display-all-records'."
+ (interactive (list (bbdb-layout-prefix)))
+ (bbdb-display-records (list (bbdb-current-record)) layout))
+
+(defun bbdb-change-records-layout (records layout)
+ (dolist (record records)
+ (unless (eq layout (nth 1 record))
+ (setcar (cdr record) layout)
+ (bbdb-redisplay-record (car record)))))
+
+;;;###autoload
+(defun bbdb-toggle-records-layout (records &optional arg)
+ "Toggle layout of RECORDS (elided or expanded).
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+With prefix ARG 0, RECORDS are displayed elided.
+With any other non-nil ARG, RECORDS are displayed expanded."
+ (interactive (list (bbdb-do-records t) current-prefix-arg))
+ (let* ((record (bbdb-current-record))
+ (current-layout (nth 1 (assq record bbdb-records)))
+ (layout-alist
+ ;; Try to consider only those layouts that have the `toggle'
+ ;; option set
+ (or (delq nil (mapcar (lambda (l)
+ (if (and (assq 'toggle l)
+ (cdr (assq 'toggle l)))
+ l))
+ bbdb-layout-alist))
+ bbdb-layout-alist))
+ (layout
+ (cond ((eq arg 0)
+ 'one-line)
+ ((null current-layout)
+ 'multi-line)
+ ;; layout is not the last element of layout-alist
+ ;; and we switch to the following element of layout-alist
+ ((caar (cdr (memq (assq current-layout layout-alist)
+ layout-alist))))
+ (t ; layout is the last element of layout-alist
+ ;; and we switch to the first element of layout-alist
+ (caar layout-alist)))))
+ (message "Using %S layout" layout)
+ (bbdb-change-records-layout (bbdb-record-list records t) layout)))
+
+;;;###autoload
+(defun bbdb-display-records-completely (records)
+ "Display RECORDS using layout `full-multi-line' (i.e., display all fields).
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'."
+ (interactive (list (bbdb-do-records t)))
+ (let* ((record (bbdb-current-record))
+ (current-layout (nth 1 (assq record bbdb-records)))
+ (layout (if (not (eq current-layout 'full-multi-line))
+ 'full-multi-line
+ 'multi-line)))
+ (bbdb-change-records-layout (bbdb-record-list records t) layout)))
+
+;;;###autoload
+(defun bbdb-display-records-with-layout (records layout)
+ "Display RECORDS using LAYOUT.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'."
+ (interactive
+ (list (bbdb-do-records t)
+ (intern (completing-read "Layout: "
+ (mapcar (lambda (i)
+ (list (symbol-name (car i))))
+ bbdb-layout-alist)))))
+ (bbdb-change-records-layout (bbdb-record-list records t) layout))
+
+;;;###autoload
+(defun bbdb-omit-record (n)
+ "Remove current record from the display without deleting it from BBDB.
+With prefix N, omit the next N records. If negative, omit backwards."
+ (interactive "p")
+ (let ((num (get-text-property (if (and (not (bobp)) (eobp))
+ (1- (point)) (point))
+ 'bbdb-record-number)))
+ (if (> n 0)
+ (setq n (min n (- (length bbdb-records) num)))
+ (setq n (min (- n) num))
+ (bbdb-prev-record n))
+ (dotimes (_i n)
+ (bbdb-redisplay-record (bbdb-current-record) nil t))))
+
+;;; Fixing up bogus records
+
+;;;###autoload
+(defun bbdb-merge-records (record1 record2)
+ "Merge RECORD1 into RECORD2, then delete RECORD1 and return RECORD2.
+If both records have name fields ask which one to use.
+Concatenate other fields, ignoring duplicates.
+RECORD1 need not be known to BBDB, its hash and cache are ignored.
+Update hash and cache for RECORD2.
+
+Interactively, RECORD1 is the current record; prompt for RECORD2.
+With prefix, RECORD2 defaults to the first record with the same name."
+ (interactive
+ (let* ((_ (bbdb-editable))
+ (record1 (bbdb-current-record))
+ (name (bbdb-record-name record1))
+ (record2 (and current-prefix-arg
+ ;; take the first record with the same name
+ (car (delq record1
+ (bbdb-search (bbdb-records) :all-names name))))))
+ (when record2
+ (message "Merge current record with duplicate record `%s'" name)
+ (sit-for 1))
+ (list record1
+ (or record2
+ (bbdb-completing-read-record
+ (format "merge record \"%s\" into: "
+ (or (bbdb-record-name record1)
+ (car (bbdb-record-mail record1))
+ "???"))
+ (list record1))))))
+
+ (bbdb-editable)
+ (cond ((eq record1 record2) (error "Records are equal"))
+ ((null record2) (error "No record to merge with")))
+
+ ;; Merge names
+ (let* ((new-name (bbdb-record-name record2))
+ (old-name (bbdb-record-name record1))
+ (old-aka (bbdb-record-aka record1))
+ extra-name
+ (name
+ (cond ((or (string= "" old-name)
+ (bbdb-string= old-name new-name))
+ (cons (bbdb-record-firstname record2)
+ (bbdb-record-lastname record2)))
+ ((string= "" new-name)
+ (cons (bbdb-record-firstname record1)
+ (bbdb-record-lastname record1)))
+ (t (prog1
+ (if (y-or-n-p
+ (format "Use name \"%s\" instead of \"%s\"? "
+ old-name new-name))
+ (progn
+ (setq extra-name new-name)
+ (cons (bbdb-record-firstname record1)
+ (bbdb-record-lastname record1)))
+ (setq extra-name old-name)
+ (cons (bbdb-record-firstname record2)
+ (bbdb-record-lastname record2)))
+ (unless (bbdb-eval-spec
+ (bbdb-add-job bbdb-add-aka record2 extra-name)
+ (format "Keep \"%s\" as an alternate name? "
+ extra-name))
+ (setq extra-name nil)))))))
+
+ (bbdb-record-set-name record2 (car name) (cdr name))
+
+ (if extra-name (push extra-name old-aka))
+ ;; It is better to delete RECORD1 at the end.
+ ;; So we must temporarily allow duplicates in RECORD2.
+ (let ((bbdb-allow-duplicates t))
+ (bbdb-record-set-field record2 'aka old-aka t)))
+
+ ;; Merge other stuff
+ (bbdb-record-set-field record2 'affix
+ (bbdb-record-affix record1) t)
+ (bbdb-record-set-field record2 'organization
+ (bbdb-record-organization record1) t)
+ (bbdb-record-set-field record2 'phone
+ (bbdb-record-phone record1) t)
+ (bbdb-record-set-field record2 'address
+ (bbdb-record-address record1) t)
+ (let ((bbdb-allow-duplicates t))
+ (bbdb-record-set-field record2 'mail
+ (bbdb-record-mail record1) t))
+ (bbdb-record-set-field record2 'xfields
+ (bbdb-record-xfields record1) t)
+
+ ;; `bbdb-delete-records' does nothing if RECORD1 is not known to BBDB.
+ (bbdb-delete-records (list record1) 'noprompt)
+ (bbdb-change-record record2)
+ record2)
+
+;; The following sorting functions are also intended for use
+;; in `bbdb-change-hook'. Then they will be called with one arg, the record.
+
+;;;###autoload
+(defun bbdb-sort-addresses (records &optional update)
+ "Sort the addresses in RECORDS according to the label.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+If UPDATE is non-nil (as in interactive calls) update the database.
+Otherwise, this is the caller's responsiblity (for example, when used
+in `bbdb-change-hook')."
+ (interactive (list (bbdb-do-records) t))
+ (bbdb-editable)
+ (dolist (record (bbdb-record-list records))
+ (bbdb-record-set-address
+ record (sort (bbdb-record-address record)
+ (lambda (xx yy) (string< (aref xx 0) (aref yy 0)))))
+ (if update
+ (bbdb-change-record record))))
+
+;;;###autoload
+(defun bbdb-sort-phones (records &optional update)
+ "Sort the phones in RECORDS according to the label.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+If UPDATE is non-nil (as in interactive calls) update the database.
+Otherwise, this is the caller's responsiblity (for example, when used
+in `bbdb-change-hook')."
+ (interactive (list (bbdb-do-records) t))
+ (bbdb-editable)
+ (dolist (record (bbdb-record-list records))
+ (bbdb-record-set-phone
+ record (sort (bbdb-record-phone record)
+ (lambda (xx yy) (string< (aref xx 0) (aref yy 0)))))
+ (if update
+ (bbdb-change-record record))))
+
+;;;###autoload
+(defun bbdb-sort-xfields (records &optional update)
+ "Sort the xfields in RECORDS according to `bbdb-xfields-sort-order'.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+If UPDATE is non-nil (as in interactive calls) update the database.
+Otherwise, this is the caller's responsiblity (for example, when used
+in `bbdb-change-hook')."
+ (interactive (list (bbdb-do-records) t))
+ (bbdb-editable)
+ (dolist (record (bbdb-record-list records))
+ (bbdb-record-set-xfields
+ record (sort (bbdb-record-xfields record)
+ (lambda (a b)
+ (< (or (cdr (assq (car a) bbdb-xfields-sort-order)) 100)
+ (or (cdr (assq (car b) bbdb-xfields-sort-order)) 100)))))
+ (if update
+ (bbdb-change-record record))))
+(define-obsolete-function-alias 'bbdb-sort-notes 'bbdb-sort-xfields "3.0")
+
+;;; Send-Mail interface
+
+;;;###autoload
+(defun bbdb-dwim-mail (record &optional mail)
+ ;; Do What I Mean!
+ "Return a string to use as the mail address of RECORD.
+The name in the mail address is formatted obeying `bbdb-mail-name-format'
+and `bbdb-mail-name'. However, if both the first name and last name
+are constituents of the address as in John.Doe@Some.Host,
+and `bbdb-mail-avoid-redundancy' is non-nil, then the address is used as is
+and `bbdb-mail-name-format' and `bbdb-mail-name' are ignored.
+If `bbdb-mail-avoid-redundancy' is 'mail-only the name is never included.
+MAIL may be a mail address to be used for RECORD.
+If MAIL is an integer, use the MAILth mail address of RECORD.
+If MAIL is nil use the first mail address of RECORD."
+ (unless mail
+ (let ((mails (bbdb-record-mail record)))
+ (setq mail (or (and (integerp mail) (nth mail mails))
+ (car mails)))))
+ (unless mail (error "Record has no mail addresses"))
+ (let (name fn ln)
+ (cond ((let ((address (bbdb-decompose-bbdb-address mail)))
+ ;; We need to know whether we should quote the name part of MAIL
+ ;; because of special characters.
+ (if (car address)
+ (setq mail (cadr address)
+ name (car address)
+ ln name))))
+ ((functionp bbdb-mail-name)
+ (setq name (funcall bbdb-mail-name record))
+ (if (consp name)
+ (setq fn (car name) ln (cdr name)
+ name (if (eq bbdb-mail-name-format 'first-last)
+ (bbdb-concat 'name-first-last fn ln)
+ (bbdb-concat 'name-last-first ln fn)))
+ (let ((pair (bbdb-divide-name name)))
+ (setq fn (car pair) ln (cdr pair)))))
+ ((setq name (bbdb-record-xfield record bbdb-mail-name))
+ (let ((pair (bbdb-divide-name name)))
+ (setq fn (car pair) ln (cdr pair))))
+ (t
+ (setq name (if (eq bbdb-mail-name-format 'first-last)
+ (bbdb-record-name record)
+ (bbdb-record-name-lf record))
+ fn (bbdb-record-firstname record)
+ ln (bbdb-record-lastname record))))
+ (if (or (not name) (equal "" name)
+ (eq 'mail-only bbdb-mail-avoid-redundancy)
+ (and bbdb-mail-avoid-redundancy
+ (cond ((and fn ln)
+ (let ((fnq (regexp-quote fn))
+ (lnq (regexp-quote ln)))
+ (or (string-match (concat "\\`[^!@%]*\\b" fnq
+ "\\b[^!%@]+\\b" lnq "\\b")
+ mail)
+ (string-match (concat "\\`[^!@%]*\\b" lnq
+ "\\b[^!%@]+\\b" fnq "\\b")
+ mail))))
+ ((or fn ln)
+ (string-match (concat "\\`[^!@%]*\\b"
+ (regexp-quote (or fn ln)) "\\b")
+ mail)))))
+ mail
+ ;; If the name contains backslashes or double-quotes, backslash them.
+ (setq name (replace-regexp-in-string "[\\\"]" "\\\\\\&" name))
+ ;; If the name contains control chars or RFC822 specials, it needs
+ ;; to be enclosed in quotes. This quotes a few extra characters as
+ ;; well (!,%, and $) just for common sense.
+ ;; `define-mail-alias' uses regexp "[^- !#$%&'*+/0-9=?A-Za-z^_`{|}~]".
+ (format (if (string-match "[][[:cntrl:]\177()<>@,;:.!$%[:nonascii:]]" name)
+ "\"%s\" <%s>"
+ "%s <%s>")
+ name mail))))
+
+(defun bbdb-compose-mail (&rest args)
+ "Start composing a mail message to send.
+Use `bbdb-mail-user-agent' or (if nil) use `mail-user-agent'.
+ARGS are passed to `compose-mail'."
+ (let ((mail-user-agent (or bbdb-mail-user-agent mail-user-agent)))
+ (apply 'compose-mail args)))
+
+;;;###autoload
+(defun bbdb-mail (records &optional subject n verbose)
+ "Compose a mail message to RECORDS (optional: using SUBJECT).
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+By default, the first mail addresses of RECORDS are used.
+If prefix N is a number, use Nth mail address of RECORDS (starting from 1).
+If prefix N is C-u (t noninteractively) use all mail addresses of RECORDS.
+If VERBOSE is non-nil (as in interactive calls) be verbose."
+ (interactive (list (bbdb-do-records) nil
+ (or (consp current-prefix-arg)
+ current-prefix-arg)
+ t))
+ (setq records (bbdb-record-list records))
+ (if (not records)
+ (if verbose (message "No records"))
+ (let ((to (bbdb-mail-address records n nil verbose)))
+ (unless (string= "" to)
+ (bbdb-compose-mail to subject)))))
+
+(defun bbdb-mail-address (records &optional n kill-ring-save verbose)
+ "Return mail addresses of RECORDS as a string.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+By default, the first mail addresses of RECORDS are used.
+If prefix N is a number, use Nth mail address of RECORDS (starting from 1).
+If prefix N is C-u (t noninteractively) use all mail addresses of RECORDS.
+If KILL-RING-SAVE is non-nil (as in interactive calls), copy mail addresses
+to kill ring. If VERBOSE is non-nil (as in interactive calls) be verbose."
+ (interactive (list (bbdb-do-records)
+ (or (consp current-prefix-arg)
+ current-prefix-arg)
+ t t))
+ (setq records (bbdb-record-list records))
+ (if (not records)
+ (progn (if verbose (message "No records")) "")
+ (let ((good "") bad)
+ (dolist (record records)
+ (let ((mails (bbdb-record-mail record)))
+ (cond ((not mails)
+ (push record bad))
+ ((eq n t)
+ (setq good (bbdb-concat ",\n\t"
+ good
+ (mapcar (lambda (mail)
+ (bbdb-dwim-mail record mail))
+ mails))))
+ (t
+ (setq good (bbdb-concat ",\n\t" good
+ (bbdb-dwim-mail record (or (and (numberp n)
+ (nth (1- n) mails))
+ (car mails)))))))))
+ (when (and bad verbose)
+ (message "No mail addresses for %s."
+ (mapconcat 'bbdb-record-name (nreverse bad) ", "))
+ (unless (string= "" good) (sit-for 2)))
+ (when (and kill-ring-save (not (string= good "")))
+ (kill-new good)
+ (if verbose (message "%s" good)))
+ good)))
+
+;; Is there better way to yank selected mail addresses from the BBDB
+;; buffer into a message buffer? We need some kind of a link between
+;; the BBDB buffer and the message buffer, where the mail addresses
+;; are supposed to go. Then we could browse the BBDB buffer and copy
+;; selected mail addresses from the BBDB buffer into a message buffer.
+
+(defun bbdb-mail-yank ()
+ "CC the people displayed in the *BBDB* buffer on this mail message.
+The primary mail of each of the records currently listed in the
+*BBDB* buffer will be appended to the CC: field of the current buffer."
+ (interactive)
+ (let ((addresses (with-current-buffer bbdb-buffer-name
+ (delq nil
+ (mapcar (lambda (x)
+ (if (bbdb-record-mail (car x))
+ (bbdb-dwim-mail (car x))))
+ bbdb-records))))
+ (case-fold-search t))
+ (goto-char (point-min))
+ (if (re-search-forward "^CC:[ \t]*" nil t)
+ ;; We have a CC field. Move to the end of it, inserting a comma
+ ;; if there are already addresses present.
+ (unless (eolp)
+ (end-of-line)
+ (while (looking-at "\n[ \t]")
+ (forward-char) (end-of-line))
+ (insert ",\n")
+ (indent-relative))
+ ;; Otherwise, if there is an empty To: field, move to the end of it.
+ (unless (and (re-search-forward "^To:[ \t]*" nil t)
+ (eolp))
+ ;; Otherwise, insert an empty CC: field.
+ (end-of-line)
+ (while (looking-at "\n[ \t]")
+ (forward-char) (end-of-line))
+ (insert "\nCC:")
+ (indent-relative)))
+ ;; Now insert each of the addresses on its own line.
+ (while addresses
+ (insert (car addresses))
+ (when (cdr addresses) (insert ",\n") (indent-relative))
+ (setq addresses (cdr addresses)))))
+(define-obsolete-function-alias 'bbdb-yank-addresses 'bbdb-mail-yank "3.0")
+
+;;; completion
+
+;;;###autoload
+(defun bbdb-completion-predicate (key records)
+ "For use as the third argument to `completing-read'.
+Obey `bbdb-completion-list'."
+ (cond ((null bbdb-completion-list)
+ nil)
+ ((eq t bbdb-completion-list)
+ t)
+ (t
+ (catch 'bbdb-hash-ok
+ (dolist (record records)
+ (bbdb-hash-p key record bbdb-completion-list))
+ nil))))
+
+(defun bbdb-completing-read-records (prompt &optional omit-records)
+ "Read and return list of records from the bbdb.
+Completion is done according to `bbdb-completion-list'. If the user
+just hits return, nil is returned. Otherwise, a valid response is forced."
+ (let* ((completion-ignore-case t)
+ (string (completing-read prompt bbdb-hashtable
+ 'bbdb-completion-predicate t)))
+ (unless (string= "" string)
+ (let (records)
+ (dolist (record (gethash string bbdb-hashtable))
+ (if (not (memq record omit-records))
+ (push record records)))
+ (delete-dups records)))))
+
+(defun bbdb-completing-read-record (prompt &optional omit-records)
+ "Prompt for and return a single record from the bbdb;
+completion is done according to `bbdb-completion-list'. If the user
+just hits return, nil is returned. Otherwise, a valid response is forced.
+If OMIT-RECORDS is non-nil it should be a list of records to dis-allow
+completion with."
+ (let ((records (bbdb-completing-read-records prompt omit-records)))
+ (cond ((eq (length records) 1)
+ (car records))
+ ((> (length records) 1)
+ (bbdb-display-records records 'one-line)
+ (let* ((count (length records))
+ (result (completing-read
+ (format "Which record (1-%s): " count)
+ (mapcar 'number-to-string (number-sequence 1 count))
+ nil t)))
+ (nth (1- (string-to-number result)) records))))))
+
+;;;###autoload
+(defun bbdb-completing-read-mails (prompt &optional init)
+ "Like `read-string', but allows `bbdb-complete-mail' style completion."
+ (read-from-minibuffer prompt init
+ bbdb-completing-read-mails-map))
+
+(defconst bbdb-quoted-string-syntax-table
+ (let ((st (make-syntax-table)))
+ (modify-syntax-entry ?\\ "\\" st)
+ (modify-syntax-entry ?\" "\"" st)
+ st)
+ "Syntax-table to parse matched quotes. Used by `bbdb-complete-mail'.")
+
+;;;###autoload
+(defun bbdb-complete-mail (&optional beg cycle-completion-buffer)
+ "In a mail buffer, complete the user name or mail before point.
+Completion happens up to the preceeding colon, comma, or BEG.
+Return non-nil if there is a valid completion, else return nil.
+
+Completion behaviour obeys `bbdb-completion-list' (see there).
+If what has been typed matches a unique BBDB record, insert an address
+formatted by `bbdb-dwim-mail' (see there). Also, display this record
+if `bbdb-completion-display-record' is non-nil,
+If what has been typed is a valid completion but does not match
+a unique record, display a list of completions.
+If the completion is done and `bbdb-complete-mail-allow-cycling' is t
+then cycle through the mails for the matching record. If BBDB
+would format a given address different from what we have in the mail buffer,
+the first round of cycling reformats the address accordingly, then we cycle
+through the mails for the matching record.
+With prefix CYCLE-COMPLETION-BUFFER non-nil, display a list of all mails
+available for cycling.
+
+Set the variable `bbdb-complete-mail' non-nil for enabling this feature
+as part of the MUA insinuation."
+ (interactive (list nil current-prefix-arg))
+
+ (bbdb-buffer) ; Make sure the database is initialized.
+
+ ;; Completion should begin after the preceding comma (separating
+ ;; two addresses) or colon (separating the header field name
+ ;; from the header field body). We want to ignore these characters
+ ;; if they appear inside a quoted string (RFC 5322, Sec. 3.2.4).
+ ;; Note also that a quoted string may span multiple lines
+ ;; (RFC 5322, Sec. 2.2.3).
+ ;; So to be save, we go back to the beginning of the header field body
+ ;; (past the colon, when we are certainly not inside a quoted string),
+ ;; then we parse forward, looking for commas not inside a quoted string
+ ;; and positioned before END. - This fails with an unbalanced quote.
+ ;; But an unbalanced quote is bound to fail anyway.
+ (when (and (not beg)
+ (<= (point)
+ (save-restriction ; `mail-header-end'
+ (widen)
+ (save-excursion
+ (rfc822-goto-eoh)
+ (point)))))
+ (let ((end (point))
+ start pnt state)
+ (save-excursion
+ ;; A header field name must appear at the beginning of a line,
+ ;; and it must be terminated by a colon.
+ (re-search-backward "^[^ \t\n:][^:]*:[ \t\n]+")
+ (setq beg (match-end 0)
+ start beg)
+ (goto-char beg)
+ ;; If we are inside a syntactically correct header field,
+ ;; all continuation lines in between the field name and point
+ ;; must begin with a white space character.
+ (if (re-search-forward "\n[^ \t]" end t)
+ ;; An invalid header is identified via BEG set to nil.
+ (setq beg nil)
+ ;; Parse field body up to END
+ (with-syntax-table bbdb-quoted-string-syntax-table
+ (while (setq pnt (re-search-forward ",[ \t\n]*" end t))
+ (setq state (parse-partial-sexp start pnt nil nil state)
+ start pnt)
+ (unless (nth 3 state) (setq beg pnt))))))))
+
+ ;; Do we have a meaningful way to set BEG if we are not in a message header?
+ (unless beg
+ (message "Not a valid buffer position for mail completion")
+ (sit-for 1))
+
+ (let* ((end (point))
+ (done (unless beg 'nothing))
+ (orig (and beg (buffer-substring beg end)))
+ (completion-ignore-case t)
+ (completion (and orig
+ (try-completion orig bbdb-hashtable
+ 'bbdb-completion-predicate)))
+ all-completions dwim-completions one-record)
+
+ (unless done
+ ;; We get fooled if a partial COMPLETION matches "," (for example,
+ ;; a comma in lf-name). Such a partial COMPLETION cannot be protected
+ ;; by quoting. Then the comma gets interpreted as BEG.
+ ;; So we never perform partial completion beyond the first comma.
+ ;; This works even if we have just one record matching ORIG (thus
+ ;; allowing dwim-completion) because ORIG is a substring of COMPLETION
+ ;; even after COMPLETION got truncated; and ORIG by itself must be
+ ;; sufficient to identify this record.
+ ;; Yet if multiple records match ORIG we can only offer a *Completions*
+ ;; buffer.
+ (if (and (stringp completion)
+ (string-match "," completion))
+ (setq completion (substring completion 0 (match-beginning 0))))
+
+ (setq all-completions (all-completions orig bbdb-hashtable
+ 'bbdb-completion-predicate))
+ ;; Resolve the records matching ORIG:
+ ;; Multiple completions may match the same record
+ (let ((records (delete-dups
+ (apply 'append (mapcar (lambda (compl)
+ (gethash compl bbdb-hashtable))
+ all-completions)))))
+ ;; Is there only one matching record?
+ (setq one-record (and (not (cdr records))
+ (car records))))
+
+ ;; Clean up *Completions* buffer window, if it exists
+ (let ((window (get-buffer-window "*Completions*")))
+ (if (window-live-p window)
+ (quit-window nil window)))
+
+ (cond
+ ;; Match for a single record
+ (one-record
+ (let ((completion-list (if (eq t bbdb-completion-list)
+ '(fl-name lf-name mail aka organization)
+ bbdb-completion-list))
+ (mails (bbdb-record-mail one-record))
+ mail elt)
+ (if (not mails)
+ (progn
+ (message "Matching record has no mail field")
+ (sit-for 1)
+ (setq done 'nothing))
+
+ ;; Determine the mail address of ONE-RECORD to use for ADDRESS.
+ ;; Do we have a preferential order for the following tests?
+ ;; (1) If ORIG matches name, AKA, or organization of ONE-RECORD,
+ ;; then ADDRESS will be the first mail address of ONE-RECORD.
+ (if (try-completion orig
+ (append
+ (if (memq 'fl-name completion-list)
+ (list (or (bbdb-record-name one-record) "")))
+ (if (memq 'lf-name completion-list)
+ (list (or (bbdb-record-name-lf one-record) "")))
+ (if (memq 'aka completion-list)
+ (bbdb-record-field one-record 'aka-all))
+ (if (memq 'organization completion-list)
+ (bbdb-record-organization one-record))))
+ (setq mail (car mails)))
+ ;; (2) If ORIG matches one or multiple mail addresses of ONE-RECORD,
+ ;; then we take the first one matching ORIG.
+ ;; We got here with MAIL nil only if `bbdb-completion-list'
+ ;; includes 'mail or 'primary.
+ (unless mail
+ (while (setq elt (pop mails))
+ (if (try-completion orig (list elt))
+ (setq mail elt
+ mails nil))))
+ ;; This error message indicates a bug!
+ (unless mail (error "No match for %s" orig))
+
+ (let ((dwim-mail (bbdb-dwim-mail one-record mail)))
+ (if (string= dwim-mail orig)
+ ;; We get here if `bbdb-mail-avoid-redundancy' is 'mail-only
+ ;; and `bbdb-completion-list' includes 'mail.
+ (unless (and bbdb-complete-mail-allow-cycling
+ (< 1 (length (bbdb-record-mail one-record))))
+ (setq done 'unchanged))
+ ;; Replace the text with the expansion
+ (delete-region beg end)
+ (insert dwim-mail)
+ (bbdb-complete-mail-cleanup dwim-mail beg)
+ (setq done 'unique))))))
+
+ ;; Partial completion
+ ((and (stringp completion)
+ (not (bbdb-string= orig completion)))
+ (delete-region beg end)
+ (insert completion)
+ (setq done 'partial))
+
+ ;; Partial match not allowing further partial completion
+ (completion
+ (let ((completion-list (if (eq t bbdb-completion-list)
+ '(fl-name lf-name mail aka organization)
+ bbdb-completion-list)))
+ ;; Now collect all the dwim-addresses for each completion.
+ ;; Add it if the mail is part of the completions
+ (dolist (key all-completions)
+ (dolist (record (gethash key bbdb-hashtable))
+ (let ((mails (bbdb-record-mail record))
+ accept)
+ (when mails
+ (dolist (field completion-list)
+ (cond ((eq field 'fl-name)
+ (if (bbdb-string= key (bbdb-record-name record))
+ (push (car mails) accept)))
+ ((eq field 'lf-name)
+ (if (bbdb-string= key (bbdb-cache-lf-name
+ (bbdb-record-cache record)))
+ (push (car mails) accept)))
+ ((eq field 'aka)
+ (if (member-ignore-case key (bbdb-record-field
+ record 'aka-all))
+ (push (car mails) accept)))
+ ((eq field 'organization)
+ (if (member-ignore-case key (bbdb-record-organization
+ record))
+ (push (car mails) accept)))
+ ((eq field 'primary)
+ (if (bbdb-string= key (car mails))
+ (push (car mails) accept)))
+ ((eq field 'mail)
+ (dolist (mail mails)
+ (if (bbdb-string= key mail)
+ (push mail accept))))))
+ (dolist (mail (delete-dups accept))
+ (push (bbdb-dwim-mail record mail) dwim-completions))))))
+
+ (setq dwim-completions (sort (delete-dups dwim-completions)
+ 'string-lessp))
+ (cond ((not dwim-completions)
+ (message "Matching record has no mail field")
+ (sit-for 1)
+ (setq done 'nothing))
+ ;; DWIM-COMPLETIONS may contain only one element,
+ ;; if multiple completions match the same record.
+ ;; Then we may proceed with DONE set to `unique'.
+ ((eq 1 (length dwim-completions))
+ (delete-region beg end)
+ (insert (car dwim-completions))
+ (bbdb-complete-mail-cleanup (car dwim-completions) beg)
+ (setq done 'unique))
+ (t (setq done 'choose)))))))
+
+ ;; By now, we have considered all possiblities to perform a completion.
+ ;; If nonetheless we haven't done anything so far, consider cycling.
+ ;;
+ ;; Completion and cycling are really two very separate things.
+ ;; Completion is controlled by the user variable `bbdb-completion-list'.
+ ;; Cycling assumes that ORIG already holds a valid RFC 822 mail address.
+ ;; Therefore cycling may consider different records than completion.
+ (when (and (not done) bbdb-complete-mail-allow-cycling)
+ ;; find the record we are working on.
+ (let* ((address (bbdb-extract-address-components orig))
+ (record (car (bbdb-message-search
+ (car address) (cadr address)))))
+ (if (and record
+ (setq dwim-completions
+ (mapcar (lambda (m) (bbdb-dwim-mail record m))
+ (bbdb-record-mail record))))
+ (cond ((and (= 1 (length dwim-completions))
+ (string= orig (car dwim-completions)))
+ (setq done 'unchanged))
+ (cycle-completion-buffer ; use completion buffer
+ (setq done 'cycle-choose))
+ ;; Reformatting / Clean up:
+ ;; If the canonical mail address (nth 1 address)
+ ;; matches the Nth canonical mail address of RECORD,
+ ;; but ORIG is not `equal' to (bbdb-dwim-mail record n),
+ ;; then we replace ORIG by (bbdb-dwim-mail record n).
+ ;; For example, the address "JOHN SMITH <FOO@BAR.COM>"
+ ;; gets reformatted as "John Smith <foo@bar.com>".
+ ;; We attempt this reformatting before the yet more
+ ;; aggressive proper cycling.
+ ((let* ((cmails (bbdb-record-mail-canon record))
+ (len (length cmails))
+ mail dwim-mail)
+ (while (and (not done)
+ (setq mail (pop cmails)))
+ (when (and (bbdb-string= mail (nth 1 address)) ; ignore case
+ (not (string= orig (setq dwim-mail
+ (nth (- len 1 (length cmails))
+ dwim-completions)))))
+ (delete-region beg end)
+ (insert dwim-mail)
+ (bbdb-complete-mail-cleanup dwim-mail beg)
+ (setq done 'reformat)))
+ done))
+
+ (t
+ ;; ORIG is `equal' to an element of DWIM-COMPLETIONS
+ ;; Use the next element of DWIM-COMPLETIONS.
+ (let ((dwim-mail (or (nth 1 (member orig dwim-completions))
+ (nth 0 dwim-completions))))
+ ;; replace with new mail address
+ (delete-region beg end)
+ (insert dwim-mail)
+ (bbdb-complete-mail-cleanup dwim-mail beg)
+ (setq done 'cycle)))))))
+
+ (when (member done '(choose cycle-choose))
+ ;; Pop up a completions window using DWIM-COMPLETIONS.
+ ;; `completion-in-region' does not work here as DWIM-COMPLETIONS
+ ;; is not a collection for completion in the usual sense, but it
+ ;; is really a list of replacements.
+ (let ((status (not (eq (selected-window) (minibuffer-window))))
+ (completion-base-position (list beg end))
+ ;; We first call the default value of
+ ;; `completion-list-insert-choice-function'
+ ;; before performing our own stuff.
+ (completion-list-insert-choice-function
+ `(lambda (beg end text)
+ ,(if (boundp 'completion-list-insert-choice-function)
+ `(funcall ',completion-list-insert-choice-function
+ beg end text))
+ (bbdb-complete-mail-cleanup text beg))))
+ (if status (message "Making completion list..."))
+ (with-output-to-temp-buffer "*Completions*"
+ (display-completion-list dwim-completions))
+ (if status (message "Making completion list...done"))))
+
+ ;; If DONE is `nothing' return nil so that possibly some other code
+ ;; can take over.
+ (unless (eq done 'nothing)
+ done)))
+
+;;;###autoload
+(define-obsolete-function-alias 'bbdb-complete-name 'bbdb-complete-mail "3.0")
+
+(defun bbdb-complete-mail-cleanup (mail beg)
+ "Clean up after inserting MAIL at position BEG.
+If we are past `fill-column', wrap at the previous comma."
+ (if (and (not (auto-fill-function))
+ (>= (current-column) fill-column))
+ (save-excursion
+ (goto-char beg)
+ (when (search-backward "," (line-beginning-position) t)
+ (forward-char 1)
+ (insert "\n")
+ (indent-relative)
+ (if (looking-at "[ \t\n]+")
+ (delete-region (point) (match-end 0))))))
+ (if (or bbdb-completion-display-record bbdb-complete-mail-hook)
+ (let* ((address (bbdb-extract-address-components mail))
+ (records (bbdb-message-search (car address) (nth 1 address))))
+ ;; Update the *BBDB* buffer if desired.
+ (if bbdb-completion-display-record
+ (let ((bbdb-silent-internal t))
+ ;; FIXME: This pops up *BBDB* before removing *Completions*
+ (bbdb-display-records records nil t)))
+ ;; `bbdb-complete-mail-hook' may access MAIL, ADDRESS, and RECORDS.
+ (run-hooks 'bbdb-complete-mail-hook))))
+
+;;; interface to mail-abbrevs.el.
+
+;;;###autoload
+(defun bbdb-mail-aliases (&optional force-rebuilt noisy)
+ "Define mail aliases for the records in the database.
+Define a mail alias for every record that has a `mail-alias' field
+which is the contents of that field.
+If there are multiple comma-separated words in the `mail-alias' field,
+then all of those words will be defined as aliases for that person.
+
+If multiple records in the database have the same mail alias,
+then that alias expands to a comma-separated list of the mail addresses
+of all of these people.
+Add this command to `mail-setup-hook'.
+
+Mail aliases are (re)built only if `bbdb-mail-aliases-need-rebuilt' is non-nil
+because the database was newly loaded or it has been edited.
+Rebuilding the aliases is enforced if prefix FORCE-REBUILT is t."
+ (interactive (list current-prefix-arg t))
+ ;; Build `mail-aliases' if not yet done.
+ ;; Note: `mail-abbrevs-setup' rebuilds the mail-aliases only if
+ ;; `mail-personal-alias-file' has changed. So it would not do anything
+ ;; if we want to rebuild the mail-aliases because of changes in BBDB.
+ (if (or force-rebuilt (eq t mail-aliases)) (build-mail-aliases))
+
+ ;; We should be cleverer here and instead of rebuilding all aliases
+ ;; we should just do what's necessary, i.e. remove deleted records
+ ;; and add new records
+ ;; Calling `bbdb-records' can change `bbdb-mail-aliases-need-rebuilt'
+ (let ((records (bbdb-search (bbdb-records) :xfield (cons bbdb-mail-alias-field ".")))
+ results match)
+ (if (not (or force-rebuilt bbdb-mail-aliases-need-rebuilt))
+ (if noisy (message "BBDB mail alias: nothing to do"))
+ (setq bbdb-mail-aliases-need-rebuilt nil)
+
+ ;; collect an alist of (alias rec1 [rec2 ...])
+ (dolist (record records)
+ (if (bbdb-record-mail record)
+ (dolist (alias (bbdb-record-xfield-split record bbdb-mail-alias-field))
+ (if (setq match (assoc alias results))
+ ;; If an alias appears more than once, we collect all records
+ ;; that refer to it.
+ (nconc match (list record))
+ (push (list alias record) results)))
+ (unless bbdb-silent
+ (bbdb-warn "record %S has no mail address, but the aliases: %s"
+ (bbdb-record-name record)
+ (bbdb-record-xfield record bbdb-mail-alias-field))
+ (sit-for 1))))
+
+ ;; Iterate over the results and create the aliases
+ (dolist (result results)
+ (let* ((aliasstem (car result))
+ (expansions
+ (if (cddr result)
+ ;; for group aliases we just take all the primary mails
+ ;; and define only one expansion!
+ (list (mapconcat (lambda (record) (bbdb-dwim-mail record))
+ (cdr result) mail-alias-separator-string))
+ ;; this is an alias for a single person so deal with it
+ ;; according to `bbdb-mail-alias'
+ (let* ((record (nth 1 result))
+ (mails (bbdb-record-mail record)))
+ (if (or (eq 'first bbdb-mail-alias)
+ (not (cdr mails)))
+ ;; Either we want to define only one alias for
+ ;; the first mail address or there is anyway
+ ;; only one address. In either case, we take
+ ;; take only the first address.
+ (list (bbdb-dwim-mail record (car mails)))
+ ;; We need to deal with more than one mail address...
+ (let* ((all (mapcar (lambda (m) (bbdb-dwim-mail record m))
+ mails))
+ (star (bbdb-concat mail-alias-separator-string all)))
+ (if (eq 'star bbdb-mail-alias)
+ (list star (car all))
+ ;; if `bbdb-mail-alias' is 'all, we create
+ ;; two aliases for the primary mail address
+ (cons star (cons (car all) all))))))))
+ (count -1) ; n=-1: <alias>*; n=0: <alias>; n>0: <alias>n
+ (len (length expansions))
+ alias f-alias)
+
+ ;; create the aliases for each expansion
+ (dolist (expansion expansions)
+ (cond ((or (= 1 len)
+ (= count 0))
+ (setq alias aliasstem))
+ ((= count -1) ;; all the mails of a record
+ (setq alias (concat aliasstem "*")))
+ (t ;; <alias>n for each mail of a record
+ (setq alias (format "%s%s" aliasstem count))))
+ (setq count (1+ count))
+
+ (bbdb-pushnew (cons alias expansion) mail-aliases)
+
+ (define-mail-abbrev alias expansion)
+ (unless (setq f-alias (intern-soft (downcase alias) mail-abbrevs))
+ (error "Cannot find the alias"))
+
+ ;; `define-mail-abbrev' initializes f-alias to be
+ ;; `mail-abbrev-expand-hook'. We replace this by
+ ;; `bbdb-mail-abbrev-expand-hook'
+ (unless (eq (symbol-function f-alias) 'mail-abbrev-expand-hook)
+ (error "mail-aliases contains unexpected hook %s"
+ (symbol-function f-alias)))
+ ;; `bbdb-mail-abbrev-hook' is called with mail addresses instead of
+ ;; bbdb records to avoid keeping pointers to records, which would
+ ;; lose if the database was reverted.
+ ;; `bbdb-mail-abbrev-hook' uses `bbdb-message-search' to convert
+ ;; these mail addresses to records, which is plenty fast.
+ ;; FIXME: The value of arg MAILS for `bbdb-mail-abbrev-hook'
+ ;; is wrong. Currently it is based on the list of records that have
+ ;; referenced ALIASTEM and we simply take the first mail address
+ ;; from each of these records.
+ ;; Then `bbdb-message-search' will find the correct records
+ ;; (assuming that each mail address appears only once in the
+ ;; database). Nonethless, arg MAILS for `bbdb-mail-abbrev-hook'
+ ;; does not, in general, contain the actual mail addresses
+ ;; of EXPANSION. So what we would need is to go back from
+ ;; EXPANSION to the mail addresses it contains (which is tricky
+ ;; because mail addresses in the database can be shortcuts for
+ ;; the addresses in EXPANSION).
+ (fset f-alias `(lambda ()
+ (bbdb-mail-abbrev-expand-hook
+ ,alias
+ ',(mapcar (lambda (r) (car (bbdb-record-mail r)))
+ (cdr result))))))))
+
+ (if noisy (message "BBDB mail alias: rebuilding done")))))
+
+(defun bbdb-mail-abbrev-expand-hook (alias mails)
+ (run-hook-with-args 'bbdb-mail-abbrev-expand-hook alias mails)
+ (mail-abbrev-expand-hook)
+ (when bbdb-completion-display-record
+ (let ((bbdb-silent-internal t))
+ (bbdb-display-records
+ (apply 'append
+ (mapcar (lambda (mail) (bbdb-message-search nil mail)) mails))
+ nil t))))
+
+(defun bbdb-get-mail-aliases ()
+ "Return a list of mail aliases used in the BBDB."
+ (let ((records (bbdb-search (bbdb-records) :xfield (cons bbdb-mail-alias-field ".")))
+ result)
+ (dolist (record records)
+ (dolist (alias (bbdb-record-xfield-split record bbdb-mail-alias-field))
+ (bbdb-pushnew alias result)))
+ result))
+
+;;;###autoload
+(defsubst bbdb-mail-alias-list (alias)
+ (if (stringp alias)
+ (bbdb-split bbdb-mail-alias-field alias)
+ alias))
+
+(defun bbdb-add-mail-alias (records &optional alias delete)
+ "Add ALIAS to RECORDS.
+If prefix DELETE is non-nil, remove ALIAS from RECORDS.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+Arg ALIAS is ignored if list RECORDS contains more than one record.
+Instead read ALIAS interactively for each record in RECORDS.
+If the function `bbdb-init-mail-alias' is defined, it is called with
+one arg RECORD to define the default value for ALIAS of RECORD."
+ (interactive (list (bbdb-do-records) nil current-prefix-arg))
+ (bbdb-editable)
+ (setq records (bbdb-record-list records))
+ (if (< 1 (length records)) (setq alias nil))
+ (let* ((tmp (intern-soft
+ (concat "bbdb-init-" (symbol-name bbdb-mail-alias-field))))
+ (init-f (if (functionp tmp) tmp)))
+ (dolist (record records)
+ (let ((r-a-list (bbdb-record-xfield-split record bbdb-mail-alias-field))
+ (alias alias)
+ a-list)
+ (if alias
+ (setq a-list (bbdb-mail-alias-list alias))
+ (when init-f
+ (setq a-list (bbdb-mail-alias-list (funcall init-f record))
+ alias (if a-list (bbdb-concat bbdb-mail-alias-field a-list))))
+ (let ((crm-separator
+ (concat "[ \t\n]*"
+ (cadr (assq bbdb-mail-alias-field bbdb-separator-alist))
+ "[ \t\n]*"))
+ (crm-local-completion-map bbdb-crm-local-completion-map)
+ (prompt (format "%s mail alias:%s " (if delete "Remove" "Add")
+ (if alias (format " (default %s)" alias) "")))
+ (collection (if delete
+ (or r-a-list (error "Record has no alias"))
+ (bbdb-get-mail-aliases))))
+ (setq a-list (if (string< "24.3" (substring emacs-version 0 4))
+ (completing-read-multiple prompt collection nil
+ delete nil nil alias)
+ (bbdb-split bbdb-mail-alias-field
+ (completing-read prompt collection nil
+ delete nil nil alias))))))
+ (dolist (a a-list)
+ (if delete
+ (setq r-a-list (delete a r-a-list))
+ ;; Add alias only if it is not there yet
+ (bbdb-pushnew a r-a-list)))
+ ;; This also handles `bbdb-mail-aliases-need-rebuilt'
+ (bbdb-record-set-xfield record bbdb-mail-alias-field
+ (bbdb-concat bbdb-mail-alias-field r-a-list))
+ (bbdb-change-record record)))))
+\f
+;;; Dialing numbers from BBDB
+
+(defun bbdb-dial-number (phone-string)
+ "Dial the number specified by PHONE-STRING.
+This uses the tel URI syntax passed to `browse-url' to make the call.
+If `bbdb-dial-function' is non-nil then that is called to make the phone call."
+ (interactive "sDial number: ")
+ (if bbdb-dial-function
+ (funcall bbdb-dial-function phone-string)
+ (browse-url (concat "tel:" phone-string))))
+
+;;;###autoload
+(defun bbdb-dial (phone force-area-code)
+ "Dial the number at point.
+If the point is at the beginning of a record, dial the first phone number.
+Use rules from `bbdb-dial-local-prefix-alist' unless prefix FORCE-AREA-CODE
+is non-nil. Do not dial the extension."
+ (interactive (list (bbdb-current-field) current-prefix-arg))
+ (if (eq (car-safe phone) 'name)
+ (setq phone (car (bbdb-record-phone (bbdb-current-record)))))
+ (if (eq (car-safe phone) 'phone)
+ (setq phone (car (cdr phone))))
+ (or (vectorp phone) (error "Not on a phone field"))
+
+ (let ((number (bbdb-phone-string phone))
+ shortnumber)
+
+ ;; cut off the extension
+ (if (string-match "x[0-9]+$" number)
+ (setq number (substring number 0 (match-beginning 0))))
+
+ (unless force-area-code
+ (let ((alist bbdb-dial-local-prefix-alist) prefix)
+ (while (setq prefix (pop alist))
+ (if (string-match (concat "^" (eval (car prefix))) number)
+ (setq shortnumber (concat (cdr prefix)
+ (substring number (match-end 0)))
+ alist nil)))))
+
+ (if shortnumber
+ (setq number shortnumber)
+
+ ;; This is terrifically Americanized...
+ ;; Leading 0 => local number (?)
+ (if (and bbdb-dial-local-prefix
+ (string-match "^0" number))
+ (setq number (concat bbdb-dial-local-prefix number)))
+
+ ;; Leading + => long distance/international number
+ (if (and bbdb-dial-long-distance-prefix
+ (string-match "^\+" number))
+ (setq number (concat bbdb-dial-long-distance-prefix " "
+ (substring number 1)))))
+
+ (unless bbdb-silent
+ (message "Dialing %s" number))
+ (bbdb-dial-number number)))
+
+;;; url interface
+
+;;;###autoload
+(defun bbdb-browse-url (records &optional which)
+ "Brwose URLs stored in the `url' field of RECORDS.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+Prefix WHICH specifies which URL in field `url' is used (starting from 0).
+Default is the first URL."
+ (interactive (list (bbdb-get-records "Visit (URL): ")
+ (and current-prefix-arg
+ (prefix-numeric-value current-prefix-arg))))
+ (unless which (setq which 0))
+ (dolist (record (bbdb-record-list records))
+ (let ((url (bbdb-record-xfield-split record 'url)))
+ (when url
+ (setq url (read-string "fetch: " (nth which url)))
+ (unless (string= "" url)
+ (browse-url url))))))
+
+;;;###autoload
+(defun bbdb-grab-url (record url)
+ "Grab URL and store it in RECORD."
+ (interactive (let ((url (browse-url-url-at-point)))
+ (unless url (error "No URL at point"))
+ (list (bbdb-completing-read-record
+ (format "Add `%s' for: " url))
+ url)))
+ (bbdb-record-set-field record 'url url t)
+ (bbdb-change-record record)
+ (bbdb-display-records (list record)))
+
+;;; Copy to kill ring
+
+;;;###autoload
+(defun bbdb-copy-records-as-kill (records)
+ "Copy RECORDS to kill ring.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'."
+ (interactive (list (bbdb-do-records t)))
+ (let (drec)
+ (dolist (record (bbdb-record-list records t))
+ (push (buffer-substring (nth 2 record)
+ (or (nth 2 (car (cdr (memq record bbdb-records))))
+ (point-max)))
+ drec))
+ (kill-new (replace-regexp-in-string
+ "[ \t\n]*\\'" "\n"
+ (mapconcat 'identity (nreverse drec) "")))))
+
+;;;###autoload
+(defun bbdb-copy-fields-as-kill (records field &optional num)
+ "For RECORDS copy values of FIELD at point to kill ring.
+If FIELD is an address or phone with a label, copy only field values
+with the same label. With numeric prefix NUM, if the value of FIELD
+is a list, copy only the NUMth list element.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'."
+ (interactive
+ (list (bbdb-do-records t) (bbdb-current-field)
+ (and current-prefix-arg
+ (prefix-numeric-value current-prefix-arg))))
+ (unless field (error "Not a field"))
+ (let* ((type (if (eq (car field) 'xfields)
+ (car (nth 1 field))
+ (car field)))
+ (label (if (memq type '(phone address))
+ (aref (cadr field) 0)))
+ (ident (and (< 1 (length records))
+ (not (eq type 'name))))
+ val-list)
+ (dolist (record (bbdb-record-list records))
+ (let ((raw-val (bbdb-record-field (car record) type))
+ value)
+ (if raw-val
+ (cond ((eq type 'phone)
+ (dolist (elt raw-val)
+ (if (equal label (aref elt 0))
+ (push (bbdb-phone-string elt) value)))
+ (setq value (bbdb-concat 'phone (nreverse value))))
+ ((eq type 'address)
+ (dolist (elt raw-val)
+ (if (equal label (aref elt 0))
+ (push (bbdb-format-address
+ elt (if (eq (nth 1 record) 'one-line) 3 2))
+ value)))
+ (setq value (bbdb-concat 'address (nreverse value))))
+ ((consp raw-val)
+ (setq value (if num (nth num raw-val)
+ (bbdb-concat type raw-val))))
+ (t (setq value raw-val))))
+ (if value
+ (push (if ident
+ (bbdb-concat 'name-field
+ (bbdb-record-name (car record)) value)
+ value) val-list))))
+ (let ((str (bbdb-concat 'record (nreverse val-list))))
+ (kill-new str)
+ (message "%s" str))))
+
+;;; Help and documentation
+
+;;;###autoload
+(defun bbdb-info ()
+ (interactive)
+ (info (format "(%s)Top" (or bbdb-info-file "bbdb"))))
+
+;;;###autoload
+(defun bbdb-help ()
+ (interactive)
+ (message (substitute-command-keys "\\<bbdb-mode-map>\
+new field: \\[bbdb-insert-field]; \
+edit field: \\[bbdb-edit-field]; \
+delete field: \\[bbdb-delete-field-or-record]; \
+mode help: \\[describe-mode]; \
+info: \\[bbdb-info]")))
+
+(provide 'bbdb-com)
+
+;;; bbdb-com.el ends here
--- /dev/null
+;;; bbdb-gnus.el --- BBDB interface to Gnus -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;; This file contains the BBDB interface to Gnus.
+;;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+(require 'bbdb-mua)
+(require 'gnus)
+
+;;; Insinuation
+
+;;;###autoload
+(defun bbdb-insinuate-gnus ()
+ "Hook BBDB into Gnus.
+Do not call this in your init file. Use `bbdb-initialize'."
+ ;; `bbdb-mua-display-sender' fails in *Article* buffers, where
+ ;; `gnus-article-read-summary-keys' provides an additional wrapper
+ ;; that restores the window configuration.
+ (define-key gnus-summary-mode-map ":" 'bbdb-mua-display-sender)
+ (define-key gnus-article-mode-map ":" 'bbdb-mua-display-sender)
+ ;; For `bbdb-mua-edit-field-sender' it is probably OK if
+ ;;`gnus-article-read-summary-keys' restores the window configuration.
+ (define-key gnus-summary-mode-map ";" 'bbdb-mua-edit-field-sender)
+ (define-key gnus-article-mode-map ";" 'bbdb-mua-edit-field-sender)
+ ;; Do we need keybindings for more commands? Suggestions welcome.
+ ;; (define-key gnus-summary-mode-map ":" 'bbdb-mua-display-records)
+ ;; (define-key gnus-summary-mode-map "'" 'bbdb-mua-display-recipients)
+ ;; (define-key gnus-summary-mode-map ";" 'bbdb-mua-edit-field-recipients)
+
+ ;; Set up user field for use in `gnus-summary-line-format'
+ ;; (1) Big solution: use whole name
+ (if bbdb-mua-summary-unify-format-letter
+ (fset (intern (concat "gnus-user-format-function-"
+ bbdb-mua-summary-unify-format-letter))
+ (lambda (header)
+ (bbdb-mua-summary-unify (mail-header-from header)))))
+
+ ;; (2) Small solution: a mark for messages whos sender is in BBDB.
+ (if bbdb-mua-summary-mark-format-letter
+ (fset (intern (concat "gnus-user-format-function-"
+ bbdb-mua-summary-mark-format-letter))
+ (lambda (header)
+ (bbdb-mua-summary-mark (mail-header-from header))))))
+
+(provide 'bbdb-gnus)
+
+;;; bbdb-gnus.el ends here
--- /dev/null
+;;; bbdb-ispell.el --- export names from BBDB to personal ispell dictionaries -*- lexical-binding: t -*-
+
+;; Copyright (C) 2011-2017 Free Software Foundation, Inc.
+
+;; Author: Ivan Kanis <ivan.kanis@googlemail.com>
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;
+;; Names are often not recognized by the standard ispell dictionaries.
+;; `bbdb-ispell-export' exports the names from your BBDB records to your
+;; personal ispell dictionaries.
+;; The personal dictionaries are in `bbdb-ispell-dictionary-list'
+;; The BBDB fields for this are in `bbdb-ispell-field-list'.
+;; Exclude words via `bbdb-ispell-min-word-length' and `bbdb-ispell-ignore-re'.
+;;
+;; Bugs:
+;; Save your personal directories before running this code. I had my
+;; dictionary truncated while debugging. It shouldn't happen
+;; but better be safe than sorry...
+;;
+;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'ispell)
+(require 'bbdb)
+
+(defcustom bbdb-ispell-dictionary-list '("default")
+ "List of ispell personal dictionaries.
+Allowed elements are as in the return value of `ispell-valid-dictionary-list'."
+ :group 'bbdb-utilities-ispell
+ :type (cons 'set (mapcar (lambda (dict) `(string ,dict))
+ (ispell-valid-dictionary-list))))
+
+(defcustom bbdb-ispell-field-list '(name organization aka)
+ "List of fields of each BBDB record considered for the personal dictionary."
+ :group 'bbdb-utilities-ispell
+ :type (list 'repeat
+ (append '(choice) (mapcar (lambda (field) `(const ,field))
+ '(name organization affix aka address))
+ '((symbol :tag "xfield")))))
+
+(defcustom bbdb-ispell-min-word-length 3
+ "Words with fewer characters are ignored."
+ :group 'bbdb-utilities-ispell
+ :type 'number)
+
+(defcustom bbdb-ispell-ignore-re "[^[:alpha:]]"
+ "Words matching this regexp are ignored."
+ :group 'bbdb-utilities-ispell
+ :type 'regexp)
+
+;; Internal variable
+(defvar bbdb-ispell-word-list nil
+ "List of words extracted from the BBDB records.")
+
+;;;###autoload
+(defun bbdb-ispell-export ()
+ "Export BBDB records to ispell personal dictionaries."
+ (interactive)
+ (message "Exporting to personal dictionary...")
+ (let (bbdb-ispell-word-list)
+ ;; Collect words from BBDB records.
+ (dolist (record (bbdb-records))
+ (dolist (field bbdb-ispell-field-list)
+ (bbdb-ispell-collect-words (bbdb-record-field record field))))
+
+ ;; Update personal dictionaries
+ (dolist (dict (or bbdb-ispell-dictionary-list '("default")))
+ (ispell-change-dictionary dict)
+ ;; Initialize variables and dicts alists
+ (ispell-set-spellchecker-params)
+ (ispell-init-process)
+ ;; put in verbose mode
+ (ispell-send-string "%\n")
+ (let (new)
+ (dolist (word (delete-dups bbdb-ispell-word-list))
+ (ispell-send-string (concat "^" word "\n"))
+ (while (progn
+ (ispell-accept-output)
+ (not (string= "" (car ispell-filter)))))
+ ;; remove extra \n
+ (setq ispell-filter (cdr ispell-filter))
+ (when (and ispell-filter
+ (listp ispell-filter)
+ (not (eq (ispell-parse-output (car ispell-filter)) t)))
+ ;; ok the word doesn't exist, add it
+ (ispell-send-string (concat "*" word "\n"))
+ (setq new t)))
+ (when new
+ ;; Save dictionary:
+ ;; aspell doesn't tell us when it completed the saving.
+ ;; So we send it another word for spellchecking.
+ (ispell-send-string "#\n^hello\n")
+ (while (progn
+ (ispell-accept-output)
+ (not (string= "" (car ispell-filter)))))))))
+ (message "Exporting to personal dictionary...done"))
+
+(defun bbdb-ispell-collect-words (field)
+ "Parse BBDB FIELD and collect words in `bbdb-ispell-word-list'."
+ ;; Ignore everything in FIELD that is not a string or a sequence.
+ (cond ((stringp field)
+ (dolist (word (split-string field))
+ (if (and (>= (length word) bbdb-ispell-min-word-length)
+ (not (string-match bbdb-ispell-ignore-re word)))
+ (push word bbdb-ispell-word-list))))
+ ((sequencep field) (mapc 'bbdb-ispell-collect-words field))))
+
+(provide 'bbdb-ispell)
+
+;;; bbdb-ispell.el ends here
--- /dev/null
+;;; bbdb-message.el --- BBDB interface to Mail Composition Packages. -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;; This file contains the BBDB interface to Mail Composition Packages.
+;;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'message)
+(require 'sendmail)
+
+;;;###autoload
+(defun bbdb-insinuate-message ()
+ "Hook BBDB into Message Mode.
+Do not call this in your init file. Use `bbdb-initialize'."
+ ;; Suggestions welcome: What are good keybindings for the following
+ ;; commands that do not collide with existing bindings?
+ ;; (define-key message-mode-map "'" 'bbdb-mua-display-recipients)
+ ;; (define-key message-mode-map ";" 'bbdb-mua-edit-field-recipients)
+ ;; (define-key message-mode-map "/" 'bbdb)
+ (if bbdb-complete-mail
+ (define-key message-mode-map "\M-\t" 'bbdb-complete-mail)))
+
+;;;###autoload
+(defun bbdb-insinuate-mail ()
+ "Hook BBDB into Mail Mode.
+Do not call this in your init file. Use `bbdb-initialize'."
+ ;; Suggestions welcome: What are good keybindings for the following
+ ;; commands that do not collide with existing bindings?
+ ;; (define-key mail-mode-map "'" 'bbdb-mua-display-recipients)
+ ;; (define-key mail-mode-map ";" 'bbdb-mua-edit-field-recipients)
+ ;; (define-key mail-mode-map "/" 'bbdb)
+ (if bbdb-complete-mail
+ (define-key mail-mode-map "\M-\t" 'bbdb-complete-mail)))
+
+(provide 'bbdb-message)
+
+;;; bbdb-message.el ends here
--- /dev/null
+;;; bbdb-mhe.el --- BBDB interface to mh-e -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;; This file contains the BBDB interface to mh-e.
+;;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+(require 'bbdb-mua)
+(require 'mh-e)
+(if (fboundp 'mh-version)
+ (require 'mh-comp)) ; For mh-e 4.x
+(require 'advice)
+
+;; A simplified `mail-fetch-field'. We could use instead (like rmail):
+;; (mail-header (intern-soft (downcase header)) (mail-header-extract))
+;;;###autoload
+(defun bbdb/mh-header (header)
+ "Find and return the value of HEADER in the current buffer.
+Returns the empty string if HEADER is not in the message."
+ (let ((case-fold-search t))
+ (goto-char (point-min))
+ ;; This will be fooled if HEADER appears in the body of the message.
+ ;; Also, it fails if HEADER appears more than once.
+ (cond ((not (re-search-forward header nil t)) "")
+ ((looking-at "[\t ]*$") "")
+ (t (re-search-forward "[ \t]*\\([^ \t\n].*\\)$" nil t)
+ (let ((start (match-beginning 1)))
+ (while (progn (forward-line 1)
+ (looking-at "[ \t]")))
+ (backward-char 1)
+ (buffer-substring-no-properties start (point)))))))
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; Use BBDB for interactive spec of MH-E commands
+
+(defadvice mh-send (before mh-bbdb-send act)
+ (interactive
+ (list (bbdb-completing-read-mails "To: ")
+ (bbdb-completing-read-mails "Cc: ")
+ (read-string "Subject: "))))
+
+(defadvice mh-send-other-window (before mh-bbdb-send-other act)
+ (interactive
+ (list (bbdb-completing-read-mails "To: ")
+ (bbdb-completing-read-mails "Cc: ")
+ (read-string "Subject: "))))
+
+(defadvice mh-forward (before mh-bbdb-forward act)
+ (interactive
+ (list (bbdb-completing-read-mails "To: ")
+ (bbdb-completing-read-mails "Cc: ")
+ (if current-prefix-arg
+ (mh-read-seq-default "Forward" t)
+ (mh-get-msg-num t)))))
+
+(defadvice mh-redistribute (before mh-bbdb-redist act)
+ (interactive
+ (list (bbdb-completing-read-mails "Redist-To: ")
+ (bbdb-completing-read-mails "Redist-Cc: ")
+ (mh-get-msg-num t))))
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+;;;###autoload
+(defun bbdb-insinuate-mh ()
+ "Call this function to hook BBDB into MH-E.
+Do not call this in your init file. Use `bbdb-initialize'."
+ (define-key mh-folder-mode-map ":" 'bbdb-mua-display-sender)
+ (define-key mh-folder-mode-map ";" 'bbdb-mua-edit-field-sender)
+ ;; Do we need keybindings for more commands? Suggestions welcome.
+ ;; (define-key mh-folder-mode-map ":" 'bbdb-mua-display-records)
+ ;; (define-key mh-folder-mode-map "'" 'bbdb-mua-display-recipients)
+ ;; (define-key mh-folder-mode-map ";" 'bbdb-mua-edit-field-recipients)
+ (when bbdb-complete-mail
+ (define-key mh-letter-mode-map "\M-;" 'bbdb-complete-mail)
+ (define-key mh-letter-mode-map "\e\t" 'bbdb-complete-mail)))
+
+(provide 'bbdb-mhe)
+
+;;; bbdb-mhe.el ends here
--- /dev/null
+;;; bbdb-migrate.el --- migration functions for BBDB -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;; This file contains the migration functions for BBDB.
+;;; See the BBDB info manual for documentation.
+
+;; Changes in `bbdb-file-format':
+;; 3 Date format for `creation-date' and `timestamp' changed
+;; from "dd mmm yy" (ex: 25 Sep 97) to "yyyy-mm-dd" (ex: 1997-09-25).
+;; 4 Country field added.
+;; 5 Streets are lists.
+;; 6 Postcodes are plain strings.
+;; 7 New field `affix'. Organizations are a list.
+;; Xfields is always a list.
+;; (8 Skipped format in "official BBDB": Some BBDB users introduced
+;; an xfield uuid in their format 8. To bring them back, we jump
+;; straight from 7 to 9.)
+;; 9 New field uuid. Make `creation-date' and `timestamp' immutable fields.
+
+
+;;; Code:
+
+(require 'bbdb)
+
+;;; Migrating the BBDB
+
+(defvar bbdb-migrate-uuid-xfield 'uuid
+ "Xfield holding a uuid in file format 8.")
+
+;;;###autoload
+(defun bbdb-migrate (records old)
+ "Migrate RECORDS from format OLD to `bbdb-file-format'."
+ ;; Some BBDB files were corrupted by random outer layers of
+ ;; parentheses surrounding the actual correct data. We attempt to
+ ;; compensate for this.
+ (while (and (consp records)
+ (listp (car records))
+ (null (cdr records)))
+ (setq records (car records)))
+
+ ;; `bbdb-migrate-lambda' uses the usual functions to access and set
+ ;; the fields of a record. So if a new record format changes
+ ;; the set of fields, we need to make these changes first.
+
+ ;; Format 7: Add new field `affix'.
+ (if (< old 7)
+ (let (new-records)
+ (dolist (record records)
+ (push (vector (elt record 0) (elt record 1) nil
+ (elt record 2) (elt record 3) (elt record 4)
+ (elt record 5) (elt record 6) (elt record 7)
+ (elt record 8))
+ new-records))
+ (setq records (nreverse new-records))))
+
+ ;; Format 9: New field `uuid'.
+ ;; Make `creation-date' and `timestamp' immutable fields.
+ (if (< old 9)
+ (let (new-records)
+ (dolist (record records)
+ (let ((uuid (or (cdr (assq bbdb-migrate-uuid-xfield (elt record 8)))
+ (bbdb-uuid)))
+ (creation-date (or (cdr (assq 'creation-date (elt record 8)))
+ (format-time-string bbdb-time-stamp-format nil t)))
+ (timestamp (or (cdr (assq 'timestamp (elt record 8)))
+ (format-time-string bbdb-time-stamp-format nil t))))
+ (push (vector (elt record 0) (elt record 1) (elt record 2)
+ (elt record 3) (elt record 4) (elt record 5)
+ (elt record 6) (elt record 7)
+ (let ((xfields (elt record 8)))
+ (dolist (elt '(uuid creation-date timestamp))
+ (setq xfields (assq-delete-all elt xfields)))
+ xfields)
+ uuid creation-date timestamp
+ (elt record 9))
+ new-records)))
+ (setq records (nreverse new-records))))
+
+ (mapc (bbdb-migrate-lambda old) records)
+ records)
+
+(defconst bbdb-migrate-alist
+ '((3 (bbdb-record-xfields bbdb-record-set-xfields
+ bbdb-migrate-dates))
+ (4 (bbdb-record-address bbdb-record-set-address
+ bbdb-migrate-add-country))
+ (5 (bbdb-record-address bbdb-record-set-address
+ bbdb-migrate-streets-to-list))
+ (6 (bbdb-record-address bbdb-record-set-address
+ bbdb-migrate-postcode-to-string))
+ (7 (bbdb-record-xfields bbdb-record-set-xfields
+ bbdb-migrate-xfields-to-list)
+ (bbdb-record-organization bbdb-record-set-organization
+ bbdb-migrate-organization-to-list)))
+ ;; Formats 8 and 9: do nothing
+ "Alist (VERSION . CHANGES).
+CHANGES is a list with elements (GET SET FUNCTION) that expands
+to action (SET record (FUNCTION (GET record))).")
+
+(defun bbdb-migrate-lambda (old)
+ "Return the function to migrate from OLD to `bbdb-file-format'.
+The manipulations are defined by `bbdb-migrate-alist'."
+ (let (spec)
+ (while (<= old bbdb-file-format)
+ (setq spec (append spec (cdr (assoc old bbdb-migrate-alist)))
+ old (1+ old)))
+ `(lambda (record)
+ ,@(mapcar (lambda (change)
+ ;; (SET record (FUNCTION (GET record)))
+ `(,(nth 1 change) record ; SET
+ (,(nth 2 change) ; FUNCTION
+ (,(nth 0 change) record)))) ; GET
+ spec)
+ record)))
+
+(defun bbdb-migrate-postcode-to-string (addresses)
+ "Make all postcodes plain strings.
+This uses the code that used to be in `bbdb-address-postcode'."
+ ;; apply the function to all addresses in the list and return a
+ ;; modified list of addresses
+ (mapcar (lambda (address)
+ (let ((postcode (bbdb-address-postcode address)))
+ (bbdb-address-set-postcode
+ address
+ (cond ((stringp postcode)
+ postcode)
+ ;; nil or zero
+ ((or (zerop postcode)
+ (null postcode))
+ "")
+ ;; a number
+ ((numberp postcode)
+ (format "%d" postcode))
+ ;; list with two strings
+ ((and (stringp (nth 0 postcode))
+ (stringp (nth 1 postcode)))
+ ;; the second string starts with 4 digits
+ (if (string-match "^[0-9][0-9][0-9][0-9]"
+ (nth 1 postcode))
+ (format "%s-%s" (nth 0 postcode) (nth 1 postcode))
+ ;; ("abc" "efg")
+ (format "%s %s" (nth 0 postcode) (nth 1 postcode))))
+ ;; list with two numbers
+ ((and (integerp (nth 0 postcode))
+ (integerp (nth 1 postcode)))
+ (format "%05d-%04d" (nth 0 postcode) (nth 1 postcode)))
+ ;; list with a string and a number
+ ((and (stringp (nth 0 postcode))
+ (integerp (nth 1 postcode)))
+ (format "%s-%d" (nth 0 postcode) (nth 1 postcode)))
+ ;; ("SE" (123 45))
+ ((and (stringp (nth 0 postcode))
+ (integerp (nth 0 (nth 1 postcode)))
+ (integerp (nth 1 (nth 1 postcode))))
+ (format "%s-%d %d" (nth 0 postcode) (nth 0 (nth 1 postcode))
+ (nth 1 (nth 1 postcode))))
+ ;; last possibility
+ (t (format "%s" postcode)))))
+ address)
+ addresses))
+
+(defun bbdb-migrate-dates (xfields)
+ "Change date formats.
+Formats are changed in timestamp and creation-date fields from
+\"dd mmm yy\" to \"yyyy-mm-dd\"."
+ (unless (stringp xfields)
+ (mapc (lambda (xfield)
+ (when (memq (car xfield) '(creation-date timestamp))
+ (bbdb-migrate-date xfield)))
+ xfields)
+ xfields))
+
+(defun bbdb-migrate-date (field)
+ "Convert date field FIELD from \"dd mmm yy\" to \"yyyy-mm-dd\"."
+ (let* ((date (cdr field))
+ (parsed (timezone-parse-date (concat date " 00:00:00"))))
+ ;; If `timezone-parse-date' cannot make sense of its arg DATE
+ ;; it returns ["0" "0" "0" "0" nil].
+ (if (equal parsed ["0" "0" "0" "0" nil])
+ (setq parsed (timezone-parse-date date)))
+ (when (equal parsed ["0" "0" "0" "0" nil])
+ (cond ((string-match
+ "^\\([0-9]\\{4\\}\\)[-/]\\([ 0-9]?[0-9]\\)[-/]\\([ 0-9]?[0-9]\\)" date)
+ (setq parsed (vector (match-string 1 date) (match-string 2 date)
+ (match-string 3 date))))
+ ((string-match
+ "^\\([ 0-9]?[0-9]\\)[-/]\\([ 0-9]?[0-9]\\)[-/]\\([0-9]\\{4\\}\\)" date)
+ (setq parsed (vector (match-string 3 date) (match-string 1 date)
+ (match-string 2 date))))))
+
+ ;; We need numbers for the following sanity check
+ (dotimes (i 3)
+ (if (stringp (aref parsed i))
+ (aset parsed i (string-to-number (aref parsed i)))))
+
+ ;; Sanity check
+ (if (and (< 0 (aref parsed 0))
+ (< 0 (aref parsed 1)) (< (aref parsed 1) 13)
+ (< 0 (aref parsed 2))
+ (<= (aref parsed 2)
+ (timezone-last-day-of-month (aref parsed 1) (aref parsed 0))))
+ (setcdr field (format "%04d-%02d-%02d" (aref parsed 0)
+ (aref parsed 1) (aref parsed 2)))
+ (error "BBDB cannot parse %s header value %S for upgrade"
+ field date))))
+
+(defun bbdb-migrate-add-country (addrl)
+ "Add a country field to each address in the address list."
+ (mapcar (lambda (address) (vconcat address [bbdb-default-country])) addrl))
+
+(defun bbdb-migrate-streets-to-list (addrl)
+ "Convert the streets to a list."
+ (mapcar (lambda (address)
+ (vector (aref address 0) ; key
+ (delq nil (delete "" ; nuke empties
+ (list (aref address 1) ; street1
+ (aref address 2) ; street2
+ (aref address 3))));street3
+ (aref address 4) ; city
+ (aref address 5) ; state
+ (aref address 6) ; postcode
+ (aref address 7))) ; country
+ addrl))
+
+(defun bbdb-migrate-xfields-to-list (xfields)
+ "Migrate XFIELDS to list."
+ (if (stringp xfields)
+ `((notes . ,xfields))
+ xfields))
+
+(defun bbdb-migrate-organization-to-list (organization)
+ "Migrate ORGANIZATION to list."
+ (if (stringp organization)
+ (bbdb-split 'organization organization)
+ organization))
+
+;;;###autoload
+(defun bbdb-undocumented-variables (&optional name-space message)
+ "Return list of undocumented variables in NAME-SPACE.
+NAME-SPACE defaults to \"bbdb-\". Use a prefix arg to specify NAME-SPACE
+interactively. If MESSAGE is non-nil (as in interactive calls) display
+the list in the message area.
+
+This command may come handy to identify BBDB variables in your init file
+that are not used anymore by the current version of BBDB. Yet this fails
+for outdated BBDB variables that are set via your personal `custom-file'."
+ (interactive (list (if current-prefix-arg
+ (read-string "Name space: ")) t))
+ (let ((re (concat "\\`" (or name-space "bbdb-"))) list)
+ (mapatoms (lambda (vv)
+ (if (and (boundp vv)
+ (string-match re (symbol-name vv))
+ (not (get vv 'variable-documentation))
+ (not (get vv 'byte-obsolete-variable)))
+ (push vv list))))
+ (if message
+ (if list
+ (apply 'message (concat "Undocumented variables: "
+ (mapconcat (lambda (_m) "%s") list " ")) list)
+ (message "No undocumented variables `%s...'" name-space)))
+ list))
+
+(provide 'bbdb-migrate)
+
+;;; bbdb-migrate.el ends here
--- /dev/null
+;;; bbdb-mu4e.el --- BBDB interface to mu4e -*- lexical-binding: t -*-
+
+;; Copyright (C) 2015-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; This file contains the BBDB interface to mu4e.
+;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(if t (require 'mu4e-view))
+
+(defvar mu4e-view-mode-map)
+
+;;;###autoload
+(defun bbdb-insinuate-mu4e ()
+ "Hook BBDB into mu4e.
+Do not call this in your init file. Use `bbdb-initialize'."
+ ;; Tackle headers later
+ ;; (define-key mu4e-headers-mode-map ":" 'bbdb-mua-display-sender)
+ ;; (define-key mu4e-headers-mode-map ";" 'bbdb-mua-edit-field-sender)
+ ;; Do we need keybindings for more commands? Suggestions welcome.
+ (define-key mu4e-view-mode-map ":" 'bbdb-mua-display-sender)
+ (define-key mu4e-view-mode-map ";" 'bbdb-mua-edit-field-sender))
+
+(provide 'bbdb-mu4e)
+
+;;; bbdb-mu4e.el ends here
--- /dev/null
+;;; bbdb-mua.el --- various MUA functionality for BBDB -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; This file provides various additional functionality for BBDB
+;; See the BBDB info manual for documentation.
+
+;; This file lets you do stuff like
+;;
+;; o automatically add some string to some field(s) based on the
+;; contents of header fields of the current message
+;; o only automatically create records when certain header fields
+;; are matched
+;; o do not automatically create records when certain header fields
+;; are matched
+;;
+;; Read the docstrings; read the texinfo file.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+
+(eval-and-compile
+ (autoload 'gnus-fetch-original-field "gnus-utils")
+ (autoload 'gnus-summary-select-article "gnus-sum")
+ (defvar gnus-article-buffer)
+
+ (autoload 'bbdb/vm-header "bbdb-vm")
+ (autoload 'vm-follow-summary-cursor "vm-motion")
+ (autoload 'vm-select-folder-buffer "vm-macro")
+ (autoload 'vm-check-for-killed-summary "vm-misc")
+ (autoload 'vm-error-if-folder-empty "vm-misc")
+
+ (autoload 'bbdb/rmail-header "bbdb-rmail")
+ (defvar rmail-buffer)
+
+ (autoload 'bbdb/mh-header "bbdb-mhe")
+ (autoload 'mh-show "mh-show")
+ (defvar mh-show-buffer)
+
+ (defvar mu4e~view-buffer-name)
+
+ (autoload 'bbdb/wl-header "bbdb-wl")
+
+ (autoload 'message-field-value "message")
+ (autoload 'mail-decode-encoded-word-string "mail-parse"))
+
+(defconst bbdb-mua-mode-alist
+ '((vm vm-mode vm-virtual-mode vm-summary-mode vm-presentation-mode)
+ (gnus gnus-summary-mode gnus-article-mode gnus-tree-mode)
+ (rmail rmail-mode rmail-summary-mode)
+ (mh mhe-mode mhe-summary-mode mh-folder-mode)
+ (mu4e mu4e-view-mode) ; Tackle `mu4e-headers-mode' later
+ (wl wl-summary-mode wl-draft-mode)
+ (message message-mode mu4e-compose-mode notmuch-message-mode)
+ (mail mail-mode))
+ "Alist of MUA modes supported by BBDB.
+Each element is of the form (MUA MODE MODE ...), where MODEs are used by MUA.")
+
+(defun bbdb-mua ()
+ "For the current message return the MUA.
+Return values include
+ gnus Newsreader Gnus
+ rmail Reading Mail in Emacs
+ vm Viewmail
+ mh Emacs interface to the MH mail system (aka MH-E)
+ mu4e Mu4e
+ wl Wanderlust
+ message Mail and News composition mode that goes with Gnus
+ mail Emacs Mail Mode."
+ (let ((mm-alist bbdb-mua-mode-alist)
+ elt mua)
+ (while (setq elt (pop mm-alist))
+ (if (memq major-mode (cdr elt))
+ (setq mua (car elt)
+ mm-alist nil)))
+ (or mua (error "BBDB: MUA `%s' not supported" major-mode))))
+
+;;;###autoload
+(defun bbdb-message-header (header)
+ "For the current message return the value of HEADER.
+MIME encoded headers are decoded. Return nil if HEADER does not exist."
+ ;; RW: If HEADER was allowed to be a regexp and the content of multiple
+ ;; matching headers was concatenated as in `message-field-value',
+ ;; this would simplify the usage of `bbdb-accept-message-alist' and
+ ;; `bbdb-ignore-message-alist'.
+ ;; RW: If this function had a remember table, it could look up the value
+ ;; of a header if we request the value of the same header multiple times.
+ ;; (We would reset the remember table each time we move on to a new message.)
+ (let* ((mua (bbdb-mua))
+ (val (cond (;; It seems that `gnus-fetch-field' fetches decoded content of
+ ;; `gnus-visible-headers', ignoring `gnus-ignored-headers'.
+ ;; Here we use instead `gnus-fetch-original-field' that fetches
+ ;; the encoded content of `gnus-original-article-buffer'.
+ ;; Decoding makes this possibly a bit slower, but something like
+ ;; `bbdb-select-message' does not get fooled by an apparent
+ ;; absence of some headers.
+ ;; See http://permalink.gmane.org/gmane.emacs.gnus.general/78741
+ (eq mua 'gnus) (gnus-fetch-original-field header))
+ ((eq mua 'vm) (bbdb/vm-header header))
+ ((eq mua 'rmail) (bbdb/rmail-header header))
+ ((eq mua 'mh) (bbdb/mh-header header))
+ ((eq mua 'mu4e) (message-field-value header))
+ ((eq mua 'wl) (bbdb/wl-header header))
+ ((memq mua '(message mail)) (message-field-value header))
+ (t (error "BBDB/%s: header function undefined" mua)))))
+ (if val (mail-decode-encoded-word-string val))))
+
+(defsubst bbdb-message-header-re (header regexp)
+ "Return non-nil if REGEXP matches value of HEADER."
+ (let ((val (bbdb-message-header header))
+ (case-fold-search t)) ; RW: Is this what we want?
+ (and val (string-match regexp val))))
+
+;;; Update database
+
+;;;###autoload
+(defun bbdb-accept-message (&optional invert)
+ "For use with variable `bbdb-mua-update-interactive-p' and friends.
+Return the value of variable `bbdb-update-records-p' for messages matching
+`bbdb-accept-message-alist'. If INVERT is non-nil, accept messages
+not matching `bbdb-ignore-message-alist'."
+ (let ((rest (if invert bbdb-ignore-message-alist
+ bbdb-accept-message-alist))
+ done elt)
+ (if (eq rest t)
+ (setq done t)
+ (while (and (setq elt (pop rest)) (not done))
+ (dolist (header (if (stringp (car elt)) (list (car elt)) (car elt)))
+ (if (bbdb-message-header-re header (cdr elt))
+ (setq done t)))))
+ (if invert (setq done (not done)))
+ (if done bbdb-update-records-p)))
+
+;;;###autoload
+(defun bbdb-ignore-message (&optional invert)
+ "For use with variable `bbdb-mua-update-interactive-p' and friends.
+Return the value of variable `bbdb-update-records-p' for messages not matching
+`bbdb-ignore-message-alist'. If INVERT is non-nil, accept messages
+matching `bbdb-accept-message-alist'."
+ (bbdb-accept-message (not invert)))
+
+;;;###autoload
+(defun bbdb-select-message ()
+ "For use with variable `bbdb-mua-update-interactive-p' and friends.
+Return the value of variable `bbdb-update-records-p' for messages both matching
+`bbdb-accept-message-alist' and not matching `bbdb-ignore-message-alist'."
+ (and (bbdb-accept-message)
+ (bbdb-ignore-message)))
+
+(defun bbdb-get-address-components (&optional header-class ignore-address)
+ "Extract mail addresses from a message.
+Return list with elements (NAME EMAIL HEADER HEADER-CLASS MUA).
+HEADER-CLASS is defined in `bbdb-message-headers'. If HEADER-CLASS is nil,
+use all classes in `bbdb-message-headers'.
+If regexp IGNORE-ADDRESS matches NAME or EMAIL of an address, this address
+is ignored. If IGNORE-ADDRESS is nil, use value of `bbdb-user-mail-address-re'."
+ ;; We do not use `bbdb-message-all-addresses' here because only when we
+ ;; have compared the addresses with the records in BBDB do we know which
+ ;; address(es) are relevant for us.
+ (let ((message-headers (if header-class
+ (list (assoc header-class bbdb-message-headers))
+ bbdb-message-headers))
+ (mua (bbdb-mua))
+ (ignore-address (or ignore-address bbdb-user-mail-address-re))
+ address-list name mail mail-list content)
+ (dolist (headers message-headers)
+ (dolist (header (cdr headers))
+ (when (setq content (bbdb-message-header header))
+ ;; Always extract all addresses because we do not know yet which
+ ;; address might match IGNORE-ADDRESS.
+ (dolist (address (bbdb-extract-address-components content t))
+ ;; We canonicalize name and mail as early as possible.
+ (setq name (car address)
+ mail (cadr address))
+ ;; ignore uninteresting addresses
+ (unless (or (and (stringp ignore-address)
+ (or (and name (string-match ignore-address name))
+ (and mail (string-match ignore-address mail))))
+ (and mail (member-ignore-case mail mail-list)))
+ ;; Add each address only once. (Use MAIL-LIST for book keeping.)
+ ;; Thus if we care about whether an address gets associated with
+ ;; one or another header, the order of elements in
+ ;; `bbdb-message-headers' is relevant. The "most important"
+ ;; headers should be first in `bbdb-message-headers'.
+ (if mail (push mail mail-list))
+ (push (list name mail header (car headers) mua) address-list))))))
+ (or (nreverse address-list)
+ (and header-class bbdb-message-try-all-headers
+ ;; Try again the remaining header classes
+ (let ((bbdb-message-headers
+ (remove (assoc header-class bbdb-message-headers)
+ bbdb-message-headers)))
+ (bbdb-get-address-components nil ignore-address))))))
+
+;;;###autoload
+(defun bbdb-update-records (address-list &optional update-p sort)
+ "Return the list of BBDB records matching ADDRESS-LIST.
+ADDRESS-LIST is a list of mail addresses. (It can be extracted from
+a mail message using `bbdb-get-address-components'.)
+UPDATE-P may take the following values:
+ search Search for existing records matching ADDRESS.
+ update Search for existing records matching ADDRESS;
+ update name and mail field if necessary.
+ query Search for existing records matching ADDRESS;
+ query for creation of a new record if the record does not exist.
+ create or t Search for existing records matching ADDRESS;
+ create a new record if it does not yet exist.
+ nil Do nothing.
+ a function This functions will be called with no arguments.
+ It should return one of the above values.
+
+If SORT is non-nil, sort records according to `bbdb-record-lessp'.
+Ottherwise, the records are ordered according to ADDRESS-LIST.
+
+Usually this function is called by the wrapper `bbdb-mua-update-records'."
+ ;; UPDATE-P allows filtering of complete messages.
+ ;; Filtering of individual addresses within an accepted message
+ ;; is done by `bbdb-get-address-components' using `bbdb-user-mail-address-re'.
+ ;; We resolve UPDATE-P repeatedly. This is needed, for example,
+ ;; with the chain `bbdb-mua-auto-update-p' -> `bbdb-select-message'
+ ;; -> `bbdb-update-records-p'.
+ (while (and (functionp update-p)
+ ;; Bad! `search' is a function in `cl-seq.el'.
+ (not (eq update-p 'search)))
+ (setq update-p (funcall update-p)))
+ (cond ((eq t update-p)
+ (setq update-p 'create))
+ ((not (memq update-p '(search update query create nil)))
+ (error "Illegal value of arg update-p: %s" update-p)))
+
+ (let (;; `bbdb-update-records-p' and `bbdb-offer-to-create' are used here
+ ;; as internal variables for communication with `bbdb-query-create'.
+ ;; This does not affect the value of the global user variable
+ ;; `bbdb-update-records-p'.
+ (bbdb-offer-to-create 'start)
+ (bbdb-update-records-p update-p)
+ address records)
+
+ (when update-p
+ (while (setq address (pop address-list))
+ (let* ((bbdb-update-records-address address)
+ hits
+ (task
+ (catch 'done
+ (setq hits
+ ;; We put the call of `bbdb-notice-mail-hook'
+ ;; into `bbdb-annotate-message' so that this hook
+ ;; runs only if the user agreed to change a record.
+ (cond ((or bbdb-read-only
+ (eq bbdb-update-records-p 'search))
+ ;; Search for records having this mail address
+ ;; but do not modify an existing record.
+ ;; This does not run `bbdb-notice-mail-hook'.
+ (bbdb-message-search (car address)
+ (cadr address)))
+ ((eq bbdb-update-records-p 'update)
+ (bbdb-annotate-message address 'update))
+ ((eq bbdb-update-records-p 'query)
+ (bbdb-annotate-message
+ address 'bbdb-query-create))
+ ((eq bbdb-update-records-p 'create)
+ (bbdb-annotate-message address 'create))))
+ nil)))
+ (cond ((eq task 'quit)
+ (setq address-list nil))
+ ((not (eq task 'next))
+ (dolist (hit (delq nil (nreverse hits)))
+ (bbdb-pushnew hit records))))
+ (if (and records (not bbdb-message-all-addresses))
+ (setq address-list nil))))
+ (setq records
+ (if sort (sort records 'bbdb-record-lessp)
+ ;; Make RECORDS a list ordered like ADDRESS-LIST.
+ (nreverse records))))
+
+ ;; `bbdb-message-search' might yield multiple records
+ (if (and records (not bbdb-message-all-addresses))
+ (setq records (list (car records))))
+
+ (unless bbdb-read-only
+ (bbdb-editable)
+ (dolist (record records)
+ (run-hook-with-args 'bbdb-notice-record-hook record)))
+
+ records))
+
+(defun bbdb-query-create ()
+ "Interactive query used by `bbdb-update-records'.
+Return t if the record should be created or `nil' otherwise.
+Honor previous answers such as `!'."
+ (let ((task bbdb-offer-to-create))
+ ;; If we have remembered what the user typed previously,
+ ;; `bbdb-offer-to-create' holds a character, i.e., a number.
+ ;; -- Right now, we only remember "!".
+ (when (not (integerp task))
+ (let ((prompt (format "%s is not in BBDB; add? (y,!,n,s,q,?) "
+ (or (nth 0 bbdb-update-records-address)
+ (nth 1 bbdb-update-records-address))))
+ event)
+ (while (not event)
+ (setq event (read-key-sequence prompt))
+ (setq event (if (stringp event) (aref event 0))))
+ (setq task event)
+ (message ""))) ; clear the message buffer
+
+ (cond ((eq task ?y)
+ t)
+ ((eq task ?!)
+ (setq bbdb-offer-to-create task)
+ t)
+ ((or (eq task ?n)
+ (eq task ?\s))
+ (throw 'done 'next))
+ ((or (eq task ?q)
+ (eq task ?\a)) ; ?\a = C-g
+ (throw 'done 'quit))
+ ((eq task ?s)
+ (setq bbdb-update-records-p 'search)
+ (throw 'done 'next))
+ (t ; any other key sequence
+ (save-window-excursion
+ (let* ((buffer (get-buffer-create " *BBDB Help*"))
+ (window (or (get-buffer-window buffer)
+ (split-window (get-lru-window)))))
+ (with-current-buffer buffer
+ (special-mode)
+ (let (buffer-read-only)
+ (erase-buffer)
+ (insert
+ "Your answer controls how BBDB updates/searches for records.
+
+Type ? for this help.
+Type y to add the current record.
+Type ! to add all remaining records.
+Type n to skip the current record. (You might also type space)
+Type s to switch from annotate to search mode.
+Type q to quit updating records. No more search or annotation is done.")
+ (set-buffer-modified-p nil)
+ (goto-char (point-min)))
+ (set-window-buffer window buffer)
+ (fit-window-to-buffer window)))
+ ;; Try again!
+ (bbdb-query-create))))))
+
+\f
+
+(defun bbdb-annotate-message (address &optional update-p)
+ "Fill the records for message ADDRESS with as much info as possible.
+If a record for ADDRESS does not yet exist, UPDATE-P controls whether
+a new record is created for ADDRESS. UPDATE-P may take the values:
+ update or nil Update existing records, never create a new record.
+ query Query interactively whether to create a new record.
+ create or t Create a new record.
+ a function This functions will be called with no arguments.
+ It should return one of the above values.
+Return the records matching ADDRESS or nil."
+ (let* ((mail (nth 1 address)) ; possibly nil
+ (name (unless (equal mail (car address))
+ (car address)))
+ (records (bbdb-message-search name mail))
+ created-p new-records)
+ (if (and (not records) (functionp update-p))
+ (setq update-p (funcall update-p)))
+ (cond ((eq t update-p) (setq update-p 'create))
+ ((not update-p) (setq update-p 'update)))
+
+ ;; Create a new record if nothing else fits.
+ ;; In this way, we can fill the slots of the new record with
+ ;; the same code that updates the slots of existing records.
+ (unless (or records
+ (eq update-p 'update)
+ (not (or name mail)))
+ ;; If there is no name, try to use the mail address as name
+ (if (and bbdb-message-mail-as-name mail
+ (or (null name)
+ (string= "" name)))
+ (setq name (funcall bbdb-message-clean-name-function mail)))
+ (if (or (eq update-p 'create)
+ (and (eq update-p 'query)
+ (y-or-n-p (format "%s is not in the BBDB. Add? "
+ (or name mail)))))
+ (setq records (list (bbdb-empty-record))
+ created-p t)))
+
+ (dolist (record records)
+ (let* ((old-name (bbdb-record-name record))
+ (fullname (bbdb-divide-name (or name "")))
+ (fname (car fullname))
+ (lname (cdr fullname))
+ (mail mail) ;; possibly changed below
+ (created-p created-p)
+ (update-p update-p)
+ change-p add-mails add-name ignore-redundant)
+
+ ;; Analyze the name part of the record.
+ (cond ((or (not name)
+ ;; The following tests can differ for more complicated names
+ (bbdb-string= name old-name)
+ (and (equal fname (bbdb-record-firstname record)) ; possibly
+ (equal lname (bbdb-record-lastname record))) ; nil
+ (member-ignore-case name (bbdb-record-aka record)))) ; do nothing
+
+ (created-p ; new record
+ (bbdb-record-set-field record 'name (cons fname lname)))
+
+ ((not (setq add-name (bbdb-add-job bbdb-add-name record name)))) ; do nothing
+
+ ((numberp add-name)
+ (unless bbdb-silent
+ (message "name mismatch: \"%s\" changed to \"%s\""
+ old-name name)
+ (sit-for add-name)))
+
+ ((bbdb-eval-spec add-name
+ (if old-name
+ (format "Change name \"%s\" to \"%s\"? "
+ old-name name)
+ (format "Assign name \"%s\" to address \"%s\"? "
+ name (car (bbdb-record-mail record)))))
+ ;; Keep old-name as AKA?
+ (when (and old-name
+ (not (member-ignore-case old-name (bbdb-record-aka record))))
+ (if (bbdb-eval-spec (bbdb-add-job bbdb-add-aka record old-name)
+ (format "Keep name \"%s\" as an AKA? " old-name))
+ (bbdb-record-set-field
+ record 'aka (cons old-name (bbdb-record-aka record)))
+ (bbdb-remhash old-name record)))
+ (bbdb-record-set-field record 'name (cons fname lname))
+ (setq change-p 'name))
+
+ ;; make new name an AKA?
+ ((and old-name
+ (not (member-ignore-case name (bbdb-record-aka record)))
+ (bbdb-eval-spec (bbdb-add-job bbdb-add-aka record name)
+ (format "Make \"%s\" an alternate for \"%s\"? "
+ name old-name)))
+ (bbdb-record-set-field
+ record 'aka (cons name (bbdb-record-aka record)))
+ (setq change-p 'name)))
+
+ ;; Is MAIL redundant compared with the mail addresses
+ ;; that are already known for RECORD?
+ (if (and mail
+ (setq ignore-redundant
+ (bbdb-add-job bbdb-ignore-redundant-mails record mail)))
+ (let ((mails (bbdb-record-mail-canon record))
+ (case-fold-search t) redundant ml re)
+ (while (setq ml (pop mails))
+ (if (and (setq re (bbdb-mail-redundant-re ml))
+ (string-match re mail))
+ (setq redundant ml mails nil)))
+ (if redundant
+ (cond ((numberp ignore-redundant)
+ (unless bbdb-silent
+ (message "%s: redundant mail `%s'"
+ (bbdb-record-name record) mail)
+ (sit-for ignore-redundant)))
+ ((or (eq t ignore-redundant)
+ bbdb-silent
+ (y-or-n-p (format "Ignore redundant mail %s?" mail)))
+ (setq mail redundant))))))
+
+ ;; Analyze the mail part of the new records
+ (cond ((or (not mail) (equal mail "???")
+ (member-ignore-case mail (bbdb-record-mail-canon record)))) ; do nothing
+
+ (created-p ; new record
+ (bbdb-record-set-field record 'mail (list mail)))
+
+ ((not (setq add-mails (bbdb-add-job bbdb-add-mails record mail)))) ; do nothing
+
+ ((numberp add-mails)
+ (unless bbdb-silent
+ (message "%s: new address `%s'"
+ (bbdb-record-name record) mail)
+ (sit-for add-mails)))
+
+ ((or (eq add-mails t) ; add it automatically
+ bbdb-silent
+ (y-or-n-p (format "Add address \"%s\" to %s? " mail
+ (bbdb-record-name record)))
+ (and (or (and (functionp update-p)
+ (progn (setq update-p (funcall update-p)) nil))
+ (memq update-p '(t create))
+ (and (eq update-p 'query)
+ (y-or-n-p
+ (format "Create a new record for %s? "
+ (bbdb-record-name record)))))
+ (progn
+ (setq record (bbdb-empty-record))
+ (bbdb-record-set-name record fname lname)
+ (setq created-p t))))
+
+ (let ((mails (bbdb-record-mail record)))
+ (if ignore-redundant
+ ;; Does the new address MAIL make an old address redundant?
+ (let ((mail-re (bbdb-mail-redundant-re mail))
+ (case-fold-search t) okay redundant)
+ (dolist (ml mails)
+ (if (string-match mail-re ml) ; redundant mail address
+ (push ml redundant)
+ (push ml okay)))
+ (let ((form (format "redundant mail%s %s"
+ (if (< 1 (length redundant)) "s" "")
+ (bbdb-concat 'mail (nreverse redundant))))
+ (name (bbdb-record-name record)))
+ (if redundant
+ (cond ((numberp ignore-redundant)
+ (unless bbdb-silent
+ (message "%s: %s" name form)
+ (sit-for ignore-redundant)))
+ ((or (eq t ignore-redundant)
+ bbdb-silent
+ (y-or-n-p (format "Delete %s: " form)))
+ (if (eq t ignore-redundant)
+ (message "%s: deleting %s" name form))
+ (setq mails okay)))))))
+
+ ;; then modify RECORD
+ (bbdb-record-set-field
+ record 'mail
+ (if (and mails
+ (bbdb-eval-spec (bbdb-add-job bbdb-new-mails-primary
+ record mail)
+ (format "Make \"%s\" the primary address? " mail)))
+ (cons mail mails)
+ (nconc mails (list mail))))
+ (unless change-p (setq change-p t)))))
+
+ (cond (created-p
+ (unless bbdb-silent
+ (if (bbdb-record-name record)
+ (message "created %s's record with address \"%s\""
+ (bbdb-record-name record) mail)
+ (message "created record with naked address \"%s\"" mail)))
+ (bbdb-change-record record))
+
+ (change-p
+ (unless bbdb-silent
+ (cond ((eq change-p 'name)
+ (message "noticed \"%s\"" (bbdb-record-name record)))
+ ((bbdb-record-name record)
+ (message "noticed %s's address \"%s\""
+ (bbdb-record-name record) mail))
+ (t
+ (message "noticed naked address \"%s\"" mail))))
+ (bbdb-change-record record)))
+
+ (run-hook-with-args 'bbdb-notice-mail-hook record)
+ (push record new-records)))
+
+ (nreverse new-records)))
+
+(defun bbdb-mua-update-records (&optional header-class update-p sort)
+ "Wrapper for `bbdb-update-records'.
+HEADER-CLASS is defined in `bbdb-message-headers'. If it is nil,
+use all classes in `bbdb-message-headers'.
+UPDATE-P is defined in `bbdb-update-records'.
+If SORT is non-nil, sort records according to `bbdb-record-lessp'."
+ (let ((mua (bbdb-mua)))
+ (save-current-buffer
+ (cond ;; VM
+ ((eq mua 'vm)
+ (vm-select-folder-buffer)
+ (vm-check-for-killed-summary)
+ (vm-error-if-folder-empty)
+ (let ((enable-local-variables t)) ; ...or vm bind this to nil.
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort)))
+ ;; Gnus
+ ((eq mua 'gnus)
+ (set-buffer gnus-article-buffer)
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort))
+ ;; MH-E
+ ((eq mua 'mh)
+ (if mh-show-buffer (set-buffer mh-show-buffer))
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort))
+ ;; Rmail
+ ((eq mua 'rmail)
+ (set-buffer rmail-buffer)
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort))
+ ;; mu4e
+ ((eq mua 'mu4e)
+ (set-buffer mu4e~view-buffer-name)
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort))
+ ;; Wanderlust
+ ((eq mua 'wl)
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort))
+ ;; Message and Mail
+ ((memq mua '(message mail))
+ (bbdb-update-records (bbdb-get-address-components header-class)
+ update-p sort))))))
+
+(defmacro bbdb-mua-wrapper (&rest body)
+ "Perform BODY in a MUA buffer."
+ (declare (debug t))
+ `(let ((mua (bbdb-mua)))
+ ;; Here we replicate BODY multiple times which gets clumsy
+ ;; for a larger BODY!
+ (cond ((eq mua 'gnus)
+ ;; This fails in *Article* buffers, where
+ ;; `gnus-article-read-summary-keys' provides an additional wrapper
+ (save-current-buffer
+ (gnus-summary-select-article) ; sets buffer `gnus-summary-buffer'
+ ,@body))
+ ((memq mua '(mail message rmail mh vm mu4e wl))
+ (cond ((eq mua 'vm) (vm-follow-summary-cursor))
+ ((eq mua 'mh) (mh-show)))
+ ;; rmail, mail, message, mu4e and wl do not require any wrapper
+ ,@body))))
+
+(defun bbdb-mua-update-interactive-p ()
+ "Interactive spec for arg UPDATE-P of `bbdb-mua-display-records' and friends.
+If these commands are called without a prefix, the value of their arg
+UPDATE-P is the car of the variable `bbdb-mua-update-interactive-p'.
+Called with a prefix, the value of UPDATE-P is the cdr of this variable."
+ (let ((update-p (if current-prefix-arg
+ (cdr bbdb-mua-update-interactive-p)
+ (car bbdb-mua-update-interactive-p))))
+ (if (eq update-p 'read)
+ (let ((str (completing-read "Action: " '((query) (search) (create))
+ nil t)))
+ (unless (string= "" str) (intern str))) ; nil otherwise
+ update-p)))
+
+(defun bbdb-mua-window-p ()
+ "Return lambda function matching the MUA window.
+This return value can be used as arg HORIZ-P of `bbdb-display-records'."
+ (let ((mm-alist bbdb-mua-mode-alist)
+ elt fun)
+ (while (setq elt (cdr (pop mm-alist)))
+ (if (memq major-mode elt)
+ (setq fun `(lambda (window)
+ (with-current-buffer (window-buffer window)
+ (memq major-mode ',elt)))
+ mm-alist nil)))
+ fun))
+
+;;;###autoload
+(defun bbdb-mua-display-records (&optional header-class update-p all)
+ "Display the BBDB record(s) for the addresses in this message.
+This looks into the headers of a message according to HEADER-CLASS.
+Then for the mail addresses found the corresponding BBDB records are displayed.
+UPDATE-P determines whether only existing BBDB records are displayed
+or whether also new records are created for these mail addresses.
+
+HEADER-CLASS is defined in `bbdb-message-headers'. If it is nil,
+use all classes in `bbdb-message-headers'.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'.
+If ALL is non-nil, bind `bbdb-message-all-addresses' to ALL."
+ (interactive (list nil (bbdb-mua-update-interactive-p)))
+ (let ((bbdb-pop-up-window-size bbdb-mua-pop-up-window-size)
+ (bbdb-message-all-addresses (or all bbdb-message-all-addresses))
+ records)
+ (bbdb-mua-wrapper
+ (setq records (bbdb-mua-update-records header-class update-p t)))
+ (if records (bbdb-display-records records nil nil nil (bbdb-mua-window-p)))
+ records))
+
+;; The following commands are some frontends for `bbdb-mua-display-records',
+;; which is always doing the real work. In your init file, you can further
+;; modify or adapt these simple commands to your liking.
+
+;;;###autoload
+(defun bbdb-mua-display-sender (&optional update-p)
+ "Display the BBDB record(s) for the sender of this message.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'."
+ (interactive (list (bbdb-mua-update-interactive-p)))
+ (bbdb-mua-display-records 'sender update-p))
+
+;;;###autoload
+(defun bbdb-mua-display-recipients (&optional update-p)
+ "Display the BBDB record(s) for the recipients of this message.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'."
+ (interactive (list (bbdb-mua-update-interactive-p)))
+ (bbdb-mua-display-records 'recipients update-p))
+
+;;;###autoload
+(defun bbdb-mua-display-all-records (&optional update-p)
+ "Display the BBDB record(s) for all addresses in this message.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'."
+ (interactive (list (bbdb-mua-update-interactive-p)))
+ (bbdb-mua-display-records nil update-p t))
+
+;;;###autoload
+(defun bbdb-mua-display-all-recipients (&optional update-p)
+ "Display BBDB records for all recipients of this message.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'."
+ (interactive (list (bbdb-mua-update-interactive-p)))
+ (bbdb-mua-display-records 'recipients update-p t))
+
+;; The commands `bbdb-annotate-record' and `bbdb-mua-edit-field'
+;; have kind of similar goals, yet they use rather different strategies.
+;; `bbdb-annotate-record' is less obtrusive. It does not display
+;; the records it operates on, nor does it display the content
+;; of the field before or after adding or replacing the annotation.
+;; Hence the user needs to know what she is doing.
+;; `bbdb-mua-edit-field' is more explicit: It displays the records
+;; as well as the current content of the field that gets edited.
+
+;; In principle, this function can be used not only with MUAs.
+(defun bbdb-annotate-record (record annotation &optional field replace)
+ "In RECORD add an ANNOTATION to field FIELD.
+FIELD defaults to `bbdb-annotate-field'.
+If REPLACE is non-nil, ANNOTATION replaces the content of FIELD.
+If ANNOTATION is an empty string and REPLACE is non-nil, delete FIELD."
+ (if (memq field '(name firstname lastname phone address xfields))
+ (error "Field `%s' illegal" field))
+ (setq annotation (bbdb-string-trim annotation))
+ (cond ((memq field '(affix organization mail aka))
+ (setq annotation (list annotation)))
+ ((not field) (setq field bbdb-annotate-field)))
+ (bbdb-record-set-field record field annotation (not replace))
+ (bbdb-change-record record))
+
+;; FIXME: For interactive calls of the following commands, the arg UPDATE-P
+;; should have the same meaning as for `bbdb-mua-display-records',
+;; that is, it should use `bbdb-mua-update-interactive-p'.
+;; But here the prefix arg is already used in a different way.
+;; We could possibly solve this problem if all `bbdb-mua-*' commands
+;; used another prefix arg that is consistently used only for
+;; `bbdb-mua-update-interactive-p'.
+;; Yet this prefix arg must be defined within the key space of the MUA(s).
+;; This results in lots of conflicts...
+;;
+;; Current workaround:
+;; These commands use merely the car of `bbdb-mua-update-interactive-p'.
+;; If one day someone proposes a smart solution to this problem (suggestions
+;; welcome!), this solution will hopefully include the current workaround
+;; as a subset of all its features.
+
+(defun bbdb-mua-annotate-field-interactive ()
+ "Interactive specification for `bbdb-mua-annotate-sender' and friends."
+ (bbdb-editable)
+ (let ((field (if (eq 'all-fields bbdb-annotate-field)
+ (intern (completing-read
+ "Field: "
+ (mapcar 'symbol-name
+ (append '(affix organization mail aka)
+ bbdb-xfield-label-list))))
+ bbdb-annotate-field)))
+ (list (read-string (format "Annotate `%s': " field))
+ field current-prefix-arg
+ (car bbdb-mua-update-interactive-p))))
+
+;;;###autoload
+(defun bbdb-mua-annotate-sender (annotation &optional field replace update-p)
+ "Add ANNOTATION to field FIELD of the BBDB record(s) of message sender(s).
+FIELD defaults to `bbdb-annotate-field'.
+If REPLACE is non-nil, ANNOTATION replaces the content of FIELD.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, use car of `bbdb-mua-update-interactive-p'."
+ (interactive (bbdb-mua-annotate-field-interactive))
+ (bbdb-mua-wrapper
+ (dolist (record (bbdb-mua-update-records 'sender update-p))
+ (bbdb-annotate-record record annotation field replace))))
+
+;;;###autoload
+(defun bbdb-mua-annotate-recipients (annotation &optional field replace
+ update-p)
+ "Add ANNOTATION to field FIELD of the BBDB records of message recipients.
+FIELD defaults to `bbdb-annotate-field'.
+If REPLACE is non-nil, ANNOTATION replaces the content of FIELD.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, use car of `bbdb-mua-update-interactive-p'."
+ (interactive (bbdb-mua-annotate-field-interactive))
+ (bbdb-mua-wrapper
+ (dolist (record (bbdb-mua-update-records 'recipients update-p))
+ (bbdb-annotate-record record annotation field replace))))
+
+(defun bbdb-mua-edit-field-interactive ()
+ "Interactive specification for command `bbdb-mua-edit-field' and friends."
+ (bbdb-editable)
+ (list (if (eq 'all-fields bbdb-mua-edit-field)
+ (intern (completing-read
+ "Field: "
+ (mapcar 'symbol-name
+ (append '(name affix organization aka mail)
+ bbdb-xfield-label-list))))
+ bbdb-mua-edit-field)
+ (bbdb-mua-update-interactive-p)))
+
+;;;###autoload
+(defun bbdb-mua-edit-field (&optional field update-p header-class)
+ "Edit FIELD of the BBDB record(s) of message sender(s) or recipients.
+FIELD defaults to value of variable `bbdb-mua-edit-field'.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'.
+HEADER-CLASS is defined in `bbdb-message-headers'. If it is nil,
+use all classes in `bbdb-message-headers'."
+ (interactive (bbdb-mua-edit-field-interactive))
+ (cond ((memq field '(firstname lastname address phone xfields))
+ (error "Field `%s' not editable this way" field))
+ ((not field)
+ (setq field bbdb-mua-edit-field)))
+ (bbdb-mua-wrapper
+ (let ((records (bbdb-mua-update-records header-class update-p))
+ (bbdb-pop-up-window-size bbdb-mua-pop-up-window-size))
+ (when records
+ (bbdb-display-records records nil nil nil (bbdb-mua-window-p))
+ (dolist (record records)
+ (bbdb-edit-field record field))))))
+
+;;;###autoload
+(defun bbdb-mua-edit-field-sender (&optional field update-p)
+ "Edit FIELD of record corresponding to sender of this message.
+FIELD defaults to value of variable `bbdb-mua-edit-field'.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'."
+ (interactive (bbdb-mua-edit-field-interactive))
+ (bbdb-mua-edit-field field update-p 'sender))
+
+;;;###autoload
+(defun bbdb-mua-edit-field-recipients (&optional field update-p)
+ "Edit FIELD of record corresponding to recipient of this message.
+FIELD defaults to value of variable `bbdb-mua-edit-field'.
+UPDATE-P may take the same values as `bbdb-update-records-p'.
+For interactive calls, see function `bbdb-mua-update-interactive-p'."
+ (interactive (bbdb-mua-edit-field-interactive))
+ (bbdb-mua-edit-field field update-p 'recipients))
+
+;; Functions for noninteractive use in MUA hooks
+
+;;;###autoload
+(defun bbdb-mua-auto-update (&optional header-class update-p)
+ "Update BBDB automatically based on incoming and outgoing messages.
+This looks into the headers of a message according to HEADER-CLASS.
+Then for the mail addresses found the corresponding BBDB records are updated.
+UPDATE-P determines whether only existing BBDB records are taken
+or whether also new records are created for these mail addresses.
+Return matching records.
+
+HEADER-CLASS is defined in `bbdb-message-headers'. If it is nil,
+use all classes in `bbdb-message-headers'.
+UPDATE-P may take the same values as `bbdb-mua-auto-update-p'.
+If UPDATE-P is nil, use `bbdb-mua-auto-update-p' (which see).
+
+If `bbdb-mua-pop-up' is non-nil, BBDB pops up the *BBDB* buffer
+along with the MUA window(s), displaying the matching records
+using `bbdb-pop-up-layout'.
+If this is nil, BBDB is updated silently.
+
+This function is intended for noninteractive use via appropriate MUA hooks.
+Call `bbdb-mua-auto-update-init' in your init file to put this function
+into the respective MUA hooks.
+See `bbdb-mua-display-records' and friends for interactive commands."
+ (let* ((bbdb-silent-internal t)
+ (records (bbdb-mua-update-records header-class
+ (or update-p
+ bbdb-mua-auto-update-p)))
+ (bbdb-pop-up-window-size bbdb-mua-pop-up-window-size))
+ (if bbdb-mua-pop-up
+ (if records
+ (bbdb-display-records records bbdb-pop-up-layout
+ nil nil (bbdb-mua-window-p))
+ ;; If there are no records, empty the BBDB window.
+ (bbdb-undisplay-records)))
+ records))
+
+;; Should the following be replaced by a minor mode??
+;; Or should we make this function interactive in some other way?
+
+;;;###autoload
+(defun bbdb-mua-auto-update-init (&rest muas)
+ "For MUAS add `bbdb-mua-auto-update' to their presentation hook.
+If a MUA is not an element of MUAS, `bbdb-mua-auto-update' is removed
+from the respective presentation hook.
+
+Call this function in your init file to use the auto update feature with MUAS.
+This function is separate from the general function `bbdb-initialize'
+as this allows one to initialize the auto update feature for some MUAs only,
+for example only for outgoing messages.
+
+See `bbdb-mua-auto-update' for details about the auto update feature."
+ (dolist (mua '((message . message-send-hook)
+ (mail . mail-send-hook)
+ (rmail . rmail-show-message-hook)
+ (gnus . gnus-article-prepare-hook)
+ (mh . mh-show-hook)
+ (vm . vm-select-message-hook)
+ (wl . wl-message-redisplay-hook)))
+ (if (memq (car mua) muas)
+ (add-hook (cdr mua) 'bbdb-mua-auto-update)
+ (remove-hook (cdr mua) 'bbdb-mua-auto-update))))
+
+;;;###autoload
+(defun bbdb-auto-notes (record)
+ "Automatically annotate RECORD based on the headers of the current message.
+See the variables `bbdb-auto-notes-rules', `bbdb-auto-notes-ignore-messages'
+and `bbdb-auto-notes-ignore-headers'.
+For use as an element of `bbdb-notice-record-hook'."
+ ;; This code re-evaluates the annotations each time a message is viewed.
+ ;; It would be faster if we could somehow store (permanently?) that we
+ ;; have already annotated a message.
+ (let ((case-fold-search t))
+ (unless (or bbdb-read-only
+ ;; check the ignore-messages pattern
+ (let ((ignore-messages bbdb-auto-notes-ignore-messages)
+ ignore rule)
+ (while (and (not ignore) (setq rule (pop ignore-messages)))
+ (if (cond ((functionp rule)
+ ;; RULE may use `bbdb-update-records-address'
+ (funcall rule record))
+ ((symbolp rule)
+ (eq rule (nth 4 bbdb-update-records-address)))
+ ((eq 1 (safe-length rule))
+ (bbdb-message-header-re (car rule) (cdr rule)))
+ ((eq 2 (safe-length rule))
+ (and (eq (car rule) (nth 4 bbdb-update-records-address))
+ (bbdb-message-header-re (nth 1 rule) (nth 2 rule)))))
+ (setq ignore t)))
+ ignore))
+ (bbdb-editable)
+
+ ;; For speed-up expanded rules are stored in `bbdb-auto-notes-rules-expanded'.
+ (when (and bbdb-auto-notes-rules
+ (not bbdb-auto-notes-rules-expanded))
+ (let (expanded mua from-to header)
+ (dolist (rule bbdb-auto-notes-rules)
+ ;; Which MUA do we want?
+ (if (or (stringp (car rule))
+ (stringp (nth 1 rule)))
+ (setq mua t)
+ (setq mua (if (symbolp (car rule)) (listp (car rule)) (car rule))
+ rule (cdr rule)))
+ ;; Which FROM-TO headers do we want?
+ (if (stringp (car rule))
+ (setq from-to t)
+ (setq from-to (car rule)
+ rule (cdr rule)))
+ (setq header (car rule))
+ (let (string field replace elt-e)
+ (dolist (elt (cdr rule))
+ (if (consp (setq string (cdr elt)))
+ (setq field (car string) ; (REGEXP FIELD-NAME STRING REPLACE)
+ replace (nth 2 string) ; perhaps nil
+ string (nth 1 string))
+ ;; else it's simple (REGEXP . STRING)
+ (setq field bbdb-default-xfield
+ replace nil))
+ (push (list (car elt) field string replace) elt-e))
+ (push (append (list mua from-to header) (nreverse elt-e)) expanded)))
+ (setq bbdb-auto-notes-rules-expanded (nreverse expanded))))
+
+ (dolist (rule bbdb-auto-notes-rules-expanded)
+ (let ((mua (car rule)) (from-to (nth 1 rule)) (header (nth 2 rule))
+ hd-val string annotation)
+ (when (and (or (eq mua t)
+ (memq (nth 4 bbdb-update-records-address) mua))
+ (or (eq from-to t)
+ (member-ignore-case
+ (nth 2 bbdb-update-records-address) from-to)
+ (memq (nth 3 bbdb-update-records-address) from-to))
+ (setq hd-val (bbdb-message-header header)))
+ (dolist (elt (nthcdr 3 rule))
+ (when (and (string-match (car elt) hd-val)
+ (let ((ignore (cdr (assoc-string
+ header
+ bbdb-auto-notes-ignore-headers t))))
+ (not (and ignore (string-match ignore hd-val)))))
+ (setq string (nth 2 elt)
+ annotation
+ (cond ((integerp string)
+ (match-string string hd-val))
+ ((stringp string)
+ (replace-match string nil nil hd-val))
+ ((functionp string)
+ (funcall string hd-val))
+ (t (error "Illegal value: %s" string))))
+ (bbdb-annotate-record record annotation
+ (nth 1 elt) (nth 3 elt))))))))))
+
+;;; Mark BBDB records in the MUA summary buffer
+
+(defun bbdb-mua-summary-unify (address)
+ "Unify mail ADDRESS displayed for a message in the MUA Summary buffer.
+Typically ADDRESS refers to the value of the From header of a message.
+If ADDRESS matches a record in BBDB display a unified name instead of ADDRESS
+in the MUA Summary buffer.
+
+Unification uses `bbdb-mua-summary-unification-list' (see there).
+The first match in this list becomes the text string displayed
+for a message in the MUA Summary buffer instead of ADDRESS.
+If variable `bbdb-mua-summary-mark' is non-nil use it to precede known addresses.
+Return the unified mail address.
+
+Currently this works with Gnus and VM. It requires the BBDB insinuation
+of these MUAs. Also, the MUA Summary format string must use
+`bbdb-mua-summary-unify-format-letter' (see there)."
+ ;; ADDRESS is analyzed as in `bbdb-get-address-components'.
+ (let* ((data (bbdb-extract-address-components address))
+ (name (car data))
+ (mail (cadr data))
+ (record (car (bbdb-message-search name mail)))
+ (u-list bbdb-mua-summary-unification-list)
+ elt val)
+ (while (setq elt (pop u-list))
+ (setq val (cond ((eq elt 'message-name) name)
+ ((eq elt 'message-mail) mail)
+ ((eq elt 'message-address) address)
+ (record (let ((result (bbdb-record-field record elt)))
+ (if (stringp result) result
+ (car result)))))) ; RESULT is list.
+ (if val (setq u-list nil)))
+ (format "%s%s"
+ (cond ((not bbdb-mua-summary-mark) "")
+ ((not record) " ")
+ ((functionp bbdb-mua-summary-mark-field)
+ (funcall bbdb-mua-summary-mark-field record))
+ ((bbdb-record-xfield record bbdb-mua-summary-mark-field))
+ (t bbdb-mua-summary-mark))
+ (or val name mail address "**UNKNOWN**"))))
+
+(defun bbdb-mua-summary-mark (address)
+ "In the MUA Summary buffer mark messages matching a BBDB record.
+ADDRESS typically refers to the value of the From header of a message.
+If ADDRESS matches a record in BBDB return a mark, \" \" otherwise.
+The mark itself is the value of the xfield `bbdb-mua-summary-mark-field'
+if this xfield is in the poster's record, and `bbdb-mua-summary-mark' otherwise."
+ (if (not bbdb-mua-summary-mark)
+ "" ; for consistency
+ ;; ADDRESS is analyzed as in `bbdb-get-address-components'.
+ (let* ((data (bbdb-extract-address-components address))
+ (record (car (bbdb-message-search (car data) (cadr data)))))
+ (if record
+ (or (when (functionp bbdb-mua-summary-mark-field)
+ (funcall bbdb-mua-summary-mark-field record)
+ t)
+ (bbdb-record-xfield record bbdb-mua-summary-mark-field)
+ bbdb-mua-summary-mark)
+ " "))))
+
+(provide 'bbdb-mua)
+
+;;; bbdb-mua.el ends here
--- /dev/null
+;;; bbdb-pgp.el --- use BBDB to handle PGP preferences -*- lexical-binding: t -*-
+
+;; Copyright (C) 2013-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; It is believed that encrypted mail works best if all mail between
+;; individuals is encrypted - even concerning matters that are not
+;; confidential. The reasoning is that confidential messages cannot
+;; then be easily spotted and decryption efforts concentrated on them.
+;; Some people therefore prefer to have all their email encrypted.
+;; This package allows you to mark the BBDB entries for those
+;; individuals so that messages will be (signed or) encrypted
+;; when they are sent.
+
+;;; Usage:
+;; Add the xfield pgp-mail (see `bbdb-pgp-field') with the value
+;; `sign' or `encrypt' to the BBDB records of the message recipients.
+;; If the value is `sign-query' or `encrypt-query', this will query
+;; whether to send signed or encrypted messages.
+;;
+;; Then call `bbdb-pgp' on outgoing message to add MML tags,
+;; see info node `(message)security'. For all message recipients
+;; in `bbdb-pgp-headers', this command grabs the action in `bbdb-pgp-field'
+;; of their BBDB records. If this proposes multiple actions,
+;; perform the action which appears first in `bbdb-pgp-ranked-actions'.
+;; If this proposes no action at all, use `bbdb-pgp-default'.
+;; The variable `bbdb-pgp-method' defines the method which is actually used
+;; for signing and encrypting, see also `bbdb-pgp-method-alist'.
+;;
+;; `bbdb-pgp' works with both `mail-mode' and `message-mode' to send
+;; signed or encrypted mail.
+;;
+;; To run `bbdb-pgp' automatically when sending a message,
+;; use `bbdb-initialize' with arg `pgp' to add this function
+;; to `message-send-hook' and `mail-send-hook'.
+;; Yet see info node `(message)Signing and encryption' why you
+;; might not want to rely for encryption on a hook function
+;; which runs just before the message is sent, that is, you might want
+;; to call the command `bbdb-pgp' manually, then call `mml-preview'.
+;;
+;; A thought: For these hooks we could define a wrapper that calls
+;; first `bbdb-pgp', then `mml-preview' for preview. The wrapper should
+;; abort the sending of the message if the preview is not getting
+;; the user's approval. Yet this might require some recursive editing mode
+;; so that the user can browse the preview before approving it.
+;;
+;;; Todo:
+;; Spot incoming PGP-signed or encrypted messages and prompt for adding
+;; `bbdb-pgp-field' to the senders' BBDB records; similar to how
+;; bbdb-sc.el maintains attribution preferences.
+
+;;; Code:
+
+(require 'message)
+(require 'bbdb-com)
+
+(defcustom bbdb-pgp-field 'pgp-mail
+ "BBDB xfield holding the PGP action.
+If the recipient of a message has this xfield in his/her BBDB record,
+its value determines whether `bbdb-pgp' signs or encrypts the message.
+The value of this xfield should be one of the following symbols:
+ sign Sign the message
+ sign-query Query whether to sign the message
+ encrypt Encrypt the message
+ encrypt-query Query whether to encrypt the message
+If the xfield is absent use `bbdb-pgp-default'.
+See also info node `(message)security'."
+ :type '(symbol :tag "BBDB xfield")
+ :group 'bbdb-utilities-pgp)
+
+(defcustom bbdb-pgp-default nil
+ "Default action when sending a message and the recipients are not in BBDB.
+This should be one of the following symbols:
+ nil Do nothing
+ sign Sign the message
+ sign-query Query whether to sign the message
+ encrypt Encrypt the message
+ encrypt-query Query whether to encrypt the message
+See info node `(message)security'."
+ :type '(choice
+ (const :tag "Do Nothing" nil)
+ (const :tag "Encrypt" encrypt)
+ (const :tag "Query encryption" encrypt-query)
+ (const :tag "Sign" sign)
+ (const :tag "Query signing" sign-query))
+ :group 'bbdb-utilities-pgp)
+
+(defcustom bbdb-pgp-ranked-actions
+ '(encrypt-query sign-query encrypt sign)
+ "Ranked list of actions when sending a message.
+If a message has multiple recipients such that their BBDB records specify
+different actions for this message, `bbdb-pgp' will perform the action
+which appears first in `bbdb-pgp-ranked-actions'.
+This list should include the following four symbols:
+ sign Sign the message
+ sign-query Query whether to sign the message
+ encrypt Encrypt the message
+ encrypt-query Query whether to encrypt the message."
+ :type '(repeat (symbol :tag "Action"))
+ :group 'bbdb-utilities-pgp)
+
+(defcustom bbdb-pgp-headers '("To" "Cc")
+ "Message headers to look at."
+ :type '(repeat (string :tag "Message header"))
+ :group 'bbdb-utilities-pgp)
+
+(defcustom bbdb-pgp-method 'pgpmime
+ "Method for signing and encrypting messages.
+It should be one of the keys of `bbdb-pgp-method-alist'.
+The default methods include
+ pgp Add MML tags for PGP format
+ pgpauto Add MML tags for PGP-auto format
+ pgpmime Add MML tags for PGP/MIME
+ smime Add MML tags for S/MIME
+See info node `(message)security'."
+ :type '(choice
+ (const :tag "MML PGP" pgp)
+ (const :tag "MML PGP-auto" pgpauto)
+ (const :tag "MML PGP/MIME" pgpmime)
+ (const :tag "MML S/MIME" smime)
+ (symbol :tag "Custom"))
+ :group 'bbdb-utilities-pgp)
+
+(defcustom bbdb-pgp-method-alist
+ '((pgp mml-secure-message-sign-pgp
+ mml-secure-message-encrypt-pgp)
+ (pgpmime mml-secure-message-sign-pgpmime
+ mml-secure-message-encrypt-pgpmime)
+ (smime mml-secure-message-sign-smime
+ mml-secure-message-encrypt-smime)
+ (pgpauto mml-secure-message-sign-pgpauto
+ mml-secure-message-encrypt-pgpauto))
+ "Alist of methods for signing and encrypting a message with `bbdb-pgp'.
+Each method is a list (KEY SIGN ENCRYPT).
+The symbol KEY identifies the method. The function SIGN signs the message;
+the function ENCRYPT encrypts it. These functions take no arguments.
+The default methods include
+ pgp Add MML tags for PGP format
+ pgpauto Add MML tags for PGP-auto format
+ pgpmime Add MML tags for PGP/MIME
+ smime Add MML tags for S/MIME
+See info node `(message)security'."
+ :type '(repeat (list (symbol :tag "Key")
+ (symbol :tag "Sign method")
+ (symbol :tag "Encrypt method")))
+ :group 'bbdb-utilities-pgp)
+
+;;;###autoload
+(defun bbdb-read-xfield-pgp-mail (&optional init)
+ "Set `bbdb-pgp-field', requiring match with `bbdb-pgp-ranked-actions'."
+ (bbdb-read-string "PGP action: " init
+ (mapcar 'list bbdb-pgp-ranked-actions) t))
+
+;;;###autoload
+(defun bbdb-pgp ()
+ "Add PGP MML tags to a message according to the recipients' BBDB records.
+For all message recipients in `bbdb-pgp-headers', this grabs the action
+in `bbdb-pgp-field' of their BBDB records. If this proposes multiple actions,
+perform the action which appears first in `bbdb-pgp-ranked-actions'.
+If this proposes no action at all, use `bbdb-pgp-default'.
+The variable `bbdb-pgp-method' defines the method which is actually used
+for signing and encrypting.
+
+This command works with both `mail-mode' and `message-mode' to send
+signed or encrypted mail.
+
+To run this command automatically when sending a message,
+use `bbdb-initialize' with arg `pgp' to add this function
+to `message-send-hook' and `mail-send-hook'.
+Yet see info node `(message)Signing and encryption' why you
+might not want to rely for encryption on a hook function
+which runs just before the message is sent, that is, you might want
+to call the command `bbdb-pgp' manually, then call `mml-preview'."
+ (interactive)
+ (save-excursion
+ (save-restriction
+ (widen)
+ (message-narrow-to-headers)
+ (when mail-aliases
+ ;; (sendmail-sync-aliases) ; needed?
+ (expand-mail-aliases (point-min) (point-max)))
+ (let ((actions
+ (or (delq nil
+ (delete-dups
+ (mapcar
+ (lambda (record)
+ (bbdb-record-xfield-intern record bbdb-pgp-field))
+ (delete-dups
+ (apply 'nconc
+ (mapcar
+ (lambda (address)
+ (bbdb-message-search (car address)
+ (cadr address)))
+ (bbdb-extract-address-components
+ (mapconcat
+ (lambda (header)
+ (mail-fetch-field header nil t))
+ bbdb-pgp-headers ", ")
+ t)))))))
+ (and bbdb-pgp-default
+ (list bbdb-pgp-default)))))
+ (when actions
+ (widen) ; after analyzing the headers
+ (let ((ranked-actions bbdb-pgp-ranked-actions)
+ action)
+ (while ranked-actions
+ (if (memq (setq action (pop ranked-actions)) actions)
+ (cond ((or (eq action 'sign)
+ (and (eq action 'sign-query)
+ (y-or-n-p "Sign message? ")))
+ (funcall (nth 1 (assq bbdb-pgp-method
+ bbdb-pgp-method-alist)))
+ (setq ranked-actions nil))
+ ((or (eq action 'encrypt)
+ (and (eq action 'encrypt-query)
+ (y-or-n-p "Encrypt message? ")))
+ (funcall (nth 2 (assq bbdb-pgp-method
+ bbdb-pgp-method-alist)))
+ (setq ranked-actions nil)))))))))))
+
+(provide 'bbdb-pgp)
+
+;;; bbdb-pgp.el ends here
--- /dev/null
+;;; bbdb-rmail.el --- BBDB interface to Rmail -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;; This file contains the BBDB interface to Rmail.
+;;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+(require 'bbdb-mua)
+(require 'rmail)
+(require 'rmailsum)
+(require 'mailheader)
+
+;;;###autoload
+(defun bbdb/rmail-header (header)
+ "Pull HEADER out of Rmail header."
+ (with-current-buffer rmail-buffer
+ (save-restriction
+ (with-no-warnings (rmail-narrow-to-non-pruned-header))
+ (mail-header (intern-soft (downcase header))
+ (mail-header-extract)))))
+
+;;;###autoload
+(defun bbdb-insinuate-rmail ()
+ "Hook BBDB into RMAIL.
+Do not call this in your init file. Use `bbdb-initialize'."
+ ;; Do we need keybindings for more commands? Suggestions welcome.
+ ;; (define-key rmail-mode-map ":" 'bbdb-mua-display-records)
+ ;; (define-key rmail-mode-map "'" 'bbdb-mua-display-recipients)
+ (define-key rmail-mode-map ":" 'bbdb-mua-display-sender)
+ (define-key rmail-mode-map ";" 'bbdb-mua-edit-field-sender)
+ ;; (define-key rmail-mode-map ";" 'bbdb-mua-edit-field-recipients)
+ (define-key rmail-summary-mode-map ":" 'bbdb-mua-display-sender)
+ (define-key rmail-summary-mode-map ";" 'bbdb-mua-edit-field-sender))
+
+(provide 'bbdb-rmail)
+
+;;; bbdb-rmail.el ends here
--- /dev/null
+;;; bbdb-site.el --- site-specific variables for BBDB -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Code:
+
+(defconst bbdb-version "@PACKAGE_VERSION@" "Version of BBDB.")
+
+(if (< emacs-major-version 24)
+ (error "BBDB %s requires GNU Emacs 24 or later" bbdb-version))
+
+(defcustom bbdb-tex-path
+ (let* ((default "@pkgdatadir@")
+ (dir (cond ((file-accessible-directory-p default)
+ default)
+ (load-file-name
+ (expand-file-name "tex/" (file-name-directory load-file-name)))
+ (t
+ (let ((f (locate-file "tex/bbdb.sty" load-path)))
+ (if f (file-name-directory f)))))))
+ (if dir (list dir)))
+ "List of directories with the BBDB TeX files.
+If this is t assume that these files reside in directories
+that are part of the regular TeX search path."
+ :group 'bbdb-utilities-tex
+ :type '(choice (const :tag "Files in TeX path" t)
+ (repeat (directory :tag "Directory"))))
+
+(provide 'bbdb-site)
+
+;;; bbdb-site.el ends here
--- /dev/null
+;;; bbdb-snarf.el --- convert free-form text to BBDB records -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; The commands `bbdb-snarf', `bbdb-snarf-yank' and `bbdb-snarf-paragraph'
+;; create BBDB records by picking the name, addresses, phones, etc.
+;; out of a (buffer) string. Things are recognized by context (e.g., URLs
+;; start with http:// or www.). See `bbdb-snarf-rule-alist' for details.
+;;
+;; The rule `eu' should work out of the box for many continental
+;; European countries. It can be further customized by defining
+;; a suitable postcode regexp passed to `bbdb-snarf-address-eu'.
+;; `mail' is a simple rule that can pick a single mail address from,
+;; say, a long list of mail addresses in a message.
+;;
+;; RW: `bbdb-snarf' is an interesting proof of concept. Yet I find
+;; its snarfing algorithms often too simplistic to be useful in real life.
+;; How can this possibly be improved? Suggestions welcome.
+
+;;; Code:
+
+(require 'bbdb-com)
+
+(defcustom bbdb-snarf-rule-alist
+ '((us bbdb-snarf-surrounding-space
+ bbdb-snarf-phone-nanp
+ bbdb-snarf-url
+ bbdb-snarf-mail
+ bbdb-snarf-empty-lines
+ bbdb-snarf-name
+ bbdb-snarf-address-us
+ bbdb-snarf-empty-lines
+ bbdb-snarf-notes
+ bbdb-snarf-name-mail) ; currently useless
+ (eu bbdb-snarf-surrounding-space
+ bbdb-snarf-phone-eu
+ bbdb-snarf-url
+ bbdb-snarf-mail
+ bbdb-snarf-empty-lines
+ bbdb-snarf-name
+ bbdb-snarf-address-eu
+ bbdb-snarf-empty-lines
+ bbdb-snarf-notes
+ bbdb-snarf-name-mail) ; currently useless
+ (mail bbdb-snarf-mail-address))
+ "Alist of rules for snarfing.
+Each rule is of the form (KEY FUNCTION FUNCTION ...).
+The symbol KEY identifies the rule, see also `bbdb-snarf-rule-default'.
+
+Snarfing is a cumulative process. The text is copied to a temporary
+snarf buffer that becomes current during snarfing.
+Each FUNCTION is called with one arg, the RECORD we are snarfing,
+and with point at the beginning of the snarf buffer. FUNCTION should populate
+the fields of RECORD. It may delete the part of the snarf buffer
+that it has processed so that the remaining FUNCTIONs operate only
+on those parts that were not yet snarfed. The order of the FUNCTION calls
+in a rule is then crucial.
+Unlike other parts of BBDB, FUNCTIONs need not update the cache and
+hash table for RECORD which is done at the end by `bbdb-snarf'."
+ :group 'bbdb-utilities-snarf
+ :type '(repeat (cons (symbol :tag "Key")
+ (repeat (function :tag "Snarf function")))))
+
+(defcustom bbdb-snarf-rule-default 'us
+ "Default rule for snarfing."
+ :group 'bbdb-utilities-snarf
+ :type 'symbol)
+
+(defcustom bbdb-snarf-name-regexp
+ "^[ \t'\"]*\\([- .,[:word:]]*[[:word:]]\\)"
+ "Regexp matching a name. Case is ignored.
+The first subexpression becomes the name."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defcustom bbdb-snarf-mail-regexp
+ (concat "\\(?:\\(?:mailto:\\|e?mail:?\\)[ \t]*\\)?"
+ "<?\\([^ \t\n<]+@[^ \t\n>]+\\)>?")
+ "Regexp matching a mail address. Case is ignored.
+The first subexpression becomes the mail address."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defcustom bbdb-snarf-phone-nanp-regexp
+ (concat "\\(?:phone:?[ \t]*\\)?"
+ "\\(\\(?:([2-9][0-9][0-9])[-. ]?\\|[2-9][0-9][0-9][-. ]\\)?"
+ "[0-9][0-9][0-9][-. ][0-9][0-9][0-9][0-9]"
+ "\\(?: *\\(?:x\\|ext\\.?\\) *[0-9]+\\)?\\)")
+ "Regexp matching a NANP phone number. Case is ignored.
+NANP is the North American Numbering Plan used in North and Central America.
+The first subexpression becomes the phone number."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defcustom bbdb-snarf-phone-eu-regexp
+ (concat "\\(?:phone?:?[ \t]*\\)?"
+ "\\(\\(?:\\+[1-9]\\|(\\)[-0-9()\s]+\\)")
+ "Regexp matching a European phone number.
+The first subexpression becomes the phone number."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defcustom bbdb-snarf-postcode-us-regexp
+ ;; US postcode appears at end of line
+ (concat "\\(\\<[0-9][0-9][0-9][0-9][0-9]"
+ "\\(-[0-9][0-9][0-9][0-9]\\)?"
+ "\\>\\)$")
+ "Regexp matching US postcodes.
+The first subexpression becomes the postcode."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defcustom bbdb-snarf-address-us-country nil
+ "Country to use for US addresses. If nil leave country blank."
+ :group 'bbdb-utilities-snarf
+ :type '(choice (const :tag "Leave blank" nil)
+ (string :tag "Country")))
+
+(defcustom bbdb-snarf-postcode-eu-regexp
+ "^\\([0-9][0-9][0-9][0-9][0-9]?\\)" ; four or five digits
+ "Regexp matching many European postcodes.
+`bbdb-snarf-address-eu' assumes that the address appears at the beginning
+of a line followed by the name of the city."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defcustom bbdb-snarf-address-eu-country nil
+ "Country to use for EU addresses. If nil leave country blank."
+ :group 'bbdb-utilities-snarf
+ :type '(choice (const :tag "Leave blank" nil)
+ (string :tag "Country")))
+
+(defcustom bbdb-snarf-default-label-alist
+ '((phone . "work") (address . "work"))
+ "Default labels for snarfing.
+This is an alist where each element is a cons pair (FIELD . LABEL).
+The symbol FIELD denotes a record field like `phone' or `address'.
+The string LABEL denotes the default label for FIELD."
+ :group 'bbdb-utilities-snarf
+ :type '(repeat (cons (symbol :tag "Field")
+ (string :tag "Label"))))
+
+(defcustom bbdb-snarf-url 'url
+ "What xfield BBDB should use for URLs, or nil to not snarf URLs."
+ :group 'bbdb-utilities-snarf
+ :type 'symbol)
+
+(defcustom bbdb-snarf-url-regexp "\\(\\(?:http://\\|www\\.\\)[^ \t\n]+\\)"
+ "Regexp matching a URL. Case is ignored.
+The first subexpression becomes the URL."
+ :group 'bbdb-utilities-snarf
+ :type 'regexp)
+
+(defun bbdb-snarf-surrounding-space (_record)
+ "Discard beginning and trailing space when snarfing RECORD."
+ (while (re-search-forward "^[ \t]+" nil t)
+ (replace-match ""))
+ (goto-char (point-min))
+ (while (re-search-forward "\\s-+$" nil t)
+ (replace-match "")))
+
+(defun bbdb-snarf-empty-lines (_record)
+ "Discard empty lines when snarfing RECORD."
+ (while (re-search-forward "^[ \t]*\n" nil t)
+ (replace-match "")))
+
+(defun bbdb-snarf-name (record)
+ "Snarf name for RECORD."
+ (if (and (not (bbdb-record-lastname record))
+ (let ((case-fold-search t))
+ (re-search-forward bbdb-snarf-name-regexp nil t)))
+ (let ((name (match-string 1)))
+ (replace-match "")
+ (setq name (bbdb-divide-name name))
+ (bbdb-record-set-firstname record (car name))
+ (bbdb-record-set-lastname record (cdr name)))))
+
+(defun bbdb-snarf-name-mail (record)
+ "Snarf name from mail address for RECORD."
+ ;; Fixme: This is currently useless because `bbdb-snarf-mail-regexp'
+ ;; cannot handle names in RFC 5322-like addresses "John Smith <foo@bar.com>".
+ (let ((name (bbdb-record-lastname record)))
+ (when (and (not name)
+ (bbdb-record-mail record)
+ (setq name (car (bbdb-extract-address-components
+ (car (bbdb-record-mail record)))))
+ (setq name (bbdb-divide-name name)))
+ (bbdb-record-set-firstname record (car name))
+ (bbdb-record-set-lastname record (cadr name)))))
+
+(defun bbdb-snarf-mail-address (record)
+ "Snarf name and mail address for RECORD."
+ ;; The voodoo of `mail-extract-address-components' makes
+ ;; the following quite powerful. If this function is used as part of
+ ;; a more complex rule, the buffer should be narrowed appropriately.
+ (let* ((data (bbdb-extract-address-components (buffer-string)))
+ (name (and (car data) (bbdb-divide-name (car data)))))
+ (bbdb-record-set-firstname record (car name))
+ (bbdb-record-set-lastname record (cdr name))
+ (bbdb-record-set-mail record (list (cadr data)))
+ (delete-region (point-min) (point-max))))
+
+(defun bbdb-snarf-mail (record)
+ "Snarf mail addresses for RECORD.
+This uses the first subexpresion of `bbdb-snarf-mail-regexp'."
+ (let ((case-fold-search t) mails)
+ (while (re-search-forward bbdb-snarf-mail-regexp nil t)
+ (push (match-string 1) mails)
+ (replace-match ""))
+ (bbdb-record-set-mail record (nconc (bbdb-record-mail record) mails))))
+
+(defun bbdb-snarf-label (field)
+ "Extract the label before point, or return default label for FIELD."
+ (save-match-data
+ (if (looking-back "\\(?:^\\|[,:]\\)\\([^\n,:]+\\):[ \t]*"
+ (line-beginning-position))
+ (prog1 (match-string 1)
+ (delete-region (match-beginning 1) (match-end 0)))
+ (cdr (assq field bbdb-snarf-default-label-alist)))))
+
+(defun bbdb-snarf-phone-nanp (record)
+ "Snarf NANP phone numbers for RECORD.
+NANP is the North American Numbering Plan used in North and Central America.
+This uses the first subexpresion of `bbdb-snarf-phone-nanp-regexp'."
+ (let ((case-fold-search t) phones)
+ (while (re-search-forward bbdb-snarf-phone-nanp-regexp nil t)
+ (goto-char (match-beginning 0))
+ (if (save-match-data
+ (looking-back "[0-9A-Z]" nil)) ;; not really an NANP phone number
+ (goto-char (match-end 0))
+ (push (vconcat (list (bbdb-snarf-label 'phone))
+ (save-match-data
+ (bbdb-parse-phone (match-string 1))))
+ phones)
+ (replace-match "")))
+ (bbdb-record-set-phone record (nconc (bbdb-record-phone record)
+ (nreverse phones)))))
+
+(defun bbdb-snarf-phone-eu (record &optional phone-regexp)
+ "Snarf European phone numbers for RECORD.
+PHONE-REGEXP is the regexp to match a phone number.
+It defaults to `bbdb-snarf-phone-eu-regexp'."
+ (let ((case-fold-search t) phones)
+ (while (re-search-forward (or phone-regexp
+ bbdb-snarf-phone-eu-regexp) nil t)
+ (goto-char (match-beginning 0))
+ (push (vector (bbdb-snarf-label 'phone)
+ (match-string 1))
+ phones)
+ (replace-match ""))
+ (bbdb-record-set-phone record (nconc (bbdb-record-phone record)
+ (nreverse phones)))))
+
+(defun bbdb-snarf-streets (address)
+ "Snarf streets for ADDRESS. This assumes a narrowed region."
+ (bbdb-address-set-streets address (bbdb-split "\n" (buffer-string)))
+ (delete-region (point-min) (point-max)))
+
+(defun bbdb-snarf-address-us (record)
+ "Snarf a US address for RECORD."
+ (let ((address (make-vector bbdb-address-length nil)))
+ (cond ((re-search-forward bbdb-snarf-postcode-us-regexp nil t)
+ ;; Streets, City, State Postcode
+ (save-restriction
+ (narrow-to-region (point-min) (match-end 0))
+ ;; Postcode
+ (goto-char (match-beginning 0))
+ (bbdb-address-set-postcode address
+ (bbdb-parse-postcode (match-string 1)))
+ ;; State
+ (skip-chars-backward " \t")
+ (let ((pos (point)))
+ (skip-chars-backward "^ \t,")
+ (bbdb-address-set-state address (buffer-substring (point) pos)))
+ ;; City
+ (skip-chars-backward " \t,")
+ (let ((pos (point)))
+ (beginning-of-line)
+ (bbdb-address-set-city address (buffer-substring (point) pos)))
+ ;; Toss it
+ (forward-char -1)
+ (delete-region (point) (point-max))
+ ;; Streets
+ (goto-char (point-min))
+ (bbdb-snarf-streets address)))
+ ;; Try for just Streets, City, State
+ ((let (case-fold-search)
+ (re-search-forward "^\\(.*\\), \\([A-Z][A-Za-z]\\)$" nil t))
+ (bbdb-address-set-city address (match-string 1))
+ (bbdb-address-set-state address (match-string 2))
+ (replace-match "")
+ (save-restriction
+ (narrow-to-region (point-min) (match-beginning 0))
+ (goto-char (point-min))
+ (bbdb-snarf-streets address))))
+ (when (bbdb-address-city address)
+ (if bbdb-snarf-address-us-country
+ (bbdb-address-set-country address bbdb-snarf-address-us-country))
+ ;; Fixme: There are no labels anymore. `bbdb-snarf-streets' snarfed
+ ;; everything that was left!
+ (bbdb-address-set-label address (bbdb-snarf-label 'address))
+ (bbdb-record-set-address record
+ (nconc (bbdb-record-address record)
+ (list address))))))
+
+(defun bbdb-snarf-address-eu (record &optional postcode-regexp country)
+ "Snarf a European address for RECORD.
+POSTCODE-REGEXP is a regexp matching the postcode assumed to appear
+at the beginning of a line followed by the name of the city. This format
+is used in many continental European countries.
+POSTCODE-REGEXP defaults to `bbdb-snarf-postcode-eu-regexp'.
+COUNTRY is the country to use. It defaults to `bbdb-snarf-address-eu-country'."
+ (when (re-search-forward (or postcode-regexp
+ bbdb-snarf-postcode-eu-regexp) nil t)
+ (let ((address (make-vector bbdb-address-length nil)))
+ (save-restriction
+ (goto-char (match-end 0))
+ (narrow-to-region (point-min) (line-end-position))
+ ;; Postcode
+ (bbdb-address-set-postcode address (match-string 1))
+ ;; City
+ (skip-chars-forward " \t")
+ (bbdb-address-set-city address (buffer-substring (point) (point-max)))
+ ;; Toss it
+ (delete-region (match-beginning 0) (point-max))
+ ;; Streets
+ (goto-char (point-min))
+ (bbdb-snarf-streets address))
+ (unless country (setq country bbdb-snarf-address-eu-country))
+ (if country (bbdb-address-set-country address country))
+ (bbdb-address-set-label address (bbdb-snarf-label 'address))
+ (bbdb-record-set-address record
+ (nconc (bbdb-record-address record)
+ (list address))))))
+
+(defun bbdb-snarf-url (record)
+ "Snarf URL for RECORD.
+This uses the first subexpresion of `bbdb-snarf-url-regexp'."
+ (when (and bbdb-snarf-url
+ (let ((case-fold-search t))
+ (re-search-forward bbdb-snarf-url-regexp nil t)))
+ (bbdb-record-set-xfields
+ record
+ (nconc (bbdb-record-xfields record)
+ (list (cons bbdb-snarf-url (match-string 1)))))
+ (replace-match "")))
+
+(defun bbdb-snarf-notes (record)
+ "Snarf notes for RECORD."
+ (when (/= (point-min) (point-max))
+ (bbdb-record-set-xfields
+ record
+ (nconc (bbdb-record-xfields record)
+ (list (cons bbdb-default-xfield (buffer-string)))))
+ (erase-buffer)))
+
+(defsubst bbdb-snarf-rule-interactive ()
+ "Read snarf rule interactively."
+ (intern
+ (completing-read
+ (format "Rule: (default `%s') " bbdb-snarf-rule-default)
+ bbdb-snarf-rule-alist nil t nil nil
+ (symbol-name bbdb-snarf-rule-default))))
+
+;;;###autoload
+(defun bbdb-snarf-paragraph (pos &optional rule)
+ "Snarf BBDB record from paragraph around position POS using RULE.
+The paragraph is the one that contains POS or follows POS.
+Interactively POS is the position of point.
+RULE defaults to `bbdb-snarf-rule-default'.
+See `bbdb-snarf-rule-alist' for details."
+ (interactive (list (point) (bbdb-snarf-rule-interactive)))
+ (bbdb-snarf (save-excursion
+ (goto-char pos)
+ ;; similar to `mark-paragraph'
+ (let ((end (progn (forward-paragraph 1) (point))))
+ (buffer-substring-no-properties
+ (progn (backward-paragraph 1) (point))
+ end)))
+ rule))
+
+;;;###autoload
+(defun bbdb-snarf-yank (&optional rule)
+ "Snarf a BBDB record from latest kill using RULE.
+The latest kill may also be a window system selection, see `current-kill'.
+RULE defaults to `bbdb-snarf-rule-default'.
+See `bbdb-snarf-rule-alist' for details."
+ (interactive (list (bbdb-snarf-rule-interactive)))
+ (bbdb-snarf (current-kill 0) rule))
+
+;;;###autoload
+(defun bbdb-snarf (string &optional rule)
+ "Snarf a BBDB record in STRING using RULE. Display and return this record.
+Interactively, STRING is the current region.
+RULE defaults to `bbdb-snarf-rule-default'.
+See `bbdb-snarf-rule-alist' for details."
+ (interactive
+ (list (buffer-substring-no-properties (region-beginning) (region-end))
+ (bbdb-snarf-rule-interactive)))
+
+ (bbdb-editable)
+ (let ((record (bbdb-empty-record)))
+ (with-current-buffer (get-buffer-create " *BBDB Snarf*")
+ (erase-buffer)
+ (insert (substring-no-properties string))
+ (mapc (lambda (fun)
+ (goto-char (point-min))
+ (funcall fun record))
+ (cdr (assq (or rule bbdb-snarf-rule-default)
+ bbdb-snarf-rule-alist))))
+ (let ((old-record (car (bbdb-message-search
+ (bbdb-concat 'name-first-last
+ (bbdb-record-firstname record)
+ (bbdb-record-lastname record))
+ (car (bbdb-record-mail record))))))
+ ;; Install RECORD after searching for OLD-RECORD
+ (bbdb-change-record record)
+ (if old-record (bbdb-merge-records old-record record)))
+ (bbdb-display-records (list record))
+ record))
+
+;; Some test cases
+;;
+;; US:
+;;
+;; another test person
+;; 1234 Gridley St.
+;; Los Angeles, CA 91342
+;; 555-1212
+;; test@person.net
+;; http://www.foo.bar/
+;; other stuff about this person
+;;
+;; test person
+;; 1234 Gridley St.
+;; St. Los Angeles, CA 91342-1234
+;; 555-1212
+;; <test@person.net>
+;;
+;; x test person
+;; 1234 Gridley St.
+;; Los Angeles, California 91342-1234
+;; work: 555-1212
+;; home: 555-1213
+;; test@person.net
+;;
+;; y test person
+;; 1234 Gridley St.
+;; Los Angeles, CA
+;; 555-1212
+;; test@person.net
+;;
+;; z test person
+;; 555-1212
+;; test@person.net
+;;
+;; EU:
+;;
+;; Maja Musterfrau
+;; Strasse 15
+;; 12345 Ort
+;; +49 12345
+;; phon: (110) 123 456
+;; mobile: (123) 456 789
+;; xxx.xxx@xxxx.xxx
+;; http://www.xxx.xx
+;; notes bla bla bla
+
+(provide 'bbdb-snarf)
+
+;;; bbdb-snarf.el ends here
--- /dev/null
+;;; bbdb-tex.el --- feed BBDB into LaTeX -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; Authors: Boris Goldowsky <boris@cs.rochester.edu>
+;; Dirk Grunwald <grunwald@cs.colorado.edu>
+;; Luigi Semenzato <luigi@paris.cs.berkeley.edu>
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; This file lets you feed BBDB into LaTeX.
+;; See the BBDB info manual for documentation.
+;;
+;; In the *BBDB* buffer, type M-x `bbdb-tex' to convert the listing
+;; to LaTeX format.
+;;
+;; TeX macros appearing in the output:
+;; \name{first}{last}
+;; \organization{foo bar}
+;; \affix{foo bar}
+;; \aka{foo bar}
+;; \phone{key}{123 456 7890}
+;; \address{key}{foo bar}
+;; \mail{foo@bar.com}{Smith <foo@bar.com>}
+;; \xfield{key}{value}
+;; Each macro may appear multiple times.
+;;
+;; The detailed grammar of the output is defined in `bbdb-tex-alist'.
+;; The output starts with a prolog where you can specify LaTeX packages
+;; and other customizations in the usual way. The above macros should get
+;; defined, too. By default, this happens in the style file bbdb.sty that
+;; is shipped with BBDB.
+;;
+;; The body of the output contains the BBDB records. Usually, the records
+;; are placed inside some "bbdb" environment. You can customize which fields
+;; of each record should appear in the listing and in which order.
+;; Also, you can put separators between individual fields. A separator macro
+;; can also separate records when the first character of the last name differs
+;; from the first character of the last name of the previous record.
+;; The listing ends with an epilog.
+
+;; A few notes on "advanced usage" of `bbdb-tex':
+;;
+;; It should be possible to use `bbdb-tex' with all the bells and whistles
+;; of LaTeX by loading the appropriate LaTeX style files and packages or
+;; embedding the output of `bbdb-tex' into more complex LaTeX documents.
+;; For this you can customize the rules in `bbdb-tex-alist' and use
+;; customized style files for interpreting the TeX macros used by `bbdb-tex'.
+;;
+;; Generally, lisp customizations for `bbdb-tex' are intended to provide control
+;; of *what* appears in the TeX listing. But there are no lisp customization
+;; options to control the actual layout that should be handled by LaTeX.
+;; BBDB is shipped with one basic LaTeX style file bbdb.sty to handle
+;; the TeX macros listed above. You should customize this LaTeX style file
+;; to match your taste and / or your needs. Note also that `bbdb-tex-alist'
+;; allows you to specify an arbitrary number of rules that may use different
+;; style files for the above TeX macros.
+
+;; Generally, it will be advantageous to make all relevant style files
+;; and packages known to LaTeX by putting them in the appropriate directories
+;; of your TeX installation. Likely, the user variable `bbdb-tex-path'
+;; should not be used in such advanced cases. The main purpose of the
+;; inlining mechanism provided via `bbdb-tex-path' is that we can ship
+;; and install BBDB without worrying about the tricky question where to
+;; (auto-) install the basic style file bbdb.sty shipped with BBDB so that
+;; TeX finds it. Most often, it will be best to manually install even bbdb.sty
+;; in a directory where TeX finds it and bind `bbdb-tex-path' to t to fully
+;; suppress the inlining.
+;;
+;; Before generating the TeX output, the field values of a record are massaged
+;; by `bbdb-tex-field' that passes these values by default to `bbdb-tex-replace',
+;; see also `bbdb-tex-replace-list'. Instead the user may also define functions
+;; `bbdb-tex-output-...' that take precedence, see `bbdb-tex-field'.
+;;
+;; `bbdb-tex' understands one new BBDB xfield: tex-name, see also
+;; `bbdb-tex-name'. If this xfield is defined for a record,
+;; this will be used for the TeXed listing instead of the name field
+;; of that record. The value of the xfield tex-name is used verbatim,
+;; it does not see `bbdb-tex-field' and `bbdb-tex-replace-list'.
+;;
+;;
+;; This program was adapted for BBDB by Boris Goldowsky
+;; <boris@cs.rochester.edu> and Dirk Grunwald
+;; <grunwald@cs.colorado.edu> using a TeX format designed by Luigi
+;; Semenzato <luigi@paris.cs.berkeley.edu>.
+;; We are also grateful to numerous people on the bbdb-info
+;; mailing list for suggestions and bug reports.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+
+;;; Variables:
+
+(defcustom bbdb-tex-name 'tex-name
+ "Xfield holding the name in TeX format.
+The string in this field gets split into first and last name
+using `bbdb-separator-alist'. The separator defaults to \"#\"."
+ :group 'bbdb-utilities-tex
+ :type '(symbol :tag "Xfield"))
+
+(defcustom bbdb-tex-alist
+ `((multi-line
+ (demand (or address phone))
+ (prolog ,(concat "\\documentclass{article}\n\\usepackage{bbdb}\n"
+ "\\usepackage{multicol}\n"
+ "\\begin{document}\n\\begin{multicols}{2}"))
+ (record "\\begin{bbdbrecord}" name organization ; affix aka
+ (address t) (phone t) (mail t)
+ (xfields t nil
+ (omit ,bbdb-tex-name mail-alias creation-date timestamp))
+ "\\end{bbdbrecord}\n")
+ (separator "\\bbdbseparator{%s}\n")
+ (epilog ,(concat "\\noindent\\hrulefill\\\\\nPrinted \\today\n"
+ "\\end{multicols}\n\\end{document}"))
+ (options (bbdb-tex-linebreak "\\\\\\\\\n")
+ (bbdb-tex-address-layout 2)))
+
+ (one-line
+ (demand phone)
+ (prolog ,(concat "\\documentclass{article}\n\\usepackage{bbdb}\n"
+ "\\begin{document}\n\\begin{bbdb}{llllll}"))
+ (record name "&" (organization 1) "&" (phone 2 "&") "&" (mail 1)
+ "&" (address 1) "\\\\")
+ (separator "\\bbdbseparator{%s}")
+ (epilog "\\end{bbdb}\n\\end{document}")
+ (options (bbdb-tex-linebreak ", ")
+ (bbdb-tex-address-layout 3)))
+
+ (phone
+ (demand phone)
+ (prolog ,(concat "\\documentclass{article}\n\\usepackage{bbdb}\n"
+ "\\begin{document}\n\\begin{bbdb}{ll}"))
+ (record name "&" (phone 2 "&") "\\\\")
+ (separator "\\bbdbseparator{%s}")
+ (epilog "\\end{bbdb}\n\\end{document}")
+ (options (bbdb-tex-linebreak ", ")
+ (bbdb-tex-address-layout 3)))
+
+ (example ; another rule with more examples
+ (demand (or address phone))
+ (prolog ,(concat "\\documentclass{article}\n\\usepackage{bbdb}\n"
+ "\\usepackage{multicol}\n"
+ "\\begin{document}\n\\begin{multicols}{2}"))
+ (record "\\begin{bbdbrecord}" name organization
+ (address 1 nil (omit "work"))
+ (phone 2 nil (admit "home" "cell"))
+ (mail t)
+ (birthday t)
+ (xfields t nil
+ (omit ,bbdb-tex-name mail-alias creation-date timestamp))
+ "\\end{bbdbrecord}\n")
+ (separator "\\bbdbseparator{%s}\n")
+ (epilog ,(concat "\\noindent\\hrulefill\\\\\nPrinted \\today\n"
+ "\\end{multicols}\n\\end{document}"))
+ (options (bbdb-tex-linebreak "\\\\\\\\\n")
+ (bbdb-tex-address-layout 2))))
+
+ "Alist of rules for passing BBDB to LaTeX.
+Each rule has the form (RULE LIST1 LIST2 ...).
+The symbol RULE identifies the rule.
+The remainder are lists LIST that should have one of these forms:
+
+ (demand FORM)
+
+ Here FORM is a lisp expression. A record will be TeXed only
+ if evaluating FORM yields a non-nil value for this record.
+ When FORM is evaluated, the symbols name, affix, organization, mail,
+ phone, address, and xfields are set to the corresponding values
+ of this record; these symbols are nil if the respective field
+ does not exist for this record.
+
+ (prolog STRING)
+
+ The string STRING is inserted at the beginning of the buffer.
+ If STRING contains the substring \"\\usepackage{foo}\" and
+ a file \"foo.sty\" exists within `bbdb-tex-path', replace
+ \"\\usepackage{foo}\" with the content of the file \"foo.sty\",
+ surrounded by \"\\makeatletter\" and \"\\makeatother\".
+ Note: This fails with more sophisticated LaTeX style files
+ using, e.g., optional arguments for the \"\\usepackage\" macro.
+
+ (record ELT1 ELT2 ...)
+
+ Here ELT may be one of the following:
+
+ IF ELT is name, this expands to \"\\name{first}{last}\"
+
+ If ELT is affix, organization, or aka, ELT expands to \"\\ELT{value}\".
+ Here the elements of ELT are concatenated to get one value.
+
+ If ELT is the key of an xfield, ELT expands to \"\\xfield{ELT}{value}\".
+
+ If ELT is a string, this is inserted \"as is\" in the TeX buffer.
+
+ ELT may also be a loop (FLD COUNT [SEPARATOR] [OPT...])
+ looping over the values of FLD.
+
+ If FLD is mail, this expands to \"\\mail{short}{long}\",
+ such as \"\\mail{foo@bar.com}{Smith <foo@bar.com>}\",
+ If FLD is phone, this expands to \"\\phone{key}{number}\"
+ If FLD is address, this expands to \"\\address{key}{value}\".
+ If FLD is xfields, this expands to \"\\xfield{key}{value}\".
+ If FLD is the key of an xfield, split the value of FLD
+ using `bbdb-separator-alist' to generate a list of values,
+ which then expand to \"\\xfield{FLD}{value}\".
+
+ If COUNT is a number, process at most COUNT values of FLD.
+ IF COUNT is t, process all values of FLD.
+
+ If SEPARATOR is non-nil, it is a string that is inserted between
+ the values of FLD. Insert COUNT - 1 instances of SEPARATOR,
+ even if there are fewer values of FLD.
+
+ If FLD is mail, phone, address, or xfields,
+ OPT may be a list (admit KEY ...) or (omit KEY ...).
+ Then a value is admitted or omitted if its key KEY is listed here.
+
+ (separator STRING)
+
+ When the first letter of the records' sortkey increases compared with
+ the previous record in the TeX listing, the new letter is formatted
+ using the format string STRING to generate a separator macro.
+
+ (epilog STRING)
+
+ The string STRING is inserted at the end of the buffer."
+ :group 'bbdb-utilities-tex)
+
+(defcustom bbdb-tex-rule-default 'multi-line
+ "Default rule for BBDB tex.
+This symbol should be a key in `bbdb-tex-alist'."
+ :group 'bbdb-utilities-tex
+ :type '(symbol :tag "rule"))
+
+;; FIXME
+;; (defcustom bbdb-tex-empty-fields nil
+;; "If non-nil generate TeX output even for empty fields."
+;; :group 'bbdb-utilities-tex)
+
+(defcustom bbdb-tex-replace-list
+ '(("[#$%&_]" . "\\\\\\&")
+ ("<" . "\\\\textless ")
+ (">" . "\\\\textgreater ")
+ ("~" . "\\\\textasciitilde ")
+ ("{" . "\\\\textbraceleft ")
+ ("}" . "\\\\textbraceright "))
+ "Replacement list for TeX's special characters.
+Each element is of the form (REGEXP . REPLACE)."
+ :group 'bbdb-utilities-tex
+ :type '(repeat (cons regexp string)))
+
+(defcustom bbdb-tex-linebreak "\\\\\\\\\n"
+ "Replacement for linebreaks."
+ :group 'bbdb-utilities-tex
+ :type 'string)
+
+(defcustom bbdb-tex-address-format-list bbdb-address-format-list
+ "List of address formatting rules for `bbdb-tex'.
+Each element may take the same values as in `bbdb-address-format-list'.
+The elements EDIT of `bbdb-address-format-list' are ignored."
+ :group 'bbdb-utilities-tex
+ :type '(repeat (list (choice (const :tag "Default" t)
+ (function :tag "Function")
+ (repeat (string)))
+ (choice (string)
+ (function :tag "Function"))
+ (choice (string)
+ (function :tag "Function"))
+ (choice (string)
+ (function :tag "Function")))))
+
+(defcustom bbdb-tex-address-layout 2
+ "Address layout according to `bbdb-tex-address-format-list'.
+2 is multi-line layout, 3 is one-line layout."
+ :group 'bbdb-utilities-tex)
+
+(defcustom bbdb-tex-file "~/bbdb.tex"
+ "Default file name for TeXing BBDB."
+ :group 'bbdb-utilities-tex
+ :type 'file)
+
+;;; Internal variables
+
+(defvar bbdb-tex-rule-last bbdb-tex-rule-default
+ "Last rule used for TeXing BBDB.")
+
+(defvar bbdb-tex-file-last bbdb-tex-file
+ "Last used TeX file")
+
+;;; Functions:
+
+;; While we use `bbdb-tex-replace' only once in `bbdb-tex-field',
+;; we keep it as a separate function so that it can also be used
+;; inside user-defined functions `bbdb-tex-output-...'.
+(defun bbdb-tex-replace (string)
+ "Apply replacement rules `bbdb-tex-replace-list' to STRING.
+Also, replace linebreaks by `bbdb-tex-linebreak'."
+ (if (not string)
+ ""
+ (dolist (elt bbdb-tex-replace-list)
+ (setq string (replace-regexp-in-string (car elt) (cdr elt) string)))
+ (replace-regexp-in-string "\n" bbdb-tex-linebreak string)))
+
+(defun bbdb-tex-field (field str)
+ "Massage string STR for LaTeX.
+By default, STR is passed to `bbdb-tex-replace'.
+The user may also define a function `bbdb-tex-output-FIELD'
+that takes precedence."
+ (let ((fun (intern-soft (format "bbdb-tex-output-%s" field))))
+ (if fun
+ (funcall fun str)
+ (bbdb-tex-replace str))))
+
+(defun bbdb-tex-list (list rule fun)
+ "Use function FUN to generate output for LIST according to RULE.
+LIST is a list of field values such as a list of addresses.
+RULE is an element of a record list as in `bbdb-tex-alist'
+used to select the elements of LIST that get processed by calling FUN."
+ (let ((admit (cdr (assq 'admit rule)))
+ (omit (cdr (assq 'omit rule)))
+ (num (if (numberp (nth 1 rule)) (nth 1 rule)))
+ (sep (if (nth 2 rule) (concat (nth 2 rule) "\n")))
+ (i -1)
+ new-list elt)
+
+ ;; Select the relevant elements of LIST.
+ (cond (admit
+ (dolist (l list)
+ (if (member (elt l 0) admit)
+ (push l new-list)))
+ (setq new-list (nreverse new-list)))
+
+ (omit
+ (dolist (l list)
+ (unless (member (elt l 0) omit)
+ (push l new-list)))
+ (setq new-list (nreverse new-list)))
+
+ (t
+ (setq new-list list)))
+
+ (cond ((not num)
+ (insert (mapconcat fun new-list (or sep ""))))
+ ((not sep)
+ (while (and (< (setq i (1+ i)) num)
+ (setq elt (pop new-list)))
+ (insert (funcall fun elt))))
+ (t
+ (while (< (setq i (1+ i)) num)
+ (if (setq elt (pop new-list))
+ (insert (funcall fun elt)))
+ (if (< (1+ i) num)
+ (insert sep)))))))
+
+;;;###autoload
+(defun bbdb-tex (records file rule)
+ "Generate FILE for TeXing RECORDS.
+Interactively, use BBDB prefix \
+\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
+RULE should be an element of `bbdb-tex-alist'."
+ (interactive
+ (list (bbdb-do-records)
+ (read-file-name
+ (format "TeX file: (default %s) "
+ (abbreviate-file-name bbdb-tex-file-last))
+ (file-name-directory bbdb-tex-file-last)
+ bbdb-tex-file-last)
+ (intern (completing-read (format "Rule: (default %s) "
+ bbdb-tex-rule-last)
+ bbdb-tex-alist nil t
+ nil nil (symbol-name bbdb-tex-rule-last)))))
+ ;; Remember our choice for `bbdb-tex-file-last'.
+ (setq bbdb-tex-file-last (expand-file-name file))
+
+ (find-file bbdb-tex-file-last)
+ (let* ((buffer-undo-list t)
+ (rule (assq rule bbdb-tex-alist))
+ (demand (nth 1 (assq 'demand rule)))
+ (separator (nth 1 (assq 'separator rule)))
+ current-letter p-symbols p-values)
+ (erase-buffer)
+
+ ;; Options
+ (dolist (option (cdr (assq 'options rule)))
+ (push (car option) p-symbols)
+ (push (cadr option) p-values))
+ (cl-progv p-symbols p-values
+
+ ;; Prolog
+ (let ((prolog (nth 1 (assq 'prolog rule))))
+ (when prolog
+ (insert prolog)
+ (when (consp bbdb-tex-path)
+ (goto-char (point-min))
+ (while (re-search-forward "\\\\usepackage[ \t\n]*{\\([^}]+\\)}" nil t)
+ (let ((sty (locate-file (match-string 1) bbdb-tex-path '(".sty"))))
+ (when sty
+ (replace-match (format "\n\\\\makeatletter\n%% begin %s\n%% end %s\n\\\\makeatother\n" sty sty))
+ (save-excursion
+ (forward-line -2)
+ (insert-file-contents sty))))))
+ (goto-char (point-max))
+ (unless (bolp) (insert "\n"))
+ (insert "% end BBDB prolog\n")))
+
+ ;; Process Records
+ (dolist (record (bbdb-record-list records))
+ (let* ((first-letter
+ (substring (bbdb-record-sortkey record) 0 1))
+ (firstname (bbdb-record-firstname record))
+ (lastname (bbdb-record-lastname record))
+ (name (bbdb-record-name record))
+ (name-lf (bbdb-record-name-lf record))
+ (organization (bbdb-record-organization record))
+ (affix (bbdb-record-affix record))
+ (aka (bbdb-record-aka record))
+ (mail (bbdb-record-mail record))
+ (phone (bbdb-record-phone record))
+ (address (bbdb-record-address record))
+ (xfields (bbdb-record-xfields record))
+ (lex-env `((firstname . ,firstname) (lastname . ,lastname)
+ (name . ,name) (name-lf . ,name-lf) (aka . ,aka)
+ (organization . ,organization) (affix . ,affix)
+ (mail . ,mail) (phone . ,phone)
+ (address . ,address) (xfields . ,xfields)))
+ (bbdb-address-format-list bbdb-tex-address-format-list))
+
+ ;; A record is processed only if the form DEMAND
+ ;; evaluates to a non-nil value.
+ (when (or (not demand)
+ (eval demand lex-env))
+
+ ;; Separator
+ (if (and separator
+ (not (and current-letter
+ (equal first-letter current-letter))))
+ (insert (format separator (upcase first-letter)) "\n"))
+ (setq current-letter first-letter)
+
+ (dolist (elt (cdr (assq 'record rule)))
+ (cond ((stringp elt)
+ (insert elt "\n"))
+
+ ((eq elt 'name) ; name of record
+ (let ((tex-name (and bbdb-tex-name
+ (bbdb-record-field record bbdb-tex-name)))
+ (fmt "\\name{%s}{%s}\n"))
+ (if tex-name
+ (let ((first-last (bbdb-split bbdb-tex-name tex-name)))
+ (cond ((eq 2 (length first-last))
+ (insert (format fmt (car first-last) (cadr first-last))))
+ ((eq 1 (length first-last))
+ (insert (format fmt "" (car first-last))))
+ (t (error "TeX name %s cannot be split" tex-name))))
+ (insert (format fmt
+ (bbdb-tex-field 'firstname firstname)
+ (bbdb-tex-field 'lastname lastname))))))
+
+ ;; organization, affix or aka as single string
+ ((memq elt '(organization affix aka))
+ (let ((val (bbdb-record-field record elt)))
+ (if val
+ (insert (format "\\%s{%s}\n" elt
+ (bbdb-tex-field elt (bbdb-concat elt val)))))))
+
+ ;; organization, affix or aka as list of strings
+ ((memq (car elt) '(organization affix aka))
+ (bbdb-tex-list
+ (bbdb-record-field record (car elt))
+ elt
+ `(lambda (o)
+ (format "\\%s{%s}\n" ',(car elt)
+ (bbdb-tex-field ',(car elt) o)))))
+
+ ((eq (car elt) 'mail) ; mail
+ (bbdb-tex-list
+ mail elt
+ (lambda (m)
+ (format "\\mail{%s}{%s}\n"
+ ;; No processing of plain mail address
+ (nth 1 (bbdb-decompose-bbdb-address m))
+ (bbdb-tex-field 'mail m)))))
+
+ ((eq (car elt) 'address) ; address
+ (bbdb-tex-list
+ address elt
+ (lambda (a)
+ (format "\\address{%s}{%s}\n"
+ (bbdb-tex-field 'address-label (bbdb-address-label a))
+ (bbdb-tex-field 'address (bbdb-format-address
+ a bbdb-tex-address-layout))))))
+
+ ((eq (car elt) 'phone) ; phone
+ (bbdb-tex-list
+ phone elt
+ (lambda (p)
+ (format "\\phone{%s}{%s}\n"
+ (bbdb-tex-field 'phone-label (bbdb-phone-label p))
+ (bbdb-tex-field 'phone (bbdb-phone-string p))))))
+
+ ((eq (car elt) 'xfields) ; list of xfields
+ (bbdb-tex-list
+ (bbdb-record-field record 'xfields)
+ elt
+ (lambda (x)
+ (format "\\xfield{%s}{%s}\n"
+ (bbdb-tex-field 'xfield-label (symbol-name (car x)))
+ (bbdb-tex-field 'xfield (cdr x))))))
+
+ ((symbolp elt) ; xfield as single string
+ ;; The value of an xfield may be a sexp instead of a string.
+ ;; Ideally, a sexp should be formatted by `pp-to-string',
+ ;; then printed verbatim.
+ (let ((val (format "%s" (bbdb-record-field record elt))))
+ (if val
+ (insert (format "\\xfield{%s}{%s}\n" elt
+ (bbdb-tex-field elt (bbdb-concat elt val)))))))
+
+ ((consp elt) ; xfield as list of strings
+ (bbdb-tex-list
+ (bbdb-split (car elt)
+ (format "%s" (bbdb-record-field record (car elt))))
+ elt
+ `(lambda (x)
+ (format "\\xfield{%s}{%s}\n" ',(car elt)
+ (bbdb-tex-field ',(car elt) x)))))
+
+ (t (error "Rule `%s' undefined" elt)))))))
+
+ ;; Epilog
+ (let ((epilog (nth 1 (assq 'epilog rule))))
+ (when epilog
+ (insert "% begin BBDB epilog\n" epilog)
+ (unless (bolp) (insert "\n"))))))
+ (setq buffer-undo-list nil)
+ (save-buffer))
+
+(provide 'bbdb-tex)
+
+;;; bbdb-tex.el ends here
--- /dev/null
+;;; bbdb-vm.el --- BBDB interface to VM -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;; This file contains the BBDB interface to VM.
+;;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-com)
+(require 'bbdb-mua)
+(require 'vm-autoloads)
+(require 'vm-motion)
+(require 'vm-summary)
+(require 'vm-mime)
+(require 'vm-vars)
+(require 'vm-macro)
+(require 'vm-message)
+(require 'vm-misc)
+
+;;;###autoload
+(defun bbdb/vm-header (header)
+ (save-current-buffer
+ (vm-select-folder-buffer)
+ (vm-get-header-contents (car vm-message-pointer)
+ (concat header ":"))))
+
+;;;###autoload
+(defun bbdb-insinuate-vm ()
+ "Hook BBDB into VM.
+Do not call this in your init file. Use `bbdb-initialize'."
+ (define-key vm-mode-map ":" 'bbdb-mua-display-records)
+ (define-key vm-mode-map "`" 'bbdb-mua-display-sender)
+ (define-key vm-mode-map "'" 'bbdb-mua-display-recipients)
+ (define-key vm-mode-map ";" 'bbdb-mua-edit-field-sender)
+ ;; Do we need keybindings for more commands? Suggestions welcome.
+ ;; (define-key vm-mode-map "'" 'bbdb-mua-edit-field-recipients)
+ (define-key vm-mode-map "/" 'bbdb)
+ ;; `mail-mode-map' is the parent of `vm-mail-mode-map'.
+ ;; So the following is also done by `bbdb-insinuate-mail'.
+ (if (and bbdb-complete-mail (boundp 'vm-mail-mode-map))
+ (define-key vm-mail-mode-map "\M-\t" 'bbdb-complete-mail))
+
+ ;; Set up user field for use in `vm-summary-format'
+ ;; (1) Big solution: use whole name
+ (if bbdb-mua-summary-unify-format-letter
+ (fset (intern (concat "vm-summary-function-"
+ bbdb-mua-summary-unify-format-letter))
+ (lambda (m) (bbdb-mua-summary-unify
+ ;; VM does not give us the original From header.
+ ;; So we have to work backwards.
+ (let ((name (vm-decode-mime-encoded-words-in-string
+ (vm-su-interesting-full-name m)))
+ (mail (vm-su-from m)))
+ (if (string= name mail) mail
+ (format "\"%s\" <%s>" name mail)))))))
+
+ ;; (2) Small solution: a mark for messages whos sender is in BBDB.
+ (if bbdb-mua-summary-mark-format-letter
+ (fset (intern (concat "vm-summary-function-"
+ bbdb-mua-summary-mark-format-letter))
+ ;; VM does not give us the original From header.
+ ;; So we assume that the mail address is sufficient to identify
+ ;; the BBDB record of the sender.
+ (lambda (m) (bbdb-mua-summary-mark (vm-su-from m))))))
+
+(provide 'bbdb-vm)
+
+;;; bbdb-vm.el ends here
--- /dev/null
+;;; bbdb-wl.el --- BBDB interface to Wanderlust -*- lexical-binding: t -*-
+
+;; Copyright (C) 2015-2017 Free Software Foundation, Inc.
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; This file contains the BBDB interface to Wl.
+;; See the BBDB info manual for documentation.
+
+;;; Code:
+
+(require 'bbdb)
+(require 'bbdb-mua)
+
+(defvar wl-summary-mode-map)
+(defvar wl-draft-mode-map)
+(defvar wl-summary-buffer-elmo-folder)
+(eval-and-compile
+ (autoload 'wl-summary-message-number "wl-summary")
+ (autoload 'elmo-message-entity "elmo-msgdb")
+ (autoload 'elmo-message-entity-field "elmo-msgdb"))
+
+;;;###autoload
+(defun bbdb/wl-header (header)
+ (elmo-message-entity-field
+ (elmo-message-entity wl-summary-buffer-elmo-folder
+ (wl-summary-message-number))
+ (intern (downcase header)) 'string))
+
+;;;###autoload
+(defun bbdb-insinuate-wl ()
+ "Hook BBDB into Wanderlust."
+ (define-key wl-summary-mode-map (kbd ":") #'bbdb-mua-display-sender)
+ (define-key wl-summary-mode-map (kbd ";") #'bbdb-mua-edit-field-sender)
+ (when bbdb-complete-mail
+ (define-key wl-draft-mode-map (kbd "M-;") #'bbdb-complete-mail)
+ (define-key wl-draft-mode-map (kbd "M-<tab>") #'bbdb-complete-mail)))
+
+(provide 'bbdb-wl)
+
+;;; bbdb-wl.el ends here
--- /dev/null
+;;; bbdb.el --- core of BBDB -*- lexical-binding: t -*-
+
+;; Copyright (C) 2010-2017 Free Software Foundation, Inc.
+
+;; Version: 3.2
+;; Package-Requires: ((emacs "24"))
+
+;; This file is part of the Insidious Big Brother Database (aka BBDB),
+
+;; BBDB is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; BBDB is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; This file is the core of the Insidious Big Brother Database (aka BBDB),
+;; See the BBDB info manual for documentation.
+;;
+;; -----------------------------------------------------------------------
+;; | There is a mailing list for discussion of BBDB: |
+;; | bbdb-user@nongnu.org |
+;; | To join, go to https://lists.nongnu.org/mailman/listinfo/bbdb-user |
+;; | |
+;; | When joining this list or reporting bugs, please mention which |
+;; | version of BBDB you have. |
+;; -----------------------------------------------------------------------
+
+;;; Code:
+
+(require 'timezone)
+(require 'bbdb-site)
+
+;; When running BBDB, we have (require 'bbdb-autoloads)
+(declare-function widget-group-match "wid-edit")
+(declare-function bbdb-migrate "bbdb-migrate")
+(declare-function bbdb-do-records "bbdb-com")
+(declare-function bbdb-append-display-p "bbdb-com")
+(declare-function bbdb-toggle-records-layout "bbdb-com")
+(declare-function bbdb-dwim-mail "bbdb-com")
+(declare-function bbdb-layout-prefix "bbdb-com")
+(declare-function bbdb-completing-read-records "bbdb-com")
+(declare-function bbdb-merge-records "bbdb-com")
+(declare-function mail-position-on-field "sendmail")
+(declare-function vm-select-folder-buffer "vm-folder")
+
+;; cannot use autoload for variables...
+(defvar message-mode-map) ;; message.el
+(defvar mail-mode-map) ;; sendmail.el
+(defvar gnus-article-buffer) ;; gnus-art.el
+
+;; Custom groups
+
+(defgroup bbdb nil
+ "The Insidious Big Brother Database."
+ :group 'news
+ :group 'mail)
+
+(defgroup bbdb-record-display nil
+ "Variables that affect the display of BBDB records"
+ :group 'bbdb)
+
+(defgroup bbdb-record-edit nil
+ "Variables that affect the editing of BBDB records"
+ :group 'bbdb)
+
+(defgroup bbdb-sendmail nil
+ "Variables that affect sending mail."
+ :group 'bbdb)
+
+(defgroup bbdb-mua nil
+ "Variables that specify the BBDB-MUA interface"
+ :group 'bbdb)
+
+(defgroup bbdb-mua-gnus nil
+ "Gnus-specific BBDB customizations"
+ :group 'bbdb-mua)
+(put 'bbdb-mua-gnus 'custom-loads '(bbdb-gnus))
+
+(defgroup bbdb-mua-gnus-scoring nil
+ "Gnus-specific scoring BBDB customizations"
+ :group 'bbdb-mua-gnus)
+(put 'bbdb-mua-gnus-scoring 'custom-loads '(bbdb-gnus))
+
+(defgroup bbdb-mua-gnus-splitting nil
+ "Gnus-specific splitting BBDB customizations"
+ :group 'bbdb-mua-gnus)
+(put 'bbdb-mua-gnus-splitting 'custom-loads '(bbdb-gnus))
+
+(defgroup bbdb-mua-vm nil
+ "VM-specific BBDB customizations"
+ :group 'bbdb-mua)
+(put 'bbdb-mua-vm 'custom-loads '(bbdb-vm))
+
+(defgroup bbdb-mua-message nil
+ "Message-specific BBDB customizations"
+ :group 'bbdb-mua)
+(put 'bbdb-mua-message 'custom-loads '(bbdb-message))
+
+(defgroup bbdb-utilities nil
+ "Customizations for BBDB Utilities"
+ :group 'bbdb)
+
+(defgroup bbdb-utilities-dialing nil
+ "BBDB Customizations for phone number dialing"
+ :group 'bbdb)
+
+(defgroup bbdb-utilities-tex nil
+ "Customizations for TeXing BBDB."
+ :group 'bbdb)
+(put 'bbdb-utilities-tex 'custom-loads '(bbdb-tex))
+
+(defgroup bbdb-utilities-anniv nil
+ "Customizations for BBDB Anniversaries"
+ :group 'bbdb-utilities)
+(put 'bbdb-utilities-anniv 'custom-loads '(bbdb-anniv))
+
+(defgroup bbdb-utilities-ispell nil
+ "Customizations for BBDB ispell interface"
+ :group 'bbdb-utilities)
+(put 'bbdb-utilities-ispell 'custom-loads '(bbdb-ispell))
+
+(defgroup bbdb-utilities-snarf nil
+ "Customizations for BBDB snarf"
+ :group 'bbdb-utilities)
+(put 'bbdb-utilities-snarf 'custom-loads '(bbdb-snarf))
+
+(defgroup bbdb-utilities-pgp nil
+ "Customizations for BBDB pgp"
+ :group 'bbdb-utilities)
+(put 'bbdb-utilities-pgp 'custom-loads '(bbdb-pgp))
+
+(defgroup bbdb-utilities-sc nil
+ "Customizations for using Supercite with the BBDB."
+ :group 'bbdb-utilities
+ :prefix "bbdb-sc")
+(put 'bbdb-utilities-sc 'custom-loads '(bbdb-sc))
+
+;;; Customizable variables
+(defcustom bbdb-file (locate-user-emacs-file "bbdb" ".bbdb")
+ "The name of the Insidious Big Brother Database file."
+ :group 'bbdb
+ :type 'file)
+
+;; This should be removed, and the following put in place:
+;; a hierarchical structure of bbdb files, some perhaps read-only,
+;; perhaps caching in the local bbdb. This way one could have, e.g. an
+;; organization address book, with each person having access to it, and
+;; then a local address book with personal stuff in it.
+(defcustom bbdb-file-remote nil
+ "The remote file to save the BBDB database to.
+When this is non-nil, it should be a file name.
+When BBDB reads `bbdb-file', it also checks this file,
+and if it is newer than `bbdb-file', it loads this file.
+When BBDB writes `bbdb-file', it also writes this file.
+
+This feature allows one to keep the database in one place while using
+different computers, thus reducing the need for merging different files."
+ :group 'bbdb
+ :type '(choice (const :tag "none" nil)
+ (file :tag "remote file name")))
+
+(defcustom bbdb-file-remote-save-always t
+ "If t `bbdb-file-remote' is saved automatically when `bbdb-file' is saved.
+When nil, ask."
+ :group 'bbdb
+ :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
+to set this to t in all but one of them."
+ :group 'bbdb
+ :type '(choice (const :tag "Database is read-only" t)
+ (const :tag "Database is writable" nil)))
+
+(defcustom bbdb-auto-revert nil
+ "If t revert unchanged database without querying.
+If t and `bbdb-file' has changed on disk, while the database
+has not been modified inside Emacs, revert the database automatically.
+If nil or the database has been changed inside Emacs, always query
+before reverting."
+ :group 'bbdb
+ :type '(choice (const :tag "Revert unchanged database without querying" t)
+ (const :tag "Ask before reverting database" nil)))
+
+(defcustom bbdb-check-auto-save-file nil
+ "If t BBDB will check its auto-save file.
+If this file is newer than `bbdb-file', BBDB will offer to revert."
+ :group 'bbdb
+ :type '(choice (const :tag "Check auto-save file" t)
+ (const :tag "Do not check auto-save file" nil)))
+
+(defcustom bbdb-before-save-hook nil
+ "Hook run before saving `bbdb-file'."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-after-save-hook nil
+ "Hook run after saving `bbdb-file'."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-create-hook nil
+ "*Hook run each time a new BBDB record is created.
+Run with one argument, the new record. This is called before the record is
+added to the database, followed by a call of `bbdb-change-hook'.
+
+If a record has been created by analyzing a mail message, hook functions
+can use the variable `bbdb-update-records-address' to determine the header
+and class of the mail address according to `bbdb-message-headers'."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-change-hook nil
+ "*Hook run each time a BBDB record is changed.
+Run with one argument, the record. This is called before the database
+is modified. If a new bbdb record is created, `bbdb-create-hook' is called
+first, followed by a call of this hook."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-merge-records-function nil
+ "If non-nil, a function for merging two records.
+This function is called when loading a record into BBDB that has the same uuid
+as an exisiting record. If nil use `bbdb-merge-records'.
+This function should take two arguments RECORD1 and RECORD2, with RECORD2
+being the already existing record. It should merge RECORD1 into RECORD2,
+and return RECORD2."
+ :group 'bbdb
+ :type 'function)
+
+(defcustom bbdb-time-stamp-format "%Y-%m-%d %T %z"
+ "The BBDB time stamp format. See `format-time-string'.
+This function is called with arg UNIVERSAL being non-nil."
+ :group 'bbdb
+ :type 'string)
+
+(defcustom bbdb-after-change-hook nil
+ "Hook run each time a BBDB record is changed.
+Run with one argument, the record. This is called after the database
+is modified. So if you want to modify a record when it is created or changed,
+use instead `bbdb-create-hook' and / or `bbdb-change-hook'."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-after-read-db-hook nil
+ "Hook run (with no arguments) after `bbdb-file' is read.
+Note that this can be called more than once if the BBDB is reverted."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-initialize-hook nil
+ "Normal hook run after the BBDB initialization function `bbdb-initialize'."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-mode-hook nil
+ "Normal hook run when the *BBDB* buffer is created."
+ :group 'bbdb
+ :type 'hook)
+
+(defcustom bbdb-silent nil
+ "If t, BBDB suppresses all its informational messages and queries.
+Be very very certain you want to set this to t, because it will suppress
+queries to alter record names, assign names to addresses, etc.
+Lisp Hackers: See also `bbdb-silent-internal'."
+ :group 'bbdb
+ :type '(choice (const :tag "Run silently" t)
+ (const :tag "Disable silent running" nil)))
+
+(defcustom bbdb-info-file nil
+ "Location of the bbdb info file, if it's not in the standard place."
+ :group 'bbdb
+ :type '(choice (const :tag "Standard location" nil)
+ (file :tag "Nonstandard location")))
+
+\f
+;;; Record display
+
+(defcustom bbdb-pop-up-window-size 0.5
+ "Vertical size of BBDB window (vertical split).
+If it is an integer number, it is the number of lines used by BBDB.
+If it is a fraction between 0.0 and 1.0 (inclusive), it is the fraction
+of the tallest existing window that BBDB will take over.
+If it is t use `display-buffer'/`pop-to-buffer' to create the BBDB window.
+See also `bbdb-mua-pop-up-window-size'."
+ :group 'bbdb-record-display
+ :type '(choice (number :tag "BBDB window size")
+ (const :tag "Use `pop-to-buffer'" t)))
+
+(defcustom bbdb-dedicated-window nil
+ "Make *BBDB* window a dedicated window.
+Allowed values include nil (not dedicated) 'bbdb (weakly dedicated)
+and t (strongly dedicated)."
+ :group 'bbdb-record-display
+ :type '(choice (const :tag "BBDB window not dedicated" nil)
+ (const :tag "BBDB window weakly dedicated" bbdb)
+ (const :tag "BBDB window strongly dedicated" t)))
+
+(defcustom bbdb-layout-alist
+ '((one-line (order . (phone mail-alias mail notes))
+ (name-end . 24)
+ (toggle . t))
+ (multi-line (omit . (uuid creation-date timestamp
+ name-format name-face))
+ (toggle . t)
+ (indentation . 21))
+ (pop-up-multi-line (omit . (uuid creation-date timestamp
+ name-format name-face))
+ (indentation . 21))
+ (full-multi-line (indentation . 21)))
+ "Alist describing each display layout.
+The format of an element is (LAYOUT-NAME OPTION-ALIST).
+
+By default there are four different layout types used by BBDB, which are
+`one-line', `multi-line', `pop-up-multi-line' (used for pop-ups) and
+`full-multi-line' (showing all fields of a record).
+
+OPTION-ALIST specifies the options for the layout. Valid options are:
+
+ ------- Availability --------
+ Format one-line multi-line default if unset
+------------------------------------------------------------------------------
+ (toggle . BOOL) + + nil
+ (order . FIELD-LIST) + + '(phone ...)
+ (omit . FIELD-LIST) + + nil
+ (name-end . INTEGER) + - 40
+ (indentation . INTEGER) - + 21
+ (primary . BOOL) - + nil
+ (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
+ holder for all remaining fields
+- omit: is a list of xfields which should not be displayed
+ or t to exclude all xfields 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 whether only the primary mail is shown or all are shown.
+- display-p: a function controlling whether the record is to be displayed.
+
+When you add a new layout FOO, you can write a corresponding layout
+function `bbdb-display-record-layout-FOO'. If you do not write your own
+layout function, the multi-line layout will be used."
+ :group 'bbdb-record-display
+ :type
+ `(repeat
+ (cons :tag "Layout Definition"
+ (choice :tag "Layout type"
+ (const one-line)
+ (const multi-line)
+ (const pop-up-multi-line)
+ (const full-multi-line)
+ (symbol))
+ (set :tag "Properties"
+ (cons :tag "Order"
+ (const :tag "List of fields to order by" order)
+ (repeat (choice (const phone)
+ (const address)
+ (const mail)
+ (const AKA)
+ (const notes)
+ (symbol :tag "other")
+ (const :tag "Remaining fields" t))))
+ (choice :tag "Omit"
+ :value (omit . nil)
+ (cons :tag "List of fields to omit"
+ (const :tag "Fields not to display" omit)
+ (repeat (choice (const phone)
+ (const address)
+ (const mail)
+ (const AKA)
+ (const notes)
+ (symbol :tag "other"))))
+ (const :tag "Exclude all fields except those listed in the order note" t))
+ (cons :tag "Indentation"
+ :value (indentation . 14)
+ (const :tag "Level of indentation for multi-line layout"
+ indentation)
+ (number :tag "Column"))
+ (cons :tag "End of name field"
+ :value (name-end . 24)
+ (const :tag "The column where the name should end in one-line layout"
+ name-end)
+ (number :tag "Column"))
+ (cons :tag "Toggle"
+ (const :tag "The layout is included when toggling layout" toggle)
+ boolean)
+ (cons :tag "Primary Mail Only"
+ (const :tag "Only the primary mail address is included" primary)
+ boolean)
+ (cons :tag "Display-p"
+ (const :tag "Show only records passing this test" display-p)
+ (choice (const :tag "No test" nil)
+ (function :tag "Predicate")))))))
+
+(defcustom bbdb-layout 'multi-line
+ "Default display layout."
+ :group 'bbdb-record-display
+ :type '(choice (const one-line)
+ (const multi-line)
+ (const full-multi-line)
+ (symbol)))
+
+(defcustom bbdb-pop-up-layout 'pop-up-multi-line
+ "Default layout for pop-up BBDB buffers (mail, news, etc.)."
+ :group 'bbdb-record-display
+ :type '(choice (const one-line)
+ (const multi-line)
+ (const full-multi-line)
+ (symbol)))
+
+(defcustom bbdb-wrap-column nil
+ "Wrap column for multi-line display. If nil do not wrap lines."
+ :group 'bbdb-record-display
+ :type '(choice (const :tag "No line wrapping" nil)
+ (number :tag "Wrap column")))
+
+(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 command `isearch-forward'."
+ :group 'bbdb-record-display
+ :type 'boolean)
+
+(defcustom bbdb-name-format 'first-last
+ "Format for displaying names.
+If first-last names are displayed as \"Firstname Lastname\".
+If last-first names are displayed as \"Lastname, Firstname\".
+This can be overriden per record via the xfield name-format,
+which should take the same values.
+See also `bbdb-read-name-format'."
+ :group 'bbdb-record-display
+ :type '(choice (const :tag "Firstname Lastname" first-last)
+ (const :tag "Lastname, Firstname" last-first)))
+
+;; See http://en.wikipedia.org/wiki/Postal_address
+;; http://www.upu.int/en/activities/addressing/postal-addressing-systems-in-member-countries.html
+(defcustom bbdb-address-format-list
+ '((("Argentina") "spcSC" "@%s\n@%p, @%c@, %S@\n%C@" "@%c@")
+ (("Australia") "scSpC" "@%s\n@%c@ %S@ %p@\n%C@" "@%c@")
+ (("Austria" "Germany" "Spain" "Switzerland")
+ "spcSC" "@%s\n@%p @%c@ (%S)@\n%C@" "@%c@")
+ (("Canada") "scSCp" "@%s\n@%c@, %S@\n%C@ %p@" "@%c@")
+ (("China") "scpSC" "@%s\n@%c@\n%p@ %S@\n%C@" "@%c@") ; English format
+ ; (("China") "CpScs" "@%C @%p\n@%S @%c@ %s@" "@%c@") ; Chinese format
+ (("India") "scpSC" "@%s\n@%c@ %p@ (%S)@\n%C@" "@%c@")
+ (("USA") "scSpC" "@%s\n@%c@, %S@ %p@\n%C@" "@%c@")
+ (t bbdb-edit-address-default bbdb-format-address-default "@%c@"))
+ "List of address editing and formatting rules for BBDB.
+Each rule is a list (IDENTIFIER EDIT FORMAT FORMAT).
+The first rule for which IDENTIFIER matches an address is used for editing
+and formatting the address.
+
+IDENTIFIER may be a list of countries.
+IDENTIFIER may also be a function that is called with one arg, the address
+to be used. The rule applies if the function returns non-nil.
+See `bbdb-address-continental-p' for an example.
+If IDENTIFIER is t, this rule always applies. Usually, this should be
+the last rule that becomes a fall-back (default).
+
+EDIT may be a function that is called with one argument, the address.
+See `bbdb-edit-address-default' for an example.
+
+EDIT may also be an editting format string. It is a string containing
+the five letters s, c, p, S, and C that specify the order for editing
+the five elements of an address:
+
+s streets
+c city
+p postcode
+S state
+C country
+
+The first FORMAT of each rule is used for multi-line layout, the second FORMAT
+is used for one-line layout.
+
+FORMAT may be a function that is called with one argument, the address.
+See `bbdb-format-address-default' for an example.
+
+FORMAT may also be a format string. It consists of formatting elements
+separated by a delimiter defined via the first (and last) character of FORMAT.
+Each formatting element may contain one of the following format specifiers:
+
+%s streets (used repeatedly for each street part)
+%c city
+%p postcode
+%S state
+%C country
+
+A formatting element will be applied only if the corresponding part
+of the address is a non-empty string.
+
+See also `bbdb-tex-address-format-list'."
+ :group 'bbdb-record-display
+ :type '(repeat (list (choice (const :tag "Default" t)
+ (function :tag "Function")
+ (repeat (string)))
+ (choice (string)
+ (function :tag "Function"))
+ (choice (string)
+ (function :tag "Function"))
+ (choice (string)
+ (function :tag "Function")))))
+
+(defcustom bbdb-continental-postcode-regexp
+ "^\\s *[A-Z][A-Z]?\\s *-\\s *[0-9][0-9][0-9]"
+ "Regexp matching continental postcodes.
+Used by address format identifier `bbdb-address-continental-p'.
+The regexp should match postcodes of the form CH-8052, NL-2300RA,
+and SE-132 54."
+ :group 'bbdb-record-display
+ :type 'regexp)
+
+(defcustom bbdb-default-separator '("[,;]" ", ")
+ "The default field separator. It is a list (SPLIT-RE JOIN).
+This is used for fields which do not have an entry in `bbdb-separator-alist'.
+Whitespace surrounding SPLIT-RE is ignored."
+ :group 'bbdb-record-display
+ :type '(list regexp string))
+
+(defcustom bbdb-separator-alist
+ '((record "\n\n" "\n\n") ; used by `bbdb-copy-fields-as-kill'
+ (name-first-last "[ ,;]" " ") (name-last-first "[ ,;]" ", ")
+ (name-field ":\n" ":\n") ; used by `bbdb-copy-fields-as-kill'
+ (phone "[,;]" ", ") (address ";\n" ";\n") ; ditto
+ (organization "[,;]" ", ") (affix "[,;]" ", ") (aka "[,;]" ", ")
+ (mail "[,;]" ", ") (mail-alias "[,;]" ", ") (vm-folder "[,;]" ", ")
+ (birthday "\n" "\n") (wedding "\n" "\n") (anniversary "\n" "\n")
+ (notes "\n" "\n") (tex-name "#" " # "))
+ "Alist of field separators.
+Each element is of the form (FIELD SPLIT-RE JOIN).
+Whitespace surrounding SPLIT-RE is ignored.
+For fields lacking an entry here `bbdb-default-separator' is used instead."
+ :group 'bbdb-record-display
+ :type '(repeat (list symbol regexp string)))
+
+(defcustom bbdb-user-menu-commands nil
+ "User defined menu entries which should be appended to the BBDB menu.
+This should be a list of menu entries.
+When set to a function, it is called with two arguments RECORD and FIELD
+and it should either return nil or a list of menu entries.
+Used by `bbdb-mouse-menu'."
+ :group 'bbdb-record-display
+ :type 'sexp)
+
+(defcustom bbdb-display-hook nil
+ "Hook run after the *BBDB* is filled in."
+ :group 'bbdb-record-display
+ :type 'hook)
+
+(defcustom bbdb-multiple-buffers nil
+ "When non-nil we create a new buffer of every buffer causing pop-ups.
+You can also set this to a function returning a buffer name.
+Here a value may be the predefined function `bbdb-multiple-buffers-default'."
+ :group 'bbdb-record-display
+ :type '(choice (const :tag "Disabled" nil)
+ (function :tag "Enabled" bbdb-multiple-buffers-default)
+ (function :tag "User defined function")))
+
+(defcustom bbdb-image nil
+ "If non-nil display records with an image.
+If a symbol this should be an xfield holding the name of the image file
+associated with the record. If it is `name' or `fl-name', the first and last
+name of the record are used as file name. If it is `lf-name', the last and
+first name of the record are used as file name.
+If a function it is called with one arg, the record, and it should return
+the name of the image file.
+The file is searched in the directories in `bbdb-image-path'.
+File name suffixes are appended according to `bbdb-image-suffixes'.
+See `locate-file'."
+ :group 'bbdb-record-display
+ :type '(choice (const :tag "Disabled" nil)
+ (function :tag "User defined function")
+ (symbol :tag "Record field")))
+
+(defcustom bbdb-image-path nil
+ "List of directories to search for `bbdb-image'."
+ :group 'bbdb-record-display
+ :type '(repeat (directory)))
+
+(defcustom bbdb-image-suffixes '(".png" ".jpg" ".gif" ".xpm")
+ "List of file name suffixes searched for `bbdb-image'."
+ :group 'bbdb-record-display
+ :type '(repeat (string :tag "File suffix")))
+
+(defcustom bbdb-read-name-format 'fullname
+ "Default format for reading names via `bbdb-read-name'.
+If it is 'first-last read first and last name separately.
+If it is 'last-first read last and first name separately.
+With any other value read full name at once.
+See also `bbdb-name-format'."
+ :group 'bbdb-record-display
+ :type '(choice (const :tag "Firstname Lastname" first-last)
+ (const :tag "Lastname, Firstname" last-first)
+ (const :tag "Full name" fullname)))
+
+\f
+;;; Record editing
+(defcustom bbdb-lastname-prefixes
+ '("von" "de" "di")
+ "List of lastname prefixes recognized in name fields.
+Used to enhance dividing name strings into firstname and lastname parts.
+Case is ignored."
+ :group 'bbdb-record-edit
+ :type '(repeat string))
+
+(defcustom bbdb-lastname-re
+ (concat "[- \t]*\\(\\(?:\\<"
+ (regexp-opt bbdb-lastname-prefixes)
+ ;; multiple last names concatenated by `-'
+ "\\>[- \t]+\\)?\\(?:\\w+[ \t]*-[ \t]*\\)*\\w+\\)\\'")
+ "Regexp matching the last name of a full name.
+Its first parenthetical subexpression becomes the last name."
+ :group 'bbdb-record-edit
+ :type 'regexp)
+
+(defcustom bbdb-lastname-suffixes
+ '("Jr" "Sr" "II" "III")
+ "List of lastname suffixes recognized in name fields.
+Used to dividing name strings into firstname and lastname parts.
+All suffixes are complemented by optional `.'. Case is ignored."
+ :group 'bbdb-record-edit
+ :type '(repeat string))
+
+(defcustom bbdb-lastname-suffix-re
+ (concat "[-,. \t/\\]+\\("
+ (regexp-opt bbdb-lastname-suffixes)
+ ;; suffices are complemented by optional `.'.
+ "\\.?\\)\\W*\\'")
+ "Regexp matching the suffix of a last name.
+Its first parenthetical subexpression becomes the suffix."
+ :group 'bbdb-record-edit
+ :type 'regexp)
+
+(defcustom bbdb-default-domain nil
+ "Default domain to append when reading a new mail address.
+If a mail address does not contain `[@%!]', append @`bbdb-default-domain' to it.
+
+The address is not altered if `bbdb-default-domain' is nil
+or if a prefix argument is given to the command `bbdb-insert-field'."
+ :group 'bbdb-record-edit
+ :type '(choice (const :tag "none" nil)
+ (string :tag "Default Domain")))
+
+(defcustom bbdb-phone-style 'nanp
+ "Phone numbering plan assumed by BBDB.
+The value 'nanp refers to the North American Numbering Plan.
+The value nil refers to a free-style numbering plan.
+
+You can have both styles of phone number in your database by providing a
+prefix argument to the command `bbdb-insert-field'."
+ :group 'bbdb-record-edit
+ :type '(choice (const :tag "NANP" nanp)
+ (const :tag "none" nil)))
+
+(defcustom bbdb-default-area-code nil
+ "Default area code to use when reading a new phone number.
+This variable also affects dialing."
+ :group 'bbdb-record-edit
+ :type '(choice (const :tag "none" nil)
+ (integer :tag "Default Area Code"))
+ :set (lambda( symb val )
+ (if (or (and (stringp val)
+ (string-match "^[0-9]+$" val))
+ (integerp val)
+ (null val))
+ (set symb val)
+ (error "%s must contain digits only." symb))))
+
+(defcustom bbdb-allow-duplicates nil
+ "When non-nil BBDB allows records with duplicate names and email addresses.
+In rare cases, this may lead to confusion with BBDB's MUA interface."
+ :group 'bbdb-record-edit
+ :type 'boolean)
+
+(defcustom bbdb-default-label-list '("home" "work" "other")
+ "Default list of labels for Address and Phone fields."
+ :group 'bbdb-record-edit
+ :type '(repeat string))
+
+(defcustom bbdb-address-label-list bbdb-default-label-list
+ "List of labels for Address field."
+ :group 'bbdb-record-edit
+ :type '(repeat string))
+
+(defcustom bbdb-phone-label-list '("home" "work" "cell" "other")
+ "List of labels for Phone field."
+ :group 'bbdb-record-edit
+ :type '(repeat string))
+
+(defcustom bbdb-default-country "Emacs";; what do you mean, it's not a country?
+ "Default country to use if none is specified."
+ :group 'bbdb-record-edit
+ :type '(choice (const :tag "None" nil)
+ (string :tag "Default Country")))
+
+(defcustom bbdb-check-postcode t
+ "If non-nil, require legal postcodes when entering an address.
+The format of legal postcodes is determined by the variable
+`bbdb-legal-postcodes'."
+ :group 'bbdb-record-edit
+ :type 'boolean)
+
+(defcustom bbdb-legal-postcodes
+ '(;; empty string
+ "^$"
+ ;; Matches 1 to 6 digits.
+ "^[ \t\n]*[0-9][0-9]?[0-9]?[0-9]?[0-9]?[0-9]?[ \t\n]*$"
+ ;; Matches 5 digits and 3 or 4 digits.
+ "^[ \t\n]*\\([0-9][0-9][0-9][0-9][0-9]\\)[ \t\n]*-?[ \t\n]*\\([0-9][0-9][0-9][0-9]?\\)[ \t\n]*$"
+ ;; Match postcodes for Canada, UK, etc. (result is ("LL47" "U4B")).
+ "^[ \t\n]*\\([A-Za-z0-9]+\\)[ \t\n]+\\([A-Za-z0-9]+\\)[ \t\n]*$"
+ ;; Match postcodes for continental Europe. Examples "CH-8057"
+ ;; or "F - 83320" (result is ("CH" "8057") or ("F" "83320")).
+ ;; Support for "NL-2300RA" added at request from Carsten Dominik
+ ;; <dominik@astro.uva.nl>
+ "^[ \t\n]*\\([A-Z]+\\)[ \t\n]*-?[ \t\n]*\\([0-9]+ ?[A-Z]*\\)[ \t\n]*$"
+ ;; Match postcodes from Sweden where the five digits are grouped 3+2
+ ;; at the request from Mats Lofdahl <MLofdahl@solar.stanford.edu>.
+ ;; (result is ("SE" (133 36)))
+ "^[ \t\n]*\\([A-Z]+\\)[ \t\n]*-?[ \t\n]*\\([0-9]+\\)[ \t\n]+\\([0-9]+\\)[ \t\n]*$")
+ "List of regexps that match legal postcodes.
+Whether this is used at all depends on the variable `bbdb-check-postcode'."
+ :group 'bbdb-record-edit
+ :type '(repeat regexp))
+
+(defcustom bbdb-default-xfield 'notes
+ "Default xfield when editing BBDB records."
+ :group 'bbdb-record-edit
+ :type '(symbol :tag "Xfield"))
+
+(defcustom bbdb-edit-foo (cons bbdb-default-xfield 'current-fields)
+ "Fields to edit with command `bbdb-edit-foo'.
+This is a cons pair (WITHOUT-PREFIX . WITH-PREFIX).
+The car is used if the command is called without a prefix.
+The cdr is used if the command is called with a prefix.
+
+WITHOUT-PREFIX and WITH-PREFIX may take the values:
+ name The full name
+ affix The list of affixes
+ organization The list of organizations
+ aka the list of AKAs
+ mail the list of email addresses
+ phone the list of phone numbers
+ address the list of addresses
+ current-fields Read the field to edit using a completion table
+ that includes all fields of the current record.
+ all-fields Read the field to edit using a completion table
+ that includes all fields currently known to BBDB.
+
+Any other symbol is interpreted as the label of an xfield."
+ :group 'bbdb-record-edit
+ :type '(cons (symbol :tag "Field without prefix")
+ (symbol :tag "Field with prefix")))
+
+\f
+;;; MUA interface
+
+(defcustom bbdb-annotate-field bbdb-default-xfield
+ "Field to annotate via `bbdb-annotate-record' and friends.
+This may take the values:
+ affix The list of affixes
+ organization The list of organizations
+ aka the list of AKAs
+ mail the list of email addresses
+ all-fields Read the field to edit using a completion table
+ that includes all fields currently known to BBDB.
+
+Any other symbol is interpreted as the label of an xfield."
+ :group 'bbdb-mua
+ :type '(symbol :tag "Field to annotate"))
+
+(defcustom bbdb-mua-edit-field bbdb-default-xfield
+ "Field to edit with command `bbdb-mua-edit-field' and friends.
+This may take the values:
+ name The full name
+ affix The list of affixes
+ organization The list of organizations
+ aka the list of AKAs
+ mail the list of email addresses
+ all-fields Read the field to edit using a completion table
+ that includes all fields currently known to BBDB.
+
+Any other symbol is interpreted as the label of an xfield."
+ :group 'bbdb-mua
+ :type '(symbol :tag "Field to edit"))
+
+(defcustom bbdb-mua-update-interactive-p '(search . query)
+ "How BBDB's interactive MUA commands update BBDB records.
+This is a cons pair (WITHOUT-PREFIX . WITH-PREFIX).
+The car is used if the command is called without a prefix.
+The cdr is used if the command is called with a prefix (and if the prefix
+ is not used for another purpose).
+
+WITHOUT-PREFIX and WITH-PREFIX may take the values
+\(here ADDRESS is an email address found in a message):
+ nil Do nothing.
+ search Search for existing records matching ADDRESS.
+ update Search for existing records matching ADDRESS;
+ update name and mail field if necessary.
+ query Search for existing records matching ADDRESS;
+ query for creation of a new record if the record does not exist.
+ create or t Search for existing records matching ADDRESS;
+ create a new record if it does not yet exist.
+ a function This functions will be called with no arguments.
+ It should return one of the above values.
+ read Read the value interactively."
+ :group 'bbdb-mua
+ :type '(cons (choice (const :tag "do nothing" nil)
+ (const :tag "search for existing records" search)
+ (const :tag "update existing records" update)
+ (const :tag "query annotation of all messages" query)
+ (const :tag "annotate all messages" create)
+ (function :tag "User-defined function")
+ (const :tag "read arg interactively" read))
+ (choice (const :tag "do nothing" nil)
+ (const :tag "search for existing records" search)
+ (const :tag "update existing records" update)
+ (const :tag "query annotation of all messages" query)
+ (const :tag "annotate all messages" create)
+ (function :tag "User-defined function")
+ (const :tag "read arg interactively" read))))
+
+(defcustom bbdb-mua-auto-update-p 'bbdb-select-message
+ "How `bbdb-mua-auto-update' updates BBDB records automatically.
+
+Allowed values are (here ADDRESS is an email address found in a message):
+ nil Do nothing.
+ search Search for existing records matching ADDRESS.
+ update Search for existing records matching ADDRESS;
+ update name and mail field if necessary.
+ query Search for existing records matching ADDRESS;
+ query for creation of a new record if the record does not exist.
+ create or t Search for existing records matching ADDRESS;
+ create a new record if it does not yet exist.
+ a function This functions will be called with no arguments.
+ It should return one of the above values.
+ For an example, see `bbdb-select-message' with
+ `bbdb-mua-update-records-p', `bbdb-accept-message-alist'
+ and `bbdb-ignore-message-alist'.
+
+To initiate auto-updating of BBDB records, call `bbdb-mua-auto-update-init'
+for the respective MUAs in your init file."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "do nothing" nil)
+ (const :tag "search for existing records" search)
+ (const :tag "update existing records" update)
+ (const :tag "query annotation of all messages" query)
+ (const :tag "annotate all messages" create)
+ (function :tag "User-defined function")))
+
+(defcustom bbdb-update-records-p 'search
+ "Return value for `bbdb-select-message' and friends.
+These functions can select messages for further processing by BBDB,
+The amount of subsequent processing is determined by `bbdb-update-records-p'.
+
+Allowed values are (here ADDRESS is an email address selected
+by `bbdb-select-message'):
+ nil Do nothing.
+ search Search for existing records matching ADDRESS.
+ update Search for existing records matching ADDRESS;
+ update name and mail field if necessary.
+ query Search for existing records matching ADDRESS;
+ query for creation of a new record if the record does not exist.
+ create or t Search for existing records matching ADDRESS;
+ create a new record if it does not yet exist.
+ a function This functions will be called with no arguments.
+ It should return one of the above values."
+ ;; Also: Used for communication between `bbdb-update-records'
+ ;; and `bbdb-query-create'.
+ :group 'bbdb-mua
+ :type '(choice (const :tag "do nothing" nil)
+ (const :tag "search for existing records" search)
+ (const :tag "update existing records" update)
+ (const :tag "query annotation of all messages" query)
+ (const :tag "annotate all messages" create)
+ (function :tag "User-defined function")))
+
+(defcustom bbdb-message-headers
+ '((sender "From" "Resent-From" "Reply-To" "Sender")
+ (recipients "Resent-To" "Resent-CC" "To" "CC" "BCC"))
+ "Alist of headers to search for sender and recipients mail addresses.
+Each element is of the form
+
+ (CLASS HEADER ...)
+
+The symbol CLASS defines a class of headers.
+The strings HEADER belong to CLASS."
+ :group 'bbdb-mua
+ :type 'list)
+
+(defcustom bbdb-message-all-addresses nil
+ "If t `bbdb-update-records' returns all mail addresses of a message.
+Otherwise this function returns only the first mail address of each message."
+ :group 'bbdb-mua
+ :type 'boolean)
+
+(defcustom bbdb-message-try-all-headers nil
+ "If t try all message headers to extract an email address from a message.
+Several BBDB commands extract either the sender or the recipients' email
+addresses from a message according to `bbdb-message-headers'. If BBDB does not
+find any email address in this subset of message headers (for example, because
+an email address is excluded because of `bbdb-user-mail-address-re')
+but `bbdb-message-try-all-headers' is t, then these commands will also consider
+the email addresses in the remaining headers."
+ :group 'bbdb-mua
+ :type 'boolean)
+
+(defcustom bbdb-accept-message-alist t
+ "Alist describing which messages to automatically create BBDB records for.
+The format of this alist is
+ ((HEADER-NAME . REGEXP) ...)
+For example, if
+ ((\"From\" . \"@.*\\.maximegalon\\.edu\")
+ (\"Subject\" . \"time travel\"))
+BBDB records are only created for messages sent by people at Maximegalon U.,
+or people posting about time travel.
+If t accept all messages. If nil do not accept any messages.
+
+See also `bbdb-ignore-message-alist', which has the opposite effect."
+ :group 'bbdb-mua
+ :type '(repeat (cons
+ (string :tag "Header name")
+ (regexp :tag "Regexp to match on header value"))))
+
+(defcustom bbdb-ignore-message-alist nil
+ "Alist describing which messages not to automatically create BBDB records for.
+The format of this alist is
+ ((HEADER-NAME . REGEXP) ... )
+For example, if
+ ((\"From\" . \"mailer-daemon\")
+ ((\"To\" \"CC\") . \"mailing-list-1\\\\|mailing-list-2\"))
+no BBDB records are created for messages from any mailer daemon,
+or messages sent to or CCed to either of two mailing lists.
+If t ignore all messages. If nil do not ignore any messages.
+
+See also `bbdb-accept-message-alist', which has the opposite effect."
+ :group 'bbdb-mua
+ :type '(repeat (cons
+ (string :tag "Header name")
+ (regexp :tag "Regexp to match on header value"))))
+
+(defcustom bbdb-user-mail-address-re
+ (and (stringp user-mail-address)
+ (string-match "\\`\\([^@]*\\)\\(@\\|\\'\\)" user-mail-address)
+ (concat "\\<" (regexp-quote (match-string 1 user-mail-address)) "\\>"))
+ "A regular expression matching your mail addresses.
+Several BBDB commands extract either the sender or the recipients' email
+addresses from a message according to `bbdb-message-headers'. Yet an email
+address will be ignored if it matches `bbdb-user-mail-address-re'. This way
+the commands will not operate on your own record.
+See also `bbdb-message-try-all-headers'."
+ :group 'bbdb-mua
+ :type '(regexp :tag "Regexp matching your mail addresses"))
+
+(defcustom bbdb-add-name 'query
+ "How to handle new names for existing BBDB records.
+This handles messages where the real name differs from the name
+in a BBDB record with the same mail address, as in \"John Smith <jqs@frob.com>\"
+versus \"John Q. Smith <jqs@frob.com>\".
+Allowed values are:
+ t Automatically change the name to the new value.
+ query Query whether to use the new name.
+ nil Ignore the new name.
+ a number Number of seconds BBDB displays the name mismatch.
+ (without further action).
+ a function This is called with two args, the record and the new name.
+ It should return one of the above values.
+ a regexp If the new name matches this regexp ignore it.
+ Otherwise query to add it.
+See also `bbdb-add-aka'."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "Automatically use the new name" t)
+ (const :tag "Query for name changes" query)
+ (const :tag "Ignore the new name" nil)
+ (integer :tag "Number of seconds to display name mismatch")
+ (function :tag "Function for analyzing name handling")
+ (regexp :tag "If the new name matches this regexp ignore it.")))
+
+(defcustom bbdb-add-aka 'query
+ "How to handle alternate names for existing BBDB records.
+Allowed values are:
+ t Automatically store alternate names as AKA.
+ query Query whether to store alternate names as an AKA.
+ nil Ignore alternate names.
+ a function This is called with two args, the record and the new name.
+ It should return one of the above values.
+ a regexp If the alternate name matches this regexp ignore it.
+ Otherwise query to add it.
+See also `bbdb-add-name'."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "Automatically store alternate names as AKA" t)
+ (const :tag "Query for alternate names" query)
+ (const :tag "Ignore alternate names" nil)
+ (function :tag "Function for alternate name handling")
+ (regexp :tag "If the alternate name matches this regexp ignore it.")))
+
+(defcustom bbdb-add-mails 'query
+ "How to handle new mail addresses for existing BBDB records.
+This handles messages where the mail address differs from the mail addresses
+in a BBDB record with the same name as in \"John Q. Smith <jqs@foo.com>\"
+versus \"John Q. Smith <jqs@bar.com>\".
+Allowed values are:
+ t Automatically add new mail addresses to the list of mail addresses.
+ query Query whether to add it.
+ nil Ignore new mail addresses.
+ a number Number of seconds BBDB displays the new address
+ (without further action).
+ a function This is called with two args, the record and the new mail address.
+ It should return one of the above values.
+ a regexp If the new mail address matches this regexp ignore the new address.
+ Otherwise query to add it.
+See also `bbdb-new-mails-primary' and `bbdb-ignore-redundant-mails'."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "Automatically add new mail addresses" t)
+ (const :tag "Query before adding new mail addresses" query)
+ (const :tag "Never add new mail addresses" nil)
+ (number :tag "Number of seconds to display new addresses")
+ (function :tag "Function for analyzing name handling")
+ (regexp :tag "If the new address matches this regexp ignore it.")))
+
+(defcustom bbdb-new-mails-primary 'query
+ "Where to put new mail addresses for existing BBDB records.
+A new mail address may either become the new primary mail address,
+when it is put at the beginning of the list of mail addresses.
+Or the new mail address is added at the end of the list of mail addresses.
+Allowed values are:
+ t Make a new address automatically the primary address.
+ query Query whether to make it the primary address.
+ nil Add the new address to the end of the list.
+ a function This is called with two args, the record and the new mail address.
+ It should return one of the above values.
+ a regexp If the new mail address matches this regexp put it at the end.
+ Otherwise query to make it the primary address.
+See also `bbdb-add-mails'."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "New address automatically made primary" t)
+ (const :tag "Query before making a new address primary" query)
+ (const :tag "Do not make new address primary" nil)
+ (function :tag "Function for analyzing primary handling")
+ (regexp :tag "If the new mail address matches this regexp put it at the end.")))
+
+(defcustom bbdb-canonicalize-mail-function nil
+ "If non-nil, it should be a function of one arg: a mail address string.
+When BBDB \"notices\" a message, the corresponding mail addresses are passed
+to this function first. It acts as a kind of \"filter\" to transform
+the mail addresses before they are compared against or added to the database.
+See `bbdb-canonicalize-mail-1' for a more complete example.
+If this function returns nil, BBDB assumes that there is no mail address.
+
+See also `bbdb-ignore-redundant-mails'."
+ :group 'bbdb-mua
+ :type 'function)
+
+(defcustom bbdb-ignore-redundant-mails 'query
+ "How to handle redundant mail addresses for existing BBDB records.
+For example, \"foo@bar.baz.com\" is redundant w.r.t. \"foo@baz.com\".
+This affects two things, whether a new redundant mail address is added
+to BBDB and whether an old mail address, which has become redundant
+because of a newly added mail address, is removed from BBDB.
+
+Allowed values are:
+ t Automatically ignore redundant mail addresses.
+ query Query whether to ignore them.
+ nil Do not ignore redundant mail addresses.
+ a number Number of seconds BBDB displays redundant mail addresses
+ (without further action).
+ a function This is called with two args, the record and the new mail address.
+ It should return one of the above values.
+ a regexp If the new mail address matches this regexp never ignore
+ this mail address. Otherwise query to ignore it.
+See also `bbdb-add-mails' and `bbdb-canonicalize-mail-function'."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "Automatically ignore redundant mail addresses" t)
+ (const :tag "Query whether to ignore them" query)
+ (const :tag "Do not ignore redundant mail addresses" nil)
+ (number :tag "Number of seconds to display redundant addresses")
+ (function :tag "Function for handling redundant mail addresses")
+ (regexp :tag "If the new address matches this regexp never ignore it.")))
+(define-obsolete-variable-alias 'bbdb-canonicalize-redundant-mails
+ 'bbdb-ignore-redundant-mails "3.0")
+
+(defcustom bbdb-message-clean-name-function 'bbdb-message-clean-name-default
+ "Function to clean up the name in the header of a message.
+It takes one argument, the name as extracted by
+`mail-extract-address-components'."
+ :group 'bbdb-mua
+ :type 'function)
+
+(defcustom bbdb-message-mail-as-name t
+ "If non-nil use mail address of message as fallback for name of new records."
+ :group 'bbdb-mua
+ :type 'boolean)
+
+(defcustom bbdb-notice-mail-hook nil
+ "Hook run each time a mail address of a record is \"noticed\" in a message.
+This means that the mail address in a message belongs to an existing BBDB record
+or to a record BBDB has created for the mail address.
+
+Run with one argument, the record. It is up to the hook function
+to determine which MUA is used and to act appropriately.
+Hook functions can use the variable `bbdb-update-records-address'
+to determine the header and class of the mail address according
+to `bbdb-message-headers'. See `bbdb-auto-notes' for how to annotate records
+using `bbdb-update-records-address' and the headers of a mail message.
+
+If a message contains multiple mail addresses belonging to one BBDB record,
+this hook is run for each mail address. Use `bbdb-notice-record-hook'
+if you want to notice each record only once per message."
+ :group 'bbdb-mua
+ :type 'hook)
+
+(defcustom bbdb-notice-record-hook nil
+ "Hook run each time a BBDB record is \"noticed\" in a message.
+This means that one of the mail addresses in a message belongs to an existing
+record or it is a record BBDB has created for the mail address. If a message
+contains multiple mail addresses belonging to one BBDB record, this hook
+is nonetheless run only once. Use `bbdb-notice-mail-hook' if you want to run
+a hook function for each mail address in a message.
+
+Hook is run with one argument, the record."
+ :group 'bbdb-mua
+ :type 'hook)
+
+(define-widget 'bbdb-alist-with-header 'group
+ "My group"
+ :match 'bbdb-alist-with-header-match
+ :value-to-internal (lambda (_widget value)
+ (if value (list (car value) (cdr value))))
+ :value-to-external (lambda (_widget value)
+ (if value (append (list (car value)) (cadr value)))))
+
+(defun bbdb-alist-with-header-match (widget value)
+ (widget-group-match widget
+ (widget-apply widget :value-to-internal value)))
+
+(defvar bbdb-auto-notes-rules-expanded nil
+ "Expanded `bbdb-auto-notes-rules'.") ; Internal variable
+
+(defcustom bbdb-auto-notes-rules nil
+ "List of rules for adding notes to records of mail addresses of messages.
+This automatically annotates the BBDB record of the sender or recipient
+of a message based on the value of a header such as the Subject header.
+This requires that `bbdb-notice-mail-hook' contains `bbdb-auto-notes'
+and that the record already exists or `bbdb-update-records-p' returns such that
+the record will be created. Messages matching `bbdb-auto-notes-ignore-messages'
+are ignored.
+
+The elements of this list are
+
+ (MUA FROM-TO HEADER ANNOTATE ...)
+ (FROM-TO HEADER ANNOTATE ...)
+ (HEADER ANNOTATE ...)
+
+MUA is the active MUA or a list of MUAs (see `bbdb-mua').
+If MUA is missing or t, use this rule for all MUAs.
+
+FROM-TO is a list of headers and/or header classes as in `bbdb-message-headers'.
+The record corresponding to a mail address of a message is considered for
+annotation if this mail address was found in a header matching FROM-TO.
+If FROM-TO is missing or t, records for each mail address are considered
+irrespective of where the mail address was found in a message.
+
+HEADER is a message header that is considered for generating the annotation.
+
+ANNOTATE may take the following values:
+
+ (REGEXP . STRING) [this is equivalent to (REGEXP notes STRING)]
+ (REGEXP FIELD STRING)
+ (REGEXP FIELD STRING REPLACE)
+
+REGEXP must match the value of HEADER for generating an annotation.
+However, if the value of HEADER also matches an element of
+`bbdb-auto-notes-ignore-headers' no annotation is generated.
+
+The annotation will be added to FIELD of the respective record.
+FIELD defaults to `bbdb-default-xfield'.
+
+STRING defines a replacement for the match of REGEXP in the value of HEADER.
+It may contain \\& or \\N specials used by `replace-match'.
+The resulting string becomes the annotation.
+If STRING is an integer N, the Nth matching subexpression is used.
+If STRING is a function, it will be called with one arg, the value of HEADER.
+The return value (which must be a string) is then used.
+
+If REPLACE is t, the resulting string replaces the old contents of FIELD.
+If it is nil, the string is appended to the contents of FIELD (unless the
+annotation is already part of the content of field).
+
+For example,
+
+ ((\"To\" (\"-vm@\" . \"VM mailing list\"))
+ (\"Subject\" (\"sprocket\" . \"mail about sprockets\")
+ (\"you bonehead\" . \"called me a bonehead\")))
+
+will cause the text \"VM mailing list\" to be added to the notes field
+of the records corresponding to anyone you get mail from via one of the VM
+mailing lists.
+
+If multiple clauses match the message, all of the corresponding strings
+will be added.
+
+See also variables `bbdb-auto-notes-ignore-messages' and
+`bbdb-auto-notes-ignore-headers'.
+
+For speed-up, the function `bbdb-auto-notes' actually use expanded rules
+stored in the internal variable `bbdb-auto-notes-rules-expanded'.
+If you change the value of `bbdb-auto-notes-rules' outside of customize,
+set `bbdb-auto-notes-rules-expanded' to nil, so that the expanded rules
+will be re-evaluated."
+ :group 'bbdb-mua
+ :set (lambda (symbol value)
+ (set-default symbol value)
+ (setq bbdb-auto-notes-rules-expanded nil))
+ :type '(repeat
+ (bbdb-alist-with-header
+ (repeat (choice
+ (const sender)
+ (const recipients)))
+ (string :tag "Header name")
+ (repeat (choice
+ (cons :tag "Value Pair"
+ (regexp :tag "Regexp to match on header value")
+ (string :tag "String for notes if regexp matches"))
+ (list :tag "Replacement list"
+ (regexp :tag "Regexp to match on header value")
+ (choice :tag "Record field"
+ (const notes :tag "xfields")
+ (const organization :tag "Organization")
+ (symbol :tag "Other"))
+ (choice :tag "Regexp match"
+ (string :tag "Replacement string")
+ (integer :tag "Subexpression match")
+ (function :tag "Callback Function"))
+ (choice :tag "Replace previous contents"
+ (const :tag "No" nil)
+ (const :tag "Yes" t))))))))
+
+(defcustom bbdb-auto-notes-ignore-messages nil
+ "List of rules for ignoring entire messages in `bbdb-auto-notes'.
+The elements may have the following values:
+ a function This function is called with one arg, the record
+ that would be annotated.
+ Ignore this message if the function returns non-nil.
+ This function may use `bbdb-update-records-address'.
+ MUA Ignore messages from MUA (see `bbdb-mua').
+ (HEADER . REGEXP) Ignore messages where HEADER matches REGEXP.
+ For example, (\"From\" . bbdb-user-mail-address-re)
+ disables any recording of notes for mail addresses
+ found in messages coming from yourself, see
+ `bbdb-user-mail-address-re'.
+ (MUA HEADER REGEXP) Ignore messages from MUA where HEADER
+ matches REGEXP.
+See also `bbdb-auto-notes-ignore-headers'."
+ :group 'bbdb-mua
+ :type '(repeat (cons
+ (string :tag "Header name")
+ (regexp :tag "Regexp to match on header value"))))
+
+(defcustom bbdb-auto-notes-ignore-headers nil
+ "Alist of headers and regexps to ignore in `bbdb-auto-notes'.
+Each element is of the form
+
+ (HEADER . REGEXP)
+
+For example,
+
+ (\"Organization\" . \"^Gatewayed from\\\\\|^Source only\")
+
+will exclude the phony `Organization:' headers in GNU mailing-lists
+gatewayed to gnu.* newsgroups.
+See also `bbdb-auto-notes-ignore-messages'."
+ :group 'bbdb-mua
+ :type '(repeat (cons
+ (string :tag "Header name")
+ (regexp :tag "Regexp to match on header value"))))
+
+(defcustom bbdb-mua-pop-up t
+ "If non-nil, display an auto-updated BBDB window while using a MUA.
+If 'horiz, stack the window horizontally if there is room.
+If this is nil, BBDB is updated silently.
+
+See also `bbdb-mua-pop-up-window-size' and `bbdb-horiz-pop-up-window-size'."
+ :group 'bbdb-mua
+ :type '(choice (const :tag "MUA BBDB window stacked vertically" t)
+ (const :tag "MUA BBDB window stacked horizontally" horiz)
+ (const :tag "No MUA BBDB window" nil)))
+(define-obsolete-variable-alias 'bbdb-message-pop-up 'bbdb-mua-pop-up "3.0")
+
+(defcustom bbdb-mua-pop-up-window-size bbdb-pop-up-window-size
+ "Vertical size of MUA pop-up BBDB window (vertical split).
+If it is an integer number, it is the number of lines used by BBDB.
+If it is a fraction between 0.0 and 1.0 (inclusive), it is the fraction
+of the tallest existing window that BBDB will take over.
+If it is t use `pop-to-buffer' to create the BBDB window.
+See also `bbdb-pop-up-window-size'."
+ :group 'bbdb-mua
+ :type '(choice (number :tag "BBDB window size")
+ (const :tag "Use `pop-to-buffer'" t)))
+
+(defcustom bbdb-horiz-pop-up-window-size '(112 . 0.3)
+ "Horizontal size of a MUA pop-up BBDB window (horizontal split).
+It is a cons pair (TOTAL . BBDB-SIZE).
+The window that will be considered for horizontal splitting must have
+at least TOTAL columns. BBDB-SIZE is the horizontal size of the BBDB window.
+If it is an integer number, it is the number of columns used by BBDB.
+If it is a fraction between 0 and 1, it is the fraction of the
+window width that BBDB will take over."
+ :group 'bbdb-mua
+ :type '(cons (number :tag "Total number of columns")
+ (number :tag "Horizontal size of BBDB window")))
+
+\f
+;;; xfields processing
+(defcustom bbdb-xfields-sort-order
+ '((notes . 0) (url . 1) (ftp . 2) (gopher . 3) (telnet . 4) (mail-alias . 5)
+ (mail-folder . 6) (lpr . 7))
+ "The order for sorting the xfields.
+If an xfield is not in the alist, it is assigned weight 100, so all xfields
+with weights less then 100 will be in the beginning, and all xfields with
+weights more than 100 will be in the end."
+ :group 'bbdb-mua
+ :type '(repeat (cons
+ (symbol :tag "xfield")
+ (number :tag "Weight"))))
+(define-obsolete-variable-alias 'bbdb-notes-sort-order 'bbdb-xfields-sort-order "3.0")
+
+(defcustom bbdb-merge-xfield-function-alist nil
+ "Alist defining merging functions for particular xfields.
+Each element is of the form (LABEL . MERGE-FUN).
+For merging xfield LABEL, this will use MERGE-FUN."
+ :group 'bbdb-mua
+ :type '(repeat (cons
+ (symbol :tag "xfield")
+ (function :tag "merge function"))))
+(define-obsolete-variable-alias 'bbdb-merge-notes-function-alist
+ 'bbdb-merge-xfield-function-alist "3.0")
+
+(defcustom bbdb-mua-summary-unification-list
+ '(name mail message-name message-mail message-address)
+ "List of FIELDs considered by `bbdb-mua-summary-unify'.
+For the RECORD matching the address of a message, `bbdb-mua-summary-unify'
+returns the first non-empty field value matching an element FIELD from this list.
+Each element FIELD may be a valid argument of `bbdb-record-field' for RECORD.
+In addition, this list may also include the following elements:
+ message-name The name in the address of the message
+ message-mail The mail in the address of the message
+ message-address The complete address of the message
+These provide a fallback if a message does not have a matching RECORD
+or if some FIELD of RECORD is empty."
+ :group 'bbdb-mua
+ :type '(repeat (symbol :tag "Field")))
+
+(defcustom bbdb-mua-summary-mark-field 'mark-char
+ "BBDB xfield whose value is used to mark message addresses known to BBDB.
+This may also be a function, called with one arg, the record, which should
+return the mark. See `bbdb-mua-summary-mark' and `bbdb-mua-summary-unify'.
+See also `bbdb-mua-summary-mark'."
+ :group 'bbdb-mua-gnus
+ :type 'symbol)
+
+(defcustom bbdb-mua-summary-mark "+"
+ "Default mark for message addresses known to BBDB.
+If nil do not mark message addresses known to BBDB.
+See `bbdb-mua-summary-mark' and `bbdb-mua-summary-unify'.
+See also `bbdb-mua-summary-mark-field'."
+ :group 'bbdb-mua
+ :type '(choice (string :tag "Mark used")
+ (const :tag "Do not mark known posters" nil)))
+
+(defcustom bbdb-mua-summary-unify-format-letter "B"
+ "Letter required for `bbdb-mua-summary-unify' in the MUA Summary format string.
+For Gnus, combine it with the %u specifier in `gnus-summary-line-format'
+\(see there), for example use \"%U%R%z%I%(%[%4L: %-23,23uB%]%) %s\\n\".
+For VM, combine it with the %U specifier in `vm-summary-format' (see there),
+for example, use \"%n %*%a %-17.17UB %-3.3m %2d %4l/%-5c %I\\\"%s\\\"\\n\".
+This customization of `gnus-summary-line-format' / `vm-summary-format'
+is required to use `bbdb-mua-summary-unify'.
+Currently no other MUAs support this BBDB feature."
+ :group 'bbdb-mua
+ :type 'string)
+
+(defcustom bbdb-mua-summary-mark-format-letter "b"
+ "Letter required for `bbdb-mua-summary-mark' in the MUA Summary format string.
+For Gnus, combine it with the %u specifier in `gnus-summary-line-format'
+\(see there), for example, use \"%U%R%z%I%(%[%4L: %ub%-23,23f%]%) %s\\n\".
+For VM, combine it with the %U specifier in `vm-summary-format' (see there),
+for example, use \"%n %*%a %Ub%-17.17F %-3.3m %2d %4l/%-5c %I\\\"%s\\\"\\n\".
+This customization of `gnus-summary-line-format' / `vm-summary-format'
+is required to use `bbdb-mua-summary-mark'.
+Currently no other MUAs support this BBDB feature."
+ :group 'bbdb-mua
+ :type 'string)
+
+\f
+;;; Sending mail
+(defcustom bbdb-mail-user-agent mail-user-agent
+ "Mail user agent used by BBDB.
+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")
+ (const :tag "Default" nil)))
+
+(defcustom bbdb-mail-name-format 'first-last
+ "Format for names when sending mail.
+If first-last format names as \"Firstname Lastname\".
+If last-first format names as \"Lastname, Firstname\".
+If `bbdb-mail-name' returns the full name as a single string, this takes
+precedence over `bbdb-mail-name-format'. Likewise, if the mail address itself
+includes a name, this is not reformatted."
+ :group 'bbdb-sendmail
+ :type '(choice (const :tag "Firstname Lastname" first-last)
+ (const :tag "Lastname, Firstname" last-first)))
+
+(defcustom bbdb-mail-name 'mail-name
+ "Xfield holding the full name for a record when sending mail.
+This may also be a function taking one argument, a record.
+If it returns the full mail name as a single string, this is used \"as is\".
+If it returns a cons pair (FIRST . LAST) with the first and last name
+for this record, these are formatted obeying `bbdb-mail-name-format'."
+ :group 'bbdb-sendmail
+ :type '(choice (symbol :tag "xfield")
+ (function :tag "mail name function")))
+
+(defcustom bbdb-mail-alias-field 'mail-alias
+ "Xfield holding the mail alias for a record.
+Used by `bbdb-mail-aliases'. See also `bbdb-mail-alias'."
+ :group 'bbdb-sendmail
+ :type 'symbol)
+
+(defcustom bbdb-mail-alias 'first
+ "Defines which mail aliases are generated for a BBDB record.
+first: Generate one alias \"<alias>\" that expands to the first mail address
+ of a record.
+star: Generate a second alias \"<alias>*\" that expands to all mail addresses
+ of a record.
+all: Generate the aliases \"<alias>\" and \"<alias>*\" (as for 'star)
+ and aliases \"<alias>n\" for each mail address, where n is the position
+ of the mail address of a record."
+ :group 'bbdb-sendmail
+ :type '(choice (symbol :tag "Only first" first)
+ (symbol :tag "<alias>* for all mails" star)
+ (symbol :tag "All aliases" all)))
+
+(defcustom bbdb-mail-avoid-redundancy nil
+ "Mail address to use for BBDB records when sending mail.
+If non-nil do not use full name in mail address when same as mail.
+If value is mail-only never use full name."
+ :group 'bbdb-sendmail
+ :type '(choice (const :tag "Allow redundancy" nil)
+ (const :tag "Never use full name" mail-only)
+ (const :tag "Avoid redundancy" t)))
+
+(defcustom bbdb-complete-mail t
+ "If t MUA insinuation provides key binding for command `bbdb-complete-mail'."
+ :group 'bbdb-sendmail
+ :type 'boolean)
+
+(defcustom bbdb-completion-list t
+ "Controls the behaviour of `bbdb-complete-mail'.
+If a list of symbols, it specifies which fields to complete. Symbols include
+ fl-name (= first and last name)
+ lf-name (= last and first name)
+ organization
+ aka
+ mail (= all email addresses of each record)
+ primary (= first email address of each record)
+If t, completion is done for all of the above.
+If nil, no completion is offered."
+ ;; These symbols match the fields for which BBDB provides entries in
+ ;; `bbdb-hashtable'.
+ :group 'bbdb-sendmail
+ :type '(choice (const :tag "No Completion" nil)
+ (const :tag "Complete across all fields" t)
+ (repeat :tag "Field"
+ (choice (const fl-name)
+ (const lf-name)
+ (const aka)
+ (const organization)
+ (const primary)
+ (const mail)))))
+
+(defcustom bbdb-complete-mail-allow-cycling nil
+ "If non-nil cycle mail addresses when calling `bbdb-complete-mail'."
+ :group 'bbdb-sendmail
+ :type 'boolean)
+
+(defcustom bbdb-complete-mail-hook nil
+ "List of functions called after a sucessful completion."
+ :group 'bbdb-sendmail
+ :type 'hook)
+
+(defcustom bbdb-mail-abbrev-expand-hook nil
+ ;; Replacement for function `mail-abbrev-expand-hook'.
+ "Function (not hook) run each time an alias is expanded.
+The function is called with two args the alias and the list
+of corresponding mail addresses."
+ :group 'bbdb-sendmail
+ :type 'function)
+
+(defcustom bbdb-completion-display-record t
+ "If non-nil `bbdb-complete-mail' displays the BBDB record after completion."
+ :group 'bbdb-sendmail
+ :type '(choice (const :tag "Update the BBDB buffer" t)
+ (const :tag "Do not update the BBDB buffer" nil)))
+
+\f
+;;;Dialing
+(defcustom bbdb-dial-local-prefix-alist
+ '(((if (integerp bbdb-default-area-code)
+ (format "(%03d)" bbdb-default-area-code)
+ (or bbdb-default-area-code ""))
+ . ""))
+ "Mapping to remove local prefixes from numbers.
+If this is non-nil, it should be an alist of
+\(PREFIX . REPLACEMENT) elements. The first part of a phone number
+matching the regexp returned by evaluating PREFIX will be replaced by
+the corresponding REPLACEMENT when dialing."
+ :group 'bbdb-utilities-dialing
+ :type 'sexp)
+
+(defcustom bbdb-dial-local-prefix nil
+ "Local prefix digits.
+If this is non-nil, it should be a string of digits which your phone
+system requires before making local calls (for example, if your phone system
+requires you to dial 9 before making outside calls.) In BBDB's
+opinion, you're dialing a local number if it starts with a 0 after
+processing `bbdb-dial-local-prefix-alist'."
+ :group 'bbdb-utilities-dialing
+ :type '(choice (const :tag "No digits required" nil)
+ (string :tag "Dial this first" "9")))
+
+(defcustom bbdb-dial-long-distance-prefix nil
+ "Long distance prefix digits.
+If this is non-nil, it should be a string of digits which your phone
+system requires before making a long distance call (one not in your local
+area code). For example, in some areas you must dial 1 before an area
+code. Note that this is used to replace the + sign in phone numbers
+when dialling (international dialing prefix.)"
+ :group 'bbdb-utilities-dialing
+ :type '(choice (const :tag "No digits required" nil)
+ (string :tag "Dial this first" "1")))
+
+(defcustom bbdb-dial-function nil
+ "If non-nil this should be a function used for dialing phone numbers.
+This function is used by `bbdb-dial-number'. It requires one
+argument which is a string for the number that is dialed.
+If nil then `bbdb-dial-number' uses the tel URI syntax passed to `browse-url'
+to make the call."
+ :group 'bbdb-utilities-dialing
+ :type 'function)
+
+\f
+;; Faces for font-lock
+(defgroup bbdb-faces nil
+ "Faces used by BBDB."
+ :group 'bbdb
+ :group 'faces)
+
+(defface bbdb-name
+ '((t (:inherit font-lock-function-name-face)))
+ "Face used for BBDB names."
+ :group 'bbdb-faces)
+
+;; KEY needs to match the value of the xfield name-face, which is a string.
+;; To avoid confusion, we make KEY a string, too, though symbols might be
+;; faster.
+(defcustom bbdb-name-face-alist nil
+ "Alist used for font-locking the name of a record.
+Each element should be a cons cell (KEY . FACE) with string KEY and face FACE.
+To use FACE for font-locking the name of a record,
+the xfield name-face of this record should have the value KEY.
+The value of name-face may also be a face which is then used directly.
+If none of these schemes succeeds, the face `bbdb-name' is used."
+ :group 'bbdb-faces
+ :type '(repeat (cons (symbol :tag "Key") (face :tag "Face"))))
+
+(defface bbdb-organization
+ '((t (:inherit font-lock-comment-face)))
+ "Face used for BBDB names."
+ :group 'bbdb-faces)
+
+(defface bbdb-field-name
+ '((t (:inherit font-lock-variable-name-face)))
+ "Face used for BBDB names."
+ :group 'bbdb-faces)
+
+;;; Internal variables
+(eval-and-compile
+ (defvar bbdb-debug t
+ "Enable debugging if non-nil during compile time.
+You really should not disable debugging. But it will speed things up."))
+
+(defconst bbdb-file-format 9
+ "BBDB file format.")
+
+(defconst bbdb-record-type
+ '(vector (or string (const nil)) ; first name
+ (or string (const nil)) ; last name
+ (repeat string) ; affix
+ (repeat string) ; aka
+ (repeat string) ; organization
+ (repeat (or (vector string string)
+ (vector string integer integer integer integer))) ; phone
+ (repeat (vector string (repeat string) string string
+ string string)) ; address
+ (repeat string) ; mail
+ (repeat (cons symbol sexp)) ; xfields
+ (cons symbol string) ; uuid
+ (cons symbol string) ; creation-date
+ (cons symbol string) ; timestamp
+ sexp) ; cache
+ "Pseudo-code for the structure of a record. Used by `bbdb-check-type'.")
+
+(defconst bbdb-file-coding-system 'utf-8
+ "Coding system used for reading and writing `bbdb-file'.")
+
+(defvar bbdb-mail-aliases-need-rebuilt nil
+ "Non-nil if mail aliases need to be rebuilt.")
+
+(defvar bbdb-buffer nil "Buffer visiting `bbdb-file'.")
+
+(defvar bbdb-buffer-name "*BBDB*" "Name of the BBDB buffer.")
+
+(defvar bbdb-silent-internal nil
+ "Bind this to t to quiet things down - do not set it.
+See also `bbdb-silent'.")
+
+(defvar bbdb-init-forms
+ '((gnus ; gnus 3.15 or newer
+ (add-hook 'gnus-startup-hook 'bbdb-insinuate-gnus))
+ (mh-e ; MH-E
+ (add-hook 'mh-folder-mode-hook 'bbdb-insinuate-mh))
+ (rmail ; RMAIL
+ (add-hook 'rmail-mode-hook 'bbdb-insinuate-rmail))
+ (vm ; newer versions of vm do not have `vm-load-hook'
+ (eval-after-load "vm" '(bbdb-insinuate-vm)))
+ (mail ; the standard mail user agent
+ (add-hook 'mail-setup-hook 'bbdb-insinuate-mail))
+ (sendmail
+ (progn (message "BBDB: sendmail insinuation deprecated. Use mail.")
+ (add-hook 'mail-setup-hook 'bbdb-insinuate-mail)))
+ (message ; the gnus mail user agent
+ (add-hook 'message-setup-hook 'bbdb-insinuate-message))
+ (mu4e ; the mu4e user agent
+ (add-hook 'mu4e-main-mode-hook 'bbdb-insinuate-mu4e))
+
+ (sc ; supercite
+ (add-hook 'sc-load-hook 'bbdb-insinuate-sc))
+ (anniv ; anniversaries
+ (add-hook 'diary-list-entries-hook 'bbdb-anniv-diary-entries))
+ (pgp ; pgp-mail
+ (progn
+ (add-hook 'message-send-hook 'bbdb-pgp)
+ (add-hook 'mail-send-hook 'bbdb-pgp)))
+ (wl
+ (add-hook 'wl-init-hook 'bbdb-insinuate-wl)))
+ "Alist mapping features to insinuation forms.")
+
+(defvar bbdb-search-invert nil
+ "Bind this variable to t in order to invert the result of `bbdb-search'.")
+
+(defvar bbdb-do-all-records nil
+ "Controls the behavior of the command `bbdb-do-all-records'.")
+
+(defvar bbdb-append-display nil
+ "Controls the behavior of the command `bbdb-append-display'.")
+
+(defvar bbdb-offer-to-create nil
+ "For communication between `bbdb-update-records' and `bbdb-query-create'.")
+
+(defvar bbdb-update-records-address nil
+ "For communication between `bbdb-update-records' and `bbdb-query-create'.
+It is a list with elements (NAME MAIL HEADER HEADER-CLASS MUA).")
+
+;;; Buffer-local variables for the database.
+(defvar bbdb-records nil
+ "BBDB records list.
+In buffer `bbdb-file' this list includes all records.
+In the *BBDB* buffers it includes the records that are actually displayed
+and its elements are (RECORD DISPLAY-FORMAT MARKER-POS).")
+(make-variable-buffer-local 'bbdb-records)
+
+(defvar bbdb-changed-records nil
+ "List of records that has been changed since BBDB was last saved.
+Use `bbdb-search-changed' to display these records.")
+
+(defvar bbdb-end-marker nil
+ "Marker holding the buffer position of the end of the last record.")
+
+(defvar bbdb-hashtable (make-hash-table :test 'equal)
+ "Hash table for BBDB records.
+Hashes the fields first-last-name, last-first-name, organization, aka, and mail.")
+
+(defvar bbdb-uuid-table (make-hash-table :test 'equal)
+ "Hash table for uuid's of BBDB records.")
+
+(defvar bbdb-xfield-label-list nil
+ "List of labels for xfields.")
+
+(defvar bbdb-organization-list nil
+ "List of organizations known to BBDB.")
+
+(defvar bbdb-street-list nil
+ "List of streets known to BBDB.")
+
+(defvar bbdb-city-list nil
+ "List of cities known to BBDB.")
+
+(defvar bbdb-state-list nil
+ "List of states known to BBDB.")
+
+(defvar bbdb-postcode-list nil
+ "List of post codes known to BBDB.")
+
+(defvar bbdb-country-list nil
+ "List of countries known to BBDB.")
+
+(defvar bbdb-modeline-info (make-vector 6 nil)
+ "Precalculated mode line info for BBDB commands.
+This is a vector [APPEND-M APPEND INVERT-M INVERT ALL-M ALL].
+APPEND-M is the mode line info if `bbdb-append-display' is non-nil.
+INVERT-M is the mode line info if `bbdb-search-invert' is non-nil.
+ALL-M is the mode line info if `bbdb-do-all-records' is non-nil.
+APPEND, INVERT, and ALL appear in the message area.")
+
+(defvar bbdb-update-unchanged-records nil
+ "If non-nil update unchanged records in the database.
+Normally calls of `bbdb-change-hook' and updating of a record are suppressed,
+if an editing command did not really change the record. Bind this to t
+if you want to call `bbdb-change-hook' and update the record unconditionally.")
+
+;;; Keymap
+(defvar bbdb-mode-map
+ (let ((km (make-sparse-keymap)))
+ (define-key km "*" 'bbdb-do-all-records)
+ (define-key km "+" 'bbdb-append-display)
+ (define-key km "!" 'bbdb-search-invert)
+ (define-key km "a" 'bbdb-add-mail-alias)
+ (define-key km "A" 'bbdb-mail-aliases)
+ (define-key km "c" 'bbdb-create)
+ (define-key km "e" 'bbdb-edit-field)
+ (define-key km ";" 'bbdb-edit-foo)
+ (define-key km "n" 'bbdb-next-record)
+ (define-key km "p" 'bbdb-prev-record)
+ (define-key km "N" 'bbdb-next-field)
+ (define-key km "\t" 'bbdb-next-field) ; TAB
+ (define-key km "P" 'bbdb-prev-field)
+ (define-key km "\d" 'bbdb-prev-field) ; DEL
+ (define-key km "d" 'bbdb-delete-field-or-record)
+ (define-key km "\C-k" 'bbdb-delete-field-or-record)
+ (define-key km "i" 'bbdb-insert-field)
+ (define-key km "s" 'bbdb-save)
+ (define-key km "\C-x\C-s" 'bbdb-save)
+ (define-key km "t" 'bbdb-toggle-records-layout)
+ (define-key km "T" 'bbdb-display-records-completely)
+ (define-key km "o" 'bbdb-omit-record)
+ (define-key km "m" 'bbdb-mail)
+ (define-key km "M" 'bbdb-mail-address)
+ (define-key km "\M-d" 'bbdb-dial)
+ (define-key km "h" 'bbdb-info)
+ (define-key km "?" 'bbdb-help)
+ ;; (define-key km "q" 'quit-window) ; part of `special-mode' bindings
+ (define-key km "\C-x\C-t" 'bbdb-transpose-fields)
+ (define-key km "Cr" 'bbdb-copy-records-as-kill)
+ (define-key km "Cf" 'bbdb-copy-fields-as-kill)
+ (define-key km "u" 'bbdb-browse-url)
+ (define-key km "\C-c\C-t" 'bbdb-tex)
+ (define-key km "=" 'delete-other-windows)
+
+ ;; Search keys
+ (define-key km "b" 'bbdb)
+ (define-key km "/1" 'bbdb-display-records)
+ (define-key km "/n" 'bbdb-search-name)
+ (define-key km "/o" 'bbdb-search-organization)
+ (define-key km "/p" 'bbdb-search-phone)
+ (define-key km "/a" 'bbdb-search-address)
+ (define-key km "/m" 'bbdb-search-mail)
+ (define-key km "/N" 'bbdb-search-xfields)
+ (define-key km "/x" 'bbdb-search-xfields)
+ (define-key km "/c" 'bbdb-search-changed)
+ (define-key km "/d" 'bbdb-search-duplicates)
+ (define-key km "\C-xnw" 'bbdb-display-all-records)
+ (define-key km "\C-xnd" 'bbdb-display-current-record)
+
+ (define-key km [delete] 'scroll-down) ; 24.1: part of `special-mode'
+ (define-key km " " 'scroll-up) ; 24.1: part of `special-mode'
+
+ (define-key km [mouse-3] 'bbdb-mouse-menu)
+ (define-key km [mouse-2] (lambda (event)
+ ;; Toggle record layout
+ (interactive "e")
+ (save-excursion
+ (posn-set-point (event-end event))
+ (bbdb-toggle-records-layout
+ (bbdb-do-records t) current-prefix-arg))))
+ km)
+ "Keymap for Insidious Big Brother Database.
+This is a child of `special-mode-map'.")
+
+(easy-menu-define
+ bbdb-menu bbdb-mode-map "BBDB Menu"
+ '("BBDB"
+ ("Display"
+ ["Previous field" bbdb-prev-field t]
+ ["Next field" bbdb-next-field t]
+ ["Previous record" bbdb-prev-record t]
+ ["Next record" bbdb-next-record t]
+ "--"
+ ["Show all records" bbdb-display-all-records t]
+ ["Show current record" bbdb-display-current-record t]
+ ["Omit record" bbdb-omit-record t]
+ "--"
+ ["Toggle layout" bbdb-toggle-records-layout t]
+ ["Show all fields" bbdb-display-records-completely t])
+ ("Searching"
+ ["General search" bbdb t]
+ ["Search one record" bbdb-display-records t]
+ ["Search name" bbdb-search-name t]
+ ["Search organization" bbdb-search-organization t]
+ ["Search phone" bbdb-search-phone t]
+ ["Search address" bbdb-search-address t]
+ ["Search mail" bbdb-search-mail t]
+ ["Search xfields" bbdb-search-xfields t]
+ ["Search changed records" bbdb-search-changed t]
+ ["Search duplicates" bbdb-search-duplicates t]
+ "--"
+ ["Old time stamps" bbdb-timestamp-older t]
+ ["New time stamps" bbdb-timestamp-newer t]
+ ["Old creation date" bbdb-creation-older t]
+ ["New creation date" bbdb-creation-newer t]
+ ["Creation date = time stamp" bbdb-creation-no-change t]
+ "--"
+ ["Append search" bbdb-append-display t]
+ ["Invert search" bbdb-search-invert t])
+ ("Mail"
+ ["Send mail" bbdb-mail t]
+ ["Save mail address" bbdb-mail-address t]
+ "--"
+ ["Add mail alias" bbdb-add-mail-alias t]
+ ["(Re-)Build mail aliases" bbdb-mail-aliases t])
+ ("Use database"
+ ["Prefix: do all records" bbdb-do-all-records t]
+ "--"
+ ["Send mail" bbdb-mail t]
+ ["Dial phone number" bbdb-dial t]
+ ["Browse URL" bbdb-browse-url t]
+ ["Copy records as kill" bbdb-copy-records-as-kill t]
+ ["Copy fields as kill" bbdb-copy-fields-as-kill t]
+ "--"
+ ["TeX records" bbdb-tex t])
+ ("Manipulate database"
+ ["Prefix: do all records" bbdb-do-all-records t]
+ "--"
+ ["Create new record" bbdb-create t]
+ ["Edit current field" bbdb-edit-field t]
+ ["Insert new field" bbdb-insert-field t]
+ ["Edit some field" bbdb-edit-foo t]
+ ["Transpose fields" bbdb-transpose-fields t]
+ ["Delete record or field" bbdb-delete-field-or-record t]
+ "--"
+ ["Sort addresses" bbdb-sort-addresses t]
+ ["Sort phones" bbdb-sort-phones t]
+ ["Sort xfields" bbdb-sort-xfields t]
+ ["Merge records" bbdb-merge-records t]
+ ["Sort database" bbdb-sort-records t]
+ ["Delete duplicate mails" bbdb-delete-redundant-mails t]
+ "--"
+ ["Save BBDB" bbdb-save t]
+ ["Revert BBDB" revert-buffer t])
+ ("Help"
+ ["Brief help" bbdb-help t]
+ ["BBDB Manual" bbdb-info t])
+ "--"
+ ["Quit" quit-window t]))
+
+(defvar bbdb-completing-read-mails-map
+ (let ((map (copy-keymap minibuffer-local-completion-map)))
+ (define-key map " " 'self-insert-command)
+ (define-key map "\t" 'bbdb-complete-mail)
+ (define-key map "\M-\t" 'bbdb-complete-mail)
+ map)
+ "Keymap used by `bbdb-completing-read-mails'.")
+
+\f
+
+;;; Helper functions
+
+(defun bbdb-warn (&rest args)
+ "Display a message at the bottom of the screen.
+ARGS are passed to `message'."
+ (ding t)
+ (apply 'message args))
+
+(defun bbdb-string-trim (string &optional null)
+ "Remove leading and trailing whitespace and all properties from STRING.
+If STRING is nil return an empty string unless NULL is non-nil."
+ (if (null string)
+ (unless null "")
+ (setq string (substring-no-properties string))
+ (if (string-match "\\`[ \t\n]+" string)
+ (setq string (substring-no-properties string (match-end 0))))
+ (if (string-match "[ \t\n]+\\'" string)
+ (setq string (substring-no-properties string 0 (match-beginning 0))))
+ (unless (and null (string= "" string))
+ string)))
+
+(defsubst bbdb-string= (str1 str2)
+ "Return t if strings STR1 and STR2 are equal, ignoring case."
+ (and (stringp str1) (stringp str2)
+ (eq t (compare-strings str1 0 nil str2 0 nil t))))
+
+(defun bbdb-split (separator string)
+ "Split STRING into list of substrings bounded by matches for SEPARATORS.
+SEPARATOR may be a regexp. SEPARATOR may also be a symbol
+\(a field name). Then look up the value in `bbdb-separator-alist'
+or use `bbdb-default-separator'.
+Whitespace around SEPARATOR is ignored unless SEPARATOR matches
+the string \" \\t\\n\".
+Almost the inverse function of `bbdb-concat'."
+ (if (symbolp separator)
+ (setq separator (car (or (cdr (assq separator bbdb-separator-alist))
+ bbdb-default-separator))))
+ (if (<= 24.4 (string-to-number emacs-version))
+ ;; `split-string' applied to an empty STRING gives nil.
+ (split-string string separator t
+ (unless (string-match separator " \t\n") "[ \t\n]*"))
+ (unless (string-match separator " \t\n")
+ (setq separator (concat "[ \t\n]*" separator "[ \t\n]*")))
+ (split-string (bbdb-string-trim string) separator t)))
+
+(defun bbdb-concat (separator &rest strings)
+ "Concatenate STRINGS to a string sticking in SEPARATOR.
+STRINGS may be strings or lists of strings. Empty strings are ignored.
+SEPARATOR may be a string.
+SEPARATOR may also be a symbol (a field name). Then look up the value
+of SEPARATOR in `bbdb-separator-alist' or use `bbdb-default-separator'.
+The inverse function of `bbdb-split'."
+ (if (symbolp separator)
+ (setq separator (nth 1 (or (cdr (assq separator bbdb-separator-alist))
+ bbdb-default-separator))))
+ (mapconcat 'identity
+ (delete "" (apply 'append (mapcar (lambda (x) (if (stringp x)
+ (list x) x))
+ strings))) separator))
+
+(defun bbdb-list-strings (list)
+ "Remove all elements from LIST which are not non-empty strings."
+ (let (new-list)
+ (dolist (elt list)
+ (if (and (stringp elt) (not (string= "" elt)))
+ (push elt new-list)))
+ (nreverse new-list)))
+
+;; A call of `indent-region' swallows any indentation
+;; that might be part of the field itself. So we indent manually.
+(defsubst bbdb-indent-string (string column)
+ "Indent nonempty lines in STRING to COLUMN (except first line).
+This happens in addition to any pre-defined indentation of STRING."
+ (replace-regexp-in-string "\n\\([^\n]\\)"
+ (concat "\n" (make-string column ?\s) "\\1")
+ string))
+
+(defun bbdb-read-string (prompt &optional init collection require-match)
+ "Read a string, trimming whitespace and text properties.
+PROMPT is a string to prompt with.
+INIT appears as initial input which is useful for editing existing records.
+COLLECTION and REQUIRE-MATCH have the same meaning as in `completing-read'."
+ (bbdb-string-trim
+ (if collection
+ ;; Hack: In `minibuffer-local-completion-map' remove
+ ;; the binding of SPC to `minibuffer-complete-word'
+ ;; and of ? to `minibuffer-completion-help'.
+ (minibuffer-with-setup-hook
+ (lambda ()
+ (use-local-map
+ (let ((map (make-sparse-keymap)))
+ (set-keymap-parent map (current-local-map))
+ (define-key map " " nil)
+ (define-key map "?" nil)
+ map)))
+ (completing-read prompt collection nil require-match init))
+ (read-string prompt init))))
+
+;; The following macros implement variants of `pushnew' (till emacs 24.2)
+;; or `cl-pushnew' (since emacs 24.3). To be compatible with older and newer
+;; versions of emacs we use our own macros. We call these macros often.
+;; So we keep them simple. Nothing fancy is needed here.
+(defmacro bbdb-pushnew (element listname)
+ "Add ELEMENT to the value of LISTNAME if it isn't there yet.
+The test for presence of ELEMENT is done with `equal'.
+The return value is the new value of LISTNAME."
+ `(let ((elt ,element))
+ (if (member elt ,listname)
+ ,listname
+ (setq ,listname (cons elt ,listname)))))
+
+(defmacro bbdb-pushnewq (element listname)
+ "Add ELEMENT to the value of LISTNAME if it isn't there yet.
+The test for presence of ELEMENT is done with `eq'.
+The return value is the new value of LISTNAME."
+ `(let ((elt ,element))
+ (if (memq elt ,listname)
+ ,listname
+ (setq ,listname (cons elt ,listname)))))
+
+(defmacro bbdb-pushnewt (element listname)
+ "Add ELEMENT to the value of LISTNAME if it isn't there yet and non-nil.
+The test for presence of ELEMENT is done with `equal'.
+The return value is the new value of LISTNAME."
+ `(let ((elt ,element))
+ (if (or (not elt)
+ (member elt ,listname))
+ ,listname
+ (setq ,listname (cons elt ,listname)))))
+
+(defun bbdb-current-record (&optional full)
+ "Return the record point is at.
+If FULL is non-nil record includes the display information."
+ (unless (eq major-mode 'bbdb-mode)
+ (error "This only works while in BBDB buffers."))
+ (let ((num (get-text-property (if (and (not (bobp)) (eobp))
+ (1- (point)) (point))
+ 'bbdb-record-number))
+ record)
+ (unless num (error "Not a BBDB record"))
+ (setq record (nth num bbdb-records))
+ (if full record (car record))))
+
+(defun bbdb-current-field ()
+ "Return current field point is on."
+ (unless (bbdb-current-record) (error "Not a BBDB record"))
+ (get-text-property (point) 'bbdb-field))
+
+(defmacro bbdb-debug (&rest body)
+ "Excecute BODY just like `progn' with debugging capability.
+Debugging is enabled if variable `bbdb-debug' is non-nil during compile.
+You really should not disable debugging. But it will speed things up."
+ (declare (indent 0))
+ (if bbdb-debug ; compile-time switch
+ `(let ((debug-on-error t))
+ ,@body)))
+
+;; inspired by `gnus-bind-print-variables'
+(defmacro bbdb-with-print-loadably (&rest body)
+ "Bind print-* variables for BBDB and evaluate BODY.
+This macro is used with `prin1', `prin1-to-string', etc. in order to ensure
+printed Lisp objects are loadable by BBDB."
+ (declare (indent 0))
+ `(let ((print-escape-newlines t) ;; BBDB needs this!
+ print-escape-nonascii print-escape-multibyte
+ print-quoted print-length print-level)
+ ;; print-circle print-gensym
+ ;; print-continuous-numbering
+ ;; print-number-table
+ ;; float-output-format
+ ,@body))
+
+(defun bbdb-timestamp (_record)
+ ""
+ (unless (get 'bbdb-timestamp 'bbdb-obsolete)
+ (put 'bbdb-timestamp 'bbdb-obsolete t)
+ (message "Function `bbdb-timestamp' is obsolete. Remove it from any hooks.")
+ (sit-for 2)))
+(make-obsolete 'bbdb-timestamp nil "2017-08-09")
+
+(defun bbdb-creation-date (_record)
+ ""
+ (unless (get 'bbdb-creation-date 'bbdb-obsolete)
+ (put 'bbdb-creation-date 'bbdb-obsolete t)
+ (message "Function `bbdb-creation-date' is obsolete. Remove it from any hooks.")
+ (sit-for 2)))
+(make-obsolete 'bbdb-creation-date nil "2017-08-09")
+
+;; Copied from org-id.el
+(defun bbdb-uuid ()
+ "Return string with random (version 4) UUID."
+ (let ((rnd (md5 (format "%s%s%s%s%s%s%s"
+ (random)
+ (current-time)
+ (user-uid)
+ (emacs-pid)
+ (user-full-name)
+ user-mail-address
+ (recent-keys)))))
+ (format "%s-%s-4%s-%s%s-%s"
+ (substring rnd 0 8)
+ (substring rnd 8 12)
+ (substring rnd 13 16)
+ (format "%x"
+ (logior
+ #b10000000
+ (logand
+ #b10111111
+ (string-to-number
+ (substring rnd 16 18) 16))))
+ (substring rnd 18 20)
+ (substring rnd 20 32))))
+
+(defun bbdb-multiple-buffers-default ()
+ "Default function for guessing a name for new *BBDB* buffers.
+May be used as value of variable `bbdb-multiple-buffers'."
+ (save-current-buffer
+ (cond ((memq major-mode '(vm-mode vm-summary-mode vm-presentation-mode
+ vm-virtual-mode))
+ (vm-select-folder-buffer)
+ (buffer-name))
+ ((memq major-mode '(gnus-summary-mode gnus-group-mode))
+ (set-buffer gnus-article-buffer)
+ (buffer-name))
+ ((memq major-mode '(mail-mode vm-mail-mode message-mode))
+ "message composition"))))
+
+(defsubst bbdb-add-job (spec record string)
+ "Internal function: Evaluate SPEC for RECORD and STRING.
+If SPEC is a function call it with args RECORD and STRING. Return value.
+If SPEC is a regexp, return 'query unless SPEC matches STRING.
+Otherwise return SPEC.
+Used with variable `bbdb-add-name' and friends."
+ (cond ((functionp spec)
+ (funcall spec record string))
+ ((stringp spec)
+ (unless (string-match spec string) 'query)) ; be least aggressive
+ (spec)))
+
+(defsubst bbdb-eval-spec (spec prompt)
+ "Internal function: Evaluate SPEC using PROMPT.
+Return t if either SPEC equals t, or SPEC equals 'query and `bbdb-silent'
+is non-nil or `y-or-no-p' returns t using PROMPT.
+Used with return values of `bbdb-add-job'."
+ (or (eq spec t)
+ (and (eq spec 'query)
+ (or bbdb-silent (y-or-n-p prompt)))))
+
+(defun bbdb-clean-address-components (components)
+ "Clean mail address COMPONENTS.
+COMPONENTS is a list (FULL-NAME CANONICAL-ADDRESS) as returned
+by `mail-extract-address-components'.
+Pass FULL-NAME through `bbdb-message-clean-name-function'
+and CANONICAL-ADDRESS through `bbdb-canonicalize-mail-function'."
+ (list (if (car components)
+ (if bbdb-message-clean-name-function
+ (funcall bbdb-message-clean-name-function (car components))
+ (car components)))
+ (if (cadr components)
+ (if bbdb-canonicalize-mail-function
+ (funcall bbdb-canonicalize-mail-function (cadr components))
+ ;; Minimalistic clean-up
+ (bbdb-string-trim (cadr components))))))
+
+(defun bbdb-extract-address-components (address &optional all)
+ "Given an RFC-822 address ADDRESS, extract full name and canonical address.
+This function behaves like `mail-extract-address-components', but it passes
+its return value through `bbdb-clean-address-components'.
+See also `bbdb-decompose-bbdb-address'."
+ (if all
+ (mapcar 'bbdb-clean-address-components
+ (mail-extract-address-components address t))
+ (bbdb-clean-address-components (mail-extract-address-components address))))
+
+;; Inspired by `gnus-extract-address-components' from gnus-utils.
+(defun bbdb-decompose-bbdb-address (mail)
+ "Given an RFC-822 address MAIL, extract full name and canonical address.
+In general, this function behaves like the more sophisticated function
+`mail-extract-address-components'. Yet for an address `<Joe_Smith@foo.com>'
+lacking a real name the latter function returns the name \"Joe Smith\".
+This is useful when analyzing the headers of email messages we receive
+from the outside world. Yet when analyzing the mail addresses stored
+in BBDB, this pollutes the mail-aka space. So we define here
+an intentionally much simpler function for decomposing the names
+and canonical addresses in the mail field of BBDB records."
+ (let (name address)
+ ;; First find the address - the thing with the @ in it.
+ (cond (;; Check `<foo@bar>' first in order to handle the quite common
+ ;; form `"abc@xyz" <foo@bar>' (i.e. `@' as part of a comment)
+ ;; correctly.
+ (string-match "<\\([^@ \t<>]+[!@][^@ \t<>]+\\)>" mail)
+ (setq address (match-string 1 mail)))
+ ((string-match "\\b[^@ \t<>]+[!@][^@ \t<>]+\\b" mail)
+ (setq address (match-string 0 mail))))
+ ;; Then check whether the `name <address>' format is used.
+ (and address
+ ;; Linear white space is not required.
+ (string-match (concat "[ \t]*<" (regexp-quote address) ">") mail)
+ (setq name (substring mail 0 (match-beginning 0)))
+ ;; Strip any quotes mail the name.
+ (string-match "^\".*\"$" name)
+ (setq name (substring name 1 (1- (match-end 0)))))
+ ;; If not, then check whether the `address (name)' format is used.
+ (or name
+ (and (string-match "(\\([^)]+\\))" mail)
+ (setq name (match-string 1 mail))))
+ (list (if (equal name "") nil name) (or address mail))))
+
+;;; Massage of mail addresses
+
+(defcustom bbdb-canonical-hosts
+ ;; Example
+ (regexp-opt '("cs.cmu.edu" "ri.cmu.edu"))
+ "Regexp matching the canonical part of the domain part of a mail address.
+If the domain part of a mail address matches this regexp, the domain
+is replaced by the substring that actually matched this address.
+
+Used by `bbdb-canonicalize-mail-1'. See also `bbdb-ignore-redundant-mails'."
+ :group 'bbdb-mua
+ :type '(regexp :tag "Regexp matching sites"))
+
+(defun bbdb-canonicalize-mail-1 (address)
+ "Example of `bbdb-canonicalize-mail-function'.
+However, this function is too specific to be useful for the general user.
+Take it as a source of inspiration for what can be done."
+ (setq address (bbdb-string-trim address))
+ (cond
+ ;; Rewrite mail-drop hosts.
+ ;; RW: The following is now also handled by `bbdb-ignore-redundant-mails'
+ ((string-match
+ (concat "\\`\\([^@%!]+@\\).*\\.\\(" bbdb-canonical-hosts "\\)\\'")
+ address)
+ (concat (match-string 1 address) (match-string 2 address)))
+ ;;
+ ;; Here at Lucid, our workstation names sometimes get into our mail
+ ;; addresses in the form "jwz%thalidomide@lucid.com" (instead of simply
+ ;; "jwz@lucid.com"). This removes the workstation name.
+ ((string-match "\\`\\([^@%!]+\\)%[^@%!.]+@\\(lucid\\.com\\)\\'" address)
+ (concat (match-string 1 address) "@" (match-string 2 address)))
+ ;;
+ ;; Another way that our local mailer is misconfigured: sometimes addresses
+ ;; which should look like "user@some.outside.host" end up looking like
+ ;; "user%some.outside.host" or even "user%some.outside.host@lucid.com"
+ ;; instead. This rule rewrites it into the original form.
+ ((string-match "\\`\\([^@%]+\\)%\\([^@%!]+\\)\\(@lucid\\.com\\)?\\'" address)
+ (concat (match-string 1 address) "@" (match-string 2 address)))
+ ;;
+ ;; Sometimes I see addresses like "foobar.com!user@foobar.com".
+ ;; That's totally redundant, so this rewrites it as "user@foobar.com".
+ ((string-match "\\`\\([^@%!]+\\)!\\([^@%!]+[@%]\\1\\)\\'" address)
+ (match-string 2 address))
+ ;;
+ ;; Sometimes I see addresses like "foobar.com!user". Turn it around.
+ ((string-match "\\`\\([^@%!.]+\\.[^@%!]+\\)!\\([^@%]+\\)\\'" address)
+ (concat (match-string 2 address) "@" (match-string 1 address)))
+ ;;
+ ;; The mailer at hplb.hpl.hp.com tends to puke all over addresses which
+ ;; pass through mailing lists which are maintained there: it turns normal
+ ;; addresses like "user@foo.com" into "user%foo.com@hplb.hpl.hp.com".
+ ;; This reverses it. (I actually could have combined this rule with
+ ;; the similar lucid.com rule above, but then the regexp would have been
+ ;; more than 80 characters long...)
+ ((string-match "\\`\\([^@!]+\\)%\\([^@%!]+\\)@hplb\\.hpl\\.hp\\.com\\'"
+ address)
+ (concat (match-string 1 address) "@" (match-string 2 address)))
+ ;;
+ ;; Another local mail-configuration botch: sometimes mail shows up
+ ;; with addresses like "user@workstation", where "workstation" is a
+ ;; local machine name. That should really be "user" or "user@netscape.com".
+ ;; (I'm told this one is due to a bug in SunOS 4.1.1 sendmail.)
+ ((string-match "\\`\\([^@%!]+\\)[@%][^@%!.]+\\'" address)
+ (match-string 1 address))
+ ;;
+ ;; Sometimes I see addresses like "foo%somewhere%uunet.uu.net@somewhere.else".
+ ;; This is silly, because I know that I can send mail to uunet directly.
+ ((string-match ".%uunet\\.uu\\.net@[^@%!]+\\'" address)
+ (concat (substring address 0 (+ (match-beginning 0) 1)) "@UUNET.UU.NET"))
+ ;;
+ ;; Otherwise, leave it as it is.
+ (t address)))
+
+(defun bbdb-message-clean-name-default (name)
+ "Default function for `bbdb-message-clean-name-function'.
+This strips garbage from the user full NAME string."
+ ;; Remove leading non-alpha chars
+ (if (string-match "\\`[^[:alpha:]]+" name)
+ (setq name (substring name (match-end 0))))
+
+ (if (string-match "^\\([^@]+\\)@" name)
+ ;; The name is really a mail address and we use the part preceeding "@".
+ ;; Everything following "@" is ignored.
+ (setq name (match-string 1 name)))
+
+ ;; Replace "firstname.surname" by "firstname surname".
+ ;; Do not replace ". " with " " because that could be an initial.
+ (setq name (replace-regexp-in-string "\\.\\([^ ]\\)" " \\1" name))
+
+ ;; Replace tabs, spaces, and underscores with a single space.
+ (setq name (replace-regexp-in-string "[ \t\n_]+" " " name))
+
+ ;; Remove trailing comments separated by "(" or " [-#]"
+ ;; This does not work all the time because some of our friends in
+ ;; northern europe have brackets in their names...
+ (if (string-match "[^ \t]\\([ \t]*\\((\\| [-#]\\)\\)" name)
+ (setq name (substring name 0 (match-beginning 1))))
+
+ ;; Remove phone extensions (like "x1234" and "ext. 1234")
+ (let ((case-fold-search t))
+ (setq name (replace-regexp-in-string
+ "\\W+\\(x\\|ext\\.?\\)\\W*[-0-9]+" "" name)))
+
+ ;; Remove trailing non-alpha chars
+ (if (string-match "[^[:alpha:]]+\\'" name)
+ (setq name (substring name 0 (match-beginning 0))))
+
+ ;; Remove text properties
+ (substring-no-properties name))
+
+;; BBDB data structure
+(defmacro bbdb-defstruct (name &rest elts)
+ "Define two functions to operate on vector NAME for each symbol ELT in ELTS.
+The function bbdb-NAME-ELT returns the element ELT in vector NAME.
+The function bbdb-NAME-set-ELT sets ELT.
+Also define a constant bbdb-NAME-length that holds the number of ELTS
+in vector NAME."
+ (declare (indent 1))
+ (let* ((count 0)
+ (sname (symbol-name name))
+ (uname (upcase sname))
+ (cname (concat "bbdb-" sname "-"))
+ body)
+ (dolist (elt elts)
+ (let* ((selt (symbol-name elt))
+ (setname (intern (concat cname "set-" selt))))
+ (push (list 'defsubst (intern (concat cname selt)) `(,name)
+ (format "For BBDB %s read element %i `%s'."
+ uname count selt)
+ ;; Use `elt' instead of `aref' so that these functions
+ ;; also work for the `bbdb-record-type' pseudo-code.
+ `(elt ,name ,count)) body)
+ (push (list 'defsubst setname `(,name value)
+ (format "For BBDB %s set element %i `%s' to VALUE. \
+Return VALUE.
+Do not call this function directly. Call instead `bbdb-record-set-field'
+which ensures the integrity of the database. Also, this makes your code
+more robust with respect to possible future changes of BBDB's innermost
+internals."
+ uname count selt)
+ `(aset ,name ,count value)) body))
+ (setq count (1+ count)))
+ (push (list 'defconst (intern (concat cname "length")) count
+ (concat "Length of BBDB `" sname "'.")) body)
+ (cons 'progn body)))
+
+;; Define RECORD:
+(bbdb-defstruct record
+ firstname lastname affix aka organization phone address mail xfields
+ uuid creation-date timestamp cache)
+
+;; Define PHONE:
+(bbdb-defstruct phone
+ label area exchange suffix extension)
+
+;; Define ADDRESS:
+(bbdb-defstruct address
+ label streets city state postcode country)
+
+;; Define record CACHE:
+;; - fl-name (first and last name of the person referred to by the record),
+;; - lf-name (last and first name of the person referred to by the record),
+;; - mail-aka (list of names associated with mail addresses)
+;; - mail-canon (list of canonical mail addresses)
+;; - sortkey (the concatenation of the elements used for sorting the record),
+;; - marker (position of beginning of record in `bbdb-file')
+(bbdb-defstruct cache
+ fl-name lf-name mail-aka mail-canon sortkey marker)
+
+(defsubst bbdb-record-mail-aka (record)
+ "Record cache function: Return mail-aka for RECORD."
+ (bbdb-cache-mail-aka (bbdb-record-cache record)))
+
+(defsubst bbdb-record-mail-canon (record)
+ "Record cache function: Return mail-canon for RECORD."
+ (bbdb-cache-mail-canon (bbdb-record-cache record)))
+
+(defun bbdb-empty-record ()
+ "Return a new empty record structure with a cache.
+It is the caller's responsibility to make the new record known to BBDB."
+ (let ((record (make-vector bbdb-record-length nil)))
+ (bbdb-record-set-cache record (make-vector bbdb-cache-length nil))
+ record))
+
+;; `bbdb-hashtable' associates with each KEY a list of matching records.
+;; KEY includes fl-name, lf-name, organizations, AKAs and email addresses.
+;; When loading the database the hash table is initialized by calling
+;; `bbdb-hash-record' for each record. This function is also called
+;; when new records are added to the database.
+;; `bbdb-delete-record-internal' with arg REMHASH non-nil removes a record
+;; from the hash table (besides deleting the record from the database).
+;; When an existing record is modified, the code that modifies the record
+;; needs to update the hash table, too. This includes removing the outdated
+;; associations between KEYs and record as well as adding the new associations.
+;; This is one reason to modify records by calling `bbdb-record-set-field'
+;; which properly updates the hash table.
+;; The hash table can be accessed via `bbdb-gethash'
+;; and via functions like `completing-read'.
+
+(defun bbdb-puthash (key record)
+ "Associate RECORD with KEY in `bbdb-hashtable'.
+KEY must be a string or nil. Empty strings and nil are ignored."
+ (if (and key (not (string= "" key))) ; do not hash empty strings
+ (let* ((key (downcase key))
+ (records (gethash key bbdb-hashtable)))
+ (puthash key (if records (bbdb-pushnewq record records)
+ (list record))
+ bbdb-hashtable))))
+
+(defun bbdb-gethash (key &optional predicate)
+ "Return list of records associated with KEY in `bbdb-hashtable'.
+KEY must be a string or nil. Empty strings and nil are ignored.
+PREDICATE may take the same values as `bbdb-completion-list'."
+ (when (and key (not (string= "" key)))
+ (let* ((key (downcase key))
+ (all-records (gethash key bbdb-hashtable))
+ records)
+ (if (or (not predicate) (eq t predicate))
+ all-records
+ (dolist (record all-records)
+ (if (catch 'bbdb-hash-ok
+ (bbdb-hash-p key record predicate))
+ (push record records)))
+ records))))
+
+(defun bbdb-hash-p (key record predicate)
+ "Throw `bbdb-hash-ok' non-nil if KEY matches RECORD acording to PREDICATE.
+PREDICATE may take the same values as the elements of `bbdb-completion-list'."
+ (if (and (memq 'fl-name predicate)
+ (bbdb-string= key (or (bbdb-record-name record) "")))
+ (throw 'bbdb-hash-ok 'fl-name))
+ (if (and (memq 'lf-name predicate)
+ (bbdb-string= key (or (bbdb-record-name-lf record) "")))
+ (throw 'bbdb-hash-ok 'lf-name))
+ (if (memq 'organization predicate)
+ (mapc (lambda (organization) (if (bbdb-string= key organization)
+ (throw 'bbdb-hash-ok 'organization)))
+ (bbdb-record-organization record)))
+ (if (memq 'aka predicate)
+ (mapc (lambda (aka) (if (bbdb-string= key aka)
+ (throw 'bbdb-hash-ok 'aka)))
+ (bbdb-record-field record 'aka-all)))
+ (if (and (memq 'primary predicate)
+ (bbdb-string= key (car (bbdb-record-mail-canon record))))
+ (throw 'bbdb-hash-ok 'primary))
+ (if (memq 'mail predicate)
+ (mapc (lambda (mail) (if (bbdb-string= key mail)
+ (throw 'bbdb-hash-ok 'mail)))
+ (bbdb-record-mail-canon record)))
+ nil)
+
+(defun bbdb-remhash (key record)
+ "Remove RECORD from list of records associated with KEY.
+KEY must be a string or nil. Empty strings and nil are ignored."
+ (if (and key (not (string= "" key)))
+ (let* ((key (downcase key))
+ (records (gethash key bbdb-hashtable)))
+ (when records
+ (setq records (delq record records))
+ (if records
+ (puthash key records bbdb-hashtable)
+ (remhash key bbdb-hashtable))))))
+
+(defun bbdb-hash-record (record)
+ "Insert RECORD in `bbdb-hashtable'.
+This performs all initializations required for a new record.
+Do not call this for existing records that require updating."
+ (bbdb-puthash (bbdb-record-name record) record)
+ (bbdb-puthash (bbdb-record-name-lf record) record)
+ (dolist (organization (bbdb-record-organization record))
+ (bbdb-puthash organization record))
+ (dolist (aka (bbdb-record-aka record))
+ (bbdb-puthash aka record))
+ (bbdb-puthash-mail record)
+ (puthash (bbdb-record-uuid record) record bbdb-uuid-table))
+
+(defun bbdb-puthash-mail (record)
+ "For RECORD put mail into `bbdb-hashtable'."
+ (let (mail-aka mail-canon address)
+ (dolist (mail (bbdb-record-mail record))
+ (setq address (bbdb-decompose-bbdb-address mail))
+ (when (car address)
+ (push (car address) mail-aka)
+ (bbdb-puthash (car address) record))
+ (push (nth 1 address) mail-canon)
+ (bbdb-puthash (nth 1 address) record))
+ (bbdb-cache-set-mail-aka (bbdb-record-cache record)
+ (nreverse mail-aka))
+ (bbdb-cache-set-mail-canon (bbdb-record-cache record)
+ (nreverse mail-canon))))
+
+(defun bbdb-hash-update (record old new)
+ "Update hash for RECORD. Remove OLD, insert NEW.
+Both OLD and NEW are lists of values."
+ (dolist (elt old)
+ (bbdb-remhash elt record))
+ (dolist (elt new)
+ (bbdb-puthash elt record)))
+
+(defun bbdb-check-name (first last &optional record)
+ "Check whether the name FIRST LAST is a valid name.
+This throws an error if the name is already used by another record
+and `bbdb-allow-duplicates' is nil. If RECORD is non-nil, FIRST and LAST
+may correspond to RECORD without raising an error."
+ ;; Are there more useful checks for names beyond checking for duplicates?
+ (unless bbdb-allow-duplicates
+ (let* ((name (bbdb-concat 'name-first-last first last))
+ (records (bbdb-gethash name '(fl-name lf-name aka))))
+ (if (or (and (not record) records)
+ (remq record records))
+ (error "%s is already in BBDB" name)))))
+
+(defun bbdb-record-name (record)
+ "Record cache function: Return the full name FIRST_LAST of RECORD.
+Return empty string if both the first and last name are nil.
+If the name is not available in the name cache, the name cache value
+is generated and stored."
+ (or (bbdb-cache-fl-name (bbdb-record-cache record))
+ ;; Build the name cache for a record.
+ (bbdb-record-set-name record t t)))
+
+(defun bbdb-record-name-lf (record)
+ "Record cache function: Return the full name LAST_FIRST of RECORD.
+If the name is not available in the name cache, the name cache value
+is generated and stored."
+ (or (bbdb-cache-lf-name (bbdb-record-cache record))
+ ;; Build the name cache for a record.
+ (progn (bbdb-record-set-name record t t)
+ (bbdb-cache-lf-name (bbdb-record-cache record)))))
+
+(defun bbdb-record-set-name (record first last)
+ "Record cache function: For RECORD set full name based on FIRST and LAST.
+If FIRST or LAST are t use respective existing entries of RECORD.
+Set full name in cache and hash. Return first-last name."
+ (let* ((cache (bbdb-record-cache record))
+ (fl-name (bbdb-cache-fl-name cache))
+ (lf-name (bbdb-cache-lf-name cache)))
+ (if fl-name (bbdb-remhash fl-name record))
+ (if lf-name (bbdb-remhash lf-name record)))
+ (if (eq t first)
+ (setq first (bbdb-record-firstname record))
+ (bbdb-record-set-firstname record first))
+ (if (eq t last)
+ (setq last (bbdb-record-lastname record))
+ (bbdb-record-set-lastname record last))
+ (let ((fl-name (bbdb-concat 'name-first-last first last))
+ (lf-name (bbdb-concat 'name-last-first last first))
+ (cache (bbdb-record-cache record)))
+ ;; Set cache of RECORD
+ (bbdb-cache-set-fl-name cache fl-name)
+ (bbdb-cache-set-lf-name cache lf-name)
+ ;; Set hash. For convenience, the hash contains the full name
+ ;; as first-last and last-fist.
+ (bbdb-puthash fl-name record)
+ (bbdb-puthash lf-name record)
+ fl-name))
+
+(defun bbdb-record-sortkey (record)
+ "Record cache function: Return the sortkey for RECORD.
+Set and store it if necessary."
+ (or (bbdb-cache-sortkey (bbdb-record-cache record))
+ (bbdb-record-set-sortkey record)))
+
+(defun bbdb-record-set-sortkey (record)
+ "Record cache function: Set and return RECORD's sortkey."
+ (bbdb-cache-set-sortkey
+ (bbdb-record-cache record)
+ (downcase
+ (bbdb-concat "" (bbdb-record-lastname record)
+ (bbdb-record-firstname record)
+ (bbdb-record-organization record)))))
+
+(defsubst bbdb-record-marker (record)
+ "Record cache function: Return the marker for RECORD."
+ (bbdb-cache-marker (bbdb-record-cache record)))
+
+(defsubst bbdb-record-set-marker (record marker)
+ "Record cache function: Set and return RECORD's MARKER."
+ (bbdb-cache-set-marker (bbdb-record-cache record) marker))
+
+(defsubst bbdb-record-xfield (record label)
+ "For RECORD return value of xfield LABEL.
+Return nil if xfield LABEL is undefined."
+ (cdr (assq label (bbdb-record-xfields record))))
+
+;; The values of xfields are normally strings. The following function
+;; comes handy if we want to treat these values as symbols.
+(defun bbdb-record-xfield-intern (record label)
+ "For RECORD return interned value of xfield LABEL.
+Return nil if xfield LABEL does not exist."
+ (let ((value (bbdb-record-xfield record label)))
+ ;; If VALUE is not a string, return whatever it is.
+ (if (stringp value) (intern value) value)))
+
+(defun bbdb-record-xfield-string (record label)
+ "For RECORD return value of xfield LABEL as string.
+Return nil if xfield LABEL does not exist."
+ (let ((value (bbdb-record-xfield record label)))
+ (if (string-or-null-p value)
+ value
+ (let ((print-escape-newlines t))
+ (prin1-to-string value)))))
+
+(defsubst bbdb-record-xfield-split (record label)
+ "For RECORD return value of xfield LABEL split as a list.
+Splitting is based on `bbdb-separator-alist'."
+ (let ((val (bbdb-record-xfield record label)))
+ (cond ((stringp val) (bbdb-split label val))
+ (val (error "Cannot split `%s'" val)))))
+
+(defun bbdb-record-set-xfield (record label value)
+ "For RECORD set xfield LABEL to VALUE.
+If VALUE is nil or an empty string, remove xfield LABEL from RECORD.
+Return VALUE."
+ ;; In principle we can also have xfield labels `name' or `mail', etc.
+ ;; Yet the actual code would get rather confused. So we throw an error.
+ (if (memq label '(name firstname lastname affix organization
+ mail aka phone address xfields))
+ (error "xfield label `%s' illegal" label))
+ (if (eq label 'mail-alias)
+ (setq bbdb-mail-aliases-need-rebuilt 'edit))
+ (if (stringp value) (setq value (bbdb-string-trim value t)))
+ (let ((old-xfield (assq label (bbdb-record-xfields record))))
+ ;; Do nothing if both OLD-XFIELD and VALUE are nil.
+ (cond ((and old-xfield value) ; update
+ (setcdr old-xfield value))
+ (value ; new xfield
+ (bbdb-pushnewq label bbdb-xfield-label-list)
+ (bbdb-record-set-xfields record
+ (append (bbdb-record-xfields record)
+ (list (cons label value)))))
+ (old-xfield ; remove
+ (bbdb-record-set-xfields record
+ (delq old-xfield
+ (bbdb-record-xfields record))))))
+ value)
+
+(defun bbdb-check-type (object type &optional abort extended)
+ "Return non-nil if OBJECT is of type TYPE.
+TYPE is a pseudo-code as in `bbdb-record-type'.
+If ABORT is non-nil, abort with error message if type checking fails.
+If EXTENDED is non-nil, consider extended atomic types which may include
+symbols, numbers, markers, and strings."
+ (let (tmp)
+ ;; Add more predicates? Compare info node `(elisp.info)Type Predicates'.
+ (or (cond ((eq type 'symbol) (symbolp object))
+ ((eq type 'integer) (integerp object))
+ ((eq type 'marker) (markerp object))
+ ((eq type 'number) (numberp object))
+ ((eq type 'string) (stringp object))
+ ((eq type 'sexp) t) ; matches always
+ ((eq type 'face) (facep object))
+ ;; not quite a type
+ ((eq type 'bound) (and (symbolp object) (boundp object)))
+ ((eq type 'function) (functionp object))
+ ((eq type 'vector) (vectorp object))
+ ((and extended
+ (cond ((symbolp type) (setq tmp (eq type object)) t)
+ ((or (numberp type) (markerp type))
+ (setq tmp (= type object)) t)
+ ((stringp type)
+ (setq tmp (and (stringp object)
+ (string= type object))) t)))
+ tmp)
+ ((not (consp type))
+ (error "Atomic type `%s' undefined" type))
+ ((eq 'const (setq tmp (car type)))
+ (equal (nth 1 type) object))
+ ((eq tmp 'cons)
+ (and (consp object)
+ (bbdb-check-type (car object) (nth 1 type) abort extended)
+ (bbdb-check-type (cdr object) (nth 2 type) abort extended)))
+ ((eq tmp 'list)
+ (and (listp object)
+ (eq (length (cdr type)) (length object))
+ (let ((type (cdr type)) (object object) (ok t))
+ (while type
+ (unless (bbdb-check-type (pop object) (pop type)
+ abort extended)
+ (setq ok nil type nil)))
+ ok)))
+ ((eq tmp 'repeat)
+ (and (listp object)
+ (let ((tp (nth 1 type)) (object object) (ok t))
+ (while object
+ (unless (bbdb-check-type (pop object) tp abort extended)
+ (setq ok nil object nil)))
+ ok)))
+ ((eq tmp 'vector)
+ (and (vectorp object)
+ (let* ((i 0) (type (cdr type))
+ (ok (eq (length object) (length type))))
+ (when ok
+ (while type
+ (if (bbdb-check-type (aref object i) (pop type)
+ abort extended)
+ (setq i (1+ i))
+ (setq ok nil type nil)))
+ ok))))
+ ((eq tmp 'or) ; like customize `choice' type
+ (let ((type (cdr type)) ok)
+ (while type
+ (if (bbdb-check-type object (pop type) nil extended)
+ (setq ok t type nil)))
+ ok))
+ ;; User-defined predicate
+ ((eq tmp 'user-p) (funcall (nth 1 type) object))
+ (t (error "Compound type `%s' undefined" tmp)))
+ (and abort
+ (error "Type mismatch: expect %s, got `%s'" type object)))))
+
+;; (bbdb-check-type 'bar 'symbol)
+;; (bbdb-check-type 'bar 'bar)
+;; (bbdb-check-type "foo" 'symbol t)
+;; (bbdb-check-type "foo" '(or symbol string))
+;; (bbdb-check-type nil '(const nil))
+;; (bbdb-check-type '(bar . "foo") '(cons symbol string))
+;; (bbdb-check-type '(bar "foo") '(list symbol string))
+;; (bbdb-check-type '("bar" "foo") '(repeat string))
+;; (bbdb-check-type (vector 'bar "foo") '(vector symbol string))
+;; (bbdb-check-type (vector 'bar "foo") 'vector)
+;; (bbdb-check-type '(bar (bar . "foo")) '(list symbol (cons symbol string)))
+;; (bbdb-check-type '("aa" . "bb") '(or (const nil) (cons string string)) t)
+;; (bbdb-check-type nil '(or nil (cons string string)) t t)
+;; (bbdb-check-type "foo" '(user-p (lambda (a) (stringp a))))
+;; (bbdb-check-type 'set 'function)
+
+(defun bbdb-record-field (record field)
+ "For RECORD return the value of FIELD.
+
+FIELD may take the following values
+ firstname Return the first name of RECORD
+ lastname Return the last name of RECORD
+ name Return the full name of RECORD (first name first)
+ name-lf Return the full name of RECORD (last name first)
+ affix Return the list of affixes
+ organization Return the list of organizations
+ aka Return the list of AKAs
+ aka-all Return the list of AKAs plus mail-akas.
+ mail Return the list of email addresses
+ mail-aka Return the list of name parts in mail addresses
+ mail-canon Return the list of canonical mail addresses.
+ phone Return the list of phone numbers
+ address Return the list of addresses
+ uuid Return the uuid of RECORD
+ creation-date Return the creation-date
+ timestamp Return the timestamp
+ xfields Return the list of all xfields
+
+Any other symbol is interpreted as the label for an xfield.
+Then return the value of this xfield.
+
+See also `bbdb-record-set-field'."
+ (cond ((eq field 'firstname) (bbdb-record-firstname record))
+ ((eq field 'lastname) (bbdb-record-lastname record))
+ ((eq field 'name) (bbdb-record-name record))
+ ((eq field 'name-lf) (bbdb-record-name-lf record))
+ ((eq field 'affix) (bbdb-record-affix record))
+ ((eq field 'organization) (bbdb-record-organization record))
+ ((eq field 'mail) (bbdb-record-mail record))
+ ((eq field 'mail-canon) (bbdb-record-mail-canon record)) ; derived (cached) field
+ ((eq field 'mail-aka) (bbdb-record-mail-aka record)) ; derived (cached) field
+ ((eq field 'aka) (bbdb-record-aka record))
+ ((eq field 'aka-all) (append (bbdb-record-aka record) ; derived field
+ (bbdb-record-mail-aka record)))
+ ((eq field 'phone) (bbdb-record-phone record))
+ ((eq field 'address) (bbdb-record-address record))
+ ((eq field 'uuid) (bbdb-record-uuid record))
+ ((eq field 'creation-date) (bbdb-record-creation-date record))
+ ((eq field 'timestamp) (bbdb-record-timestamp record))
+ ;; Return all xfields
+ ((eq field 'xfields) (bbdb-record-xfields record))
+ ;; Return xfield FIELD (e.g., `notes') or nil if FIELD is not defined.
+ ((symbolp field) (bbdb-record-xfield record field))
+ (t (error "Unknown field type `%s'" field))))
+(define-obsolete-function-alias 'bbdb-record-get-field 'bbdb-record-field "3.0")
+
+(defun bbdb-record-set-field (record field value &optional merge check)
+ "For RECORD set FIELD to VALUE. Return VALUE.
+If MERGE is non-nil, merge VALUE with the current value of FIELD.
+If CHECK is non-nil, check syntactically whether FIELD may take VALUE.
+This function also updates the hash table. However, it does not update
+RECORD in the database. Use `bbdb-change-record' for that.
+
+FIELD may take the following values
+ firstname VALUE is the first name of RECORD
+ lastname VALUE is the last name of RECORD
+ name VALUE is the full name of RECORD either as one string
+ or as a cons pair (FIRST . LAST)
+ affix VALUE is the list of affixes
+ organization VALUE is the list of organizations
+ aka VALUE is the list of AKAs
+ mail VALUE is the list of email addresses
+ phone VALUE is the list of phone numbers
+ address VALUE is the list of addresses
+ uuid VALUE is the uuid of RECORD
+ creation-date VALUE is the creation-date
+ timestamp VALUE is the timestamp
+ xfields VALUE is the list of all xfields
+
+Any other symbol is interpreted as the label for an xfield.
+Then VALUE is the value of this xfield.
+
+See also `bbdb-record-field'."
+ (bbdb-editable)
+ (if (memq field '(name-lf mail-aka mail-canon aka-all))
+ (error "`%s' is not allowed as the name of a field" field))
+ (let ((record-type (cdr bbdb-record-type)))
+ (cond ((eq field 'firstname) ; First name
+ (if merge (error "Does not merge names"))
+ (if check (bbdb-check-type value (bbdb-record-firstname record-type) t))
+ (bbdb-check-name value (bbdb-record-lastname record) record)
+ (bbdb-record-set-name record value t))
+
+ ;; Last name
+ ((eq field 'lastname)
+ (if merge (error "Does not merge names"))
+ (if check (bbdb-check-type value (bbdb-record-lastname record-type) t))
+ (bbdb-check-name (bbdb-record-firstname record) value record)
+ (bbdb-record-set-name record t value))
+
+ ;; Name
+ ((eq field 'name)
+ (if merge (error "Does not merge names"))
+ (if (stringp value)
+ (setq value (bbdb-divide-name value))
+ (if check (bbdb-check-type value '(cons string string) t)))
+ (let ((fn (car value)) (ln (cdr value)))
+ (bbdb-check-name fn ln record)
+ (bbdb-record-set-name record fn ln)))
+
+ ;; Affix
+ ((eq field 'affix)
+ (if merge (setq value (bbdb-merge-lists (bbdb-record-affix record)
+ value 'bbdb-string=)))
+ (if check (bbdb-check-type value (bbdb-record-affix record-type) t))
+ (setq value (bbdb-list-strings value))
+ (bbdb-record-set-affix record value))
+
+ ;; Organization
+ ((eq field 'organization)
+ (if merge (setq value (bbdb-merge-lists (bbdb-record-organization record)
+ value 'bbdb-string=)))
+ (if check (bbdb-check-type value (bbdb-record-organization record-type) t))
+ (setq value (bbdb-list-strings value))
+ (bbdb-hash-update record (bbdb-record-organization record) value)
+ (dolist (organization value)
+ (bbdb-pushnew organization bbdb-organization-list))
+ (bbdb-record-set-organization record value))
+
+ ;; AKA
+ ((eq field 'aka)
+ (if merge (setq value (bbdb-merge-lists (bbdb-record-aka record)
+ value 'bbdb-string=)))
+ (if check (bbdb-check-type value (bbdb-record-aka record-type) t))
+ (setq value (bbdb-list-strings value))
+ (unless bbdb-allow-duplicates
+ (dolist (aka value)
+ (let ((old (remq record (bbdb-gethash aka '(fl-name lf-name aka)))))
+ (if old (error "Alternate name address \"%s\" is used by \"%s\""
+ aka (mapconcat 'bbdb-record-name old ", "))))))
+ (bbdb-hash-update record (bbdb-record-aka record) value)
+ (bbdb-record-set-aka record value))
+
+ ;; Mail
+ ((eq field 'mail)
+ (if merge (setq value (bbdb-merge-lists (bbdb-record-mail record)
+ value 'bbdb-string=)))
+ (if check (bbdb-check-type value (bbdb-record-mail record-type) t))
+ (setq value (bbdb-list-strings value))
+ (unless bbdb-allow-duplicates
+ (dolist (mail value)
+ (let ((old (remq record (bbdb-gethash mail '(mail)))))
+ (if old (error "Mail address \"%s\" is used by \"%s\""
+ mail (mapconcat 'bbdb-record-name old ", "))))))
+ (dolist (aka (bbdb-record-mail-aka record))
+ (bbdb-remhash aka record))
+ (dolist (mail (bbdb-record-mail-canon record))
+ (bbdb-remhash mail record))
+ (bbdb-record-set-mail record value)
+ (bbdb-puthash-mail record))
+
+ ;; Phone
+ ((eq field 'phone)
+ (if merge (setq value (bbdb-merge-lists (bbdb-record-phone record)
+ value 'equal)))
+ (if check (bbdb-check-type value (bbdb-record-phone record-type) t))
+ (dolist (phone value)
+ (bbdb-pushnew (bbdb-phone-label phone) bbdb-phone-label-list))
+ (bbdb-record-set-phone record value))
+
+ ;; Address
+ ((eq field 'address)
+ (if merge (setq value (bbdb-merge-lists (bbdb-record-address record)
+ value 'equal)))
+ (if check (bbdb-check-type value (bbdb-record-address record-type) t))
+ (dolist (address value)
+ (bbdb-pushnew (bbdb-address-label address) bbdb-address-label-list)
+ (mapc (lambda (street) (bbdb-pushnewt street bbdb-street-list))
+ (bbdb-address-streets address))
+ (bbdb-pushnewt (bbdb-address-city address) bbdb-city-list)
+ (bbdb-pushnewt (bbdb-address-state address) bbdb-state-list)
+ (bbdb-pushnewt (bbdb-address-postcode address) bbdb-postcode-list)
+ (bbdb-pushnewt (bbdb-address-country address) bbdb-country-list))
+ (bbdb-record-set-address record value))
+
+ ;; uuid
+ ((eq field 'uuid)
+ ;; MERGE not meaningful
+ (if check (bbdb-check-type value (bbdb-record-uuid record-type) t))
+ (let ((old-uuid (bbdb-record-uuid record)))
+ (unless (string= old-uuid value)
+ (remhash old-uuid bbdb-uuid-table)
+ (bbdb-record-set-uuid record value)
+ (puthash value record bbdb-uuid-table))))
+
+ ;; creation-date
+ ((eq field 'creation-date)
+ ;; MERGE not meaningful
+ (if check (bbdb-check-type value (bbdb-record-creation-date record-type) t))
+ (bbdb-record-set-creation-date record value))
+
+ ;; timestamp
+ ((eq field 'timestamp)
+ ;; MERGE not meaningful
+ (if check (bbdb-check-type value (bbdb-record-timestamp record-type) t))
+ (bbdb-record-set-timestamp record value))
+
+ ;; all xfields
+ ((eq field 'xfields)
+ (if merge
+ (let ((xfields (bbdb-record-xfields record))
+ xfield)
+ (dolist (nv value)
+ (if (setq xfield (assq (car nv) xfields))
+ (setcdr xfield (bbdb-merge-xfield
+ (car nv) (cdr xfield) (cdr nv)))
+ (setq xfields (append xfields (list nv)))))
+ (setq value xfields)))
+ (if check (bbdb-check-type value (bbdb-record-xfields record-type) t))
+ (let (new-xfields)
+ (dolist (xfield value)
+ ;; Ignore junk
+ (when (and (cdr xfield) (not (equal "" (cdr xfield))))
+ (push xfield new-xfields)
+ (bbdb-pushnewq (car xfield) bbdb-xfield-label-list)))
+ (bbdb-record-set-xfields record (nreverse new-xfields))))
+
+ ;; Single xfield
+ ((symbolp field)
+ (if merge
+ (setq value (bbdb-merge-xfield field (bbdb-record-xfield record field)
+ value)))
+ ;; The following test always succeeds
+ ;; (if check (bbdb-check-type value 'sexp t))
+ ;; This removes xfield FIELD if its value is nil.
+ (bbdb-record-set-xfield record field value))
+
+ (t (error "Unknown field type `%s'" field)))))
+
+;; Currently unused (but possible entry for `bbdb-merge-xfield-function-alist')
+(defun bbdb-merge-concat (string1 string2 &optional separator)
+ "Return the concatenation of STRING1 and STRING2.
+SEPARATOR defaults to \"\\n\"."
+ (concat string1 (or separator "\n") string2))
+
+;; Currently unused (but possible entry for `bbdb-merge-xfield-function-alist')
+(defun bbdb-merge-concat-remove-duplicates (string1 string2)
+ "Concatenate STRING1 and STRING2, but remove duplicate lines."
+ (let ((lines (split-string string1 "\n")))
+ (dolist (line (split-string string2 "\n"))
+ (bbdb-pushnew line lines))
+ (bbdb-concat "\n" lines)))
+
+(defun bbdb-merge-string-least (string1 string2)
+ "Return the string out of STRING1 and STRING2 that is `string-lessp'."
+ (if (string-lessp string1 string2)
+ string1
+ string2))
+
+(defun bbdb-merge-string-most (string1 string2)
+ "Return the string out of STRING1 and STRING2 that is not `string-lessp'."
+ (if (string-lessp string1 string2)
+ string2
+ string1))
+
+(defun bbdb-merge-lists (l1 l2 cmp)
+ "Merge two lists L1 and L2 based on comparison CMP.
+An element from L2 is added to L1 if CMP returns nil for all elements of L1.
+If L1 or L2 are not lists, they are replaced by (list L1) and (list L2)."
+ (let (merge)
+ (unless (listp l1) (setq l1 (list l1)))
+ (dolist (e2 (if (listp l2) l2 (list l2)))
+ (let ((ll1 l1) e1 fail)
+ (while (setq e1 (pop ll1))
+ (if (funcall cmp e1 e2)
+ (setq ll1 nil
+ fail t)))
+ (unless fail (push e2 merge))))
+ (append l1 (nreverse merge))))
+
+(defun bbdb-merge-xfield (label value1 value2)
+ "For LABEL merge VALUE1 with VALUE2.
+If LABEL has an entry in `bbdb-merge-xfield-function-alist', use it.
+If VALUE1 or VALUE2 is a substring of the other, return the longer one.
+Otherwise use `bbdb-concat'. Return nil if we have nothing to merge."
+ (if (stringp value1) (setq value1 (bbdb-string-trim value1 t)))
+ (if (stringp value2) (setq value2 (bbdb-string-trim value2 t)))
+ (cond ((and value1 value2)
+ (let ((fun (cdr (assq label bbdb-merge-xfield-function-alist))))
+ (cond (fun (funcall fun value1 value2))
+ ((not (and (stringp value1) (stringp value2)))
+ (cons value1 value2)) ; concatenate lists
+ ((string-match (regexp-quote value1) value2) value2)
+ ((string-match (regexp-quote value2) value1) value1)
+ (t (bbdb-concat label value1 value2)))))
+ (value1)
+ (value2)))
+
+;;; Parsing other things
+
+(defun bbdb-divide-name (string)
+ "Divide STRING into a first name and a last name.
+Case is ignored. Return name as (FIRST . LAST).
+LAST is always a string (possibly empty). FIRST may be nil."
+ (let ((case-fold-search t)
+ first suffix)
+ ;; Separate a suffix.
+ (if (string-match bbdb-lastname-suffix-re string)
+ (setq suffix (concat " " (match-string 1 string))
+ string (substring string 0 (match-beginning 0))))
+ (cond ((string-match "\\`\\(.+\\),[ \t\n]*\\(.+\\)\\'" string)
+ ;; If STRING contains a comma, this probably means that STRING
+ ;; is of the form "Last, First".
+ (setq first (match-string 2 string)
+ string (match-string 1 string)))
+ ((string-match bbdb-lastname-re string)
+ (setq first (and (not (zerop (match-beginning 0)))
+ (substring string 0 (match-beginning 0)))
+ string (match-string 1 string))))
+ (cons (and first (bbdb-string-trim first))
+ (bbdb-string-trim (concat string suffix)))))
+
+(defun bbdb-parse-postcode (string)
+ "Check whether STRING is a legal postcode.
+Do this only if `bbdb-check-postcode' is non-nil."
+ (if bbdb-check-postcode
+ (let ((postcodes bbdb-legal-postcodes) re done)
+ (while (setq re (pop postcodes))
+ (if (string-match re string)
+ (setq done t postcodes nil)))
+ (if done string
+ (error "not a valid postcode.")))
+ string))
+
+(defun bbdb-phone-string (phone)
+ "Massage string PHONE into a standard format."
+ ;; Phone numbers should come in two forms:
+ (if (= 2 (length phone))
+ ;; (1) ["where" "the number"]
+ (if (stringp (aref phone 1))
+ (aref phone 1)
+ (error "Not a valid phone number: %s" (aref phone 1)))
+ ;; (2) ["where" 415 555 1212 99]
+ (unless (and (integerp (aref phone 2))
+ (integerp (aref phone 3)))
+ (error "Not an NANP number: %s %s" (aref phone 2) (aref phone 3)))
+ (concat (if (/= 0 (bbdb-phone-area phone))
+ (format "(%03d) " (bbdb-phone-area phone))
+ "")
+ (if (/= 0 (bbdb-phone-exchange phone))
+ (format "%03d-%04d"
+ (bbdb-phone-exchange phone) (bbdb-phone-suffix phone))
+ "")
+ (if (and (bbdb-phone-extension phone)
+ (/= 0 (bbdb-phone-extension phone)))
+ (format " x%d" (bbdb-phone-extension phone))
+ ""))))
+
+(defsubst bbdb-record-lessp (record1 record2)
+ (string< (bbdb-record-sortkey record1)
+ (bbdb-record-sortkey record2)))
+
+(defmacro bbdb-error-retry (&rest body)
+ "Repeatedly execute BODY ignoring errors till no error occurs."
+ `(catch '--bbdb-error-retry--
+ (while t
+ (condition-case --c--
+ (throw '--bbdb-error-retry-- (progn ,@body))
+ (error (ding)
+ (message "Error: %s" (nth 1 --c--))
+ (sit-for 2))))))
+
+\f
+;;; Reading and Writing the BBDB
+
+(defun bbdb-buffer ()
+ "Return buffer that visits the BBDB file `bbdb-file'.
+Ensure that this buffer is in sync with `bbdb-file'.
+Revert the buffer if necessary.
+If `bbdb-file-remote' is non-nil and it is newer than `bbdb-file',
+copy it to `bbdb-file'."
+ (unless (buffer-live-p bbdb-buffer)
+ (if (and bbdb-file-remote
+ (file-newer-than-file-p bbdb-file-remote bbdb-file))
+ (copy-file bbdb-file-remote bbdb-file t t))
+
+ (with-current-buffer (setq bbdb-buffer (find-file-noselect bbdb-file))
+
+ ;; Check whether auto-save file is newer than `bbdb-file'
+ ;; Do this only when reading `bbdb-file'.
+ (let ((auto-save-file (make-auto-save-file-name)))
+ (when (and bbdb-check-auto-save-file
+ (file-newer-than-file-p auto-save-file buffer-file-name))
+ (recover-file buffer-file-name) ; this queries
+ (bury-buffer) ; `recover-file' selects `bbdb-buffer'
+ (auto-save-mode 1) ; turn auto-save back on
+ ;; Delete auto-save file even if the user rejected to recover it,
+ ;; so we do not keep asking.
+ (condition-case nil
+ (delete-file auto-save-file)
+ (file-error nil))))))
+
+ ;; Make sure `bbdb-buffer' is not out of sync with disk.
+ (with-current-buffer bbdb-buffer
+ (cond ((verify-visited-file-modtime))
+ ((bbdb-revert-buffer))
+ ;; This is the case where `bbdb-file' has changed; the buffer
+ ;; has changed as well; and the user has answered "no" to the
+ ;; "flush your changes and revert" question. The only other
+ ;; alternative is to save the file right now. If they answer
+ ;; no to the following question, they will be asked the
+ ;; preceeding question again and again some large (but finite)
+ ;; number of times. `bbdb-buffer' is called a lot, you see...
+ ((buffer-modified-p)
+ ;; this queries
+ (bbdb-save t t))
+ (t ; Buffer and file are inconsistent, but we let them stay that way
+ (message "Continuing with inconsistent BBDB buffers")))
+
+ ;; `bbdb-revert-buffer' kills all local variables.
+ (unless (assq 'bbdb-records (buffer-local-variables))
+ ;; We are reading / reverting `bbdb-buffer'.
+ (set (make-local-variable 'revert-buffer-function)
+ 'bbdb-revert-buffer)
+
+ (setq buffer-file-coding-system bbdb-file-coding-system
+ buffer-read-only bbdb-read-only
+ bbdb-mail-aliases-need-rebuilt 'parse
+ bbdb-changed-records nil)
+
+ ;; `bbdb-before-save-hook' and `bbdb-after-save-hook' are user variables.
+ ;; To avoid confusion, we hide the hook functions `bbdb-before-save'
+ ;; and `bbdb-after-save' from the user as these are essential for BBDB.
+ (dolist (hook (cons 'bbdb-before-save bbdb-before-save-hook))
+ (add-hook 'before-save-hook hook nil t))
+ (dolist (hook (cons 'bbdb-after-save bbdb-after-save-hook))
+ (add-hook 'after-save-hook hook nil t))
+
+ (clrhash bbdb-hashtable)
+ (clrhash bbdb-uuid-table)
+
+ (if (/= (point-min) (point-max))
+ (bbdb-parse-records) ; normal case: nonempty db
+ ;; Empty db: the following does not require `insert-before-markers'
+ ;; because there are no db-markers in this buffer.
+ (insert (format (concat ";; -*- mode: Emacs-Lisp; coding: %s; -*-"
+ "\n;;; file-format: %d\n")
+ bbdb-file-coding-system bbdb-file-format))
+ ;; We pretend that `bbdb-buffer' is still unmodified,
+ ;; so that we will (auto-)save it only if we also add records to it.
+ (set-buffer-modified-p nil)
+ (setq bbdb-end-marker (point-marker)
+ ;; Setting `bbdb-records' makes it buffer-local,
+ ;; so that we can use it as a test whether we have
+ ;; initialized BBDB.
+ bbdb-records nil))
+
+ (run-hooks 'bbdb-after-read-db-hook)))
+
+ ;; return `bbdb-buffer'
+ bbdb-buffer)
+
+(defmacro bbdb-with-db-buffer (&rest body)
+ "Execute the forms in BODY with `bbdb-buffer' temporarily current.
+If `bbdb-debug' was non-nil at compile-time, and `bbdb-buffer' is visible
+in a window, temporarilly switch to that window. So when we come out,
+that window has been scrolled to the record we have just modified."
+ (declare (indent 0))
+ (if bbdb-debug
+ `(let* ((buffer (bbdb-buffer))
+ (window (get-buffer-window buffer)))
+ (if window
+ (with-selected-window window
+ ,@body)
+ (with-current-buffer buffer
+ ,@body)))
+ `(with-current-buffer (bbdb-buffer)
+ ,@body)))
+
+(defun bbdb-editable ()
+ "Ensure that BBDB is editable, otherwise throw an error.
+If BBDB is out of sync try to revert.
+BBDB is not editable if it is read-only."
+ (if bbdb-read-only (error "BBDB is read-only"))
+ (let ((buffer (bbdb-buffer))) ; this reverts if necessary / possible
+ ;; Is the following possible? Superfluous tests do not hurt.
+ ;; It is relevant only for editing commands in a BBDB buffer,
+ ;; but not for MUA-related editing functions.
+ (if (and (eq major-mode 'bbdb-mode)
+ bbdb-records
+ (not (memq (caar bbdb-records)
+ (with-current-buffer buffer bbdb-records))))
+ (error "BBDB is out of sync")))
+ t)
+
+;;;###autoload
+(defsubst bbdb-records ()
+ "Return a list of all BBDB records; read in and parse the db if necessary.
+This function also notices if the corresponding file on disk has been modified."
+ (with-current-buffer (bbdb-buffer)
+ bbdb-records))
+
+(defun bbdb-revert-buffer (&optional ignore-auto noconfirm)
+ "The `revert-buffer-function' for `bbdb-buffer' visiting `bbdb-file'.
+IGNORE-AUTO and NOCONFIRM have same meaning as in `revert-buffer'.
+See also variable `bbdb-auto-revert'.
+Return t if the reversion was successful (or not needed).
+Return nil otherwise."
+ (interactive (list (not current-prefix-arg))) ; as in `revert-buffer'
+ (unless (buffer-live-p bbdb-buffer)
+ (error "No live BBDB buffer to revert"))
+ (with-current-buffer bbdb-buffer
+ (cond ((not buffer-file-number)
+ ;; We have not yet created `bbdb-file'
+ (when (or noconfirm
+ (yes-or-no-p "Flush your changes? "))
+ (erase-buffer)
+ (kill-all-local-variables) ; clear database
+ (bbdb-buffer) ; re-initialize
+ (set-buffer-modified-p nil)
+ (bbdb-undisplay-records t)))
+ ;; If nothing has changed do nothing, return t.
+ ((and (verify-visited-file-modtime)
+ (not (buffer-modified-p))))
+ ((or (and (not (verify-visited-file-modtime bbdb-buffer))
+ ;; File changed on disk
+ (or noconfirm
+ (and bbdb-auto-revert
+ (not (buffer-modified-p)))
+ (yes-or-no-p
+ (if (buffer-modified-p)
+ "BBDB changed on disk; flush your changes and revert? "
+ "BBDB changed on disk; revert? "))))
+ (and (verify-visited-file-modtime bbdb-buffer)
+ ;; File not changed on disk, but buffer modified
+ (buffer-modified-p)
+ (or noconfirm
+ (yes-or-no-p "Flush your changes and revert BBDB? "))))
+ (unless (file-exists-p bbdb-file)
+ (error "BBDB: file %s no longer exists" bbdb-file))
+ (kill-all-local-variables) ; clear database
+ ;; `revert-buffer-function' has the permanent-local property
+ ;; So to avoid looping, we need to bind it to nil explicitly.
+ (let (revert-buffer-function)
+ (revert-buffer ignore-auto t))
+ (bbdb-buffer) ; re-initialize
+ (bbdb-undisplay-records t)
+ t)))) ; return nil if the user rejected to revert
+
+(defun bbdb-goto-first-record ()
+ "Go to where first record begins, Move to end of file if no records."
+ (goto-char (point-min))
+ (if (search-forward "\n[" nil 'move)
+ (forward-char -1)))
+
+(defun bbdb-parse-records ()
+ "Parse BBDB records and initialize various internal variables.
+If `bbdb-file' uses an outdated format, migrate to `bbdb-file-format'."
+ (save-excursion
+ (save-restriction
+ (widen)
+ (bbdb-goto-first-record)
+ (let* ((file (abbreviate-file-name buffer-file-name))
+ (file-format (save-excursion
+ (if (re-search-backward
+ "^;+[ \t]*file-\\(format\\|version\\):[ \t]*\\([0-9]+\\)[ \t]*$" nil t)
+ (string-to-number (match-string 2))
+ ;; No file-format line.
+ (error "BBDB corrupted: no file-format line"))))
+ (migrate (< file-format bbdb-file-format))
+ records)
+ (if (> file-format bbdb-file-format)
+ (error "%s understands file format %s but not %s."
+ (bbdb-version) bbdb-file-format file-format))
+
+ (if (and migrate
+ (not (yes-or-no-p
+ (format (concat "Migrate `%s' to BBDB file format %s "
+ "(back-up recommended)? ")
+ file bbdb-file-format))))
+ (progn
+ (message "Abort loading %s" file)
+ (sleep-for 2)
+ (setq bbdb-records nil
+ ;; Avoid unexpected surprises
+ buffer-read-only t)
+ 'abort)
+
+ (or (eobp) (looking-at "\\[")
+ (error "BBDB corrupted: no following bracket"))
+
+ (unless bbdb-silent (message "Parsing BBDB file `%s'..." file))
+
+ ;; narrow the buffer to skip over the rubbish before the first record.
+ (narrow-to-region (point) (point-max))
+ (let ((modp (buffer-modified-p))
+ ;; Make sure those parens get cleaned up.
+ ;; This code had better stay simple!
+ (inhibit-quit t)
+ (buffer-undo-list t)
+ buffer-read-only)
+ (goto-char (point-min)) (insert "(\n")
+ (goto-char (point-max)) (insert "\n)")
+ (goto-char (point-min))
+ (unwind-protect
+ (setq records (read (current-buffer)))
+ (goto-char (point-min)) (delete-char 2)
+ (goto-char (point-max)) (delete-char -2)
+ (set-buffer-modified-p modp)))
+ (widen)
+
+ ;; Migrate if `bbdb-file' is outdated.
+ (if migrate (setq records (bbdb-migrate records file-format)))
+
+ ;; We could first set `bbdb-phone-label-list' and
+ ;; `bbdb-address-label-list' to their customized values. Bother?
+ (setq bbdb-records records
+ bbdb-xfield-label-list nil
+ bbdb-organization-list nil
+ bbdb-street-list nil
+ bbdb-city-list nil
+ bbdb-state-list nil
+ bbdb-postcode-list nil
+ bbdb-country-list nil)
+
+ (bbdb-goto-first-record)
+ (dolist (record records)
+ ;; We assume that the markers for each record need to go at each
+ ;; newline. If this is not the case, things can go *very* wrong.
+ (bbdb-debug
+ (unless (looking-at "\\[")
+ (error "BBDB corrupted: junk between records at %s" (point))))
+
+ (bbdb-cache-set-marker
+ (bbdb-record-set-cache record (make-vector bbdb-cache-length nil))
+ (point-marker))
+ (forward-line 1)
+
+ ;; Every record must have a unique uuid in `bbdb-uuid-table'.
+ (if (gethash (bbdb-record-uuid record) bbdb-uuid-table)
+ ;; Is there a more useful action than throwing an error?
+ ;; We are just loading BBDB, so we are not yet ready
+ ;; for sophisticated solutions.
+ (error "Duplicate UUID %s" (bbdb-record-uuid record)))
+
+ ;; Set the completion lists
+ (dolist (phone (bbdb-record-phone record))
+ (bbdb-pushnew (bbdb-phone-label phone) bbdb-phone-label-list))
+ (dolist (address (bbdb-record-address record))
+ (bbdb-pushnew (bbdb-address-label address) bbdb-address-label-list)
+ (mapc (lambda (street) (bbdb-pushnewt street bbdb-street-list))
+ (bbdb-address-streets address))
+ (bbdb-pushnewt (bbdb-address-city address) bbdb-city-list)
+ (bbdb-pushnewt (bbdb-address-state address) bbdb-state-list)
+ (bbdb-pushnewt (bbdb-address-postcode address) bbdb-postcode-list)
+ (bbdb-pushnewt (bbdb-address-country address) bbdb-country-list))
+ (dolist (xfield (bbdb-record-xfields record))
+ (bbdb-pushnewq (car xfield) bbdb-xfield-label-list))
+ (dolist (organization (bbdb-record-organization record))
+ (bbdb-pushnew organization bbdb-organization-list))
+
+ (let ((name (bbdb-concat 'name-first-last
+ (bbdb-record-firstname record)
+ (bbdb-record-lastname record))))
+ (when (and (not bbdb-allow-duplicates)
+ (bbdb-gethash name '(fl-name aka)))
+ ;; This does not check for duplicate mail fields.
+ ;; Yet under normal circumstances, this should really
+ ;; not be necessary each time BBDB is loaded as BBDB checks
+ ;; whether creating a new record or modifying an existing one
+ ;; results in duplicates.
+ ;; Alternatively, you can use `bbdb-search-duplicates'.
+ (message "Duplicate BBDB record encountered: %s" name)
+ (sit-for 1)))
+
+ ;; If `bbdb-allow-duplicates' is non-nil, we allow that two records
+ ;; (with different uuids) refer to the same person (same name etc.).
+ ;; Such duplicate records are always hashed.
+ ;; Otherwise, an unhashed record would not be available for things
+ ;; like completion (and we would not know which record to keeep
+ ;; and which one to hide). We trust the user she knows what
+ ;; she wants if she keeps duplicate records in the database though
+ ;; `bbdb-allow-duplicates' is nil.
+ (bbdb-hash-record record))
+
+ ;; Note that `bbdb-xfield-label-list' serves two purposes:
+ ;; - check whether an xfield is new to BBDB
+ ;; - list of known xfields for minibuffer completion
+ ;; Only in the latter case, we might want to exclude
+ ;; those xfields that are handled automatically.
+ ;; So the following is not a satisfactory solution.
+
+ ;; (dolist (label (bbdb-layout-get-option 'multi-line 'omit))
+ ;; (setq bbdb-xfield-label-list (delq label bbdb-xfield-label-list)))
+
+ ;; `bbdb-end-marker' allows to put comments at the end of `bbdb-file'
+ ;; that are ignored.
+ (setq bbdb-end-marker (point-marker))
+
+ (when migrate
+ (dolist (record bbdb-records)
+ (bbdb-overwrite-record-internal record))
+ ;; update file format
+ (goto-char (point-min))
+ (if (re-search-forward (format "^;;; file-\\(version\\|format\\): %d$"
+ file-format)
+ nil t)
+ (replace-match (format ";;; file-format: %d" bbdb-file-format))))
+
+ (unless bbdb-silent (message "Parsing BBDB file `%s'...done" file))
+ bbdb-records)))))
+
+(defun bbdb-before-save ()
+ "Run before saving `bbdb-file' as buffer-local part of `before-save-hook'."
+ (when (and bbdb-file-remote
+ (or bbdb-file-remote-save-always
+ (y-or-n-p (format "Save the remote BBDB file %s too? "
+ bbdb-file-remote))))
+ ;; Write the current buffer `bbdb-file' into `bbdb-file-remote'.
+ (let ((coding-system-for-write bbdb-file-coding-system))
+ (write-region (point-min) (point-max) bbdb-file-remote))))
+
+(defun bbdb-after-save ()
+ "Run after saving `bbdb-file' as buffer-local part of `after-save-hook'."
+ (setq bbdb-changed-records nil)
+ (dolist (buffer (buffer-list))
+ (with-current-buffer buffer
+ (if (eq major-mode 'bbdb-mode)
+ (set-buffer-modified-p nil)))))
+
+(defun bbdb-change-record (record &rest ignored)
+ "Update the database after a change of RECORD.
+Return RECORD if RECORD got changed compared with the database,
+return nil otherwise.
+Hash RECORD if it is new. If RECORD is not new, it is the the caller's
+responsibility to update the hashtables for RECORD. (Up-to-date hashtables are
+ensured if the fields are modified by calling `bbdb-record-set-field'.)
+Redisplay RECORD if it is not new.
+
+Args IGNORED are ignored and their use is discouraged.
+They are present only for backward compatibility."
+ (when (and ignored (get 'bbdb-change-record 'bbdb-outdated))
+ (put 'bbdb-change-record 'bbdb-outdated t)
+ (message "Outdated usage of `bbdb-change-record'")
+ (sit-for 2))
+
+ (if bbdb-read-only
+ (error "The Insidious Big Brother Database is read-only."))
+ ;; The call of `bbdb-records' checks file synchronization.
+ ;; If RECORD refers to an existing record that has been changed,
+ ;; yet in the meanwhile we reverted the BBDB file, then RECORD
+ ;; no longer refers to a record in `bbdb-records'. RECORD will then
+ ;; be treated as new, when we try to merge it with the known record.
+ (let ((tail (memq record (bbdb-records))))
+ (if tail ; RECORD is not new
+ ;; If the string we currently have for RECORD in `bbdb-buffer'
+ ;; is `equal' to the string we would write to `bbdb-buffer',
+ ;; we really did not change RECORD at all. So we don't update RECORD
+ ;; unless `bbdb-update-unchanged-records' tells us to do so anyway.
+ ;; Also, we only call `bbdb-change-hook' and `bbdb-after-change-hook'
+ ;; if RECORD got changed.
+ (when (or bbdb-update-unchanged-records
+ (not (string= (bbdb-with-db-buffer
+ (buffer-substring-no-properties
+ (bbdb-record-marker record)
+ (1- (if (cdr tail)
+ (bbdb-record-marker (cadr tail))
+ bbdb-end-marker))))
+ (let ((cache (bbdb-record-cache record))
+ (inhibit-quit t))
+ (bbdb-record-set-cache record nil)
+ (prog1 (bbdb-with-print-loadably
+ (prin1-to-string record))
+ (bbdb-record-set-cache record cache))))))
+ (bbdb-record-set-timestamp
+ record (format-time-string bbdb-time-stamp-format nil t))
+ (run-hook-with-args 'bbdb-change-hook record)
+ (let ((sort (not (equal (bbdb-cache-sortkey (bbdb-record-cache record))
+ (bbdb-record-set-sortkey record)))))
+ (if (not sort) ;; If we do not need to sort, overwrite RECORD.
+ (bbdb-overwrite-record-internal record)
+ ;; Since we need to sort, delete then insert RECORD.
+ ;; Do not mess with the hash tables here.
+ ;; We assume they got updated by the caller.
+ (bbdb-delete-record-internal record)
+ (bbdb-insert-record-internal record))
+ (bbdb-pushnewq record bbdb-changed-records)
+ (run-hook-with-args 'bbdb-after-change-hook record)
+ (bbdb-redisplay-record-globally record sort))
+ record)
+
+ ;; Record is new and not yet in BBDB.
+ (unless (bbdb-record-cache record)
+ (bbdb-record-set-cache record (make-vector bbdb-cache-length nil)))
+ (unless (bbdb-record-uuid record)
+ (bbdb-record-set-uuid record (bbdb-uuid)))
+ (unless (bbdb-record-creation-date record)
+ (bbdb-record-set-creation-date
+ record (format-time-string bbdb-time-stamp-format nil t))
+ (run-hook-with-args 'bbdb-create-hook record))
+
+ (let ((old-record (gethash (bbdb-record-uuid record) bbdb-uuid-table)))
+ (if old-record
+ ;; RECORD is really OLD-RECORD. Merge and return OLD-RECORD.
+ (if bbdb-merge-records-function
+ (funcall bbdb-merge-records-function record old-record)
+ (bbdb-merge-records record old-record))
+
+ ;; RECORD is really new.
+ (bbdb-record-set-timestamp
+ record (format-time-string bbdb-time-stamp-format nil t))
+ (run-hook-with-args 'bbdb-change-hook record)
+ (bbdb-insert-record-internal record)
+ (bbdb-hash-record record)
+ (bbdb-pushnewq record bbdb-changed-records)
+ (run-hook-with-args 'bbdb-after-change-hook record)
+ record)))))
+
+(defun bbdb-delete-record-internal (record &optional completely)
+ "Delete RECORD in the database file.
+With COMPLETELY non-nil, also undisplay RECORD and remove it
+from the hash table."
+ (unless (bbdb-record-marker record) (error "BBDB: marker absent"))
+ (if completely (bbdb-redisplay-record-globally record nil t))
+ (bbdb-with-db-buffer
+ (barf-if-buffer-read-only)
+ (let ((tail (memq record bbdb-records))
+ (inhibit-quit t))
+ (unless tail (error "BBDB record absent: %s" record))
+ (delete-region (bbdb-record-marker record)
+ (if (cdr tail)
+ (bbdb-record-marker (car (cdr tail)))
+ bbdb-end-marker))
+ (setq bbdb-records (delq record bbdb-records))
+ (when completely
+ (bbdb-remhash (bbdb-record-name record) record)
+ (bbdb-remhash (bbdb-record-name-lf record) record)
+ (dolist (organization (bbdb-record-organization record))
+ (bbdb-remhash organization record))
+ (dolist (mail (bbdb-record-mail-canon record))
+ (bbdb-remhash mail record))
+ (dolist (aka (bbdb-record-field record 'aka-all))
+ (bbdb-remhash aka record))))))
+
+(defun bbdb-insert-record-internal (record)
+ "Insert RECORD into the database file. Return RECORD.
+Do not call this function directly, call instead `bbdb-change-record'
+that calls the hooks, too."
+ (unless (bbdb-record-marker record)
+ (bbdb-record-set-marker record (make-marker)))
+ (bbdb-with-db-buffer
+ (barf-if-buffer-read-only)
+ ;; splice record into `bbdb-records'
+ (bbdb-debug (if (memq record bbdb-records)
+ (error "BBDB record not unique: - %s" record)))
+ (if (or (not bbdb-records) ; first record in new database
+ (bbdb-record-lessp record (car bbdb-records)))
+ (push record bbdb-records)
+ (let ((records bbdb-records))
+ (while (and (cdr records)
+ (bbdb-record-lessp (nth 1 records) record))
+ (setq records (cdr records)))
+ (setcdr records (cons record (cdr records)))))
+
+ (let ((next (car (cdr (memq record bbdb-records)))))
+ (goto-char (if next
+ (bbdb-record-marker next)
+ bbdb-end-marker)))
+ ;; Before writing the record, remove the cache (we do not want that
+ ;; written to the file.) After writing, put the cache back and update
+ ;; the cache's marker.
+ (let ((cache (bbdb-record-cache record))
+ (point (point))
+ (inhibit-quit t))
+ (bbdb-debug
+ (if (= point (point-min))
+ (error "Inserting at point-min (%s)" point))
+ (if (and (/= point bbdb-end-marker)
+ (not (looking-at "^\\[")))
+ (error "Not inserting before a record (%s)" point)))
+ (bbdb-record-set-cache record nil)
+ (insert-before-markers
+ (bbdb-with-print-loadably (prin1-to-string record)) "\n")
+ (set-marker (bbdb-cache-marker cache) point)
+ (bbdb-record-set-cache record cache))
+ record))
+
+(defun bbdb-overwrite-record-internal (record)
+ "Overwrite RECORD in the database file. Return RECORD.
+Do not call this function directly, call instead `bbdb-change-record'
+that calls the hooks, too."
+ (bbdb-with-db-buffer
+ (barf-if-buffer-read-only)
+ (let* ((tail (memq record bbdb-records))
+ (_ (unless tail (error "BBDB record absent: %s" record)))
+ (cache (bbdb-record-cache record))
+ (inhibit-quit t))
+ (bbdb-debug
+ (if (<= (bbdb-cache-marker cache) (point-min))
+ (error "Cache marker is %s" (bbdb-cache-marker cache))))
+ (goto-char (bbdb-cache-marker cache))
+ (bbdb-debug
+ (if (and (/= (point) bbdb-end-marker)
+ (not (looking-at "\\[")))
+ (error "Not inserting before a record (%s)" (point))))
+
+ (bbdb-record-set-cache record nil)
+ (insert (bbdb-with-print-loadably (prin1-to-string record)) "\n")
+ (delete-region (point)
+ (if (cdr tail)
+ (bbdb-record-marker (car (cdr tail)))
+ bbdb-end-marker))
+ (bbdb-record-set-cache record cache)
+
+ (bbdb-debug
+ (if (<= (if (cdr tail)
+ (bbdb-record-marker (car (cdr tail)))
+ bbdb-end-marker)
+ (bbdb-record-marker record))
+ (error "Overwrite failed")))
+
+ record)))
+
+;; Record formatting:
+;; This does not insert anything into the *BBDB* buffer,
+;; which is handled in a second step by the display functions.
+
+(defun bbdb-layout-get-option (layout option)
+ "For LAYOUT return value of OPTION according to `bbdb-layout-alist'."
+ (let ((layout-spec (if (listp layout)
+ layout
+ (assq layout bbdb-layout-alist)))
+ option-value)
+ (and layout-spec
+ (setq option-value (assq option layout-spec))
+ (cdr option-value))))
+
+(defun bbdb-address-continental-p (address)
+ "Return non-nil if ADDRESS is a continental address.
+This is done by comparing the postcode to `bbdb-continental-postcode-regexp'.
+
+This is a possible identifying function for
+`bbdb-address-format-list' and `bbdb-tex-address-format-list'."
+ (string-match bbdb-continental-postcode-regexp
+ (bbdb-address-postcode address)))
+
+;; This function can provide some guidance for writing
+;; your own address formatting function
+(defun bbdb-format-address-default (address)
+ "Return formatted ADDRESS as a string.
+This is the default format; it is used in the US, for example.
+The result looks like this:
+ label: street
+ street
+ ...
+ city, state postcode
+ country.
+
+This function is a possible formatting function for
+`bbdb-address-format-list'."
+ (let ((country (bbdb-address-country address))
+ (streets (bbdb-address-streets address)))
+ (concat (if streets
+ (concat (mapconcat 'identity streets "\n") "\n"))
+ (bbdb-concat ", " (bbdb-address-city address)
+ (bbdb-concat " " (bbdb-address-state address)
+ (bbdb-address-postcode address)))
+ (unless (or (not country) (string= "" country))
+ (concat "\n" country)))))
+
+(defun bbdb-format-address (address layout)
+ "Format ADDRESS using LAYOUT. Return result as a string.
+The formatting rules are defined in `bbdb-address-format-list'."
+ (let ((list bbdb-address-format-list)
+ (country (bbdb-address-country address))
+ elt string)
+ (while (and (not string) (setq elt (pop list)))
+ (let ((identifier (car elt))
+ (format (nth layout elt))
+ ;; recognize case for format identifiers
+ case-fold-search str)
+ (when (or (eq t identifier) ; default
+ (and (functionp identifier)
+ (funcall identifier address))
+ (and country
+ (listp identifier)
+ ;; ignore case for countries
+ (member-ignore-case country identifier)))
+ (cond ((functionp format)
+ (setq string (funcall format address)))
+ ((stringp format)
+ (setq string "")
+ (dolist (form (split-string (substring format 1 -1)
+ (substring format 0 1) t))
+ (cond ((string-match "%s" form) ; street
+ (mapc (lambda (s) (setq string (concat string (format form s))))
+ (bbdb-address-streets address)))
+ ((string-match "%c" form) ; city
+ (unless (or (not (setq str (bbdb-address-city address))) (string= "" str))
+ (setq string (concat string (format (replace-regexp-in-string "%c" "%s" form) str)))))
+ ((string-match "%p" form) ; postcode
+ (unless (or (not (setq str (bbdb-address-postcode address))) (string= "" str))
+ (setq string (concat string (format (replace-regexp-in-string "%p" "%s" form) str)))))
+ ((string-match "%S" form) ; state
+ (unless (or (not (setq str (bbdb-address-state address))) (string= "" str))
+ (setq string (concat string (format (replace-regexp-in-string "%S" "%s" form t) str)))))
+ ((string-match "%C" form) ; country
+ (unless (or (not country) (string= "" country))
+ (setq string (concat string (format (replace-regexp-in-string "%C" "%s" form t) country)))))
+ (t (error "Malformed address format element %s" form)))))
+ (t (error "Malformed address format %s" format))))))
+ (unless string
+ (error "No match of `bbdb-address-format-list'"))
+ string))
+
+;;; Record display:
+;; This inserts formatted (pieces of) records into the BBDB buffer.
+
+(defsubst bbdb-field-property (start field)
+ "Set text property bbdb-field of text between START and point to FIELD."
+ (put-text-property start (point) 'bbdb-field field))
+
+(defsubst bbdb-display-text (text field &optional face)
+ "Insert TEXT at point. Set its text property bbdb-field to FIELD.
+If FACE is non-nil, also add face FACE."
+ (let ((start (point)))
+ (insert text)
+ (bbdb-field-property start field)
+ (if face (put-text-property start (point) 'face face))))
+
+(defun bbdb-display-list (list field &optional terminator face indent)
+ "Insert elements of LIST at point.
+For inserted text, set text property bbdb-field to FIELD.
+If TERMINATOR is non-nil use it to terminate the inserted text.
+If FACE is non-nil use it as FACE for inserted text.
+If INDENT and `bbdb-wrap-column' are integers, insert line breaks in between
+elements of LIST if otherwise inserted text exceeds `bbdb-wrap-column'."
+ ;; `truncate-lines' is fine for one-line layout. But it is annyoing
+ ;; for records that are displayed with multi-line layout.
+ ;; Non-nil `word-wrap' would be much nicer. How can we switch between
+ ;; non-nil `truncate-lines' and non-nil `word-wrap' on a per-record basis?
+ ;; The following code is an alternative solution using `bbdb-wrap-column'.
+ (let* ((separator (nth 1 (or (cdr (assq field bbdb-separator-alist))
+ bbdb-default-separator)))
+ (indent-flag (and (integerp bbdb-wrap-column)
+ (integerp indent)))
+ (prefix (if indent-flag
+ (concat separator "\n" (make-string indent ?\s))))
+ elt)
+ (while (setq elt (pop list))
+ (bbdb-display-text elt (list field elt) face)
+ (cond ((and list indent-flag
+ (> (+ (current-column) (length (car list)))
+ bbdb-wrap-column))
+ (bbdb-display-text prefix (list field) face))
+ (list
+ (bbdb-display-text separator (list field) face))
+ (terminator
+ (bbdb-display-text terminator (list field) face))))))
+
+(defun bbdb-display-name-organization (record)
+ "Insert name, affix, and organization of RECORD.
+If RECORD has an xfield name-face, its value is used for font-locking name.
+The value of name-face may be a face that is used directly.
+The value may also be a key in `bbdb-name-face-alist'. Then the
+corresponding cdr is used. If none of these schemes succeeds the face
+`bbdb-face' is used."
+ ;; Should this be further customizable? We could build the following
+ ;; from a customizable list containing function calls and strings.
+ ;; Name
+ (let ((name (if (eq 'last-first
+ (or (bbdb-record-xfield-intern record 'name-format)
+ bbdb-name-format))
+ (bbdb-record-name-lf record)
+ ;; default: Firstname Lastname
+ (bbdb-record-name record)))
+ (name-face (bbdb-record-xfield record 'name-face)))
+ (if (string= "" name) (setq name "???"))
+ (bbdb-display-text name (list 'name name)
+ (if name-face
+ (cond ((facep name-face) name-face)
+ ((cdr (assoc name-face bbdb-name-face-alist)))
+ (t 'bbdb-name))
+ 'bbdb-name)))
+ ;; Affix
+ (let ((affix (bbdb-record-affix record)))
+ (when affix
+ (insert ", ")
+ (bbdb-display-list affix 'affix)))
+ ;; Organization
+ (let ((organization (bbdb-record-organization record)))
+ (when organization
+ (insert " - ")
+ (bbdb-display-list organization 'organization nil
+ 'bbdb-organization)))
+ ;; Image
+ (if (and bbdb-image (display-images-p))
+ (let ((image (cond ((functionp bbdb-image)
+ (funcall bbdb-image record))
+ ((memq bbdb-image '(name fl-name))
+ (bbdb-record-name record))
+ ((eq bbdb-image 'lf-name)
+ (bbdb-record-name-lf record))
+ (t
+ (bbdb-record-xfield record bbdb-image)))))
+ (when (and image
+ (setq image (locate-file image bbdb-image-path
+ bbdb-image-suffixes))
+ (setq image (create-image image)))
+ (insert " ")
+ (insert-image image)))))
+
+(defun bbdb-display-record-one-line (record layout field-list)
+ "Format RECORD for the one-line FORMAT using LAYOUT.
+See `bbdb-layout-alist' for more info on layouts.
+FIELD-LIST is the list of actually displayed FIELDS."
+ ;; Name, affix, and organizations
+ (bbdb-display-name-organization record)
+ (let ((name-end (or (bbdb-layout-get-option layout 'name-end)
+ 40))
+ (start (line-beginning-position)))
+ (when (> (- (point) start -1) name-end)
+ (put-text-property (+ start name-end -4) (point) 'invisible t)
+ (insert "..."))
+ (indent-to name-end))
+ ;; rest of the fields
+ (let (formatfun start)
+ (dolist (field field-list)
+ (cond (;; customized formatting
+ (setq formatfun (intern-soft (format "bbdb-display-%s-one-line" field)))
+ (funcall formatfun record))
+ ;; phone
+ ((eq field 'phone)
+ (let ((phones (bbdb-record-phone record)) phone)
+ (if phones
+ (while (setq phone (pop phones))
+ (bbdb-display-text (format "%s " (aref phone 0))
+ `(phone ,phone field-label)
+ 'bbdb-field-name)
+ (bbdb-display-text (format "%s%s" (aref phone 1)
+ (if phones " " "; "))
+ `(phone ,phone))))))
+ ;; address
+ ((eq field 'address)
+ (dolist (address (bbdb-record-address record))
+ (setq start (point))
+ (insert (bbdb-format-address address 3))
+ (bbdb-field-property start `(address ,address))
+ (insert "; ")))
+ ;; mail
+ ((eq field 'mail)
+ (let ((mail (bbdb-record-mail record)))
+ (if mail
+ (bbdb-display-list (if (bbdb-layout-get-option layout 'primary)
+ (list (car mail)) mail)
+ 'mail "; "))))
+ ;; AKA
+ ((eq field 'aka)
+ (let ((aka (bbdb-record-aka record)))
+ (if aka
+ (bbdb-display-list aka 'aka "; "))))
+ ;; uuid
+ ((eq field 'uuid)
+ (let ((uuid (bbdb-record-uuid record)))
+ (bbdb-display-text (format "%s; " uuid) `(uuid ,uuid))))
+ ;; creation-date
+ ((eq field 'creation-date)
+ (let ((creation-date (bbdb-record-creation-date record)))
+ (bbdb-display-text (format "%s; " creation-date) `(creation-date ,creation-date))))
+ ;; timestamp
+ ((eq field 'timestamp)
+ (let ((timestamp (bbdb-record-timestamp record)))
+ (bbdb-display-text (format "%s; " timestamp) `(timestamp ,timestamp))))
+ ;; xfields
+ (t
+ (let* ((xfield (assq field (bbdb-record-xfields record)))
+ (value (cdr xfield)))
+ (if value
+ (bbdb-display-text
+ (concat (if (stringp value)
+ (replace-regexp-in-string
+ "\n" "; " value)
+ ;; value of xfield is a sexp
+ (let ((print-escape-newlines t))
+ (prin1-to-string value)))
+ "; ")
+ `(xfields ,xfield)))))))
+ ;; delete the trailing "; "
+ (if (looking-back "; " nil)
+ (backward-delete-char 2))
+ (insert "\n")))
+
+(defun bbdb-display-record-multi-line (record layout field-list)
+ "Format RECORD for the multi-line FORMAT using LAYOUT.
+See `bbdb-layout-alist' for more info on layouts.
+FIELD-LIST is the list of actually displayed FIELDS."
+ (bbdb-display-name-organization record)
+ (insert "\n")
+ (let* ((indent (or (bbdb-layout-get-option layout 'indentation) 21))
+ ;; The format string FMT adds three extra characters.
+ ;; So we subtract those from the value of INDENT.
+ (fmt (format " %%%ds: " (- indent 3)))
+ start formatfun)
+ (dolist (field field-list)
+ (setq start (point))
+ (cond (;; customized formatting
+ (setq formatfun (intern-soft (format "bbdb-display-%s-multi-line" field)))
+ (funcall formatfun record indent))
+ ;; phone
+ ((eq field 'phone)
+ (dolist (phone (bbdb-record-phone record))
+ (bbdb-display-text (format fmt (concat "phone ("
+ (bbdb-phone-label phone)
+ ")"))
+ `(phone ,phone field-label)
+ 'bbdb-field-name)
+ (bbdb-display-text (concat (bbdb-phone-string phone) "\n")
+ `(phone ,phone))))
+ ;; address
+ ((eq field 'address)
+ (dolist (address (bbdb-record-address record))
+ (bbdb-display-text (format fmt (concat "address ("
+ (bbdb-address-label address)
+ ")"))
+ `(address ,address field-label)
+ 'bbdb-field-name)
+ (setq start (point))
+ (insert (bbdb-indent-string (bbdb-format-address address 2) indent)
+ "\n")
+ (bbdb-field-property start `(address ,address))))
+ ;; mail
+ ((eq field 'mail)
+ (let ((mail (bbdb-record-mail record)))
+ (when mail
+ (bbdb-display-text (format fmt "mail") '(mail nil field-label)
+ 'bbdb-field-name)
+ (bbdb-display-list (if (bbdb-layout-get-option layout 'primary)
+ (list (car mail)) mail)
+ 'mail "\n" nil indent))))
+ ;; AKA
+ ((eq field 'aka)
+ (let ((aka (bbdb-record-aka record)))
+ (when aka
+ (bbdb-display-text (format fmt "AKA") '(aka nil field-label)
+ 'bbdb-field-name)
+ (bbdb-display-list aka 'aka "\n"))))
+ ;; uuid
+ ((eq field 'uuid)
+ (let ((uuid (bbdb-record-uuid record)))
+ (bbdb-display-text (format fmt "uuid") `(uuid ,uuid field-label)
+ 'bbdb-field-name)
+ (bbdb-display-text (format "%s\n" uuid) `(uuid ,uuid))))
+ ;; creation-date
+ ((eq field 'creation-date)
+ (let ((creation-date (bbdb-record-creation-date record)))
+ (bbdb-display-text (format fmt "creation-date") `(creation-date ,creation-date field-label)
+ 'bbdb-field-name)
+ (bbdb-display-text (format "%s\n" creation-date) `(creation-date ,creation-date))))
+ ;; timestamp
+ ((eq field 'timestamp)
+ (let ((timestamp (bbdb-record-timestamp record)))
+ (bbdb-display-text (format fmt "timestamp") `(timestamp ,timestamp field-label)
+ 'bbdb-field-name)
+ (bbdb-display-text (format "%s\n" timestamp) `(timestamp ,timestamp))))
+ ;; xfields
+ (t
+ (let* ((xfield (assq field (bbdb-record-xfields record)))
+ (value (cdr xfield)))
+ (when value
+ (bbdb-display-text (format fmt field)
+ `(xfields ,xfield field-label)
+ 'bbdb-field-name)
+ (setq start (point))
+ (insert (bbdb-indent-string
+ (if (stringp value)
+ value
+ ;; value of xfield is a sexp
+ (let ((string (pp-to-string value)))
+ (if (string-match "[ \t\n]+\\'" string)
+ (substring-no-properties
+ string 0 (match-beginning 0))
+ string)))
+ indent) "\n")
+ (bbdb-field-property start `(xfields ,xfield)))))))
+ (insert "\n")))
+
+(defalias 'bbdb-display-record-full-multi-line
+ 'bbdb-display-record-multi-line)
+
+(defalias 'bbdb-display-record-pop-up-multi-line
+ 'bbdb-display-record-multi-line)
+
+(defun bbdb-display-record (record layout number)
+ "Insert a formatted RECORD into the current buffer at point.
+LAYOUT can be a symbol describing a layout in `bbdb-layout-alist'.
+If it is nil, use `bbdb-layout'.
+NUMBER is the number of RECORD among the displayed records.
+Move point to the end of the inserted record."
+ (unless layout (setq layout bbdb-layout))
+ (unless (assq layout bbdb-layout-alist)
+ (error "Unknown layout `%s'" layout))
+ (let ((display-p (bbdb-layout-get-option layout 'display-p))
+ (omit-list (bbdb-layout-get-option layout 'omit)) ; omitted fields
+ (order-list (bbdb-layout-get-option layout 'order)); requested field order
+ (all-fields (append '(phone address mail aka) ; default field order
+ (mapcar 'car (bbdb-record-xfields record))
+ '(uuid creation-date timestamp)))
+ (beg (point))
+ format-function field-list)
+ (when (or (not display-p)
+ (and display-p
+ (funcall display-p)))
+ (if (functionp omit-list)
+ (setq omit-list (funcall omit-list record layout)))
+ (if (functionp order-list)
+ (setq order-list (funcall order-list record layout)))
+ ;; first omit unwanted fields
+ (when (and omit-list (or (not order-list) (memq t order-list)))
+ (if (listp omit-list)
+ ;; show all fields except those listed here
+ (dolist (omit omit-list)
+ (setq all-fields (delq omit all-fields)))
+ (setq all-fields nil))) ; show nothing
+ ;; then order them
+ (cond ((not order-list)
+ (setq field-list all-fields))
+ ((not (memq t order-list))
+ (setq field-list order-list))
+ (t
+ (setq order-list (reverse order-list)
+ all-fields (delq nil (mapcar (lambda (f)
+ (unless (memq f order-list)
+ f))
+ all-fields)))
+ (dolist (order order-list)
+ (if (eq t order)
+ (setq field-list (append all-fields field-list))
+ (push order field-list)))))
+ ;; call the actual format function
+ (setq format-function
+ (intern-soft (format "bbdb-display-record-%s" layout)))
+ (if (functionp format-function)
+ (funcall format-function record layout field-list)
+ (bbdb-display-record-multi-line record layout field-list))
+ (put-text-property beg (point) 'bbdb-record-number number))))
+
+(defun bbdb-display-records (records &optional layout append
+ select horiz-p)
+ "Display RECORDS using LAYOUT.
+If APPEND is non-nil append RECORDS to the already displayed records.
+Otherwise RECORDS overwrite the displayed records.
+SELECT and HORIZ-P have the same meaning as in `bbdb-pop-up-window'."
+ (interactive (list (bbdb-completing-read-records "Display records: ")
+ (bbdb-layout-prefix)))
+ (if (bbdb-append-display-p) (setq append t))
+ ;; `bbdb-redisplay-record' calls `bbdb-display-records'
+ ;; with display information already amended to RECORDS.
+ (unless (or (null records)
+ (consp (car records)))
+ ;; add layout and a marker to the local list of records
+ (setq layout (or layout bbdb-layout)
+ records (mapcar (lambda (record)
+ (list record layout (make-marker)))
+ records)))
+
+ (let ((first-new (caar records)) ; first new record
+ new-name)
+
+ ;; If `bbdb-multiple-buffers' is non-nil we create a new BBDB buffer
+ ;; when not already within one. The new buffer name starts with a space,
+ ;; i.e. it does not clutter the buffer list.
+ (when (and bbdb-multiple-buffers
+ (not (assq 'bbdb-buffer-name (buffer-local-variables))))
+ (setq new-name (concat " *BBDB " (if (functionp bbdb-multiple-buffers)
+ (funcall bbdb-multiple-buffers)
+ (buffer-name))
+ "*"))
+ ;; `bbdb-buffer-name' becomes buffer-local in the current buffer
+ ;; as well as in the buffer `bbdb-buffer-name'
+ (set (make-local-variable 'bbdb-buffer-name) new-name))
+
+ (with-current-buffer (get-buffer-create bbdb-buffer-name) ; *BBDB*
+ ;; If we are appending RECORDS to the ones already displayed,
+ ;; then first remove any duplicates, and then sort them.
+ (if append
+ (let ((old-rec (mapcar 'car bbdb-records)))
+ (dolist (record records)
+ (unless (memq (car record) old-rec)
+ (push record bbdb-records)))
+ (setq records
+ (sort bbdb-records
+ (lambda (x y) (bbdb-record-lessp (car x) (car y)))))))
+
+ (bbdb-mode)
+ ;; Normally `bbdb-records' is the only BBDB-specific buffer-local variable
+ ;; in the *BBDB* buffer. It is intentionally not permanent-local.
+ ;; A value of nil indicates that we need to (re)process the records.
+ (setq bbdb-records records)
+ (if new-name
+ (set (make-local-variable 'bbdb-buffer-name) new-name))
+
+ (unless (or bbdb-silent-internal bbdb-silent)
+ (message "Formatting BBDB..."))
+ (let ((record-number 0)
+ buffer-read-only all-records)
+ (erase-buffer)
+ (bbdb-debug (setq all-records (bbdb-records)))
+ (dolist (record records)
+ (bbdb-debug (unless (memq (car record) all-records)
+ (error "Record %s does not exist" (car record))))
+ (set-marker (nth 2 record) (point))
+ (bbdb-display-record (nth 0 record) (nth 1 record) record-number)
+ (setq record-number (1+ record-number)))
+
+ (run-hooks 'bbdb-display-hook))
+
+ (unless (or bbdb-silent-internal bbdb-silent)
+ (message "Formatting BBDB...done."))
+ (set-buffer-modified-p nil)
+
+ (bbdb-pop-up-window select horiz-p)
+ (if (not first-new)
+ (goto-char (point-min))
+ ;; Put point on first new record in *BBDB* buffer.
+ (goto-char (nth 2 (assq first-new bbdb-records)))
+ (set-window-start (get-buffer-window (current-buffer)) (point))))))
+
+(defun bbdb-undisplay-records (&optional all-buffers)
+ "Undisplay records in *BBDB* buffer, leaving this buffer empty.
+If ALL-BUFFERS is non-nil undisplay records in all BBDB buffers."
+ (dolist (buffer (cond (all-buffers (buffer-list))
+ ((let ((buffer (get-buffer bbdb-buffer-name)))
+ (and (buffer-live-p buffer) (list buffer))))))
+ (with-current-buffer buffer
+ (when (eq major-mode 'bbdb-mode)
+ (let (buffer-read-only)
+ (erase-buffer))
+ (setq bbdb-records nil)
+ (set-buffer-modified-p nil)))))
+
+(defun bbdb-redisplay-record (record &optional sort delete-p)
+ "Redisplay RECORD in current BBDB buffer.
+If SORT is t, usually because RECORD has a new sortkey, re-sort
+the displayed records.
+If DELETE-P is non-nil RECORD is removed from the BBDB buffer."
+ ;; For deletion in the *BBDB* buffer we use the full information
+ ;; about the record in the database. Therefore, we need to delete
+ ;; the record in the *BBDB* buffer before deleting the record in
+ ;; the database.
+ ;; FIXME: If point is initially inside RECORD, `bbdb-redisplay-record'
+ ;; puts point at the beginning of the redisplayed RECORD.
+ ;; Ideally, `bbdb-redisplay-record' should put point such that it
+ ;; matches the previous value `bbdb-ident-point'.
+ (let ((full-record (assq record bbdb-records)))
+ (unless full-record
+ (error "Record `%s' not displayed" (bbdb-record-name record)))
+ (if (and sort (not delete-p))
+ ;; FIXME: For records requiring re-sorting it may be more efficient
+ ;; to insert these records in their proper location instead of
+ ;; re-displaying all records.
+ (bbdb-display-records (list record) nil t)
+ (let ((marker (nth 2 full-record))
+ (end-marker (nth 2 (car (cdr (memq full-record bbdb-records)))))
+ buffer-read-only record-number)
+ ;; If point is inside record, put it at the beginning of the record.
+ (if (and (<= marker (point))
+ (< (point) (or end-marker (point-max))))
+ (goto-char marker))
+ (save-excursion
+ (goto-char marker)
+ (setq record-number (get-text-property (point) 'bbdb-record-number))
+ (unless delete-p
+ ;; First insert the reformatted record, then delete the old one,
+ ;; so that the marker of this record cannot collapse with the
+ ;; marker of the subsequent record
+ (bbdb-display-record (car full-record) (nth 1 full-record)
+ record-number))
+ (delete-region (point) (or end-marker (point-max)))
+ ;; If we deleted a record we need to update the subsequent
+ ;; record numbers.
+ (when delete-p
+ (let* ((markers (append (mapcar (lambda (x) (nth 2 x))
+ (cdr (memq full-record bbdb-records)))
+ (list (point-max))))
+ (start (pop markers)))
+ (dolist (end markers)
+ (put-text-property start end
+ 'bbdb-record-number record-number)
+ (setq start end
+ record-number (1+ record-number))))
+ (setq bbdb-records (delq full-record bbdb-records)))
+ (run-hooks 'bbdb-display-hook))))))
+
+(defun bbdb-redisplay-record-globally (record &optional sort delete-p)
+ "Redisplay RECORD in all BBDB buffers.
+If SORT is t, usually because RECORD has a new sortkey, re-sort
+the displayed records.
+If DELETE-P is non-nil RECORD is removed from the BBDB buffers."
+ (dolist (buffer (buffer-list))
+ (with-current-buffer buffer
+ (if (and (eq major-mode 'bbdb-mode)
+ (memq record (mapcar 'car bbdb-records)))
+ (let ((window (get-buffer-window bbdb-buffer-name)))
+ (if window
+ (with-selected-window window
+ (bbdb-redisplay-record record sort delete-p))
+ (bbdb-redisplay-record record sort delete-p)))))))
+(define-obsolete-function-alias 'bbdb-maybe-update-display
+ 'bbdb-redisplay-record-globally "3.0")
+\f
+
+;;; window configuration hackery
+(defun bbdb-pop-up-window (&optional select horiz-p)
+ "Display *BBDB* buffer by popping up a new window.
+Finds the largest window on the screen, splits it, displaying the
+*BBDB* buffer in the bottom `bbdb-pop-up-window-size' lines (unless
+the *BBDB* buffer is already visible, in which case do nothing.)
+Select this window if SELECT is non-nil.
+
+If `bbdb-mua-pop-up' is 'horiz, and the first window matching
+the predicate HORIZ-P is wider than the car of `bbdb-horiz-pop-up-window-size'
+then the window will be split horizontally rather than vertically."
+ (let ((buffer (get-buffer bbdb-buffer-name)))
+ (unless buffer
+ (error "No %s buffer to display" bbdb-buffer-name))
+ (cond ((let ((window (get-buffer-window buffer t)))
+ ;; We already have a BBDB window so that at most we select it
+ (and window
+ (or (not select) (select-window window)))))
+
+ ;; try horizontal split
+ ((and (eq bbdb-mua-pop-up 'horiz)
+ horiz-p
+ (>= (frame-width) (car bbdb-horiz-pop-up-window-size))
+ (let ((window-list (window-list))
+ (b-width (cdr bbdb-horiz-pop-up-window-size))
+ (search t) s-window)
+ (while (and (setq s-window (pop window-list))
+ (setq search (not (funcall horiz-p s-window)))))
+ (unless (or search (<= (window-width s-window)
+ (car bbdb-horiz-pop-up-window-size)))
+ (condition-case nil ; `split-window' might fail
+ (let ((window (split-window
+ s-window
+ (if (integerp b-width)
+ (- (window-width s-window) b-width)
+ (round (* (- 1 b-width) (window-width s-window))))
+ t))) ; horizontal split
+ (set-window-buffer window buffer)
+ (cond (bbdb-dedicated-window
+ (set-window-dedicated-p window bbdb-dedicated-window))
+ ((fboundp 'display-buffer-record-window) ; GNU Emacs >= 24.1
+ (set-window-prev-buffers window nil)
+ (display-buffer-record-window 'window window buffer)))
+ (if select (select-window window))
+ t)
+ (error nil))))))
+
+ ((eq t bbdb-pop-up-window-size)
+ (bbdb-pop-up-window-simple buffer select))
+
+ (t ;; vertical split
+ (let* ((window (selected-window))
+ (window-height (window-height window)))
+ ;; find the tallest window...
+ (mapc (lambda (w)
+ (let ((w-height (window-height w)))
+ (if (> w-height window-height)
+ (setq window w window-height w-height))))
+ (window-list))
+ (condition-case nil
+ (progn
+ (unless (eql bbdb-pop-up-window-size 1.0)
+ (setq window (split-window ; might fail
+ window
+ (if (integerp bbdb-pop-up-window-size)
+ (- window-height 1 ; for mode line
+ (max window-min-height bbdb-pop-up-window-size))
+ (round (* (- 1 bbdb-pop-up-window-size)
+ window-height))))))
+ (set-window-buffer window buffer) ; might fail
+ (cond (bbdb-dedicated-window
+ (set-window-dedicated-p window bbdb-dedicated-window))
+ ((and (fboundp 'display-buffer-record-window) ; GNU Emacs >= 24.1
+ (not (eql bbdb-pop-up-window-size 1.0)))
+ (set-window-prev-buffers window nil)
+ (display-buffer-record-window 'window window buffer)))
+ (if select (select-window window)))
+ (error (bbdb-pop-up-window-simple buffer select))))))))
+
+(defun bbdb-pop-up-window-simple (buffer select)
+ "Display BUFFER in some window, selecting it if SELECT is non-nil.
+If `bbdb-dedicated-window' is non-nil, mark the window as dedicated."
+ (let ((window (if select
+ (progn (pop-to-buffer buffer)
+ (get-buffer-window))
+ (display-buffer buffer))))
+ (if bbdb-dedicated-window
+ (set-window-dedicated-p window bbdb-dedicated-window))))
+
+\f
+;;; BBDB mode
+
+;;;###autoload
+(define-derived-mode bbdb-mode special-mode "BBDB"
+ "Major mode for viewing and editing the Insidious Big Brother Database.
+Letters no longer insert themselves. Numbers are prefix arguments.
+You can move around using the usual cursor motion commands.
+\\<bbdb-mode-map>
+\\[bbdb-add-mail-alias]\t Add new mail alias to visible records or \
+remove it.
+\\[bbdb-edit-field]\t Edit the field on the current line.
+\\[bbdb-delete-field-or-record]\t Delete the field on the \
+current line. If the current line is the\n\t first line of a record, then \
+delete the entire record.
+\\[bbdb-insert-field]\t Insert a new field into the current record. \
+Note that this\n\t will let you add new fields of your own as well.
+\\[bbdb-transpose-fields]\t Swap the field on the current line with the \
+previous field.
+\\[bbdb-dial]\t Dial the current phone field.
+\\[bbdb-next-record], \\[bbdb-prev-record]\t Move to the next or the previous \
+displayed record, respectively.
+\\[bbdb-create]\t Create a new record.
+\\[bbdb-toggle-records-layout]\t Toggle whether the current record is displayed in a \
+one-line\n\t listing, or a full multi-line listing.
+\\[bbdb-do-all-records]\\[bbdb-toggle-records-layout]\t Do that \
+for all displayed records.
+\\[bbdb-merge-records]\t Merge the contents of the current record with \
+some other, and then\n\t delete the current record.
+\\[bbdb-omit-record]\t Remove the current record from the display without \
+deleting it from\n\t the database. This is often a useful thing to do \
+before using one\n\t of the `*' commands.
+\\[bbdb]\t Search for records in the database (on all fields).
+\\[bbdb-search-mail]\t Search for records by mail address.
+\\[bbdb-search-organization]\t Search for records by organization.
+\\[bbdb-search-xfields]\t Search for records by xfields.
+\\[bbdb-search-name]\t Search for records by name.
+\\[bbdb-search-changed]\t Display records that have changed since the database \
+was saved.
+\\[bbdb-mail]\t Compose mail to the person represented by the \
+current record.
+\\[bbdb-do-all-records]\\[bbdb-mail]\t Compose mail \
+to everyone whose record is displayed.
+\\[bbdb-save]\t Save the BBDB file to disk.
+\\[bbdb-tex]\t Create a TeX listing of the current record.
+\\[bbdb-do-all-records]\\[bbdb-tex]\t Do that for all \
+displayed record.
+\\[other-window]\t Move to another window.
+\\[bbdb-info]\t Read the Info documentation for BBDB.
+\\[bbdb-help]\t Display a one line command summary in the echo area.
+\\[bbdb-browse-url]\t Visit Web sites listed in the `url' field(s) of the current \
+record.
+
+For address completion using the names and mail addresses in the database:
+\t in Mail mode, type \\<mail-mode-map>\\[bbdb-complete-mail].
+\t in Message mode, type \\<message-mode-map>\\[bbdb-complete-mail].
+
+Important variables:
+\t `bbdb-auto-revert'
+\t `bbdb-ignore-redundant-mails'
+\t `bbdb-case-fold-search'
+\t `bbdb-completion-list'
+\t `bbdb-default-area-code'
+\t `bbdb-default-domain'
+\t `bbdb-layout'
+\t `bbdb-file'
+\t `bbdb-phone-style'
+\t `bbdb-check-auto-save-file'
+\t `bbdb-pop-up-layout'
+\t `bbdb-pop-up-window-size'
+\t `bbdb-add-name'
+\t `bbdb-add-aka'
+\t `bbdb-add-mails'
+\t `bbdb-new-mails-primary'
+\t `bbdb-read-only'
+\t `bbdb-mua-pop-up'
+\t `bbdb-user-mail-address-re'
+
+There are numerous hooks. M-x apropos ^bbdb.*hook RET
+
+\\{bbdb-mode-map}"
+ (setq truncate-lines t
+ default-directory (file-name-directory bbdb-file)
+ mode-line-buffer-identification
+ (list 24 (buffer-name) " "
+ '(:eval (format "%d/%d/%d"
+ (1+ (or (get-text-property
+ (point) 'bbdb-record-number) -1))
+ (length bbdb-records)
+ ;; This code gets called a lot.
+ ;; So we keep it as simple as possible.
+ (with-current-buffer bbdb-buffer
+ (length bbdb-records))))
+ '(:eval (concat " "
+ (bbdb-concat " " (elt bbdb-modeline-info 0)
+ (elt bbdb-modeline-info 2)
+ (elt bbdb-modeline-info 4)))))
+ mode-line-modified
+ ;; For the mode-line we want to be fast. So we skip the checks
+ ;; performed by `bbdb-with-db-buffer'.
+ '(:eval (if (buffer-modified-p bbdb-buffer)
+ (if bbdb-read-only "%*" "**")
+ (if bbdb-read-only "%%" "--"))))
+ ;; `bbdb-revert-buffer' acts on `bbdb-buffer'. Yet this command is usually
+ ;; called from the *BBDB* buffer.
+ (set (make-local-variable 'revert-buffer-function)
+ 'bbdb-revert-buffer)
+ (add-hook 'post-command-hook 'force-mode-line-update nil t))
+
+\f
+
+(defun bbdb-sendmail-menu (record)
+ "Menu items for email addresses of RECORD."
+ (let ((mails (bbdb-record-mail record)))
+ (list
+ (if (cdr mails)
+ ;; Submenu for multiple mail addresses
+ (cons "Send mail to..."
+ (mapcar (lambda (address)
+ (vector address `(bbdb-compose-mail
+ ,(bbdb-dwim-mail record address))
+ t))
+ mails))
+ ;; Single entry for single mail address
+ (vector (concat "Send mail to " (car mails))
+ `(bbdb-compose-mail ,(bbdb-dwim-mail record (car mails)))
+ t)))))
+
+(defun bbdb-field-menu (record field)
+ "Menu items specifically for FIELD of RECORD."
+ (let ((type (car field)))
+ (append
+ (list
+ (format "Commands for %s Field:"
+ (cond ((eq type 'xfields)
+ (format "\"%s\"" (symbol-name (car (nth 1 field)))))
+ ((eq type 'name) "Name")
+ ((eq type 'affix) "Affix")
+ ((eq type 'organization) "Organization")
+ ((eq type 'aka) "Alternate Names")
+ ((eq type 'mail) "Mail Addresses")
+ ((memq type '(address phone))
+ (format "\"%s\" %s" (aref (nth 1 field) 0)
+ (capitalize (symbol-name type)))))))
+ (cond ((eq type 'phone)
+ (list (vector (concat "Dial " (bbdb-phone-string (nth 1 field)))
+ `(bbdb-dial ',field nil) t)))
+ ((eq type 'xfields)
+ (let* ((field (cadr field))
+ (type (car field)))
+ (cond ((eq type 'url )
+ (list (vector (format "Browse \"%s\"" (cdr field))
+ `(bbdb-browse-url ,record) t)))))))
+ '(["Edit Field" bbdb-edit-field t])
+ (unless (eq type 'name)
+ '(["Delete Field" bbdb-delete-field-or-record t])))))
+
+(defun bbdb-insert-field-menu (record)
+ "Submenu for inserting a new field for RECORD."
+ (cons "Insert New Field..."
+ (mapcar
+ (lambda (field)
+ (if (stringp field) field
+ (vector (symbol-name field)
+ `(bbdb-insert-field
+ ,record ',field (bbdb-read-field ,record ',field
+ ,current-prefix-arg))
+ (not (or (and (eq field 'affix) (bbdb-record-affix record))
+ (and (eq field 'organization)
+ (bbdb-record-organization record))
+ (and (eq field 'mail) (bbdb-record-mail record))
+ (and (eq field 'aka) (bbdb-record-aka record))
+ (assq field (bbdb-record-xfields record)))))))
+ (append '(affix organization aka phone address mail)
+ '("--") bbdb-xfield-label-list))))
+
+(defun bbdb-mouse-menu (event)
+ "BBDB mouse menu for EVENT,"
+ (interactive "e")
+ (mouse-set-point event)
+ (let* ((record (bbdb-current-record))
+ (field (bbdb-current-field))
+ (menu (if (and record field (functionp bbdb-user-menu-commands))
+ (funcall bbdb-user-menu-commands record field)
+ bbdb-user-menu-commands)))
+ (if record
+ (popup-menu
+ (append
+ (list
+ (format "Commands for record \"%s\":" (bbdb-record-name record))
+ ["Delete Record" bbdb-delete-records t]
+ ["Toggle Record Display Layout" bbdb-toggle-records-layout t]
+ (if (and (not (eq 'full-multi-line
+ (nth 1 (assq record bbdb-records))))
+ (bbdb-layout-get-option 'multi-line 'omit))
+ ["Fully Display Record" bbdb-display-records-completely t])
+ ["Omit Record" bbdb-omit-record t]
+ ["Merge Record" bbdb-merge-records t])
+ (if (bbdb-record-mail record)
+ (bbdb-sendmail-menu record))
+ (list "--" (bbdb-insert-field-menu record))
+ (if field
+ (cons "--" (bbdb-field-menu record field)))
+ (if menu
+ (append '("--" "User Defined Commands") menu)))))))
+
+\f
+
+(defun bbdb-scan-property (property predicate n)
+ "Scan for change of PROPERTY matching PREDICATE for N times.
+Return position of beginning of matching interval."
+ (let ((fun (if (< 0 n) 'next-single-property-change
+ 'previous-single-property-change))
+ (limit (if (< 0 n) (point-max) (point-min)))
+ (nn (abs n))
+ (i 0)
+ (opoint (point))
+ npoint)
+ ;; For backward search, move point to beginning of interval with PROPERTY.
+ (if (and (<= n 0)
+ (< (point-min) opoint)
+ (let ((prop (get-text-property opoint property)))
+ (and (eq prop (get-text-property (1- opoint) property))
+ (funcall predicate prop))))
+ (setq opoint (previous-single-property-change opoint property nil limit)))
+ (if (zerop n)
+ opoint ; Return beginning of interval point is in
+ (while (and (< i nn)
+ (let (done)
+ (while (and (not done)
+ (setq npoint (funcall fun opoint property nil limit)))
+ (cond ((and (/= opoint npoint)
+ (funcall predicate (get-text-property
+ npoint property)))
+ (setq opoint npoint done t))
+ ((= opoint npoint)
+ ;; Search reached beg or end of buffer: abort.
+ (setq done t i nn npoint nil))
+ (t (setq opoint npoint))))
+ done))
+ (setq i (1+ i)))
+ npoint)))
+
+(defun bbdb-next-record (n)
+ "Move point to the beginning of the next BBDB record.
+With prefix N move forward N records."
+ (interactive "p")
+ (let ((npoint (bbdb-scan-property 'bbdb-record-number 'integerp n)))
+ (if npoint (goto-char npoint)
+ (error "No %s record" (if (< 0 n) "next" "previous")))))
+
+(defun bbdb-prev-record (n)
+ "Move point to the beginning of the previous BBDB record.
+With prefix N move backwards N records."
+ (interactive "p")
+ (bbdb-next-record (- n)))
+
+(defun bbdb-next-field (n)
+ "Move point to next (sub)field.
+With prefix N move forward N (sub)fields."
+ (interactive "p")
+ (let ((npoint (bbdb-scan-property
+ 'bbdb-field
+ (lambda (p) (and (nth 1 p)
+ (not (eq (nth 2 p) 'field-label))))
+ n)))
+ (if npoint (goto-char npoint)
+ (error "No %s field" (if (< 0 n) "next" "previous")))))
+
+(defun bbdb-prev-field (n)
+ "Move point to previous (sub)field.
+With prefix N move backwards N (sub)fields."
+ (interactive "p")
+ (bbdb-next-field (- n)))
+
+(defun bbdb-save (&optional prompt noisy)
+ "Save the BBDB if it is modified.
+If PROMPT is non-nil prompt before saving.
+If NOISY is non-nil as in interactive calls issue status messages."
+ (interactive (list nil t))
+ (bbdb-with-db-buffer
+ (if (buffer-modified-p)
+ (if (or (not prompt)
+ (y-or-n-p
+ (if bbdb-read-only
+ "Save the BBDB, even though it is supposedly read-only? "
+ "Save the BBDB now? ")))
+ (save-buffer))
+ (if noisy (message "(No BBDB changes need to be saved)")))))
+
+;;;###autoload
+(defun bbdb-version (&optional arg)
+ "Return string describing the version of BBDB.
+With prefix ARG, insert string at point."
+ (interactive (list (or (and current-prefix-arg 1) t)))
+ (let* ((version
+ (if (string-match "\\`[ \t\n]*[1-9]" bbdb-version)
+ bbdb-version
+ (let ((source (find-function-noselect 'bbdb-version)))
+ (if source
+ (with-current-buffer (car source)
+ (prog1 (save-excursion
+ (goto-char (point-min))
+ (when (re-search-forward
+ "^;;+ *Version: \\(.*\\)" nil t)
+ (match-string-no-properties 1)))
+ (unless (get-buffer-window nil t)
+ (kill-buffer (current-buffer)))))))))
+ (version-string (format "BBDB version %s" (or version "<unknown>"))))
+ (cond ((numberp arg) (insert (message version-string)))
+ ((eq t arg) (message version-string))
+ (t version-string))))
+
+\f
+
+(defun bbdb-sort-records ()
+ "Sort BBDB database.
+This is not needed when using BBDB itself. It might be necessary,
+however, after having used other programs to add records to the BBDB."
+ (interactive)
+ (let* ((records (copy-sequence (bbdb-records))))
+ (bbdb-with-db-buffer
+ (setq bbdb-records (sort bbdb-records 'bbdb-record-lessp))
+ (if (equal records bbdb-records)
+ (message "BBDB already sorted properly")
+ (message "BBDB was mis-sorted; fixing...")
+ (bbdb-goto-first-record)
+ (delete-region (point) bbdb-end-marker)
+ (let ((buf (current-buffer))
+ (inhibit-quit t) ; really, don't mess with this
+ cache)
+ (dolist (record bbdb-records)
+ ;; Before printing the record, remove cache (we do not want that
+ ;; written to the file.) Ater writing, put the cache back
+ ;; and update the cache's marker.
+ (setq cache (bbdb-record-cache record))
+ (set-marker (bbdb-cache-marker cache) (point))
+ (bbdb-record-set-cache record nil)
+ (bbdb-with-print-loadably (prin1 record buf))
+ (bbdb-record-set-cache record cache)
+ (insert ?\n)))
+ (dolist (buffer (buffer-list))
+ (with-current-buffer buffer
+ (if (eq major-mode 'bbdb-mode)
+ ; Redisplay all records
+ (bbdb-display-records nil nil t))))
+ (message "BBDB was mis-sorted; fixing...done")))))
+
+\f
+
+;;;###autoload
+(defun bbdb-initialize (&rest muas)
+ "Initialize BBDB for MUAS and miscellaneous packages.
+List MUAS may include the following symbols to initialize the respective
+mail/news readers, composers, and miscellaneous packages:
+ gnus Gnus mail/news reader.
+ mh-e MH-E mail reader.
+ mu4e Mu4e mail reader.
+ rmail Rmail mail reader.
+ vm VM mail reader.
+ mail Mail (M-x mail).
+ message Message mode.
+ wl Wanderlust mail reader.
+
+ anniv Anniversaries in Emacs diary.
+
+ sc Supercite. However, this is not the full story.
+ See bbdb-sc.el for how to fully hook BBDB into Supercite.
+
+ pgp PGP support: this adds `bbdb-pgp' to `message-send-hook'
+ and `mail-send-hook' so that `bbdb-pgp' runs automatically
+ when a message is sent.
+ Yet see info node `(message)Signing and encryption'
+ why you might not want to rely for encryption on a hook
+ function which runs just before the message is sent,
+ that is, you might want to call the command `bbdb-pgp' manually,
+ then call `mml-preview'.
+
+See also `bbdb-mua-auto-update-init'. The latter is a separate function
+as this allows one to initialize the auto update feature for some MUAs only,
+for example only for outgoing messages."
+ (dolist (mua muas)
+ (let ((init (assq mua bbdb-init-forms)))
+ (if init
+ ;; Should we make sure that each insinuation happens only once?
+ (eval (cadr init))
+ (bbdb-warn "Do not know how to insinuate `%s'" mua))))
+ (run-hooks 'bbdb-initialize-hook))
+
+\f
+(provide 'bbdb)
+
+;;; bbdb.el ends here
--- /dev/null
+Ceci est le fichier .../info/dir, qui contient le nœud le
+plus haut de la hiérarchie Info. Ce nœud est appelé (dir)Top.
+C'est de ce nœud que vous démarrez la première fois que
+vous utilisez Info.
+\1f
+File: dir, Node: Top Ceci est le haut de l'arborescence INFO
+
+ Ceci (le nœud Répertoire) fournit un menu des sujets majeurs.
+ Entrez « q » pour quitter, « H » pour afficher toutes les commandes Info,
+ « d » pour revenir ici ;, « h » affiche un guide d'initiation pour les
+ nouveaux venus.
+ « mEmacs<Entrée> » démarre une consultation du manuel Emacs, et cætera.
+
+ Dans Emacs, vous pouvez cliquer avec le deuxième bouton de la souris
+ sur une entrée de menu ou sur un renvoi pour le sélectionner.
+
+* Menu:
+
+Emacs misc features
+* BBDB: (bbdb). Insidious Big Brother Database (BBDB).
--- /dev/null
+# doc/Makefile.am for BBDB
+#
+# Copyright (C) 2013 Christian Egli <christian.egli@sbs.ch>
+# Copyright (C) 2013-2017 Roland Winkler <winkler@gnu.org>
+#
+# This file is part of the Insidious Big Brother Database (aka BBDB),
+#
+# BBDB is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# BBDB is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+info_TEXINFOS = bbdb.texi
+bbdb_TEXINFOS = doclicense.texi gpl.texi
+
+doc_DATA = bbdb.pdf
+
+bbdb.info bbdb.pdf: $(bbdb_TEXINFOS)
--- /dev/null
+\input texinfo @c -*-texinfo-*-
+@c %**start of header
+@setfilename bbdb.info
+@settitle Insidious Big Brother Database (BBDB) User Manual
+@c %**end of header
+
+@copying
+This file documents the Insidious Big Brother Database (BBDB)
+
+Copyright (C) 2011-2017 Roland Winkler <winkler@@gnu.org>
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3
+or any later version published by the Free Software Foundation;
+with the Invariant Section being ``GNU GENERAL PUBLIC LICENSE,''
+A copy of the license is included in the section entitled
+``GNU Free Documentation License.''
+@end quotation
+@end copying
+
+@dircategory Emacs misc features
+@direntry
+* BBDB: (bbdb). Insidious Big Brother Database (BBDB).
+@end direntry
+
+@titlepage
+@title Insidious Big Brother Database (BBDB) User Manual
+@page
+@vskip 0pt plus 1filll
+@insertcopying
+@end titlepage
+
+@c Output the table of the contents at the beginning.
+@contents
+
+@ifnottex
+@node Top, First Chapter, (dir), (dir)
+@top BBDB User Manual
+
+@insertcopying
+@end ifnottex
+
+@menu
+* First Chapter:: The first chapter is the only chapter
+ in this sample.
+
+Appendices
+* Copying:: The GNU General Public License gives you permission
+ to redistribute GNU Emacs on certain terms;
+ it also explains that there is no warranty.
+* GNU Free Documentation License:: The license for this documentation.
+* Index:: Complete index.
+
+
+
+
+@end menu
+
+@node First Chapter, Copying, Top, Top
+@chapter First Chapter
+
+@cindex chapter, first
+
+This is the first chapter.
+@cindex index entry, another
+
+Here is a numbered list.
+
+@enumerate
+@item
+This is the first item.
+
+@item
+This is the second item.
+@end enumerate
+
+
+@node Copying, GNU Free Documentation License, First Chapter, Top
+@appendix GNU GENERAL PUBLIC LICENSE
+@include gpl.texi
+
+@node GNU Free Documentation License, Index, Copying, Top
+@appendix GNU Free Documentation License
+@include doclicense.texi
+
+@node Index, , GNU Free Documentation License, Top
+@unnumbered Index
+
+@printindex cp
+
+@bye
--- /dev/null
+@c -*-texinfo-*-
+@c The GNU Free Documentation License.
+@center Version 1.3, 3 November 2008
+
+@c This file is intended to be included within another document,
+@c hence no sectioning command or @node.
+
+@display
+Copyright @copyright{} 2000, 2001, 2002, 2007, 2008, 2009 Free Software Foundation, Inc.
+@uref{http://fsf.org/}
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+@end display
+
+@enumerate 0
+@item
+PREAMBLE
+
+The purpose of this License is to make a manual, textbook, or other
+functional and useful document @dfn{free} in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it,
+with or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible
+for modifications made by others.
+
+This License is a kind of ``copyleft'', which means that derivative
+works of the document must themselves be free in the same sense. It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does. But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book. We recommend this License
+principally for works whose purpose is instruction or reference.
+
+@item
+APPLICABILITY AND DEFINITIONS
+
+This License applies to any manual or other work, in any medium, that
+contains a notice placed by the copyright holder saying it can be
+distributed under the terms of this License. Such a notice grants a
+world-wide, royalty-free license, unlimited in duration, to use that
+work under the conditions stated herein. The ``Document'', below,
+refers to any such manual or work. Any member of the public is a
+licensee, and is addressed as ``you''. You accept the license if you
+copy, modify or distribute the work in a way requiring permission
+under copyright law.
+
+A ``Modified Version'' of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+
+A ``Secondary Section'' is a named appendix or a front-matter section
+of the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document's overall
+subject (or to related matters) and contains nothing that could fall
+directly within that overall subject. (Thus, if the Document is in
+part a textbook of mathematics, a Secondary Section may not explain
+any mathematics.) The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+
+The ``Invariant Sections'' are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License. If a
+section does not fit the above definition of Secondary then it is not
+allowed to be designated as Invariant. The Document may contain zero
+Invariant Sections. If the Document does not identify any Invariant
+Sections then there are none.
+
+The ``Cover Texts'' are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License. A Front-Cover Text may
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
+
+A ``Transparent'' copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, that is suitable for revising the document
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters. A copy made in an otherwise Transparent file
+format whose markup, or absence of markup, has been arranged to thwart
+or discourage subsequent modification by readers is not Transparent.
+An image format is not Transparent if used for any substantial amount
+of text. A copy that is not ``Transparent'' is called ``Opaque''.
+
+Examples of suitable formats for Transparent copies include plain
+@sc{ascii} without markup, Texinfo input format, La@TeX{} input
+format, @acronym{SGML} or @acronym{XML} using a publicly available
+@acronym{DTD}, and standard-conforming simple @acronym{HTML},
+PostScript or @acronym{PDF} designed for human modification. Examples
+of transparent image formats include @acronym{PNG}, @acronym{XCF} and
+@acronym{JPG}. Opaque formats include proprietary formats that can be
+read and edited only by proprietary word processors, @acronym{SGML} or
+@acronym{XML} for which the @acronym{DTD} and/or processing tools are
+not generally available, and the machine-generated @acronym{HTML},
+PostScript or @acronym{PDF} produced by some word processors for
+output purposes only.
+
+The ``Title Page'' means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page. For works in
+formats which do not have any title page as such, ``Title Page'' means
+the text near the most prominent appearance of the work's title,
+preceding the beginning of the body of the text.
+
+The ``publisher'' means any person or entity that distributes copies
+of the Document to the public.
+
+A section ``Entitled XYZ'' means a named subunit of the Document whose
+title either is precisely XYZ or contains XYZ in parentheses following
+text that translates XYZ in another language. (Here XYZ stands for a
+specific section name mentioned below, such as ``Acknowledgements'',
+``Dedications'', ``Endorsements'', or ``History''.) To ``Preserve the Title''
+of such a section when you modify the Document means that it remains a
+section ``Entitled XYZ'' according to this definition.
+
+The Document may include Warranty Disclaimers next to the notice which
+states that this License applies to the Document. These Warranty
+Disclaimers are considered to be included by reference in this
+License, but only as regards disclaiming warranties: any other
+implication that these Warranty Disclaimers may have is void and has
+no effect on the meaning of this License.
+
+@item
+VERBATIM COPYING
+
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License. You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute. However, you may accept
+compensation in exchange for copies. If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+
+@item
+COPYING IN QUANTITY
+
+If you publish printed copies (or copies in media that commonly have
+printed covers) of the Document, numbering more than 100, and the
+Document's license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover. Both covers must also clearly and legibly identify
+you as the publisher of these copies. The front cover must present
+the full title with all words of the title equally prominent and
+visible. You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a computer-network location from which the general network-using
+public has access to download using public-standard network protocols
+a complete Transparent copy of the Document, free of added material.
+If you use the latter option, you must take reasonably prudent steps,
+when you begin distribution of Opaque copies in quantity, to ensure
+that this Transparent copy will remain thus accessible at the stated
+location until at least one year after the last time you distribute an
+Opaque copy (directly or through your agents or retailers) of that
+edition to the public.
+
+It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+
+@item
+MODIFICATIONS
+
+You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it. In addition, you must do these things in the Modified Version:
+
+@enumerate A
+@item
+Use in the Title Page (and on the covers, if any) a title distinct
+from that of the Document, and from those of previous versions
+(which should, if there were any, be listed in the History section
+of the Document). You may use the same title as a previous version
+if the original publisher of that version gives permission.
+
+@item
+List on the Title Page, as authors, one or more persons or entities
+responsible for authorship of the modifications in the Modified
+Version, together with at least five of the principal authors of the
+Document (all of its principal authors, if it has fewer than five),
+unless they release you from this requirement.
+
+@item
+State on the Title page the name of the publisher of the
+Modified Version, as the publisher.
+
+@item
+Preserve all the copyright notices of the Document.
+
+@item
+Add an appropriate copyright notice for your modifications
+adjacent to the other copyright notices.
+
+@item
+Include, immediately after the copyright notices, a license notice
+giving the public permission to use the Modified Version under the
+terms of this License, in the form shown in the Addendum below.
+
+@item
+Preserve in that license notice the full lists of Invariant Sections
+and required Cover Texts given in the Document's license notice.
+
+@item
+Include an unaltered copy of this License.
+
+@item
+Preserve the section Entitled ``History'', Preserve its Title, and add
+to it an item stating at least the title, year, new authors, and
+publisher of the Modified Version as given on the Title Page. If
+there is no section Entitled ``History'' in the Document, create one
+stating the title, year, authors, and publisher of the Document as
+given on its Title Page, then add an item describing the Modified
+Version as stated in the previous sentence.
+
+@item
+Preserve the network location, if any, given in the Document for
+public access to a Transparent copy of the Document, and likewise
+the network locations given in the Document for previous versions
+it was based on. These may be placed in the ``History'' section.
+You may omit a network location for a work that was published at
+least four years before the Document itself, or if the original
+publisher of the version it refers to gives permission.
+
+@item
+For any section Entitled ``Acknowledgements'' or ``Dedications'', Preserve
+the Title of the section, and preserve in the section all the
+substance and tone of each of the contributor acknowledgements and/or
+dedications given therein.
+
+@item
+Preserve all the Invariant Sections of the Document,
+unaltered in their text and in their titles. Section numbers
+or the equivalent are not considered part of the section titles.
+
+@item
+Delete any section Entitled ``Endorsements''. Such a section
+may not be included in the Modified Version.
+
+@item
+Do not retitle any existing section to be Entitled ``Endorsements'' or
+to conflict in title with any Invariant Section.
+
+@item
+Preserve any Warranty Disclaimers.
+@end enumerate
+
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant. To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+
+You may add a section Entitled ``Endorsements'', provided it contains
+nothing but endorsements of your Modified Version by various
+parties---for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version. Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity. If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+
+@item
+COMBINING DOCUMENTS
+
+You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice, and that you preserve all their Warranty Disclaimers.
+
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy. If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections Entitled ``History''
+in the various original documents, forming one section Entitled
+``History''; likewise combine any sections Entitled ``Acknowledgements'',
+and any sections Entitled ``Dedications''. You must delete all
+sections Entitled ``Endorsements.''
+
+@item
+COLLECTIONS OF DOCUMENTS
+
+You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+
+@item
+AGGREGATION WITH INDEPENDENT WORKS
+
+A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, is called an ``aggregate'' if the copyright
+resulting from the compilation is not used to limit the legal rights
+of the compilation's users beyond what the individual works permit.
+When the Document is included in an aggregate, this License does not
+apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document's Cover Texts may be placed on
+covers that bracket the Document within the aggregate, or the
+electronic equivalent of covers if the Document is in electronic form.
+Otherwise they must appear on printed covers that bracket the whole
+aggregate.
+
+@item
+TRANSLATION
+
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections. You may include a
+translation of this License, and all the license notices in the
+Document, and any Warranty Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers. In case of a disagreement between
+the translation and the original version of this License or a notice
+or disclaimer, the original version will prevail.
+
+If a section in the Document is Entitled ``Acknowledgements'',
+``Dedications'', or ``History'', the requirement (section 4) to Preserve
+its Title (section 1) will typically require changing the actual
+title.
+
+@item
+TERMINATION
+
+You may not copy, modify, sublicense, or distribute the Document
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense, or distribute it is void, and
+will automatically terminate your rights under this License.
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, receipt of a copy of some or all of the same material does
+not give you any rights to use it.
+
+@item
+FUTURE REVISIONS OF THIS LICENSE
+
+The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns. See
+@uref{http://www.gnu.org/copyleft/}.
+
+Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License ``or any later version'' applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation. If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation. If the Document
+specifies that a proxy can decide which future versions of this
+License can be used, that proxy's public statement of acceptance of a
+version permanently authorizes you to choose that version for the
+Document.
+
+@item
+RELICENSING
+
+``Massive Multiauthor Collaboration Site'' (or ``MMC Site'') means any
+World Wide Web server that publishes copyrightable works and also
+provides prominent facilities for anybody to edit those works. A
+public wiki that anybody can edit is an example of such a server. A
+``Massive Multiauthor Collaboration'' (or ``MMC'') contained in the
+site means any set of copyrightable works thus published on the MMC
+site.
+
+``CC-BY-SA'' means the Creative Commons Attribution-Share Alike 3.0
+license published by Creative Commons Corporation, a not-for-profit
+corporation with a principal place of business in San Francisco,
+California, as well as future copyleft versions of that license
+published by that same organization.
+
+``Incorporate'' means to publish or republish a Document, in whole or
+in part, as part of another Document.
+
+An MMC is ``eligible for relicensing'' if it is licensed under this
+License, and if all works that were first published under this License
+somewhere other than this MMC, and subsequently incorporated in whole
+or in part into the MMC, (1) had no cover texts or invariant sections,
+and (2) were thus incorporated prior to November 1, 2008.
+
+The operator of an MMC Site may republish an MMC contained in the site
+under CC-BY-SA on the same site at any time before August 1, 2009,
+provided the MMC is eligible for relicensing.
+
+@end enumerate
+
+@page
+@heading ADDENDUM: How to use this License for your documents
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+
+@smallexample
+@group
+ Copyright (C) @var{year} @var{your name}.
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License, Version 1.3
+ or any later version published by the Free Software Foundation;
+ with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
+ Texts. A copy of the license is included in the section entitled ``GNU
+ Free Documentation License''.
+@end group
+@end smallexample
+
+If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+replace the ``with@dots{}Texts.'' line with this:
+
+@smallexample
+@group
+ with the Invariant Sections being @var{list their titles}, with
+ the Front-Cover Texts being @var{list}, and with the Back-Cover Texts
+ being @var{list}.
+@end group
+@end smallexample
+
+If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
+
+
+@c Local Variables:
+@c ispell-local-pdict: "ispell-dict"
+@c End:
+
--- /dev/null
+@c The GNU General Public License.
+@center Version 3, 29 June 2007
+
+@c This file is intended to be included within another document,
+@c hence no sectioning command or @node.
+
+@display
+Copyright @copyright{} 2007 Free Software Foundation, Inc. @url{http://fsf.org/}
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+@end display
+
+@heading Preamble
+
+The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom
+to share and change all versions of a program---to make sure it remains
+free software for all its users. We, the Free Software Foundation,
+use the GNU General Public License for most of our software; it
+applies also to any other work released this way by its authors. You
+can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you
+have certain responsibilities if you distribute copies of the
+software, or if you modify it: responsibilities to respect the freedom
+of others.
+
+For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too,
+receive or can get the source code. And you must show them these
+terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the
+manufacturer can do so. This is fundamentally incompatible with the
+aim of protecting users' freedom to change the software. The
+systematic pattern of such abuse occurs in the area of products for
+individuals to use, which is precisely where it is most unacceptable.
+Therefore, we have designed this version of the GPL to prohibit the
+practice for those products. If such problems arise substantially in
+other domains, we stand ready to extend this provision to those
+domains in future versions of the GPL, as needed to protect the
+freedom of users.
+
+Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish
+to avoid the special danger that patents applied to a free program
+could make it effectively proprietary. To prevent this, the GPL
+assures that patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and
+modification follow.
+
+@heading TERMS AND CONDITIONS
+
+@enumerate 0
+@item Definitions.
+
+``This License'' refers to version 3 of the GNU General Public License.
+
+``Copyright'' also means copyright-like laws that apply to other kinds
+of works, such as semiconductor masks.
+
+``The Program'' refers to any copyrightable work licensed under this
+License. Each licensee is addressed as ``you''. ``Licensees'' and
+``recipients'' may be individuals or organizations.
+
+To ``modify'' a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of
+an exact copy. The resulting work is called a ``modified version'' of
+the earlier work or a work ``based on'' the earlier work.
+
+A ``covered work'' means either the unmodified Program or a work based
+on the Program.
+
+To ``propagate'' a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+To ``convey'' a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user
+through a computer network, with no transfer of a copy, is not
+conveying.
+
+An interactive user interface displays ``Appropriate Legal Notices'' to
+the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+@item Source Code.
+
+The ``source code'' for a work means the preferred form of the work for
+making modifications to it. ``Object code'' means any non-source form
+of a work.
+
+A ``Standard Interface'' means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+The ``System Libraries'' of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+``Major Component'', in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+The ``Corresponding Source'' for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can
+regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same
+work.
+
+@item Basic Permissions.
+
+All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey,
+without conditions so long as your license otherwise remains in force.
+You may convey covered works to others for the sole purpose of having
+them make modifications exclusively for you, or provide you with
+facilities for running those works, provided that you comply with the
+terms of this License in conveying all material for which you do not
+control copyright. Those thus making or running the covered works for
+you must do so exclusively on your behalf, under your direction and
+control, on terms that prohibit them from making any copies of your
+copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the
+conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+@item Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such
+circumvention is effected by exercising rights under this License with
+respect to the covered work, and you disclaim any intention to limit
+operation or modification of the work as a means of enforcing, against
+the work's users, your or third parties' legal rights to forbid
+circumvention of technological measures.
+
+@item Conveying Verbatim Copies.
+
+You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+@item Conveying Modified Source Versions.
+
+You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these
+conditions:
+
+@enumerate a
+@item
+The work must carry prominent notices stating that you modified it,
+and giving a relevant date.
+
+@item
+The work must carry prominent notices stating that it is released
+under this License and any conditions added under section 7. This
+requirement modifies the requirement in section 4 to ``keep intact all
+notices''.
+
+@item
+You must license the entire work, as a whole, under this License to
+anyone who comes into possession of a copy. This License will
+therefore apply, along with any applicable section 7 additional terms,
+to the whole of the work, and all its parts, regardless of how they
+are packaged. This License gives no permission to license the work in
+any other way, but it does not invalidate such permission if you have
+separately received it.
+
+@item
+If the work has interactive user interfaces, each must display
+Appropriate Legal Notices; however, if the Program has interactive
+interfaces that do not display Appropriate Legal Notices, your work
+need not make them do so.
+@end enumerate
+
+A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+``aggregate'' if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+@item Conveying Non-Source Forms.
+
+You may convey a covered work in object code form under the terms of
+sections 4 and 5, provided that you also convey the machine-readable
+Corresponding Source under the terms of this License, in one of these
+ways:
+
+@enumerate a
+@item
+Convey the object code in, or embodied in, a physical product
+(including a physical distribution medium), accompanied by the
+Corresponding Source fixed on a durable physical medium customarily
+used for software interchange.
+
+@item
+Convey the object code in, or embodied in, a physical product
+(including a physical distribution medium), accompanied by a written
+offer, valid for at least three years and valid for as long as you
+offer spare parts or customer support for that product model, to give
+anyone who possesses the object code either (1) a copy of the
+Corresponding Source for all the software in the product that is
+covered by this License, on a durable physical medium customarily used
+for software interchange, for a price no more than your reasonable
+cost of physically performing this conveying of source, or (2) access
+to copy the Corresponding Source from a network server at no charge.
+
+@item
+Convey individual copies of the object code with a copy of the written
+offer to provide the Corresponding Source. This alternative is
+allowed only occasionally and noncommercially, and only if you
+received the object code with such an offer, in accord with subsection
+6b.
+
+@item
+Convey the object code by offering access from a designated place
+(gratis or for a charge), and offer equivalent access to the
+Corresponding Source in the same way through the same place at no
+further charge. You need not require recipients to copy the
+Corresponding Source along with the object code. If the place to copy
+the object code is a network server, the Corresponding Source may be
+on a different server (operated by you or a third party) that supports
+equivalent copying facilities, provided you maintain clear directions
+next to the object code saying where to find the Corresponding Source.
+Regardless of what server hosts the Corresponding Source, you remain
+obligated to ensure that it is available for as long as needed to
+satisfy these requirements.
+
+@item
+Convey the object code using peer-to-peer transmission, provided you
+inform other peers where the object code and Corresponding Source of
+the work are being offered to the general public at no charge under
+subsection 6d.
+
+@end enumerate
+
+A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+A ``User Product'' is either (1) a ``consumer product'', which means any
+tangible personal property which is normally used for personal,
+family, or household purposes, or (2) anything designed or sold for
+incorporation into a dwelling. In determining whether a product is a
+consumer product, doubtful cases shall be resolved in favor of
+coverage. For a particular product received by a particular user,
+``normally used'' refers to a typical or common use of that class of
+product, regardless of the status of the particular user or of the way
+in which the particular user actually uses, or expects or is expected
+to use, the product. A product is a consumer product regardless of
+whether the product has substantial commercial, industrial or
+non-consumer uses, unless such uses represent the only significant
+mode of use of the product.
+
+``Installation Information'' for a User Product means any methods,
+procedures, authorization keys, or other information required to
+install and execute modified versions of a covered work in that User
+Product from a modified version of its Corresponding Source. The
+information must suffice to ensure that the continued functioning of
+the modified object code is in no case prevented or interfered with
+solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or
+updates for a work that has been modified or installed by the
+recipient, or for the User Product in which it has been modified or
+installed. Access to a network may be denied when the modification
+itself materially and adversely affects the operation of the network
+or violates the rules and protocols for communication across the
+network.
+
+Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+@item Additional Terms.
+
+``Additional permissions'' are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders
+of that material) supplement the terms of this License with terms:
+
+@enumerate a
+@item
+Disclaiming warranty or limiting liability differently from the terms
+of sections 15 and 16 of this License; or
+
+@item
+Requiring preservation of specified reasonable legal notices or author
+attributions in that material or in the Appropriate Legal Notices
+displayed by works containing it; or
+
+@item
+Prohibiting misrepresentation of the origin of that material, or
+requiring that modified versions of such material be marked in
+reasonable ways as different from the original version; or
+
+@item
+Limiting the use for publicity purposes of names of licensors or
+authors of the material; or
+
+@item
+Declining to grant rights under trademark law for use of some trade
+names, trademarks, or service marks; or
+
+@item
+Requiring indemnification of licensors and authors of that material by
+anyone who conveys the material (or modified versions of it) with
+contractual assumptions of liability to the recipient, for any
+liability that these contractual assumptions directly impose on those
+licensors and authors.
+@end enumerate
+
+All other non-permissive additional terms are considered ``further
+restrictions'' within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions; the
+above requirements apply either way.
+
+@item Termination.
+
+You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+@item Acceptance Not Required for Having Copies.
+
+You are not required to accept this License in order to receive or run
+a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+@item Automatic Licensing of Downstream Recipients.
+
+Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+An ``entity transaction'' is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+@item Patents.
+
+A ``contributor'' is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's ``contributor version''.
+
+A contributor's ``essential patent claims'' are all patent claims owned
+or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, ``control'' includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+In the following three paragraphs, a ``patent license'' is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To ``grant'' such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. ``Knowingly relying'' means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+A patent license is ``discriminatory'' if it does not include within the
+scope of its coverage, prohibits the exercise of, or is conditioned on
+the non-exercise of one or more of the rights that are specifically
+granted under this License. You may not convey a covered work if you
+are a party to an arrangement with a third party that is in the
+business of distributing software, under which you make payment to the
+third party based on the extent of your activity of conveying the
+work, and under which the third party grants, to any of the parties
+who would receive the covered work from you, a discriminatory patent
+license (a) in connection with copies of the covered work conveyed by
+you (or copies made from those copies), or (b) primarily for and in
+connection with specific products or compilations that contain the
+covered work, unless you entered into that arrangement, or that patent
+license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+@item No Surrender of Others' Freedom.
+
+If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey
+a covered work so as to satisfy simultaneously your obligations under
+this License and any other pertinent obligations, then as a
+consequence you may not convey it at all. For example, if you agree
+to terms that obligate you to collect a royalty for further conveying
+from those to whom you convey the Program, the only way you could
+satisfy both those terms and this License would be to refrain entirely
+from conveying the Program.
+
+@item Use with the GNU Affero General Public License.
+
+Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+@item Revised Versions of this License.
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies that a certain numbered version of the GNU General Public
+License ``or any later version'' applies to it, you have the option of
+following the terms and conditions either of that numbered version or
+of any later version published by the Free Software Foundation. If
+the Program does not specify a version number of the GNU General
+Public License, you may choose any version ever published by the Free
+Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions
+of the GNU General Public License can be used, that proxy's public
+statement of acceptance of a version permanently authorizes you to
+choose that version for the Program.
+
+Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+@item Disclaimer of Warranty.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ``AS IS'' WITHOUT
+WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
+DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
+CORRECTION.
+
+@item Limitation of Liability.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR
+CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
+NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
+LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM
+TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
+PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+@item Interpretation of Sections 15 and 16.
+
+If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+@end enumerate
+
+@heading END OF TERMS AND CONDITIONS
+
+@heading How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these
+terms.
+
+To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the ``copyright'' line and a pointer to where the full notice is found.
+
+@smallexample
+@var{one line to give the program's name and a brief idea of what it does.}
+Copyright (C) @var{year} @var{name of author}
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or (at
+your option) any later version.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see @url{http://www.gnu.org/licenses/}.
+@end smallexample
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+@smallexample
+@var{program} Copyright (C) @var{year} @var{name of author}
+This program comes with ABSOLUTELY NO WARRANTY; for details type @samp{show w}.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type @samp{show c} for details.
+@end smallexample
+
+The hypothetical commands @samp{show w} and @samp{show c} should show
+the appropriate parts of the General Public License. Of course, your
+program's commands might be different; for a GUI interface, you would
+use an ``about box''.
+
+You should also get your employer (if you work as a programmer) or school,
+if any, to sign a ``copyright disclaimer'' for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+@url{http://www.gnu.org/licenses/}.
+
+The GNU General Public License does not permit incorporating your
+program into proprietary programs. If your program is a subroutine
+library, you may consider it more useful to permit linking proprietary
+applications with the library. If this is what you want to do, use
+the GNU Lesser General Public License instead of this License. But
+first, please read @url{http://www.gnu.org/philosophy/why-not-lgpl.html}.
--- /dev/null
+% bbdb.sty --- basic LaTeX style for TeXing BBDB
+%
+% Copyright (C) 2017 Free Software Foundation, Inc.
+%
+% This file is part of the Insidious Big Brother Database (aka BBDB),
+%
+% BBDB is free software: you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation, either version 3 of the License, or
+% (at your option) any later version.
+%
+% BBDB is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with BBDB. If not, see <http://www.gnu.org/licenses/>.
+
+%% Commentary:
+%
+% This file defines a basic LaTeX style for TeXing BBDB.
+
+\def\bbdb@name#1#2{\textbf{#2, #1}}
+\def\bbdb@organization#1{#1}
+\def\bbdb@affix#1{\emph{affix:} #1}
+\def\bbdb@aka#1{\emph{aka:} #1}
+\def\bbdb@phone#1#2{\emph{#1:} #2}
+\def\bbdb@mail#1#2{\ifx\href\undefined
+ \texttt{#2}%
+ \else
+ \href{mailto:#1}{\texttt{#2}}%
+ \fi}
+\def\bbdb@address#1#2{\emph{#1:} #2}
+\def\bbdb@xfield#1#2{\emph{#1:} #2}
+
+% \def\bbdb@separator#1{\hline}
+\def\bbdb@separator#1{\\\hline
+\multicolumn{\LT@cols}{@{}c@{}}{\hrulefill\ #1\rule{0pt}{2.2ex}\ \hrulefill}\\}
+
+\RequirePackage{longtable}
+\newenvironment{bbdb}[1]{%
+\let\name\bbdb@name
+\let\organization\bbdb@organization
+\let\affix\bbdb@affix
+\let\aka\bbdb@aka
+\let\phone\bbdb@phone
+\let\mail\bbdb@mail
+\let\address\bbdb@address
+\let\xfield\bbdb@xfield
+\let\bbdbseparator\bbdb@separator
+\begin{longtable}[l]{@{}#1@{}}}%
+{\\ \hline \multicolumn{\LT@cols}{c}{Printed \today}\\ \hline\end{longtable}}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\def\bbdbrecord@name#1#2{{\raggedright\textbf{#2, #1}\dotfill\par}}
+\def\bbdbrecord@organization#1{#1\par}
+\def\bbdbrecord@affix#1{\bbdbrecord@par{\emph{affix:} #1}}
+\def\bbdbrecord@aka#1{\bbdbrecord@par{\emph{aka:} #1}}
+\def\bbdbrecord@phone#1#2{\hspace*{\fill}\emph{#1:} #2\par}
+\def\bbdbrecord@mail#1#2{\ifx\href\undefined
+ \texttt{#2}%
+ \else
+ \href{mailto:#1}{\texttt{#2}}%
+ \fi\par}
+\def\bbdbrecord@par#1{{\leftskip 1em\parindent -\leftskip#1\par}}
+\def\bbdbrecord@address#1#2{\bbdbrecord@par{\emph{#1:} #2}}
+\def\bbdbrecord@xfield#1#2{\bbdbrecord@par{\emph{#1:} #2}}
+
+\newenvironment{bbdbrecord}{%
+\smallbreak
+\parskip 0pt
+\parindent 0pt
+\let\name\bbdbrecord@name
+\let\organization\bbdbrecord@organization
+\let\affix\bbdbrecord@affix
+\let\aka\bbdbrecord@aka
+\let\phone\bbdbrecord@phone
+\let\mail\bbdbrecord@mail
+\let\address\bbdbrecord@address
+\let\xfield\bbdbrecord@xfield}{\medbreak}
+
+\newcommand*{\bbdbseparator}[1]{\vspace{3ex}\noindent
+ \fbox{\parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep}%
+ {\centering\textbf{#1}}}%
+ \vspace{1ex}}
+
+% \endinput % Fails when inlining this file.
projects / ~bandali / configs / commitdiff