Merge branch 'master' of https://git.gnus.org/gnus
[gnus] / contrib / README
1 The files in this directory are not (yet) part of the Gnus distribution proper.
2 They may later become part of the distribution, or they may disappear
3 altogether.
4
5 Please note that it is NOT good to just add this directory to `load-path': a
6 number of files in this directory will become part of more recent Emacs
7 versions, so that you might be running obsolete libraries with all kinds of ill
8 effects (cf. `list-load-path-shadows').
9
10 The suggested method for installation is to copy those files that you need to a
11 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 and
18         practical (actually you can replace lisp/compface.el with it), however
19         the author is missing and the copyright has not been assigned yet.
20
21 gnus-namazu.el
22
23         This file defines the command to search mails and persistent articles
24         with Namazu, which is a full-text search engine distributed at
25         <http://namazu.org>, and to browse its results with Gnus.
26
27 gnus-kill-to-score.el
28
29         Convert kill files to score files.  See (info "(gnus)Converting Kill
30         Files").
31
32 one-line-cookie.diff
33
34 sendmail.el
35 smtpmail.el
36
37         Copies of the corresponding files from the Emacs lisp/mail/ directory,
38         to provide features (occasionally) needed by Gnus which may not be
39         provided by the versions of these files in older Emacs distributions
40         (Emacs < 22).  XEmacs users should NOT use this, since it doesn't work.
41         See the XEmacs mail-lib module instead.
42
43 ucs-tables.el
44
45         This file provides improved Unicode functionality.  It defines
46         functions `unify-8859-on-encoding-mode' and
47         `unify-8859-on-decoding-mode' which unify the Latin-N charsets.
48         Without `unify-8859-on-encoding-mode', composing a Latin-9 reply to a
49         Latin-1 posting, say, will produce a multipart posting (a Latin-1 part
50         and a Latin-9 part), or perhaps UTF-8.  With
51         `unify-8859-on-encoding-mode', the outgoing posting can be all Latin-1
52         or all Latin-9 in most cases.
53
54         It is harmless to turn on `unify-8859-on-encoding-mode', but
55         `unify-8859-on-decoding-mode' may unexpectedly change files in
56         certain situations.  (If the file contains different Latin-N
57         charsets which should not be unified.)
58
59         This is part of Emacs 21.3 and later, which also turns on
60         `unify-8859-on-encoding-mode' by default.
61
62 vcard.el
63
64 ;; Local Variables:
65 ;; fill-column: 79
66 ;; End: