X-Git-Url: https://cgit.sxemacs.org/?a=blobdiff_plain;f=contrib%2FREADME;h=bf648ed6b489605ff2e14eff4d514d9738720a43;hb=795feeab0cc4216fe7bea104613c8ca6e95f593f;hp=76d0e5c01951c9dd642fdcf19bd24e6267dd85f0;hpb=43fb9e5fef5cce2b851be3d86f06adbad1b9ef62;p=gnus

diff --git a/contrib/README b/contrib/README
index 76d0e5c01..bf648ed6b 100644
--- a/contrib/README
+++ b/contrib/README
@@ -1,3 +1,36 @@
-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 (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'.
+
+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.
+
+gnus-kill-to-score.el
+
+	Convert kill files to score files.  See (info "(gnus)Converting Kill
+	Files").
+
+vcard.el
+
+;; Local Variables:
+;; fill-column: 79
+;; End: