aboutsummaryrefslogtreecommitdiffstats
path: root/admin/www/mailman-admin/node20.html
diff options
context:
space:
mode:
Diffstat (limited to 'admin/www/mailman-admin/node20.html')
-rw-r--r--admin/www/mailman-admin/node20.html219
1 files changed, 219 insertions, 0 deletions
diff --git a/admin/www/mailman-admin/node20.html b/admin/www/mailman-admin/node20.html
new file mode 100644
index 00000000..2a890daf
--- /dev/null
+++ b/admin/www/mailman-admin/node20.html
@@ -0,0 +1,219 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<title>3.6 The Digest Options Category</title>
+<META NAME="description" CONTENT="3.6 The Digest Options Category">
+<META NAME="keywords" CONTENT="mailman-admin">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<link rel="STYLESHEET" href="mailman-admin.css">
+<link rel="first" href="mailman-admin.html">
+<link rel="contents" href="contents.html" title="Contents">
+
+<LINK REL="next" HREF="node21.html">
+<LINK REL="previous" HREF="node19.html">
+<LINK REL="up" HREF="node9.html">
+<LINK REL="next" HREF="node21.html">
+</head>
+<body>
+<DIV CLASS="navigation">
+<table align="center" width="100%" cellpadding="0" cellspacing="2">
+<tr>
+<td><A HREF="node19.html"><img src="../icons/previous.gif"
+ border="0" height="32"
+ alt="Previous Page" width="32"></A></td>
+<td><A HREF="node9.html"><img src="../icons/up.gif"
+ border="0" height="32"
+ alt="Up One Level" width="32"></A></td>
+<td><A HREF="node21.html"><img src="../icons/next.gif"
+ border="0" height="32"
+ alt="Next Page" width="32"></A></td>
+<td align="center" width="100%">GNU Mailman - List Administration Manual</td>
+<td><A href="contents.html"><img src="../icons/contents.gif"
+ border="0" height="32"
+ alt="Contents" width="32"></A></td>
+<td><img src="../icons/blank.gif"
+ border="0" height="32"
+ alt="" width="32"></td>
+<td><img src="../icons/blank.gif"
+ border="0" height="32"
+ alt="" width="32"></td>
+</tr></table>
+<b class="navlabel">Previous:</b> <a class="sectref" HREF="node19.html">3.5 The Non-digest Options</A>
+<b class="navlabel">Up:</b> <a class="sectref" HREF="node9.html">3 The List Configuration</A>
+<b class="navlabel">Next:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
+<br><hr>
+</DIV>
+<!--End of Navigation Panel-->
+
+<H2><A NAME="SECTION002360000000000000000">
+3.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" name="rfcref-1093"
+href="http://www.faqs.org/rfcs/rfc1153.html">RFC 1153</a> digest standard. The retain some, but not
+all of the original messages, but can also include a summary and
+headers and footers.
+
+<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="#foot184"><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 <i>Regular</i> (non-digest) or <i>Digest</i>
+ delivery.
+
+<P>
+</DD>
+<DT><STRONG>mime_is_default_digest</STRONG></DT>
+<DD>If a member is allowed to choose digests, this variable controls
+ which is the default digest style they will receive. <i>Plain</i>
+ digests are <a class="rfc" name="rfcref-1095"
+href="http://www.faqs.org/rfcs/rfc1153.html">RFC 1153</a> format as described above.
+
+<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
+ <i>No</i>, 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 <i>Yes</i>, submit the
+ form, and the current digest is packaged up and sent to digest
+ members, regardless of size (well, there has to be at least one
+ message in the digest).
+</DD>
+</DL>
+
+<P>
+<BR><HR><H4>Footnotes</H4>
+<DL>
+<DT><A NAME="foot184">... immediately</A><A
+ HREF="node20.html#tex2html7"><SUP>5</SUP></A></DT>
+<DD>They'll also receive the message in the
+digest.
+
+</DD>
+</DL>
+<DIV CLASS="navigation">
+<p><hr>
+<table align="center" width="100%" cellpadding="0" cellspacing="2">
+<tr>
+<td><A HREF="node19.html"><img src="../icons/previous.gif"
+ border="0" height="32"
+ alt="Previous Page" width="32"></A></td>
+<td><A HREF="node9.html"><img src="../icons/up.gif"
+ border="0" height="32"
+ alt="Up One Level" width="32"></A></td>
+<td><A HREF="node21.html"><img src="../icons/next.gif"
+ border="0" height="32"
+ alt="Next Page" width="32"></A></td>
+<td align="center" width="100%">GNU Mailman - List Administration Manual</td>
+<td><A href="contents.html"><img src="../icons/contents.gif"
+ border="0" height="32"
+ alt="Contents" width="32"></A></td>
+<td><img src="../icons/blank.gif"
+ border="0" height="32"
+ alt="" width="32"></td>
+<td><img src="../icons/blank.gif"
+ border="0" height="32"
+ alt="" width="32"></td>
+</tr></table>
+<b class="navlabel">Previous:</b> <a class="sectref" HREF="node19.html">3.5 The Non-digest Options</A>
+<b class="navlabel">Up:</b> <a class="sectref" HREF="node9.html">3 The List Configuration</A>
+<b class="navlabel">Next:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
+<hr>
+<span class="release-info">Release 2.1, documentation updated on October 2, 2004.</span>
+</DIV>
+<!--End of Navigation Panel-->
+
+</BODY>
+</HTML>