X-Git-Url: http://cgit.sxemacs.org/?a=blobdiff_plain;f=contrib%2FREADME;h=b9622a7c1616509394704531795faa27b397535e;hb=67de1ba513ba94dc786ab20840e9315c7c1dfe7a;hp=b1fdc062bd3dd4f77ded80db256a8c28fc136ae1;hpb=c048cd58d527e652634ca5841bb048b55dac2445;p=gnus diff --git a/contrib/README b/contrib/README index b1fdc062b..b9622a7c1 100644 --- a/contrib/README +++ b/contrib/README @@ -1,62 +1,84 @@ -The files in this directory are not (yet) part of the Gnus -distribution proper. They may later become part of the distribution, -or they may disappear altogether. +The files in this directory are not (yet) part of the Gnus distribution proper. +They may later become part of the distribution, or they may disappear +altogether. -Please note that it is not good to just add this directory to -load-path: a number of files in this directory will become part of -more recent Emacs versions, so that you might be running obsolete -libraries with all kinds of ill effects. +Please note that it is NOT good to just add this directory to `load-path': a +number of files in this directory will become part of more recent Emacs +versions, so that you might be running obsolete libraries with all kinds of ill +effects (cf. `list-load-path-shadows'). -The suggested method for installation is to copy those files that you -need to a directory which is in load-path. +The suggested method for installation is to copy those files that you need to a +directory which is in `load-path'. Here is an overview of the files: +compface.el + + Provides the ELisp-based uncompface program. It is excellent and + practical (actually you can replace lisp/compface.el with it), however + the author is missing and the copyright has not been assigned yet. + gnus-namazu.el - This file defines the command to search mails and persistent - articles with Namazu, which is a full-text search engine - distributed at http://namazu.org, and to browse its results - with Gnus. + This file defines the command to search mails and persistent articles + with Namazu, which is a full-text search engine distributed at + , and to browse its results with Gnus. + +gnus-kill-to-score.el + + Convert kill files to score files. See (info "(gnus)Converting Kill + Files"). gpg-ring.el gpg.el -hashcash.el + Obsoleted by PGG and EasyPG. -nnir.el +one-line-cookie.diff - Interface to various full-text search engines. Provides less - functionality than gnus-namazu.el, but also supports programs - other than Namazu. Current implementation is restricted to - nnml folders, but could be extended for other backends. +sendmail.el +smtpmail.el -one-line-cookie.diff + Copies of the corresponding files from the Emacs lisp/mail/ directory, + to provide features (occasionally) needed by Gnus which may not be + provided by the versions of these files in older Emacs distributions + (Emacs < 22). XEmacs users should NOT use this, since it doesn't work. + See the XEmacs mail-lib module instead. ssl.el + Obsolete interface to OpenSSL. Completely replaced by `lisp/tls.el', + which supports both GnuTLS and OpenSSL. This file will be removed + eventually. + ucs-tables.el This file provides improved Unicode functionality. It defines - functions unify-8859-on-encoding-mode and - unify-8859-on-decoding-mode which unify the Latin-N charsets. - Without unify-8859-on-encoding-mode, composing a Latin-9 reply - to a Latin-1 posting, say, will produce a multipart posting (a - Latin-1 part and a Latin-9 part), or perhaps UTF-8. With - unify-8859-on-encoding-mode, the outgoing posting can be all - Latin-1 or all Latin-9 in most cases. - - It is harmless to turn on unify-8859-on-encoding-mode, but - unify-8859-on-decoding-mode may unexpectedly change files in + functions `unify-8859-on-encoding-mode' and + `unify-8859-on-decoding-mode' which unify the Latin-N charsets. + Without `unify-8859-on-encoding-mode', composing a Latin-9 reply to a + Latin-1 posting, say, will produce a multipart posting (a Latin-1 part + and a Latin-9 part), or perhaps UTF-8. With + `unify-8859-on-encoding-mode', the outgoing posting can be all Latin-1 + or all Latin-9 in most cases. + + It is harmless to turn on `unify-8859-on-encoding-mode', but + `unify-8859-on-decoding-mode' may unexpectedly change files in certain situations. (If the file contains different Latin-N charsets which should not be unified.) This is part of Emacs 21.3 and later, which also turns on - unify-8859-on-encoding-mode by default. + `unify-8859-on-encoding-mode' by default. vcard.el xml.el - This is used for parsing RSS feeds. Part of Emacs 21.3 and - later. + This is used for parsing RSS feeds. Part of Emacs 21.3 and later. + Note that the version of this file in the Gnus contrib/ directory is + out of date with respect to the version in the Emacs tree, so don't use + this file unless using Emacs < 21.3. + +;; Local Variables: +;; fill-column: 79 +;; End: