Mail header information keys are nuggets of information that
Supercite extracts from the various mail headers of the original
message, placed in the reply buffer by the MUA. Information is kept
in the Info Alist as key-value pairs, and can be retrieved for
use in various places within Supercite, such as in header rewrite
functions and attribution selection. Other bits of data, composed and
created by Supercite, are also kept as key-value pairs in this alist.
In the case of mail fields, the key is the name of the field, omitting
the trailing colon. Info keys are always case insensitive (as are
mail headers), and the value for a corresponding key can be retrieved
from the alist with the sc-mail-field
function. Thus, if the
following fields were present in the original article:
Date: 08 April 1991, 17:32:09 EST Subject: Better get out your asbestos suit
then, the following lisp constructs return:
(sc-mail-field "date") ==> "08 April 1991, 17:32:09 EST" (sc-mail-field "subject") ==> "Better get out your asbestos suit"
Since the argument to sc-mail-field
can be any string, it is
possible that the mail field will not be present on the info alist
(possibly because the mail header was not present in the original
message). In this case, sc-mail-field
will return the value of
the variable sc-mumble
.
Supercite always places all mail fields found in the yanked original article into the info alist. If possible, Supercite will also places the following keys into the info alist:
"sc-attribution"
the selected attribution string.
"sc-citation"
the non-nested citation string.
"sc-from-address"
email address extracted from the ‘From:’ field.
"sc-reply-address"
email address extracted from the ‘Reply-To:’ field.
"sc-sender-address"
email address extracted from the ‘Sender:’ field.
"sc-emailname"
email terminus extracted from the ‘From:’ field.
"sc-initials"
the author’s initials.
"sc-author"
the author’s full name.
"sc-firstname"
the author’s first name.
"sc-lastname"
the author’s last name.
"sc-middlename-1"
the author’s first middle name.
If the author’s name has more than one middle name, they will appear as
info keys with the appropriate index (e.g., "sc-middlename-2"
,
…). See Selecting an Attribution.