diff options
author | Barry Warsaw <barry@python.org> | 2007-12-05 17:23:41 -0500 |
---|---|---|
committer | Barry Warsaw <barry@python.org> | 2007-12-05 17:23:41 -0500 |
commit | 3a258ad5cdd98c5705af6c02ba91993b3d382adc (patch) | |
tree | 85c90c037ee5b5f992c3b291e66c60cab46d9e73 /doc/mailman-admin | |
parent | 18f080804e368c63de499b32717d57701aaf8880 (diff) | |
download | mailman2-3a258ad5cdd98c5705af6c02ba91993b3d382adc.tar.gz mailman2-3a258ad5cdd98c5705af6c02ba91993b3d382adc.tar.xz mailman2-3a258ad5cdd98c5705af6c02ba91993b3d382adc.zip |
Because the admin directory is no longer included, the www directory isn't
either, and that's where the generated docs used to live. So now, make this
directory include the generated docs, removing the old IPC7 and LISA-98
directories, and the .tex source files. These latter are moved to the admin
repository.
Diffstat (limited to 'doc/mailman-admin')
52 files changed, 5785 insertions, 0 deletions
diff --git a/doc/mailman-admin/WARNINGS b/doc/mailman-admin/WARNINGS new file mode 100644 index 00000000..355383a0 --- /dev/null +++ b/doc/mailman-admin/WARNINGS @@ -0,0 +1,3 @@ +couldn't convert character (circ into available encodings + + ...set $ACCENT_IMAGES to get an image diff --git a/doc/mailman-admin/about.html b/doc/mailman-admin/about.html new file mode 100644 index 00000000..153099b2 --- /dev/null +++ b/doc/mailman-admin/about.html @@ -0,0 +1,112 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="prev" href="contents.html" /> +<link rel="parent" href="mailman-admin.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>About this document ...</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 class='online-navigation'><a rel="prev" title="1 this is an" + href="node35.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="GNU mailman - List" + href="mailman-admin.html"><img src='up.png' + border='0' height='32' alt='Up one Level' width='32' /></a></td> +<td class='online-navigation'><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></td> +<td align="center" width="100%">GNU Mailman - List Administration Manual</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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node35.html">1 This is an</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-admin.html">GNU Mailman - List</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION003000000000000000000"> +About this document ...</a> +</h1> + <strong>GNU Mailman - List Administration Manual</strong>, +December 5, 2007, Release 2.1 +<p> This document was generated using the <a + href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> + <strong>LaTeX</strong>2<tt>HTML</tt></a> translator. +</p> + +<p> <a + href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> + <strong>LaTeX</strong>2<tt>HTML</tt></a> is Copyright © + 1993, 1994, 1995, 1996, 1997, <a + href="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos + Drakos</a>, Computer Based Learning Unit, University of + Leeds, and Copyright © 1997, 1998, <a + href="http://www.maths.mq.edu.au/~ross/">Ross + Moore</a>, Mathematics Department, Macquarie University, + Sydney. +</p> + +<p> The application of <a + href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/"> + <strong>LaTeX</strong>2<tt>HTML</tt></a> to the Python + documentation has been heavily tailored by Fred L. Drake, + Jr. Original navigation icons were contributed by Christopher + Petrilli. +</p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1 this is an" + href="node35.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="GNU mailman - List" + href="mailman-admin.html"><img src='up.png' + border='0' height='32' alt='Up one Level' width='32' /></a></td> +<td class='online-navigation'><img src='next.png' + border='0' height='32' alt='Next Page' width='32' /></td> +<td align="center" width="100%">GNU Mailman - List Administration Manual</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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node35.html">1 This is an</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-admin.html">GNU Mailman - List</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/blank.png b/doc/mailman-admin/blank.png Binary files differnew file mode 100644 index 00000000..2af5639b --- /dev/null +++ b/doc/mailman-admin/blank.png diff --git a/doc/mailman-admin/contents.html b/doc/mailman-admin/contents.html new file mode 100644 index 00000000..24113e68 --- /dev/null +++ b/doc/mailman-admin/contents.html @@ -0,0 +1,126 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="about.html" /> +<link rel="prev" href="front.html" /> +<link rel="parent" href="mailman-admin.html" /> +<link rel="next" href="node3.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>Contents</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 class='online-navigation'><a rel="prev" title="Front Matter" + href="front.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="GNU mailman - List" + href="mailman-admin.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="1 introduction to GNU" + href="node3.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 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> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="front.html">Front Matter</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-admin.html">GNU Mailman - List</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node3.html">1 Introduction to GNU</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> +<br><h2><a name="SECTION002000000000000000000"> +Contents</a> +</h2> +<!--Table of Contents--> + +<ul class="TofC"> +<li><ul> +<li><a href="node3.html">1 Introduction to GNU Mailman</a> +<ul> +<li><a href="node4.html">1.1 A List's Email Addresses</a> +<li><a href="node5.html">1.2 Administrative Roles</a> +<li><a href="node6.html">1.3 A List's Web Pages</a> +<li><a href="node7.html">1.4 Basic Architectural Overview</a> +</ul> +<li><a href="node8.html">2 The List Configuration Pages</a> +<ul> +<li><a href="node9.html">2.1 The General Options Category</a> +<li><a href="node15.html">2.2 The Passwords Category</a> +<li><a href="node16.html">2.3 The Language Options Category</a> +<li><a href="node17.html">2.4 The Membership Management Category</a> +<li><a href="node18.html">2.5 The Non-digest Options Category</a> +<li><a href="node19.html">2.6 The Digest Options Category</a> +<li><a href="node20.html">2.7 The Privacy Options Category</a> +<li><a href="node25.html">2.8 The Bounce Processing Category</a> +<li><a href="node26.html">2.9 The Archiving Options Category</a> +<li><a href="node27.html">2.10 The Mail/News Gateway Category</a> +<li><a href="node28.html">2.11 The Auto-responder Category</a> +<li><a href="node29.html">2.12 The Content Filtering Category</a> +<li><a href="node30.html">2.13 The Topics Category</a> +</ul> +<li><a href="node31.html">3 Membership Management</a> +<li><a href="node32.html">4 Tending to Pending Moderator Requests</a> +<li><a href="node33.html">5 Editing the Public HTML Pages</a> +<li><a href="node34.html">6 Deleting the Mailing List</a> +<li><a href="node35.html">1 This is an Appendix</a> +</ul></ul> +<!--End of Table of Contents--> +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="Front Matter" + href="front.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="GNU mailman - List" + href="mailman-admin.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="1 introduction to GNU" + href="node3.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 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> +<td class='online-navigation'><img src='blank.png' + border='0' height='32' alt='' width='32' /></td> +</tr></table> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="front.html">Front Matter</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-admin.html">GNU Mailman - List</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node3.html">1 Introduction to GNU</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/contents.png b/doc/mailman-admin/contents.png Binary files differnew file mode 100644 index 00000000..3429be0c --- /dev/null +++ b/doc/mailman-admin/contents.png diff --git a/doc/mailman-admin/front.html b/doc/mailman-admin/front.html new file mode 100644 index 00000000..b0977103 --- /dev/null +++ b/doc/mailman-admin/front.html @@ -0,0 +1,114 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="contents.html" /> +<link rel="prev" href="mailman-admin.html" /> +<link rel="parent" href="mailman-admin.html" /> +<link rel="next" href="contents.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>Front Matter</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 class='online-navigation'><a rel="prev" title="GNU mailman - List" + href="mailman-admin.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="GNU mailman - List" + href="mailman-admin.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="Contents" + href="contents.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="mailman-admin.html">GNU Mailman - List</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-admin.html">GNU Mailman - List</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="contents.html">Contents</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION001000000000000000000"></a><a name="front"></a> +<br> +Front Matter +</h1> + +<p> + +<h3>Abstract:</h3> +<div class="ABSTRACT"> + +This document describes the list administrator's interface for GNU +Mailman 2.1. It contains information a list owner would need to +configure their list, either through the web interface or through +email. It also covers the moderator's interface for approving held +messages and subscription notices, and the web interface for creating +new mailing lists. In general, it does not cover the command line +interface to Mailman, installing Mailman, or interacting with Mailman +from the point of view of the user. That information is covered in +other manuals. +</div> +<p> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="GNU mailman - List" + href="mailman-admin.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="GNU mailman - List" + href="mailman-admin.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="Contents" + href="contents.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="mailman-admin.html">GNU Mailman - List</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="mailman-admin.html">GNU Mailman - List</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="contents.html">Contents</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/index.dat b/doc/mailman-admin/index.dat new file mode 100644 index 00000000..e69de29b --- /dev/null +++ b/doc/mailman-admin/index.dat diff --git a/doc/mailman-admin/index.html b/doc/mailman-admin/index.html new file mode 100644 index 00000000..d79769ad --- /dev/null +++ b/doc/mailman-admin/index.html @@ -0,0 +1,130 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="front.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>GNU Mailman - List Administration Manual</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 class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up one Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.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 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> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<div class="titlepage"> +<div class='center'> +<h1>GNU Mailman - List Administration Manual</h1> +<p><b><font size="+2">Barry A. Warsaw</font></b></p> +<p><strong>Release 2.1</strong><br /> +<strong>December 5, 2007</strong></p> +<p></p> +</div> +</div> + +<p> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<a name="CHILD_LINKS"></a> + +<ul class="ChildLinks"> +<li><a href="front.html">Front Matter</a> +<li><a href="contents.html">Contents</a> +<ul> +<li><a href="node3.html">1 Introduction to GNU Mailman</a> +<ul> +<li><a href="node4.html">1.1 A List's Email Addresses</a> +<li><a href="node5.html">1.2 Administrative Roles</a> +<li><a href="node6.html">1.3 A List's Web Pages</a> +<li><a href="node7.html">1.4 Basic Architectural Overview</a> +</ul> +<li><a href="node8.html">2 The List Configuration Pages</a> +<ul> +<li><a href="node9.html">2.1 The General Options Category</a> +<li><a href="node15.html">2.2 The Passwords Category</a> +<li><a href="node16.html">2.3 The Language Options Category</a> +<li><a href="node17.html">2.4 The Membership Management Category</a> +<li><a href="node18.html">2.5 The Non-digest Options Category</a> +<li><a href="node19.html">2.6 The Digest Options Category</a> +<li><a href="node20.html">2.7 The Privacy Options Category</a> +<li><a href="node25.html">2.8 The Bounce Processing Category</a> +<li><a href="node26.html">2.9 The Archiving Options Category</a> +<li><a href="node27.html">2.10 The Mail/News Gateway Category</a> +<li><a href="node28.html">2.11 The Auto-responder Category</a> +<li><a href="node29.html">2.12 The Content Filtering Category</a> +<li><a href="node30.html">2.13 The Topics Category</a> +</ul> +<li><a href="node31.html">3 Membership Management</a> +<li><a href="node32.html">4 Tending to Pending Moderator Requests</a> +<li><a href="node33.html">5 Editing the Public HTML Pages</a> +<li><a href="node34.html">6 Deleting the Mailing List</a> +<li><a href="node35.html">1 This is an Appendix</a> +</ul> +<li><a href="about.html">About this document ...</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up one Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.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 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> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/index.png b/doc/mailman-admin/index.png Binary files differnew file mode 100644 index 00000000..cd918afe --- /dev/null +++ b/doc/mailman-admin/index.png diff --git a/doc/mailman-admin/internals.pl b/doc/mailman-admin/internals.pl new file mode 100644 index 00000000..8ef71735 --- /dev/null +++ b/doc/mailman-admin/internals.pl @@ -0,0 +1,18 @@ +# LaTeX2HTML 2002-2-1 (1.71) +# Associate internals original text with physical files. + + +$key = q/front/; +$ref_files{$key} = "$dir".q|node1.html|; +$noresave{$key} = "$nosave"; + +$key = q/contents/; +$ref_files{$key} = "$dir".q|node2.html|; +$noresave{$key} = "$nosave"; + +$key = q/about/; +$ref_files{$key} = "$dir".q|node36.html|; +$noresave{$key} = "$nosave"; + +1; + diff --git a/doc/mailman-admin/intlabels.pl b/doc/mailman-admin/intlabels.pl new file mode 100644 index 00000000..44814752 --- /dev/null +++ b/doc/mailman-admin/intlabels.pl @@ -0,0 +1,3 @@ +%internal_labels = (); +1; # hack in case there are no entries + diff --git a/doc/mailman-admin/labels.pl b/doc/mailman-admin/labels.pl new file mode 100644 index 00000000..70f0223d --- /dev/null +++ b/doc/mailman-admin/labels.pl @@ -0,0 +1,25 @@ +# LaTeX2HTML 2002-2-1 (1.71) +# Associate labels original text with physical files. + + +$key = q/front/; +$external_labels{$key} = "$URL/" . q|node1.html|; +$noresave{$key} = "$nosave"; + +$key = q/contents/; +$external_labels{$key} = "$URL/" . q|node2.html|; +$noresave{$key} = "$nosave"; + +$key = q/about/; +$external_labels{$key} = "$URL/" . q|node36.html|; +$noresave{$key} = "$nosave"; + +1; + + +# LaTeX2HTML 2002-2-1 (1.71) +# labels from external_latex_labels array. + + +1; + diff --git a/doc/mailman-admin/mailman-admin.css b/doc/mailman-admin/mailman-admin.css new file mode 100644 index 00000000..06a613c2 --- /dev/null +++ b/doc/mailman-admin/mailman-admin.css @@ -0,0 +1,243 @@ +/* + * The first part of this is the standard CSS generated by LaTeX2HTML, + * with the "empty" declarations removed. + */ + +/* Century Schoolbook font is very similar to Computer Modern Math: cmmi */ +.math { font-family: "Century Schoolbook", serif; } +.math i { font-family: "Century Schoolbook", serif; + font-weight: bold } +.boldmath { font-family: "Century Schoolbook", serif; + font-weight: bold } + +/* + * Implement both fixed-size and relative sizes. + * + * I think these can be safely removed, as it doesn't appear that + * LaTeX2HTML ever generates these, even though these are carried + * over from the LaTeX2HTML stylesheet. + */ +small.xtiny { font-size : xx-small; } +small.tiny { font-size : x-small; } +small.scriptsize { font-size : smaller; } +small.footnotesize { font-size : small; } +big.xlarge { font-size : large; } +big.xxlarge { font-size : x-large; } +big.huge { font-size : larger; } +big.xhuge { font-size : xx-large; } + +/* + * Document-specific styles come next; + * these are added for the Python documentation. + * + * Note that the size specifications for the H* elements are because + * Netscape on Solaris otherwise doesn't get it right; they all end up + * the normal text size. + */ + +body { color: #000000; + background-color: #ffffff; } + +a:link:active { color: #ff0000; } +a:link:hover { background-color: #bbeeff; } +a:visited:hover { background-color: #bbeeff; } +a:visited { color: #551a8b; } +a:link { color: #0000bb; } + +h1, h2, h3, h4, h5, h6 { font-family: avantgarde, sans-serif; + font-weight: bold; } +h1 { font-size: 180%; } +h2 { font-size: 150%; } +h3, h4 { font-size: 120%; } + +/* These are section titles used in navigation links, so make sure we + * match the section header font here, even it not the weight. + */ +.sectref { font-family: avantgarde, sans-serif; } +/* And the label before the titles in navigation: */ +.navlabel { font-size: 85%; } + + +/* LaTeX2HTML insists on inserting <br> elements into headers which + * are marked with \label. This little bit of CSS magic ensures that + * these elements don't cause spurious whitespace to be added. + */ +h1>br, h2>br, h3>br, +h4>br, h5>br, h6>br { display: none; } + +code, tt { font-family: "lucida typewriter", lucidatypewriter, + monospace; } +var { font-family: times, serif; + font-style: italic; + font-weight: normal; } + +.Unix { font-variant: small-caps; } + +.typelabel { font-family: lucida, sans-serif; } + +.navigation td { background-color: #99ccff; + font-weight: bold; + font-family: avantgarde, sans-serif; + font-size: 110%; } + +div.warning { background-color: #fffaf0; + border: thin solid black; + padding: 1em; + margin-left: 2em; + margin-right: 2em; } + +div.warning .label { font-family: sans-serif; + font-size: 110%; + margin-right: 0.5em; } + +div.note { background-color: #fffaf0; + border: thin solid black; + padding: 1em; + margin-left: 2em; + margin-right: 2em; } + +div.note .label { margin-right: 0.5em; + font-family: sans-serif; } + +address { font-size: 80%; } +.release-info { font-style: italic; + font-size: 80%; } + +.titlegraphic { vertical-align: top; } + +.verbatim pre { color: #00008b; + font-family: "lucida typewriter", lucidatypewriter, + monospace; + font-size: 90%; } +.verbatim { margin-left: 2em; } +.verbatim .footer { padding: 0.05in; + font-size: 85%; + background-color: #99ccff; + margin-right: 0.5in; } + +.grammar { background-color: #99ccff; + margin-right: 0.5in; + padding: 0.05in; } +.grammar-footer { padding: 0.05in; + font-size: 85%; } +.grammartoken { font-family: "lucida typewriter", lucidatypewriter, + monospace; } + +.productions { background-color: #bbeeff; } +.productions a:active { color: #ff0000; } +.productions a:link:hover { background-color: #99ccff; } +.productions a:visited:hover { background-color: #99ccff; } +.productions a:visited { color: #551a8b; } +.productions a:link { color: #0000bb; } +.productions table { vertical-align: baseline; + empty-cells: show; } +.productions > table td, +.productions > table th { padding: 2px; } +.productions > table td:first-child, +.productions > table td:last-child { + font-family: "lucida typewriter", + lucidatypewriter, + monospace; + } +/* same as the second selector above, but expressed differently for Opera */ +.productions > table td:first-child + td + td { + font-family: "lucida typewriter", + lucidatypewriter, + monospace; + vertical-align: baseline; + } +.productions > table td:first-child + td { + padding-left: 1em; + padding-right: 1em; + } +.productions > table tr { vertical-align: baseline; } + +.email { font-family: avantgarde, sans-serif; } +.mailheader { font-family: avantgarde, sans-serif; } +.mimetype { font-family: avantgarde, sans-serif; } +.newsgroup { font-family: avantgarde, sans-serif; } +.url { font-family: avantgarde, sans-serif; } +.file { font-family: avantgarde, sans-serif; } +.guilabel { font-family: avantgarde, sans-serif; } + +.realtable { border-collapse: collapse; + border-color: black; + border-style: solid; + border-width: 0px 0px 2px 0px; + empty-cells: show; + margin-left: auto; + margin-right: auto; + padding-left: 0.4em; + padding-right: 0.4em; + } +.realtable tbody { vertical-align: baseline; } +.realtable tfoot { display: table-footer-group; } +.realtable thead { background-color: #99ccff; + border-width: 0px 0px 2px 1px; + display: table-header-group; + font-family: avantgarde, sans-serif; + font-weight: bold; + vertical-align: baseline; + } +.realtable thead :first-child { + border-width: 0px 0px 2px 0px; + } +.realtable thead th { border-width: 0px 0px 2px 1px } +.realtable td, +.realtable th { border-color: black; + border-style: solid; + border-width: 0px 0px 1px 1px; + padding-left: 0.4em; + padding-right: 0.4em; + } +.realtable td:first-child, +.realtable th:first-child { + border-left-width: 0px; + vertical-align: baseline; + } +.center { text-align: center; } +.left { text-align: left; } +.right { text-align: right; } + +.refcount-info { font-style: italic; } +.refcount-info .value { font-weight: bold; + color: #006600; } + +/* + * Some decoration for the "See also:" blocks, in part inspired by some of + * the styling on Lars Marius Garshol's XSA pages. + * (The blue in the navigation bars is #99CCFF.) + */ +.seealso { background-color: #fffaf0; + border: thin solid black; + padding: 0pt 1em 4pt 1em; } + +.seealso > .heading { font-size: 110%; + font-weight: bold; } + +/* + * Class 'availability' is used for module availability statements at + * the top of modules. + */ +.availability .platform { font-weight: bold; } + + +/* + * Additional styles for the distutils package. + */ +.du-command { font-family: monospace; } +.du-option { font-family: avantgarde, sans-serif; } +.du-filevar { font-family: avantgarde, sans-serif; + font-style: italic; } +.du-xxx:before { content: "** "; + font-weight: bold; } +.du-xxx:after { content: " **"; + font-weight: bold; } + + +/* + * Some specialization for printed output. + */ +@media print { + .online-navigation { display: none; } + } diff --git a/doc/mailman-admin/mailman-admin.html b/doc/mailman-admin/mailman-admin.html new file mode 100644 index 00000000..d79769ad --- /dev/null +++ b/doc/mailman-admin/mailman-admin.html @@ -0,0 +1,130 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="front.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>GNU Mailman - List Administration Manual</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 class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up one Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.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 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> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<div class="titlepage"> +<div class='center'> +<h1>GNU Mailman - List Administration Manual</h1> +<p><b><font size="+2">Barry A. Warsaw</font></b></p> +<p><strong>Release 2.1</strong><br /> +<strong>December 5, 2007</strong></p> +<p></p> +</div> +</div> + +<p> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<a name="CHILD_LINKS"></a> + +<ul class="ChildLinks"> +<li><a href="front.html">Front Matter</a> +<li><a href="contents.html">Contents</a> +<ul> +<li><a href="node3.html">1 Introduction to GNU Mailman</a> +<ul> +<li><a href="node4.html">1.1 A List's Email Addresses</a> +<li><a href="node5.html">1.2 Administrative Roles</a> +<li><a href="node6.html">1.3 A List's Web Pages</a> +<li><a href="node7.html">1.4 Basic Architectural Overview</a> +</ul> +<li><a href="node8.html">2 The List Configuration Pages</a> +<ul> +<li><a href="node9.html">2.1 The General Options Category</a> +<li><a href="node15.html">2.2 The Passwords Category</a> +<li><a href="node16.html">2.3 The Language Options Category</a> +<li><a href="node17.html">2.4 The Membership Management Category</a> +<li><a href="node18.html">2.5 The Non-digest Options Category</a> +<li><a href="node19.html">2.6 The Digest Options Category</a> +<li><a href="node20.html">2.7 The Privacy Options Category</a> +<li><a href="node25.html">2.8 The Bounce Processing Category</a> +<li><a href="node26.html">2.9 The Archiving Options Category</a> +<li><a href="node27.html">2.10 The Mail/News Gateway Category</a> +<li><a href="node28.html">2.11 The Auto-responder Category</a> +<li><a href="node29.html">2.12 The Content Filtering Category</a> +<li><a href="node30.html">2.13 The Topics Category</a> +</ul> +<li><a href="node31.html">3 Membership Management</a> +<li><a href="node32.html">4 Tending to Pending Moderator Requests</a> +<li><a href="node33.html">5 Editing the Public HTML Pages</a> +<li><a href="node34.html">6 Deleting the Mailing List</a> +<li><a href="node35.html">1 This is an Appendix</a> +</ul> +<li><a href="about.html">About this document ...</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></td> +<td class='online-navigation'><img src='up.png' + border='0' height='32' alt='Up one Level' width='32' /></td> +<td class='online-navigation'><a rel="next" title="Front Matter" + href="front.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 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> +<div class='online-navigation'> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="front.html">Front Matter</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/modules.png b/doc/mailman-admin/modules.png Binary files differnew file mode 100644 index 00000000..8fa8b755 --- /dev/null +++ b/doc/mailman-admin/modules.png diff --git a/doc/mailman-admin/next.png b/doc/mailman-admin/next.png Binary files differnew file mode 100644 index 00000000..cfe5e51c --- /dev/null +++ b/doc/mailman-admin/next.png diff --git a/doc/mailman-admin/node10.html b/doc/mailman-admin/node10.html new file mode 100644 index 00000000..29a6bb8d --- /dev/null +++ b/doc/mailman-admin/node10.html @@ -0,0 +1,199 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node11.html" /> +<link rel="prev" href="node9.html" /> +<link rel="parent" href="node9.html" /> +<link rel="next" href="node11.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.1.1 General list personality</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 class='online-navigation'><a rel="prev" title="2.1 the General Options" + href="node9.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.1 the General Options" + href="node9.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.1.2 reply-to header munging" + href="node11.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node11.html">2.1.2 Reply-To header munging</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002211000000000000000"> +2.1.1 General list personality</a> +</h3> + +<p> +These variables, grouped under the general list personality section, +control some public information about the mailing list. + +<p> +<dl> +<dt><strong>real_name</strong></dt> +<dd>Every mailing list has both a <em>posting name</em> and a <em>real + name</em>. The posting name shows up in urls and in email addresses, + e.g. the <code>mylist</code> in <code>mylist@example.com</code>. The posting + name is always presented in lower case, with alphanumeric + characters and no spaces. The list's real name is used in some + public information and email responses, such as in the general + list overview. The real name can differ from the posting name by + case only. For example, if the posting name is <code>mylist</code>, the + real name can be <code>Posting</code>. + +<p> +</dd> +<dt><strong>owner</strong></dt> +<dd>This variable contains a list of email addresses, one address per + line, of the list owners. These addresses are used whenever the + list owners need to be contacted, either by the system or by end + users. Often, these addresses are used in combination with the + <code>moderator</code> addresses (see below). + +<p> +</dd> +<dt><strong>moderator</strong></dt> +<dd>This variable contains a list of email addresses, one address per + line, of the list moderators. These addresses are often used in + combination with the <code>owner</code> addresses. For example, when + you email <code>mylist-owner@example.com</code>, both the owner and + moderator addresses will receive a copy of the message. + +<p> +</dd> +<dt><strong>description</strong></dt> +<dd>In the general list overview page, which shows you every available + mailing list, each list is displayed with a short description. + The contents of this variable is that description. Note that in + emails from the mailing list, this description is also used in the + comment section of the <span class="mailheader">To:</span> address. This text should + be relatively short and no longer than one line. + +<p> +</dd> +<dt><strong>info</strong></dt> +<dd>This variable contains a longer description of the mailing list. + It is included at the top of the list's information page, and it + can contain HTML. However, blank lines will be automatically + converted into paragraph breaks. Preview your HTML though, + because unclosed or invalid HTML can prevent display of parts of + the list information page. + +<p> +</dd> +<dt><strong>subject_prefix</strong></dt> +<dd>This is a string that will be prepended to the + <span class="mailheader">Subject:</span> header of any message posted to the list. + For example, if a message is posted to the list with a + <span class="mailheader">Subject:</span> like: + +<p> +<div class="verbatim"><pre> + Subject: This is a message +</pre></div> + +<p> +and the <code>subject_prefix</code> is <code>[My List] </code> (note the + trailing space!), then the message will be received like so: + +<p> +<div class="verbatim"><pre> + Subject: [My List] This is a message +</pre></div> + +<p> +If you leave <code>subject_prefix</code> empty, no prefix will be added + to the <span class="mailheader">Subject:</span>. Mailman is careful not to add a + prefix when the header already has one, as is the case in replies + for example. The prefix can also contain characters in the list's + preferred language. In this case, because of vagarities of the + email standards, you may or may not want to add a trailing space. + +<p> +</dd> +<dt><strong>anonymous_list</strong></dt> +<dd>This variable allows you to turn on some simple anonymizing + features of Mailman. When you set this option to <em>Yes</em>, + Mailman will remove or replace the <span class="mailheader">From:</span>, + <span class="mailheader">Sender:</span>, and <span class="mailheader">Reply-To:</span> fields of any + message posted to the list. + +<p> +Note that this option is simply an aid for anonymization, it + doesn't guarantee it. For example, a poster's identity could be + evident in their signature, or in other mail headers, or even in + the style of the content of the message. There's little Mailman + can do about this kind of identity leakage. +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1 the General Options" + href="node9.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.1 the General Options" + href="node9.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.1.2 reply-to header munging" + href="node11.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node11.html">2.1.2 Reply-To header munging</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node11.html b/doc/mailman-admin/node11.html new file mode 100644 index 00000000..665d5bfd --- /dev/null +++ b/doc/mailman-admin/node11.html @@ -0,0 +1,200 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node12.html" /> +<link rel="prev" href="node10.html" /> +<link rel="parent" href="node9.html" /> +<link rel="next" href="node12.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.1.2 Reply-To header munging</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 class='online-navigation'><a rel="prev" title="2.1.1 general list personality" + href="node10.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.1 the General Options" + href="node9.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.1.3 umbrella list settings" + href="node12.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node10.html">2.1.1 General list personality</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node12.html">2.1.3 Umbrella list settings</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002212000000000000000"> +2.1.2 Reply-To header munging</a> +</h3> + +<p> +This section controls what happens to the <span class="mailheader">Reply-To:</span> +headers of messages posted through your list. + +<p> +Beware! <span class="mailheader">Reply-To:</span> munging is considered a religious issue +and the policies you set here can ignite some of the most heated +off-topic flame wars on your mailing lists. We'll try to stay as +agnostic as possible, but our biases may still peak through. + +<p> +<span class="mailheader">Reply-To:</span> is a header that is commonly used to redirect +replies to messages. Exactly what happens when your uses reply to +such a message depends on the mail readers your users use, and what +functions they provide. Usually, there is both a ``reply to sender'' +button and a ``reply to all'' button. If people use these buttons +correctly, you will probably never need to munge +<span class="mailheader">Reply-To:</span>, so the default values should be fine. + +<p> +Since an informed decision is always best, here are links to two +articles that discuss the opposing viewpoints in great detail: + +<p> + +<ul> +<li><a class="ulink" href="http://www.unicom.com/pw/reply-to-harmful.html" + >Reply-To Munging Considered + Harmful</a> +</li> +<li><a class="ulink" href="http://www.metasystema.org/essays/reply-to-useful.mhtml" + >Reply-To Munging Considered + Useful</a> + +<p> +</li> +</ul> + +<p> +The three options in this section work together to provide enough +flexibility to do whatever <span class="mailheader">Reply-To:</span> munging you might +(misguidingly :) feel you need to do. + +<p> +<dl> +<dt><strong>first_strip_reply_to</strong></dt> +<dd>This variable controls whether any <span class="mailheader">Reply-To:</span> header + already present in the posted message should get removed before + any other munging occurs. Stripping this header will be done + regardless of whether or not Mailman will add its own + <span class="mailheader">Reply-To:</span> header to the message. + +<p> +If this option is set to <em>No</em>, then any existing + <span class="mailheader">Reply-To:</span> header will be retained in the posted + message. If Mailman adds its own header, it will contain + addresses which are the union of the original header and the + Mailman added addresses. The mail standards specify that a + message may only have one <span class="mailheader">Reply-To:</span> header, but that + that header may contain multiple addresses. + +<p> +</dd> +<dt><strong>reply_goes_to_list</strong></dt> +<dd>This variable controls whether Mailman will add its own + <span class="mailheader">Reply-To:</span> header, and if so, what the value of that + header will be (not counting original header stripping - see + above). + +<p> +When you set this variable to <em>Poster</em>, no additional + <span class="mailheader">Reply-To:</span> header will be added by Mailman. This + setting is strongly recommended. + +<p> +When you set this variable to <em>This list</em>, a + <span class="mailheader">Reply-To:</span> header pointing back to your list's posting + address will be added. + +<p> +When you set this variable to <em>Explicit address</em>, the value + of the variable <code>reply_to_address</code> (see below) will be + added. Note that this is one situation where + <span class="mailheader">Reply-To:</span> munging may have a legitimate purpose. Say + you have two lists at your site, an announce list and a discussion + list. The announce list might allow postings only from a small + number of approved users; the general list membership probably + can't post to this list. But you want to allow comments on + announcements to be posted to the general discussion list by any + list member. In this case, you can set the <span class="mailheader">Reply-To:</span> + header for the announce list to point to the discussion list's + posting address. + +<p> +</dd> +<dt><strong>reply_to_address</strong></dt> +<dd>This is the address that will be added in the + <span class="mailheader">Reply-To:</span> header if <code>reply_goes_to_list</code> is set + to <em>Explicit address</em>. + +<p> +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1.1 general list personality" + href="node10.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.1 the General Options" + href="node9.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.1.3 umbrella list settings" + href="node12.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node10.html">2.1.1 General list personality</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node12.html">2.1.3 Umbrella list settings</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node12.html b/doc/mailman-admin/node12.html new file mode 100644 index 00000000..1f4a69cc --- /dev/null +++ b/doc/mailman-admin/node12.html @@ -0,0 +1,100 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node13.html" /> +<link rel="prev" href="node11.html" /> +<link rel="parent" href="node9.html" /> +<link rel="next" href="node13.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.1.3 Umbrella list settings</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 class='online-navigation'><a rel="prev" title="2.1.2 reply-to header munging" + href="node11.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.1 the General Options" + href="node9.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.1.4 Notifications" + href="node13.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node11.html">2.1.2 Reply-To header munging</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node13.html">2.1.4 Notifications</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002213000000000000000"> +2.1.3 Umbrella list settings</a> +</h3> + +<p> +TBD. Note that umbrella lists are deprecated and will be replace with +a better mechanism for Mailman 3.0. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1.2 reply-to header munging" + href="node11.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.1 the General Options" + href="node9.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.1.4 Notifications" + href="node13.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node11.html">2.1.2 Reply-To header munging</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node13.html">2.1.4 Notifications</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node13.html b/doc/mailman-admin/node13.html new file mode 100644 index 00000000..bbf848ce --- /dev/null +++ b/doc/mailman-admin/node13.html @@ -0,0 +1,184 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node14.html" /> +<link rel="prev" href="node12.html" /> +<link rel="parent" href="node9.html" /> +<link rel="next" href="node14.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.1.4 Notifications</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 class='online-navigation'><a rel="prev" title="2.1.3 umbrella list settings" + href="node12.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.1 the General Options" + href="node9.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.1.5 additional settings" + href="node14.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node12.html">2.1.3 Umbrella list settings</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node14.html">2.1.5 Additional settings</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002214000000000000000"> +2.1.4 Notifications</a> +</h3> + +<p> +Mailman sends notifications to the list administrators or list members +under a number of different circumstances. Most of these +notifications can be configured in this section, but see the Bounce +Processing and Auto-responder categories for other notifications that +Mailman can send. + +<p> +<dl> +<dt><strong>send_reminders</strong></dt> +<dd>By default Mailman sends all list members a monthly password + reminder. This notice serves two purposes. First, it reminds + people about all the lists they may be subscribed to on this + domain, including the lists where their subscription may be + disabled. Second, it reminds people about their passwords for + these lists, as well as the url for their personal options pages, + so that they can more easily configure their subscription options. + +<p> +Some people get annoyed with these monthly reminders, and they can + disable the reminders via their subscription options page. For + some lists, the monthly reminders aren't appropriate for any of + the members, so you can disable them list-wide by setting the + <code>send_reminders</code> variable to <em>No</em>. + +<p> +</dd> +<dt><strong>welcome_msg</strong></dt> +<dd>When new members are subscribed to the list, either by their own + action, or the action of a list administrator, a welcome message + can be sent to them. The welcome message contains some common + boilerplate information, such as the name of the list, + instructions for posting to the list, and the member's + subscription password. You can add additional information to the + welcome message by typing the text into the <code>welcome_msg</code> + text box. Note that because this text is sent as part of an + email, it should <strong>not</strong> contain HTML. + +<p> +</dd> +<dt><strong>send_welcome_msg</strong></dt> +<dd>This flag controls whether or not the welcome message is sent to + new subscribers. + +<p> +</dd> +<dt><strong>goodbye_msg</strong></dt> +<dd>Like the <code>welcome_msg</code>, a ``goodbye'' message can be sent to + members when they unsubscribe from the list. Unlike the welcome + message, there's no boilerplate for the goodbye message. Enter + the entire goodbye message you'd like unsubscribing members to + receive into the <code>goodbye_msg</code> text box. + +<p> +</dd> +<dt><strong>send_goodbye_msg</strong></dt> +<dd>This flag controls whether or not the goodbye message is sent to + unsubscribing members. + +<p> +</dd> +<dt><strong>admin_immed_notify</strong></dt> +<dd>List moderators get notifications of pending administrative + actions, such as subscription or unsubscription requests that + require moderator approval, or posted messages that are being held + for moderator approval. List moderators will always get a daily + summary of such pending requests, but they can also get immediate + notifications when such a request is made. The + <code>admin_immed_notify</code> variable controls whether these + immediate notifications are sent or not. It's generally a good + idea to leave this set to <em>Yes</em>. + +<p> +</dd> +<dt><strong>admin_notify_mchanges</strong></dt> +<dd>This variable controls whether the list administrators should get + notifications when members join or leave the list. + +<p> +</dd> +<dt><strong>respond_to_post_requests</strong></dt> +<dd>This variable controls whether the original sender of a posting + gets a notice when their message is held for moderator approval. + +<p> +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1.3 umbrella list settings" + href="node12.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.1 the General Options" + href="node9.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.1.5 additional settings" + href="node14.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node12.html">2.1.3 Umbrella list settings</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node14.html">2.1.5 Additional settings</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node14.html b/doc/mailman-admin/node14.html new file mode 100644 index 00000000..99e91f28 --- /dev/null +++ b/doc/mailman-admin/node14.html @@ -0,0 +1,207 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="prev" href="node13.html" /> +<link rel="parent" href="node9.html" /> +<link rel="next" href="node15.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.1.5 Additional settings</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 class='online-navigation'><a rel="prev" title="2.1.4 Notifications" + href="node13.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.1 the General Options" + href="node9.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.2 the Passwords Category" + href="node15.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node13.html">2.1.4 Notifications</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node15.html">2.2 The Passwords Category</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002215000000000000000"> +2.1.5 Additional settings</a> +</h3> + +<p> +This section contains some miscellaneous settings for your mailing +list. + +<p> +<dl> +<dt><strong>emergency</strong></dt> +<dd>When this option is enabled, all list traffic is emergency + moderated, i.e. held for moderation. Turn this option on when + your list is experiencing a flamewar and you want a cooling off + period. + +<p> +</dd> +<dt><strong>new_member_options</strong></dt> +<dd>Each member has a set of subscription options which they can use + to control how they receive messages and otherwise interact with + the list. While the members can change these settings by logging + into their personal options page, you might want to set the + default for a number of the member options. You can do that with + this variable, but see also the other categories for other member + defaults you can set. + +<p> +This variable presents a set of checkboxes which control the + defaults for some of the member options. <em>Conceal the + member's address</em> specifies whether or not the address is + displayed in the list roster. <em>Acknowledge the member's + posting</em> controls whether or not Mailman sends an acknowledgement + to a member when they post a message to the list. <em>Do not + send a copy of a member's own post</em> specifies whether a member + posting to the list will get a copy of their own posting. + <em>Filter out duplicate messages to list members (if possible)</em> + specifies whether members who are explicitly listed as a recipient + of a message (e.g. via the <span class="mailheader">Cc:</span> header) will also get a + copy from Mailman. + +<p> +Of course, members can always override these defaults by making + changes on their membership options page. + +<p> +</dd> +<dt><strong>administrivia</strong></dt> +<dd>This option specifies whether Mailman will search posted messages + for <em>admimistrivia</em>, in other words, email commands which + usually should be posted to the <code>-request</code> address for the + list. Setting this to <em>Yes</em> helps prevent such things as + unsubscribe messages getting erroneously posted to the list. + +<p> +If a message seems to contain administrivia, it is held for + moderator approval. + +<p> +</dd> +<dt><strong>max_message_size</strong></dt> +<dd>This option specifies a maximum message size, in kilobytes, over + which the message will be held for moderator approval. + +<p> +</dd> +<dt><strong>host_name</strong></dt> +<dd>This option specifies the host name part of email addresses used + by this list. For example, this is the <code>example.com</code> part of + the posting address <code>mylist@example.com</code>. + +<p> +It's generally not a good idea to change this value, since its + default value is specified when the mailing list is created. + Changing this to an incorrect value could make it difficult to + contact your mailing list. Also not that the url used to visit + the list's pages is not configurable through the web interface. + This is because if you messed it up, you'd have to have the site + administrator fix it. + +<p> +</dd> +<dt><strong>include_rfc2369_headers</strong></dt> +<dd><a class="rfc" id='rfcref-1033' xml:id='rfcref-1033' +href="http://www.faqs.org/rfcs/rfc2369.html">RFC 2369</a> is an internet standard that describes a bunch of + headers that mailing list managers should add to messages to make + it easier for people to interact with the list. Mail reading + programs which support this standard may provide buttons for easy + access to the list's archives, or for subscribing and + unsubscribing to the list. It's generally a good idea to enable + these headers as it provides for an improved user experience. + These headers are often called the <code>List-*</code> headers. + +<p> +However, not all mail readers are standards compliant yet, and if + you have a large number of members who are using non-compliant + mail readers, they may be annoyed at these headers. You should + first try to educate your members as to why these headers exist, + and how to hide them in their mail clients. As a last resort you + can disable these headers, but this is not recommended. + +<p> +</dd> +<dt><strong>include_list_post_header</strong></dt> +<dd>The <span class="mailheader">List-Post:</span> header is one of the headers + recommended by <a class="rfc" id='rfcref-1035' xml:id='rfcref-1035' +href="http://www.faqs.org/rfcs/rfc2369.html">RFC 2369</a>. However for some announce-only mailing + lists, only a very select group of people are allowed to post to + the list; the general membership is usually not allowed to post to + such lists. For lists of this nature, the <span class="mailheader">List-Post:</span> + header is misleading. Select <em>No</em> to disable the inclusion + of this header. (This does not affect the inclusion of the other + <code>List-*</code> headers.) +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1.4 Notifications" + href="node13.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.1 the General Options" + href="node9.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.2 the Passwords Category" + href="node15.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node13.html">2.1.4 Notifications</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node9.html">2.1 The General Options</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node15.html">2.2 The Passwords Category</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node15.html b/doc/mailman-admin/node15.html new file mode 100644 index 00000000..db700d93 --- /dev/null +++ b/doc/mailman-admin/node15.html @@ -0,0 +1,120 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node16.html" /> +<link rel="prev" href="node9.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node16.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.2 The Passwords 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 class='online-navigation'><a rel="prev" title="2.1.5 additional settings" + href="node14.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.3 the Language Options" + href="node16.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node14.html">2.1.5 Additional settings</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="node16.html">2.3 The Language Options</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002220000000000000000"> +2.2 The Passwords Category</a> +</h2> +As mentioned above, there are two primary administrative roles for +mailing lists. In this category you can specify the password for +these roles. + +<p> +The list owner has total control over the configuration of their +mailing list (within some bounds as specified by the site +administrator). Note that on this page, for historical reasons, the +list owner role is described here as the <em>list administrator</em>. +You can set the list owner's password by entering it in the password +field on the left. You must type it twice for confirmation. Note +that if you forget this password, the only way for you to get back +into your list's administrative pages is to ask the site administrator +to reset it for you (there's no password reminders for list owners). + +<p> +If you want to delegate list moderation to someone else, you can enter +a different moderator password in the field on the right (typed twice +for confirmation). Note that if you aren't going to delegate +moderation, and the same people are going to both configure the list +and moderate postings to the list, don't enter anything into the +moderator password fields. If you do enter a separate moderator +password, be sure to fill in the <code>moderator</code> variable in the +<em>General options</em> category page. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.1.5 additional settings" + href="node14.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.3 the Language Options" + href="node16.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node14.html">2.1.5 Additional settings</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="node16.html">2.3 The Language Options</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node16.html b/doc/mailman-admin/node16.html new file mode 100644 index 00000000..fe00410f --- /dev/null +++ b/doc/mailman-admin/node16.html @@ -0,0 +1,156 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node17.html" /> +<link rel="prev" href="node15.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node17.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.3 The Language 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 class='online-navigation'><a rel="prev" title="2.2 the Passwords Category" + href="node15.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.4 the Membership Management" + href="node17.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node15.html">2.2 The Passwords Category</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="node17.html">2.4 The Membership Management</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002230000000000000000"> +2.3 The Language Options Category</a> +</h2> +Mailman is multilingual and internationalized, meaning you can set up +your list so that members can interact with it in any of a number of +natural languages. Of course, Mailman won't translate list +postings. :) + +<p> +However, if your site administrator has enabled its support, you can +set your list up to support any of about two dozen languages, such as +German, Italian, Japanese, or Spanish. Your list members can then +choose any of your supported languages as their <em>preferred +language</em> for interacting with the list. Such things as their member +options page will be displayed in this language. Each mailing list +also has its own <em>preferred language</em> which is the language the +list supports if no other language context is known. + +<p> +These variables control the language settings for your mailing list: + +<p> +<dl> +<dt><strong>preferred_language</strong></dt> +<dd>This is the list's preferred language, which is the language that + the list administrative pages will be displayed in. Also any + messages sent to the list owners by Mailman will be sent in this + language. This option is presented as a drop-down list containing + the language enabled in the <code>available_languages</code> variable. + +<p> +</dd> +<dt><strong>available_languages</strong></dt> +<dd>This set of checkboxes contains all the natural languages that + your site administrator has made available to your mailing lists. + Select any language that you'd either like your members to be able + to view the list in, or that you'd like to be able to use in your + list's <code>preferred_language</code> variable. + +<p> +</dd> +<dt><strong>encode_ascii_prefixes</strong></dt> +<dd>If your mailing list's preferred language uses a non-ASCII + character set and the <code>subject_prefix</code> contains non-ASCII + characters, the prefix will always be encoded according to the + relevant standards. However, if your subject prefix contains only + ASCII characters, you may want to set this option to <em>Never</em> + to disable prefix encoding. This can make the subject headers + slightly more readable for users with mail readers that don't + properly handle non-ASCII encodings. + +<p> +Note however, that if your mailing list receives both encoded and + unencoded subject headers, you might want to choose <em>As + needed</em>. Using this setting, Mailman will not encode ASCII + prefixes when the rest of the header contains only ASCII + characters, but if the original header contains non-ASCII + characters, it will encode the prefix. This avoids an ambiguity + in the standards which could cause some mail readers to display + extra, or missing spaces between the prefix and the original + header. +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.2 the Passwords Category" + href="node15.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.4 the Membership Management" + href="node17.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node15.html">2.2 The Passwords Category</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="node17.html">2.4 The Membership Management</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node17.html b/doc/mailman-admin/node17.html new file mode 100644 index 00000000..df0e7232 --- /dev/null +++ b/doc/mailman-admin/node17.html @@ -0,0 +1,108 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node18.html" /> +<link rel="prev" href="node16.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node18.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.4 The Membership Management 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 class='online-navigation'><a rel="prev" title="2.3 the Language Options" + href="node16.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.5 the Non-digest Options" + href="node18.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node16.html">2.3 The Language 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="node18.html">2.5 The Non-digest Options</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002240000000000000000"> +2.4 The Membership Management Category</a> +</h2> + +<p> +The <em>Membership Management</em> category is unlike the other +administrative categories. It doesn't contain configuration variables +or list settings. Instead, it presents a number of pages that allow +you to manage the membership of you list. This includes pages for +subscribing and unsubscribing members, and for searching for members, +and for changing various member-specific settings. + +<p> +More details on membership management are described in the Membership +Management section. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.3 the Language Options" + href="node16.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.5 the Non-digest Options" + href="node18.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node16.html">2.3 The Language 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="node18.html">2.5 The Non-digest Options</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node18.html b/doc/mailman-admin/node18.html new file mode 100644 index 00000000..69795786 --- /dev/null +++ b/doc/mailman-admin/node18.html @@ -0,0 +1,318 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node19.html" /> +<link rel="prev" href="node17.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node19.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.5 The Non-digest 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 class='online-navigation'><a rel="prev" title="2.4 the Membership Management" + href="node17.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.6 the Digest Options" + href="node19.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node17.html">2.4 The Membership Management</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="node19.html">2.6 The Digest Options</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002250000000000000000"> +2.5 The Non-digest Options Category</a> +</h2> + +<p> +Mailman delivers messages to users via two modes. List members can +elect to receive postings in bundles call <em>digests</em> one or a few +times a day, or they can receive messages immediately whenever the +message is posted to the list. This latter delivery mode is also +called <em>non-digest delivery</em>. There are two administrative +categories available for separately controlling digest and non-digest +delivery. You can even disable one or the other forms of delivery +(but not both). + +<p> +Both kinds of delivery can have list-specific headers and footers +added to them which can contain other useful information you want your +list members to see. For example, you can include instructions for +unsubscribing, or a url to the lists digest, or any other information. + +<p> +Non-digest deliveries can also be <em>personalized</em> which means +certain parts of the message can contain information tailored to the +member receiving the message. For example, the <span class="mailheader">To:</span> header +will contain the address of the member when deliveries are +personalized. Footers and headers can contain personalized +information as well, such as a link to the individual user's options +page. + +<p> +In addition, personalized messages will contain extra information that +Mailman can use to unambiguously track bounces from members. +Ordinarily, Mailman does some pattern recognition on bounce messages +to determine list members whose addresses are no longer valid, but +because of the vagaries of mail systems, and the countless forwards +people can put in place, it's often the case that bounce messages +don't contain any useful information in them. Personalized messages +avoid this problem by encoding information in certain headers that +unambiguously identify the recipient of a message. If that message +bounces, Mailman will know exactly which member it was intended for. + +<p> +Note that because personalization requires extra system resources, it +must be enabled by the site administrator before you can choose it. + +<p> +Here are the variables which control non-digest delivery: + +<p> +<dl> +<dt><strong>nondigestable</strong></dt> +<dd>This option controls whether members can receive immediate + delivery or not. If not, they will be forced to receive messages + in digests. You can't disable non-digest delivery if digests are + already disabled. + +<p> +</dd> +<dt><strong>personalize</strong></dt> +<dd>This option turns on message personalization. + +<p> +</dd> +<dt><strong>msg_header</strong></dt> +<dd>This text box lets you enter information that will be included in + the header of every non-digest message sent through the + list. + +<p> +See below for more information on what can go in the headers and + footers. If you leave this text box empty, no header will be + added. + +<p> +</dd> +<dt><strong>msg_footer</strong></dt> +<dd>Just like with the header, you can add a footer to every message. + The same rules apply to footers as apply to headers. +</dd> +</dl> + +<p> +Headers and footers can contain any text you want. For non-English +lists, the headers and footers can contain any character in the +character set of the list's preferred language. The headers and +footers can also contain <em>substitution variables</em> which Mailman +will fill in with information taken from the mailing list. These +substitutions are in Python string interpolation format, where +something like <code>%(list_name)s</code> is substituted with he name of +the mailing list. Note that the trailing "<tt class="samp">s</tt>" is +required<a name="tex2html4" + href="#foot279"><sup>2</sup></a>. + +<p> +For example, a footer containing the following text: + +<p> +<div class="verbatim"><pre> +This is the \%(list_name)s mailing list +Description: \%(description)s +</pre></div> + +<p> +might get attached to postings like so: + +<p> +<div class="verbatim"><pre> +This is the Example mailing list +Description: An example of Mailman mailing lists +</pre></div> + +<p> +Here is the list of substitution variables available for your headers +and footers: + +<p> +<dl> +<dt><strong>real_name</strong></dt> +<dd>This is the value of the <code>real_name</code> configuration variable + in the General options category. + +<p> +</dd> +<dt><strong>list_name</strong></dt> +<dd>This is the canonical name of the mailing list. In other words + it's the posting address of the list<a name="tex2html5" + href="#foot280"><sup>3</sup></a>. + +<p> +</dd> +<dt><strong>host_name</strong></dt> +<dd>This is the domain name part of the email address for this list. + +<p> +</dd> +<dt><strong>web_page_url</strong></dt> +<dd>This is the base url for contacting the list via the web. It can + be appended with <code>listinfo/%(list_name)s</code> to yield the + general list information page for the mailing list. + +<p> +</dd> +<dt><strong>description</strong></dt> +<dd>The brief description of the mailing list. + +<p> +</dd> +<dt><strong>info</strong></dt> +<dd>This is the full description of the mailing list. + +<p> +</dd> +<dt><strong>cgiext</strong></dt> +<dd>This is the extension added to CGI scripts. It might be the empty + string, <code>.cgi</code>, or something else depending on how your site + is configured. +</dd> +</dl> + +<p> +Note that <code>real_name</code>, <code>host_name</code>, <code>description</code>, and +<code>info</code> substitution variables take their values from the list +configuration variables of the same name. + +<p> +When personalization is enabled, the following substitution variables +are also available: + +<p> +<dl> +<dt><strong>user_address</strong></dt> +<dd>The address of the recipient of the message, coerced to lower case. + +<p> +</dd> +<dt><strong>user_delivered_to</strong></dt> +<dd>The case-preserved address that the user subscribed to the mailing + list with<a name="tex2html6" + href="#foot281"><sup>4</sup></a>. + +<p> +</dd> +<dt><strong>user_password</strong></dt> +<dd>The user's password, in clear text. + +<p> +</dd> +<dt><strong>user_name</strong></dt> +<dd>The user's full name. + +<p> +</dd> +<dt><strong>user_optionsurl</strong></dt> +<dd>The url to the user's personal options page. +</dd> +</dl> + +<p> +<br><hr><h4>Footnotes</h4> +<dl> +<dt><a name="foot279">... +required</a><A + HREF="node18.html#tex2html4"><sup>2</sup></a></dt> +<dd>The site administrator can configure lists to use a +simpler interpolation format, where <code>$list_name</code> or +<code>${list_name}</code> would be substituted with the mailing list's +name. Ask your site administrator if the've configured your list this +way. + +</dd> +<dt><a name="foot280">... list</a><A + HREF="node18.html#tex2html5"><sup>3</sup></a></dt> +<dd>For backward + compatibility, the variable <code>_internal_name</code> is + equivalent. + +</dd> +<dt><a name="foot281">... with</a><A + HREF="node18.html#tex2html6"><sup>4</sup></a></dt> +<dd>Usually it makes no difference which of + <code>user_address</code> and <code>user_delivered_to</code> is used, but it's + important to remember that they can be different. When they're + different, Mailman always uses the lower case address as the key + to the member's subscription information, but it always delivers + messages to the case-preserved version. + +</dd> +</dl> +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.4 the Membership Management" + href="node17.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.6 the Digest Options" + href="node19.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node17.html">2.4 The Membership Management</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="node19.html">2.6 The Digest Options</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node19.html b/doc/mailman-admin/node19.html new file mode 100644 index 00000000..75a5f53e --- /dev/null +++ b/doc/mailman-admin/node19.html @@ -0,0 +1,226 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node20.html" /> +<link rel="prev" href="node18.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node20.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.6 The Digest 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 class='online-navigation'><a rel="prev" title="2.5 the Non-digest Options" + href="node18.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 the Privacy Options" + href="node20.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node18.html">2.5 The Non-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="node20.html">2.7 The Privacy Options</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002260000000000000000"> +2.6 The Digest 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. + +<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. + +<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" id='rfcref-1080' xml:id='rfcref-1080' +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. + +<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. + +<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="#foot182"><sup>5</sup></a>. + +<p> +Here are the variables which control digest delivery: + +<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. + +<p> +</dd> +<dt><strong>digest_is_default</strong></dt> +<dd>Controls which style of delivery is the default for new members. + You can choose <em>Regular</em> (non-digest) or <em>Digest</em> + 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. <em>Plain</em> + digests are <a class="rfc" id='rfcref-1082' xml:id='rfcref-1082' +href="http://www.faqs.org/rfcs/rfc1153.html">RFC 1153</a> format as described above. + +<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. + +<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 + <em>No</em>, then digests will only be sent when they are bigger + than <code>digest_size_threshold</code>. + +<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. + +<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. + +<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> +</dd> +<dt><strong>_send_digest_now</strong></dt> +<dd>This is another action variable. Select <em>Yes</em>, 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> + +<p> +<br><hr><h4>Footnotes</h4> +<dl> +<dt><a name="foot182">... immediately</a><A + HREF="node19.html#tex2html7"><sup>5</sup></a></dt> +<dd>They'll also receive the message in the +digest. + +</dd> +</dl> +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.5 the Non-digest Options" + href="node18.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 the Privacy Options" + href="node20.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node18.html">2.5 The Non-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="node20.html">2.7 The Privacy Options</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node20.html b/doc/mailman-admin/node20.html new file mode 100644 index 00000000..5205808d --- /dev/null +++ b/doc/mailman-admin/node20.html @@ -0,0 +1,179 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 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 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> +<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="SECTION002270000000000000000"> +2.7 The Privacy Options Category</a> +</h2> + +<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. + +<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 + +<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: + +<p> + +<ul> +<li>Approved or Accepted - the message may be sent on to the + members of the mailing list. + +<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. + +<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. + +<p> +</li> +<li>Discard - the message is simply thrown away without further + processing. +</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. + +<p> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<a name="CHILD_LINKS"><strong>Subsections</strong></a> + +<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> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<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 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> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node21.html b/doc/mailman-admin/node21.html new file mode 100644 index 00000000..0db2153a --- /dev/null +++ b/doc/mailman-admin/node21.html @@ -0,0 +1,204 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 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 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> +<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--> + +<h3><a name="SECTION002271000000000000000"> +2.7.1 Subscription rules</a> +</h3> + +<p> +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> +<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> +</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>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>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>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>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> +</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> +</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> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<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 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> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node22.html b/doc/mailman-admin/node22.html new file mode 100644 index 00000000..62bbe43f --- /dev/null +++ b/doc/mailman-admin/node22.html @@ -0,0 +1,215 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node23.html" /> +<link rel="prev" href="node21.html" /> +<link rel="parent" href="node20.html" /> +<link rel="next" href="node23.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.7.2 Sender 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 class='online-navigation'><a rel="prev" title="2.7.1 subscription rules" + href="node21.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.3 recipient Filters" + href="node23.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node21.html">2.7.1 Subscription rules</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="node23.html">2.7.3 Recipient Filters</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002272000000000000000"> +2.7.2 Sender 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. + +<p> +<dl> +<dt><strong>default_member_moderation</strong></dt> +<dd>Member postings are held for moderation if their <em>moderation + flag</em> 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 <em>Reject</em>, 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 <em>Hold</em> 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 + <em>Reject</em> or <em>Discard</em>. + +<p> +Note that when a moderated member posts to your list, and the + <code>member_moderation_action</code> is set to <em>Hold</em>, 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. + +<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 <em>Reject</em>, 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. + +<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 <em>Hold</em>, 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. + +<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 <em>Discard</em>, you can choose + whether such messages are forwarded to the lsit administrators or + not. +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.7.1 subscription rules" + href="node21.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.3 recipient Filters" + href="node23.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node21.html">2.7.1 Subscription rules</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="node23.html">2.7.3 Recipient Filters</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node23.html b/doc/mailman-admin/node23.html new file mode 100644 index 00000000..eb6ab6c1 --- /dev/null +++ b/doc/mailman-admin/node23.html @@ -0,0 +1,133 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<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 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 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> +<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="SECTION002273000000000000000"> +2.7.3 Recipient Filters</a> +</h3> + +<p> +The variables in this section control various filters based on the +recipient of the message. + +<p> +<dl> +<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> +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>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>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"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<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 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> +<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 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node24.html b/doc/mailman-admin/node24.html new file mode 100644 index 00000000..49951ddf --- /dev/null +++ b/doc/mailman-admin/node24.html @@ -0,0 +1,131 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="prev" href="node23.html" /> +<link rel="parent" href="node20.html" /> +<link rel="next" href="node25.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.7.4 Spam 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 class='online-navigation'><a rel="prev" title="2.7.3 recipient Filters" + href="node23.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.8 the Bounce Processing" + href="node25.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node23.html">2.7.3 Recipient 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="node25.html">2.8 The Bounce Processing</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h3><a name="SECTION002274000000000000000"> +2.7.4 Spam Filters</a> +</h3> + +<p> +This section provides some adjuncts to spam fighting tools; it +doesn't replace dedicated anti-spam tools such as SpamAssassin or +Spambayes. + +<p> +<dl> +<dt><strong>bounce_matching_headers</strong></dt> +<dd>This variable contains header regular expressions, one per line, + and if any of a message's headers matches one of these patterns, + it will be held for moderation. The format is a colon separated + header and value, where the header is case insensitive and the + value is any valid Python regular expression. Lines that start + with # are ignored. + +<p> +This variable can be used to catch known spammers by writing + regexps that match against <span class="mailheader">To:</span> or <span class="mailheader">Cc:</span> + lines, or known-bad <span class="mailheader">Message-ID:</span>s. Perhaps more useful + though are patterns that match headers added by spam detection + tools higher up in the tool chain. For example, you might + configure SpamAssassin to add an <span class="mailheader">X-Spam-Score:</span> header + with between zero and 5 stars depending on the spam score. Then + you can add a line to this variable like: + +<p> +<div class="verbatim"><pre> + X-Spam-Score: [*]{3,5} +</pre></div> + +<p> +This line will match from 3 to 5 stars in the value of this + field. +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.7.3 recipient Filters" + href="node23.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.8 the Bounce Processing" + href="node25.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node23.html">2.7.3 Recipient 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="node25.html">2.8 The Bounce Processing</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node25.html b/doc/mailman-admin/node25.html new file mode 100644 index 00000000..48a42e3a --- /dev/null +++ b/doc/mailman-admin/node25.html @@ -0,0 +1,196 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node26.html" /> +<link rel="prev" href="node20.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node26.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.8 The Bounce Processing 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 class='online-navigation'><a rel="prev" title="2.7.4 spam Filters" + href="node24.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.9 the Archiving Options" + href="node26.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node24.html">2.7.4 Spam Filters</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="node26.html">2.9 The Archiving Options</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002280000000000000000"> +2.8 The Bounce Processing Category</a> +</h2> + +<p> +These policies control the automatic bounce processing system in +Mailman. Here's an overview of how it works: + +<p> +When a bounce is received, Mailman tries to extract two pieces of +information from the message: the address of the member the message +was intended for, and the severity of the problem causing the bounce. +The severity can be either <em>hard</em> for fatal errors, or +<em>soft</em> for transient errors. When in doubt, a hard severity is +used. + +<p> +If no member address can be extracted from the bounce, then the bounce +message is usually discarded. Every member has a <em>bounce score</em>, +initialized at zero, and every time we encounter a bounce from a +member we increment that member's score. Hard bounces increment by 1 +while soft bounces increment by 0.5. We only increment the bounce +score once per day, so even if we receive ten hard bounces from a +member per day, their score will increase by only 1 for that day. + +<p> +When a member's bounce score is greater than the <em>bounce score +threshold</em> (see below), the member's subscription is disabled. Once +disabled, the member will not receive any postings from the list until +their membership is explicitly re-enabled, either by the list +administrator or the user. However, they will receive occasional +reminders that their membership has been disabled, and these reminders +will include information about how to re-enable their membership. You +can control both the number of reminders the member will receive and +the frequency with which these reminders are sent. + +<p> +There is one other important configuration variable; after a certain +period of time - during which no bounces from the member are received +- the bounce information is considered stale and discarded. Thus by +adjusting this value, and the score threshold, you can control how +quickly bouncing members are disabled. You should tune both of these +to the frequency and traffic volume of your list. + +<p> +<dl> +<dt><strong>bounce_processing</strong></dt> +<dd>Specifies whether or not this list should do automatic bounce + processing. + +<p> +</dd> +<dt><strong>bounce_score_threshold</strong></dt> +<dd>This is the bounce score above which a member's subscription will + be automatically disabled. When the subscription is re-enabled, + their bounce score will be reset to zero. This value can be a + floating point number. + +<p> +</dd> +<dt><strong>bounce_info_stale_after</strong></dt> +<dd>Thenumber of days after which a member's bounce information is + considered stale. If no new bounces have been received in the + interrim, the bounce score is reset to zero. This value must be + an integer. + +<p> +</dd> +<dt><strong>bounce_you_are_disabled_warnings</strong></dt> +<dd>The number of notices a disabled member will receive before their + address is removed from the mailing list's roster. Set this to 0 + to immediately remove an address from the list once their bounce + score exceeds the threshold. This value must be an integer. + +<p> +</dd> +<dt><strong>bounce_you_are_disabled_warnings_interval</strong></dt> +<dd>The number of days between each disabled notification. + +<p> +</dd> +<dt><strong>bounce_unrecognized_goes_to_list_owner</strong></dt> +<dd>This variable controls whether unrecognized bounces are discarded, + or forwarded on the list administrator. The bounce detector isn't + perfect, although personalization can make it much more accurate. + The list owner may want to receive unrecognized bounces so that + they can manually disable or remove such members. + +<p> +</dd> +<dt><strong>bounce_notify_owner_on_disable</strong></dt> +<dd>This option controls whether or not the list owner is notified + when a member's subscription is automatically disabled due to + their bounce threshold being reached. + +<p> +</dd> +<dt><strong>bounce_notify_owner_on_removal</strong></dt> +<dd>This option controls whether or not the list owner is notified + when a member is removed from the list after their disabled + notifications have been exhausted. +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.7.4 spam Filters" + href="node24.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.9 the Archiving Options" + href="node26.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node24.html">2.7.4 Spam Filters</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="node26.html">2.9 The Archiving Options</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node26.html b/doc/mailman-admin/node26.html new file mode 100644 index 00000000..1cb22484 --- /dev/null +++ b/doc/mailman-admin/node26.html @@ -0,0 +1,137 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node27.html" /> +<link rel="prev" href="node25.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node27.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.9 The Archiving 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 class='online-navigation'><a rel="prev" title="2.8 the Bounce Processing" + href="node25.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.10 the Mail/News Gateway" + href="node27.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node25.html">2.8 The Bounce Processing</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="node27.html">2.10 The Mail/News Gateway</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002290000000000000000"> +2.9 The Archiving Options Category</a> +</h2> + +<p> +Mailman comes with a built-in web-based archiver called +<em>Pipermail</em>, although it can be configured to use external, +third party archivers. + +<p> +<dl> +<dt><strong>archive</strong></dt> +<dd>This option tells Mailman whether to archive messages it receives + or not, regardless of whether Pipermail or a third party archiver + is used. Turn this off if you don't want to archive messages. + +<p> +Note that senders can control whether their own posts are + archived, on an individual per-message basis. If the posted + message has a <span class="mailheader">X-No-Archive:</span> header (regardless of + value), or a <span class="mailheader">X-Archive:</span> header with a value of + <code>No</code> (case insensitive), then the message will not be + archived, although it will be treated as normal in all other + ways. + +<p> +</dd> +<dt><strong>archive_private</strong></dt> +<dd>Controls whether Pipermail archives are private or public. + Private archives require a valid member address and password, or a + list administrator password in order to access them. This + option has no effect when a third party archiver is used. + +<p> +</dd> +<dt><strong>archive_volume_frequency</strong></dt> +<dd>Controls how Pipermail splits messages in the archive. The most + common option is <em>Monthly</em> meaning a new archive volume is + started every month. Very high volume lists may want a shorter + frequency (e.g. <em>Weekly</em> or <em>Daily</em>) where as lower + volume lists may want a longer frequency (e.g. <em>Yearly</em>). + This option has no effect when a third party archiver is used. +</dd> +</dl> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.8 the Bounce Processing" + href="node25.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.10 the Mail/News Gateway" + href="node27.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node25.html">2.8 The Bounce Processing</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="node27.html">2.10 The Mail/News Gateway</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node27.html b/doc/mailman-admin/node27.html new file mode 100644 index 00000000..6388de8e --- /dev/null +++ b/doc/mailman-admin/node27.html @@ -0,0 +1,101 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node28.html" /> +<link rel="prev" href="node26.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node28.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.10 The Mail/News Gateway 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 class='online-navigation'><a rel="prev" title="2.9 the Archiving Options" + href="node26.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.11 the Auto-responder Category" + href="node28.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node26.html">2.9 The Archiving 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="node28.html">2.11 The Auto-responder Category</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION0022100000000000000000"> +2.10 The Mail/News Gateway Category</a> +</h2> + +<p> +Mailman has a sophisticated mail-to-news gateway feature. It can +independently gate messages from news to mail and vice versa, and can +even be used to manage moderated newsgroups. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.9 the Archiving Options" + href="node26.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.11 the Auto-responder Category" + href="node28.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node26.html">2.9 The Archiving 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="node28.html">2.11 The Auto-responder Category</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node28.html b/doc/mailman-admin/node28.html new file mode 100644 index 00000000..1b6bce1e --- /dev/null +++ b/doc/mailman-admin/node28.html @@ -0,0 +1,94 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node29.html" /> +<link rel="prev" href="node27.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node29.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.11 The Auto-responder 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 class='online-navigation'><a rel="prev" title="2.10 the Mail/News Gateway" + href="node27.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.12 the Content Filtering" + href="node29.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node27.html">2.10 The Mail/News Gateway</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="node29.html">2.12 The Content Filtering</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION0022110000000000000000"> +2.11 The Auto-responder Category</a> +</h2> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.10 the Mail/News Gateway" + href="node27.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.12 the Content Filtering" + href="node29.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node27.html">2.10 The Mail/News Gateway</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="node29.html">2.12 The Content Filtering</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node29.html b/doc/mailman-admin/node29.html new file mode 100644 index 00000000..7fecbdf0 --- /dev/null +++ b/doc/mailman-admin/node29.html @@ -0,0 +1,94 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node30.html" /> +<link rel="prev" href="node28.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node30.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.12 The Content Filtering 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 class='online-navigation'><a rel="prev" title="2.11 the Auto-responder Category" + href="node28.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.13 the Topics Category" + href="node30.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node28.html">2.11 The Auto-responder Category</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="node30.html">2.13 The Topics Category</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION0022120000000000000000"> +2.12 The Content Filtering Category</a> +</h2> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.11 the Auto-responder Category" + href="node28.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.13 the Topics Category" + href="node30.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node28.html">2.11 The Auto-responder Category</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="node30.html">2.13 The Topics Category</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node3.html b/doc/mailman-admin/node3.html new file mode 100644 index 00000000..e813a33f --- /dev/null +++ b/doc/mailman-admin/node3.html @@ -0,0 +1,129 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node8.html" /> +<link rel="prev" href="contents.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="node4.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>1 Introduction to GNU Mailman</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 class='online-navigation'><a rel="prev" title="Contents" + href="contents.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="1.1 a List's Email" + href="node4.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="contents.html">Contents</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node4.html">1.1 A List's Email</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002100000000000000000"> +1 Introduction to GNU Mailman</a> +</h1> + +<p> +GNU Mailman is software that lets you manage electronic mailing lists. +It supports a wide range of mailing list types, such as general +discussion lists and announce-only lists. Mailman has extensive +features for controlling the privacy of your lists, distributing your +list as personalized postings or digests, gatewaying postings to and +from Usenet, and providing automatic bounce detection. Mailman +provides a built-in archiver, multiple natural languages, as well as +advanced content and topic filtering. + +<p> +Mailman provides several interfaces to its functionality. Most list +administrators will primarily use the web interface to customize their +lists. There is also a limited email command interface to the +administrative functions, as well as a command line interface if you +have shell access on the Mailman server. This document does not cover +the command line interface; see the GNU Mailman site administrator's +manual for more details. + +<p> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<a name="CHILD_LINKS"><strong>Subsections</strong></a> + +<ul class="ChildLinks"> +<li><a href="node4.html">1.1 A List's Email Addresses</a> +<li><a href="node5.html">1.2 Administrative Roles</a> +<li><a href="node6.html">1.3 A List's Web Pages</a> +<li><a href="node7.html">1.4 Basic Architectural Overview</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="Contents" + href="contents.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="1.1 a List's Email" + href="node4.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="contents.html">Contents</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node4.html">1.1 A List's Email</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node30.html b/doc/mailman-admin/node30.html new file mode 100644 index 00000000..07c65bb5 --- /dev/null +++ b/doc/mailman-admin/node30.html @@ -0,0 +1,95 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="prev" href="node29.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node31.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.13 The Topics 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 class='online-navigation'><a rel="prev" title="2.12 the Content Filtering" + href="node29.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="3 membership Management" + href="node31.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node29.html">2.12 The Content Filtering</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="node31.html">3 Membership Management</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION0022130000000000000000"> +2.13 The Topics Category</a> +</h2> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.12 the Content Filtering" + href="node29.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="3 membership Management" + href="node31.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node29.html">2.12 The Content Filtering</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="node31.html">3 Membership Management</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node31.html b/doc/mailman-admin/node31.html new file mode 100644 index 00000000..52d177a2 --- /dev/null +++ b/doc/mailman-admin/node31.html @@ -0,0 +1,94 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node32.html" /> +<link rel="prev" href="node8.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="node32.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>3 Membership Management</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 class='online-navigation'><a rel="prev" title="2.13 the Topics Category" + href="node30.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="4 tending to Pending" + href="node32.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node30.html">2.13 The Topics Category</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node32.html">4 Tending to Pending</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002300000000000000000"> +3 Membership Management</a> +</h1> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2.13 the Topics Category" + href="node30.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="4 tending to Pending" + href="node32.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node30.html">2.13 The Topics Category</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node32.html">4 Tending to Pending</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node32.html b/doc/mailman-admin/node32.html new file mode 100644 index 00000000..27f20051 --- /dev/null +++ b/doc/mailman-admin/node32.html @@ -0,0 +1,94 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node33.html" /> +<link rel="prev" href="node31.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="node33.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>4 Tending to Pending Moderator Requests</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 class='online-navigation'><a rel="prev" title="3 membership Management" + href="node31.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="5 editing the Public" + href="node33.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node31.html">3 Membership Management</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node33.html">5 Editing the Public</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002400000000000000000"> +4 Tending to Pending Moderator Requests</a> +</h1> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="3 membership Management" + href="node31.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="5 editing the Public" + href="node33.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node31.html">3 Membership Management</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node33.html">5 Editing the Public</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node33.html b/doc/mailman-admin/node33.html new file mode 100644 index 00000000..335cb405 --- /dev/null +++ b/doc/mailman-admin/node33.html @@ -0,0 +1,94 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node34.html" /> +<link rel="prev" href="node32.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="node34.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>5 Editing the Public HTML Pages</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 class='online-navigation'><a rel="prev" title="4 tending to Pending" + href="node32.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="6 deleting the Mailing" + href="node34.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node32.html">4 Tending to Pending</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node34.html">6 Deleting the Mailing</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002500000000000000000"> +5 Editing the Public HTML Pages</a> +</h1> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="4 tending to Pending" + href="node32.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="6 deleting the Mailing" + href="node34.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node32.html">4 Tending to Pending</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node34.html">6 Deleting the Mailing</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node34.html b/doc/mailman-admin/node34.html new file mode 100644 index 00000000..fe7aec18 --- /dev/null +++ b/doc/mailman-admin/node34.html @@ -0,0 +1,98 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node35.html" /> +<link rel="prev" href="node33.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="node35.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>6 Deleting the Mailing List</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 class='online-navigation'><a rel="prev" title="5 editing the Public" + href="node33.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="1 this is an" + href="node35.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node33.html">5 Editing the Public</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node35.html">1 This is an</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002600000000000000000"> +6 Deleting the Mailing List</a> +</h1> + +<p> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="5 editing the Public" + href="node33.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="1 this is an" + href="node35.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node33.html">5 Editing the Public</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node35.html">1 This is an</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node35.html b/doc/mailman-admin/node35.html new file mode 100644 index 00000000..0d64431c --- /dev/null +++ b/doc/mailman-admin/node35.html @@ -0,0 +1,113 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="prev" href="node34.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="about.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>1 This is an Appendix</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 class='online-navigation'><a rel="prev" title="6 deleting the Mailing" + href="node34.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="About this document ..." + href="about.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node34.html">6 Deleting the Mailing</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="about.html">About this document ...</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002700000000000000000"> +1 This is an Appendix</a> +</h1> + +<p> +To create an appendix in a Python HOWTO document, use markup like +this: + +<p> +<div class="verbatim"><pre> +\appendix + +\section{This is an Appendix} + +To create an appendix in a Python HOWTO document, .... + + +\section{This is another} + +Just add another \section{}, but don't say \appendix again. +</pre></div> + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="6 deleting the Mailing" + href="node34.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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="About this document ..." + href="about.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node34.html">6 Deleting the Mailing</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="about.html">About this document ...</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node4.html b/doc/mailman-admin/node4.html new file mode 100644 index 00000000..538cd6b8 --- /dev/null +++ b/doc/mailman-admin/node4.html @@ -0,0 +1,160 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node5.html" /> +<link rel="prev" href="node3.html" /> +<link rel="parent" href="node3.html" /> +<link rel="next" href="node5.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>1.1 A List's Email Addresses</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 class='online-navigation'><a rel="prev" title="1 introduction to GNU" + href="node3.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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="1.2 administrative Roles" + href="node5.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node5.html">1.2 Administrative Roles</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002110000000000000000"> +1.1 A List's Email Addresses</a> +</h2> + +<p> +Every mailing list has a set of email addresses that messages can be +sent to. There's always one address for posting messages to the list, +one address that bounces will be sent to, and addresses for processing +email commands. For example, for a mailing list called +<var>mylist@example.com</var>, you'd find these addresses: + +<p> + +<ul> +<li>mylist@example.com - this is the email address people should + use for new postings to the list. + +<p> +</li> +<li>mylist-join@example.com - by sending a message to this address, + a new member can request subscription to the list. Both the + <span class="mailheader">Subject:</span> header and body of such a message are + ignored. Note that mylist-subscribe@example.com is an alias for + the -join address. + +<p> +</li> +<li>mylist-leave@example.com - by sending a message to this address, + a member can request unsubscription from the list. As with the + -join address, the <span class="mailheader">Subject:</span> header and body of the + message is ignored. Note that mylist-unsubscribe@example.com is + an alias for the -leave address. + +<p> +</li> +<li>mylist-owner@example.com - This address reaches the list owner + and list moderators directly. + +<p> +</li> +<li>mylist-request@example.com - This address reaches a mail robot + which processes email commands that can be used to set member + subscription options, as well as process other commands. + +<p> +</li> +<li>mylist-bounces@example.com - This address receives bounces from + members who's addresses have become either temporarily or + permanently inactive. The -bounces address is also a mail robot + that processes bounces and automatically disables or removes + members as configured in the bounce processing settings. Any + bounce messages that are either unrecognized, or do not seem to + contain member addresses, are forwarded to the list + administrators. + +<p> +</li> +<li>mylist-confirm@example.com - This address is another email + robot, which processes confirmation messages for subscription + and unsubscription requests. +</li> +</ul> + +<p> +There's also an -admin address which also reaches the list +administrators, but this address only exists for compatibility with +older versions of Mailman. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1 introduction to GNU" + href="node3.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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="1.2 administrative Roles" + href="node5.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node5.html">1.2 Administrative Roles</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node5.html b/doc/mailman-admin/node5.html new file mode 100644 index 00000000..489d4a23 --- /dev/null +++ b/doc/mailman-admin/node5.html @@ -0,0 +1,126 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node6.html" /> +<link rel="prev" href="node4.html" /> +<link rel="parent" href="node3.html" /> +<link rel="next" href="node6.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>1.2 Administrative Roles</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 class='online-navigation'><a rel="prev" title="1.1 a List's Email" + href="node4.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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="1.3 a List's Web" + href="node6.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node4.html">1.1 A List's Email</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node6.html">1.3 A List's Web</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002120000000000000000"> +1.2 Administrative Roles</a> +</h2> + +<p> +There are two primary administrative roles for each mailing list, a +list owner and a list moderator. A list owner is allowed to change +various settings of the list, such as the privacy and archiving +policies, the content filtering settings, etc. The list owner is also +allowed to subscribe or invite members, unsubscribe members, and +change any member's subscription options. + +<p> +The list moderator on the other hand, is only allowed to approve or +reject postings and subscription requests. The list moderator can +also do things like clear a member's moderation flag, or add an +address to a list of approved non-member posters. + +<p> +Normally, the list owner and list moderator are the same person. In +fact, the list owner can always do all the tasks a list moderator can +do. Access to both the owner's configuration pages, and the +moderation pages are protected by the same password. However, if the +list owner wants to delegate posting and subscription approval +authority to other people, a separate list moderator password can be +set, giving moderators access to the approval pages, but not the +configuration pages. In this setup, list owners can still moderate +the list, of course. + +<p> +In the sections that follow, we'll often use the terms list owner and +list administrator interchangably, meaning both roles. When +necessary, we'll distinguish the list moderator explicitly. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1.1 a List's Email" + href="node4.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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="1.3 a List's Web" + href="node6.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node4.html">1.1 A List's Email</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node6.html">1.3 A List's Web</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node6.html b/doc/mailman-admin/node6.html new file mode 100644 index 00000000..eca800af --- /dev/null +++ b/doc/mailman-admin/node6.html @@ -0,0 +1,135 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node7.html" /> +<link rel="prev" href="node5.html" /> +<link rel="parent" href="node3.html" /> +<link rel="next" href="node7.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>1.3 A List's Web Pages</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 class='online-navigation'><a rel="prev" title="1.2 administrative Roles" + href="node5.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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="1.4 basic Architectural Overview" + href="node7.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node5.html">1.2 Administrative Roles</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node7.html">1.4 Basic Architectural Overview</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002130000000000000000"> +1.3 A List's Web Pages</a> +</h2> + +<p> +Every mailing list is also accessible by a number of web pages. Note +that the exact urls is configurable by the site administrator, so they +may be different than what's described below. We'll describe the most +common default configuration, but check with your site administrator +or hosting service for details. + +<p> +Mailman provides a set of web pages that list members use to get +information about the list, or manage their membership options. There +are also list archive pages, for browsing an online web-based archive +of the list traffic. These are described in more detail in the GNU +Mailman user's manual. + +<p> +Mailman also provides a set of pages for configuring an individual +list, as well as a set of pages for disposing of posting and +subscription requests. + +<p> +For a mailing list called <var>mylist</var> hosted at the domain +<var>lists.example.com</var>, you would typically access the administrative +pages by going to <code>http://lists.example.com/mailman/admin/mylist</code>. +The first time you visit this page, you will be presented with a login +page, asking for the list owner's password. When you enter the +password, Mailman will store a session cookie in your browser, so you +don't have to re-authenticate for every action you want to take. This +cookie is stored only until you exit your browser. + +<p> +To access the administrative requests page, you'd visit +<code>http://lists.example.com/mailman/admindb/mylist</code> (note the +<em>admindb</em> url as opposed to the <em>admin</em> url). Again, the +first time you visit this page, you'll be presented with a login page, +on which you can enter either the list moderator password or the list +owner password. Again, a session cookie is dropped in your browser. +Note also that if you've previously logged in as the list owner, you +do not need to re-login to access the administrative requests page. + +<p> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1.2 administrative Roles" + href="node5.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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="1.4 basic Architectural Overview" + href="node7.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node5.html">1.2 Administrative Roles</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node7.html">1.4 Basic Architectural Overview</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node7.html b/doc/mailman-admin/node7.html new file mode 100644 index 00000000..8f41bc68 --- /dev/null +++ b/doc/mailman-admin/node7.html @@ -0,0 +1,147 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="prev" href="node6.html" /> +<link rel="parent" href="node3.html" /> +<link rel="next" href="node8.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>1.4 Basic Architectural Overview</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 class='online-navigation'><a rel="prev" title="1.3 a List's Web" + href="node6.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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 the List Configuration" + href="node8.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node6.html">1.3 A List's Web</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node8.html">2 The List Configuration</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002140000000000000000"> +1.4 Basic Architectural Overview</a> +</h2> + +<p> +This section will outline the basic architecture of GNU Mailman, such +as how messages are processed by the sytem. Without going into lots +of detail, this information will help you understand how the +configuration options control Mailman's functionality. + +<p> +When mail enters the system from your mail server, it is dropped into +one of several Mailman <em>queues</em> depending on the address the +message was sent to. For example, if your system has a mailing list +named <var>mylist</var> and your domain is <var>example.com</var>, people can +post messages to your list by sending them to +<var>mylist@example.com</var>. These messages will be dropped into the +<em>incoming</em> queue, which is also colloquially called the +<em>moderate-and-munge</em> queue. The incoming queue is where most of +the approval process occurs, and it's also where the message is +prepared for sending out to the list membership. + +<p> +There are separate queues for the built-in archiver, the bounce +processor, the email command processor, as well as the outgoing email +and news queues. There's also a queue for messages generated by the +Mailman system. Each of these queues typically has one <em>queue +runner</em> (or ``qrunner'') that processes messages in the queue. The +qrunners are idle when there are no messages to process. + +<p> +Every message in the queues are represented by two files, a message +file and a metadata file. Both of these files share the same base +name, which is a combination of a unique hash and the Unix time that +the message was received. The metadata file has a suffix of +<span class="file">.db</span> and the message file has a suffix of either <span class="file">.msg</span> if +stored in plain text, or <span class="file">.pck</span> if stored in a more efficient +internal representation<a name="tex2html1" + href="#foot39"><sup>1</sup></a>. + +<p> +As a message moves through the incoming queue, it performs various +checks on the message, such as whether it matches one of the +moderation criteria, or contains disallowed MIME types. Once a +message is approved for sending to the list membership, the message is +prepared for sending by deleting, adding, or changing message headers, +adding footers, etc. Messages in the incoming queue may also be +stored for appending to digests. + +<p> +<br><hr><h4>Footnotes</h4> +<dl> +<dt><a name="foot39">... representation</a><A + HREF="node7.html#tex2html1"><sup>1</sup></a></dt> +<dd>Specifically, a Python pickle + +</dd> +</dl> +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1.3 a List's Web" + href="node6.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="1 introduction to GNU" + href="node3.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 the List Configuration" + href="node8.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node6.html">1.3 A List's Web</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="node3.html">1 Introduction to GNU</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node8.html">2 The List Configuration</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node8.html b/doc/mailman-admin/node8.html new file mode 100644 index 00000000..3a7fc7c8 --- /dev/null +++ b/doc/mailman-admin/node8.html @@ -0,0 +1,177 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node31.html" /> +<link rel="prev" href="node3.html" /> +<link rel="parent" href="contents.html" /> +<link rel="next" href="node9.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2 The List Configuration Pages</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 class='online-navigation'><a rel="prev" title="1.4 basic Architectural Overview" + href="node7.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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.1 the General Options" + href="node9.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node7.html">1.4 Basic Architectural Overview</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node9.html">2.1 The General Options</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h1><a name="SECTION002200000000000000000"> +2 The List Configuration Pages</a> +</h1> + +<p> +After logging into the list configuration pages, you'll see the +configuration options for the list, grouped in categories. All the +administrative pages have some common elements. In the upper section, +you'll see two columns labeled ``Configuration Categories''. Some +categories have sub-categories which are only visible when you click +on the category link. The first page you see after logging in will be +the ``General Options'' category. The specific option settings for +each category are described below. + +<p> +On the right side of the top section, you'll see a column labeled +``Other Administrative Activities''. Here you'll find some other +things you can do to your list, as well as convenient links to the +list information page and the list archives. Note the big ``Logout'' +link; use this if you're finished configuring your list and don't want +to leave the session cookie active in your browser. + +<p> +Below this common header, you'll find a list of this category's +configuration variables, arranged in two columns. In the left column +is a brief description of the option, which also contains a +``details'' link. For many of the variables, more details are +available describing the semantics of the various available settings, +or information on the interaction between this setting and other list +options. Clicking on the details link brings up a page which contains +only the information for that option, as well as a button for +submitting your setting, and a link back to the category page. + +<p> +On the right side of the two-column section, you'll see the variable's +current value. Some variables may present a limited set of values, +via radio button or check box arrays. Other variables may present +text entry boxes of one or multiple lines. Most variables control +settings for the operation of the list, but others perform immediate +actions (these are clearly labeled). + +<p> +At the bottom of the page, you'll find a ``Submit'' button and a +footer with some more useful links and a few logos. Hitting the +submit button commits your list settings, after they've been +validated. Any invalid values will be ignored and an error message +will be displayed at the top of the resulting page. The results page +will always be the category page that you submitted. + +<p> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<a name="CHILD_LINKS"><strong>Subsections</strong></a> + +<ul class="ChildLinks"> +<li><a href="node9.html">2.1 The General Options Category</a> +<ul> +<li><a href="node10.html">2.1.1 General list personality</a> +<li><a href="node11.html">2.1.2 Reply-To header munging</a> +<li><a href="node12.html">2.1.3 Umbrella list settings</a> +<li><a href="node13.html">2.1.4 Notifications</a> +<li><a href="node14.html">2.1.5 Additional settings</a> +</ul> +<li><a href="node15.html">2.2 The Passwords Category</a> +<li><a href="node16.html">2.3 The Language Options Category</a> +<li><a href="node17.html">2.4 The Membership Management Category</a> +<li><a href="node18.html">2.5 The Non-digest Options Category</a> +<li><a href="node19.html">2.6 The Digest Options Category</a> +<li><a href="node20.html">2.7 The Privacy Options Category</a> +<ul> +<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> +<li><a href="node25.html">2.8 The Bounce Processing Category</a> +<li><a href="node26.html">2.9 The Archiving Options Category</a> +<li><a href="node27.html">2.10 The Mail/News Gateway Category</a> +<li><a href="node28.html">2.11 The Auto-responder Category</a> +<li><a href="node29.html">2.12 The Content Filtering Category</a> +<li><a href="node30.html">2.13 The Topics Category</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="1.4 basic Architectural Overview" + href="node7.html"><img src='previous.png' + border='0' height='32' alt='Previous Page' width='32' /></a></td> +<td class='online-navigation'><a rel="parent" title="Contents" + href="contents.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.1 the General Options" + href="node9.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node7.html">1.4 Basic Architectural Overview</a> +<b class="navlabel">Up:</b> +<a class="sectref" rel="parent" href="contents.html">Contents</a> +<b class="navlabel">Next:</b> +<a class="sectref" rel="next" href="node9.html">2.1 The General Options</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/node9.html b/doc/mailman-admin/node9.html new file mode 100644 index 00000000..6203bde9 --- /dev/null +++ b/doc/mailman-admin/node9.html @@ -0,0 +1,117 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<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="node15.html" /> +<link rel="prev" href="node8.html" /> +<link rel="parent" href="node8.html" /> +<link rel="next" href="node10.html" /> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> +<meta name='aesop' content='information' /> +<title>2.1 The General 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 class='online-navigation'><a rel="prev" title="2 the List Configuration" + href="node8.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.1.1 general list personality" + href="node10.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node8.html">2 The List Configuration</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="node10.html">2.1.1 General list personality</a> +</div> +<hr /></div> +</div> +<!--End of Navigation Panel--> + +<h2><a name="SECTION002210000000000000000"> +2.1 The General Options Category</a> +</h2> + +<p> +The General Options category is where you can set a variety of +variables that affect basic behavior and public information. In the +descriptions that follow, the variable name is given first, along with +an overview and a description of what that variable controls. + +<p> + +<p><br /></p><hr class='online-navigation' /> +<div class='online-navigation'> +<!--Table of Child-Links--> +<a name="CHILD_LINKS"><strong>Subsections</strong></a> + +<ul class="ChildLinks"> +<li><a href="node10.html">2.1.1 General list personality</a> +<li><a href="node11.html">2.1.2 Reply-To header munging</a> +<li><a href="node12.html">2.1.3 Umbrella list settings</a> +<li><a href="node13.html">2.1.4 Notifications</a> +<li><a href="node14.html">2.1.5 Additional settings</a> +</ul> +<!--End of Table of Child-Links--> +</div> + +<div class="navigation"> +<div class='online-navigation'> +<p></p><hr /> +<table align="center" width="100%" cellpadding="0" cellspacing="2"> +<tr> +<td class='online-navigation'><a rel="prev" title="2 the List Configuration" + href="node8.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.1.1 general list personality" + href="node10.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 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> +<div class='online-navigation'> +<b class="navlabel">Previous:</b> +<a class="sectref" rel="prev" href="node8.html">2 The List Configuration</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="node10.html">2.1.1 General list personality</a> +</div> +</div> +<hr /> +<span class="release-info">Release 2.1, documentation updated on December 5, 2007.</span> +</div> +<!--End of Navigation Panel--> + +</body> +</html> diff --git a/doc/mailman-admin/previous.png b/doc/mailman-admin/previous.png Binary files differnew file mode 100644 index 00000000..497def42 --- /dev/null +++ b/doc/mailman-admin/previous.png diff --git a/doc/mailman-admin/pyfav.png b/doc/mailman-admin/pyfav.png Binary files differnew file mode 100644 index 00000000..d2d8669d --- /dev/null +++ b/doc/mailman-admin/pyfav.png diff --git a/doc/mailman-admin/up.png b/doc/mailman-admin/up.png Binary files differnew file mode 100644 index 00000000..a90e0284 --- /dev/null +++ b/doc/mailman-admin/up.png |