GNU Info

(bbdb.info)Supercite Prep

---

Next: Web Browser Prep Prev: Reportmail Prep Up: Initial Configuration

---

Enter node , (file) or (file)node

Initializing BBDB support for Supercite
.......................................

   To allow the BBDB to assist in the storage of Supercite citations,
add the following form to your Emacs initialization file:

     `(bbdb-insinuate-sc)'

   `bbdb-insinuate-sc' adds BBDB functions to two Supercite hooks -
`sc-post-hook' and `sc-attribs-postselect-hook'.  See Note: Using
Supercite for more details on the operation of Supercite citation
management using the BBDB.

   Three other Supercite variables must be set/modified to allow the
BBDB 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:

`sc-preferred-attribution-list'
     `"sc-consult"' should be added to the list.  An example
     configuration is:

          (setq sc-preferred-attribution-list
            '("sc-lastchoice" "x-attribution" "sc-consult"
              "initials" "firstname" "lastname"))

`sc-attrib-selection-list'
     The following form should be added to `sc-attrib-selection-list':

                '(("sc-from-address"
          	 ((".*" . (bbdb/sc-consult-attr
          		   (sc-mail-field "sc-from-address"))))))

`sc-mail-glom-frame'
     The following form should be added to `sc-mail-glom-frame', to
     allow the retrieval of the name of a person who is a) in the BBDB
     and b) has only included their net address in the message in
     question.

            ("^$"  (progn (bbdb/sc-default)
                      (list 'abort '(step . 0))))

     An example configuration is as follows:

     `(setq sc-mail-glom-frame'
     `   '((begin                        (setq sc-mail-headers-start (point)))'
     `     ("^x-attribution:[ \t]+.*$"   (sc-mail-fetch-field t) nil t)'
     `     ("^\\S +:.*$"                 (sc-mail-fetch-field) nil t)'
     `     ("^$"                         (progn (bbdb/sc-default)'
     `                                   (list 'abort '(step . 0))))'
     `     ("^[ \t]+"                    (sc-mail-append-field))'
     `     (sc-mail-warn-if-non-rfc822-p (sc-mail-error-in-mail-field))'
     `     (end                          (setq sc-mail-headers-end (point)))))'

   The above is also documented in `bbdb-sc.el'.  The
`bbdb/sc-setup-variables' function has been provided as an example for
Supercite variable initialization.  Please note that while
`bbdb/sc-setup-variables' makes every attempt to safely configure the
Supercite variables, it will not always work.  Specifically, the
variables `sc-attrib-selection-list' and `sc-mail-glom-frame' will not
be overridden if they have already been defined.