Sync with recent gnu.emacs.sources post.
[gnus] / contrib / README
1 The files in this directory are not (yet) part of the Gnus
2 distribution proper.  They may later become part of the distribution,
3 or they may disappear altogether.
4
5 Please note that it is not good to just add this directory to
6 load-path: a number of files in this directory will become part of
7 more recent Emacs versions, so that you might be running obsolete
8 libraries with all kinds of ill effects.
9
10 The suggested method for installation is to copy those files that you
11 need to a directory which is in load-path.
12
13 Here is an overview of the files:
14
15 base64.el
16
17         As of Emacs 21, base64 encoding and decoding is available
18         natively.  So this file appears to be needed for Emacs 20
19         only.
20
21 gpg-ring.el
22 gpg.el
23
24 hashcash.el
25
26 md5.el
27
28         MD5 encoding is part of Emacs as of Emacs 21.2.  Hence, this
29         file is not needed for those Emacs versions.
30
31 one-line-cookie.diff
32
33 ssl.el
34
35 ucs-tables.el
36
37         This file provides improved Unicode functionality.  It defines
38         functions unify-8859-on-encoding-mode and
39         unify-8859-on-decoding-mode which unify the Latin-N charsets.
40         Without unify-8859-on-encoding-mode, composing a Latin-9 reply
41         to a Latin-1 posting, say, will produce a multipart posting (a
42         Latin-1 part and a Latin-9 part), or perhaps UTF-8.  With
43         unify-8859-on-encoding-mode, the outgoing posting can be all
44         Latin-1 or all Latin-9 in most cases.
45
46         It is harmless to turn on unify-8859-on-encoding-mode, but
47         unify-8859-on-decoding-mode may unexpectedly change files in
48         certain situations.  (If the file contains different Latin-N
49         charsets which should not be unified.)
50
51         This is part of Emacs 21.3 and later, which also turns on
52         unify-8859-on-encoding-mode by default.
53
54 vcard.el
55
56 xml.el
57
58         This is used for parsing RSS feeds.  Part of Emacs 21.3 and
59         later.