<!--
   $FML: chapter.sgml,v 1.5 2005/10/08 03:37:39 fukachan Exp $
   $jaFML: chapter.sgml,v 1.3 2003/04/15 14:51:39 fukachan Exp $
-->

<chapter id="digest">
	<title>
	Digest Delivery
	</title>

<para>
Run
<screen>
/usr/local/libexec/fml/digest $ml_name
</screen>
periodically for digest delivery. It aggregates articles into one
MIME/multipart message and send it to members defined by
$digest_recipient_maps.
</para>

<warning>
<para>
Digest delivery program is a simple version yet now.
</para>
</warning>


<sect1 id="digest.config.files">
	<title>
	Files Used For Digest Delivery Control
	</title>

<para>
This program uses the following files under $ml_home_dir.
<screen>
seq-digest
members-digest 
recipients-digest
</screen>
</para>

<para>
seq-digest holds the last sequence delivered as digest.
</para>

<para>
members-digest is dummy.
recipients-digest is a recipient list.
$digest_recipient_maps is this recipients-digest file only by default.
</para>

<para>
The argument of $digest_recipient_maps is IO::Adapter, 
so you can use mysql here.
</para>

</sect1>


<sect1 id="digest.command">
	<title>
	Idea: Digest Related Commands
	</title>


<!--
   XXX-TODO digest related commands
-->


<para>
Idea on digest commands (references: fml-devel:313).
</para>

<para>
Hmm, how about the further extension?
</para>


<sect2>
	<title>
	makefml command
	</title>

<para>
<screen>
makefml digest    $ml $address on
makefml digeston  $ml $address

makefml digest    $ml $address off
makefml digestoff $ml $address
</screen>
(These commands are implemented already).
</para>

<para>
</para>

</sect2>


<sect2>
	<title>
	admin command mail
	</title>

<para>
<screen>
admin digest $address on
admin digest $address off
</screen>
(These commands are implemented already).
</para>

</sect2>


<sect2>
	<title>
	user level command mail ?
	</title>

<para>
<screen>
digest on
digest off
</screen>
</para>

<para>
The confirmation is needed ? Yes, we should need it to unify the fml
fundamental design. We should restrict address manipulation functions
as could as possible.
</para>

</sect2>


<sect2>
	<title>
	CGI
	</title>

<para>
<screen>
digeston
digestoff
</screen>
ok?
</para>

</sect2>


</sect1>


<!-- recipies -->
<sect1 id="digest.recipes">
        <title> 
        recipes
        </title> 

	&sect.digest.recipes;
</sect1>


</chapter>
