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/node23.html
parent: d497f1c251bff2eae3bce19d183a4bd988fe37e4 (diff)
download: mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.gz
mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.xz
mailman2-a3a7b94b04974c40bca54caece474e8506d53822.zip
1 files changed, 90 insertions, 166 deletions
diff --git a/admin/www/mailman-admin/node23.html b/admin/www/mailman-admin/node23.html
index ef2f32c3..25a08bc4 100644
--- a/admin/www/mailman-admin/node23.html
+++ b/admin/www/mailman-admin/node23.html
@@ -1,206 +1,130 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html>
 <head>
-<title>3.7.2 Sender filters</title>
-<META NAME="description" CONTENT="3.7.2 Sender filters">
-<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="node24.html">
-<LINK REL="previous" HREF="node22.html">
-<LINK REL="up" HREF="node21.html">
-<LINK REL="next" HREF="node24.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="node24.html" />
+<link rel="prev" href="node22.html" />
+<link rel="parent" href="node20.html" />
+<link rel="next" href="node24.html" />
+<meta name='aesop' content='information' />
+<title>2.7.3 Recipient Filters</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="node22.html"><img src="../icons/previous.gif"
-  border="0" height="32"
-  alt="Previous Page" width="32"></A></td>
-<td><A HREF="node21.html"><img src="../icons/up.gif"
-  border="0" height="32"
-  alt="Up One Level" width="32"></A></td>
-<td><A HREF="node24.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.7.2 Sender filters"
+  href="node22.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.7 The Privacy Options"
+  href="node20.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.4 Spam Filters"
+  href="node24.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="node22.html">3.7.1 Subscription rules</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node24.html">3.7.3 Recipient Filters</A>
-<br><hr>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node22.html">2.7.2 Sender filters</A>
+<b class="navlabel">Up:</b>
+<a class="sectref" rel="parent" href="node20.html">2.7 The Privacy Options</A>
+<b class="navlabel">Next:</b>
+<a class="sectref" rel="next" href="node24.html">2.7.4 Spam Filters</A>
+</div>
+<hr /></div>
 </DIV>
 <!--End of Navigation Panel-->
 
-<H3><A NAME="SECTION002372000000000000000">
-3.7.2 Sender filters</A>
+<H3><A NAME="SECTION002273000000000000000">
+2.7.3 Recipient Filters</A>
 </H3>
 
 <P>
-When a message is posted to the list, a series of moderation criteria are
-applied to determine the disposition of the message.  This section
-contains the modeation controls for postings from both members and
-non-members.
+The variables in this section control various filters based on the
+recipient of the message.
 
 <P>
 <DL>
-<DT><STRONG>default_member_moderation</STRONG></DT>
-<DD>Member postings are held for moderation if their <i>moderation
-    flag</i> is turned on.  Note that only the list administrators can
-    change the value of a member's moderation flag.
-
-<P>
-You can control whether new members get their moderation flag
-    turned on or off by default when they subscribe to the list.  By
-    turning this flag off by default, postings by members will be
-    allowed without further intervention (barring other restrictions
-    such as size or implicit recipient lists - see below).  By
-    turning the flag on, you can quarantine new member postings to
-    make sure that they meet your criteria for netiquette, topicality,
-    etc.  Once you determine that the new member understands the
-    community's posting rules, you can turn off their moderation flag
-    and let their postings go through unstopped.
-
-<P>
-E-newsletter style lists can also be set up by using the
-    moderation flag.  By setting the <code>member_moderation_action</code>
-    to <i>Reject</i>, and by turning off the moderation flag for just
-    the few approved senders, your list will operate in essentially a
-    one-way direction.  Note that you'd also need to reject or discard
-    postings from non-members.
-
-<P>
-</DD>
-<DT><STRONG>member_moderation_action</STRONG></DT>
-<DD>This is the action to take for postings from a member who's
-    moderation flag is set.  For typical discussion lists, you'll
-    likely set this to <i>Hold</i> so that the list moderator will get
-    a chance to manually approve, reject, or discard the message.  For
-    e-newsletter and announcement lists, you might want to set this to
-    <i>Reject</i> or <i>Discard</i>.
-
-<P>
-Note that when a moderated member posts to your list, and the
-    <code>member_moderation_action</code> is set to <i>Hold</i>, the message
-    will appear on the administrative requests page.  When you dispose
-    of the message, you will be given an opportunity to clear the
-    moderation flag at the same time.   If you're quarantining new
-    posts, this makes it very convenient to both approve a new
-    member's post and de-moderate them at the same time.
+<DT><STRONG>require_explicit_destination</STRONG></DT>
+<DD>This controls whether the mailing list posting address must be
+    explicitly named in the <span class="mailheader">To:</span> or <span class="mailheader">Cc:</span>
+    recipient lists.  The main reason why it wouldn't is if the
+    message was blind-carbon-copied (i.e. <span class="mailheader">Bcc:</span>'d) to the
+    list.  Spammers like to do this, but sometimes legitimate messages
+    are forwarded to the list this way.
 
 <P>
-</DD>
-<DT><STRONG>member_moderation_notice</STRONG></DT>
-<DD>When a member's moderation flag is turned on and
-    <code>member_moderation_action</code> is <i>Reject</i>, this variable
-    contains the text sent in the rejection notice.
-</DD>
-</DL>
-
-<P>
-The next batch of variables controls what happens when non-members
-post messages to the list.  Each of these accepts one email address
-per line; regular expressions are allowed if the line starts with the
-(caret) character.  These address lists are always consulted in the
-order in which they're presented on this page (i.e. accepts first,
-followed by holds, rejections, and discards).
-
-<P>
-<DL>
-<DT><STRONG>accept_these_nonmembers</STRONG></DT>
-<DD>Postings from non-members whose addresses match this list are
-    accepted, barring other list restrictions due to size, implicit
-    recipients, etc.  You might want to add alternative addresses of
-    approved posters to this list.
-
-<P>
-</DD>
-<DT><STRONG>hold_these_nonmembers</STRONG></DT>
-<DD>Postings from non-members whose addresses match this list are
-    held for moderator approval.
-
-<P>
-</DD>
-<DT><STRONG>reject_these_nonmembers</STRONG></DT>
-<DD>Postings from non-members whose addresses match this list are
-    rejected, i.e. bounced back to the original sender.  There
-    currently is no way to add additional text to the rejection
-    message.
-
-<P>
-</DD>
-<DT><STRONG>discard_these_nonmembers</STRONG></DT>
-<DD>Postings from non-members whose addresses match this list are
-    discarded, with no bounce back message.  You might want to add the
-    addresses of known spammers to this list.
+If the list is not explicitly addressed and this setting is turned
+    on, the message will be held for moderator approval.
 
 <P>
 </DD>
-<DT><STRONG>generic_nonmember_action</STRONG></DT>
-<DD>This variable controls what happens to non-member posts when the
-    address of the sender doesn't match any of the above four lists.
-    If you set this to <i>Hold</i>, the posting will appear on the
-    administrative requests page, and you will be given an opportunity
-    to add the non-member to one of the above four lists at the same
-    time you dispose of the held message.
+<DT><STRONG>acceptable_aliases</STRONG></DT>
+<DD>This is the list of alternative addresses that are acceptable as a
+    list posting address when <code>require_explicit_destination</code> is
+    enabled.  This is useful for when there aliases for the main
+    posting address (e.g. <code>help@example.com</code> may be an alias for
+    <code>help-list@example.com</code>).
 
 <P>
 </DD>
-<DT><STRONG>forward_auto_discards</STRONG></DT>
-<DD>When messages from non-members are discarded, either because the
-    sender address matched <code>discard_these_nonmembers</code>, or because
-    <code>generic_nonmember_action</code> is <i>Discard</i>, you can choose
-    whether such messages are forwarded to the lsit administrators or
-    not.
+<DT><STRONG>max_num_recipients</STRONG></DT>
+<DD>This is the maximum number of explicit recipients that are allowed
+    on the posted message.  Spammers sometimes send messages with lots
+    of explicit recipients, so setting this number to a reasonable
+    value may cut down on spam.
 </DD>
 </DL>
 
 <P>
 
 <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="node22.html"><img src="../icons/previous.gif"
-  border="0" height="32"
-  alt="Previous Page" width="32"></A></td>
-<td><A HREF="node21.html"><img src="../icons/up.gif"
-  border="0" height="32"
-  alt="Up One Level" width="32"></A></td>
-<td><A HREF="node24.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.7.2 Sender filters"
+  href="node22.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.7 The Privacy Options"
+  href="node20.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.4 Spam Filters"
+  href="node24.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="node22.html">3.7.1 Subscription rules</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node24.html">3.7.3 Recipient Filters</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="node22.html">2.7.2 Sender filters</A>
+<b class="navlabel">Up:</b>
+<a class="sectref" rel="parent" href="node20.html">2.7 The Privacy Options</A>
+<b class="navlabel">Next:</b>
+<a class="sectref" rel="next" href="node24.html">2.7.4 Spam Filters</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/node23.html
parent	d497f1c251bff2eae3bce19d183a4bd988fe37e4 (diff)
download	mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.gz mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.xz mailman2-a3a7b94b04974c40bca54caece474e8506d53822.zip