<!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 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 13, 2004.</span>
</DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>