[finetuning
Joost van Baal <joostvb@uvt.nl>**20060106144812] {
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 9
-<p>This patch is an effort to include PGP and S/MIME support in Mailman, as
-part of the SURFnet Secure List Server project.</p>
+<p>This patch is an effort to include OpenPGP and S/MIME support in Mailman, as
+part of the <a href="http://www.surfnet.nl/">SURFnet</a> Secure List Server
+project.</p>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 26
-<h2>specs</h2>
+<p>Beware!  This code is not mature, and not yet suitable for production use.
+Inspect the code to find out if it's good enough for you.</p>
+
+<h2>Specs</h2>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 31
-<p>This patch handles RFC 2633 (S/MIME) messages next to RFC 2440 (OpenPGP).</p>
+<p>This patch handles both RFC 2633 (S/MIME) and RFC 2440 (OpenPGP) email
+messages.</p>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 34
-<p>A post will be distributed only if the PGP signature on the post is from one
-of the list members.</p>
+<p>A post will be distributed only if the PGP (or S/MIME) signature on the post
+is from one of the list members.</p>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 41
-<p>In order to achieve this, each list has a public and private key, as well
-as a key passphrase.  Furthermore, new list settings are defined:</p>
+<p>In order to achieve this, each list has a public and private key.  (These
+private keys can optionally be protected by passphrases.) Furthermore, new list
+settings are defined:</p>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 61
-<h2>installation</h2>
+<h2>Installation</h2>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 69
-<h3>Upgrading from earlier and/or unpatched versions</h3>
+<h3>upgrading from earlier and/or unpatched versions</h3>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 71
-<p>GPG support needs to store additional information for the mailing lists,
+<p>SSLS support needs to store additional information for the mailing lists,
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 73
-for "GPG".</p>
+for "GPG" and "smime".</p>
+
+<p>The automatic upgrade procedure occuring on a change of the version number
+is implemented yet untested.  You can either modify the version number in
+Version.py to trigger the automatic patch, or run bin/update --force (worked
+for me, but I won't give any guarantees).</p>
+
+<h3>fresh installs</h3>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 82
-<p>The automatic upgrade procedure occuring on a change of the
-version number is implemented yet untested.
-You can either modify the version number in Version.py to trigger the
-automatic patch, or run bin/update --force (worked for me, but I won't
-give any guarantees).</p>
+<p>If you're installing on a Debian(-based) hosts, you can "apt-get install"
+the patched package from</p>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 85
-<h3>Fresh Installs</h3>
+<pre>
+deb http://non-gnu.uvt.nl/debian sarge mailman
+</pre>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 89
-<p>Install the patched Mailman.</p>
+<p>If you're on another platform, you can apply <a
+href="http://non-gnu.uvt.nl/pub/mailman/">the patch</a> to a pristine official
+mailman tarball, and install using the official installation instructions.</p>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 93
-<h3>Setting up lists</h3>
+<h3>setting up lists</h3>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 95
-<p>Create a list. Go to the admin menu.  Open "Privacy
-options", select "GPG options". Make the settings appropriate for your list
+<p>Create a list. Go to the admin menu.  Open "Privacy options", select "GPG
+options" and "S/MIME options". Make the settings appropriate for your list
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 138
-<h2>hacking</h2>
+<h2>Hacking</h2>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 152
-<h2>history, credits, copyright</h2>
+<h2>History, credits, copyright</h2>
hunk ./mailman-ssls/mailman-ssls/README.SSLS.html 158
-mailman-2.1.5-gpg_2005-02-22.diff.gz) and Tilburg University (stuff written by
-Joost van Baal), see the individual files for details.</p>
+mailman-2.1.5-gpg_2005-02-22.diff.gz) and <a href="http://www.uvt.nl/">Tilburg
+University</a> (stuff written by Joost van Baal), see the individual files for
+details.</p>
}