updating the content for this guide

author: bwarsaw <> 2004-12-14 14:14:32 +0000
committer: bwarsaw <> 2004-12-14 14:14:32 +0000
commit: a3a7b94b04974c40bca54caece474e8506d53822 (patch)
tree: bb447beeccdfa07a18082a99929ea7eb9f85cf9e /admin/www/mailman-admin/node20.html
parent: d497f1c251bff2eae3bce19d183a4bd988fe37e4 (diff)
download: mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.gz
mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.xz
mailman2-a3a7b94b04974c40bca54caece474e8506d53822.zip
1 files changed, 125 insertions, 166 deletions
diff --git a/admin/www/mailman-admin/node20.html b/admin/www/mailman-admin/node20.html
index 2a890daf..0fe77067 100644
--- a/admin/www/mailman-admin/node20.html
+++ b/admin/www/mailman-admin/node20.html
@@ -1,217 +1,176 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html>
 <head>
-<title>3.6 The Digest Options Category</title>
-<META NAME="description" CONTENT="3.6 The Digest Options Category">
-<META NAME="keywords" CONTENT="mailman-admin">
-<META NAME="resource-type" CONTENT="document">
-<META NAME="distribution" CONTENT="global">
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-<link rel="STYLESHEET" href="mailman-admin.css">
-<link rel="first" href="mailman-admin.html">
-<link rel="contents" href="contents.html" title="Contents">
-
-<LINK REL="next" HREF="node21.html">
-<LINK REL="previous" HREF="node19.html">
-<LINK REL="up" HREF="node9.html">
-<LINK REL="next" HREF="node21.html">
+<link rel="STYLESHEET" href="mailman-admin.css" type='text/css' />
+<link rel="first" href="mailman-admin.html" title='GNU Mailman - List Administration Manual' />
+<link rel='contents' href='contents.html' title="Contents" />
+<link rel='last' href='about.html' title='About this document...' />
+<link rel='help' href='about.html' title='About this document...' />
+<link rel="next" href="node25.html" />
+<link rel="prev" href="node19.html" />
+<link rel="parent" href="node8.html" />
+<link rel="next" href="node21.html" />
+<meta name='aesop' content='information' />
+<title>2.7 The Privacy Options Category</title>
 </head>
 <body>
 <DIV CLASS="navigation">
+<div id='top-navigation-panel' xml:id='top-navigation-panel'>
 <table align="center" width="100%" cellpadding="0" cellspacing="2">
 <tr>
-<td><A HREF="node19.html"><img src="../icons/previous.gif"
-  border="0" height="32"
-  alt="Previous Page" width="32"></A></td>
-<td><A HREF="node9.html"><img src="../icons/up.gif"
-  border="0" height="32"
-  alt="Up One Level" width="32"></A></td>
-<td><A HREF="node21.html"><img src="../icons/next.gif"
-  border="0" height="32"
-  alt="Next Page" width="32"></A></td>
+<td class='online-navigation'><a rel="prev" title="2.6 The Digest Options"
+  href="node19.html"><img src='previous.png'
+  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="2 The List Configuration"
+  href="node8.html"><img src='up.png'
+  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><a rel="next" title="2.7.1 Subscription rules"
+  href="node21.html"><img src='next.png'
+  border='0' height='32'  alt='Next Page' width='32' /></A></td>
 <td align="center" width="100%">GNU Mailman - List Administration Manual</td>
-<td><A href="contents.html"><img src="../icons/contents.gif"
-  border="0" height="32"
-  alt="Contents" width="32"></A></td>
-<td><img src="../icons/blank.gif"
-  border="0" height="32"
-  alt="" width="32"></td>
-<td><img src="../icons/blank.gif"
-  border="0" height="32"
-  alt="" width="32"></td>
+<td class='online-navigation'><a rel="contents" title="Table of Contents"
+  href="contents.html"><img src='contents.png'
+  border='0' height='32'  alt='Contents' width='32' /></A></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
 </tr></table>
-<b class="navlabel">Previous:</b> <a class="sectref" HREF="node19.html">3.5 The Non-digest Options</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node9.html">3 The List Configuration</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
-<br><hr>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node19.html">2.6 The Digest Options</A>
+<b class="navlabel">Up:</b>
+<a class="sectref" rel="parent" href="node8.html">2 The List Configuration</A>
+<b class="navlabel">Next:</b>
+<a class="sectref" rel="next" href="node21.html">2.7.1 Subscription rules</A>
+</div>
+<hr /></div>
 </DIV>
 <!--End of Navigation Panel-->
 
-<H2><A NAME="SECTION002360000000000000000">
-3.6 The Digest Options Category</A>
+<H2><A NAME="SECTION002270000000000000000">
+2.7 The Privacy Options Category</A>
 </H2>
 
 <P>
-Digest delivery is a way to bundle many articles together into one
-package, which can be delivered once per day (if there were any posted
-articles), or whenever the package is bigger than a specified limit.
-Some users may prefer this style of delivery for higher traffic lists
-since they will receive fewer messages.
+The Privacy category lets you control how much of the list's
+information is public, as well as who can send messages to your list.
+It also contains some spam detection filters.  Note that this section
+is not used to control whether your list's archives are public or
+private; for that, use the <A HREF="#Archiving_options"><tex2html_cross_ref_visible_mark></A> category.
 
 <P>
-Mailman supports two standard digest formats, and if digests are
-enabled, users can select which of the two formats they receive.  One
-is MIME digests, where each message is an attachment inside a
-<span class="mimetype">multipart/digest</span>.  This format also contains a summary
-table of contents, and of course the an optional header and footer,
-and it retains most of the headers of the original messages.
+There are four sub-categories:
 
-<P>
-The second type is called ``plaintext'' digests because they are
-readable in mail readers that don't support MIME.  Actually, they
-adhere to the <a class="rfc" name="rfcref-1093"
-href="http://www.faqs.org/rfcs/rfc1153.html">RFC 1153</a> digest standard.  The retain some, but not
-all of the original messages, but can also include a summary and
-headers and footers.
+<UL>
+<LI>Subscription rules - i.e. the rules for joining and leaving
+      your mailing list
 
 <P>
-Like non-digest delivery, you can enable or disable digest delivery,
-but you cannot disable both types of delivery.  You can specify
-different headers and footers for digest and non-digest deliveries.
-You cannot personalize digest deliveries.
+</LI>
+<LI>Sender filters - the rules for who may post messages to your
+      list
 
 <P>
-As list administrator, you may want to send an urgent message to all
-list members, bypassing the normal digest bundling.  To do this, send
-the message with a <span class="mailheader">Urgent:</span> header, where the value of the
-header is the list administrator's password.  Non-digest members will
-receive the message like normal, but digest members will receive the
-message immediately<A NAME="tex2html7"
-  HREF="#foot184"><SUP>5</SUP></A>.
+</LI>
+<LI>Recipient filters - moderation rules based on the recipient of
+      the message
 
 <P>
-Here are the variables which control digest delivery:
+</LI>
+<LI>Spam filters - some regular expression based rules for header
+      matching
+</LI>
+</UL>
 
 <P>
-<DL>
-<DT><STRONG>digestable</STRONG></DT>
-<DD>The option controls whether members can receive digest deliveries
-    or not.  If not, they will be forced to receive immediate
-    deliveries.  You can't disable digests if non-digests are already
-    disabled.
+The sender, recipient, and spam filtering rules are part of the
+general list moderation features of Mailman.  When a message is posted
+to the list, it is matched against a number of criteria, the outcome
+of which determines whether the message is reflected to the membership
+or not.  In general, the outcome is one of four states:
 
 <P>
-</DD>
-<DT><STRONG>digest_is_default</STRONG></DT>
-<DD>Controls which style of delivery is the default for new members.
-    You can choose <i>Regular</i> (non-digest) or <i>Digest</i>
-    delivery.
 
-<P>
-</DD>
-<DT><STRONG>mime_is_default_digest</STRONG></DT>
-<DD>If a member is allowed to choose digests, this variable controls
-    which is the default digest style they will receive.  <i>Plain</i>
-    digests are <a class="rfc" name="rfcref-1095"
-href="http://www.faqs.org/rfcs/rfc1153.html">RFC 1153</a> format as described above.
+<UL>
+<LI>Approved or Accepted - the message may be sent on to the
+      members of the mailing list.
 
 <P>
-</DD>
-<DT><STRONG>digest_size_threshold</STRONG></DT>
-<DD>Normally, digest members get at least one message per day, if
-    there have been any messages posted to the list.  However, for
-    high volume lists, you may want to send out digests when the size
-    has reached a certain threshold, otherwise, the one digest they
-    receive could be huge.  This variable controls the size threshold
-    by specifying the maximum digest size in kilobytes.  Note that
-    this threshold isn't exact.  Set this variable to zero to specify
-    that there is no size threshold, in which case no more than one
-    digest will be sent out per day.
+</LI>
+<LI>Hold - the message will be held for moderator approval.  The
+      list owners and moderators will then have to explicitly approve
+      the message before the list members will see it.
 
 <P>
-</DD>
-<DT><STRONG>digest_send_periodic</STRONG></DT>
-<DD>This variable actually controls whether or not a digest is sent
-    daily when the size threshold has not yet been met.  If set to
-    <i>No</i>, then digests will only be sent when they are bigger
-    than <code>digest_size_threshold</code>.
+</LI>
+<LI>Reject - the message is bounced back to the original sender,
+      often with a notice containing the reason the message was
+      rejected.  The list members never see rejected messages.
 
 <P>
-</DD>
-<DT><STRONG>digest_header</STRONG></DT>
-<DD>This text box lets you enter information that will be included in
-    the header of every digest message sent through the list.  The
-    same information can go in this header as can go in the
-    <code>msg_header</code>, except for the personalization variables.
+</LI>
+<LI>Discard - the message is simply thrown away without further
+      processing.
+</LI>
+</UL>
 
 <P>
-</DD>
-<DT><STRONG>digest_footer</STRONG></DT>
-<DD>Just like with the header, you can add a footer to every message.
-    The same rules apply to digest footers as apply to digest headers.
+Many of the fields in this section are text boxes accepting addresses,
+one per line.  Unless otherwise noted, these also accept regular
+expressions which will be matched against an address, if the line
+begins with a (caret) character.
 
 <P>
-</DD>
-<DT><STRONG>digest_volume_frequency</STRONG></DT>
-<DD>Each digest is numbered with a volume and an issue.  This variable
-    controls how often a new digest volume is sent.  When the digest
-    volume number is incremented, the issue number is reset to 1.
 
-<P>
-</DD>
-<DT><STRONG>_new_volume</STRONG></DT>
-<DD>This is an action variable, which forces an increment of the
-    volume number as soon as you submit the form.
+<p><br /></p><hr class='online-navigation' />
+<div class='online-navigation'>
+<!--Table of Child-Links-->
+<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
 
-<P>
-</DD>
-<DT><STRONG>_send_digest_now</STRONG></DT>
-<DD>This is another action variable.  Select <i>Yes</i>, submit the
-    form, and the current digest is packaged up and sent to digest
-    members, regardless of size (well, there has to be at least one
-    message in the digest).
-</DD>
-</DL>
+<UL CLASS="ChildLinks">
+<LI><A href="node21.html">2.7.1 Subscription rules</a>
+<LI><A href="node22.html">2.7.2 Sender filters</a>
+<LI><A href="node23.html">2.7.3 Recipient Filters</a>
+<LI><A href="node24.html">2.7.4 Spam Filters</a>
+</ul>
+<!--End of Table of Child-Links-->
+</div>
 
-<P>
-<BR><HR><H4>Footnotes</H4>
-<DL>
-<DT><A NAME="foot184">... immediately</A><A
- HREF="node20.html#tex2html7"><SUP>5</SUP></A></DT>
-<DD>They'll also receive the message in the
-digest.
-
-</DD>
-</DL>
 <DIV CLASS="navigation">
-<p><hr>
+<div class='online-navigation'>
+<p></p><hr />
 <table align="center" width="100%" cellpadding="0" cellspacing="2">
 <tr>
-<td><A HREF="node19.html"><img src="../icons/previous.gif"
-  border="0" height="32"
-  alt="Previous Page" width="32"></A></td>
-<td><A HREF="node9.html"><img src="../icons/up.gif"
-  border="0" height="32"
-  alt="Up One Level" width="32"></A></td>
-<td><A HREF="node21.html"><img src="../icons/next.gif"
-  border="0" height="32"
-  alt="Next Page" width="32"></A></td>
+<td class='online-navigation'><a rel="prev" title="2.6 The Digest Options"
+  href="node19.html"><img src='previous.png'
+  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="2 The List Configuration"
+  href="node8.html"><img src='up.png'
+  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><a rel="next" title="2.7.1 Subscription rules"
+  href="node21.html"><img src='next.png'
+  border='0' height='32'  alt='Next Page' width='32' /></A></td>
 <td align="center" width="100%">GNU Mailman - List Administration Manual</td>
-<td><A href="contents.html"><img src="../icons/contents.gif"
-  border="0" height="32"
-  alt="Contents" width="32"></A></td>
-<td><img src="../icons/blank.gif"
-  border="0" height="32"
-  alt="" width="32"></td>
-<td><img src="../icons/blank.gif"
-  border="0" height="32"
-  alt="" width="32"></td>
+<td class='online-navigation'><a rel="contents" title="Table of Contents"
+  href="contents.html"><img src='contents.png'
+  border='0' height='32'  alt='Contents' width='32' /></A></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
 </tr></table>
-<b class="navlabel">Previous:</b> <a class="sectref" HREF="node19.html">3.5 The Non-digest Options</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node9.html">3 The List Configuration</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
-<hr>
-<span class="release-info">Release 2.1, documentation updated on October 2, 2004.</span>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node19.html">2.6 The Digest Options</A>
+<b class="navlabel">Up:</b>
+<a class="sectref" rel="parent" href="node8.html">2 The List Configuration</A>
+<b class="navlabel">Next:</b>
+<a class="sectref" rel="next" href="node21.html">2.7.1 Subscription rules</A>
+</div>
+</div>
+<hr />
+<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span>
 </DIV>
 <!--End of Navigation Panel-->
author	bwarsaw <>	2004-12-14 14:14:32 +0000
committer	bwarsaw <>	2004-12-14 14:14:32 +0000
commit	a3a7b94b04974c40bca54caece474e8506d53822 (patch)
tree	bb447beeccdfa07a18082a99929ea7eb9f85cf9e /admin/www/mailman-admin/node20.html
parent	d497f1c251bff2eae3bce19d183a4bd988fe37e4 (diff)
download	mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.gz mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.xz mailman2-a3a7b94b04974c40bca54caece474e8506d53822.zip