Add ssl.el discussion.
[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 compface.el
16
17         Provides the ELisp-based uncompface program.  It is excellent
18         and practical (actually you can replace lisp/compface.el with
19         it), however the author is missing and the copyright has not
20         been assigned yet.
21
22 gnus-namazu.el
23
24         This file defines the command to search mails and persistent
25         articles with Namazu, which is a full-text search engine
26         distributed at http://namazu.org, and to browse its results
27         with Gnus.
28
29 gpg-ring.el
30 gpg.el
31
32 hashcash.el
33
34 nnir.el
35
36         Interface to various full-text search engines.  Provides less
37         functionality than gnus-namazu.el, but also supports programs
38         other than Namazu.  Current implementation is restricted to
39         nnml folders, but could be extended for other backends.
40
41 one-line-cookie.diff
42
43 ssl.el
44
45         Obsolete interface to OpenSSL.  Completely replaced by
46         lisp/tls.el, which supports both GnuTLS and OpenSSL.  This
47         file will be removed eventually.
48
49 ucs-tables.el
50
51         This file provides improved Unicode functionality.  It defines
52         functions unify-8859-on-encoding-mode and
53         unify-8859-on-decoding-mode which unify the Latin-N charsets.
54         Without unify-8859-on-encoding-mode, composing a Latin-9 reply
55         to a Latin-1 posting, say, will produce a multipart posting (a
56         Latin-1 part and a Latin-9 part), or perhaps UTF-8.  With
57         unify-8859-on-encoding-mode, the outgoing posting can be all
58         Latin-1 or all Latin-9 in most cases.
59
60         It is harmless to turn on unify-8859-on-encoding-mode, but
61         unify-8859-on-decoding-mode may unexpectedly change files in
62         certain situations.  (If the file contains different Latin-N
63         charsets which should not be unified.)
64
65         This is part of Emacs 21.3 and later, which also turns on
66         unify-8859-on-encoding-mode by default.
67
68 vcard.el
69
70 xml.el
71
72         This is used for parsing RSS feeds.  Part of Emacs 21.3 and
73         later.