instructions for encrypted mailing lists added

README

@@ -14,9 +14,10 @@ Contents
    V.   Notes
   VI.   Multi-level list access
  VII.   Language Portability
-VIII.   Bugs && Bug Reports
+VIII.	Encrypted mailing lists
-  XI.   Acknowledgements
+  IX.   Bugs && Bug Reports
-   X.   Availability
+   X.   Acknowledgements
+  XI.   Availability
 
 
 I. Copyright Stuff - essentially the FreeBSD licence ...
@@ -255,7 +256,14 @@ Secondly, please mail me a copy (ezmlm-web@sumpfralle.de) so that I may use
 them in any future releases of ezmlm-web.
 
 
-VIII. Bugs && Bug Reports
+VIII. Encrypted mailing lists
+=============================
+If you want to manage encrypted mailing lists (see
+http://www.synacklabs.net/projects/crypt-ml/) with ezmlm-web, then you should
+read README.gnupg and follow the instructions.
+
+
+IX. Bugs && Bug Reports
 =======================
 I don't know of any bugs, but then this is a rewrite and a first release. It
 has been tested reasonably well, but not exhaustively. I know it works on
@@ -263,12 +271,15 @@ FreeBSD 4.0-STABLE, FreeBSD 3.4-RELEASE, RedHat 5.1, Redhat 6.0 and Debian
 3.0 all using an Apache web server, but I would be interested to know whether
 it works on other OSs and with other web servers.
 
-Please mail bug reports and comments to ezmlm-web@sumpfralle.de.
+Please mail bug reports and comments to
-Or (even better) submit a bug report at https://systemausfall.org/trac/ezmlm-web.
+	ezmlm-web@sumpfralle.de
-Or subscribe to the ezmlm-web mailinglist: ezmlm-web-subscribe@lists.systemausfall.org.
+Or (even better) submit a bug report at
+	https://systemausfall.org/trac/ezmlm-web
+Or subscribe to the ezmlm-web mailinglist:
+	ezmlm-web-subscribe@lists.systemausfall.org
 
 
-IX. Acknowledgements
+X. Acknowledgements
 ===================
 *  Guy Antony Halse (guy-ezmlm@rucus.ru.ac.za) - he created ezmlm-web
    and maintained it till 02005 
@@ -293,7 +304,7 @@ IX. Acknowledgements
    interface for v3.0
 
 
-X. Availability
+XI. Availability
 =================
 More information on ezmlm-web and developments to ezmlm-web can be found at:
 https://systemausfall.org/toolforge/ezmlm-web

README.gnupg

@@ -0,0 +1,50 @@
+This file describes how to manage encrypted mailing lists with ezmlm-web.
+
+Content:
+1) Requirements
+2) Installation of gpg-ezmlm
+3) Setup of ezmlm-web
+4) Notes
+
+------------------------------
+
+1) Requirements
+To use encrypted mailing lists, you need to install gpg-ezmlm (see
+http://www.synacklabs.net/projects/crypt-ml/). It is essential to use
+at least version 0.3.4.
+gpg-ezmlm will handle your incoming and outgoing mails. It does not
+support all the features of ezmlm-idx, but it should suffice for the
+specialized needs of encrypted communication for small groups.
+
+Install the perl module Mail::Ezmlm::Gpg to access gpg-ezmlm. You can
+downloaded it from 
+https://systemausfall.org/toolforge/ezmlm-web/downloads/gnupg-support.
+
+Of course, you also need gnupg (it is required by gpg-ezmlm, too).
+
+
+2) Installation
+Follow the instructions in the README file of gpg-ezmlm.
+Usually it should boil down to the following commands:
+ perl Makefile.PL
+ make
+ make install
+
+
+3) Setup of ezmlm-web
+The location of the encryption configuration file for ezmlm-web depends
+on the location of your ezmlmwebrc file. ezmlm-web will just check, if
+a file prefixed with ".gnupg" exists besides ezmlmwebrc.
+In short: you have to put it into the same directory, as you placed your
+ezmlmwebrc. ezmlm-web will NOT look into any other location.
+
+To support the setup of encrypted mailing lists, you have to include the
+following lines in your ezmlmwebrc.gnupg file.
+ use Mail::Ezmlm::Gpg;
+ GPG_SUPPRT = yes;
+
+4) Notes
+As soon as you installed all the necessary programs and after you did put
+the ezmlmwebrc.gnupg to the right location, you will find a new link in the
+navigation bar of ezmlm-web named "Encryption".
+

ezmlmwebrc.gnupg

@@ -1,4 +1,8 @@
 # sample configuration file for encrypted mailing list support
+# You do not need to change anything, if you do not want to
+# manage encrypted mailing lists. See README.gnupg for details.
+
+# Put this file besides ezmlmwebrc (just suffixed with ".gnupg").
 
 # BEWARE: enable the following line ONLY if you installed the
 # Mail::Ezmlm::Gpg module - otherwise ezmlm-web will not work!
@@ -6,7 +10,6 @@
 
 # turn support for encrypted mailing lists on or off
 # defaults to 0 (off)
-# you MUST enable the "use" line above, if you turn on the gpg support
+# you MUST enable the "use" line above, if you want to turn on gnupg support
 $GPG_SUPPORT = 0;
 
-