(Choosing Variables): Fix descriptions.
[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 ucs-tables.el
46
47         This file provides improved Unicode functionality.  It defines
48         functions unify-8859-on-encoding-mode and
49         unify-8859-on-decoding-mode which unify the Latin-N charsets.
50         Without unify-8859-on-encoding-mode, composing a Latin-9 reply
51         to a Latin-1 posting, say, will produce a multipart posting (a
52         Latin-1 part and a Latin-9 part), or perhaps UTF-8.  With
53         unify-8859-on-encoding-mode, the outgoing posting can be all
54         Latin-1 or all Latin-9 in most cases.
55
56         It is harmless to turn on unify-8859-on-encoding-mode, but
57         unify-8859-on-decoding-mode may unexpectedly change files in
58         certain situations.  (If the file contains different Latin-N
59         charsets which should not be unified.)
60
61         This is part of Emacs 21.3 and later, which also turns on
62         unify-8859-on-encoding-mode by default.
63
64 vcard.el
65
66 xml.el
67
68         This is used for parsing RSS feeds.  Part of Emacs 21.3 and
69         later.