summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBarak A. Pearlmutter <barak+git@cs.nuim.ie>2011-03-12 15:02:34 +0000
committerBarak A. Pearlmutter <barak+git@cs.nuim.ie>2011-03-12 15:02:34 +0000
commit469a9635a0b19112698480d7b860911347825896 (patch)
tree21c7be762cb4f9685eebb92e39c94f963df16aec
parent2565e552dfd6ef525d58403f7ced94e6bd99e0cf (diff)
patch with debian diff bbdb_2.35.cvs20060204-1.diff.gz
(manually resolve keyword expansion conflicts)
-rw-r--r--bits/bbdb-ldif.el3
-rw-r--r--debian/Makepatch19
-rw-r--r--debian/README.debian47
-rw-r--r--debian/bbdb-areacode-split.pl.146
-rw-r--r--debian/bbdb-cid.pl.145
-rw-r--r--debian/bbdb-pilot-jwz.el584
-rw-r--r--debian/bbdb-srv.pl.160
-rw-r--r--debian/bbdb-unlazy-lock.pl.141
-rw-r--r--debian/changelog360
-rw-r--r--debian/compat1
-rw-r--r--debian/control15
-rw-r--r--debian/copyright32
-rw-r--r--debian/dirs2
-rw-r--r--debian/doc-base12
-rw-r--r--debian/docs1
-rw-r--r--debian/emacsen-install111
-rw-r--r--debian/emacsen-remove36
-rw-r--r--debian/emacsen-startup20
-rw-r--r--debian/postinst9
-rw-r--r--debian/prerm7
-rw-r--r--debian/rules121
-rw-r--r--lisp/Makefile.in45
-rw-r--r--texinfo/bbdb/bbdb.html263
-rw-r--r--texinfo/bbdb/bbdb_1.html5031
-rw-r--r--texinfo/bbdb/bbdb_2.html323
-rw-r--r--texinfo/bbdb/bbdb_3.html192
-rw-r--r--texinfo/bbdb/bbdb_abt.html166
-rw-r--r--texinfo/bbdb/bbdb_fot.html99
-rw-r--r--texinfo/bbdb/bbdb_toc.html178
29 files changed, 7850 insertions, 19 deletions
diff --git a/bits/bbdb-ldif.el b/bits/bbdb-ldif.el
index 4c2d63b..f07891c 100644
--- a/bits/bbdb-ldif.el
+++ b/bits/bbdb-ldif.el
@@ -1,6 +1,9 @@
;;; Copyright (C) 1998,2000 by Niels Elgaard Larsen <elgaard@diku.dk>
;;; $Log$
+;;; Revision 1.1 2006/02/04 15:35:15 joerg
+;;; Added
+;;;
;;; Revision 1.1 2005/02/13 14:16:03 waider
;;; * added new file, with minor abuse to make it work with current BBDB
;;;
diff --git a/debian/Makepatch b/debian/Makepatch
new file mode 100644
index 0000000..b33d669
--- /dev/null
+++ b/debian/Makepatch
@@ -0,0 +1,19 @@
+--- Makefile.orig Tue Apr 2 12:57:12 2002
++++ Makefile Tue Apr 2 13:10:16 2002
+@@ -16,15 +16,7 @@
+ aclocal.m4 configure configure.ac install-sh Makefile.in \
+ bits lisp misc tex texinfo utils
+
+-all: Makefile bbdb info gnus
+-
+-Makefile: configure Makefile.in
+- @echo "Makefile.in or configure has changed. Please rerun configure!"
+- exit 1
+-
+-configure: configure.ac
+- @echo "configure.ac has changed. Please rerun autoconf!"
+- exit 1
++all: bbdb info gnus
+
+ bbdb:
+ cd lisp; $(MAKE) bbdb
diff --git a/debian/README.debian b/debian/README.debian
new file mode 100644
index 0000000..df100c3
--- /dev/null
+++ b/debian/README.debian
@@ -0,0 +1,47 @@
+To enable bbdb support add a call to bbdb-initialize in your .emacs:
+
+bbdb-initialize is a compiled Lisp function in `bbdb'.
+(bbdb-initialize &rest TO-INSINUATE)
+
+*Initialize the BBDB. One or more of the following symbols can be
+passed as arguments to initiate the appropriate insinuations.
+
+ Initialization of mail/news readers:
+
+ Gnus Initialize BBDB support for the Gnus version 3.14 or
+ older.
+ gnus Initialize BBDB support for the Gnus mail/news reader
+ version 3.15 or newer. If you pass the `gnus' symbol,
+ you should probably also pass the `message' symbol.
+ mh-e Initialize BBDB support for the MH-E mail reader.
+ rmail Initialize BBDB support for the RMAIL mail reader.
+ sendmail Initialize BBDB support for sendmail (M-x mail).
+ vm Initialize BBDB support for the VM mail reader.
+ NOTE: For the VM insinuation to work properly, you must
+ either call `bbdb-initialize' with the `vm' symbol from
+ within your VM initialization file ("~/.vm") or you
+ must call `bbdb-insinuate-vm' manually from within your
+ VM initialization file.
+
+ Initialization of miscellaneous package:
+
+ message Initialize BBDB support for Message mode.
+ reportmail Initialize BBDB support for the Reportmail mail
+ notification package.
+ sc Initialize BBDB support for the Supercite message
+ citation package.
+ w3 Initialize BBDB support for Web browsers.
+
+---+++---
+
+In bits.tar.gz is the bits/ Subdir of the bbdb-Source packaged.
+The README there states this:
+
+This is the collection of bits and pieces located on the net or mailed to me
+by various folk that may or may not wind up in BBDB proper. They shouldn't
+be considered part of the bbdb as-is, nor should you complain to me about
+their failure to work.
+
+Look at it if you find something useful. If there is enough demand for some of the
+files i can install them with bbdb. Just ask me. :)
+
diff --git a/debian/bbdb-areacode-split.pl.1 b/debian/bbdb-areacode-split.pl.1
new file mode 100644
index 0000000..c41d326
--- /dev/null
+++ b/debian/bbdb-areacode-split.pl.1
@@ -0,0 +1,46 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH BBDB-AREACODE-SPLIT.PL 1 "March 31, 2002"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+bbdb-areacode-split.pl \- Looks for phone numbers in your .bbdb
+.SH SYNOPSIS
+.B bbdb-areacode-split.pl
+<old-code> <new-code> <exchanges-file> [bbdb]
+.SH DESCRIPTION
+Looks for phone numbers in your .bbdb with a particular area code
+and one of a set of exchanges and changes the area code. The old
+and new area codes are specified on the command line, as is the
+location of a file that contains the exchanges that are being
+changed. (The format of that file is very loose. Every three digit
+sequence will be used.)
+
+This manual page was written for the Debian distribution
+because the original program does not have a manual page.
+Instead, it has documentation in the GNU Info format; see below.
+.SH SEE ALSO
+.BR bbdb-cid.pl (1),
+.BR bbdb-unlazy-lock.pl (1).
+.BR bbdb-srv.pl (1).
+.br
+The bbdb is fully documented by
+.IR "The insidious Big Brother Database for mail and news" ,
+available via the Infonode
+.BR bbdb
+.
+.SH AUTHOR
+This manual page was written by Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/bbdb-cid.pl.1 b/debian/bbdb-cid.pl.1
new file mode 100644
index 0000000..261b77b
--- /dev/null
+++ b/debian/bbdb-cid.pl.1
@@ -0,0 +1,45 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH BBDB-CID.PL 1 "March 31, 2002"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+bbdb-cid.pl \- Caller-ID-logger
+.SH SYNOPSIS
+.B bbdb-cid.pl
+.SH DESCRIPTION
+Opens the modem and waits for it to print caller-ID data. When it does,
+it logs it to a file, parses it, and pops up a window using "xmessage".
+If the number is present in your .bbdb file, it shows the name (or company)
+associated with it.
+
+.IR "You have to edit the Skript and change it to fit into your System!"
+
+This manual page was written for the Debian distribution
+because the original program does not have a manual page.
+Instead, it has documentation in the GNU Info format; see below.
+.SH SEE ALSO
+.BR bbdb-areacode-split.pl (1),
+.BR bbdb-unlazy-lock.pl (1).
+.BR bbdb-srv.pl (1).
+.br
+The bbdb is fully documented by
+.IR "The insidious Big Brother Database for mail and news" ,
+available via the Infonode
+.BR bbdb
+.
+.SH AUTHOR
+This manual page was written by Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/bbdb-pilot-jwz.el b/debian/bbdb-pilot-jwz.el
new file mode 100644
index 0000000..07f6ff5
--- /dev/null
+++ b/debian/bbdb-pilot-jwz.el
@@ -0,0 +1,584 @@
+;;; bbdb-pilot-jwz.el --- bbdb to palmos address book conduit
+
+;; Copyright (C) 1999 Jamie Zawinski <jwz@jwz.org>, all rights reserved.
+
+;; Maintainer: Noah Friedman <friedman@splode.com>
+;; Created: 2000-01-21
+
+;; $Id: bbdb-pilot-jwz.el,v 1.8 2001/06/19 03:45:37 friedman Exp $
+
+;; 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 2, 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, you can either send email to this
+;; program's maintainer or write to: The Free Software Foundation,
+;; Inc.; 59 Temple Place, Suite 330; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+
+;; pilot-addresses expects a file with the following 19 fields:
+;;
+;; Last Name
+;; First Name
+;; Title
+;; Company
+;; Named Field 1 (default: Work)
+;; Named Field 2 (default: Home)
+;; Named Field 3 (default: Fax)
+;; Named Field 4 (default: Other)
+;; Named Field 5 (default: E-mail)
+;; Address
+;; City
+;; State
+;; Zip
+;; Country
+;; Custom 1
+;; Custom 2
+;; Custom 3
+;; Custom 4
+;; Note
+;;
+;; The "named fields" are the ones that have a field title that can be set
+;; with a popup menu. The available titles are:
+;;
+;; Work
+;; Home
+;; Fax
+;; Other
+;; E-mail
+;; Main
+;; Pager
+;; Mobile
+;;
+;; A record in the file consists of 19 fields followed by a newline.
+;; Field values are enclosed in double-quotes and are separated by commas.
+;; The "named" fields may also be preceeded by the field name and a
+;; semicolon, e.g.:
+;; "Home";"(415) 555-1212",
+;;
+;; Strings may contain newlines, and are read with backslash-decoding
+;; (for \n, \t and so on.)
+;;
+;; Embedded quotes are double-quoted in csv output, e.g. " -> ""
+
+;;; Code:
+
+(require 'bbdb)
+(require 'cl)
+
+(defconst bbdb-pilot-field-names
+ '["Work" "Home" "Fax" "Other" "E-mail" "Main" "Pager" "Mobile"])
+
+;; `title' is in this list since, if present, it is handled specially and
+;; we do not want to duplicate it in the notes section of each entry.
+;; But it's still a user-defined "notes" field as far as bbdb is concerned.
+(defconst bbdb-pilot-ignored-notes
+ '(mail-name mail-alias face mark-char title creation-date timestamp))
+
+
+(bbdb-defstruct bbdb-pilot-
+ lastname ; 1
+ firstname ; 2
+ title ; 3
+ company ; 4
+ name-1 value-1 ; 5
+ name-2 value-2 ; 6
+ name-3 value-3 ; 7
+ name-4 value-4 ; 8
+ name-5 value-5 ; 9
+ address ; 10
+ city ; 11
+ state ; 12
+ zip ; 13
+ country ; 14
+ custom-1 ; 15
+ custom-2 ; 16
+ custom-3 ; 17
+ custom-4 ; 18
+ note ; 19
+ )
+
+
+(defun bbdb-pilot-format (pilot)
+ "Inserts a `pilot-addresses'-compatible description of the `pilot' struct
+into the current buffer."
+ (let ((print-escape-newlines nil)
+ (print-escape-nonascii nil)
+ (standard-output (current-buffer)))
+ (save-restriction
+ (narrow-to-region (point) (point))
+ (prin1 (or (bbdb-pilot-lastname pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-firstname pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-title pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-company pilot) "")) (insert ",")
+
+ (prin1 (or (bbdb-pilot-name-1 pilot) "Other")) (insert ";")
+ (prin1 (or (bbdb-pilot-value-1 pilot) "")) (insert ",")
+
+ (prin1 (or (bbdb-pilot-name-2 pilot) "Other")) (insert ";")
+ (prin1 (or (bbdb-pilot-value-2 pilot) "")) (insert ",")
+
+ (prin1 (or (bbdb-pilot-name-3 pilot) "Other")) (insert ";")
+ (prin1 (or (bbdb-pilot-value-3 pilot) "")) (insert ",")
+
+ (prin1 (or (bbdb-pilot-name-4 pilot) "Other")) (insert ";")
+ (prin1 (or (bbdb-pilot-value-4 pilot) "")) (insert ",")
+
+ (prin1 (or (bbdb-pilot-name-5 pilot) "Other")) (insert ";")
+ (prin1 (or (bbdb-pilot-value-5 pilot) "")) (insert ",")
+
+ (prin1 (or (bbdb-pilot-address pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-city pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-state pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-zip pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-country pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-custom-1 pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-custom-2 pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-custom-3 pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-custom-4 pilot) "")) (insert ",")
+ (prin1 (or (bbdb-pilot-note pilot) "")) (insert "\n")
+
+ ;; Replace escaped double quotes (\") with "".
+ (goto-char (point-min))
+ (while (re-search-forward "\\\\\"" nil t)
+ (replace-match "\"\"" nil t))
+ (goto-char (point-max))))
+ nil)
+
+
+(defun bbdb-pilot-pretty-print (pilot)
+ ;; for debugging
+ (let ((i 0)
+ (names '["lastname" "firstname" "title" "company"
+ "name-1" "value-1" "name-2" "value-2" "name-3" "value-3"
+ "name-4" "value-4" "name-5" "value-5" "address" "city"
+ "state" "zip" "country" "custom-1" "custom-2" "custom-3"
+ "custom-4" "note"]))
+ (while (< i bbdb-pilot-length)
+ (insert (format "%12s: " (aref names i)))
+ (let ((s (aref pilot i))
+ (print-escape-newlines t))
+ (if (null s) (setq s ""))
+ (insert (format "%S\n" s)))
+ (setq i (1+ i))))
+ nil)
+
+
+(defun bbdb-record-to-pilot-record (record)
+ "Converts a BBDB record to a Pilot record."
+ (let ((pilot (make-vector bbdb-pilot-length nil))
+ (phones (bbdb-record-phones record))
+ (notes (bbdb-record-raw-notes record)))
+
+ (if (stringp notes)
+ (setq notes (list (cons 'notes notes)))
+ ;; may be destructively modified later
+ (setq notes (copy-alist notes)))
+
+ (if (bbdb-record-aka record)
+ (setq notes
+ (append notes
+ (list (cons 'AKA
+ (mapconcat 'identity
+ (bbdb-record-aka record)
+ ",\n"))))))
+
+ ;; These fields are easy...
+ ;;
+ (bbdb-pilot-set-lastname pilot (bbdb-record-lastname record))
+ (bbdb-pilot-set-firstname pilot (bbdb-record-firstname record))
+ (bbdb-pilot-set-title pilot (bbdb-record-getprop record 'title))
+ (bbdb-pilot-set-company pilot (bbdb-record-company record))
+
+ ;; Now do the phone numbers...
+ ;;
+ (let ((pilot-phones '()))
+ (while phones
+ (let ((loc (bbdb-phone-location (car phones)))
+ (num (bbdb-phone-string (car phones)))
+ field)
+ (cond ((string-match "\\b\\(work\\|office\\)" loc)
+ (setq field "Work"))
+ ((string-match "\\b\\(home\\)" loc)
+ (setq field "Home"))
+ ((string-match "\\b\\(fax\\|facs?imile\\)" loc)
+ (setq field "Fax"))
+ ((string-match "\\b\\(pager?\\|beeper\\)" loc)
+ (setq field "Pager"))
+ ((string-match "\\b\\(cell\\|mobile\\)" loc)
+ (setq field "Mobile"))
+ ((string-match "\\b\\(voice\\|main\\|phone\\)\\b" loc)
+ (setq field "Main"))
+ (t
+ ;; If we don't recognise the phone label, then call it
+ ;; "Other" but preserve the original label in the field
+ ;; itself.
+ (setq field "Other"
+ num (concat loc ": " num))))
+
+ ;; If this phone number is the same type as one previously seen
+ ;; (e.g. there are two pager numbers), append with a newline to
+ ;; the existing entry. This makes it possible to group multiple
+ ;; numbers in the same pilot field and make room for more numbers
+ ;; of different loc types.
+ (let ((seen (assoc field pilot-phones)))
+ (if seen
+ (setcdr seen (concat (cdr seen) "\n" num))
+ (setq pilot-phones (cons (cons field num) pilot-phones))))
+ (setq phones (cdr phones))))
+ (setq pilot-phones (nreverse pilot-phones))
+
+ ;; The email field goes last in the list of phone fields
+ (if (bbdb-record-net record)
+ (let ((c (cons "E-mail" (car (bbdb-record-net record)))))
+ (setq pilot-phones (nconc pilot-phones (list c)))))
+
+ (if (cdr (bbdb-record-net record))
+ (setq notes
+ (cons (cons 'other-email
+ (mapconcat 'identity
+ (cdr (bbdb-record-net record))
+ ",\n"))
+ notes)))
+
+ (let (pp)
+ (setq pp (pop pilot-phones))
+ (bbdb-pilot-set-name-1 pilot (car pp))
+ (bbdb-pilot-set-value-1 pilot (cdr pp))
+
+ (setq pp (pop pilot-phones))
+ (bbdb-pilot-set-name-2 pilot (car pp))
+ (bbdb-pilot-set-value-2 pilot (cdr pp))
+
+ (setq pp (pop pilot-phones))
+ (bbdb-pilot-set-name-3 pilot (car pp))
+ (bbdb-pilot-set-value-3 pilot (cdr pp))
+
+ ;; We've filled in three phone-number fields.
+ ;; If there are more than 2 phone numbers left (not counting the
+ ;; email field), put remaining numbers in 4th field (with their
+ ;; headings) and put the email address in the 5th field.
+ (cond ((< (length pilot-phones) 3)
+ (setq pp (pop pilot-phones))
+ (bbdb-pilot-set-name-4 pilot (car pp))
+ (bbdb-pilot-set-value-4 pilot (cdr pp))
+
+ (setq pp (pop pilot-phones))
+ (bbdb-pilot-set-name-5 pilot (car pp))
+ (bbdb-pilot-set-value-5 pilot (cdr pp)))
+ (t
+ (let* ((email (assoc "E-mail" pilot-phones))
+ (val
+ (mapconcat
+ #'(lambda (pp)
+ (let ((p 0) s)
+ ;; If there are newlines in the data, make sure
+ ;; each new line begins with the field name
+ ;; since this record is heterogenous.
+ (while (string-match "\n" (cdr pp) p)
+ (setq s (concat "\n" (car pp) ": "))
+ (setq p (+ (match-end 0) (length s)))
+ (setcdr pp (replace-match s t t (cdr pp)))))
+ (concat (car pp) ": " (cdr pp)))
+ (delq email pilot-phones) "\n")))
+ (bbdb-pilot-set-name-4 pilot "Other")
+ (bbdb-pilot-set-value-4 pilot val)
+
+ (bbdb-pilot-set-name-5 pilot (car email))
+ (bbdb-pilot-set-value-5 pilot (cdr email)))))))
+
+ ;; Now do the addresses...
+ ;; Put the first address in the address field, and the others
+ ;; in the "custom" fields.
+ ;;
+ (let* ((addrs (bbdb-record-addresses record))
+ (addr1 (pop addrs)))
+ (cond
+ (addr1
+ (let (st)
+ (cond ((>= bbdb-file-format 6)
+ (setq st (bbdb-join (bbdb-address-streets addr1) "\n")))
+ (t
+ (setq st (bbdb-address-street1 addr1))
+ (if (> (length (bbdb-address-street2 addr1)) 0)
+ (setq st (concat st "\n" (bbdb-address-street2 addr1))))
+ (if (> (length (bbdb-address-street3 addr1)) 0)
+ (setq st (concat st "\n" (bbdb-address-street3 addr1))))))
+
+ (setq st (concat (bbdb-address-location addr1) ":\n" st))
+
+ (bbdb-pilot-set-address pilot st)
+ (bbdb-pilot-set-city pilot (bbdb-address-city addr1))
+ (bbdb-pilot-set-state pilot (bbdb-address-state addr1))
+ (bbdb-pilot-set-zip pilot (bbdb-address-zip-string addr1))
+ (bbdb-pilot-set-country pilot nil))))
+
+ (cond
+ (addrs
+ (let ((indent-tabs-mode nil)
+ (formatted '())
+ addr c s)
+ (while addrs
+ (setq addr (car addrs))
+ (save-excursion
+ (set-buffer (get-buffer-create "*bbdb-tmp*"))
+ (erase-buffer)
+ (insert (bbdb-address-location addr) ":\n")
+ (cond
+ ((>= bbdb-file-format 6)
+ (let ((sts (bbdb-address-streets addr)))
+ (while sts
+ (indent-to 8)
+ (insert (car sts) "\n")
+ (setq sts (cdr sts)))))
+ (t
+ (if (= 0 (length (setq s (bbdb-address-street1 addr)))) nil
+ (indent-to 8) (insert s "\n"))
+ (if (= 0 (length (setq s (bbdb-address-street2 addr)))) nil
+ (indent-to 8) (insert s "\n"))
+ (if (= 0 (length (setq s (bbdb-address-street3 addr)))) nil
+ (indent-to 8) (insert s "\n"))))
+ (indent-to 8)
+ (insert (setq c (bbdb-address-city addr)))
+ (setq s (bbdb-address-state addr))
+ (if (and (> (length c) 0) (> (length s) 0)) (insert ", "))
+ (insert s " ")
+ (insert (bbdb-address-zip-string addr))
+
+ (setq formatted (cons (buffer-string) formatted))
+ (setq addrs (cdr addrs))))
+ (setq formatted (nreverse formatted))
+
+ (bbdb-pilot-set-custom-1 pilot (pop formatted))
+ (bbdb-pilot-set-custom-2 pilot (pop formatted))
+ (bbdb-pilot-set-custom-3 pilot (pop formatted))
+ (if (null (cdr formatted))
+ (bbdb-pilot-set-custom-4 pilot (pop formatted))
+ (bbdb-pilot-set-custom-4 pilot
+ (mapconcat 'identity formatted "\n"))))))
+ )
+
+ ;; Now handle the notes...
+ ;;
+ (let ((losers bbdb-pilot-ignored-notes))
+ (while losers
+ (let ((c (assq (car losers) notes)))
+ (if c (setq notes (delete c notes))))
+ (setq losers (cdr losers))))
+
+ (bbdb-pilot-set-note pilot
+ (mapconcat
+ #'(lambda (cons)
+ (save-excursion
+ (set-buffer (get-buffer-create "*bbdb-tmp*"))
+ (erase-buffer)
+ (insert (format "%s:\n%s" (car cons) (cdr cons)))
+ (goto-char (point-min))
+ (while (search-forward "\n" nil t)
+ (replace-match "\n " t t))
+ (goto-char (point-max))
+ (skip-chars-backward "\n\t ")
+ (buffer-substring (point-min) (point))))
+ notes
+ "\n\n"))
+
+ pilot))
+
+
+(defun bbdb-pilot-make-phone (location phone-string)
+ (let* ((num (make-vector
+ (if bbdb-north-american-phone-numbers-p
+ bbdb-phone-length
+ 2)
+ nil))
+ (p (bbdb-parse-phone-number phone-string)))
+ (bbdb-phone-set-location num location)
+ (bbdb-phone-set-area num (nth 0 p)) ; euronumbers too.
+ (if (= (length num) 2)
+ nil
+ (bbdb-phone-set-exchange num (nth 1 p))
+ (bbdb-phone-set-suffix num (nth 2 p))
+ (bbdb-phone-set-extension num (or (nth 3 p) 0)))
+ num))
+
+
+(defun pilot-record-to-bbdb-record (pilot)
+ "Converts a Pilot record to a BBDB record."
+ (let ((firstname (bbdb-pilot-firstname pilot))
+ (lastname (bbdb-pilot-lastname pilot))
+ (company (bbdb-pilot-company pilot))
+ (title (bbdb-pilot-title pilot)) ; ####
+ ;; #### AKA
+ (net nil)
+ (addrs '())
+ (phones '())
+ (pphones '())
+ (notes '())
+ )
+ (if (equal company "") (setq company nil))
+ (if (equal title "") (setq title nil))
+ (if (equal notes "") (setq notes nil))
+
+ ;; Process the phone numbers and primary net address...
+ ;;
+ (setq pphones (list (cons (bbdb-pilot-name-1 pilot)
+ (bbdb-pilot-value-1 pilot))
+ (cons (bbdb-pilot-name-2 pilot)
+ (bbdb-pilot-value-2 pilot))
+ (cons (bbdb-pilot-name-3 pilot)
+ (bbdb-pilot-value-3 pilot))
+ (cons (bbdb-pilot-name-4 pilot)
+ (bbdb-pilot-value-4 pilot))
+ (cons (bbdb-pilot-name-5 pilot)
+ (bbdb-pilot-value-5 pilot))))
+ (while pphones
+ (cond ((equal (car (car pphones)) "E-mail")
+ (setq net (list (cdr (car pphones)))))
+ ((and (equal (car (car pphones)) "Other")
+ (string-match "^\\([^ \t\n:]+\\):[ \t]*"
+ (cdr (car pphones))))
+ (let ((a (substring (cdr (car pphones))
+ (match-beginning 1) (match-end 1)))
+ (b (substring (cdr (car pphones)) (match-end 0))))
+ (setq phones (cons (bbdb-pilot-make-phone a b)
+ phones))))
+ ((> (length (cdr (car pphones))) 0)
+ (setq phones (cons (bbdb-pilot-make-phone (car (car pphones))
+ (cdr (car pphones)))
+ phones))))
+ (setq pphones (cdr pphones)))
+ (setq phones (nreverse phones))
+
+ ;; Now parse the primary address...
+ ;;
+ (cond ((> (length (bbdb-pilot-address pilot)) 0)
+ (let ((addr (make-vector bbdb-address-length nil))
+ loc sts st1 st2 st3
+ (street (bbdb-pilot-address pilot))
+ (cty (bbdb-pilot-city pilot))
+ (ste (bbdb-pilot-state pilot))
+ (zip (bbdb-pilot-zip pilot))
+ )
+ (if (equal cty "") (setq cty nil))
+ (if (equal ste "") (setq ste nil))
+ (if (equal zip "") (setq zip nil))
+ (if zip (setq zip (bbdb-parse-zip-string zip)))
+
+ (if (string-match "^\\([^ \t\n:]+\\):[ \t\n]*" street)
+ (setq loc (substring street 0 (match-end 1))
+ street (substring street (match-end 0))))
+
+ (bbdb-address-set-location addr loc)
+
+ (cond
+ ((>= bbdb-file-format 6)
+ (while (string-match "^\\([^\n]+\\)\\(\n\\|$\\)" street)
+ (setq sts (append
+ sts
+ (list (substring street 0 (match-end 1))))
+ street (substring street (match-end 0))))
+ (bbdb-address-set-streets addr sts))
+ (t
+ (if (string-match "^\\([^\n]+\\)\\(\n\\|$\\)" street)
+ (setq st1 (substring street 0 (match-end 1))
+ street (substring street (match-end 0))))
+ (if (string-match "^\\([^\n]+\\)\\(\n\\|$\\)" street)
+ (setq st2 (substring street 0 (match-end 1))
+ street (substring street (match-end 0))))
+ (if (string-match "^\\([^\n]+\\)\\(\n\\|$\\)" street)
+ (setq st3 (substring street 0 (match-end 1))
+ street (substring street (match-end 0))))
+ (bbdb-address-set-street1 addr (or st1 ""))
+ (bbdb-address-set-street2 addr (or st2 ""))
+ (bbdb-address-set-street3 addr (or st3 ""))))
+
+ (bbdb-address-set-city addr (or cty ""))
+ (bbdb-address-set-state addr (or ste ""))
+ (bbdb-address-set-zip addr zip)
+ (setq addrs (list addr))
+ )))
+
+ ;; Now parse the secondary addresses...
+ ;;
+ (let ((paddrs (list (bbdb-pilot-custom-1 pilot)
+ (bbdb-pilot-custom-2 pilot)
+ (bbdb-pilot-custom-3 pilot)
+ (bbdb-pilot-custom-4 pilot))))
+ (while paddrs
+ (cond
+ ((car paddrs)
+ ;; #### parse text to address. fmh.
+ ))
+ (setq paddrs (cdr paddrs))))
+
+ ;; Now parse the notes field.
+ ;;
+ ;; ####
+
+ (let ((record
+ (vector firstname lastname nil company phones addrs net notes
+ (make-vector bbdb-cache-length nil))))
+ record)))
+
+
+;;;###autoload
+(defun bbdb-to-pilot-file (filename &optional records)
+ (interactive "FWrite pilot-addresses file: ")
+ (or records (setq records (bbdb-records)))
+ (save-excursion
+ (set-buffer (find-file-noselect filename))
+ (erase-buffer)
+ (let ((len (length records))
+ (i 0))
+ (while records
+ (message "%d%%..." (/ (* 100 i) len))
+ (bbdb-pilot-format (bbdb-record-to-pilot-record (car records)))
+ (setq records (cdr records)
+ i (1+ i))))
+ (save-buffer)
+ (kill-buffer (current-buffer)))
+ filename)
+
+
+(defun bbdb-to-pilot ()
+ "Push the current contents of BBDB out to the Pilot."
+; (interactive)
+ (bbdb-records) ; load bbdb
+ (message "Selecting records...")
+ (let ((records
+ (remove-if-not
+ #'(lambda (record)
+ (and (or (bbdb-record-name record)
+ (bbdb-record-company record))
+ (let ((phones-p nil)
+ (phones (bbdb-record-phones record)))
+ (while phones
+ (let ((loc (bbdb-phone-location (car phones))))
+ (if (and (not (string-match "cid" loc))
+ (not (string-match "[?]" loc)))
+ (setq phones-p t)))
+ (setq phones (cdr phones)))
+ phones-p)))
+ (bbdb-records)))
+
+ (file (format "/tmp/pilot-bbdb-%s-%d-%s"
+ (user-login-name) (emacs-pid) (float-time))))
+
+ (bbdb-to-pilot-file file records)
+ (shell-command (concat "pilot-addresses -p /dev/pilot "
+ "-d BBDB -c BBDB -r " file
+ ;;"; rm " file
+ " &"))
+ ))
+
+(provide 'bbdb-pilot-jwz)
+
+;;; bbdb-pilot-jwz.el ends here
diff --git a/debian/bbdb-srv.pl.1 b/debian/bbdb-srv.pl.1
new file mode 100644
index 0000000..86f83da
--- /dev/null
+++ b/debian/bbdb-srv.pl.1
@@ -0,0 +1,60 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH BBDB-SRV.PL 1 "March 31, 2002"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+bbdb-srv.pl \- Converts Mail-Headers to an Emacs-Lisp String.
+.SH SYNOPSIS
+.B echo "Some Headers" | bbdb-srv.pl
+.SH DESCRIPTION
+This script reads a block of message headers on stdin, and converts them
+to an emacs-lisp string (quoting all dangerous characters) and then
+uses the `gnudoit' program to cause a running Emacs process to invoke
+the `bbdb-srv' function with that string.
+
+This has the effect of causing the running Emacs to display the BBDB
+record corresponding to these headers.
+
+See the Emacs side of things in bbdb-srv.el for more info.
+
+A trivial application of this is the shell command:
+
+ echo 'From: Jamie Zawinski <jwz@netscape.com>' | bbdb-srv.perl
+
+which will cause the corresponding record to be displayed.
+A more interesting application of this is:
+
+ setenv NS_MSG_DISPLAY_HOOK bbdb-srv.perl
+
+which will hook BBDB up to Mozilla (Unix Netscape Mail and Netscape News
+versions 3.0b2 and later only.)
+
+This manual page was written for the Debian distribution
+because the original program does not have a manual page.
+Instead, it has documentation in the GNU Info format; see below.
+.SH SEE ALSO
+.BR bbdb-areacode-split.pl (1),
+.BR bbdb-unlazy-lock.pl (1).
+.BR bbdb-srv.pl (1).
+.br
+The bbdb is fully documented by
+.IR "The insidious Big Brother Database for mail and news" ,
+available via the Infonode
+.BR bbdb
+.
+.SH AUTHOR
+This manual page was written by Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/bbdb-unlazy-lock.pl.1 b/debian/bbdb-unlazy-lock.pl.1
new file mode 100644
index 0000000..4a8a6cb
--- /dev/null
+++ b/debian/bbdb-unlazy-lock.pl.1
@@ -0,0 +1,41 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH BBDB-UNLAZY-LOCK.PL 1 "March 31, 2002"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+bbdb--unlazy-lock.pl \- Removes crap from lazy-lock from your .bbdb
+.SH SYNOPSIS
+.B bbdb-unlazy-lock.pl
+.SH DESCRIPTION
+Lazy-lock-mode has (had) a nasty habit of munging .bbdb files if you
+visited them with it on. This script removes the lazy-lock mung
+
+This manual page was written for the Debian distribution
+because the original program does not have a manual page.
+Instead, it has documentation in the GNU Info format; see below.
+.SH SEE ALSO
+.BR bbdb-areacode-split.pl (1),
+.BR bbdb-unlazy-lock.pl (1).
+.BR bbdb-srv.pl (1).
+.br
+The bbdb is fully documented by
+.IR "The insidious Big Brother Database for mail and news" ,
+available via the Infonode
+.BR bbdb
+.
+.SH AUTHOR
+This manual page was written by Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..82834bf
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,360 @@
+bbdb (2.35.cvs20060204-1) unstable; urgency=low
+
+ * New CVS co
+ - Bug fix: "bbdb-news-auto-create-p with 'prompt doesn't work" (Closes: #296577).
+ * Bug fix: "bbdb: File error: "Cannot open load file",
+ 'bbdb-autoloads'" (Closes: #344032, #345186, #345297, #350449, #308336, #279920).
+ * Bug fix: "bbdb does not work with gnus-5.10", (works for me [TM]) (Closes: #192904).
+
+ -- Joerg Jaspert <joerg@debian.org> Sat, 4 Feb 2006 16:32:31 +0100
+
+bbdb (2.35.cvs20040528-1) unstable; urgency=low
+
+ * CVS co - last changes there are from 28.05.2004
+ * Bug fix: "fails to load : missing bbdb-vm.el". (Closes: #179821, #180024, #210248, #233904).
+ * Removed | emacs20 from Depends. (Closes: #232731)
+ * Removed old w3-el-e{20|19} Suggests.
+ * Bug fix: "bbdb: Include /usr/share/emacs/site-lisp/bbdb/tex/", thanks
+ to Mario Lang (Closes: #243211).
+
+ -- Joerg Jaspert <joerg@debian.org> Wed, 11 Aug 2004 23:12:05 +0200
+
+bbdb (2.35.cvs20030801-1) unstable; urgency=low
+
+ * CVS from 01 August 2003.
+
+ -- Joerg Jaspert <joerg@debian.org> Sun, 24 Aug 2003 14:51:51 +0200
+
+bbdb (2.34.cvs20030503-1) unstable; urgency=low
+
+ * CVS from 03 Mai 2003.
+ * Removed a suggestion about charsets in .bbdb. It should work without
+ that (closes: #177625)
+
+ -- Joerg Jaspert <joerg@debian.org> Sat, 3 May 2003 20:16:15 +0200
+
+bbdb (2.34.cvs20030102-1) unstable; urgency=low
+
+ * CVS checkout from 02 Januar 2003.
+ * A note in README.Debian about charsets and .bbdb.
+ (closes: #174006,173817)
+ * This patch for encoding issues is included upstream (closes: #159339)
+ * Standards 3.5.8
+
+ -- Joerg Jaspert <joerg@debian.org> Sun, 5 Jan 2003 15:38:42 +0100
+
+bbdb (2.34.cvs20021102-1) unstable; urgency=low
+
+ * Newest CVS Checkout. Well, new....
+
+ -- Joerg Jaspert <joerg@debian.org> Wed, 13 Nov 2002 21:02:25 +0100
+
+bbdb (2.34.cvs20021027-1) unstable; urgency=low
+
+ * Newest CVS checkout. This is really 2.35 :)
+ * Standards-Version: 3.5.7
+ * Removed mk-binary from debian/ dir, it is not used.
+
+ -- Joerg Jaspert <joerg@debian.org> Sun, 27 Oct 2002 16:09:56 +0100
+
+bbdb (2.34.cvs20020819-1) unstable; urgency=low
+
+ * Newest CVS checkout.
+
+ -- Joerg Jaspert <joerg@debian.org> Tue, 20 Aug 2002 22:20:26 +0200
+
+bbdb (2.34.cvs20020703-1) unstable; urgency=low
+
+ * Newest cvs checkout.
+ * (require 'bbdb-autloads) in startup file (closes: #152435)
+
+ -- Joerg Jaspert <joerg@debian.org> Wed, 10 Jul 2002 12:03:34 +0200
+
+bbdb (2.34.cvs20020418-3) unstable; urgency=low
+
+ * Added bbdb-pilot-jwz.el as suggested in (closes: #144465)
+ I dont have a handheld, so i cant test it. (Hint :) )
+
+ -- Joerg Jaspert <joerg@debian.org> Fri, 26 Apr 2002 00:13:03 +0200
+
+bbdb (2.34.cvs20020418-2) unstable; urgency=high
+
+ * Urgency=high because the Bugfix for #143463 should really go into
+ woody. I have not made any other changes in the emacsen-install files,
+ and there are no Bug Reports since my last Upload, so i think this is OK.
+ * I now generate some html Pages from the texinfo Source and install the
+ doc-base things. So you can read the bbdb documentation from your
+ Webbrowser if you want that.
+
+ -- Joerg Jaspert <joerg@debian.org> Sun, 21 Apr 2002 20:02:31 +0200
+
+bbdb (2.34.cvs20020418-1) unstable; urgency=low
+
+ * New Upstream release. This fixes bbdb-gui which (closes: #143463)
+ * Changed my Email Address.
+
+ -- Joerg Jaspert <joerg@debian.org> Thu, 18 Apr 2002 20:53:56 +0200
+
+bbdb (2.34.cvs20020404-2) unstable; urgency=low
+
+ * Changed emacsen-install:
+ Hide make autoloads output for the user and redirect it to the Compile-Log
+ Tell the User that the Byte-Compile of bbdb could be a long-running process.
+
+ -- Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net> Mon, 8 Apr 2002 15:42:46 +0200
+
+bbdb (2.34.cvs20020404-1) unstable; urgency=low
+
+ * If a Variable in Makefile changes between two releases it is very
+ helpful to change it in the calling installscript too. Thx to
+ James LewisMoss for this. This (closes: #141207)
+ * New CVS checkout. bbdb-merge.el changed.
+ * I now package the bits/ subdir with bbdb. It is *not* official part
+ of bbdb. So i only make a .tar.gz of it and place it into
+ /usr/share/doc/bbdb. Have a look at it and see if you find some
+ things useful. If there is enough demand for one thing i can install it with
+ bbdb (if License is clear).
+
+ -- Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net> Thu, 4 Apr 2002 23:48:32 +0200
+
+bbdb (2.34.cvs20020330-4) unstable; urgency=low
+
+ * Im so stupid blind. bbdb needs bbdb-autoloads.el. I must generate it before i compile
+ the package at install-time. If not we have a not existing bbdb-autoloads.el so bbdb
+ cant load anything and crashes. Argh, i hate me. I shold read INSTALL full. Next time...
+ I now generate bbdb-autoloads.el and bbdb works again. Sorry for this stupidity.
+ It (closes: #140968)
+
+ -- Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net> Wed, 3 Apr 2002 19:45:36 +0200
+
+bbdb (2.34.cvs20020330-3) unstable; urgency=low
+
+ * Hmm, i should look if I really remove all installed files between my tests. I left some
+ crap and all worked fine. So i cant see that Makefile.in is neccessary.
+ Added it again.
+ * Apply a patch to the Makefile in /usr/share/emacs/site-lisp which really should remove
+ checking for configure.ac. This two should (closes: #140868)
+
+ -- Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net> Tue, 2 Apr 2002 12:38:53 +0200
+
+bbdb (2.34.cvs20020330-2) unstable; urgency=low
+
+ * It now works to look at the bbdb info files with emacs, so this
+ should (closes: #111769)
+ * It should also (closes: #139287)
+ * Argh. If i want to install the info files without dh_installinfo i
+ have to copy them to the Packagedir.
+ * Suggest tetex-base.
+ * Install the .tex files for bbdb-print in /usr/share/texmf/tex/bbdb so
+ one can use bbdb-print without any extra work required. This two
+ changes are for this: (closes: #101282)
+ * -1 was not uploaded. So i just close the bug here again.
+ New Maintainer. (closes: #140041)
+ * gzip -9 for Readme.Debain
+ * Remove unneccessary Makefile.in from bbdb/lisp dir.
+
+ -- Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net> Mon, 1 Apr 2002 13:44:19 +0200
+
+bbdb (2.34.cvs20020330-1) unstable; urgency=low
+
+ * New Maintainer. (closes: #140041)
+ * My first Emacs-addon Package. Hope it works.
+ * New Version. Used CVS from 30 March 2002
+ * Added w3-el-e21 to Suggests.
+ * Changed URL in debian/copyright to point to right Site.
+ * Changed Path for License to /usr/share/common-license
+ * Disabled dh_installinfo in debian/rules. We do it manually so we dont need
+ to double it.
+ * Dont install Upstream README. Its just four words: Read the INSTALL file. We
+ dont need this for a Debian Package. :)
+ * Remove Files generated by configure or build-process which are not removed by
+ Upstream Makefiles clean target.
+ * Changed Depends to emacs21 | emacsen to make Lintian happy.
+ * Wrote manpages for the 4 Perlskripts. Better than a link to dh_undocumented.
+ * Use sed to change the Target all in the Makefiles so emacs-install could work.
+ We dont want to check for configure there so we dont check for it. :)
+
+ -- Joerg Jaspert (JJ) <joerg@goliathbbs.dnsalias.net> Sun, 31 Mar 2002 20:15:42 +0200
+
+bbdb (2.32-2) unstable; urgency=low
+
+ * don't install FLAVOR/etc/bbdb (closes: #123612)
+ tex be isntalled into document directory
+ utils/*.el be installed into site-lisp/bbdb with byte-compile
+ utils/*.pl be installed into /usr/bin/
+ * install /etc/emacs/site-start.d/50bbdb.el as conffile
+ * Build-Depends: debhelper (>> 3.0.0)
+ * Standards-Version: 3.5.2
+ * DH_COMPAT=3
+
+ -- Takuo KITAME <kitame@northeye.org> Thu, 13 Dec 2001 00:45:23 +0900
+
+bbdb (2.32-1) unstable; urgency=low
+
+ * New upstream release
+ * fixed bashizm of emacsen-install (closes: Bug#98574)
+ * remove (require 'message) from init.el (closes: Bug#109062)
+
+ -- Takuo KITAME <kitame@northeye.org> Sat, 25 Aug 2001 11:23:09 +0900
+
+bbdb (2.3-2) unstable; urgency=low
+
+ * debian/emacsen-install: insert (provide 'bbdb-autoloads) if not xemacs20 or xemacs21. (closes: Bug#88471)
+
+ -- Takuo KITAME <kitame@northeye.org> Mon, 5 Mar 2001 00:24:20 +0900
+
+bbdb (2.3-1) unstable; urgency=low
+
+ * New upstream release
+ * some upstream bug ware fixed (closes: Bug#86816,Bug#83920,Bug#83601)
+ * fix #85283: bbdb doesn't load bbdb-autoload (closes: Bug#85283)
+ * fix #82338: bbdb: upgrade leaves files behind (closes: Bug#82338)
+ * fix #85019: bbdb complains about nonexistent directory (closes: Bug#85019)
+ * fix #78721: calls switch-to-buffer(-1) on exit, xemacs doesn't like this (closes: Bug#78721)
+
+ -- Takuo KITAME <kitame@northeye.org> Sun, 4 Mar 2001 02:51:34 +0900
+
+bbdb (2.2-1) unstable; urgency=low
+
+ * New upstream release
+ * cloese: #82338: bbdb: upgrade leaves files behind
+ * closes: #81653: bbdb-complete-name fails,
+ * closes: #78564: bbdb breaks gnus
+ * closes: #80838: bbdb: perl scripts broken
+
+ -- Takuo KITAME <kitame@northeye.org> Fri, 26 Jan 2001 11:57:09 +0900
+
+bbdb (2.00.06.20001116cvs-1) unstable; urgency=low
+
+ * New upstream release
+
+ -- Takuo KITAME <kitame@northeye.org> Wed, 29 Nov 2000 08:22:33 +0900
+
+bbdb (2.00.06.20001015cvs-3) unstable; urgency=low
+
+ * Support xemacs21 (clsoes: Bug#76254)
+
+ -- Takuo KITAME <kitame@northeye.org> Mon, 13 Nov 2000 10:21:54 +0900
+
+bbdb (2.00.06.20001015cvs-2) unstable; urgency=low
+
+ * install info
+ * debian/bbdb-init.el:
+ (require 'bbdb)
+ (bbdb-initialize)
+ * lisp/bbdb.el: at defun bbdb-insinuate-message,
+ (if (not (boundp 'message-mode-map))
+ (require 'message))
+ (closes: Bug#74998)
+
+ -- Takuo KITAME <kitame@northeye.org> Wed, 18 Oct 2000 11:04:30 +0900
+
+bbdb (2.00.06.20001015cvs-1) unstable; urgency=low
+
+ * New upstream release (CVS snapshot)
+ * closes: Bug#72315 bbdb 2.00 is known not to work with Emacs 20.
+ * debian/control: Suggests: w3-el-e20|w3-el-e19 instead of w3-el.
+ (closes: Bug#74194)
+ * put perl script. (closes: Bug#72481)
+ * from lisp/bbdb-hooks.el,
+ ;; Revision 1.58 2000/04/05 17:09:06 bbdb-writer
+ ;; * Autoload cookie for bbdb-header-start
+ It seems Bug#69182 was fixed. (closes: Bug#69182)
+ * (setq bbdb-electric-p t) is worked. I think it was fixed by Upstream.
+ (closes: Bug#52453)
+ * applied view-mode -1 patch. (closes: Bug#48805)
+
+ -- Takuo KITAME <kitame@northeye.org> Tue, 17 Oct 2000 16:06:12 +0900
+
+bbdb (2.00.06-1) unstable; urgency=low
+
+ * New upstream release (closes: Bug#48316, Bug#19262)
+ * Work well on XEmacs (closes: Bug#12086)
+ * removing usr/share/xemacs20/etc/bbdb when package remove.
+ It was fixed in previous release. (closes: Bug#52527)
+ * install.log will be created as mode 644. (closes: Bug#55433)
+
+ -- Takuo KITAME <kitame@northeye.org> Wed, 29 Mar 2000 03:09:33 +0900
+
+bbdb (2.00-6) frozen unstable; urgency=high
+
+ * Maintainer was changed.
+ * Fixed install script for bbdb-gnus.el (closes: Bug#59177)
+
+ -- Takuo KITAME <kitame@northeye.org> Tue, 28 Mar 2000 13:30:34 +0900
+
+bbdb (2.00-5) unstable frozen; urgency=high
+
+ * ignore xemacs21 in the install stage. Closes: Bug#55432.
+
+ -- Frederic Lepied <Lepied@debian.org> Thu, 24 Feb 2000 09:36:47 +0100
+
+bbdb (2.00-4) unstable; urgency=low
+
+ * applied documentation fixes from <jrv@vanzandt.mv.com>. Closes: Bug#36225.
+ * (bbdb-print.el): corrected invalid condition-case. Closes: Bug#36846, Bug#44355, Bug#44364.
+ * removed itimer Suggests:.
+ * really install README.debian. Closes: Bug#26687.
+ * (bbdb-print.el): hard code the location of TeX files. CLoses: Bug#36844.
+ * (bbdb-print.tex): applied patch from Mattia Monga to correct the
+ size of tt fonts. Closes: Bug#41268.
+ * avoid aborting the install when a file failed to compile. Closes: Bug#37373, Bug#40379.
+
+ -- Frederic Lepied <Lepied@debian.org> Tue, 14 Sep 1999 21:57:24 +0200
+
+bbdb (2.00-3) frozen unstable; urgency=low
+
+ * (install): added vm target for xemacs19 and xemacs20. Fixes Bug#21940.
+ * (install): corrected echo placement. Fixes Bug#21496.
+ * (install): suppressed duplicate. Fixes Bug#21497.
+ * (README.debian): new file to explain how to initialize bbdb. Fixes Bug#21497.
+
+ -- Frederic Lepied <Lepied@debian.org> Mon, 4 May 1998 05:56:21 +0200
+
+bbdb (2.00-2) frozen unstable; urgency=low
+
+ * (control): added a dependency on make.
+ * (control): priority optional.
+ * (control): suggests vm, w3-el, gnuserv and itimer.
+ * (install): byte compile with -no-site-file.
+
+ -- Frederic Lepied <Lepied@debian.org> Sun, 19 Apr 1998 08:11:15 +0200
+
+bbdb (2.00-1) unstable; urgency=low
+
+ * new upstream version.
+
+ -- Frederic Lepied <Lepied@Debian.org> Wed, 18 Mar 1998 21:45:28 +0100
+
+bbdb (1.55unoff-1.1) unstable; urgency=low
+
+ * Non-maintainer release.
+
+ * Updated for new emacsen requirements.
+
+ * Removed empty README.Debian file.
+
+ * Removed debmake dependencies--made it easier to fix everything else.
+
+ * Updated to standards 2.4.0.0.
+
+ -- Ben Pfaff <pfaffben@pilot.msu.edu> Thu, 5 Mar 1998 11:48:24 -0500
+
+bbdb (1.55unoff-1) unstable; urgency=low
+
+ * upstream release.
+ * removed gnus-bbdb.el for lack of copyright and integration into
+ upstream bbdb-gnus.
+
+ -- Frederic Lepied <Lepied@debian.org> Sun, 26 Oct 1997 11:34:06 +0100
+
+bbdb (1.54unoff-1) unstable; urgency=low
+
+ * new maintainer.
+ * new upstream release.
+ * Added the missing P binding for bbdb-print in bbdb.el.
+ * Added gnus-bbdb.el to work with newer version of gnus.
+
+ -- Frederic Lepied <Lepied@debian.org> Fri, 17 Oct 1997 22:54:11 +0200
+
+
diff --git a/debian/compat b/debian/compat
new file mode 100644
index 0000000..7ed6ff8
--- /dev/null
+++ b/debian/compat
@@ -0,0 +1 @@
+5
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..fdaacdc
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,15 @@
+Source: bbdb
+Section: mail
+Priority: optional
+Maintainer: Joerg Jaspert <joerg@debian.org>
+Build-Depends-Indep: debhelper (>> 4.2.0), texinfo, texi2html, emacs21
+Standards-Version: 3.6.2.0
+
+Package: bbdb
+Architecture: all
+Depends: make, emacs21 | emacsen
+Suggests: vm, w3-el-e21, gnuserv, gnus|t-gnus, perl
+Description: The Insidious Big Brother Database (email rolodex) for Emacs
+ BBDB is a rolodex-like database program for GNU Emacs. BBDB stands
+ for Insidious Big Brother Database, and is not, repeat, *not* an
+ obscure reference to the Buck Rogers TV series.
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 0000000..d43b903
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,32 @@
+This package was debianized by Frederic Lepied <Lepied@debian.org> on
+Mon, 17 Oct 1997 23:09:25 +0200.
+
+Actual Maintainer: Joerg Jaspert <joerg@debian.org>
+
+It was downloaded from http://bbdb.sourceforge.net/
+
+Authors: Jamie Zawinski, Ronan Waide (Waider), Todd Kaufmann,
+ Boris Goldowsky, Christopher Kline, John Heidemann,
+ Roland McGrath
+
+Current Upstream: Ronan Waide
+
+Copyright:
+
+;;; The Insidious Big Brother Database 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 2, 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 GNU Emacs; see the file COPYING. If not, write to
+;;; the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;;; Boston, MA 02111-1307, USA.
+
+On Debian systems, the complete text of the GNU General Public
+License can be found in /usr/share/common-licenses/GPL file.
diff --git a/debian/dirs b/debian/dirs
new file mode 100644
index 0000000..b22ae1e
--- /dev/null
+++ b/debian/dirs
@@ -0,0 +1,2 @@
+usr/bin
+usr/share/emacs/site-lisp/bbdb
diff --git a/debian/doc-base b/debian/doc-base
new file mode 100644
index 0000000..038c1ae
--- /dev/null
+++ b/debian/doc-base
@@ -0,0 +1,12 @@
+Document: bbdb
+Title: Insidious Big Brother Database User Manual
+Author: Jamie Zawinski, Matt Simmons and the BBDB Development Team
+Abstract: BBDB is a rolodex-like database program for GNU Emacs and
+ XEmacs. BBDB stands for Insidious Big Brother Database, and is not,
+ repeat, not an obscure reference to the Buck Rogers TV series.
+Section: mail
+
+Format: HTML
+Index: /usr/share/doc/bbdb/html/bbdb.html
+Files: /usr/share/doc/bbdb/html/*.html
+
diff --git a/debian/docs b/debian/docs
new file mode 100644
index 0000000..1e8ceb3
--- /dev/null
+++ b/debian/docs
@@ -0,0 +1 @@
+bits.tar.gz
diff --git a/debian/emacsen-install b/debian/emacsen-install
new file mode 100644
index 0000000..65721e8
--- /dev/null
+++ b/debian/emacsen-install
@@ -0,0 +1,111 @@
+#!/bin/sh
+# /usr/lib/emacsen-common/packages/install/bbdb
+
+FLAVOR=$1
+PACKAGE="bbdb"
+
+if [ "X${FLAVOR}" = "X" ]; then
+ echo Need argument to determin FLAVOR of emacs;
+ exit 1
+fi
+
+if [ "X${PACKAGE}" = "X" ]; then
+ echo Internal error: need package name;
+ exit 1;
+fi
+
+ELDIR=/usr/share/emacs/site-lisp/${PACKAGE}
+ELCDIR=/usr/share/${FLAVOR}/site-lisp/${PACKAGE}
+
+COMPILE="-q -batch -f batch-byte-compile"
+
+case "${FLAVOR}" in
+ emacs)
+ echo "install/${PACKAGE}: Ignoring Flavor ${FLAVOR} ..."
+ ;;
+ *)
+
+ echo "install/${PACKAGE}: Byte-compiling for ${FLAVOR} ..."
+
+ rm -rf ${ELCDIR}
+ cd ${ELDIR}
+ TARGETS="rmail mhe gnus bbdb"
+
+ if [ -d /usr/share/${FLAVOR}/site-lisp/vm ]; then
+ TARGETS="$TARGETS vm"
+ elif [ ${FLAVOR} = xemacs20 -o ${FLAVOR} = xemacs21 ]; then
+ TARGETS="$TARGETS vm"
+ fi
+
+ if [ ${FLAVOR} = emacs19 -o ${FLAVOR} = mule2 ]; then
+ MHEDIR=/usr/share/${FLAVOR}/site-lisp/../lisp
+ elif [ ${FLAVOR} = xemacs20 -o ${FLAVOR} = xemacs21 ]; then
+ MHEDIR=/usr/share/${FLAVOR}/site-lisp/../lisp/mh-e
+ else # emacs20
+ MHEDIR=/usr/share/${FLAVOR}/site-lisp/../lisp/mail
+ fi
+
+ ## for Gnus
+ if [ -d /usr/share/${FLAVOR}/site-lisp/gnus ]; then
+ GNUSDIR=/usr/share/${FLAVOR}/site-lisp/gnus
+ elif [ -d /usr/share/${FLAVOR}/site-lisp/semi-gnus ]; then
+ GNUSDIR=/usr/share/${FLAVOR}/site-lisp/semi-gnus
+ elif [ -d /usr/share/${FLAVOR}/site-lisp/t-gnus ]; then
+ GNUSDIR=/usr/share/${FLAVOR}/site-lisp/t-gnus
+ elif [ -d /usr/share/${FLAVOR}/site-lisp/chaos ]; then
+ GNUSDIR=/usr/share/${FLAVOR}/site-lisp/chaos
+ fi
+
+ if [ -z ${GNUSDIR} ]; then
+ if [ ${FLAVOR} = emacs19 -o ${FLAVOR} = mule2 ]; then
+ GNUSDIR=/usr/share/emacs/19.34/lisp
+ elif [ ${FLAVOR} = xemacs20 ]; then
+ GNUSDIR=/usr/lib/xemacs-20.4/lisp/gnus
+ elif [ ${FLAVOR} = xemacs21 ]; then
+ GNUSDIR=/usr/share/xemacs21/packages/lisp/gnus
+ else
+ GNUSDIR=/usr/share/${FLAVOR}/site-lisp/../lisp/gnus
+ fi
+ fi
+
+ LOG=`tempfile`
+
+ rm -rf ${ELCDIR} && cp -a ${ELDIR} ${ELCDIR}
+
+ # at ELCDIR
+ ( cd ${ELCDIR}
+ echo "Generating bbdb-autoloads..."
+ echo "Generating bbdb-autoloads" >> $LOG
+ make autoloads >> $LOG 2>&1
+ if [ $FLAVOR != xemacs20 -a $FLAVOR != xemacs21 ]; then
+ echo "(provide 'bbdb-autoloads)" >> lisp/bbdb-autoloads.el
+ fi
+ echo "Byte-compiling bbdb. This takes looooooong..."
+ make $TARGETS EMACS_PROG=${FLAVOR} VMDIR=/usr/share/${FLAVOR}/site-lisp/vm GNUSDIR=${GNUSDIR} MHEDIR=${MHEDIR} >> $LOG 2>&1
+ mv lisp/*.elc utils/*.el .
+ rm -rf tex utils lisp Makefile
+ ${FLAVOR} ${COMPILE} *.el >> $LOG 2>&1
+ )
+ cat > ${ELCDIR}/load-path.el <<EOF
+(setq load-path (cons (concat "/usr/share/${FLAVOR}/site-lisp/bbdb") load-path))
+(provide 'bbdb/load-path)
+EOF
+ if [ ! -e ${ELCDIR}/bbdb-gnus.elc ]; then
+ echo "*** installing not-compiled bbdb-gnus.el ***" >> $LOG
+ echo "install -m 644 ${ELDIR}/lisp/bbdb-gnus.el ${ELCDIR}" >> $LOG
+ install -m 644 ${ELDIR}/lisp/bbdb-gnus.el ${ELCDIR}
+ fi
+
+ # a hack to fix #179821, #210248, #233904
+ # If bbdb gets installed before vm then the bbdb doesnt have the bbdb-vm compiled....
+ install -m 644 ${ELDIR}/lisp/bbdb-vm.el ${ELCDIR}
+
+ # make -k clean >> $LOG
+ mv $LOG ${ELCDIR}/CompilationLog
+ gzip -9 ${ELCDIR}/CompilationLog
+ chmod 644 ${ELCDIR}/CompilationLog.gz
+
+ echo " done."
+ ;;
+esac
+
diff --git a/debian/emacsen-remove b/debian/emacsen-remove
new file mode 100644
index 0000000..cb2d689
--- /dev/null
+++ b/debian/emacsen-remove
@@ -0,0 +1,36 @@
+#!/bin/sh
+# /usr/lib/emacsen-common/packages/remove/bbdb
+
+# I don't think that remove scripts should have -e set, because
+# that makes the package unremovable if the script fails.
+# set -e
+
+FLAVOR=$1
+PACKAGE="bbdb"
+
+if [ "X${FLAVOR}" = "X" ]; then
+ echo Need argument to determin FLAVOR of emacs;
+ exit 1
+fi
+
+if [ "X${PACKAGE}" = "X" ]; then
+ echo Internal error: need package name;
+ exit 1;
+fi
+
+ELDIR=/usr/share/emacs/site-lisp/${PACKAGE}
+ELCDIR=/usr/share/${FLAVOR}/site-lisp/${PACKAGE}
+
+case "${FLAVOR}" in
+ emacs)
+ echo "remove/${PACKAGE}: Ignoring Flavor ${FLAVOR} ..."
+ ;;
+ *)
+ echo -n "remove/${PACKAGE}: Handling removal of emacsen flavor ${FLAVOR} ..."
+ rm -rf ${ELCDIR}
+
+ echo " done."
+ ;;
+esac
+
+exit 0;
diff --git a/debian/emacsen-startup b/debian/emacsen-startup
new file mode 100644
index 0000000..0f7ea21
--- /dev/null
+++ b/debian/emacsen-startup
@@ -0,0 +1,20 @@
+;; on Debian GNU/Linux
+;;
+;;
+(setq load-path
+ (cons
+ (concat "/usr/share/" (symbol-name debian-emacs-flavor)
+ "/site-lisp/bbdb")
+ load-path))
+
+;; (require 'message)
+
+;; http://bugs.debian.org/85019
+(setq bbdb-sound-files nil)
+(setq bbdb-sound-player nil)
+(setq bbdb-sounds-directory nil)
+
+;; (require 'bbdb)
+;; (bbdb-initialize)
+
+(require 'bbdb-autoloads)
diff --git a/debian/postinst b/debian/postinst
new file mode 100644
index 0000000..bed9e6b
--- /dev/null
+++ b/debian/postinst
@@ -0,0 +1,9 @@
+#!/bin/sh
+
+set -e
+
+install-info --section Emacs Emacs --menuentry="bbdb" \
+ --description='The insidious Big Brother Database for mail and news.' \
+ --quiet /usr/share/info/bbdb.info
+
+#DEBHELPER#
diff --git a/debian/prerm b/debian/prerm
new file mode 100644
index 0000000..8875ed6
--- /dev/null
+++ b/debian/prerm
@@ -0,0 +1,7 @@
+#!/bin/sh
+
+set -e
+
+install-info --quiet --remove /usr/share/info/bbdb.info
+
+#DEBHELPER#
diff --git a/debian/rules b/debian/rules
new file mode 100644
index 0000000..98c0651
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,121 @@
+#!/usr/bin/make -f
+# Made with the aid of debmake, by Christoph Lameter,
+# based on the sample debian/rules file for GNU hello by Ian Jackson.
+
+PACKAGE := bbdb
+pwd=$(shell pwd)
+
+TOPDIR := $(shell pwd)
+t = ${TOPDIR}/debian/bbdb
+
+_files_only = for f in ${1}; do if [ -f $$f ]; then echo $$f; fi; done
+_install_scripts = set -e; \
+ for f in ${1}; \
+ do \
+ b=`basename $$f`; \
+ install -m ${2} $$f ${3}/$${b%.debian}; \
+ done;
+
+perl_scripts := $(shell $(call _files_only, $(wildcard utils/*.pl)))
+
+
+build: build-stamp
+build-stamp:
+ dh_testdir
+
+ ./configure
+
+ cd texinfo && $(MAKE) bbdb.info
+ cd texinfo && /usr/bin/texi2html -split=chapter bbdb.texinfo
+ for f in ${perl_scripts}; \
+ do \
+ sed -e 's@/usr/local/bin/perl.*@/usr/bin/perl@g' \
+ < $$f > $$f.debian; \
+ done;
+
+ touch build-stamp
+
+clean:
+ dh_testdir
+ dh_testroot
+ -rm -f build-stamp
+ -rm -f ${perl_scripts:%=%.debian}
+# -rm -f texinfo/bbdb.dvi
+ -rm -f texinfo/bbdb/
+ -rm -f texinfo/bbdb.info*
+ dh_clean
+ -rm -f Makefile
+ -rm -f lisp/Makefile
+ -rm -f misc/Makefile
+ -rm -f tex/Makefile
+ -rm -f texinfo/Makefile
+ -rm -f testing/Makefile
+ -rm -f utils/Makefile
+ -rm -f config.status
+ -rm -f config.log
+ -rm -f bits.tar.gz
+
+
+install: build
+ dh_testdir
+ dh_testroot
+ dh_clean -k
+ dh_installdirs
+
+ cp -a Makefile debian/bbdb-pilot-jwz.el lisp \
+ ${t}/usr/share/emacs/site-lisp/${PACKAGE}/
+ cp -a debian/bbdb-pilot-jwz.el ${t}/usr/share/emacs/site-lisp/${PACKAGE}/lisp/
+ mkdir -p ${t}/usr/share/emacs/site-lisp/${PACKAGE}/tex/
+ cp -a tex/*.tex ${t}/usr/share/emacs/site-lisp/${PACKAGE}/tex/
+ mkdir -p ${t}/usr/share/emacs/site-lisp/${PACKAGE}/utils/
+ cp utils/*.el ${t}/usr/share/emacs/site-lisp/${PACKAGE}/utils/
+ mkdir -p ${t}/usr/share/man/man1/
+ cp debian/bbdb-*.1 ${t}/usr/share/man/man1/
+
+ tar czf bits.tar.gz bits/
+
+# Hey, we dont want to check for configure when emacs-install runs, so remove target for Makefile
+# sed s/Makefile\ bbdb/bbdb/ <${t}/usr/share/emacs/site-lisp/bbdb/Makefile >Makefile.tmp
+# mv -f Makefile.tmp ${t}/usr/share/emacs/site-lisp/bbdb/Makefile
+ sed s/Makefile\ rmail/rmail/ <${t}/usr/share/emacs/site-lisp/bbdb/lisp/Makefile >Makefile.tmp
+ mv -f Makefile.tmp ${t}/usr/share/emacs/site-lisp/bbdb/lisp/Makefile
+ patch ${t}/usr/share/emacs/site-lisp/bbdb/Makefile ${TOPDIR}/debian/Makepatch
+
+# Install tex/* into usr/share/texmf/text/bbdb so one could use bbdb-print easy
+ mkdir -p ${t}/usr/share/texmf/tex/bbdb/
+ cp tex/*.tex ${t}/usr/share/texmf/tex/bbdb/
+
+ mkdir -p ${t}/usr/share/info
+ cp texinfo/*.info* ${t}/usr/share/info/
+ gzip -9 ${t}/usr/share/info/*
+ $(call _install_scripts, ${perl_scripts:%=%.debian}, 0755, ${t}/usr/bin)
+
+# Install the generated html Documentation
+ -mkdir -p ${t}/usr/share/doc/bbdb/html/
+ cp texinfo/bbdb/* ${t}/usr/share/doc/bbdb/html/
+
+# Build architecture-independent files here.
+binary-indep: install
+# We have nothing to do by default.
+
+# Build architecture-dependent files here.
+binary-arch: install
+ dh_testdir
+ dh_testroot
+ dh_installemacsen
+ dh_installdocs
+ dh_installchangelogs ChangeLog
+# dh_installinfo texinfo/*.info*
+ gzip -9 ${t}/usr/share/doc/bbdb/README.Debian
+ dh_strip
+ dh_compress
+ dh_fixperms
+ dh_installdeb
+ dh_shlibdeps
+ dh_gencontrol
+ dh_md5sums
+ dh_builddeb
+
+binary: binary-indep binary-arch
+.PHONY: build clean install binary-indep binary-arch binary
+
diff --git a/lisp/Makefile.in b/lisp/Makefile.in
index 70b933b..ed11b74 100644
--- a/lisp/Makefile.in
+++ b/lisp/Makefile.in
@@ -34,7 +34,14 @@ MHE = -eval '(progn (if (not (string-match "$(MHEDIR)" "")) \
(setq load-path (cons "$(MHEDIR)" load-path))) \
(load "mh-e" t t))'
-PUSHPATH=-l @top_srcdir@/@BBDB_LOADPATH@
+PUSHPATH= -eval "`\
+ dir=\". $(OTHERDIRS)\"; \
+ echo \(setq load-path \(append \(list ; \
+ for i in $$dir ; do \
+ echo \(expand-file-name \\"$$i\\"\)\ ; \
+ done ;\
+ echo \) load-path\)\) ; \
+ `"
.SUFFIXES: .elc .el .tar .Z .gz .uu
@@ -89,7 +96,7 @@ bbdb-autoloads.el: $(DEPSRCS)
@echo " (defmacro define-widget (&rest args)" >> $@;
@echo " nil)))" >> $@;
@echo " " >> $@;
- @HUSHMAKE@$(EMACS_PROG) -batch -q -l autoload \
+ $(EMACS_PROG) -batch -q -l autoload \
--eval '(setq generated-autoload-file "'`pwd`'/$@")' \
--eval "(if (featurep 'xemacs) (delete-file generated-autoload-file))" \
--eval '(setq make-backup-files nil)' \
@@ -97,7 +104,7 @@ bbdb-autoloads.el: $(DEPSRCS)
-f batch-update-autoloads `pwd`
bbdb-autoloads.elc: bbdb-autoloads.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q -f batch-byte-compile ./$^
+ $(EMACS_PROG) -batch -q -f batch-byte-compile ./$^
bbdb.elc: bbdb.el
bbdb-com.elc: bbdb.elc bbdb-com.el
@@ -112,41 +119,41 @@ bbdb-w3.elc: bbdb.elc bbdb-w3.el
bbdb-xemacs.elc: bbdb.elc bbdb-xemacs.el
.el.elc:
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -f batch-byte-compile $<
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -f batch-byte-compile $<
bbdb.elc: bbdb.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q -f batch-byte-compile ./bbdb.el
+ $(EMACS_PROG) -batch -q -f batch-byte-compile ./bbdb.el
bbdb-gnus.elc: bbdb.elc bbdb-gnus.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(GNUS) \
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(GNUS) \
-f batch-byte-compile $(@:.elc=.el)
bbdb-mhe.elc: bbdb.elc bbdb-mhe.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(MHE) \
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(MHE) \
-f batch-byte-compile $(@:.elc=.el)
bbdb-rmail.elc: bbdb.elc bbdb-rmail.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(RMAIL) \
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(RMAIL) \
-f batch-byte-compile $(@:.elc=.el)
bbdb-vm.elc: bbdb.elc bbdb-vm.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(VM) \
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc $(VM) \
-f batch-byte-compile $(@:.elc=.el)
bbdb-srv.elc: bbdb.elc bbdb-srv.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -eval '(progn (or (fboundp (quote define-obsolete-variable-alias)) (if (locate-library "gnuserv-compat") (load "gnuserv-compat" t t))) (if (and (locate-library "gnuserv") (locate-library "itimer")) (byte-compile-file "bbdb-srv.el") (message "Optional package bbdb-srv skipped - gnuserv not found")))'
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -eval '(progn (or (fboundp (quote define-obsolete-variable-alias)) (if (locate-library "gnuserv-compat") (load "gnuserv-compat" t t))) (if (and (locate-library "gnuserv") (locate-library "itimer")) (byte-compile-file "bbdb-srv.el") (message "Optional package bbdb-srv skipped - gnuserv not found")))'
bbdb-reportmail.elc: bbdb.elc bbdb-reportmail.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -eval '(if (locate-library "reportmail") (byte-compile-file "bbdb-reportmail.el") (message "Optional package bbdb-reportmail skipped - reportmail not found"))'
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -eval '(if (locate-library "reportmail") (byte-compile-file "bbdb-reportmail.el") (message "Optional package bbdb-reportmail skipped - reportmail not found"))'
bbdb-sc.elc: bbdb.elc bbdb-sc.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -eval '(if (locate-library "supercite") (byte-compile-file "bbdb-sc.el") (message "Optional package bbdb-sc skipped - supercite not found"))'
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc -eval '(if (locate-library "supercite") (byte-compile-file "bbdb-sc.el") (message "Optional package bbdb-sc skipped - supercite not found"))'
# bbdb-hooks uses VM macros if it can find VM.
bbdb-hooks.elc: bbdb.elc bbdb-hooks.el
- @HUSHMAKE@$(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc \
- -eval '(and (not (string= "$(VMDIR)" "")) \
- (setq load-path (cons "$(VMDIR)" load-path)) \
- (load "vm" t t) \
- (load "vm-vars" t t))' \
+ $(EMACS_PROG) -batch -q $(PUSHPATH) -l ./bbdb.elc \
+ -eval "(and (not (string= \"$(VMDIR)\" \"\")) \
+ (setq load-path (cons \"$(VMDIR)\" load-path)) \
+ (load \"vm\" t t) \
+ (load \"vm-vars\" t t))" \
-f batch-byte-compile $(@:.elc=.el)
autoloads: bbdb-autoloads.el
@@ -154,8 +161,8 @@ autoloads: bbdb-autoloads.el
autoloadsc: bbdb-autoloads.elc
extras: bbdb-print.elc bbdb-ftp.elc bbdb-whois.elc bbdb-xemacs.elc \
- @BBDB_SRV@ @BBDB_REPORTMAIL@ bbdb-snarf.elc bbdb-w3.elc \
- @BBDB_SC@ bbdb-merge.elc bbdb-migrate.elc bbdb-gui.elc
+ bbdb-srv.el bbdb-reportmail.el bbdb-snarf.elc bbdb-w3.elc \
+ bbdb-sc.el bbdb-merge.elc bbdb-migrate.elc bbdb-gui.elc
bbdb: bbdb.elc bbdb-com.elc bbdb-hooks.elc autoloadsc extras
rmail: bbdb bbdb-rmail.elc
vm: bbdb bbdb-vm.elc
diff --git a/texinfo/bbdb/bbdb.html b/texinfo/bbdb/bbdb.html
new file mode 100644
index 0000000..cc5503e
--- /dev/null
+++ b/texinfo/bbdb/bbdb.html
@@ -0,0 +1,263 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: 1. BBDB</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: 1. BBDB">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: 1. BBDB">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="Top"></a>
+<a name="SEC1"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[ &lt; ]</td>
+<td valign="middle" align="left">[<a href="bbdb_1.html#SEC2" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[ &lt;&lt; ]</td>
+<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h1 class="chapter"> 1. BBDB </h1>
+
+<p><b>BBDB</b> is a rolodex-like database program for GNU Emacs. <b>BBDB</b> stands
+for <b><i>Insidious Big Brother Database</i></b>, and is not, repeat, <em>not</em> an
+obscure reference to the Buck Rogers TV series.
+</p>
+<p>It provides the following features:
+</p>
+<ul>
+<li>
+Integration with mail and news readers, with little or no
+interaction by the user:
+
+<ul>
+<li>
+easy (or automatic) display of the record corresponding to the sender of
+the current message;
+
+</li><li>
+automatic creation of records based on the contents of the current
+message;
+
+</li><li>
+automatic addition of data to arbitrary fields of the record
+corresponding to the sender of the current message.
+</li></ul>
+
+</li><li>
+Listing all records which match a regular expression;
+
+</li><li>
+Listing all records which match a regular expression in a particular
+field (<samp>`company'</samp> or <samp>`notes,'</samp> for example);
+</li></ul>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC2">1.1 Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC28">1.2 The <b>BBDB</b></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Overview
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC33">1.3 BBDB Mode</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC36">1.4 Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Interfaces to various readers
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC41">1.5 Reader-specific Features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Features only available to specific readers
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC53">1.6 Using the <b>BBDB</b> with other packages</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Using the BBDB with other packages
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC58">1.7 Options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC62">1.8 Utilities</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC67">1.9 Internals</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> BBDB Internals
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC75">1.10 Mailing Lists</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> The BBDB mailing lists
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC76">1.11 Changes in this Version</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> New in this version
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC81">1.12 The Latest Version</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Where to Get It
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC82">1.13 The Future</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Known Bugs, the TODO list and EOL statements
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC89">1.14 Thanks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> to the Ministry of Bugs
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_2.html#SEC93">Concept Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_3.html#SEC94">Variable Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+ --- The Detailed Node Listing ---
+
+Installation
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC3">1.1.1 General Prerequisites</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> General <b>BBDB</b> requirements
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+File Installation
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC4">1.1.2 Normal User Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> &quot;Normal&quot; Installations
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC10">1.1.3 XEmacs Package Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Installing as an XEmacs package
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Initial Configuration
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC13">1.1.4 Initial Configuration</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> How to initially set up the <b>BBDB</b>
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Manual initialization
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC19">1.1.4.1 Initializing <b>BBDB</b> support for Gnus</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC20">1.1.4.2 Initializing <b>BBDB</b> support for MH-E</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC21">1.1.4.3 Initializing <b>BBDB</b> support for RMAIL</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC22">1.1.4.4 Initializing <b>BBDB</b> support for Sendmail</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC23">1.1.4.5 Initializing <b>BBDB</b> support for VM</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Other packages:
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC24">1.1.4.6 Initializing <b>BBDB</b> support for Message mode</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC25">1.1.4.7 Initializing <b>BBDB</b> support for Reportmail</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC26">1.1.4.8 Initializing <b>BBDB</b> support for Supercite</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC27">1.1.4.9 Initializing <b>BBDB</b> support for Web Browsers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+The <b>BBDB</b>
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Description of database fields
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC30">1.2.2 Basic searching commands</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Basic database searching commands
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC31">1.2.3 Advanced searching commands</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Advanced database searching commands
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC32">1.2.4 Manual record addition</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Adding records by hand
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Interfaces
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC37">1.4.1 Mail Reading Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC38">1.4.2 News Reading Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Reader-specific Features
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC42">1.5.1 Gnus-specific Features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC48">1.5.2 VM-specific features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> VM-specific Features
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Gnus-specific Features
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC43">1.5.1.1 Scoring</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Store score adjustments in the <b>BBDB</b>
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC44">1.5.1.2 Gnus Summary Buffer Enhancements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> <b>BBDB</b> information in the Summary buffer
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> <b>BBDB</b> information in the Subject List
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+VM-specific features
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC49">1.5.2.1 VM Message Summary Enhancements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> <b>BBDB</b> information in message summary
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Using the <b>BBDB</b> with other packages
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC54">1.6.1 Using the <b>BBDB</b> with Message Mode</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC55">1.6.2 Using the <b>BBDB</b> with Reportmail</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC56">1.6.3 Using the <b>BBDB</b> with Supercite</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC57">1.6.4 Using the <b>BBDB</b> with Web Browsers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Options
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Utilities
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC63">1.8.1 <code>bbdb-ftp</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Storing FTP sites in the <b>BBDB</b>
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Print the <b>BBDB</b>
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC65">1.8.3 <code>bbdb-snarf</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Record generation from raw text
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC66">1.8.4 <code>bbdb-srv</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> External control of the <b>BBDB</b>
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Changes in this Version
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC77">1.11.1 Major Changes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Major changes in this version
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC79">1.11.2 Other Changes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Not-so-major changes
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+The Future
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="bbdb_1.html#SEC83">1.13.1 Known Bugs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Known Bugs, and how to submit new ones
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC84">1.13.2 TODO List</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> The TODO List
+</td></tr>
+<tr><td align="left" valign="top"><a href="bbdb_1.html#SEC88">1.13.3 End of Life (EOL) Statements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> EOL (End Of Life) Statements
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+_
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="#SEC1">1. BBDB</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+</pre></th></tr></table>
+
+<hr size="6">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[ &lt;&lt; ]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>
diff --git a/texinfo/bbdb/bbdb_1.html b/texinfo/bbdb/bbdb_1.html
new file mode 100644
index 0000000..c740138
--- /dev/null
+++ b/texinfo/bbdb/bbdb_1.html
@@ -0,0 +1,5031 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: 1.1 Installation</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: 1.1 Installation">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: 1.1 Installation">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="Installation"></a>
+<a name="SEC2"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC3" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.1 Installation </h2>
+
+<p>This program consists of several groups of files, organized by
+directory:
+</p>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC3">1.1.1 General Prerequisites</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> General <b>BBDB</b> requirements
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+File Installation
+</pre></th></tr><tr><td align="left" valign="top"><a href="#SEC4">1.1.2 Normal User Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> &quot;Normal&quot; Installations
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC10">1.1.3 XEmacs Package Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Installing as an XEmacs package
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Initial Configuration
+</pre></th></tr><tr><td align="left" valign="top"><a href="#SEC13">1.1.4 Initial Configuration</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> How to initially set up the <b>BBDB</b>
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="General-Prerequisites"></a>
+<a name="SEC3"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC2" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC4" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.1.1 General Prerequisites </h3>
+
+<p>Various parts of the <b>BBDB</b> require extra packages to be available
+that are not part of the <b>BBDB</b> distribution. Please note that with
+one exception no extra packages (beyond those which ship with both GNU
+Emacs and XEmacs) are required for the use of <b>BBDB</b> core
+functionality.<a name="DOCF1" href="bbdb_fot.html#FOOT1">(1)</a> This one exception
+applies to XEmacs 20.5 users - the <code>xemacs-base</code> package must be
+installed for the correct operation of the core <b>BBDB</b> functionality.
+The table below lists the requirements of the various portions of the
+<b>BBDB</b>. Please note that the absence of any of the below optional
+packages will not affect core <b>BBDB</b> functionality.
+</p>
+<table>
+<tr><td> <br><p> BBDB file
+</p></td><td> <br><p> Package needed
+</p></td><td> <br><p> GNU 19.34
+</p></td><td> <br><p> GNU 20.2
+</p></td><td><p> XEmacs<br> </p><p align="center"> &gt;=20.4
+</p></td><td><p> XEmacs<br> </p><p align="center"> 20.5
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-ftp</code>
+</p></td><td><p> EFS or <br> Ange-FTP
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> P
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-gnus</code>
+</p></td><td><p> Gnus[1]
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> P
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-mhe</code>
+</p></td><td><p> MH-E
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> P
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-reportmail</code>
+</p></td><td><p> Reportmail
+</p></td><td>
+</td><td>
+</td><td> <p align="center"> B
+</p></td><td> <p align="center"> P[2]
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-sc</code>
+</p></td><td><p> Supercite
+</p></td><td> <p align="center"> B
+</p></td><td>
+</td><td> <p align="center"> B
+</p></td><td> <p align="center"> P
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-srv</code>
+</p></td><td><p> <code>gnuserv</code> and <br> <code>itimer</code>
+</p></td><td>
+</td><td>
+</td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-vm</code>
+</p></td><td><p> VM[4]
+</p></td><td>
+</td><td>
+</td><td> <p align="center"> B
+</p></td><td> <p align="center"> P
+</p>
+</td></tr>
+<tr><td><p> <code>bbdb-w3</code>
+</p></td><td><p> <code>browse-url</code>
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> B
+</p></td><td> <p align="center"> P[3]
+</p></td></tr>
+</table>
+
+<br>
+
+<p><b>NOTES:</b>
+</p><ol>
+<li>
+The old GNUS mail/newsreader should still work. Please keep in mind
+that you have a relatively recent Emacs (GNU 19.34 or later, XEmacs
+19.15 or later), you are probably using Gnus.
+</li><li>
+As of this writing, Reportmail is available as
+part of the <code>edit-utils</code> package.
+</li><li>
+As of this writing, <code>browse-url</code> is
+available as part of the <code>mail-lib</code> package.
+</li><li>
+The source release of VM is currently required due to the use of macros
+from the VM codebase in <b>BBDB</b>'s VM integration.
+</li></ol>
+
+<p>Please also note that the XEmacs package locations are as of this
+writing. As the XEmacs 20.5 package system is still in development, the
+locations may change without warning.
+</p>
+<hr size="6">
+<a name="Normal-User"></a>
+<a name="SEC4"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC3" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC10" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.1.2 Normal User Installation </h3>
+
+<a name="SEC5"></a>
+<h3 class="subheading"> Configuring the compilation process </h3>
+
+<p>First of all, you should run the <code>configure</code> script at the toplevel
+of the distribution. This script will perform a number of checks on
+your system and generate the <tt>`Makefile'</tt>'s accordingly.
+</p>
+<p>The <code>configure</code> script also comes with a number of options that
+lets you customize the compilation process. These options are described
+below where appropriate.
+</p>
+<a name="SEC6"></a>
+<h3 class="subheading"> Byte Compiling the Lisp files </h3>
+
+<p>First, you need to byte-compile the appropriate <b>BBDB</b> Lisp files.
+While this is in theory an optional step, it is virtually required in
+practice due to speed reasons.
+</p>
+<p>In order to byte-compile the lisp files, an Emacs of some sort must be
+used. By default (at <code>configure</code> time), <code>emacs</code> and
+<code>xemacs</code> will be tried in that order. If you want to use a special
+Emacs flavor (or if you want to use <code>xemacs</code> at the first place),
+you should pass the <code>--with-emacs=PROG</code> option to <code>configure</code>.
+</p>
+<p>In order to successfully compile the <b>BBDB</b>, the build process also
+needs to know the location of the various optional packages. If the
+directories containing these optional packages are in the default Emacs
+search path (the <code>load-path</code> variable), no other changes need be
+made for the build process to complete successfully.
+</p>
+<p>If the optional packages are not in the default search path, the build
+process will not find them unless explicitly told of their location(s).
+To tell the build process where to find Gnus, MH-E, and/or VM, use the
+<code>configure</code> options <code>--with-gnus-dir=DIR</code>,
+<code>--with-mhe-dir=DIR</code>, and/or <code>--with-vm-dir=DIR</code> variables
+respectively. To tell the build process where to find any other
+package(s), pass the directories containing the lisp files for the
+package(s) to the <code>configure</code> option <code>--with-other-dirs=DIRS</code>.
+If multiple directories are to be added, they should be separated by
+spaces or colons, and should <b>not</b> be quoted. For example, to
+add the <tt>`/p/local/elisp/footnote'</tt> and <tt>`/p/local/elisp/sc'</tt>
+directories, call the <code>configure</code> script as follows:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"> <code>configure --with-other-dirs=/p/local/elisp/footnote:/p/local/elisp/sc</code>
+</pre></td></tr></table>
+<p>After configuring, run one of the following commands:
+</p>
+
+<p>You can also combine the above <code>make</code> commands. For example, to
+build the <b>BBDB</b> with support for <code>Gnus</code> and <code>VM</code>, you can
+do so by typing:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">make gnus vm
+</pre></td></tr></table>
+<a name="SEC7"></a>
+<h3 class="subheading"> Moving the files to their final destination </h3>
+
+<a name="SEC8"></a>
+<h4 class="subsubheading"> Lisp files </h4>
+
+<p>As stated above, the <tt>`lisp'</tt> subdirectory contains the Emacs Lisp source
+files for the <b>BBDB</b>. Therefore, these files must be in the Emacs
+<code>load-path</code>. There are several ways of doing this, three of which are
+described below:
+</p>
+<ul>
+<li>
+Add the <tt>`lisp'</tt> directory from the source distribution to the
+<code>load-path</code>. This will allow you to run the <b>BBDB</b> in-place. This
+method is recommended for normal users or <b>BBDB</b> developers, especially if
+disk usage is an issue. It is <b>not</b> recommended for site-wide
+installations.
+
+</li><li>
+Link the <tt>`lisp'</tt> directory into your <tt>`site-lisp'</tt> directory. This is
+for a site-wide installation, but it is subject to the following caveat. If you
+link the <tt>`lisp'</tt> directory into <tt>`site-lisp'</tt>, you will make life more
+difficult for yourself down the road, as you will not be able to make changes to
+the source directory (new versions, patches, etc) without having an effect on
+other users who now depend on it. This directory will automatically be added to
+the <code>load-path</code> when Emacs starts.
+
+</li><li>
+Make a directory whose sole purpose in life is containing the production copies
+of the <b>BBDB</b> source and byte-compiled source files. Either put this
+directory under <tt>`site-lisp'</tt> (or put it somewhere else and link it into
+<tt>`site-lisp'</tt>). This directory will automatically be added to the
+<code>load-path</code> when Emacs starts. This is the best of the three listed here,
+as it allows for a degree of separation between the (possibly changing) source
+tree and the production code.
+</li></ul>
+
+
+<a name="SEC9"></a>
+<h4 class="subsubheading"> texinfo files </h4>
+
+<p>The <tt>`bbdb.info'</tt> file in this directory contains the documentation
+for the <b>BBDB</b>. This file should either be linked or copied to a
+directory on the default path for the <code>info</code> program or listed in
+the <code>INFOPATH</code> environment variable.
+</p>
+<hr size="6">
+<a name="XEmacs-Package"></a>
+<a name="SEC10"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC4" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.1.3 XEmacs Package Installation </h3>
+
+
+<p><b>NOTE:</b> XEmacs packages are currently supported only under XEmacs
+versions after and including 20.5. If you are not running such a version
+of XEmacs, you should install the <b>BBDB</b> according to the instructions
+in <a href="#SEC4">Normal User Installation</a>.
+</p>
+<a name="SEC11"></a>
+<h3 class="subheading"> Configuring / Byte Compiling </h3>
+
+<p>The configuration and byte-compilation procedures are the same as in the
+Normal User installation. See <a href="#SEC4">Normal User Installation</a>.
+</p>
+<a name="SEC12"></a>
+<h3 class="subheading"> Moving the files to their final destination </h3>
+
+<p>Support is provided for the automatic installation of the <b>BBDB</b> in an
+XEmacs package directory. The following <code>configure</code> options are
+available for you:
+</p>
+<dl compact="compact">
+<dt> <b><code>--with-package-dir=DIR</code></b></dt>
+<dd><p>This option sets the root of the XEmacs package directory. By default,
+<tt>`/usr/local/lib/xemacs/site-packages'</tt> is used.
+</p></dd>
+<dt> <b><code>--with-symlinks</code></b></dt>
+<dd><p>If this option is used, the installation will be done by making symbolic
+links to the sources instead of copying the files.
+</p></dd>
+<dt> <b><code>--with-linkpath=PATH</code></b></dt>
+<dd><p>Without this option, the installation process uses the output of
+<code>pwd</code> to determine the current directory. If something else should
+be used, you should provide an alternate name for the BBDB toplevel
+directory by using <code>--with-linkpath</code>. If, for example, <code>pwd</code>
+returns <tt>`/p/local/elisp/bbdb'</tt>, but you prefer to use
+<tt>`/usr/local/elisp/bbdb/...'</tt> for the links, usr this:
+<code>configure --with-linkpath=/usr/local/elisp/bbdb</code>. This option is
+ignored if <code>--with-symlinks</code> is not used.
+</p></dd>
+</dl>
+
+<p>To perform the (un)installation, use the command <code>make (un)install-pkg</code>.
+This will compile the <tt>`lisp/auto-autoloads.el'</tt> file and will
+install the appropriate files to the appropriate places. The final
+installation tree will take the following form:
+</p>
+<dl compact="compact">
+<dt> <code>$(PACKAGEDIR)/</code></dt>
+<dd><dl compact="compact">
+<dt> <code>lisp/</code></dt>
+<dd><dl compact="compact">
+<dt> <code>bbdb/</code></dt>
+<dd><p> <i><b>BBDB</b> lisp source files. This directory contains a copy of all
+<code>.el</code> and <code>.elc</code> files from the <tt>`lisp'</tt> source directory,
+or is a symbolic link to it.</i>
+</p></dd>
+</dl>
+</dd>
+<dt> <code>info/</code></dt>
+<dd><dl compact="compact">
+<dt> <code>bbdb.info*</code></dt>
+<dd><p> <i><b>BBDB</b> documentation files. These are either copies of the info
+files from the <tt>`texinfo'</tt> source directory, or are symbolic links to
+them.</i>
+</p></dd>
+</dl>
+</dd>
+<dt> <code>etc/</code></dt>
+<dd><dl compact="compact">
+<dt> <code>bbdb/</code></dt>
+<dd><dl compact="compact">
+<dt> <code>tex/</code></dt>
+<dd><p> <i><b>BBDB</b> support files for bbdb-print. This directory contains a
+copy of the appropriate files from the <tt>`tex'</tt> source directory, or
+is a symbolic link to it.</i>
+</p></dd>
+<dt> <code>utils/</code></dt>
+<dd><p> <i><b>BBDB</b> miscellaneous utilities. This directory contains a copy
+of the appropriate files from the <tt>`utils'</tt> source directory, or is a
+symbolic link to it.</i>
+</p></dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+
+<hr size="6">
+<a name="Initial-Configuration"></a>
+<a name="SEC13"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC10" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC19" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.1.4 Initial Configuration </h3>
+
+<p>The simplest way to configure the <b>BBDB</b> is to include the following
+forms in your Emacs configuration file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(require 'bbdb)</code>
+<code>(bbdb-initialize)</code>
+</pre></td></tr></table>
+<p><b>Note:</b> The forms above replace the autoloads needed for previous
+versions of the <b>BBDB</b>.
+</p>
+<p>This will set up the <b>BBDB</b> for basic querying and record manipulation
+(the Core Functionality referred to in the Prerequisites section). It
+will not enable any of the mailreader-, newsreader- or other
+package-specific <b>BBDB</b> features. To enable some or all of these
+features, the <code>(bbdb-initialize)</code> form can be enable as shown
+below. Alternatively, the features can be enabled manually as described
+in the following sections.
+</p>
+<a name="SEC14"></a>
+<h3 class="subheading"> Modifying <code>(bbdb-initialize)</code> </h3>
+
+<p>The <code>bbdb-initialize</code> function can be used to enable the various
+package-specific <b>BBDB</b> functions. This feature activation is
+accomplished through the passing of symbols which tell the function
+which features to activate. These symbols are outlined below and in the
+Emacs documentation for the <code>bbdb-initialize</code><a name="DOCF2" href="bbdb_fot.html#FOOT2">(2)</a>
+</p>
+<a name="SEC15"></a>
+<h4 class="subsubheading"> Initialization symbols for mail and news readers </h4>
+
+<dl compact="compact">
+<dt> <code>gnus</code></dt>
+<dd><p> Initialize support for Gnus<a name="DOCF3" href="bbdb_fot.html#FOOT3">(3)</a>. If you pass the <code>gnus</code> symbol, you should
+ probably also pass the <code>message</code> symbol.
+</p></dd>
+<dt> <code>mh-e</code></dt>
+<dd><p> Initialize support for the MH-E mail reader.
+</p></dd>
+<dt> <code>rmail</code></dt>
+<dd><p> Initialize support for the RMAIL mail reader.
+</p></dd>
+<dt> <code>sendmail</code></dt>
+<dd><p> Initialize support for sendmail (<kbd>M-x mail</kbd>)
+</p></dd>
+<dt> <code>vm</code></dt>
+<dd><p> Initialize support for the VM mail reader.<a name="DOCF4" href="bbdb_fot.html#FOOT4">(4)</a>
+</p></dd>
+</dl>
+
+<a name="SEC16"></a>
+<h4 class="subsubheading"> Initialization symbols for other packages </h4>
+
+<dl compact="compact">
+<dt> <code>message</code></dt>
+<dd><p> Initialize support for Message mode (the mail composition program
+ included with Gnus).
+</p></dd>
+<dt> <code>reportmail</code></dt>
+<dd><p> Initialize support for the Reportmail mail notification package.
+</p></dd>
+<dt> <code>sc</code></dt>
+<dd><p> Initialize support for the Supercite message citation package.
+ Additional initialization is required for Supercite to work with the
+ <b>BBDB</b>. See section <a href="#SEC26">Initializing <b>BBDB</b> support for Supercite</a>.
+</p></dd>
+<dt> <code>w3</code></dt>
+<dd><p> Initialize support for Web browsers.
+</p></dd>
+</dl>
+
+<a name="SEC17"></a>
+<h4 class="subsubheading"> Initialization example </h4>
+
+<p>To initialize support for Gnus 5.5, Message mode, Supercite, and Web
+browsers, the following forms would be used:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(require 'bbdb)
+(bbdb-initialize 'gnus 'message 'sc 'w3)
+</pre></td></tr></table>
+<a name="SEC18"></a>
+<h4 class="subsubheading"> Manual initialization </h4>
+
+<p>If your initialization needs exceed those provided by
+<code>bbdb-initialize</code>, refer to the following sections for a
+description of the procedures necessary for enabling <b>BBDB</b> support
+for the packages listed above. The procedures described are the same as
+those carried out by the <code>bbdb-initialize</code> function when passed the
+appropriate symbols. That is, the procedure listed in the RMAIL Prep
+section below is the same as than executed by <code>bbdb-initialize</code>
+when the <code>rmail</code> symbol is passed.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<p>Mail and News readers:
+</p>
+<tr><td align="left" valign="top"><a href="#SEC19">1.1.4.1 Initializing <b>BBDB</b> support for Gnus</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC20">1.1.4.2 Initializing <b>BBDB</b> support for MH-E</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC21">1.1.4.3 Initializing <b>BBDB</b> support for RMAIL</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC22">1.1.4.4 Initializing <b>BBDB</b> support for Sendmail</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC23">1.1.4.5 Initializing <b>BBDB</b> support for VM</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Other packages:
+
+</pre></th></tr><tr><td align="left" valign="top"><a href="#SEC24">1.1.4.6 Initializing <b>BBDB</b> support for Message mode</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC25">1.1.4.7 Initializing <b>BBDB</b> support for Reportmail</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC26">1.1.4.8 Initializing <b>BBDB</b> support for Supercite</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC27">1.1.4.9 Initializing <b>BBDB</b> support for Web Browsers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+</table>
+
+<hr size="6">
+<a name="Gnus-Prep"></a>
+<a name="SEC19"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC13" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC20" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.1 Initializing <b>BBDB</b> support for Gnus </h4>
+
+<p>To take advantage of the <b>Gnus</b> features of the <b>BBDB</b>, add one of
+the following forms to your Emacs configuration file:
+</p>
+
+<p>For Gnus 3.14 or older:
+</p>
+<p><code>(add-hook 'gnus-Startup-hook 'bbdb-insinuate-gnus)</code>
+</p>
+
+<p>For Gnus 3.15 or newer:
+</p>
+<p><code>(add-hook 'gnus-startup-hook 'bbdb-insinuate-gnus)</code>
+</p>
+<p><code>bbdb-insinuate-gnus</code> adds bindings for the default keys to
+<b>Gnus</b> and configures <b>Gnus</b> to notify the <b>BBDB</b> when new
+messages are loaded. This notification is required if the <b>BBDB</b> is
+to be able to display <b>BBDB</b> entries for messages displayed in
+<b>Gnus</b>.
+</p>
+<hr size="6">
+<a name="MH_002dE-Prep"></a>
+<a name="SEC20"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC19" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC21" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.2 Initializing <b>BBDB</b> support for MH-E </h4>
+
+<p>To take advantage of the <b>MH-E</b> features of the <b>BBDB</b>, add the
+following form to your Emacs configuration file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(add-hook 'mh-folder-mode-hook 'bbdb-insinuate-mh)
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-mh</code> adds bindings for the default keys to
+<b>MH-E</b> and configures <b>MH-E</b> to notify the <b>BBDB</b> when new
+messages are loaded. This notification is required if the <b>BBDB</b> is
+to be able to display <b>BBDB</b> entries for messages displayed in
+<b>MH-E</b>.
+</p>
+<hr size="6">
+<a name="RMAIL-Prep"></a>
+<a name="SEC21"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC20" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC22" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.3 Initializing <b>BBDB</b> support for RMAIL </h4>
+
+<p>To take advantage of the <b>RMAIL</b> features of the <b>BBDB</b>, add the
+following form to your Emacs configuration file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(add-hook 'rmail-mode-hook 'bbdb-insinuate-rmail)
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-rmail</code> adds bindings for the default keys to
+<b>RMAIL</b> and configures <b>RMAIL</b> to notify the <b>BBDB</b> when new
+messages are loaded. This notification is required if the <b>BBDB</b> is
+to be able to display <b>BBDB</b> entries for messages displayed in
+<b>RMAIL</b>.
+</p>
+<hr size="6">
+<a name="Sendmail-Prep"></a>
+<a name="SEC22"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC21" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC23" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.4 Initializing <b>BBDB</b> support for Sendmail </h4>
+
+<p>To take advantage of send-mail-mode (the one invoked with <code>M-x
+mail</code>) features of the <b>BBDB</b>, add the following form to your Emacs
+configuration file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(add-hook 'mail-setup-hook 'bbdb-insinuate-sendmail)
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-sendmail</code> enables auto-completion in
+send-mail-mode.
+</p>
+<hr size="6">
+<a name="VM-Prep"></a>
+<a name="SEC23"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC22" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC24" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.5 Initializing <b>BBDB</b> support for VM </h4>
+
+<p>To take advantage of the <b>VM</b> features of the <b>BBDB</b>, either add
+<code>'vm</code> to the parameters of the <code>(bbdb-initialize)</code> form, or
+add the following form to your <tt>`~/.vm'</tt> file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(bbdb-insinuate-vm)</code>
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-vm</code> adds bindings for the default keys to <b>VM</b>
+and configures <b>VM</b> to notify the <b>BBDB</b> when new messages are
+loaded. This notification is required if the <b>BBDB</b> is to be able to
+display <b>BBDB</b> entries for messages displayed in <b>VM</b>.
+</p>
+<hr size="6">
+<a name="Message-Prep"></a>
+<a name="SEC24"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC23" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC25" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.6 Initializing <b>BBDB</b> support for Message mode </h4>
+
+<p>To allow the <b>BBDB</b> to be used in Message mode, add the following form
+to your Emacs initialization file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(bbdb-insinuate-message)</code>
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-message</code> adds a binding for <kbd>M-TAB</kbd> to Message
+mode. This will enable completion of addressees based on <b>BBDB</b>
+records. See <a href="#SEC54">Using the <b>BBDB</b> with Message Mode</a> for more details on the operation
+of Message mode <b>BBDB</b> record completion.
+</p>
+<hr size="6">
+<a name="Reportmail-Prep"></a>
+<a name="SEC25"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC24" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC26" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.7 Initializing <b>BBDB</b> support for Reportmail </h4>
+
+<p>To allow the Reportmail package to report information from <b>BBDB</b>
+records for new mail, add the following form to your Emacs
+initialization file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(bbdb-insinuate-reportmail)</code>
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-reportmail</code> adds to the
+<code>display-time-get-field</code> function to allow access to <b>BBDB</b>
+records during new mail information display. See <a href="#SEC55">Using the <b>BBDB</b> with Reportmail</a>
+for more details on the operation of Reportmail with the <b>BBDB</b>.
+</p>
+<hr size="6">
+<a name="Supercite-Prep"></a>
+<a name="SEC26"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC25" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC27" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.8 Initializing <b>BBDB</b> support for Supercite </h4>
+
+<p>To allow the <b>BBDB</b> to assist in the storage of Supercite citations,
+add the following form to your Emacs initialization file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(bbdb-insinuate-sc)</code>
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-sc</code> adds <b>BBDB</b> functions to two Supercite hooks
+- <code>sc-post-hook</code> and <code>sc-attribs-postselect-hook</code>. See
+<a href="#SEC56">Using the <b>BBDB</b> with Supercite</a> for more details on the operation of Supercite
+citation management using the <b>BBDB</b>.
+</p>
+<p>Three other Supercite variables must be set/modified to allow the
+<b>BBDB</b> to work with it. These variables are not automatically set as
+it would be impossible to reliably set them without interfering with
+other user customizations. The modifications are:
+</p>
+<dl compact="compact">
+<dt> <code>sc-preferred-attribution-list</code></dt>
+<dd><p><code>&quot;sc-consult&quot;</code> should be added to the list. An example
+configuration is:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(setq sc-preferred-attribution-list
+ '(&quot;sc-lastchoice&quot; &quot;x-attribution&quot; &quot;sc-consult&quot;
+ &quot;initials&quot; &quot;firstname&quot; &quot;lastname&quot;))
+</pre></td></tr></table>
+</dd>
+<dt> <code>sc-attrib-selection-list</code></dt>
+<dd><p>The following form should be added to <code>sc-attrib-selection-list</code>:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"> '((&quot;sc-from-address&quot;
+ ((&quot;.*&quot; . (bbdb/sc-consult-attr
+ (sc-mail-field &quot;sc-from-address&quot;))))))
+</pre></td></tr></table>
+</dd>
+<dt> <code>sc-mail-glom-frame</code></dt>
+<dd><p>The following form should be added to <code>sc-mail-glom-frame</code>, to
+allow the retrieval of the name of a person who is a) in the <b>BBDB</b>
+and b) has only included their net address in the message in question.
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"> (&quot;^$&quot; (progn (bbdb/sc-default)
+ (list 'abort '(step . 0))))
+</pre></td></tr></table>
+<p>An example configuration is as follows:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(setq sc-mail-glom-frame</code>
+<code> '((begin (setq sc-mail-headers-start (point)))</code>
+<code> (&quot;^x-attribution:[ \t]+.*$&quot; (sc-mail-fetch-field t) nil t)</code>
+<code> (&quot;^\\S +:.*$&quot; (sc-mail-fetch-field) nil t)</code>
+<code> (&quot;^$&quot; (progn (bbdb/sc-default)</code>
+<code> (list 'abort '(step . 0))))</code>
+<code> (&quot;^[ \t]+&quot; (sc-mail-append-field))</code>
+<code> (sc-mail-warn-if-non-rfc822-p (sc-mail-error-in-mail-field))</code>
+<code> (end (setq sc-mail-headers-end (point)))))</code>
+</pre></td></tr></table></dd>
+</dl>
+
+<p>The above is also documented in <tt>`bbdb-sc.el'</tt>. The
+<code>bbdb/sc-setup-variables</code> function has been provided as an example for
+Supercite variable initialization. Please note that while
+<code>bbdb/sc-setup-variables</code> makes every attempt to safely configure
+the Supercite variables, it will not always work. Specifically, the
+variables <code>sc-attrib-selection-list</code> and <code>sc-mail-glom-frame</code>
+will not be overridden if they have already been defined.
+</p>
+<hr size="6">
+<a name="Web-Browser-Prep"></a>
+<a name="SEC27"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC26" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC28" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC13" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.1.4.9 Initializing <b>BBDB</b> support for Web Browsers </h4>
+
+<p>To allow URLs to be added to <b>BBDB</b> records, add the following form to
+your Emacs initialization file:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"><code>(bbdb-insinuate-w3)</code>
+</pre></td></tr></table>
+<p><code>bbdb-insinuate-w3</code> adds the definition of <kbd>:</kbd> to the W3
+keymap.
+</p>
+<p>The other <code>bbdb-w3</code> functions, specifically the passing of URLs
+from <b>BBDB</b> records to Web browsers, do not require initialization
+within the <b>BBDB</b>. They do, however, require the configuration of the
+<code>browse-url</code> package so it knows to which Web browser URLs are to
+be passed. For more details on the operation of <code>bbdb-w3</code>, see
+<a href="#SEC57">Using the <b>BBDB</b> with Web Browsers</a>.
+</p>
+<hr size="6">
+<a name="The-BBDB"></a>
+<a name="SEC28"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC27" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC29" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.2 The <b>BBDB</b> </h2>
+
+<p>This section discusses the basics of the <b>BBDB</b> - an overview of the
+database's layout, and a discussion of the basic <b>BBDB</b> manipulation
+commands.
+</p>
+<p>The database itself lives in a file which is named by the variable
+<code>bbdb-file</code>. If this variable is not set, the database is assumed
+to be in <tt>`~/.bbdb'</tt>.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC29">1.2.1 Database Fields</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Description of database fields
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC30">1.2.2 Basic searching commands</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Basic database searching commands
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC31">1.2.3 Advanced searching commands</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Advanced database searching commands
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC32">1.2.4 Manual record addition</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Adding records by hand
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="Database-Fields"></a>
+<a name="SEC29"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC28" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC30" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC28" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.2.1 Database Fields </h3>
+
+<p>The database is organized as a set of records, where each record
+corresponds to one person or organization. Each record has several
+fields, and each field is of one of several types. Below, the built-in
+types are listed, followed by a description of how and why some types
+can be used more than once in a single record:
+<a name="IDX1"></a>
+</p>
+<table>
+<tr><td><p> Type
+</p></td><td><p> Description
+</p></td><td><p> Notes
+</p>
+</td></tr>
+<tr><td><p> <code>name</code>
+</p></td><td><p> The name of this person, or none if the record corresponds to an
+organization.
+</p></td><td><p> Single value, single instance.
+</p>
+</td></tr>
+<tr><td><p> <code>company</code>
+</p></td><td><p> The name of this person's organization, or none.
+</p></td><td><p> Single value, single instance.
+</p>
+</td></tr>
+<tr><td><p> <code>AKA</code>
+</p></td><td><p> A list of other names for this person.
+</p></td><td><p> Multiple values through commas.
+</p>
+</td></tr>
+<tr><td><p> <code>net</code>
+</p></td><td><p> A list of this person's network addresses.
+</p></td><td><p> Multiple values through commas.
+</p>
+</td></tr>
+<tr><td><p> <code>address</code>
+</p></td><td><p> A list of postal (physical) addresses for this person.
+</p></td><td><p> Multiple values through multiple occurences.
+</p>
+</td></tr>
+<tr><td><p> <code>phone</code>
+</p></td><td><p> A list of telephone numbers for this person.
+</p></td><td><p> Multiple values through multiple occurences.
+</p>
+</td></tr>
+<tr><td><p> <code>notes</code>
+</p></td><td><p> Random commentary.
+</p></td><td><p> Multiple values through multiple occurences.
+</p>
+</td></tr>
+</table>
+
+<p>The field types listed above can be classified into four categories, as
+indicated by the comments in the `Notes' column.
+</p>
+<p>Field types marked as &quot;Single value, single occurrence&quot; may only occur
+once per record. Each occurrence can only have a single value. For
+example, there will be only one field of type <code>name</code> in a record.
+It will be named <code>name</code>, and will contain a single value (the
+person's name).
+</p>
+<p>The types marked as &quot;Multiple values through commas&quot; are essentially the
+same as the single value, single occurrence field types, but with one
+crucial difference: they can contain multiple values in the form of a
+comma-separated list. So, for example, while a <code>name</code> field with a
+value of &quot;foo, bar&quot; would be treated as if it contained the single value
+&quot;foo, bar&quot;, a <code>net</code> field with the same data would be thought of as
+having two separate values - &quot;foo&quot; and &quot;bar&quot;. As in the single
+occurrence, single value field types, there will be only one occurrence
+of each &quot;Multiple values through commas&quot; field type, and the occurrence
+will have the same name as the type.
+</p>
+<p>The &quot;Multiple values through multiple occurrences&quot; field type is the
+most flexible of the four listed here. There can be multiple
+occurrences of each type. This type necessarily does not have the name
+restriction imposed by the previous two types. For example, there can
+be multiple fields of the <code>address</code> type, none of which have to be
+named <code>address</code>. One could be named <code>home</code>, and the other
+could be named <code>work</code>.
+</p>
+<p>Special properties of the <code>notes</code> field type: All user-defined
+fields that don't fit into the other predefined field types
+(<code>name</code>, <code>company</code>, <code>AKA</code>, <code>net</code>, <code>address</code>,
+and <code>phone</code>) will be created as a <code>notes</code>-type field. In
+addition, several of the user-defined field names are &quot;special&quot;. That
+is, the <b>BBDB</b> treats the values of these &quot;special&quot; fields differently
+than it does other user-defined fields. The &quot;special&quot; fields are:
+</p>
+<a name="IDX2"></a>
+<dl compact="compact">
+<dt> <code>attribution</code></dt>
+<dd><a name="IDX3"></a>
+<p><i>(Available only when the Supercite-specific <b>BBDB</b> functions have been
+enabled)</i> Used for the storage of Supercite attributions. For initialization
+details, see <a href="#SEC26">Initializing <b>BBDB</b> support for Supercite</a>. For usage details, see <a href="#SEC56">Using the <b>BBDB</b> with Supercite</a>. The field used can be changed by changing the value of
+<code>bbdb/sc-attribution-field</code>.
+</p></dd>
+<dt> <code>aka</code></dt>
+<dd><p>Used to store non-primary names associated with a given record.
+</p></dd>
+<dt> <code>face</code></dt>
+<dd><p><i>(XEmacs only)</i> Used for the storage of image data. This data is to be
+in the format output by <code>compface</code>, and commonly found in
+<code>X-Face:</code> headers in messages. If face support has been compiled
+into XEmacs, the image contained in the <code>face</code> header will be
+displayed when the record is viewed.
+</p></dd>
+<dt> <code>finger-host</code></dt>
+<dd><a name="IDX4"></a>
+<p>Address used in place of the listed net address for fingering the entity
+indicated by the record. See section <a href="#SEC33">BBDB Mode</a>. The field used can be changed by
+changing the value of <code>bbdb-finger-host-field</code>.
+</p></dd>
+<dt> <code>gnus-score</code></dt>
+<dd><a name="IDX5"></a>
+<p><b>Gnus</b> scoring adjustment for this person. For initialization details, see
+<a href="#SEC19">Initializing <b>BBDB</b> support for Gnus</a>. For usage details, see <a href="#SEC42">Gnus-specific Features</a>. The field used
+can be changed by changing the value of <code>bbdb/gnus-score-field</code>.
+</p></dd>
+<dt> <code>mail-alias</code></dt>
+<dd><a name="IDX6"></a>
+<p>Value used instead of <code>name</code> for completion. See section <a href="#SEC39">Mail Sending Interfaces</a>.
+</p></dd>
+<dt> <code>mail-name</code></dt>
+<dd><p><i>(Available only when the Reportmail-specific <b>BBDB</b> functions have been
+enabled)</i> Used for the storage of non-default names to be used in the
+reporting of new mail by Reportmail. For initialization details,
+see <a href="#SEC25">Initializing <b>BBDB</b> support for Reportmail</a>. For usage details, see <a href="#SEC55">Using the <b>BBDB</b> with Reportmail</a>.
+</p></dd>
+<dt> <code>mark-char</code></dt>
+<dd><p>The field containing the character to be used for marking a given poster
+in the Gnus Summary Buffer. For usage details, see <a href="#SEC44">Gnus Summary Buffer Enhancements</a>.
+</p></dd>
+<dt> <code>tex-name</code></dt>
+<dd><a name="IDX7"></a>
+<a name="IDX8"></a>
+<p>The value of this field is used in place of the <code>name</code> field when
+printing the database using <code>bbdb-print</code>. See section <a href="#SEC64"><code>bbdb-print</code></a>.
+</p></dd>
+<dt> <code>www</code></dt>
+<dd><p>This field contains the URL associated with the <b>BBDB</b> record. Common uses
+are with <code>bbdb-snarf</code> (see section <a href="#SEC65"><code>bbdb-snarf</code></a>) and the <b>BBDB</b>/Web Browser
+functionality (for initialization details, see <a href="#SEC27">Initializing <b>BBDB</b> support for Web Browsers</a>. For
+usage details, see <a href="#SEC57">Using the <b>BBDB</b> with Web Browsers</a>).
+</p></dd>
+</dl>
+
+<hr size="6">
+<a name="Basic-Searching"></a>
+<a name="SEC30"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC29" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC31" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC28" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.2.2 Basic searching commands </h3>
+
+<p>You can list the contents of the database with the command
+<kbd>M-x bbdb</kbd>. You will be prompted for a regular expression, and all
+records which match that regexp in the name, company, network address,
+or any notes fields will be displayed.
+<a name="IDX9"></a>
+<a name="IDX10"></a>
+<a name="IDX11"></a>
+<a name="IDX12"></a>
+<a name="IDX13"></a>
+<a name="IDX14"></a>
+</p>
+<p>A narrower search may be made by using the commands <kbd>bbdb-name</kbd>,
+<kbd>bbdb-company,</kbd> <kbd>bbdb-net,</kbd> or <kbd>bbdb-notes</kbd>. These commands
+limit their searches to the name, company, email address, and notes
+fields, respectively. If these commands are given a prefix argument,
+the listing displayed will be one line per entry; otherwise, the full
+database entry will be shown on multiple lines.
+</p>
+<p>The functions described above are predefined to certain keys in the
+<code>*BBDB*</code> buffer. See section <a href="#SEC33">BBDB Mode</a>. for more details.
+</p>
+<a name="IDX15"></a>
+<p>The <code>bbdb-notes</code> command will prompt for the notes field to search
+(<kbd>RET</kbd> for all). In this way you can limit your searches to the
+contents of one particular user-defined notes field. (You can add
+user-defined fields with the <code>bbdb-insert-new-field</code> command;
+See section <a href="#SEC33">BBDB Mode</a>.)
+</p>
+<a name="IDX16"></a>
+<a name="IDX17"></a>
+
+<hr size="6">
+<a name="Advanced-Searching"></a>
+<a name="SEC31"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC30" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC32" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC28" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.2.3 Advanced searching commands </h3>
+
+<p>The following functions can be used to search for records based on
+creation and/or modification dates. These functions will match records
+that have <code>timestamp</code> and/or <code>creation-date</code> fields (as
+appropriate. See section <a href="#SEC61">Predefined Hooks</a>. for more information on these
+fields, which are created by default.
+</p>
+<dl compact="compact">
+<dd><a name="IDX18"></a>
+</dd>
+<dt> <code>bbdb-timestamp-older</code></dt>
+<dd><p>Display all records modified before a given date. If this function is
+called interactively, it will prompt for a date. If it is being called
+non-interactively, the date should be provided as a string in
+<samp>`yyyy-mm-dd'</samp> format.
+</p>
+<a name="IDX19"></a>
+</dd>
+<dt> <code>bbdb-timestamp-newer</code></dt>
+<dd><p>Display all records modified after a given date. If this function is
+called interactively, it will prompt for a date. If it is being called
+non-interactively, the date should be provided as a string in
+<samp>`yyyy-mm-dd'</samp> format.
+</p>
+<a name="IDX20"></a>
+</dd>
+<dt> <code>bbdb-creation-older</code></dt>
+<dd><p>Display all records created before a given date. If this function is
+called interactively, it will prompt for a date. If it is being called
+non-interactively, the date should be provided as a string in
+<samp>`yyyy-mm-dd'</samp> format.
+</p>
+<a name="IDX21"></a>
+</dd>
+<dt> <code>bbdb-creation-newer</code></dt>
+<dd><p>Display all records created after a given date. If this function is
+called interactively, it will prompt for a date. If it is being called
+non-interactively, the date should be provided as a string in
+<samp>`yyyy-mm-dd'</samp> format.
+</p>
+<a name="IDX22"></a>
+</dd>
+<dt> <code>bbdb-creation-no-change</code></dt>
+<dd><p>Display all records that have not been changed since creation.
+</p></dd>
+</dl>
+
+<hr size="6">
+<a name="Manual-Record-Addition"></a>
+<a name="SEC32"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC31" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC33" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC28" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.2.4 Manual record addition </h3>
+
+<p>There are several ways to add new entries to the Insidious Big Brother
+Database; the most straightforward is to use <kbd>M-x bbdb-create</kbd>,
+which will prompt you for all relevant information. However, the
+easiest way is to allow them to be added automatically by one of the
+mail or news-reading interfaces (See section <a href="#SEC36">Interfaces</a>.).
+</p>
+<a name="IDX23"></a>
+<a name="IDX24"></a>
+
+<p>There is also <kbd>bbdb-snarf</kbd> (See section <a href="#SEC65"><code>bbdb-snarf</code></a>), which will
+attempt to create a record from a text block. Note that this depends
+on particular formatting and may not do exactly what you want.
+</p>
+<hr size="6">
+<a name="BBDB-Mode"></a>
+<a name="SEC33"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC32" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC34" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.3 BBDB Mode </h2>
+
+<hr size="6">
+<a name="SEC34"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC33" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC35" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC33" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.3.1 Functions bound to keys in <b>BBDB</b> Mode </h3>
+
+<p>When the <samp>`*BBDB*'</samp> buffer is active (either summoned by one of the
+commands in the previous section [See section <a href="#SEC28">The <b>BBDB</b></a>.] or by your mail
+or news program), a variety of commands become available for database
+manipulation. Some of the commands listed below take numeric arguments.
+These arguments can be generated by entering the number before pressing
+the key(s) corresponding to the desired command. The output (if any) of
+the listed commands will be displayed in the <samp>`*BBDB*'</samp> buffer, and
+can be navigated through using the usual cursor motion commands.
+<a name="IDX25"></a>
+<a name="IDX26"></a>
+</p>
+<dl compact="compact">
+<dt> <kbd>e</kbd></dt>
+<dd><a name="IDX27"></a>
+<a name="IDX28"></a>
+<a name="IDX29"></a>
+<p>(<code>bbdb-edit-current-field</code>) Edit the field on the current line. If
+the cursor is in the middle of a multi-line field, such as an address or
+comments section, then the entire field is edited, not just the current
+line.
+</p>
+</dd>
+<dt> <kbd>;</kbd></dt>
+<dd><a name="IDX30"></a>
+<p>(<code>bbdb-edit-notes</code>) A shortcut for editing the <var>notes</var> field.
+</p>
+</dd>
+<dt> <kbd>d, C-k</kbd></dt>
+<dd><a name="IDX31"></a>
+<a name="IDX32"></a>
+<a name="IDX33"></a>
+<p>(<code>bbdb-delete-current-field-or-record</code>) Delete the field on the
+current line. If the current line is the first line of a record, the
+<b>BBDB</b> will, after prompting the user, delete the entire record from
+the database. This may also be applied to multiple records at once by
+<kbd>*</kbd>.
+</p>
+</dd>
+<dt> <kbd>C-o</kbd></dt>
+<dd><a name="IDX34"></a>
+<a name="IDX35"></a>
+<a name="IDX36"></a>
+<a name="IDX37"></a>
+<p>(<code>bbdb-insert-new-field</code>) Inserts a new field into the current
+record. You are prompted (with completion) for the type of field to
+insert (<b>phone</b>, <b>address</b>, <b>notes</b>, etc); if the string you type
+is not a known field type, you will be asked whether to add a new field
+with the entered name of type <code>notes</code>.
+</p>
+<a name="IDX38"></a>
+<a name="IDX39"></a>
+<a name="IDX40"></a>
+<p>If you are inserting a new phone-number field, you can control whether
+it is a North American or European phone number by providing a prefix
+argument. A prefix arg of <kbd>^U</kbd> means it's to be a euronumber, and
+any other prefix arg means it's to be a a structured North American
+number. If no prefix argument is supplied, the style used is controlled
+by the variable <code>bbdb-north-american-phone-numbers-p</code>.
+</p>
+</dd>
+<dt> <kbd>C-x C-t</kbd></dt>
+<dd><a name="IDX41"></a>
+<a name="IDX42"></a>
+<a name="IDX43"></a>
+<p>(<code>bbdb-transpose-fields</code>) This is like the <code>transpose-lines</code>
+command, but it is for <b>BBDB</b> fields. If the cursor is on a field of
+a <b>BBDB</b> record, that field and the previous field will be
+transposed.
+</p>
+<p>With non-zero numeric argument <var>ARG</var>, the previous field is moved
+past <var>ARG</var> fields. With argument 0, the field indicated by
+<i>point</i> is interchanged with the one indicated by <i>mark</i>.
+</p>
+<p>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-number
+fields are listed, but you can't use it to make an address appear before a
+phone number; the order of field types is fixed.)
+</p>
+</dd>
+<dt> <kbd>n, p</kbd></dt>
+<dd><a name="IDX44"></a>
+<a name="IDX45"></a>
+<p>(<code>bbdb-next-record</code>, <code>bbdb-prev-record</code>) Move to the next and
+previous displayed record, respectively.
+</p>
+</dd>
+<dt> <kbd>t</kbd></dt>
+<dd><a name="IDX46"></a>
+<p>(<code>bbdb-toggle-records-display-layout</code>) Toggles the display layout of a
+record. With a numeric argument
+of 0, the current record will be made displayed in one line layout; with any
+other argument, the current record will be shown in multi-line layout.
+</p>
+<p>If <kbd>*t</kbd> is used instead of simply <kbd>t</kbd>, then the state of all
+records will be changed instead of just the one at point. In this case,
+a numeric argument of 0 means that all records will unconditionally be
+made one-line layout; any other numeric argument means that all of the records
+will unconditionally be shown expanded; and no numeric argument means
+that the records are made to be in the opposite state of the record
+under point.
+</p>
+</dd>
+<dt> <kbd>T</kbd></dt>
+<dd><a name="IDX47"></a>
+<p>(<code>bbdb-display-record-completely</code>)
+Show all the fields of the current record.
+The display layout `full-multi-line' is used for this.
+
+</p>
+</dd>
+<dt> <kbd>o</kbd></dt>
+<dd><a name="IDX48"></a>
+<p>(<code>bbdb-omit-record</code>) Removes the current record from the display,
+but does not delete it from the database; it merely makes it seem as if
+the most recent search had not matched this record. With a numeric
+argument, omit the next N records. With a negative argument, go
+backwards.
+</p>
+</dd>
+<dt> <kbd>m</kbd></dt>
+<dd><a name="IDX49"></a>
+<a name="IDX50"></a>
+<a name="IDX51"></a>
+<p>(<code>bbdb-send-mail</code>) Begin composing mail to the person represented
+by the current record. The first email address is used. Normally, the
+mail-sending package which is used is determined by which mail-reading
+package is loaded; that is, if <b>MH-E</b> is loaded, then <code>mh-send</code>
+will be used; if <b>VM</b> is loaded, then <code>vm-mail</code> is used; if
+<b>message</b> is loaded, then it is used; otherwise, <code>mail</code> is used.
+You can override this by setting the variable
+<code>bbdb-send-mail-style</code> to one of the symbols <code>vm</code>, <code>mh</code>,
+<code>message</code>, or <code>mail</code>.
+</p>
+<p>If <kbd>*m</kbd> is used instead of simply <kbd>m</kbd>, then mail will be sent to
+all of the folks listed in the <samp>`*BBDB*'</samp> buffer instead of just the
+person under point.
+</p>
+<p>This function does not at present use the facility provided by
+<code>compose-mail</code> and <code>mail-user-agent</code>. In a future version of
+the <b>BBDB</b>, it will.
+</p>
+</dd>
+<dt> <kbd>s, C-x C-s</kbd></dt>
+<dd><a name="IDX52"></a>
+<a name="IDX53"></a>
+<p>(<code>bbdb-save-db</code>) Saves the <b>BBDB</b> file to disk.
+</p>
+</dd>
+<dt> <kbd>r</kbd></dt>
+<dd><a name="IDX54"></a>
+<a name="IDX55"></a>
+<a name="IDX56"></a>
+<p>(<code>bbdb-refile-record</code>) Merge the current record into some other record;
+that is, delete the record under point after copying all of the data
+within it into some other record. this is useful if you realize that
+somehow a redundant record has gotten into the database, and you want to
+merge it with another.
+</p>
+<p>If both records have names and/or companies, you are asked which to use.
+Phone numbers, addresses, and network addresses are simply concatenated.
+The first record is the record under the point; the second is prompted
+for. Completion behavior is as dictated by the variable
+<code>bbdb-completion-type</code>.
+</p>
+</dd>
+<dt> <kbd>M-d</kbd></dt>
+<dd><a name="IDX57"></a>
+<a name="IDX58"></a>
+<p>(<code>bbdb-dial</code>) This command will attempt to dial the phone number
+currently at point, or if point is at the start of a record, the first
+phone number in the record. An extension, if present, is disregarded.
+
+</p>
+<p>The method of dialling is controlled by <code>bbdb-modem-dial</code>. If this
+variable is nil, the <b>BBDB</b> will play touchtones corresponding to the
+number to be dialled. Otherwise, this variable is treated as a modem
+command string to be prepended to the number prior to feeding it to
+<code>bbdb-modem-device</code>.
+</p>
+<p>The <b>BBDB</b> plays touchtones using <code>bbdb-sound-player</code> to play the
+sounds and the elements of <code>bbdb-sound-files</code> as the audio to be
+played. The first ten elements of <code>bbdb-sound-files</code> correspond to
+the touchtones for the digits <samp>`0'</samp> to <samp>`9'</samp>, while the eleventh
+and twelfth elements correspond to <samp>`#'</samp> and <samp>`*'</samp>
+respectively. The default configuration assumes a Solaris[tm]
+installation with the demonstration sound files in
+<code>/usr/demo/SOUND/sounds</code>.
+</p>
+<p>The actual number dialled depends on the following variables:
+</p>
+<dl compact="compact">
+<dt> <code>bbdb-dial-local-prefix-alist</code> </dt>
+<dd><a name="IDX59"></a>
+<p>This is a list of (SEXPR REPLACEMENT) pairs. SEXPR is evaluated to
+produce a regular expression which is then applied to the number. If it
+matches, whatever it matches is replaced by REPLACEMENT. The match and
+replace is performed using each item in the list that matches, in
+sequence, so that the output from one item may become input to another.
+The default value for this variable is to remove
+<code>(bbdb-default-area-code)</code> (i.e. the value of that variable, in
+parenthesis) from the start of the number to be dialled.
+</p>
+<p><b>Note:</b> If this procedure produces a transformed number then no
+further modifications (such as prefix additions, below) will be made to
+the number before dialling.
+</p>
+<p>Using a prefix argument to <code>bbdb-dial</code> disables the processing of
+this variable. The other modifiers, below, are not affected by
+this.
+</p>
+</dd>
+<dt> <code>bbdb-dial-local-prefix</code></dt>
+<dd><a name="IDX60"></a>
+<p>If the number to be dialled starts with a zero, it is deemed to be a
+local number, and <code>bbdb-dial-local-prefix</code> is prepended to it (see
+note above concerning <code>bbdb-dial-local-prefix-alist</code> processing,
+however).
+</p>
+</dd>
+<dt> <code>bbdb-dial-long-distance-prefix</code></dt>
+<dd><a name="IDX61"></a>
+<p>If the number to be dialled starts with a plus sign (+), it is deemed to
+be a long distance number, and <code>bbdb-dial-long-distance-prefix</code> is
+prepended to it (see note above concerning
+<code>bbdb-dial-local-prefix-alist</code> processing, however).
+</p>
+</dd>
+</dl>
+
+</dd>
+<dt> <kbd>f</kbd></dt>
+<dd><a name="IDX62"></a>
+<a name="IDX63"></a>
+<p>(<code>bbdb-finger</code>) This command fingers the network address of a
+<b>BBDB</b> record. If this command is executed from the <samp>`*BBDB*'</samp> buffer,
+it fingers the network address of the record which is at point; otherwise,
+it prompts in the minibuffer (with completion) for a user to finger. With a
+numeric prefix argument, it fingers the <i>N</i>th network address of the
+current record; with a prefix argument of <kbd>^U</kbd>, it fingers all of them.
+The <samp>`*finger*'</samp> buffer is filled asynchronously, meaning that you don't
+have to wait around for it to finish; but fingering another user before
+the first finger has finished could have unpredictable results.
+</p>
+<p>If this command is executed from the <samp>`*BBDB*'</samp> buffer, it may be prefixed
+with <kbd>*</kbd> (as in <kbd>*f</kbd> instead of simply <kbd>f</kbd>), meaning to
+finger all of the users currently listed instead of just the one under
+point. The numeric prefix argument has the same interpretation.
+</p>
+<a name="IDX64"></a>
+<p>You can define a special network address to &quot;finger&quot; by defining a field
+<code>finger-host</code>. The name of the field to be fingered can be changed
+by setting <code>bbdb-finger-host-field</code>.
+</p>
+</dd>
+<dt> <kbd>q</kbd></dt>
+<dd><a name="IDX65"></a>
+<p>(<code>bbdb-bury-buffer</code>) Hides the <samp>`*BBDB*'</samp> buffer. <b>Note:</b>
+This command does <b>not</b> kill the <samp>`*BBDB*'</samp> buffer.
+</p>
+</dd>
+<dt> <kbd>?</kbd></dt>
+<dd><a name="IDX66"></a>
+<p>(<code>bbdb-help</code>) This displays a one-line help message in the
+minibuffer, showing some of the most common bbdb-mode commands.
+</p>
+</dd>
+<dt> <kbd>i</kbd></dt>
+<dd><a name="IDX67"></a>
+<p>(<code>bbdb-info</code>) This documentation is displayed. Please note that
+either <tt>`bbdb'</tt> or <tt>`bbdb.info'</tt> must be installed in one of the
+info directories known to Emacs for this command to work.
+</p>
+<dl compact="compact">
+<dt> <code>bbdb-info-file</code></dt>
+<dd><a name="IDX68"></a>
+<p>If this documentation is not installed in the standard Info directory,
+then you should set this variable to the name of the texinfo-formatted
+version of this file; the <code>bbdb-info</code> command will use this file
+instead.
+</p></dd>
+</dl>
+
+</dd>
+<dt> <kbd>W</kbd></dt>
+<dd><a name="IDX69"></a>
+<a name="IDX70"></a>
+<p>(<code>bbdb-www</code>) Displays the Web page listed in the <code>www</code> field
+of the current record. See section <a href="#SEC57">Using the <b>BBDB</b> with Web Browsers</a>.
+</p>
+</dd>
+<dt> <kbd>P</kbd></dt>
+<dd><a name="IDX71"></a>
+<a name="IDX72"></a>
+<p>(<code>bbdb-print</code>) Creates a TeX file that contains a pretty-printed version
+of <b>BBDB</b> records. If prefixed by <kbd>*</kbd>, only the records currently
+displayed will print. See section <a href="#SEC64"><code>bbdb-print</code></a>.
+</p>
+</dd>
+<dt> <kbd>h</kbd></dt>
+<dd><a name="IDX73"></a>
+<p>Moves point to another window via the <code>other-window</code> function.
+</p>
+</dd>
+<dt> <kbd>c</kbd></dt>
+<dd><a name="IDX74"></a>
+<a name="IDX75"></a>
+<p>(<code>bbdb-create</code>) Create a new database record from information
+supplied by the user.
+</p>
+</dd>
+<dt> <kbd>C</kbd></dt>
+<dd><a name="IDX76"></a>
+<a name="IDX77"></a>
+<p>(<code>bbdb-changed</code>) Display all records that have been changed since
+the last time the database was saved.
+</p>
+</dd>
+<dt> <kbd>b</kbd></dt>
+<dd><a name="IDX78"></a>
+<a name="IDX79"></a>
+<p>(<code>bbdb</code>) Begin a new database search. The results of the new
+search will be displayed in place of the results of the old search.
+</p>
+</dd>
+<dt> <kbd>S a, S c, S o, S n</kbd></dt>
+<dd><a name="IDX80"></a>
+<a name="IDX81"></a>
+<a name="IDX82"></a>
+<a name="IDX83"></a>
+<a name="IDX84"></a>
+<p>(<code>bbdb-net</code>, <code>bbdb-company</code>, <code>bbdb-notes</code>,
+<code>bbdb-name</code>)<br>
+Begin a new database search. This search will be
+limited to the net address, company, notes, or name fields,
+respectively, of database records. See section <a href="#SEC30">Basic searching commands</a>. for more
+details.
+</p>
+</dd>
+<dt> <kbd>*</kbd></dt>
+<dd><a name="IDX85"></a>
+<p><code>bbdb-append-records</code> will make the next display/search
+command to append its results to the BBDB buffer instead of replacing its
+content.
+</p>
+<p>With an prefix arg (C-u) toggle between always append and no append.
+With an prefix arg that is a positive number append will be enabled for that
+many times.
+With any other argument append will be enabled once.&quot;
+</p>
+</dd>
+</dl>
+
+<hr size="6">
+<a name="SEC35"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC34" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC36" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC33" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.3.2 Other database manipulation functions </h3>
+
+<dl compact="compact">
+<dd><a name="IDX86"></a>
+</dd>
+<dt> <code>bbdb-kill-older</code></dt>
+<dd><p>If called interactively (or with a single argument - a date in
+<samp>`yyyy-mm-dd'</samp> format), it will kill all records that were last
+modified before the given date as determined by the <code>timestamp</code>
+field. See section <a href="#SEC61">Predefined Hooks</a>. If called non-interactively with a
+date (in <samp>`yyyy-mm-dd'</samp> format), a comparison function and an action
+function, the comparison function is applied to the <code>timestamp</code>
+field of all records, and the action function applied to those for whom
+the comparison function returns true. If <samp>`nil'</samp> is supplied as the
+comparison function, <code>string-lessp</code> is used.
+</p>
+</dd>
+</dl>
+
+<hr size="6">
+<a name="Interfaces"></a>
+<a name="SEC36"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC35" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC37" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.4 Interfaces </h2>
+
+<p>The <b>BBDB</b> interfaces itself with several message-handling packages, but
+certain parameters control its behavior depending on whether it is
+being used from within a mail reader or a news reader.
+</p>
+<p>In all of these packages, two new keybindings will be added:
+</p>
+<dl compact="compact">
+<dt> <kbd>:</kbd></dt>
+<dd><a name="IDX87"></a>
+<a name="IDX88"></a>
+<a name="IDX89"></a>
+<a name="IDX90"></a>
+<a name="IDX91"></a>
+<p>(<code>bbdb/<i>package</i>-show-sender</code>) Displays the <b>BBDB</b> entry corresponding
+to the author of the current message. If there is none, you will be
+asked whether to create one. The function called is
+<code>bbdb/<i>package</i>-show-sender</code>, where <code><i>package</i></code> is either
+<code>gnus</code>, <code>mh</code>, <code>rmail</code>, or <code>vm</code>, depending on the
+mail or news program being used when the command is invoked.
+</p>
+</dd>
+<dt> <kbd>;</kbd></dt>
+<dd><a name="IDX92"></a>
+<a name="IDX93"></a>
+<a name="IDX94"></a>
+<a name="IDX95"></a>
+<a name="IDX96"></a>
+<p>(<code>bbdb/<i>package</i>-annotate-sender</code>) Lets you edit the <samp>`notes'</samp>
+field of the <b>BBDB</b> record corresponding to the sender of the current
+message. If there is no record for the current author, you will be
+asked whether to create one. The function called is
+<code>bbdb/<i>package</i>-annotate-sender</code>, where <code><i>package</i></code> is
+either <code>gnus</code>, <code>mh</code>, <code>rmail</code>, or <code>vm</code>, depending on
+the mail or news program being used when the command is invoked.
+</p></dd>
+</dl>
+
+<p>These keybindings (and several other features) will not be
+available unless you call the appropriate &quot;insinuation&quot;
+function; See section <a href="#SEC2">Installation</a>.
+</p>
+<p>It is possible to configure <b>BBDB</b> so that it automatically creates a
+record when it sees a message from a person who is not in the database.
+It is also possible to have text automatically added to the notes field
+of the corresponding record depending on the contents of the message
+headers. See section <a href="#SEC60">Customization Hooks</a>.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC37">1.4.1 Mail Reading Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC38">1.4.2 News Reading Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC39">1.4.3 Mail Sending Interfaces</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+</table>
+
+<hr size="6">
+<a name="Mail-Reading-Interfaces"></a>
+<a name="SEC37"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC36" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC38" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC36" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.4.1 Mail Reading Interfaces </h3>
+
+<p>There are BBDB interfaces for the following mail readers:
+</p>
+<ul>
+<li>
+<b>Gnus</b>, a news- and email- reader written by Lars Magne Ingebrigtsen
+(based on <b>GNUS</b> by Mansanobu Umeda).
+</li><li>
+<b>MH-E</b>, the Emacs interface to <b>Mail Handler</b> (<b>MH</b>), from the
+standard emacs library, but packaged separately from XEmacs since
+version 20.4.
+</li><li>
+<b>RMAIL</b>, from the standard emacs library (packaged separately for
+XEmacs users as of 20.4);
+</li><li>
+<b>View Mail</b>, by Kyle Jones, version 5.31 or newer;
+</li></ul>
+
+<hr size="6">
+<a name="News-Reading-Interfaces"></a>
+<a name="SEC38"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC37" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC39" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC36" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.4.2 News Reading Interfaces </h3>
+
+<p>There are BBDB interfaces for the following news readers:
+</p>
+<ul>
+<li>
+<b>GNUS</b>, a newsreader written by Masanobu Umeda.
+</li><li>
+<b>Gnus</b>, the modern news- and email-reading incarnation of <b>GNUS</b>.
+<b>Gnus</b> is written by Lars Magne Ingebrigtsen.
+</li></ul>
+
+<hr size="6">
+<a name="Mail-Sending-Interfaces"></a>
+<a name="SEC39"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC38" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC40" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC36" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.4.3 Mail Sending Interfaces </h3>
+
+<p>When sending mail, the keystroke <kbd>M-TAB</kbd> is bound to the
+function <code>bbdb-complete-name</code>. This will take the string that
+you have typed (from point back to the preceding colon, comma, or
+the beginning of the line) and will complete that against the
+contents of the database. What you have typed may be an initial
+subsequence of a person's full name or network address; if it
+completes ambiguously, then what you have typed will be replaced
+with the common portion of the matches. Typing <kbd>M-TAB</kbd> again will
+show a list of possible completions. If it completes unambiguously,
+then an address will be inserted. The variable
+<code>bbdb-completion-type</code> controls whether completion is done on real
+names, or network addresses, or both. The address inserted is normally
+of the form <code>User Name &lt;email-address&gt;</code>; however, if
+<code>User Name</code> has an address of the form
+<code>&lt;user.name@somedomain&gt;</code>, only the <code>&lt;email-address&gt;</code> portion
+is inserted. This can be overridden by setting
+<code>bbdb-dwim-net-address-allow-redundancy</code> to <code>t</code>.
+</p>
+<p>This binding is automatically set by the various insinuation functions
+documented earlier in this manual. (See section <a href="#SEC13">Initial Configuration</a>.)
+Briefly, the forms for these functions are:
+</p>
+<dl compact="compact">
+<dt> <b>Gnus</b></dt>
+<dd><p><code>(add-hook 'gnus-Startup-hook 'bbdb-insinuate-gnus)</code> <i>for Gnus 3.14 or older</i><br>
+<code>(add-hook 'gnus-startup-hook 'bbdb-insinuate-gnus)</code> <i>for Gnus 3.15 or newer</i>
+</p></dd>
+<dt> <b>MH-E</b></dt>
+<dd><p><code>(add-hook 'mh-folder-mode-hook 'bbdb-insinuate-mh)</code>
+</p></dd>
+<dt> <b>RMAIL</b></dt>
+<dd><p><code>(add-hook 'rmail-mode-hook 'bbdb-insinuate-rmail)</code>
+</p></dd>
+<dt> <b>sendmail</b></dt>
+<dd><p><code>(add-hook 'mail-setup-hook 'bbdb-insinuate-sendmail)</code>
+</p></dd>
+<dt> <b>VM</b></dt>
+<dd><p><code>(bbdb-insinuate-vm)</code> <i>Add to <tt>`~/.vm'</tt> file</i>
+</p></dd>
+</dl>
+
+
+<p>The above forms should be added to your Emacs initialization file,
+except where otherwise noted.
+</p>
+<p>You can control what &quot;real name&quot; is inserted with the
+<code>mail-alias</code> field: if a record has a <code>mail-alias</code>
+field, then that is used instead of their <code>name</code> field.
+</p>
+<a name="IDX97"></a>
+<p>If the variable <code>bbdb-completion-display-record</code> is true (the
+default) then when you successfully complete an address with
+<kbd>M-TAB</kbd>, the corresponding record will be appended to
+the <samp>`*BBDB*'</samp> buffer. The buffer will not be displayed if it
+is not already visible, but the record will be displayed there.
+</p>
+<a name="IDX98"></a>
+<a name="IDX99"></a>
+<p>When sending mail, you can use the command <code>bbdb-yank-addresses</code>
+to CC the current message to the people currently displayed in
+the <samp>`*BBDB*'</samp> buffer. This is useful if you are in the midst of
+sending or replying to a message, and you decide to add some recipients.
+You can use one of the <kbd>M-x bbdb</kbd> commands to display the set of
+people that you want to CC the message to, and then execute this command
+to add them to the list.
+</p>
+<hr size="6">
+<a name="SEC40"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC39" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC41" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC36" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="unnumberedsubsec"> Mailing Lists and Mail Aliases </h3>
+
+
+<p>If you are using Jamie Zawinski's <tt>`mail-abbrevs.el'</tt> package, which
+uses the word-abbrev mechanism for mail aliases, then you can store your
+mail aliases in the BBDB instead of duplicating the information
+elsewhere.
+</p>
+<p>If you want a mail alias to be defined for a person, simply add a
+<code>mail-alias</code> field to their record. You may have multiple aliases
+for the same person; simply separate them with commas.
+</p>
+<p>For convenience there is the function <code>bbdb-add-or-remove-mail-alias</code>
+bound to <kbd>a</kbd> which adds an alias to one or multiple records when prefixed
+by a <kbd>*</kbd>. Called with a prefix argument <kbd>C-u</kbd> it will remove
+the given alias.
+</p>
+<p>If more than one person has the same mail-alias, then that alias expands
+to the addresses of all of those people; in this way you can maintain
+mailing lists within the BBDB.
+</p>
+<p>When you want to group aliases as in <code>.mailrc</code> you may just
+retained the group aliases in your <code>.mailrc</code>.
+</p>
+<p>To actually define the aliases which are stored in the BBDB, call the
+function <code>bbdb-define-all-aliases</code> from your
+<code>mail-setup-hook</code> (or <code>message-setup-hook</code> if you use
+Message mode coming with Gnus). This will search the database, and
+call <code>define-mail-alias</code> to define each of the resulting
+aliases.
+</p>
+<hr size="6">
+<a name="Reader_002dspecific-Features"></a>
+<a name="SEC41"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC40" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC42" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.5 Reader-specific Features </h2>
+
+<p>There are features of the <b>BBDB</b> that are available only for specific
+mail- and news-readers. These features are described below.
+</p>
+<p>The headers which are parsed for email addresses and what records are
+displayed can be controlled by the following variables:
+<a name="IDX100"></a>
+<a name="IDX101"></a>
+<a name="IDX102"></a>
+<a name="IDX103"></a>
+<code>bbdb-get-addresses-from-headers</code> controls which headers are parsed
+for sender addresses when calling the show-sender function of your MUA.
+<code>bbdb-get-addresses-to-headers</code> controls which headers are parsed
+for recipients addresses when calling the show-all-recipients function
+of your MUA. When using the pop up feature it will search for the
+addresses in <code>bbdb-get-addresses-headers</code> and display them. By
+default it will list only the first address, but by setting
+<code>bbdb-get-only-first-address-p</code> to <code>nil</code> one will will get
+records for all addresses.
+</p>
+<p>If there is no MUA specific variable for ignoring certain addresses then
+those addresses matching <code>bbdb-user-mail-names</code> will be ignored.
+</p>
+<p><b>BBDB</b> adds the bindings <kbd>:</kbd> for showing all senders and <kbd>;</kbd>
+for editing the notes of the sender.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC42">1.5.1 Gnus-specific Features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC48">1.5.2 VM-specific features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> VM-specific Features
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="Gnus-Features"></a>
+<a name="SEC42"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC41" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC43" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC41" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.5.1 Gnus-specific Features </h3>
+
+<p>The <b>BBDB</b> can be used to provide score information, or to integrate
+database information into the <b>Gnus</b> Summary buffer or the <b>GNUS</b>
+Subject List.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC43">1.5.1.1 Scoring</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Store score adjustments in the <b>BBDB</b>
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC44">1.5.1.2 Gnus Summary Buffer Enhancements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> <b>BBDB</b> information in the Summary buffer
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> <b>BBDB</b> information in the Subject List
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="Gnus-Scoring"></a>
+<a name="SEC43"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC42" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC44" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC42" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.1.1 Scoring </h4>
+
+<p>The <b>BBDB</b> can provide scoring information to <b>Gnus</b> in one of two
+ways.
+</p>
+<ol>
+<li>
+Articles whose authors appear in the <b>BBDB</b> and who have
+<code>gnus-score</code> fields will have their scores adjusted by the value
+contained in that field.
+</li><li>
+Articles whose authors appear in the <b>BBDB</b> but who do not have
+<code>gnus-score</code> fields will have their scores adjusted by
+<code>bbdb/gnus-score-default</code>. If <code>bbdb/gnus-score-default</code> is
+<code>nil</code>, no score adjustment will be made.
+</li></ol>
+
+<p>The <b>BBDB</b> by default searches the field contained in
+<code>bbdb/gnus-score-field</code> for score values. To have the <b>BBDB</b> use
+a different field, change the value of this variable.
+</p>
+<p>To enable <b>BBDB</b>-assisted scoring, add the <code>bbdb/gnus-score</code>
+function to <code>gnus-score-find-score-files-function</code>. Assuming that
+you want to preserve the default value of this variable, use a form
+similar to the following:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(setq gnus-score-find-score-files-function
+ '(gnus-score-find-bnews bbdb/gnus-score))
+</pre></td></tr></table>
+<p><b>Note:</b> The default value in <b>Gnus</b> 5.5 is <code>gnus-score-find-bnews</code>.
+Check your configuration before using the above code, as your values may
+be different.
+</p>
+<hr size="6">
+<a name="Gnus-Summary-Buffer"></a>
+<a name="SEC44"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC43" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC47" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC42" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.1.2 Gnus Summary Buffer Enhancements </h4>
+
+<p><b>Gnus</b> can use the <b>BBDB</b> to do one of two things:
+</p>
+<ul>
+<li>
+Mark authors in the Summary Buffer who have records in the <b>BBDB</b> with
+a user-defined mark character. See Marking Posters, below.
+</li><li>
+For authors in the Summary Buffer who also have records in the <b>BBDB</b>,
+replace their name as listed in the Summary Buffer with their name as
+stored in the <b>BBDB</b>. See Using Names from the <b>BBDB</b>, below.
+</li></ul>
+
+<a name="SEC45"></a>
+<h4 class="subsubheading"> Marking Posters </h4>
+
+<p>Authors with records in the <b>BBDB</b> can be marked either with a
+user-defined mark character, or with a default one. The marking is
+enabled by the use of a Gnus user format code, as determined by
+<code>bbdb/gnus-summary-in-bbdb-format-letter</code>. This variable, which
+defaults to <samp>`b'</samp>, is used to create a format code which is intended
+for use in <code>gnus-summary-line-format</code>. The format code is created
+by concatenating <samp>`%u'</samp> with the value of
+<code>bbdb/gnus-summary-in-bbdb-format-letter</code>. In the default case
+this results in the creation of the format code <samp>`%ub'</samp>.
+</p>
+<p>Posts are marked as follows: If the record for the poster has the field
+indicated in <code>bbdb-message-marker-field</code> (the default is
+<code>mark-char</code>), the value of that field is used as the mark
+character.<a name="DOCF5" href="bbdb_fot.html#FOOT5">(5)</a> If no such field is present, the value of
+<code>bbdb/gnus-summary-known-poster-mark</code> will be used instead. If the
+author is not in the <b>BBDB</b>, a space will be used as the mark character.
+</p>
+<a name="SEC46"></a>
+<h4 class="subsubheading"> Using Names from the <b>BBDB</b> </h4>
+
+<p>The names reported for authors of posts in the Summary buffer can be
+altered to conform to the values present in their respective <b>BBDB</b>
+records (if any). This rewriting is enabled by the use of a Gnus user
+format code, as determined by
+<code>bbdb/gnus-summary-user-format-letter</code>. This variable, which
+defaults to <samp>`B'</samp>, is used to create a format code which is intended
+for use in <code>gnus-summary-line-format</code>. The format code is created
+by concatenating <samp>`%u'</samp> with the value of
+<code>bbdb/gnus-summary-user-format-letter</code>. In the default case this
+results in the creation of the format code <samp>`%uB'</samp>. This format code
+is intended to <b>replace</b> the format code previously used in the Summary
+buffer format line to indicate the author and/or net address (usually
+<samp>`%a'</samp>, <samp>`%n'</samp>, and/or <samp>`$N'</samp>).
+</p>
+<p>The effects of this format code are in two independent parts - the
+marking of known posters, and the rewriting of posters names. The
+first, the marking of posters, occurs only when
+<code>bbdb/gnus-summary-mark-known-posters</code> is <code>t</code> (the default)
+and the posters have entries in the <b>BBDB</b>. When this variable is
+true, the marking occurs as described in the previous section, Marking
+Posters, above.
+</p>
+<p>The poster name rewriting is done for all posters - not just for those
+with records in the <b>BBDB</b>. That said, rewriting rules for posters in
+the <b>BBDB</b> are more flexible than for those not listed. The rewriting is
+governed by two variables, as described below.
+</p>
+<p><code>bbdb/gnus-summary-prefer-real-names</code> can have one of three values -
+<samp>`t'</samp>, <samp>`bbdb'</samp>, or <code>nil</code>. In general, this variable governs
+the preference between net addresses and names. If it is <samp>`t'</samp>, the
+name (if any) will be used. If <samp>`nil'</samp>, the net address will be
+used. The third value, <samp>`bbdb'</samp>, can be used as a method for
+distinguishing between authors with records in the <b>BBDB</b> and those
+without. If the variable is set to <samp>`bbdb'</samp>, the name from the
+<b>BBDB</b> record will be used if the author has a record in the
+<b>BBDB</b>. If the author is not in the <b>BBDB</b>, the net address from
+the message will be printed. This variable makes little sense if
+<code>bbdb/gnus-summary-prefer-bbdb-data</code> is <samp>`nil'</samp>, as no names
+will be printed in the Summary buffer in this case - only net addresses.
+</p>
+<p><code>bbdb/gnus-summary-prefer-bbdb-data</code> is used to (dis)allow use of
+the <b>BBDB</b> for author data retrieval. If it is <samp>`t'</samp>, data from
+the <b>BBDB</b> will be used if available. If it is <samp>`nil'</samp>, data from
+the <b>BBDB</b> will not be used.
+</p>
+
+<p>In the following examples, assume the following:
+</p>
+<ol>
+<li>
+Message: <code>From: Jamie &lt;jwz@netscape.com&gt;</code><br>
+<b>BBDB</b>: No record
+</li><li>
+Message: <code>From: Matt &lt;simmonmt@acm.org&gt;</code><br>
+<b>BBDB</b>: Name: <samp>`Matthew'</samp>, Net: <samp>`simmonmt@purdue.edu'</samp>
+</li></ol>
+
+<table>
+<tr><td><p> <code>bbdb/gnus-summary-prefer-bbdb-data</code>
+</p></td><td> <p align="center"> <code>t</code>
+</p></td><td> <p align="center"> <code>t</code>
+</p></td><td> <p align="center"> <code>nil</code>
+</p></td></tr>
+<tr><td><p> <code>bbdb/gnus-summary-prefer-real-names</code>
+</p></td><td> <p align="center"> <code>t</code>
+</p></td><td> <p align="center"> <code>bbdb</code>
+</p></td><td> <p align="center"> <code>t</code>
+</p></td></tr>
+<tr><td><p> Printed in Summary buffer for
+</p></td><td>
+</td><td>
+</td><td>
+</td></tr>
+<tr><td> <p align="center"> Case 1
+</p></td><td> <p align="center"> Jamie
+</p></td><td> <p align="center"> jwz@netscape.com
+</p></td><td> <p align="center"> Jamie
+</p></td></tr>
+<tr><td> <p align="center"> Case 2
+</p></td><td> <p align="center"> Matthew
+</p></td><td> <p align="center"> Matthew
+</p></td><td> <p align="center"> Matt
+</p></td></tr>
+</table>
+
+<hr size="6">
+<a name="GNUS-Subject-List"></a>
+<a name="SEC47"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC44" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC48" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC42" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.1.3 GNUS Summary Buffer Enhancements </h4>
+
+<p><i>This section is remarkably terse, as I don't have a copy of <b>GNUS</b>.
+If anybody can provide more descriptive information, please let me
+know.</i>
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(autoload 'bbdb/gnus-lines-and-from &quot;bbdb-gnus&quot;)
+(setq gnus-optional-headers 'bbdb/gnus-lines-and-from)
+</pre></td></tr></table>
+<dl compact="compact">
+<dt> <code>bbdb/gnus-mark-known-posters</code></dt>
+<dd><a name="IDX104"></a>
+<a name="IDX105"></a>
+<p>If <code>t</code> (the default), then the <b>GNUS</b> subject list will contain an
+indication of those messages posted by people who have entries in
+the Insidious Big Brother Database (they will be marked with an
+asterisk.)
+</p>
+<a name="IDX106"></a>
+<p>You can change the character used to mark records on a record-by-record
+basis by adding a <code>mark-char</code> property to the record, whose value
+is be the string to display (preferably one character.)
+</p>
+</dd>
+<dt> <code>bbdb/gnus-header-prefer-real-names</code></dt>
+<dd><a name="IDX107"></a>
+<p>Default: <code>nil</code>. if <code>t</code>, then the <b>GNUS</b> subject list will
+display real names instead of network addresses.
+</p>
+</dd>
+<dt> <code>bbdb/gnus-header-show-bbdb-names</code></dt>
+<dd><a name="IDX108"></a>
+<p>Default: <code>t</code>. If both this variable and
+the <code>bbdb/gnus-header-prefer-real-names</code> variable are true, then
+for news messages from people who are in your database, the name displayed
+will be the primary name from the database, rather than the one from
+the <samp>`From:'</samp> line of the message. This doesn't affect the names of
+people who aren't in the database, of course.
+</p>
+</dd>
+<dt> <code>bbdb/gnus-lines-and-from-length</code></dt>
+<dd><a name="IDX109"></a>
+<p>Default: 18. The number of characters used to display <samp>`From:'</samp> info in
+<b>GNUS</b>, if you have set <code>gnus-optional-headers</code> to
+<code>bbdb/gnus-lines-and-from</code>.
+</p></dd>
+</dl>
+
+<hr size="6">
+<a name="VM-Features"></a>
+<a name="SEC48"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC47" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC49" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC41" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.5.2 VM-specific features </h3>
+
+<p>The <b>BBDB</b> can be used to integrate database information into the
+message summary.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC49">1.5.2.1 VM Message Summary Enhancements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> <b>BBDB</b> information in message summary
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC50">1.5.2.2 VM configuration of what records the <b>BBDB</b> buffer shows</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC51">1.5.2.3 VM automatic setup of <code>vm-set-auto-folder-alist</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC52">1.5.2.4 VM automatic adding of labels</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="VM-Message-Summary"></a>
+<a name="SEC49"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC48" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC50" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC48" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.2.1 VM Message Summary Enhancements </h4>
+
+<p>VM users can cause their summary buffer to display the name of the
+message sender according to <b>BBDB</b> data, instead of according to the
+contents of the current message's headers. In VM 5.40 or later, use
+the summary format control <code>%UB&quot;</code> instead of <code>&quot;%F&quot;</code>, and the
+current record name will be shown there if available. If no entry is
+found it behaves like <code>&quot;%F&quot;</code>. See the documentation for
+<code>vm-summary-format</code> for more details. Warning, this may
+significantly slow down summary generation for large folders.
+</p>
+<hr size="6">
+<a name="VM-what-records-are-displayed"></a>
+<a name="SEC50"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC49" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC51" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC48" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.2.2 VM configuration of what records the <b>BBDB</b> buffer shows </h4>
+
+
+<p>Email addresses which match <code>vm-summary-uninteresting-senders</code> are
+ignored.
+</p>
+<p>The records in the <b>BBDB</b> buffer are listed in the same order as found.
+</p>
+<hr size="6">
+<a name="VM-automatic-setup-of-vm_002dset_002dauto_002dfolder_002dalist"></a>
+<a name="SEC51"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC50" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC52" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC48" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.2.3 VM automatic setup of <code>vm-set-auto-folder-alist</code> </h4>
+
+<p>VM users can setup the <code>vm-set-auto-folder-alist</code> automatically by
+calling <code>bbdb/vm-set-auto-folder-alist</code>. This adds for each <b>BBDB</b>
+record containing a <code>bbdb/vm-set-auto-folder-alist-field</code> an entry
+to <code>vm-set-auto-folder-alist</code>.
+</p>
+<p>The record field can contain a string which is used as folder name or
+if it starts with a <code>'</code> it is treated as lisp expression returning
+a folder name.
+</p>
+<hr size="6">
+<a name="VM-automatic-adding-of-labels"></a>
+<a name="SEC52"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC51" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC53" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC48" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.5.2.4 VM automatic adding of labels </h4>
+
+
+<p><code>bbdb/vm-auto-add-label-list</code> is a
+List used by <code>bbdb/vm-auto-add-label</code> to automatically label messages.
+Each element in the list is either a string or a list of two strings.
+If a single string then it is used as both the field value to check for
+and the label to apply to the message. If a list of two strings, the first
+is the field value to search for and the second is the label to apply.
+</p>
+<p><code>bbdb/vm-auto-add-label-field bbdb-define-all-aliases-field</code> is the
+field used by <code>bbdb/vm-auto-add-label</code> to automatically label messages.
+Value is either a single symbol or a list of symbols of bbdb fields that
+<code>bbdb/vm-auto-add-label</code> uses to check for labels to apply to messages.
+Defaults to <code>bbdb-define-all-aliases-field</code> which is typically
+<code>mail-alias</code>.
+</p>
+<p><code>bbdb/vm-auto-add-label</code> automatically adds labels to messages
+based on the <code>bbdb/vm-auto-add-label-field
+bbdb-define-all-aliases-field</code> field. Add this to
+<code>bbdb-notice-hook</code> and if using VM each message that bbdb notices
+will be checked. If the sender has a value in the
+<code>bbdb/vm-auto-add-label-field</code> in their BBDB record that matches a
+value in <code>bbdb/vm-auto-add-label-list</code> then a VM label will be
+added to the message.
+</p>
+<p>This works great when `bbdb-user-mail-names' is set. As a result mail
+that you send to people (and copy yourself on) is labeled as well.
+</p>
+<hr size="6">
+<a name="Other-Packages"></a>
+<a name="SEC53"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC52" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC54" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.6 Using the <b>BBDB</b> with other packages </h2>
+
+<p>The <b>BBDB</b> adds functionality to several packages. The following sections
+detail these augmentations.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC54">1.6.1 Using the <b>BBDB</b> with Message Mode</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC55">1.6.2 Using the <b>BBDB</b> with Reportmail</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC56">1.6.3 Using the <b>BBDB</b> with Supercite</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC57">1.6.4 Using the <b>BBDB</b> with Web Browsers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+</table>
+
+<hr size="6">
+<a name="Using-Message-Mode"></a>
+<a name="SEC54"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC53" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC55" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC53" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.6.1 Using the <b>BBDB</b> with Message Mode </h3>
+
+<p>At this time, the only feature the <b>BBDB</b> adds to Message mode is the binding
+to <kbd>M-TAB</kbd> which allows for <b>BBDB</b> record completion.
+</p>
+<hr size="6">
+<a name="Using-Reportmail"></a>
+<a name="SEC55"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC54" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC56" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC53" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.6.2 Using the <b>BBDB</b> with Reportmail </h3>
+
+<p>The <b>BBDB</b> can modify the <tt>`reportmail.el'</tt> package to use information
+from <b>BBDB</b> records when identifying the senders or recipients of e-mail
+messages.
+</p>
+<p>In normal operation, Reportmail displays the name and net address sender and
+recipient of incoming messages. The <b>BBDB</b> can be configured to intercept
+and rewrite this information before it appears in the Emacs mode-line. It
+first attempts to rewrite the sender and/or recipient information by
+substituting those addresses with information from the <b>BBDB</b>. Replacement
+information is first sought from the <code>mail-name</code> field in the respective
+<b>BBDB</b> records. If no such field is found, the <code>name</code> field is
+returned. If no <b>BBDB</b> record is found, no rewriting is performed.
+</p>
+<p>The <b>BBDB</b>-Reportmail augmentation is accomplished through the advising of
+the Reportmail <code>display-time-get-field</code> function in order to do
+a-posteriori modification of the returned value. The augmentation uses the
+<code>bbdb/reportmail-alternate-full-name</code> function to retrieve data from the
+<b>BBDB</b> for use in rewriting.
+</p>
+<hr size="6">
+<a name="Using-Supercite"></a>
+<a name="SEC56"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC55" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC57" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC53" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.6.3 Using the <b>BBDB</b> with Supercite </h3>
+
+
+<p>The <b>BBDB</b> can be used with Supercite to store attributions with <b>BBDB</b>
+records. Normally, when a non-default attribution is entered for a given
+message, the entered attribution is used for that message, and is then
+discarded. When the <b>BBDB</b>-Supercite augmentation is enabled, the
+non-default attribution will be added to the record (if any) for the entity
+being cited. This poor explanation sounds complicated, but it's not. If a
+message from <samp>`Jamie Zawinski &lt;jwz@netscape.com&gt;'</samp> is being replied to,
+Supercite will, by default, suggest the citation <samp>`Jamie'</samp>. If the
+non-default citation <samp>`jwz'</samp> is entered, Supercite can save it with the
+<b>BBDB</b> record for <samp>`Jamie Zawinski'</samp> in the <code>attribution</code> field.
+</p>
+
+<p>The field used can be changed by changing the value of
+<code>bbdb/sc-attribution-field</code>.
+</p>
+<hr size="6">
+<a name="Using-Web-Browsers"></a>
+<a name="SEC57"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC56" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC58" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC53" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.6.4 Using the <b>BBDB</b> with Web Browsers </h3>
+
+<p>The <b>BBDB</b>/Web Browser integration is in two parts, one which is
+automatically enabled, and one which must be manually enabled (see section <a href="#SEC27">Initializing <b>BBDB</b> support for Web Browsers</a>). The first feature added is the ability to display the URL
+associated with a given record in a Web Browser. The second is the ability to
+add URLs to <b>BBDB</b> records from within W3, the Emacs Web Browser.
+</p>
+<p>Pressing <kbd>W</kbd> in the <code>*BBDB*</code> buffer while the cursor is positioned
+over a record with a <code>www</code> field will cause the first URL in the field to
+be loaded in a Web Browser. This functionality uses <code>browse-url</code> to
+display URLs - see the documentation for <code>browse-url</code> for information on
+selecting the browser to be used.
+</p>
+<p>If W3 is used, and if the <b>BBDB</b>/W3 functionality has been enabled as
+described in <a href="#SEC27">Initializing <b>BBDB</b> support for Web Browsers</a>, pressing the <kbd>:</kbd> key will add the URL
+currently being displayed in W3 to a user-specified <b>BBDB</b> record.
+</p>
+<hr size="6">
+<a name="Options"></a>
+<a name="SEC58"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC57" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC59" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.7 Options </h2>
+
+<p>There are many variables which control the behavior of the Insidious Big
+Brother Database, and there are many hook-variables which can be used to
+modify its behavior in more complex ways. Several pieces of functionality
+are included which use the hooks in this way.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC59">1.7.1 Customization Parameters</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC60">1.7.2 Customization Hooks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+<tr><td align="left" valign="top"><a href="#SEC61">1.7.3 Predefined Hooks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
+</table>
+
+<hr size="6">
+<a name="Customization-Parameters"></a>
+<a name="SEC59"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC58" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC60" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC58" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.7.1 Customization Parameters </h3>
+
+<dl compact="compact">
+<dt> <code>bbdb-file</code></dt>
+<dd><a name="IDX110"></a>
+<p>The name of the file which contains your personal database. Default:
+<tt>`~/.bbdb'</tt>.
+</p>
+</dd>
+<dt> <code>bbdb-default-area-code</code></dt>
+<dd><a name="IDX111"></a>
+<a name="IDX112"></a>
+<p>The default area code to use when prompting for a new phone number.
+Default: 415. This must be a number, not a string.
+</p>
+</dd>
+<dt> <code>bbdb-north-american-phone-numbers-p</code></dt>
+<dd><a name="IDX113"></a>
+<a name="IDX114"></a>
+<a name="IDX115"></a>
+<p>Whether syntax-checking of phone numbers should be enforced. Default:
+<code>t</code>. This only works for Bell-system phone numbers. If this is true,
+then you can't enter invalid phone numbers, and all phone numbers are
+pretty-printed in the same way. European phone numbers don't have as
+strict a syntax, however, so this is a harder problem for them (on which
+I am punting).
+</p>
+<p>You can have both styles of phone number in your database by providing a
+prefix argument to the <code>bbdb-insert-new-field</code> command.
+</p>
+</dd>
+<dt> <code>bbdb-check-zip-codes-p</code></dt>
+<dd><a name="IDX116"></a>
+<a name="IDX117"></a>
+<a name="IDX118"></a>
+<a name="IDX119"></a>
+<a name="IDX120"></a>
+<a name="IDX121"></a>
+<a name="IDX122"></a>
+<a name="IDX123"></a>
+<p>Whether syntax-checking of zip codes should be enforced. Default:
+<code>t</code>. If this is true, you can't enter invalid zip codes. A zip
+code is valid if it matches one of the regular expressions in the
+variable <code>bbdb-legal-zip-codes</code>.
+</p>
+</dd>
+<dt> <code>bbdb-address-formatting-alist</code></dt>
+<dd><a name="IDX124"></a>
+<a name="IDX125"></a>
+<a name="IDX126"></a>
+<a name="IDX127"></a>
+<p>Controls the display of addresses in the buffer. Each entry in this
+list consists of an identifying function and a formatting function.
+The identifying function must accept an address and return <code>t</code> if
+the associated formatting function is to be used. The formatting
+function must insert the formatted address in the current buffer.
+Identifying functions usually base their decision on the zip code
+format or on the country name. The default entries will format an
+address using continental style if the zip code matches
+<code>bbdb-continental-zip-regexp</code>. If the zip code does not match,
+addresses are formatted in US style.
+</p>
+</dd>
+<dt> <code>bbdb-continental-zip-regexp</code></dt>
+<dd><a name="IDX128"></a>
+<a name="IDX129"></a>
+<a name="IDX130"></a>
+<p>Decides whether an address should be formatted using US or European
+style. If the zip code of an address matches the regular expression,
+the European style is used. This works only if the expression
+<code>(bbdb-address-is-continental . bbdb-format-address-continental)</code>
+is part of <code>bbdb-address-formatting-alist</code>.
+</p>
+</dd>
+<dt> <code>bbdb-electric-p</code></dt>
+<dd><a name="IDX131"></a>
+<a name="IDX132"></a>
+<p>Whether bbdb mode should be <i>&quot;electric&quot;</i> like <code>electric-buffer-list</code>.
+Default: <code>t</code>. What this means is that the BBDB buffer which pops
+up when you use it can be disposed of by pressing the space bar, at
+which point your window configuration will be restored to what it was
+before you invoked the db list. (The <code>bbdb-mode</code> commands still
+work as well.)
+</p>
+<p>There are some problems with electric modes; for example, keyboard
+macros and incremental search don't work. (This is not a bug in BBDB,
+but in <tt>`electric.el'</tt>.)
+</p>
+</dd>
+<dt> <code>bbdb-case-fold-search</code></dt>
+<dd><a name="IDX133"></a>
+<p>Default: the same as <code>case-fold-search</code>. <code>case-fold-search</code> is
+bound to this by <kbd>M-x bbdb</kbd> and related commands. This variable lets
+the case-sensitivity of <kbd>^S</kbd> and of the bbdb searching commands be
+different.
+</p>
+</dd>
+<dt> <code>bbdb/mail-auto-create-p</code></dt>
+<dd><a name="IDX134"></a>
+<p>If this is <code>t</code> (the default), then <b>VM</b>, <b>MH</b>, and <b>RMAIL</b>
+will automatically create new bbdb records for people you receive mail
+from. If this variable is a function name or lambda expression, then it
+is called with no arguments to decide whether an entry should be
+automatically created. You can use this to, for example, not create
+records for messages which have reached you through a particular mailing
+list, or to only create records automatically if the mail has a
+particular subject. See the variables
+<code>bbdb-ignore-most-messages-alist</code> and
+<code>bbdb-ignore-some-messages-alist</code> (See section <a href="#SEC61">Predefined Hooks</a>.)
+</p>
+</dd>
+<dt> <code>bbdb/news-auto-create-p</code></dt>
+<dd><a name="IDX135"></a>
+<a name="IDX136"></a>
+<p>If this is <code>t</code> (default: <code>nil</code>), then <b>GNUS</b> will
+automatically create new <b>BBDB</b> records for people you read messages
+by. If this is a function name or lambda expression, then it is called
+with no arguments to decide whether an entry should be automatically
+created. You can use this to, for example, create or not create
+messages which have a particular subject. See the variable
+<code>bbdb-auto-notes-alist</code> (See section <a href="#SEC61">Predefined Hooks</a>.).
+</p>
+<p>If you want to autocreate messages based on the current newsgroup, it's
+probably a better idea to set this variable to <code>t</code> or <code>nil</code> from your
+<code>gnus-select-group-hook</code> instead.
+</p>
+<p>To automatically remember users in certain groups, you can do something
+like
+</p><table><tr><td>&nbsp;</td><td><pre class="example">(setq gnus-select-group-hook
+'(lambda ()
+(setq bbdb/news-auto-create-p
+(or (string= &quot;some.news.group&quot; gnus-newsgroup-name)
+(string= &quot;other.news.group&quot; gnus-newsgroup-name)))))
+</pre></td></tr></table>
+</dd>
+<dt> <code>bbdb-quiet-about-name-mismatches</code></dt>
+<dd><a name="IDX137"></a>
+<p>If this is false (the default), then <b>BBDB</b> will prompt you when it notices a
+name change, that is, when the &quot;real name&quot; in a message doesn't correspond
+to a record already in the database with the same network address. As in,
+<i>&quot;John Smith &lt;jqs@frob.com&gt;&quot;</i> versus
+<i>&quot;John Q. Smith &lt;jqs@frob.com&gt;&quot;.</i> If this is true, then you will
+not be asked if you want to change it (and it will not be changed.)
+If a number then it is the number of seconds to sit-for while
+displaying the name mismatch.
+
+</p>
+</dd>
+<dt> <code>bbdb-use-alternate-names</code></dt>
+<dd><a name="IDX138"></a>
+<a name="IDX139"></a>
+<a name="IDX140"></a>
+<p>If this is false, then the <b>BBDB</b> will not use the <b>AKA</b> field.
+Otherwise (the default) then the mail and news interfaces will ask you
+if you want to add an alternate name when a name-change is noticed, and
+will ask you whether the new name should be made the primary one.
+Note that if <code>bbdb-quiet-about-name-mismatches</code> is true, you will
+not be asked any questions about alternate names.
+</p>
+</dd>
+<dt> <code>bbdb-readonly-p</code></dt>
+<dd><a name="IDX141"></a>
+<p>If this is true (default: <code>nil</code>), then nothing will attempt to change the
+database implicitly, and you will be prevented from doing it
+explicitly. If you have more than one emacs running at the same time,
+you might want to arrange for this to be set to <code>t</code> in all but one of
+them.
+</p>
+</dd>
+<dt> <code>bbdb-auto-revert-p</code></dt>
+<dd><a name="IDX142"></a>
+<p>If this variable is true (default: <code>nil</code>) and the <b>BBDB</b> file is noticed to
+have changed on disk, it will be automatically reverted without
+prompting you first. Otherwise you will be asked. (But if the file has
+changed and you have made changes in memory as well, you will always be
+asked.)
+</p>
+</dd>
+<dt> <code>bbdb-notice-auto-save-file</code></dt>
+<dd><a name="IDX143"></a>
+<a name="IDX144"></a>
+<p>If this is true (default: <code>nil</code>), then the <b>BBDB</b> will notice when its
+auto-save file is newer than the file is was read from, and will offer
+to revert.
+</p>
+</dd>
+<dt> <code>bbdb-use-pop-up</code></dt>
+<dd><a name="IDX145"></a>
+<a name="IDX146"></a>
+<p>If true (the default), display a continuously-updating <b>BBDB</b>
+window while in <b>VM</b>, <b>MH</b>, <b>RMAIL</b>, or <b>GNUS</b>.
+Each time a new message is selected, the record corresponding to
+that message's sender will be displayed in another window. The
+buffer in this other window will be in bbdb-mode, and all
+corresponding commands will be available.
+</p>
+<p>This buffer will be positioned on the screen by finding the tallest
+of the windows present, and splitting it such that the bottom
+<code>bbdb-pop-up-target-lines</code> lines of the window display the
+<samp>`*BBDB*'</samp> buffer. With the default configurations of <b>VM</b>,
+<b>MH</b>, <b>RMAIL</b>, and <b>GNUS</b>, this means that the bbdb-list
+buffer will be just below the message-body buffer.
+</p>
+<p>If this is the symbol <code>horiz</code>, then the <b>BBDB</b> window will be
+stacked horizontally instead of vertically, if there is room to do that
+tastefully.
+</p>
+</dd>
+<dt> <code>bbdb-pop-up-target-lines</code></dt>
+<dd><a name="IDX147"></a>
+<p>Desired number of lines in a <b>VM/MH/RMAIL/GNUS</b> pop-up <b>BBDB</b> window,
+default 5.
+</p>
+</dd>
+<dt> <code>bbdb-completion-type</code></dt>
+<dd><a name="IDX148"></a>
+<a name="IDX149"></a>
+<a name="IDX150"></a>
+<a name="IDX151"></a>
+<a name="IDX152"></a>
+<p>Controls the behavior of the <code>bbdb-complete-name</code> command. If <code>nil</code>
+(the default), completion is done across the set of all full-names and
+user-ids in the database; if the symbol <code>name</code>, completion is
+done on real-names only; if the symbol <code>net</code>, completion is done
+on network addresses only; if it is <code>primary</code>, then completion is
+done only across the set of primary network addresses (the first address
+in the list of addresses for a given user). If it is
+<code>primary-or-name</code>, completion is done across primaries and real
+names.
+</p>
+</dd>
+<dt> <code>bbdb-expand-mail-aliases</code></dt>
+<dd><a name="IDX153"></a>
+<a name="IDX154"></a>
+<a name="IDX155"></a>
+<a name="IDX156"></a>
+<a name="IDX157"></a>
+<p>If non-nil, expand mail aliases in `bbdb-complete-name'.
+
+</p>
+</dd>
+<dt> <code>bbdb-complete-name-allow-cycling</code></dt>
+<dd><a name="IDX158"></a>
+<a name="IDX159"></a>
+<a name="IDX160"></a>
+<a name="IDX161"></a>
+<a name="IDX162"></a>
+<p>Whether to allow cycling of email addresses when calling
+`bbdb-complete-name' on a completed address in a composition buffer.&quot;
+
+</p>
+</dd>
+<dt> <code>bbdb-complete-name-full-completion</code></dt>
+<dd><a name="IDX163"></a>
+<a name="IDX164"></a>
+<a name="IDX165"></a>
+<a name="IDX166"></a>
+<a name="IDX167"></a>
+<p>Show full expanded completion rather than partial matches.
+If t then do it always, if a number then just is the number of
+completions for a specific match is below that number.
+
+</p>
+</dd>
+<dt> <code>bbdb-user-mail-names</code></dt>
+<dd><a name="IDX168"></a>
+<p>A regular expression identifying the addresses that belong to you. If a
+message from an address matching this is seen, the <b>BBDB</b> record for the
+<samp>`To:'</samp> line will be shown instead of the one for the <samp>`From:'</samp>
+line. If this is <code>nil</code>, it will default to the value of
+<code>(user-login-name)</code>.
+</p>
+</dd>
+<dt> <code>bbdb-always-add-addresses</code></dt>
+<dd><a name="IDX169"></a>
+<p>If this is <code>t</code>, then whenever the Insidious Big Brother Database
+notices a new email address corresponding to a person who is in the
+database, it will add it to the database. If this is <code>nil</code> (the
+default), then whenever a new network address is noticed for a person in
+the database, you will be asked whether to add the address. If this is
+the symbol <code>never</code> (really if it is not <code>t</code> and not <code>nil</code>)
+then new network addresses will never be automatically added.
+</p>
+</dd>
+<dt> <code>bbdb-new-nets-always-primary</code></dt>
+<dd><a name="IDX170"></a>
+<p>If this is <code>t</code>, then when the Insidious Big Brother Database adds a new
+address to a record, it will always add it to the front of the list of
+addresses, making it the primary address. If this is <code>nil</code> (the default),
+then you will be asked. If this is the symbol <code>never</code> (really if
+it is not <code>t</code> and not <code>nil</code>) then new network addresses will
+always be added to the end of the list.
+</p>
+</dd>
+<dt> <code>bbdb-canonicalize-redundant-nets-p</code></dt>
+<dd><a name="IDX171"></a>
+<p>If this is non-<code>nil</code>, redundant network addresses will be ignored.
+If a record has an address of the form <code>foo@baz.com</code>, setting this
+to <code>t</code> will cause subsequently-noticed addresses
+like <code>foo@bar.baz.com</code> to be ignored (since we already have a more
+general form of that address.) This is similar in function to one of
+the possible uses of the variable <code>bbdb-canonicalize-net-hook</code>
+but is somewhat more automatic. (This can't quite be implemented in
+terms of the canonicalize-net-hook because it needs access to the
+database to determine whether an address is redundant, and the
+canonicalize-net-hook is purely a textual manipulation which is
+performed before any database access.)
+</p>
+</dd>
+<dt> <code>bbdb-message-caching-enabled</code></dt>
+<dd><a name="IDX172"></a>
+<p>Whether caching of the message-&gt;bbdb-record association should be
+used for the interfaces which support it (<b>VM</b>, <b>MH</b>, and
+<b>RMAIL</b>). This can speed things up a lot. One implication of
+this variable being true (the default) is that the
+<code>bbdb-notice-hook</code> will not be called each time a message is
+selected, but only the first time. Likewise, if selecting a message
+would generate a question (whether to add an address, change the
+name, etc) you will only be asked that question the very first time
+the message is selected.
+</p>
+</dd>
+<dt> <code>bbdb-offer-save</code></dt>
+<dd><a name="IDX173"></a>
+<p>If <code>t</code> (the default), then certain actions will cause the <b>BBDB</b> to
+ask you whether you wish to save the database. If <code>nil</code>, then the
+offer to save will never be made. If not <code>t</code> and not <code>nil</code>, then
+any time it would ask you, it will just save it without asking.
+</p>
+</dd>
+</dl>
+
+<hr size="6">
+<a name="Customization-Hooks"></a>
+<a name="SEC60"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC59" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC61" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC58" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.7.2 Customization Hooks </h3>
+
+<p>All of the hooks variables described below may be set to a symbol or
+lambda expression, which will be funcalled; or may be set to a list of
+symbols or lambda expressions, each of which will be funcalled in turn.
+Almost all hooks in Emacs work this way. But notice that some of the
+hooks described below are called with arguments.
+</p>
+<dl compact="compact">
+<dt> <code>bbdb-list-hook</code></dt>
+<dd><a name="IDX174"></a>
+<p>Hook or hooks invoked after the bbdb-list-buffer is filled in. Invoked
+with no arguments.
+</p>
+</dd>
+<dt> <code>bbdb-create-hook</code></dt>
+<dd><a name="IDX175"></a>
+<p>Hook or hooks invoked each time a new bbdb-record is created. Invoked
+with one argument, the new record. This is called <em>before</em> the record is
+added to the database. Note that <code>bbdb-change-hook</code> will be called as
+well.
+</p>
+</dd>
+<dt> <code>bbdb-change-hook</code></dt>
+<dd><a name="IDX176"></a>
+<p>Hook or hooks invoked each time a bbdb-record is altered. Invoked with
+one argument, the record. This is called <em>before</em> the database buffer
+is modified. Note that if a new bbdb record is created, both this hook and
+<code>bbdb-create-hook</code> will be called.
+</p>
+</dd>
+<dt> <code>bbdb-mode-hook</code></dt>
+<dd><a name="IDX177"></a>
+<p>Hook or hooks invoked when the <samp>`*BBDB*'</samp> buffer is created.
+</p>
+</dd>
+<dt> <code>bbdb-notice-hook</code></dt>
+<dd><a name="IDX178"></a>
+<p>Hook or hooks invoked each time a bbdb-record is &quot;noticed,&quot; that
+is, each time it is displayed by the news or mail interfaces.
+Invoked with one argument, the new record. The record need not have
+been modified for this to be called - use <code>bbdb-change-hook</code> for that.
+You can use this to, for example, add something to the notes field
+based on the subject of the current message. It is up to your hook
+to determine whether it is running in <b>GNUS</b>, <b>VM</b>,
+<b>MH</b>, or <b>RMAIL</b>, and to act appropriately.
+</p>
+<p>Also note that <code>bbdb-change-hook</code> will <em>not</em> be called as a
+result of any modifications you may make to the record inside this
+hook.
+</p>
+<p>Beware that if the variable <code>bbdb-message-caching-enabled</code> is
+true (a good idea) then when you are using <b>VM</b>, <b>MH</b>, or
+<b>RMAIL</b>, this hook will be called only the first time that
+message is selected. (The <b>GNUS</b> interface does not use caching.)
+When debugging the value of this hook, it is a good idea to set
+caching-enabled to <code>nil</code>.
+</p>
+</dd>
+<dt> <code>bbdb-after-read-db-hook</code></dt>
+<dd><a name="IDX179"></a>
+<p>Hook or hooks invoked (with no arguments) just after the Insidious Big
+Brother Database is read in. Note that this can be called more than once if
+the <b>BBDB</b> is reverted. One possible use for this is to rename the
+<tt>`.bbdb'</tt> buffer; for example
+</p>
+<p><code>(setq bbdb-after-read-db-hook '(lambda () (rename-buffer &quot; bbdb&quot;)))</code>
+</p>
+
+<p>will cause the buffer visiting the <code>bbdb-file</code> to be
+called <code>&quot; bbdb&quot;</code>. The leading space in its name will prevent
+it from showing up in the buffer list.
+</p>
+</dd>
+<dt> <code>bbdb-load-hook</code></dt>
+<dd><a name="IDX180"></a>
+<p>Hook or hooks invoked (with no arguments) when the Insidious Big Brother
+Database code is first loaded. WARNING: Slow functions should not be
+put on this hook, as the <b>BBDB</b> code will, if not loaded before, be
+loaded during the first use of <b>BBDB</b>-related Customization
+functions. Slow functions should be put on <code>bbdb-initialize-hook</code>.
+</p>
+</dd>
+<dt> <code>bbdb-initialize-hook</code></dt>
+<dd><a name="IDX181"></a>
+<a name="IDX182"></a>
+<p>Hook or hooks invoked (with no arguments) when the
+<code>bbdb-initialize</code> function is called.
+</p>
+</dd>
+<dt> <code>bbdb-canonicalize-net-hook</code></dt>
+<dd><a name="IDX183"></a>
+<p>If this is non-<code>nil</code>, it should be a function of one argument: a
+network address string. (Note that, unlike the other hook-variables
+described above, this may not be a list of functions.) Whenever the
+Insidious Big Brother Database &quot;notices&quot; a message, the corresponding
+network address will be passed to this function first, as a kind of
+&quot;filter&quot; to do whatever transformations upon it you like before it is
+compared against or added to the database. For example: it is the case
+that <code>CS.CMU.EDU</code> is a valid return address for all mail
+originating at a machine in the <code>.CS.CMU.EDU</code> domain. So, if you
+wanted all such addresses to be canonically hashed as
+<code>user@CS.CMU.EDU</code>, instead of as <code>user@somehost.CS.CMU.EDU</code>,
+you might set this variable to a function like this:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(setq bbdb-canonicalize-net-hook
+ '(lambda (addr)
+ (cond ((string-match
+ &quot;\\`\\([^@]+@\\).*\\.\\(CS\\.CMU\\.EDU\\)\\'&quot;
+ addr)
+ (concat (substring addr
+ (match-beginning 1) (match-end 1))
+ (substring addr
+ (match-beginning 2) (match-end 2))))
+ (t addr))))
+</pre></td></tr></table>
+<p>You could also use this function to rewrite UUCP-style addresses into
+domain-style addresses, or any number of other things.
+</p>
+<p>This function will be called repeatedly until it returns a value EQ to the
+value passed in. So multiple rewrite rules might apply to a single
+address.
+</p>
+<p>There is an example of the use of this variable in the
+file <tt>`bbdb-hooks.el'</tt>: the function
+<code>sample-bbdb-canonicalize-net-hook</code>.
+</p></dd>
+</dl>
+
+<a name="IDX184"></a>
+<a name="IDX185"></a>
+<p>The <code>bbdb-canonicalize-net-hook</code> is powerful in that it allows
+arbitrary rewriting of addresses, however, in many cases that is
+overkill. The function <code>bbdb-delete-redundant-nets</code> can be
+used as a value of <code>bbdb-change-hook</code> to cause network addresses
+which appear to be &quot;redundant&quot; to be deleted each time a modification
+is made to a record.
+</p>
+<p>This works as follows: suppose one gets mail from <code>user@foo.bar.com</code>,
+and then later gets mail from <code>user@bar.com</code>. At this point, one
+can generally delete the <code>user@foo.bar.com</code> address, since the
+<code>user@bar.com</code> address is more general. (See also the
+variable `bbdb-canonicalize-redundant-nets-p', which has the effect of
+ignoring subsequent addresses from <code>user@quux.bar.com</code> if the
+address <code>user@bar.com</code> is already known.)
+</p>
+<hr size="6">
+<a name="Predefined-Hooks"></a>
+<a name="SEC61"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC60" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC62" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC58" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.7.3 Predefined Hooks </h3>
+
+<p>If the variable <code>bbdb-change-hook</code> is set to the symbol
+<code>bbdb-timestamp-hook</code> (the default), then every record in the
+database will have a field named <samp>`timestamp'</samp>, which will always
+contain the date and time at which this record was created or last
+modified.
+</p>
+<a name="IDX186"></a>
+<p>If the variable <code>bbdb-create-hook</code> is set to the symbol
+<code>bbdb-creation-date-hook</code> (the default), then every record in the
+database will have a field named <samp>`creation-date'</samp>, which will
+contain the date and time at which this record was added to the
+database.
+</p>
+<a name="IDX187"></a>
+<a name="IDX188"></a>
+<a name="IDX189"></a>
+<p>If the variable <code>bbdb/mail-auto-create-p</code> is set to the symbol
+<code>bbdb-ignore-most-messages-hook</code>, then the variable
+<code>bbdb-ignore-most-messages-alist</code> will determine which messages
+should have records automatically created for them. The format of this
+alist is
+</p><table><tr><td>&nbsp;</td><td><pre class="example">(( <var>HEADER-NAME</var> . <var>REGEXP</var> ) &hellip; )
+</pre></td></tr></table>
+<p>for example,
+</p><table><tr><td>&nbsp;</td><td><pre class="example">((&quot;From&quot; . &quot;@.*\\.maximegalon\\.edu&quot;)
+ (&quot;Subject&quot; . &quot;time travel&quot;))
+</pre></td></tr></table>
+
+<p>will cause <b>BBDB</b> entries to be made only for messages sent by
+people at Maximegalon U., or (that's <em>or</em>) people posting
+about time travel.
+</p>
+<p>There may be only one entry per header in this alist: that is,
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">((&quot;From&quot; . &quot;addr1\\|addr2&quot;) &hellip; )
+</pre></td></tr></table>
+
+<p>is legal, but
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">((&quot;From&quot; . &quot;addr1&quot;) (&quot;From&quot; . &quot;addr2&quot;) &hellip; )
+</pre></td></tr></table>
+
+<p>is not.
+</p>
+<a name="IDX190"></a>
+<a name="IDX191"></a>
+<a name="IDX192"></a>
+<a name="IDX193"></a>
+<p>If the variable <code>bbdb/mail-auto-create-p</code> is set to the symbol
+<code>bbdb-ignore-some-messages-hook</code>, then the variable
+<code>bbdb-ignore-some-messages-alist</code> will determine which messages
+should have records automatically created for them. This is the exact
+inverse of the semantics of the <code>bbdb-ignore-most-messages-alist</code>:
+the alist specifies which messages should <em>not</em> have records
+automatically created for them, instead of which should. For
+example,
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">((&quot;From&quot; . &quot;mailer.daemon&quot;)
+ (&quot;To&quot; . &quot;mailing-list-1\\|mailing-list-2&quot;)
+ (&quot;CC&quot; . &quot;mailing-list-1\\|mailing-list-2&quot;))
+</pre></td></tr></table>
+
+<p>will cause <b>BBDB</b> entries to not be made for messages from any mailer daemon,
+or messages sent to or <b>CC</b>ed to either of two mailing lists.
+</p>
+<p>The variable <code>bbdb/news-auto-create-p</code> may be set to either of the
+above-mentioned functions as well, to get this behavior for netnews
+messages instead of mail messages.
+</p>
+<a name="IDX194"></a>
+<a name="IDX195"></a>
+<a name="IDX196"></a>
+<p>If the variable <code>bbdb-notice-hook</code> is set to the symbol
+<code>bbdb-auto-notes-hook</code>, then the variable <code>bbdb-auto-notes-alist</code>
+may be used to automatically add text to the notes fields of the records
+corresponding to certain messages. The format of this alist is
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(( <var>HEADER-NAME</var>
+ (<var>REGEXP</var> . <var>STRING</var>) &hellip; )
+ &hellip; )
+</pre></td></tr></table>
+
+<p>for example,
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">((&quot;To&quot; (&quot;-vm@&quot; . &quot;VM mailing list&quot;))
+ (&quot;Subject&quot; (&quot;sprocket&quot; . &quot;mail about sprockets&quot;)
+ (&quot;you bonehead&quot; . &quot;called me a bonehead&quot;)))
+</pre></td></tr></table>
+
+<p>will cause the text <code>&quot;VM mailing list&quot;</code> to be added to the notes field of
+the record corresponding to anyone you get mail from via one of the <b>VM</b>
+mailing lists. If, that is, <code>bbdb/mail-auto-create-p</code> is set such
+that the record would have been created, or if the record already
+existed.
+</p>
+<p>The format of elements of this list may also be
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(<var>REGEXP</var> <var>FIELD-NAME</var> <var>STRING</var>)
+</pre></td></tr></table>
+<p>or
+</p><table><tr><td>&nbsp;</td><td><pre class="example">(<var>REGEXP</var> <var>FIELD-NAME</var> <var>STRING</var> <var>REPLACE-P</var>)
+</pre></td></tr></table>
+
+<p>meaning add the given string to the named field. The field-name may not
+be <samp>`name'</samp>, <samp>`aka'</samp>, <samp>`address'</samp>, <samp>`phone'</samp>, or <samp>`net'</samp>
+(builtin fields) but must be either <samp>`notes'</samp>, <samp>`company'</samp>, or the
+name of a user-defined note-field.
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(&quot;pattern&quot; . &quot;string to add&quot;)
+</pre></td></tr></table>
+
+<p>is equivalent to
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(&quot;pattern&quot; notes &quot;string to add&quot;)
+</pre></td></tr></table>
+
+<p><var>STRING</var> can contain <code>\&amp;</code> or <code>\N</code> escapes like in the function
+<code>replace-match</code>. For example, to automatically add the contents of the
+<b>organization</b> field of a message to the <code>company</code> field of a <b>BBDB</b>
+record, you can use this:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(&quot;Organization&quot; (&quot;.*&quot; company &quot;\\&amp;&quot;))
+</pre></td></tr></table>
+
+<p>(Note you need two \ to get a single \ into a lisp string literal.)
+</p>
+<p>If STRING is an integer <i>N</i>, the <i>N</i>th matching subexpression is
+used, so the above example could be written more efficiently as
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(&quot;Organization&quot; (&quot;.*&quot; company 0))
+</pre></td></tr></table>
+<p>If STRING is neither a string or an integer, it should be a function
+which is called with the contents of the field, and the result of the
+function call is used.
+</p>
+<p>If the <var>REPLACE-P</var> flag is true, then the string replaces the old
+contents instead of being appended to it.
+</p>
+<p>If multiple clauses match the message, all of the corresponding strings
+will be added.
+</p>
+<p>If the string is being appended (<var>REPLACE-P</var> is false or not
+provided) then the new string is appended to the end of the existing
+field value, with an intervening newline. So each piece of text
+automatically added to this field will go on its own line.
+</p>
+<p>You can control what the separator is by putting a <code>field-separator</code>
+property on the symbol naming the field. For example, to make text
+automatically added to a field named <code>newsgroups</code> be separated by
+commas, you could do
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(put 'newsgroups 'field-separator &quot;; &quot;)
+</pre></td></tr></table>
+<p>This variable works for news as well. You might want to arrange for
+this to have a different value when in mail as when in news.
+</p>
+<p>There may be only one entry per header in this alist: that is,
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"> ((&quot;Subject&quot; (&quot;\\bfoo\\b&quot; . &quot;Foo!!&quot;)
+ (&quot;bar&quot; . &quot;Bar!&quot;)))
+</pre></td></tr></table>
+
+<p>will work, but
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example"> ((&quot;Subject&quot; (&quot;\\bfoo\\b&quot; . &quot;Foo!!&quot;))
+ (&quot;Subject&quot; (&quot;bar&quot; . &quot;Bar!&quot;)))
+</pre></td></tr></table>
+
+<p>will not.
+</p>
+<p>Here's a more complicated example: some people include bitmaps of
+themselves in their mail messages in an <b>X-Face:</b> header field.
+You can capture this field into the <samp>`*BBDB*'</samp> with the
+following:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(setq bbdb-auto-notes-alist
+ (append bbdb-auto-notes-alist
+ (list &quot;x-face&quot;
+ (list (concat &quot;[ \t\n]*\\([^ \t\n]*\\)&quot;
+ &quot;\\([ \t\n]+\\([^ \t\n]+\\)\\)?&quot;
+ &quot;\\([ \t\n]+\\([^ \t\n]+\\)\\)?&quot;
+ &quot;\\([ \t\n]+\\([^ \t\n]+\\)\\)?&quot;
+ )
+ 'face
+ &quot;\\1\\3\\5\\7&quot;))))
+</pre></td></tr></table>
+
+<p>(The calls to <code>list</code> and <code>concat</code> are just for readability, it
+could easily be a constant.) The tricky bit here is that it strips out
+the newlines and whitespace used for header continuation, which are not
+actually a part of the face data. So though the mail message may have
+the face data on multiple lines, the entry in the <samp>`*BBDB*'</samp> will
+be just one line.
+</p>
+<a name="IDX197"></a>
+<p><code>bbdb-auto-notes-ignore</code> is an alist of headers and regexps to
+ignore in <code>bbdb-auto-notes-hook</code>. Each element looks like
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(<var>HEADER</var> . <var>REGEXP</var>)
+</pre></td></tr></table>
+
+<p>for example,
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(&quot;Organization&quot; . &quot;^Gatewayed from\\|^Source only&quot;)
+</pre></td></tr></table>
+
+<p>would exclude the phony <code>Organization:</code> headers in GNU mailing-lists
+gatewayed to the <code>gnu.*</code> newsgroups. Note that this exclusion
+applies only to a single field, not to the entire message. For that,
+use the variable <code>bbdb-auto-notes-ignore-all</code>.
+</p>
+<a name="IDX198"></a>
+<p><code>bbdb-auto-notes-ignore-all</code> is an alist of headers and regexps
+which cause the entire message to be ignored in <code>bbdb-auto-notes-hook</code>.
+Each element looks like
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(<var>HEADER</var> . <var>REGEXP</var>)
+</pre></td></tr></table>
+
+<p>for example,
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">(&quot;From&quot; . &quot;BLAT\\.COM&quot;)
+</pre></td></tr></table>
+
+<p>would exclude any notes recording for message coming from <code>BLAT.COM</code>.
+Note that this is different from <code>bbdb-auto-notes-ignore</code>, which
+applies only to a particular header field, rather than the entire message.
+</p>
+<hr size="6">
+<a name="Utilities"></a>
+<a name="SEC62"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC61" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC63" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.8 Utilities </h2>
+
+<p>This section describes <b>BBDB</b> functionality that does not fit neatly into
+other sections.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC63">1.8.1 <code>bbdb-ftp</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Storing FTP sites in the <b>BBDB</b>
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC64">1.8.2 <code>bbdb-print</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Print the <b>BBDB</b>
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC65">1.8.3 <code>bbdb-snarf</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Record generation from raw text
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC66">1.8.4 <code>bbdb-srv</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> External control of the <b>BBDB</b>
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="bbdb_002dftp"></a>
+<a name="SEC63"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC62" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC64" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC62" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.8.1 <code>bbdb-ftp</code> </h3>
+
+<p>The <code>bbdb-ftp</code> utility enables the storage of FTP sites as <b>BBDB</b>
+records. The <code>bbdb-create-ftp-site</code> function is used to create a
+<b>BBDB</b> record for an FTP site. The command will prompt for information
+needed to create the record. The FTP site for a given record can be accessed
+with the <code>bbdb-ftp</code> command.
+</p>
+<hr size="6">
+<a name="bbdb_002dprint"></a>
+<a name="SEC64"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC63" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC65" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC62" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.8.2 <code>bbdb-print</code> </h3>
+
+<p><code>bbdb-print</code> is a utility for pretty-printing entries from the <b>BBDB</b>
+using TeX. It is invoked by pressing <kbd>P</kbd> in the <code>*BBDB*</code> buffer -
+this will cause all records in the <b>BBDB</b> to be printed as governed by the
+variables described below. If <kbd>P</kbd> is prefixed by a <kbd>*</kbd>, only the
+currently-displayed records will be printed. Once invoked, <code>bbdb-print</code>
+will generate the TeX output in a buffer named <tt>`~/bbdb.tex'</tt> (controlled
+by <code>bbdb-print-file-name</code>). The generated output will be shown, and must
+be <b>manually</b> saved.
+</p>
+<p>For each record printed, <code>bbdb-print</code> will look for the presence of the
+<code>tex-name</code> field. If this field is found, its value will be printed
+instead of the <code>name</code> field for the record in question. This field is
+intended to allow the storage of names with accents or other characters that
+would be illegal in the address portion of a message. While other fields have
+special characters quoted by <code>bbdb-print</code> as described below, the
+contents of the <code>tex-name</code> field (if present) are used verbatim.
+</p>
+<p>The following variables govern the printing of records (and of the printing of
+the fields therein):
+</p>
+<dl compact="compact">
+<dt> <code>bbdb-print-omit-fields</code></dt>
+<dd><a name="IDX199"></a>
+<p>This variable should be set to a list of the fields that are not to be printed
+by <code>bbdb-print</code>. It defaults to:<br>
+</p><p align="center"> <code>(omit tex-name aka mail-alias)</code>
+</p>
+</dd>
+<dt> <code>bbdb-print-file-name</code></dt>
+<dd><a name="IDX200"></a>
+<p>The name of the file where generated TeX output is to be stored. The default
+is <tt>`~/bbdb.tex'</tt>.
+</p>
+</dd>
+<dt> <code>bbdb-print-require</code></dt>
+<dd><a name="IDX201"></a>
+<p>The fields required for printing a record. This allows, for example, only
+records with phone numbers to be printed. The value of the value of the
+variable will be evaluated once for each record, and the record will be
+printed only if the evaluation returns a non-nil value. The symbols
+<code>name</code>, <code>company</code>, <code>net</code>, <code>phone</code>, <code>address</code>, and
+<code>notes</code> will be set to the appropriate values during evaluation; they
+will be nil if the field does not exist or is elided.
+</p>
+<p>The value of this variable can be any lisp expression, but typically
+it will be used for a boolean combination of the field variables, as
+in the following simple examples:
+</p>
+<ul>
+<li> Print only people whose phone numbers are known:<br>
+<p align="center"> <code>(setq bbdb-print-require 'phone)</code>
+</p></li><li> Print people whose names AND companies are known:<br>
+<p align="center"> <code>(setq bbdb-print-require '(and name company))</code>
+</p></li><li> Print people whose names, and either addresses OR phone numbers are
+known:<br>
+<p align="center"> <code>(setq bbdb-print-require '(and name (or address phone))).</code>
+</p>
+<p>The default value is:<br>
+</p><p align="center"> <code>(or address phone)</code>
+</p></li></ul>
+
+</dd>
+<dt> <code>bbdb-print-alist</code></dt>
+<dd><a name="IDX202"></a>
+<p>Formatting options for all formats of <code>bbdb-print</code>. The value is an
+alist of the form<br>
+</p><p align="center"> <code>((<var>OPTION</var> . <var>VALUE</var>) (<var>OPTION</var> . <var>VALUE</var>) ...)</code>
+</p>
+<p>Separate settings can be configured using <code>bbdb-print-brief-alist</code> and
+<code>bbdb-print-full-alist</code>. Settings in these variables will override the
+ones in <code>bbdb-print-alist</code>.
+</p>
+<p>The possible options and legal settings are:
+</p><dl compact="compact">
+<dt> <code>columns</code></dt>
+<dd><p><code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, <code>quad</code> (4 little
+2-column pages per sheet) or <code>grid</code> (12 credit-card-sized pages per
+sheet).
+</p>
+</dd>
+<dt> <code>separator</code></dt>
+<dd><p><code>0</code>-<code>7</code>, the style of heading for each letter. <code>0</code>=none,
+<code>1</code>=line, <code>2</code>=boxed letters, <code>3</code>=large boxed letters,
+<code>4</code>=large letters, <code>5</code>=letters with lines, <code>6</code>=letters with
+suits, <code>7</code>=boxed letters with suits.
+</p>
+</dd>
+<dt> <code>omit-area-code</code></dt>
+<dd><p>A regular expression matching area codes to omit.
+</p>
+</dd>
+<dt> <code>phone-on-first-line</code></dt>
+<dd><p>If <code>t</code>, the first phone number will be put on the same line as the name.
+If <code>nil</code>, the name will be the only text on the line. If set to a
+string, the field of type <code>phone</code> whose name matches the string will be
+used. The string should be a valid regular expression.
+</p>
+</dd>
+<dt> <code>n-phones</code></dt>
+<dd><p>Maximum number of phone numbers to include.
+</p>
+</dd>
+<dt> <code>n-addresses</code></dt>
+<dd><p>Maximum number of addresses to include.
+</p>
+</dd>
+<dt> <code>include-files</code></dt>
+<dd><p>List of TeX files to <code>\input</code>. If the filenames are not absolute, the
+files must be located somewhere in the TeX input path.
+</p>
+</dd>
+<dt> <code>ps-fonts</code></dt>
+<dd><p>Postscript fonts (TimesNewRoman and Courier) will be used if the value
+is non-<code>nil</code>. Standard TeX fonts (ec-fonts) will be used
+otherwise.
+</p>
+</dd>
+<dt> <code>font-size</code></dt>
+<dd><p>The integer point size of the font to be used.
+</p>
+</dd>
+<dt> <code>hsize</code></dt>
+<dd><p>The horizontal dimension of the pages. The value must be a string, and must
+be a valid TeX dimension. Alternatively, the TeX default will be used if the
+value is <code>nil</code>.
+</p>
+</dd>
+<dt> <code>vsize</code></dt>
+<dd><p>The vertical dimension of the pages. The value must be a string, and must
+be a valid TeX dimension. Alternatively, the TeX default will be used if the
+value is <code>nil</code>.
+</p>
+</dd>
+<dt> <code>hoffset</code></dt>
+<dd><p>The TeX output will be offset to the right by the value of this option. The
+value must be either a string containing a valid TeX dimension or <code>nil</code>
+or <code>0</code> to use the default TeX horizontal offset.
+</p>
+</dd>
+<dt> <code>voffset</code></dt>
+<dd><p>The TeX output will be offset downward by the value of this option. The
+value must be either a string containing a valid TeX dimension or <code>nil</code>
+or <code>0</code> to use the default TeX vertical offset.
+</p>
+</dd>
+<dt> <code>quad-hsize</code></dt>
+<dd><p>Horizontal size to be used for the individual pages in the quad format. The
+value must be a string containing a valid TeX dimension.
+</p>
+</dd>
+<dt> <code>quad-vsize</code></dt>
+<dd><p>Vertical size to be used for the individual pages in the quad format. The
+value must be a string containing a valid TeX dimension.
+</p></dd>
+</dl>
+
+<p>The default value is
+</p><table><tr><td>&nbsp;</td><td><pre class="example">((omit-area-code . &quot;(<var>AREA-CODE</var>)&quot;)
+ (phone-on-first-line . &quot;^[ \t]*$&quot;)
+ (ps-fonts . nil)
+ (font-size . 6)
+ (quad-hsize . &quot;3.15in&quot;)
+ (quad-vsize . &quot;4.5in&quot;))
+</pre></td></tr></table>
+<p>Where <var>AREA-CODE</var> is the value of <code>bbdb-default-area-code</code> or
+<samp>`000'</samp> if there is no default area code.
+</p>
+</dd>
+<dt> <code>bbdb-print-brief-alist</code></dt>
+<dd><a name="IDX203"></a>
+<p>Extra options for the <code>bbdb-print</code> brief format. The value(s) of
+this variable can either supplement or override the values in
+<code>bbdb-print-alist</code>. The format and possible values of this variable are
+as in <code>bbdb-print-alist</code>, described above.
+</p>
+<p>The default value is
+</p><table><tr><td>&nbsp;</td><td><pre class="example">((columns . 1)
+ (separator . 1)
+ (n-phones . 2)
+ (n-addresses . 1)
+ (include-files &quot;bbdb-print-brief&quot; &quot;bbdb-cols&quot;))
+</pre></td></tr></table>
+</dd>
+<dt> <code>bbdb-print-full-alist</code></dt>
+<dd><a name="IDX204"></a>
+<p>Extra options for the <code>bbdb-print</code> non-brief format. The value(s) of
+this variable can either supplement or override the values in
+<code>bbdb-print-alist</code>. The format and possible values of this variable are
+as in <code>bbdb-print-alist</code>, described above.
+</p>
+<p>The default value is
+</p><table><tr><td>&nbsp;</td><td><pre class="example">((columns . 3)
+ (separator . 2)
+ (include-files &quot;bbdb-print&quot; &quot;bbdb-cols&quot;))
+</pre></td></tr></table>
+</dd>
+<dt> <code>bbdb-print-prolog</code></dt>
+<dd><a name="IDX205"></a>
+<p>TeX statements to include at the beginning of the <code>bbdb-print</code> output
+file.
+</p>
+</dd>
+<dt> <code>bbdb-print-epilog</code></dt>
+<dd><a name="IDX206"></a>
+<p>TeX statements to include at the end of the <code>bbdb-print</code> output file.
+</p>
+</dd>
+</dl>
+
+<hr size="6">
+<a name="bbdb_002dsnarf"></a>
+<a name="SEC65"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC64" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC66" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC62" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.8.3 <code>bbdb-snarf</code> </h3>
+
+<p><code>bbdb-snarf</code> provides the ability to generate <b>BBDB</b> records from raw
+text. If invoked as <code>bbdb-snarf</code>, it attempts to generate the record
+from the information around point (the cursor). If invoked as
+<code>bbdb-snarf-region</code><a name="DOCF6" href="bbdb_fot.html#FOOT6">(6)</a>, the active region is used to generate the record.
+</p>
+
+<p><b>Restrictions:</b>
+</p>
+<ol>
+<li>
+<code>bbdb-snarf</code> currently recognizes only US-style phone numbers.
+</li><li>
+<code>bbdb-snarf</code> works best with things that look like mailing addresses.
+</li></ol>
+
+
+<p>Example of an address that <code>bbdb-snarf</code> will recognize:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">another test person
+1234 Gridley St.
+Los Angeles, CA 91342
+555-1212
+test@person.net
+http://www.foo.bar/
+other stuff about this person
+</pre></td></tr></table>
+<hr size="6">
+<a name="bbdb_002dsrv"></a>
+<a name="SEC66"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC65" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC67" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC62" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.8.4 <code>bbdb-srv</code> </h3>
+
+<p><code>bbdb-srv</code> provides the ability to initiate the display of <b>BBDB</b>
+records from outside of Emacs. This allows external programs to cause
+the <b>BBDB</b> record for a given person to appear in the running Emacs
+when, for example, mail is recieved from that person. One specific
+application, described below, is the integration of Netscape and the
+<b>BBDB</b>, allowing the display of <b>BBDB</b> records corresponding to Mail
+and/or News messages displayed in Netscape.
+</p>
+<p><code>bbdb-srv</code> is composed of two parts - an external Perl script
+(<tt>`utils/bbdb-srv.pl'</tt>), and an Emacs Lisp file
+(<tt>`lisp/bbdb-srv.el'</tt>). The external portion is used to send
+commands to the internal portion.
+</p>
+<p><b>NOTE:</b> <code>bbdb-srv</code> requires <code>gnuserv</code> and <code>itimer</code>,
+both included with XEmacs. <code>gnuserv</code> must be started with the
+<code>gnuserv-start</code> command before <code>bbdb-srv</code> can be used.
+</p>
+<p>In it's most basic form, mail or news headers are passed to the Perl
+script. The Perl script then causes the <b>BBDB</b> record (if any)
+corresponding to the passed headers to be displayed in the running
+Emacs. While <code>bbdb-srv</code> will operate with just a <samp>`From:'</samp>
+field, it works better when passed both <samp>`From:'</samp> and <samp>`To:'</samp>
+headers. When <code>bbdb-srv</code> notices that the logged-in user is named
+in the <samp>`From:'</samp> header, it will attempt to display the record (if
+any) for the person named in the <samp>`To:'</samp> header. If no <samp>`To:'</samp>
+header is passed, it falls back on the record (if any) for the logged-in
+user (the person named in the <samp>`From:'</samp> header).
+</p>
+<p>An example manual invocation of <code>bbdb-srv</code> is as follows:
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">% cat |bbdb-srv.pl
+From: Jamie Zawinski &lt;jwz@netscape.com&gt;
+To: Matt Simmons &lt;simmonmt@acm.org&gt;
+<kbd>CTRL-D</kbd>
+</pre></td></tr></table>
+<p>If the invoking user is Jamie Zawinski, the record for Matt Simmons (if
+any) will be displayed. If the invoking user is not Jamie Zawinski, the
+record for Jamie Zawinski (if any) will be displayed.
+</p>
+<p>As mentioned above <code>bbdb-srv</code> can be used with Netscape Mail and
+Netscape News. Please note that it can only be used with the UNIX
+versions 3.0b2 and greater of these applications. To allow Netscape to
+use <code>bbdb-srv</code>, set the <samp>`NS_MSG_DISPLAY_HOOK'</samp> variable to
+<code>bbdb-srv.pl</code><a name="DOCF7" href="bbdb_fot.html#FOOT7">(7)</a> as follows:
+</p>
+
+<p>Bourne Shell (<tt>`/bin/sh'</tt>) and variants:
+</p><table><tr><td>&nbsp;</td><td><pre class="example"># NS_MSG_DISPLAY_HOOK bbdb-srv.pl
+# export NS_MSG_DISPLAY_HOOK
+</pre></td></tr></table>
+
+<p>C-Shell (<tt>`/bin/csh'</tt>) and variants:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">% setenv NS_MSG_DISPLAY_HOOK bbdb-srv.pl
+</pre></td></tr></table>
+<p>The following variables can be used to customize the behavior of
+<code>bbdb-srv</code>:
+</p>
+<dl compact="compact">
+<dd><a name="IDX207"></a>
+</dd>
+<dt> <code>bbdb/srv-auto-create-p</code></dt>
+<dd><p>This variable is similar to <code>bbdb/news-auto-create-p</code> and
+<code>bbdb/mail-auto-create-p</code>. That is, when headers are passed in to
+<code>bbdb-srv</code>, a new <b>BBDB</b> record can be created if none exists,
+depending on the value of this variable. Possible values are:
+</p><dl compact="compact">
+<dt> <code>t</code></dt>
+<dd><p>Automatically create new <b>BBDB</b> records if the headers passed in do
+not correspond to an already-existing record.
+</p></dd>
+<dt> <code>nil</code></dt>
+<dd><p>Do not automatically create new <b>BBDB</b> records.
+</p></dd>
+<dt> <var>FUNCTION</var></dt>
+<dd><p><var>FUNCTION</var> is called. If it returns <code>t</code>, a record will be
+created for the person named in the <samp>`From:'</samp> header. If it returns
+<code>nil</code>, no record will be created.
+</p>
+<p>A suggested function for use is
+<code>bbdb/srv-auto-create-mail-news-dispatcher</code>. This function will
+attempt to determine the source of the passed headers - whether they
+were part of a mail message or of a news article. The action (if any)
+dictated by the value of either <code>bbdb/mail-auto-create-p</code> or
+<code>bbdb/news-auto-create-p</code>, based on the determined source of the
+passed headers.
+</p>
+</dd>
+</dl>
+
+<a name="IDX208"></a>
+</dd>
+<dt> <code>bbdb/srv/display-delay</code></dt>
+<dd><p><code>bbdb-srv</code> pauses between displaying the records corresponding to
+each passed set of headers. This variable controls the length of time
+(in seconds) of the delay between the display of different records.
+Note when setting this variable that only one set of headers can be
+queued at a time. If three sets of headers are passed to
+<code>bbdb-srv</code> in less than the delay time, only the first and last
+will be displayed.
+</p></dd>
+</dl>
+
+<hr size="6">
+<a name="Internals"></a>
+<a name="SEC67"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC66" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.9 Internals </h2>
+
+<p><b>This section is currently a dumping ground for things that should
+eventually go here, but were found elsewhere in the file.</b>
+</p>
+<p><b>INFORMATION IN THIS SECTION IS FOR INFORMATIONAL PURPOSES ONLY. IT
+SHOULD NOT BE TAKEN AS DOCUMENTATION OF AN EXTERNAL API. EVERYTHING
+LISTED BELOW IS SUBJECT TO CHANGE WITHOUT NOTICE</b>
+</p>
+<p>The first time you use
+one of the <b>BBDB</b> commands, this file is read into an emacs buffer, and
+remains there. As you make changes to the database, this buffer is
+changed as well, ensuring that if it is auto-saved, it will be saved in
+its most current state.
+</p>
+<hr size="6">
+<a name="SEC68"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC67" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC69" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC67" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.9.1 BBDB data file format </h3>
+
+<p>The data file is arranged in a hierarchical fashion. At the top level
+are vectors, with one vector per database record. It is <b>very</b>
+important that each vector be on its own line, as the BBDB builds and
+stores markers based on this layout. The markers are then used to
+increase the speed of database modifications (more on this later). The
+record vectors contain the individual fields of the record. These
+fields can be of any type, but are currently integers, strings, lists of
+strings, alists, vectors, or lists of vectors. In the case of fields
+that contain one or more vectors, they can be further broken down in
+terms of the fields of their component vectors.
+</p>
+<p>In an effort to provide a more concrete example to illustrate the above,
+and to provide a reference for database accessor and modifier functions,
+we describe the database format below. This description starts with the
+fields of the individual record vectors, and drills down through the
+vectors used by some of the fields.
+</p>
+<hr size="6">
+<a name="SEC69"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC68" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC70" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.9.1.1 Record Vectors </h4>
+
+<table>
+<tr><td><p> <b>Name</b>
+</p></td><td><p> <b>Type</b>
+</p></td><td><p> <b>Accessor and Modifier</b>
+</p></td><td><p> <b>Description</b>
+</p>
+</td></tr>
+<tr><td><p> First name
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-record-firstname</code><br>
+ <code>bbdb-record-set-firstname</code>
+</p></td><td><p> Entity's first name
+</p>
+</td></tr>
+<tr><td><p> Last name
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-record-lastname</code><br>
+ <code>bbdb-record-set-lastname</code>
+</p></td><td><p> Entity's last name
+</p>
+</td></tr>
+<tr><td><p> AKAs
+</p></td><td><p> List of Strings
+</p></td><td><p> <code>bbdb-record-aka</code><br>
+ <code>bbdb-record-set-aka</code>
+</p></td><td><p> Alternate names for entity
+</p>
+</td></tr>
+<tr><td><p> Company
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-record-company</code><br>
+ <code>bbdb-record-set-company</code>
+</p></td><td><p> Company with which entity is associated
+</p>
+</td></tr>
+<tr><td><p> Phones
+</p></td><td><p> List of Vectors
+</p></td><td><p> <code>bbdb-record-phones</code><br>
+ <code>bbdb-record-set-phones</code>
+</p></td><td><p> List of phone number vectors
+</p>
+</td></tr>
+<tr><td><p> Addresses
+</p></td><td><p> List of Vectors
+</p></td><td><p> <code>bbdb-record-addresses</code><br>
+ <code>bbdb-record-set-addresses</code>
+</p></td><td><p> List of address vectors
+</p>
+</td></tr>
+<tr><td><p> Net address
+</p></td><td><p> List of Strings
+</p></td><td><p> <code>bbdb-record-net</code><br>
+ <code>bbdb-record-set-net</code>
+</p></td><td><p> List of network addresses
+</p>
+</td></tr>
+<tr><td><p> Notes
+</p></td><td><p> String or Alist
+</p></td><td><p> <code>bbdb-record-raw-notes</code><br>
+ <code>bbdb-record-set-raw-notes</code>
+</p></td><td><p> String or Association list of note fields (strings)
+</p>
+</td></tr>
+<tr><td><p> Cache
+</p></td><td><p> Vector
+</p></td><td><p> <code>bbdb-record-cache</code><br>
+ <code>bbdb-record-set-cache</code>
+</p></td><td><p> Record cache.<br>
+ <i>Internal version only.</i>
+</p>
+</td></tr>
+</table>
+
+<p>The phone, address and cache vector fields are described below. Please
+note that, as indicated in the table above, the cache is present only in
+the internal version of the database - it is not written out as part of
+the <tt>`.bbdb'</tt> file.
+</p>
+<p>In addition, the accessor and modifier functions for the notes alist
+are described.
+</p>
+<hr size="6">
+<a name="SEC70"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC69" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC71" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.9.1.2 Phone Vectors </h4>
+
+<p>To access the fields in the below table, you must first get the list of
+phone vectors using the <code>bbdb-record-phones</code> function. Note that
+if you alter the phones field with the <code>bbdb-record-set-phones</code>
+function, you are altering the entire phones list for the given record.
+Use the modifier functions below for modifications to individual phone
+vectors.
+</p>
+<table>
+<tr><td><p> <b>Name</b>
+</p></td><td><p> <b>Type</b>
+</p></td><td><p> <b>Accessor and Modifier</b>
+</p></td><td><p> <b>Description</b>
+</p>
+</td></tr>
+<tr><td><p> Location
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-phone-location</code><br>
+ <code>bbdb-phone-set-location</code>
+</p></td><td><p> Phone number identifier
+</p>
+</td></tr>
+<tr><td><p> Area
+</p></td><td><p> Integer
+</p></td><td><p> <code>bbdb-phone-area</code><br>
+ <code>bbdb-phone-set-area</code>
+</p></td><td><p> Area code for phone number
+</p>
+</td></tr>
+<tr><td><p> Exchange
+</p></td><td><p> Integer
+</p></td><td><p> <code>bbdb-phone-exchange</code><br>
+ <code>bbdb-phone-set-exchange</code>
+</p></td><td><p> Exchange (aka prefix) for phone number
+</p>
+</td></tr>
+<tr><td><p> Suffix
+</p></td><td><p> Integer
+</p></td><td><p> <code>bbdb-phone-suffix</code><br>
+ <code>bbdb-phone-set-suffix</code>
+</p></td><td><p> Suffix for phone number
+</p>
+</td></tr>
+<tr><td><p> Extension
+</p></td><td><p> Integer
+</p></td><td><p> <code>bbdb-phone-extension</code><br>
+ <code>bbdb-phone-set-extension</code>
+</p></td><td><p> Phone number extension (<samp>`0'</samp> if none)
+</p>
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="SEC71"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC70" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC72" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.9.1.3 Address Vectors </h4>
+
+<p>To access the fields in the below table, you must first get the list of
+address vectors using the <code>bbdb-record-addresses</code> function. Note
+that if you alter the addresses field with the
+<code>bbdb-record-set-addresses</code> function, you are altering the entire
+addresses list for the given record. Use the modifier functions below
+for modifications to individual address vectors.
+</p>
+<table>
+<tr><td><p> <b>Name</b>
+</p></td><td><p> <b>Type</b>
+</p></td><td><p> <b>Accessor and Modifier</b>
+</p></td><td><p> <b>Description</b>
+</p>
+</td></tr>
+<tr><td><p> Location
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-address-location</code><br>
+ <code>bbdb-address-set-location</code>
+</p></td><td><p> Address identifier
+</p>
+</td></tr>
+<tr><td><p> Streets
+</p></td><td><p> List
+</p></td><td><p> <code>bbdb-address-streets</code><br>
+ <code>bbdb-address-set-streets</code>
+</p></td><td><p> List of street address lines. <code>nil</code> if none.
+</p>
+</td></tr>
+<tr><td><p> Street3
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-address-street3</code><br>
+ <code>bbdb-address-set-street3</code>
+</p></td><td><p> Third line of street address. &quot;&quot; if none.
+</p>
+</td></tr>
+<tr><td><p> City
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-address-city</code><br>
+ <code>bbdb-address-set-city</code>
+</p></td><td><p> City name
+</p>
+</td></tr>
+<tr><td><p> State
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-address-state</code><br>
+ <code>bbdb-address-set-state</code>
+</p></td><td><p> State abbreviation
+</p>
+</td></tr>
+<tr><td><p> Zip
+</p></td><td><p> Integer (american)
+ List (non-american)
+</p></td><td><p> <code>bbdb-address-zip</code><br>
+ <code>bbdb-address-set-zip</code>
+</p></td><td><p> Zip code
+</p>
+</td></tr>
+<tr><td><p> Country
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-address-country</code><br>
+ <code>bbdb-address-set-country</code>
+</p></td><td><p> Country
+</p>
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="SEC72"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC71" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC73" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.9.1.4 Cache Vector </h4>
+
+<p>This vector is present only in the internal database representation. It
+is not written out to the database file because it contains information
+aggregated from the rest of the record that is reconstructed when the
+database is read. To write the cache information to the database file
+would increase the risk of database inconsistency, and would violate the
+principles of normalization.
+</p>
+<p>To access the cache fields using the functions listed below that begin
+with <code>bbdb-cache-</code>, you must first get the cache vector using the
+<code>bbdb-record-cache</code> function. The functions that begin with
+<code>bbdb-record-</code> get the cache vector internally. Note that if you
+alter the cache field in the high-level record with the
+<code>bbdb-record-set-cache</code> function, you are altering the entire cache
+vector for the given record. Use the modifier functions below for
+modifications to individual cache fields.
+</p>
+<table>
+<tr><td><p> <b>Name</b>
+</p></td><td><p> <b>Type</b>
+</p></td><td><p> <b>Accessor and Modifier</b>
+</p></td><td><p> <b>Description</b>
+</p>
+</td></tr>
+<tr><td><p> Name Cache
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-cache-namecache</code><br>
+ <code>bbdb-cache-set-namecache</code>
+</p></td><td><p> Preconcatenated name of entity
+</p>
+</td></tr>
+<tr><td><p> Sort Key
+</p></td><td><p> String
+</p></td><td><p> <code>bbdb-cache-sortkey</code><br>
+ <code>bbdb-cache-set-sortkey</code>
+</p></td><td><p> Preconcatenated sort key for record
+</p>
+</td></tr>
+<tr><td><p> Marker
+</p></td><td><p> Marker
+</p></td><td><p> <code>bbdb-cache-marker</code><br>
+ <code>bbdb-record-marker</code><br>
+ <code>bbdb-cache-set-marker</code><br>
+ <code>bbdb-record-set-marker</code><br>
+</p></td><td><p> Marker in <tt>`.bbdb'</tt> for start of record
+</p>
+</td></tr>
+<tr><td><p> Deleted
+</p></td><td><p> Boolean
+</p></td><td><p> <code>bbdb-cache-deleted-p</code><br>
+ <code>bbdb-record-deleted-p</code><br>
+ <code>bbdb-cache-set-deleted-p</code><br>
+ <code>bbdb-record-set-deleted-p</code>
+</p></td><td><p> Set to <code>t</code> if record has been deleted, <code>nil</code> if not
+</p>
+</td></tr>
+</table>
+
+<p>The functions listed above will return <code>nil</code> if their respective
+cache fields are not set. The functions listed below will return the
+value of their cache fields if set, but will also build (and set) the
+correct field values if the fields are unset:
+</p>
+<dl compact="compact">
+<dt> <code>bbdb-record-name</code></dt>
+<dd><p>Return the name in the Name Cache field of the cache (if set). If
+the name has not been built yet (if the field is <code>nil</code>), the name is
+built, stored in the Name Cache field, and returned.
+</p>
+</dd>
+<dt> <code>bbdb-record-sortkey</code></dt>
+<dd><p>Return the name it the Sort Key field of the cache (if set). If the
+Sort Key field has not yet been set (if the field is <code>nil</code>), the
+Sort Key is built, stored in the Sort Key field, and returned.
+</p>
+</dd>
+</dl>
+
+<hr size="6">
+<a name="SEC73"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC72" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC74" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.9.1.5 Notes String or Alist </h4>
+
+<p>If there is only a single note for a given record, the notes field for
+that record will be a string. If there is more than one note, the notes
+field will be an association list (alist) with elements of the form
+</p>
+<p align="center"> ( <var>NAME</var> . <var>VALUE</var> )
+</p>
+
+<p>where <var>NAME</var> is the symbol for the name of the note, and
+<var>VALUE</var> is the value of the note.
+</p>
+<hr size="6">
+<a name="SEC74"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC73" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC75" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC68" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h4 class="subsubsection"> 1.9.1.6 Example BBDB record </h4>
+
+<hr size="6">
+<a name="Mailing-Lists"></a>
+<a name="SEC75"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC74" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC76" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.10 Mailing Lists </h2>
+
+<p>(If you are looking for a way to create mailing lists with <b>BBDB</b>, you
+should be looking at the section on See section <a href="#SEC39">Mail Sending Interfaces</a>.)
+</p>
+<p>There are three mailing lists for the <b>BBDB</b>.
+<code>bbdb-info@lists.sourceforge.net</code> gets moderate traffic, and is
+intended for the discussion and distribution of development versions of
+the <b>BBDB</b>. Users of development versions of the <b>BBDB</b> should be
+subscribed to this list. It is also to this list that bugs should be
+reported. See section <a href="#SEC83">Known Bugs</a>. for instructions on submitting bug reports.
+</p>
+<p>The second mailing list <code>bbdb-announce@lists.sourceforge.net</code> has
+very low volume. Any user of the <b>BBDB</b> should consider subscribing to
+this list, as new releases and security issues will be posted here.
+</p>
+<p>A third mailing list, <code>bbdb-cvs@lists.sourceforge.net</code>, is
+intended for developers to follow the changes made to the <b>BBDB</b>
+development version. Developers of the <b>BBDB</b> should consider to
+subscribe to this list.
+</p>
+<hr size="6">
+<a name="Changes"></a>
+<a name="SEC76"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC75" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC77" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.11 Changes in this Version </h2>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC77">1.11.1 Major Changes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Major changes in this version
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC79">1.11.2 Other Changes</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Not-so-major changes
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="Major-Changes"></a>
+<a name="SEC77"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC76" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC79" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC76" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.11.1 Major Changes </h3>
+
+<a name="SEC78"></a>
+<h4 class="subsubheading"> Database File Version Change </h4>
+
+<p>(the following version-migration text will move in a future version. It is in
+this section currently because new users will likely not experience it)
+</p>
+<p>There has been a version change in the <b>BBDB</b> database file. The new
+version supports non-US zip codes, and an additional &quot;Country&quot; field
+in addresses.
+</p>
+<p>An automatic version-migration mechanism has been implemented that allows
+older version <tt>`.bbdb'</tt> files to either be migrated to the new version, or
+used as-is without migrating. When the <b>BBDB</b> detects a database file with
+an old version, it will display the features that have been introduced <b>in
+the database file</b> from the time of the older version's implementation. It
+will offer the choice of migration or use of the <b>BBDB</b> with the
+older-version file.
+</p>
+<p>If migration is chosen, the database file will be automatically changed to the
+new format. If migration is declined, the file will kept in the older format
+in the <code>.bbdb</code> buffer, but will be stored internally in the new format.
+When changes need to be made to the <code>.bbdb</code> buffer, changed records will
+be reverse-migrated from their internal version to that of the disk file.
+</p>
+<hr size="6">
+<a name="Other-Changes"></a>
+<a name="SEC79"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC77" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC81" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC76" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.11.2 Other Changes </h3>
+
+<a name="SEC80"></a>
+<h4 class="subsubheading"> TeX Output </h4>
+
+<p>By default, ec fonts are used for TeX output instead of cm fonts. With
+the <code>ps-fonts</code> option set in <code>bbdb-print-alist</code>, TimesNewRoman
+and Courier fonts are used.
+</p>
+<ul>
+</ul>
+
+<hr size="6">
+<a name="The-Latest-Version"></a>
+<a name="SEC81"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC79" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC82" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.12 The Latest Version </h2>
+
+
+<p>Released versions of the <b>BBDB</b> can be found at the
+following site:
+</p>
+<ul>
+<li>
+WWW: <code>http://bbdb.sourceforge.net</code>
+</li><li>
+FTP: <code>ftp://ftp.sourceforge.net/pub/bbdb</code>
+</li></ul>
+
+
+<p>Development versions of the <b>BBDB</b> can be obtained in the
+following ways:
+</p>
+<ul>
+<li>
+WWW: <code>http://bbdb.sourceforge.net</code>
+</li><li>
+Anonymous CVS: See <code>http://bbdb.sourceforge.net</code> for instructions.
+</li></ul>
+
+<p>Users of development versions of the <b>BBDB</b> should subscribe to the
+<code>bbdb-info</code> mailing list. See section <a href="#SEC75">Mailing Lists</a>.
+</p>
+<hr size="6">
+<a name="The-Future"></a>
+<a name="SEC82"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC81" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC83" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.13 The Future </h2>
+
+<p>The future consists of Bugs and Features.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="#SEC83">1.13.1 Known Bugs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> Known Bugs, and how to submit new ones
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC84">1.13.2 TODO List</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> The TODO List
+</td></tr>
+<tr><td align="left" valign="top"><a href="#SEC88">1.13.3 End of Life (EOL) Statements</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"> EOL (End Of Life) Statements
+</td></tr>
+</table>
+
+<hr size="6">
+<a name="Known-Bugs"></a>
+<a name="SEC83"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC82" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC84" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC82" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.13.1 Known Bugs </h3>
+
+<ol>
+<li>
+<b><kbd>M-TAB</kbd> conflicts with ispell.</b> Workaround: The binding
+installed by the <b>BBDB</b> for address completion/expansion conflicts with
+that used by ispell. The suggested workarounds are to rebind the ispell
+key (the <b>BBDB</b> binding is not configurable at this time), to manually
+invoke ispell via <kbd>M-x</kbd>, or to not use ispell completion functionality
+in <b>BBDB</b>-enabled message composition buffers. The following is an
+example of such a rebinding, supplied by Kai Gro▀johan:
+
+<table><tr><td>&nbsp;</td><td><pre class="lisp">(defun my-message-mode-keys ()
+ (define-key message-mode-map (kbd &quot;M-TAB&quot;) 'bbdb-complete-name))
+ (add-hook 'message-mode-hook 'my-message-mode-keys)
+</pre></td></tr></table>
+</li><li>
+<b><b>BBDB</b> and abbrev expansion is inconsistent.</b> Workaround:
+Currently, <kbd>M-TAB</kbd> must be used to expand/complete against <b>BBDB</b>
+names and net addresses, and <kbd>TAB</kbd> must be used to expand abbrevs (the
+values in the <code>mail-alias</code> field). Unification is planned for a
+future version.
+
+</li><li>
+<b>The <code>*BBDB*</code> buffer does not always come up when the first
+article in a Gnus Summary Buffer is selected.</b> Workaround: Pressing
+<kbd>g</kbd> to reload the article. This will cause the <code>*BBDB*</code> buffer
+to be displayed.
+
+</li><li>
+<b>Expansion will fail when the name to be expanded is a subset of
+the name for another record.</b> For example, if you have entries for
+<samp>`John'</samp> and <samp>`Johnathan'</samp>, you will not be able to expand the
+name for <samp>`John'</samp>. Workaround: Use the net address for the subset
+name (<samp>`John'</samp> in this example).
+
+</li></ol>
+
+<a name="IDX209"></a>
+<p>It is commonly known that there are no bugs in the <b>BBDB</b>. Bugs
+found in defiance of this rule should be submitted using <kbd>M-x
+bbdb-submit-bug-report</kbd>. These bug reports will bbe sent to the
+<code>bbdb-info</code> mailing list (see section <a href="#SEC75">Mailing Lists</a>) and are
+available from public archives. Other big brothers may be reading
+your bug reports.
+</p>
+<hr size="6">
+<a name="TODO-List"></a>
+<a name="SEC84"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC83" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC88" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC82" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.13.2 TODO List </h3>
+
+<a name="SEC85"></a>
+<h4 class="subsubheading"> The Near Future </h4>
+
+<ul>
+<li>
+Add bbdb/<i>MUA</i>-delete-sender-record
+
+</li><li>
+Configurable completion. Should allow user to specify &quot;complete on
+names first, then nets&quot;, etc.
+
+</li><li>
+More variables for upgrading. Specifically a variable that lets users
+specify extra fields for upgrading (an alist <samp>`(a . b)'</samp> that says
+field <samp>`a'</samp> should be upgraded the same way as field <samp>`b'</samp>.
+
+</li><li>
+Change all functions that switch on MUAs to use compose-mail (ex:
+<code>bbdb-send-mail-internal</code>).
+
+</li><li>
+Soren Dayton's method for generically extending the <b>BBDB</b> with
+special-purpose fields
+
+</li><li>
+Sorting records on alternate keys. <code>bbdb-sort-by</code> from Boris
+Goldowsky.
+
+</li><li>
+Sorting individual types of fields - Sam Steingold's method.
+
+</li><li>
+Button 3 menus (Mark Moll and Soren Dayton)
+
+
+</li><li>
+Conditionalized erasure of properties when text is pasted into the <b>BBDB</b>.
+
+</li><li>
+Should notice when there are <samp>`Reply-To:'</samp> addresses.
+
+</li><li>
+Should have a command for merging together two divergent copies of
+a <tt>`.bbdb'</tt> file (in case you read mail on one machine and news on
+another, for instance.)
+
+</li><li>
+The <samp>`*BBDB*'</samp> buffer should be resized to exactly fit what it's
+displaying, even when not in &quot;electric&quot; mode.
+
+</li><li>
+It should be possible to do completion on last names as well as first
+names.
+
+</li><li>
+The BBDB buffer is left at the top of the stack when GNUS is exited
+because GNUS runs its exit-hooks too early. This should be fixed.
+
+</li><li>
+String area codes (German area codes can begin with zeroes) patch from
+<code>Michael Sperber &lt;sperber@informatik.uni-tuebingen.de&gt;</code>
+
+
+</li><li>
+Default country variable, similar to <code>bbdb-default-area-code</code>.
+
+</li><li>
+Make format self-describing in comment
+
+</li><li>
+ISO-8859-x characters in records for printing.
+
+</li><li>
+Prefix for <kbd>W</kbd> (<code>bbdb-www</code>) command to allow selection of
+different addresses.
+
+</li><li>
+Generalized buttons (via extents) for fields. Example: <samp>`(a . b)'</samp>
+means create button that calls <samp>`b'</samp> for each entry in the <samp>`a'</samp>
+field.
+
+</li><li>
+Remove support for GNUS. Start with lisp Makefile (remove nntp and gnus
+loads).
+
+</li><li>
+More flexible auto-addition. Conditionalizing of addition (conditions
+or supplied function). Prompt if multiple records that meet criteria exist.
+
+</li><li>
+Different output formats. See Toby Speight's <code>&lt;s8iurdodvm.fsf@plato.ansa.co.uk&gt;</code>
+and Bin Mu's <code>&lt;199801221605.KAA23663@DerivaTech.Com&gt;</code>.
+
+</li><li>
+Generalized area-code-split program that could split, for example, based
+on input copied (or straight fetch of page) from the Bellcore NANP page.
+
+</li><li>
+Print multivalue (comma-separated) fields with one value per line
+
+</li><li>
+Easier BBDB extension. See <code>&lt;xcdyb30f3hb.fsf@ra.cs.uchicago.edu&gt;</code>
+from Soren Dayton.
+
+</li><li>
+Take birthdays from the <b>BBDB</b>, add them to calendar. From Boris
+Goldowsky.
+
+</li><li>
+Make mail aliases file for other mailers. From Boris Goldowsky.
+
+</li><li>
+Various patches from Boris Goldowsky in <tt>`bbdb-ext'</tt>.
+
+</li><li>
+Various other patches:
+<ul class="toc">
+<li>-
+<code>bbdb-filters-0.2</code>
+</li><li>-
+<code>bbdb-frame.el</code>
+</li><li>-
+<code>bbdb-letter-1.0</code>
+</li><li>-
+<code>bbdb-plz</code>
+</li><li>-
+<code>bbdb-query</code>
+</li><li>-
+<code>country</code>
+</li><li>-
+<code>country-info</code>
+</li></ul>
+
+<p>Note that these files have not been investigated. They may or
+may not be incorporated.
+</p>
+</li><li>
+Ability to remove all properties from copied strings.
+
+</li></ul>
+
+
+<a name="SEC86"></a>
+<h4 class="subsubheading"> Not-So-Near Future </h4>
+
+<ul>
+<li>
+Fix Gnus scoring so it rebuilds when gnus-score disappears
+
+</li><li>
+Multiline note fields
+
+</li><li>
+Change key to be some kind of unique number
+
+</li><li>
+There should be better support for non-American addresses and phone
+numbers. This might be Near Future if somebody volunteers to send me patches.
+
+</li><li>
+Should reimplement &quot;electric&quot; mode to not be so broken.
+
+</li><li>
+The <kbd>*C-o</kbd> keystroke should add a field to all displayed records.
+Perhaps <kbd>*;</kbd> should append some text to an arbitrary field of all
+displayed records.
+
+</li><li>
+Multiple <tt>`.bbdb'</tt> files with precedence relationships. See Wes
+Hardaker's <br><code>&lt;sdu3awz75a.fsf@oakdale.ucdavis.edu&gt;</code>
+
+</li><li>
+Automatically grab information about a person from their sig. See
+Graham Clark's <code>info-bbdb</code> post
+<code>&lt;6282.199706161624@havra.dcs.ed.ac.uk&gt;</code> and Adrian Aichner's
+<code>info-bbdb</code> post
+<code>&lt;rxsiuzebpgp.fsf@midnight.ecf.teradyne.com&gt;</code>. Would like to have
+<code>bbdb-snarf</code> attack the sig then compare the snarfed data with the
+header data.
+
+</li></ul>
+
+<a name="SEC87"></a>
+<h4 class="subsubheading"> Thoughts </h4>
+
+<ul>
+<li>
+Are there enough hooks?
+
+</li><li>
+The interfaces should share more code.
+
+</li><li>
+The <code>bbdb-create-internal</code> function should be more forgiving.
+
+</li><li>
+More <kbd>*</kbd> commands in general, including <kbd>*d</kbd>.
+</li></ul>
+
+<hr size="6">
+<a name="EOL-Statements"></a>
+<a name="SEC88"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC84" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC89" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="#SEC82" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h3 class="subsection"> 1.13.3 End of Life (EOL) Statements </h3>
+
+<p>The items in the following list describe items for which support will be
+removed in coming versions of the <b>BBDB</b>. The items listed are
+guaranteed to be supported and present only until the EOL date. They
+may be removed without warning at any time thereafter.
+</p>
+<ol>
+<li>
+<code>advertized-bbdb-delete-current-field-or-record</code><br>
+Support for this function will be removed for version 2.2. It is
+recommended that all code depending on this variable be switched to use
+<code>bbdb-delete-current-field-or-record</code>. The two functions have the
+same calling conventions and effects. This EOL statement was added for
+version 2.1.
+
+</li><li>
+Support for the GNUS (not Gnus) newsreader<br>
+The GNUS-specific parts of the <b>BBDB</b> will be actively removed for the
+2.2 release. No further maintenance and/or bugfixes are planned for
+GNUS code at this time. This EOL statement was added for version 2.1.
+</li></ol>
+
+<hr size="6">
+<a name="Thanks"></a>
+<a name="SEC89"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#SEC88" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h2 class="section"> 1.14 Thanks </h2>
+
+<p>Thanks to everyone on the info-bbdb mailing list for many useful
+suggestions. This hack would be far less insidious without their input!
+</p>
+<a name="SEC90"></a>
+<h3 class="subheading"> Thanks list for versions after 2.00.06. </h3>
+
+<p>Thanks to Alex Schroeder, Ronan Waide, Thomas DeWeese, Robert Fenk,
+Didier Verna, Bill Carpenter.
+</p>
+<a name="SEC91"></a>
+<h3 class="subheading"> Thanks list for versions after 1.51 prior to and including 2.00.06. </h3>
+
+<p>Thanks to Adrian Aichner, Kees de Bruin, David Carlton, Soren Dayton,
+Brian Edmonds, Boris Goldowsky, Seth Golub, John Heidemann, Christopher
+Kline, Carsten Leonhardt, Hrvoje Niksic, Jens-Ulrik Hoger Petersen,
+Colin Rafferty, Matt Simmons, Sam Steingold, Marco Walther, Christoph
+Wedler.
+</p>
+<a name="SEC92"></a>
+<h3 class="subheading"> Thanks list for versions prior to and including 1.51. </h3>
+
+<p>And special thanks to Sebastian Kremer, Joe Wells, Todd Kaufmann, Andy
+Norman, Ivan Vazquez, Stewart Clamen, Roland McGrath, Dave Brennan,
+Kimball Collins, Dirk Grunwald, Philippe Queinnec, Boris Putanec, Dave
+Disser, Francois Felix Ingrand, Sean Owens, Guido Bosch, Lance Brown,
+Tom Emerson, George Hartzell, Luis Miguel Silveira, Kimmo Suominen,
+Derek Upham, David Zuhn, Rod Whitby, Richard Mlynarik.
+</p>
+<p>Last, but not least, thanks to Jamie Zawinski for writing <b>BBDB</b> in the
+first place.
+</p>
+
+<hr size="6">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>
diff --git a/texinfo/bbdb/bbdb_2.html b/texinfo/bbdb/bbdb_2.html
new file mode 100644
index 0000000..049afc4
--- /dev/null
+++ b/texinfo/bbdb/bbdb_2.html
@@ -0,0 +1,323 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: Concept Index</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: Concept Index">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: Concept Index">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="Concept-Index"></a>
+<a name="SEC93"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb_1.html#SEC89" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_3.html#SEC94" title="Next section in reading order"> &gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_3.html#SEC94" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h1 class="unnumbered"> Concept Index </h1>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#SEC93_0" class="summary-letter"><b>%</b></a>
+ &nbsp;
+<a href="#SEC93_1" class="summary-letter"><b>*</b></a>
+ &nbsp;
+<br>
+<a href="#SEC93_2" class="summary-letter"><b>A</b></a>
+ &nbsp;
+<a href="#SEC93_3" class="summary-letter"><b>B</b></a>
+ &nbsp;
+<a href="#SEC93_4" class="summary-letter"><b>C</b></a>
+ &nbsp;
+<a href="#SEC93_5" class="summary-letter"><b>D</b></a>
+ &nbsp;
+<a href="#SEC93_6" class="summary-letter"><b>E</b></a>
+ &nbsp;
+<a href="#SEC93_7" class="summary-letter"><b>F</b></a>
+ &nbsp;
+<a href="#SEC93_8" class="summary-letter"><b>G</b></a>
+ &nbsp;
+<a href="#SEC93_9" class="summary-letter"><b>I</b></a>
+ &nbsp;
+<a href="#SEC93_10" class="summary-letter"><b>L</b></a>
+ &nbsp;
+<a href="#SEC93_11" class="summary-letter"><b>M</b></a>
+ &nbsp;
+<a href="#SEC93_12" class="summary-letter"><b>N</b></a>
+ &nbsp;
+<a href="#SEC93_13" class="summary-letter"><b>O</b></a>
+ &nbsp;
+<a href="#SEC93_14" class="summary-letter"><b>P</b></a>
+ &nbsp;
+<a href="#SEC93_15" class="summary-letter"><b>R</b></a>
+ &nbsp;
+<a href="#SEC93_16" class="summary-letter"><b>S</b></a>
+ &nbsp;
+<a href="#SEC93_17" class="summary-letter"><b>T</b></a>
+ &nbsp;
+<a href="#SEC93_18" class="summary-letter"><b>U</b></a>
+ &nbsp;
+<a href="#SEC93_19" class="summary-letter"><b>V</b></a>
+ &nbsp;
+<a href="#SEC93_20" class="summary-letter"><b>X</b></a>
+ &nbsp;
+<a href="#SEC93_21" class="summary-letter"><b>Z</b></a>
+ &nbsp;
+</td></tr></table>
+<table border="0" class="index-cp">
+<tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_0">%</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC49">%F</a></td><td valign="top"><a href="bbdb_1.html#SEC49">1.5.2.1 VM Message Summary Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC49">%UB</a></td><td valign="top"><a href="bbdb_1.html#SEC49">1.5.2.1 VM Message Summary Enhancements</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_1">*</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX26">*BBDB* buffer</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_2">A</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX35">Adding new fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX24">Adding new records</a></td><td valign="top"><a href="bbdb_1.html#SEC32">1.2.4 Manual record addition</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC39">Address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX152">Address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX157">Address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX162">Address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX167">Address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX127">Address display</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX140">AKA</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX139">Alternate names</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX92">Annotating the sender of the current message</a></td><td valign="top"><a href="bbdb_1.html#SEC36">1.4 Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX144">Auto-save files</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX146">Automatic display of the corresponding record</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX196">Automatically adding text to records</a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX136">Automatically creating records</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX189">Automatically creating records</a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_3">B</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX25">BBDB Mode</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX69">Browsing the Web page for the current record</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX209">Bug Reports</a></td><td valign="top"><a href="bbdb_1.html#SEC83">1.13.1 Known Bugs</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX1">Builtin field types</a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_4">C</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX29">Changing fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX73">Changing windows</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX119">Checking zip codes</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX149">Completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX154">Completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX159">Completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX164">Completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX129">Continental addresses</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX23">Creating new records</a></td><td valign="top"><a href="bbdb_1.html#SEC32">1.2.4 Manual record addition</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX74">Creating new records</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_5">D</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX32">Deleting fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX58">Dialling phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX126">Display of addresses</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX76">Displaying changed records</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_6">E</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX28">Editing fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX132">Electric display</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX16">Elided display</a></td><td valign="top"><a href="bbdb_1.html#SEC30">1.2.2 Basic searching commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX130">European addresses</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX40">European phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX115">European phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_7">F</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX63">Finger interface</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX55">Fixing mistakes</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC39">Format of completed address</a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX125">Formatting addresses</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_8">G</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX105">GNUS Subject-buffer</a></td><td valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_9">I</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC13">Initial Configuration</a></td><td valign="top"><a href="bbdb_1.html#SEC13">1.1.4 Initial Configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX36">Inserting new fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC2">Installation</a></td><td valign="top"><a href="bbdb_1.html#SEC2">1.1 Installation</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX120">Invalid zip codes</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_10">L</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX122">List of valid zip codes</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_11">M</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC39">Mail address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX151">Mail address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX156">Mail address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX161">Mail address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX166">Mail address completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC40">Mail Aliases</a></td><td valign="top"><a href="bbdb_1.html#SEC40">Mailing Lists and Mail Aliases</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX6">mail-alias definition</a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC40">mail-alias usage</a></td><td valign="top"><a href="bbdb_1.html#SEC40">Mailing Lists and Mail Aliases</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC40">Mailing lists</a></td><td valign="top"><a href="bbdb_1.html#SEC40">Mailing Lists and Mail Aliases</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC2">Makefile</a></td><td valign="top"><a href="bbdb_1.html#SEC2">1.1 Installation</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX106">mark-char</a></td><td valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX56">Merging records</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_12">N</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC39">Name completion</a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX150">Name completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX155">Name completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX160">Name completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX165">Name completion</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC4">Normal User Installation</a></td><td valign="top"><a href="bbdb_1.html#SEC4">1.1.2 Normal User Installation</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX39">North American phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX114">North American phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX121">Not a valid zip code</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_13">O</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX17">One-line display</a></td><td valign="top"><a href="bbdb_1.html#SEC30">1.2.2 Basic searching commands</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_14">P</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX38">Phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX112">Phone numbers</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX7">Printing records in the database</a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX71">Printing records in the database</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC64">Printing records in the database</a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_15">R</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX33">Removing fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX42">Reordering fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_16">S</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX53">Saving your changes</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX9">Searching the database</a></td><td valign="top"><a href="bbdb_1.html#SEC30">1.2.2 Basic searching commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX78">Searching the database</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX80">Searching the database</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX50">Sending mail</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX99">Sending mail</a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX87">Showing the sender of the current message</a></td><td valign="top"><a href="bbdb_1.html#SEC36">1.4 Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX2">Special Field Names</a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC63">Storing FTP sites in the BBDB</a></td><td valign="top"><a href="bbdb_1.html#SEC63">1.8.1 <code>bbdb-ftp</code></a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_17">T</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC61">Timestamping records</a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX43">Transposing fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_18">U</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX15">User-defined fields</a></td><td valign="top"><a href="bbdb_1.html#SEC30">1.2.2 Basic searching commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX37">User-defined fields</a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_19">V</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX123">Valid zip codes</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_20">X</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC10">XEmacs Package Installation</a></td><td valign="top"><a href="bbdb_1.html#SEC10">1.1.3 XEmacs Package Installation</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC93_21">Z</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX118">Zip code checking</a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+</table>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#SEC93_0" class="summary-letter"><b>%</b></a>
+ &nbsp;
+<a href="#SEC93_1" class="summary-letter"><b>*</b></a>
+ &nbsp;
+<br>
+<a href="#SEC93_2" class="summary-letter"><b>A</b></a>
+ &nbsp;
+<a href="#SEC93_3" class="summary-letter"><b>B</b></a>
+ &nbsp;
+<a href="#SEC93_4" class="summary-letter"><b>C</b></a>
+ &nbsp;
+<a href="#SEC93_5" class="summary-letter"><b>D</b></a>
+ &nbsp;
+<a href="#SEC93_6" class="summary-letter"><b>E</b></a>
+ &nbsp;
+<a href="#SEC93_7" class="summary-letter"><b>F</b></a>
+ &nbsp;
+<a href="#SEC93_8" class="summary-letter"><b>G</b></a>
+ &nbsp;
+<a href="#SEC93_9" class="summary-letter"><b>I</b></a>
+ &nbsp;
+<a href="#SEC93_10" class="summary-letter"><b>L</b></a>
+ &nbsp;
+<a href="#SEC93_11" class="summary-letter"><b>M</b></a>
+ &nbsp;
+<a href="#SEC93_12" class="summary-letter"><b>N</b></a>
+ &nbsp;
+<a href="#SEC93_13" class="summary-letter"><b>O</b></a>
+ &nbsp;
+<a href="#SEC93_14" class="summary-letter"><b>P</b></a>
+ &nbsp;
+<a href="#SEC93_15" class="summary-letter"><b>R</b></a>
+ &nbsp;
+<a href="#SEC93_16" class="summary-letter"><b>S</b></a>
+ &nbsp;
+<a href="#SEC93_17" class="summary-letter"><b>T</b></a>
+ &nbsp;
+<a href="#SEC93_18" class="summary-letter"><b>U</b></a>
+ &nbsp;
+<a href="#SEC93_19" class="summary-letter"><b>V</b></a>
+ &nbsp;
+<a href="#SEC93_20" class="summary-letter"><b>X</b></a>
+ &nbsp;
+<a href="#SEC93_21" class="summary-letter"><b>Z</b></a>
+ &nbsp;
+</td></tr></table>
+
+<hr size="6">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_3.html#SEC94" title="Next chapter"> &gt;&gt; </a>]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>
diff --git a/texinfo/bbdb/bbdb_3.html b/texinfo/bbdb/bbdb_3.html
new file mode 100644
index 0000000..73c27e0
--- /dev/null
+++ b/texinfo/bbdb/bbdb_3.html
@@ -0,0 +1,192 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: Variable Index</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: Variable Index">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: Variable Index">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="Variable-Index"></a>
+<a name="SEC94"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Previous section in reading order"> &lt; </a>]</td>
+<td valign="middle" align="left">[ &gt; ]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Up section"> Up </a>]</td>
+<td valign="middle" align="left">[ &gt;&gt; ]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h1 class="unnumbered"> Variable Index </h1>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#SEC94_0" class="summary-letter"><b>B</b></a>
+ &nbsp;
+<a href="#SEC94_1" class="summary-letter"><b>G</b></a>
+ &nbsp;
+<a href="#SEC94_2" class="summary-letter"><b>V</b></a>
+ &nbsp;
+</td></tr></table>
+<table border="0" class="index-vr">
+<tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC94_0">B</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX124"><code>bbdb-address-formatting-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX179"><code>bbdb-after-read-db-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX169"><code>bbdb-always-add-addresses</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX195"><code>bbdb-auto-notes-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX197"><code>bbdb-auto-notes-ignore</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX198"><code>bbdb-auto-notes-ignore-all</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX142"><code>bbdb-auto-revert-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX183"><code>bbdb-canonicalize-net-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX171"><code>bbdb-canonicalize-redundant-nets-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX133"><code>bbdb-case-fold-search</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX176"><code>bbdb-change-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX184"><code>bbdb-change-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX116"><code>bbdb-check-zip-codes-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX158"><code>bbdb-complete-name-allow-cycling</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX163"><code>bbdb-complete-name-full-completion</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX97"><code>bbdb-completion-display-record</code></a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX148"><code>bbdb-completion-type</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX128"><code>bbdb-continental-zip-regexp</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX175"><code>bbdb-create-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX111"><code>bbdb-default-area-code</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX60"><code>bbdb-dial-local-prefix</code></a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX59"><code>bbdb-dial-local-prefix-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX61"><code>bbdb-dial-long-distance-prefix</code></a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC39"><code>bbdb-dwim-net-address-allow-redundancy</code></a></td><td valign="top"><a href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX131"><code>bbdb-electric-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX153"><code>bbdb-expand-mail-aliases</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX110"><code>bbdb-file</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX4"><code>bbdb-finger-host-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX64"><code>bbdb-finger-host-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX100"><code>bbdb-get-addresses-from-headers</code></a></td><td valign="top"><a href="bbdb_1.html#SEC41">1.5 Reader-specific Features</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX102"><code>bbdb-get-addresses-headers</code></a></td><td valign="top"><a href="bbdb_1.html#SEC41">1.5 Reader-specific Features</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX101"><code>bbdb-get-addresses-to-headers</code></a></td><td valign="top"><a href="bbdb_1.html#SEC41">1.5 Reader-specific Features</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX103"><code>bbdb-get-only-first-address-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC41">1.5 Reader-specific Features</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX188"><code>bbdb-ignore-most-messages-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX193"><code>bbdb-ignore-some-messages-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX68"><code>bbdb-info-file</code></a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX181"><code>bbdb-initialize-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX117"><code>bbdb-legal-zip-codes</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX174"><code>bbdb-list-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX180"><code>bbdb-load-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX172"><code>bbdb-message-caching-enabled</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX177"><code>bbdb-mode-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX170"><code>bbdb-new-nets-always-primary</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX113"><code>bbdb-north-american-phone-numbers-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX143"><code>bbdb-notice-auto-save-file</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX178"><code>bbdb-notice-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX194"><code>bbdb-notice-hook</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX173"><code>bbdb-offer-save</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX147"><code>bbdb-pop-up-target-lines</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX202"><code>bbdb-print-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX203"><code>bbdb-print-brief-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX206"><code>bbdb-print-epilog</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX200"><code>bbdb-print-file-name</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX204"><code>bbdb-print-full-alist</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX199"><code>bbdb-print-omit-fields</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX205"><code>bbdb-print-prolog</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX201"><code>bbdb-print-require</code></a></td><td valign="top"><a href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX137"><code>bbdb-quiet-about-name-mismatches</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX141"><code>bbdb-readonly-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX51"><code>bbdb-send-mail-style</code></a></td><td valign="top"><a href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX138"><code>bbdb-use-alternate-names</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX145"><code>bbdb-use-pop-up</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX168"><code>bbdb-user-mail-names</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX107"><code>bbdb/gnus-header-prefer-real-names</code></a></td><td valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX108"><code>bbdb/gnus-header-show-bbdb-names</code></a></td><td valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX109"><code>bbdb/gnus-lines-and-from-length</code></a></td><td valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX104"><code>bbdb/gnus-mark-known-posters</code></a></td><td valign="top"><a href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC43"><code>bbdb/gnus-score-default</code></a></td><td valign="top"><a href="bbdb_1.html#SEC43">1.5.1.1 Scoring</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX5"><code>bbdb/gnus-score-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC43"><code>bbdb/gnus-score-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC43">1.5.1.1 Scoring</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX134"><code>bbdb/mail-auto-create-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX190"><code>bbdb/mail-auto-create-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX135"><code>bbdb/news-auto-create-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX191"><code>bbdb/news-auto-create-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX3"><code>bbdb/sc-attribution-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX207"><code>bbdb/srv-auto-create-p</code></a></td><td valign="top"><a href="bbdb_1.html#SEC66">1.8.4 <code>bbdb-srv</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#IDX208"><code>bbdb/srv-display-delay</code></a></td><td valign="top"><a href="bbdb_1.html#SEC66">1.8.4 <code>bbdb-srv</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC52"><code>bbdb/vm-auto-add-label-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC52">1.5.2.4 VM automatic adding of labels</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC52"><code>bbdb/vm-auto-add-label-list</code></a></td><td valign="top"><a href="bbdb_1.html#SEC52">1.5.2.4 VM automatic adding of labels</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC51"><code>bbdb/vm-set-auto-folder-alist-field</code></a></td><td valign="top"><a href="bbdb_1.html#SEC51">1.5.2.3 VM automatic setup of <code>vm-set-auto-folder-alist</code></a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC94_1">G</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC43"><code>gnus-score-find-score-files-function</code></a></td><td valign="top"><a href="bbdb_1.html#SEC43">1.5.1.1 Scoring</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+<tr><th><a name="SEC94_2">V</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC49"><code>vm-summary-format</code></a></td><td valign="top"><a href="bbdb_1.html#SEC49">1.5.2.1 VM Message Summary Enhancements</a></td></tr>
+<tr><td></td><td valign="top"><a href="bbdb_1.html#SEC50"><code>vm-summary-uninteresting-senders</code></a></td><td valign="top"><a href="bbdb_1.html#SEC50">1.5.2.2 VM configuration of what records the <b>BBDB</b> buffer shows</a></td></tr>
+<tr><td colspan="3"> <hr></td></tr>
+</table>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#SEC94_0" class="summary-letter"><b>B</b></a>
+ &nbsp;
+<a href="#SEC94_1" class="summary-letter"><b>G</b></a>
+ &nbsp;
+<a href="#SEC94_2" class="summary-letter"><b>V</b></a>
+ &nbsp;
+</td></tr></table>
+
+<hr size="6">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
+<td valign="middle" align="left">[ &gt;&gt; ]</td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left"> &nbsp; </td>
+<td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>
diff --git a/texinfo/bbdb/bbdb_abt.html b/texinfo/bbdb/bbdb_abt.html
new file mode 100644
index 0000000..6879c43
--- /dev/null
+++ b/texinfo/bbdb/bbdb_abt.html
@@ -0,0 +1,166 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: About This Document</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: About This Document">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: About This Document">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="SEC_About"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h1>About This Document</h1>
+<p>
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+</p>
+<p>
+ The buttons in the navigation panels have the following meaning:
+</p>
+<table border="1">
+ <tr>
+ <th> Button </th>
+ <th> Name </th>
+ <th> Go to </th>
+ <th> From 1.2.3 go to</th>
+ </tr>
+ <tr>
+ <td align="center"> [ &lt; ] </td>
+ <td align="center">Back</td>
+ <td>previous section in reading order</td>
+ <td>1.2.2</td>
+ </tr>
+ <tr>
+ <td align="center"> [ &gt; ] </td>
+ <td align="center">Forward</td>
+ <td>next section in reading order</td>
+ <td>1.2.4</td>
+ </tr>
+ <tr>
+ <td align="center"> [ &lt;&lt; ] </td>
+ <td align="center">FastBack</td>
+ <td>beginning of this chapter or previous chapter</td>
+ <td>1</td>
+ </tr>
+ <tr>
+ <td align="center"> [ Up ] </td>
+ <td align="center">Up</td>
+ <td>up section</td>
+ <td>1.2</td>
+ </tr>
+ <tr>
+ <td align="center"> [ &gt;&gt; ] </td>
+ <td align="center">FastForward</td>
+ <td>next chapter</td>
+ <td>2</td>
+ </tr>
+ <tr>
+ <td align="center"> [Top] </td>
+ <td align="center">Top</td>
+ <td>cover (top) of document</td>
+ <td> &nbsp; </td>
+ </tr>
+ <tr>
+ <td align="center"> [Contents] </td>
+ <td align="center">Contents</td>
+ <td>table of contents</td>
+ <td> &nbsp; </td>
+ </tr>
+ <tr>
+ <td align="center"> [Index] </td>
+ <td align="center">Index</td>
+ <td>index</td>
+ <td> &nbsp; </td>
+ </tr>
+ <tr>
+ <td align="center"> [ ? ] </td>
+ <td align="center">About</td>
+ <td>about (help)</td>
+ <td> &nbsp; </td>
+ </tr>
+</table>
+
+<p>
+ where the <strong> Example </strong> assumes that the current position is at <strong> Subsubsection One-Two-Three </strong> of a document of the following structure:
+</p>
+
+<ul>
+ <li> 1. Section One
+ <ul>
+ <li>1.1 Subsection One-One
+ <ul>
+ <li>...</li>
+ </ul>
+ </li>
+ <li>1.2 Subsection One-Two
+ <ul>
+ <li>1.2.1 Subsubsection One-Two-One</li>
+ <li>1.2.2 Subsubsection One-Two-Two</li>
+ <li>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp;
+ <strong>&lt;== Current Position </strong></li>
+ <li>1.2.4 Subsubsection One-Two-Four</li>
+ </ul>
+ </li>
+ <li>1.3 Subsection One-Three
+ <ul>
+ <li>...</li>
+ </ul>
+ </li>
+ <li>1.4 Subsection One-Four</li>
+ </ul>
+ </li>
+</ul>
+
+<hr size="1">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>
diff --git a/texinfo/bbdb/bbdb_fot.html b/texinfo/bbdb/bbdb_fot.html
new file mode 100644
index 0000000..c683a7d
--- /dev/null
+++ b/texinfo/bbdb/bbdb_fot.html
@@ -0,0 +1,99 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: Footnotes</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: Footnotes">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: Footnotes">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="SEC_Foot"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h1>Footnotes</h1>
+<h3><a name="FOOT1" href="bbdb_1.html#DOCF1">(1)</a></h3>
+<p>&quot;Core Functionality&quot; is defined as the parts of
+the <b>BBDB</b> used to implement basic record creation (<samp>`M-x
+bbdb-create'</samp>) and searching (<samp>`M-x bbdb'</samp>).
+</p><h3><a name="FOOT2" href="bbdb_1.html#DOCF2">(2)</a></h3>
+<p>This
+documentation can be accessed by typing <kbd>C-h f bbdb-initialize RET</kbd>.
+</p><h3><a name="FOOT3" href="bbdb_1.html#DOCF3">(3)</a></h3>
+<p>If you are using GNUS (not Gnus),
+ and if your GNUS version is 3.14 or older, use the <code>Gnus</code> (note
+ the capitalization) symbol.
+</p><h3><a name="FOOT4" href="bbdb_1.html#DOCF4">(4)</a></h3>
+<p>For the VM
+ initialization to work properly, you must either call
+ <code>bbdb-initialize</code> with the <code>vm</code> symbol from within your VM
+ initialization file (<tt>`~/.vm'</tt>), or you must call
+ <code>bbdb-insinuate-vm</code> manually from within your VM initialization
+ file.
+</p><h3><a name="FOOT5" href="bbdb_1.html#DOCF5">(5)</a></h3>
+<p>While it is possible to put a multi-character mark
+in <code>bbdb-message-marker-field</code> and/or in
+<code>bbdb/gnus-summary-known-poster-mark</code>, the resulting summary buffer
+will be misaligned as a result. This misalignment will result from fact
+that at this time the character used to indicate posts whose authors are
+not in the <b>BBDB</b> is always a single character, and cannot be
+changed.
+</p><h3><a name="FOOT6" href="bbdb_1.html#DOCF6">(6)</a></h3>
+<p><code>bbdb-snarf</code> is actually a wrapper for
+<code>bbdb-snarf-region</code> that determines the relevant region and passes it
+on.
+</p><h3><a name="FOOT7" href="bbdb_1.html#DOCF7">(7)</a></h3>
+<p>Use the full path to <code>bbdb-srv.pl</code> if
+it is not in the default path.
+</p><hr size="1">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>
diff --git a/texinfo/bbdb/bbdb_toc.html b/texinfo/bbdb/bbdb_toc.html
new file mode 100644
index 0000000..665daac
--- /dev/null
+++ b/texinfo/bbdb/bbdb_toc.html
@@ -0,0 +1,178 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
+<html>
+<!-- Created on February, 4 2006 by texi2html 1.76 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<head>
+<title>Insidious Big Brother Database User Manual: Table of Contents</title>
+
+<meta name="description" content="Insidious Big Brother Database User Manual: Table of Contents">
+<meta name="keywords" content="Insidious Big Brother Database User Manual: Table of Contents">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="texi2html 1.76">
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+pre.display {font-family: serif}
+pre.format {font-family: serif}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: serif; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: serif; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.sansserif {font-family:sans-serif; font-weight:normal;}
+ul.toc {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+
+<a name="SEC_Contents"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<h1>Table of Contents</h1>
+<div class="contents">
+
+<ul class="toc">
+ <li><a name="TOC1" href="bbdb.html#SEC1">1. BBDB</a>
+ <ul class="toc">
+ <li><a name="TOC2" href="bbdb_1.html#SEC2">1.1 Installation</a>
+ <ul class="toc">
+ <li><a name="TOC3" href="bbdb_1.html#SEC3">1.1.1 General Prerequisites</a></li>
+ <li><a name="TOC4" href="bbdb_1.html#SEC4">1.1.2 Normal User Installation</a></li>
+ <li><a name="TOC5" href="bbdb_1.html#SEC10">1.1.3 XEmacs Package Installation</a></li>
+ <li><a name="TOC6" href="bbdb_1.html#SEC13">1.1.4 Initial Configuration</a>
+ <ul class="toc">
+ <li><a name="TOC7" href="bbdb_1.html#SEC19">1.1.4.1 Initializing <b>BBDB</b> support for Gnus</a></li>
+ <li><a name="TOC8" href="bbdb_1.html#SEC20">1.1.4.2 Initializing <b>BBDB</b> support for MH-E</a></li>
+ <li><a name="TOC9" href="bbdb_1.html#SEC21">1.1.4.3 Initializing <b>BBDB</b> support for RMAIL</a></li>
+ <li><a name="TOC10" href="bbdb_1.html#SEC22">1.1.4.4 Initializing <b>BBDB</b> support for Sendmail</a></li>
+ <li><a name="TOC11" href="bbdb_1.html#SEC23">1.1.4.5 Initializing <b>BBDB</b> support for VM</a></li>
+ <li><a name="TOC12" href="bbdb_1.html#SEC24">1.1.4.6 Initializing <b>BBDB</b> support for Message mode</a></li>
+ <li><a name="TOC13" href="bbdb_1.html#SEC25">1.1.4.7 Initializing <b>BBDB</b> support for Reportmail</a></li>
+ <li><a name="TOC14" href="bbdb_1.html#SEC26">1.1.4.8 Initializing <b>BBDB</b> support for Supercite</a></li>
+ <li><a name="TOC15" href="bbdb_1.html#SEC27">1.1.4.9 Initializing <b>BBDB</b> support for Web Browsers</a></li>
+ </ul>
+</li>
+ </ul></li>
+ <li><a name="TOC16" href="bbdb_1.html#SEC28">1.2 The <b>BBDB</b></a>
+ <ul class="toc">
+ <li><a name="TOC17" href="bbdb_1.html#SEC29">1.2.1 Database Fields</a></li>
+ <li><a name="TOC18" href="bbdb_1.html#SEC30">1.2.2 Basic searching commands</a></li>
+ <li><a name="TOC19" href="bbdb_1.html#SEC31">1.2.3 Advanced searching commands</a></li>
+ <li><a name="TOC20" href="bbdb_1.html#SEC32">1.2.4 Manual record addition</a></li>
+ </ul></li>
+ <li><a name="TOC21" href="bbdb_1.html#SEC33">1.3 BBDB Mode</a>
+ <ul class="toc">
+ <li><a name="TOC22" href="bbdb_1.html#SEC34">1.3.1 Functions bound to keys in <b>BBDB</b> Mode</a></li>
+ <li><a name="TOC23" href="bbdb_1.html#SEC35">1.3.2 Other database manipulation functions</a></li>
+ </ul></li>
+ <li><a name="TOC24" href="bbdb_1.html#SEC36">1.4 Interfaces</a>
+ <ul class="toc">
+ <li><a name="TOC25" href="bbdb_1.html#SEC37">1.4.1 Mail Reading Interfaces</a></li>
+ <li><a name="TOC26" href="bbdb_1.html#SEC38">1.4.2 News Reading Interfaces</a></li>
+ <li><a name="TOC27" href="bbdb_1.html#SEC39">1.4.3 Mail Sending Interfaces</a></li>
+ <li><a name="TOC28" href="bbdb_1.html#SEC40">Mailing Lists and Mail Aliases</a></li>
+ </ul></li>
+ <li><a name="TOC29" href="bbdb_1.html#SEC41">1.5 Reader-specific Features</a>
+ <ul class="toc">
+ <li><a name="TOC30" href="bbdb_1.html#SEC42">1.5.1 Gnus-specific Features</a>
+ <ul class="toc">
+ <li><a name="TOC31" href="bbdb_1.html#SEC43">1.5.1.1 Scoring</a></li>
+ <li><a name="TOC32" href="bbdb_1.html#SEC44">1.5.1.2 Gnus Summary Buffer Enhancements</a></li>
+ <li><a name="TOC33" href="bbdb_1.html#SEC47">1.5.1.3 GNUS Summary Buffer Enhancements</a></li>
+ </ul></li>
+ <li><a name="TOC34" href="bbdb_1.html#SEC48">1.5.2 VM-specific features</a>
+ <ul class="toc">
+ <li><a name="TOC35" href="bbdb_1.html#SEC49">1.5.2.1 VM Message Summary Enhancements</a></li>
+ <li><a name="TOC36" href="bbdb_1.html#SEC50">1.5.2.2 VM configuration of what records the <b>BBDB</b> buffer shows</a></li>
+ <li><a name="TOC37" href="bbdb_1.html#SEC51">1.5.2.3 VM automatic setup of <code>vm-set-auto-folder-alist</code></a></li>
+ <li><a name="TOC38" href="bbdb_1.html#SEC52">1.5.2.4 VM automatic adding of labels</a></li>
+ </ul>
+</li>
+ </ul></li>
+ <li><a name="TOC39" href="bbdb_1.html#SEC53">1.6 Using the <b>BBDB</b> with other packages</a>
+ <ul class="toc">
+ <li><a name="TOC40" href="bbdb_1.html#SEC54">1.6.1 Using the <b>BBDB</b> with Message Mode</a></li>
+ <li><a name="TOC41" href="bbdb_1.html#SEC55">1.6.2 Using the <b>BBDB</b> with Reportmail</a></li>
+ <li><a name="TOC42" href="bbdb_1.html#SEC56">1.6.3 Using the <b>BBDB</b> with Supercite</a></li>
+ <li><a name="TOC43" href="bbdb_1.html#SEC57">1.6.4 Using the <b>BBDB</b> with Web Browsers</a></li>
+ </ul></li>
+ <li><a name="TOC44" href="bbdb_1.html#SEC58">1.7 Options</a>
+ <ul class="toc">
+ <li><a name="TOC45" href="bbdb_1.html#SEC59">1.7.1 Customization Parameters</a></li>
+ <li><a name="TOC46" href="bbdb_1.html#SEC60">1.7.2 Customization Hooks</a></li>
+ <li><a name="TOC47" href="bbdb_1.html#SEC61">1.7.3 Predefined Hooks</a></li>
+ </ul></li>
+ <li><a name="TOC48" href="bbdb_1.html#SEC62">1.8 Utilities</a>
+ <ul class="toc">
+ <li><a name="TOC49" href="bbdb_1.html#SEC63">1.8.1 <code>bbdb-ftp</code></a></li>
+ <li><a name="TOC50" href="bbdb_1.html#SEC64">1.8.2 <code>bbdb-print</code></a></li>
+ <li><a name="TOC51" href="bbdb_1.html#SEC65">1.8.3 <code>bbdb-snarf</code></a></li>
+ <li><a name="TOC52" href="bbdb_1.html#SEC66">1.8.4 <code>bbdb-srv</code></a></li>
+ </ul></li>
+ <li><a name="TOC53" href="bbdb_1.html#SEC67">1.9 Internals</a>
+ <ul class="toc">
+ <li><a name="TOC54" href="bbdb_1.html#SEC68">1.9.1 BBDB data file format</a>
+ <ul class="toc">
+ <li><a name="TOC55" href="bbdb_1.html#SEC69">1.9.1.1 Record Vectors</a></li>
+ <li><a name="TOC56" href="bbdb_1.html#SEC70">1.9.1.2 Phone Vectors</a></li>
+ <li><a name="TOC57" href="bbdb_1.html#SEC71">1.9.1.3 Address Vectors</a></li>
+ <li><a name="TOC58" href="bbdb_1.html#SEC72">1.9.1.4 Cache Vector</a></li>
+ <li><a name="TOC59" href="bbdb_1.html#SEC73">1.9.1.5 Notes String or Alist</a></li>
+ <li><a name="TOC60" href="bbdb_1.html#SEC74">1.9.1.6 Example BBDB record</a></li>
+ </ul>
+</li>
+ </ul></li>
+ <li><a name="TOC61" href="bbdb_1.html#SEC75">1.10 Mailing Lists</a></li>
+ <li><a name="TOC62" href="bbdb_1.html#SEC76">1.11 Changes in this Version</a>
+ <ul class="toc">
+ <li><a name="TOC63" href="bbdb_1.html#SEC77">1.11.1 Major Changes</a></li>
+ <li><a name="TOC64" href="bbdb_1.html#SEC79">1.11.2 Other Changes</a></li>
+ </ul></li>
+ <li><a name="TOC65" href="bbdb_1.html#SEC81">1.12 The Latest Version</a></li>
+ <li><a name="TOC66" href="bbdb_1.html#SEC82">1.13 The Future</a>
+ <ul class="toc">
+ <li><a name="TOC67" href="bbdb_1.html#SEC83">1.13.1 Known Bugs</a></li>
+ <li><a name="TOC68" href="bbdb_1.html#SEC84">1.13.2 TODO List</a></li>
+ <li><a name="TOC69" href="bbdb_1.html#SEC88">1.13.3 End of Life (EOL) Statements</a></li>
+ </ul></li>
+ <li><a name="TOC70" href="bbdb_1.html#SEC89">1.14 Thanks</a></li>
+ </ul></li>
+ <li><a name="TOC71" href="bbdb_2.html#SEC93">Concept Index</a></li>
+ <li><a name="TOC72" href="bbdb_3.html#SEC94">Variable Index</a></li>
+</ul>
+</div>
+<hr size="1">
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="bbdb.html#Top" title="Cover (top) of document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_2.html#SEC93" title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="bbdb_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
+</tr></table>
+<p>
+ <font size="-1">
+ This document was generated by <em>Joerg Jaspert</em> on <em>February, 4 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
+ </font>
+ <br>
+
+</p>
+</body>
+</html>