GNU Info

(emacs-mime)rfc2047

---

Next: time-date Prev: ietf-drums Up: Basic Functions

---

Enter node , (file) or (file)node

rfc2047
=======

   RFC2047 (Message Header Extensions for Non-ASCII Text) specifies how
non-ASCII text in headers are to be encoded.  This is actually rather
complicated, so a number of variables are necessary to tweak what this
library does.

   The following variables are tweakable:

 - Variable: rfc2047-default-charset
     Characters in this charset should not be decoded by this library.
     This defaults to `iso-8859-1'.

 - Variable: rfc2047-header-encoding-list
     This is an alist of header / encoding-type pairs.  Its main
     purpose is to prevent encoding of certain headers.

   The keys can either be header regexps, or `t'.

   The values can be either `nil', in which case the header(s) in
question won't be encoded, or `mime', which means that they will be
encoded.

 - Variable: rfc2047-charset-encoding-alist
     RFC2047 specifies two forms of encoding--`Q' (a
     Quoted-Printable-like encoding) and `B' (base64).  This alist
     specifies which charset should use which encoding.

 - Variable: rfc2047-encoding-function-alist
     This is an alist of encoding / function pairs.  The encodings are
     `Q', `B' and `nil'.

 - Variable: rfc2047-q-encoding-alist
     The `Q' encoding isn't quite the same for all headers.  Some
     headers allow a narrower range of characters, and that is what this
     variable is for.  It's an alist of header regexps and allowable
     character ranges.

 - Variable: rfc2047-encoded-word-regexp
     When decoding words, this library looks for matches to this regexp.

   Those were the variables, and these are the functions:

 - Function: rfc2047-narrow-to-field
     Narrow the buffer to the header on the current line.

 - Function: rfc2047-encode-message-header
     Should be called narrowed to the header of a message.  Encodes
     according to `rfc2047-header-encoding-alist'.

 - Function: rfc2047-encode-region start end
     Encodes all encodable words in the region START to END.

 - Function: rfc2047-encode-string string
     Encode STRING and return the result.

 - Function: rfc2047-decode-region start end
     Decode the encoded words in the region START to END.

 - Function: rfc2047-decode-string string
     Decode STRING and return the result.