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/node21.html
parent: d497f1c251bff2eae3bce19d183a4bd988fe37e4 (diff)
download: mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.gz
mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.xz
mailman2-a3a7b94b04974c40bca54caece474e8506d53822.zip
1 files changed, 152 insertions, 119 deletions
diff --git a/admin/www/mailman-admin/node21.html b/admin/www/mailman-admin/node21.html
index 55fa06dd..03d23444 100644
--- a/admin/www/mailman-admin/node21.html
+++ b/admin/www/mailman-admin/node21.html
@@ -1,168 +1,201 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html>
 <head>
-<title>3.7 The Privacy Options Category</title>
-<META NAME="description" CONTENT="3.7 The Privacy 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="node26.html">
-<LINK REL="previous" HREF="node20.html">
-<LINK REL="up" HREF="node9.html">
-<LINK REL="next" HREF="node22.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="node22.html" />
+<link rel="prev" href="node20.html" />
+<link rel="parent" href="node20.html" />
+<link rel="next" href="node22.html" />
+<meta name='aesop' content='information' />
+<title>2.7.1 Subscription rules</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="node20.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="node22.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 The Privacy Options"
+  href="node20.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.2 Sender filters"
+  href="node22.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="node20.html">3.6 The 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="node22.html">3.7.1 Subscription rules</A>
-<br><hr>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node20.html">2.7 The Privacy Options</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="node22.html">2.7.2 Sender filters</A>
+</div>
+<hr /></div>
 </DIV>
 <!--End of Navigation Panel-->
 
-<H2><A NAME="SECTION002370000000000000000">
-3.7 The Privacy Options Category</A>
-</H2>
+<H3><A NAME="SECTION002271000000000000000">
+2.7.1 Subscription rules</A>
+</H3>
 
 <P>
-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.
+This subcategory controls the rules for exposing the existance of this
+list, and for what new members must do in order to subscribe to the
+list.
 
 <P>
-There are four sub-categories:
-
-<UL>
-<LI>Subscription rules - i.e. the rules for joining and leaving
-      your mailing list
-
-<P>
-</LI>
-<LI>Sender filters - the rules for who may post messages to your
-      list
+<DL>
+<DT><STRONG>advertised</STRONG></DT>
+<DD>This option controls whether this list will show up in the list
+    overview for the site.  Normally, an overview contains the name
+    and short description of every mailing list in the virtual
+    domain.  By setting this variable to <em>No</em>, it will not show
+    up in this overview, nor will it show up in the administrative
+    overview.  The only way then to find the list is to guess (or
+    know!) its name.
 
 <P>
-</LI>
-<LI>Recipient filters - moderation rules based on the recipient of
-      the message
-
-<P>
-</LI>
-<LI>Spam filters - some regular expression based rules for header
-      matching
-</LI>
-</UL>
-
-<P>
-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:
+</DD>
+<DT><STRONG>subscribe_policy</STRONG></DT>
+<DD>This option controls the steps that a new member must take to join
+    the list.  The available options may differ based on some defaults
+    that the site administrator chooses.  They are:
 
 <P>
 
 <UL>
-<LI>Approved or Accepted - the message may be sent on to the
-      members of the mailing list.
+<LI>None - No verification is done on the subscribing
+          member. This is also called <em>open subscriptions</em> and is
+          generally disabled by default.  The site administrator must
+          allow list admins to choose this option; if not, this option
+          will not be presented to you.
 
 <P>
 </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.
+<LI>Confirm - An email confirmation step is required before the
+          address is added to the list.  When a member requests
+          subscription, either via the web page or by sending a
+          message to <var>yourlist</var><code>-join@example.com</code>, Mailman
+          will send a confirmation message to the requesting address.
+          This mail-back confirmation contains a unique identifier,
+          which the requester can present to Mailman in order to
+          confirm their subscription.  This can be done either by
+          replying to the mail-back, or by visiting the url in the
+          mail-back message.  The url points to a page that lets the
+          user either discard or confirm their request.
 
 <P>
 </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.
+<LI>Require approval - All subscription requests are held for
+          approval of the list moderator.  No mail-back confirmation
+          is sent, but the list admins will recieve a message
+          indicating that approval is pending.
 
 <P>
 </LI>
-<LI>Discard - the message is simply thrown away without further
-      processing.
+<LI>Confirm and approve - Here, a mail-back notice must first
+          be confirmed by the requester.  Once confirmed, the list
+          moderator must then approve the request.  This is the most
+          secure method for users to subscribe since it both verifies
+          the requesting address, and forces the list moderators to
+          approve the request.
+
+<P>
 </LI>
 </UL>
 
 <P>
-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.
+</DD>
+<DT><STRONG>unsubscribe_policy</STRONG></DT>
+<DD>Specifies whether the list moderator's approval is required for
+    unsubscription requests.  <em>No</em> is highly recommended, since
+    it is exceedingly impolite to not allow people to leave a mailing
+    list whenever they want (i.e. opt-out).  <em>Yes</em> is useful in
+    some specialized contexts; e.g. you may not want to allow
+    employees to unsubscribe from the company newsletter.
 
 <P>
+</DD>
+<DT><STRONG>ban_list</STRONG></DT>
+<DD>This contains a list of addresses (or regular expressiosn), one
+    per line, that are banned from ever subscribing to your mailing
+    list.  If a match occurs during the subscription process, the
+    request will be automatically rejected, and the requester will get
+    a rejection notice.  You can use this to permanently ban
+    troublesome posters to a members-only list.
 
-<p><hr>
-<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
+<P>
+</DD>
+<DT><STRONG>private_roster</STRONG></DT>
+<DD>This specifies who is allowed to view the roster of member
+    addresses.  If you choose <em>Anyone</em>, then the list membership
+    is completely public.  You can limit exposure of the roster to
+    just list members, or just to the list administrators.  In the
+    former case, a user must enter a valid member's address and
+    password before they can view the roster.  In the latter case, a
+    list administrator's password must be enter; if a matching admin
+    password is entered, address field is ignored.
+
+<P>
+</DD>
+<DT><STRONG>obscure_addresses</STRONG></DT>
+<DD>Controls whether some simple obfuscation of addresses is used when
+    member addresses are included on web pages.  This should reduce
+    the opportunity for email address harvesting by spammers, although
+    it probably doesn't eliminate it.
+</DD>
+</DL>
 
-<UL CLASS="ChildLinks">
-<LI><A href="node22.html">3.7.1 Subscription rules</a>
-<LI><A href="node23.html">3.7.2 Sender filters</a>
-<LI><A href="node24.html">3.7.3 Recipient Filters</a>
-<LI><A href="node25.html">3.7.4 Spam Filters</a>
-</ul>
-<!--End of Table of Child-Links-->
+<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="node20.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="node22.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 The Privacy Options"
+  href="node20.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.2 Sender filters"
+  href="node22.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="node20.html">3.6 The 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="node22.html">3.7.1 Subscription rules</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="node20.html">2.7 The Privacy Options</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="node22.html">2.7.2 Sender 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/node21.html
parent	d497f1c251bff2eae3bce19d183a4bd988fe37e4 (diff)
download	mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.gz mailman2-a3a7b94b04974c40bca54caece474e8506d53822.tar.xz mailman2-a3a7b94b04974c40bca54caece474e8506d53822.zip