cgit.sxemacs.org Git - gnus/blob - 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 gpg-ring.el
  28 gpg.el
  29
  30         Obsoleted by PGG and EasyPG.
  31
  32 nnir.el
  33
  34         Interface to various full-text search engines.  Provides less
  35         functionality than `gnus-namazu.el', but also supports programs other
  36         than Namazu.  Current implementation is restricted to nnml folders, but
  37         could be extended for other backends.
  38
  39 one-line-cookie.diff
  40
  41 sendmail.el
  42 smtpmail.el
  43
  44         Copies of the corresponding files from the Emacs lisp/mail/ directory,
  45         to provide features (occasionally) needed by Gnus which may not be
  46         provided by the versions of these files in older Emacs distributions
  47         (Emacs < 22).  XEmacs users should NOT use this, since it doesn't work.
  48         See the XEmacs mail-lib module instead.
  49
  50 ssl.el
  51
  52         Obsolete interface to OpenSSL.  Completely replaced by `lisp/tls.el',
  53         which supports both GnuTLS and OpenSSL.  This file will be removed
  54         eventually.
  55
  56 ucs-tables.el
  57
  58         This file provides improved Unicode functionality.  It defines
  59         functions `unify-8859-on-encoding-mode' and
  60         `unify-8859-on-decoding-mode' which unify the Latin-N charsets.
  61         Without `unify-8859-on-encoding-mode', composing a Latin-9 reply to a
  62         Latin-1 posting, say, will produce a multipart posting (a Latin-1 part
  63         and a Latin-9 part), or perhaps UTF-8.  With
  64         `unify-8859-on-encoding-mode', the outgoing posting can be all Latin-1
  65         or all Latin-9 in most cases.
  66
  67         It is harmless to turn on `unify-8859-on-encoding-mode', but
  68         `unify-8859-on-decoding-mode' may unexpectedly change files in
  69         certain situations.  (If the file contains different Latin-N
  70         charsets which should not be unified.)
  71
  72         This is part of Emacs 21.3 and later, which also turns on
  73         `unify-8859-on-encoding-mode' by default.
  74
  75 vcard.el
  76
  77 xml.el
  78
  79         This is used for parsing RSS feeds.  Part of Emacs 21.3 and later.
  80         Note that the version of this file in the Gnus contrib/ directory is
  81         out of date with respect to the version in the Emacs tree, so don't use
  82         this file unless using Emacs < 21.3.
  83
  84 ;; Local Variables:
  85 ;; fill-column: 79
  86 ;; End: