X-Git-Url: http://cgit.sxemacs.org/?p=gnus;a=blobdiff_plain;f=contrib%2FREADME;h=a6e4fd84cda476862a65170a5df2a6277ff18aa4;hp=13d45edfb210a300ca1a4b4da1c87d63acd1ca4f;hb=d121cfee275ac4ee2f76599611cbaa156e3cbd21;hpb=19f6acebe88b61059a088ee5239ce78bfc160575

diff --git a/contrib/README b/contrib/README
index 13d45edfb..a6e4fd84c 100644
--- a/contrib/README
+++ b/contrib/README
@@ -1,55 +1,66 @@
-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
+	<http://namazu.org>, and to browse its results with Gnus.
 
-gpg-ring.el
-gpg.el
+gnus-kill-to-score.el
 
-hashcash.el
+	Convert kill files to score files.  See (info "(gnus)Converting Kill
+	Files").
 
 one-line-cookie.diff
 
-ssl.el
+sendmail.el
+smtpmail.el
+
+	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.
 
 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.
+;; Local Variables:
+;; fill-column: 79
+;; End: