Mail::Digest::Tools 2.11

Mail::Digest::Tools is a Perl module that has tools for digest versions of mailing lists.

SYNOPSIS

use Mail::Digest::Tools qw(
process_new_digests
reprocess_ALL_digests
reply_to_digest_message
repair_message_order
consolidate_threads_multiple
consolidate_threads_single
delete_deletables
);
%config_in and %config_out are two configuration hashes whose setup is discussed in detail below.
process_new_digests(%config_in, %config_out);

reprocess_ALL_digests(%config_in, %config_out);

$full_reply_file = reply_to_digest_message(
%config_in,
%config_out,
$digest_number,
$digest_entry,
$directory_for_reply,
);

repair_message_order(
%config_in,
%config_out,
{
year => 2004,
month => 01,
day => 27,
}
);

consolidate_threads_multiple(
%config_in,
%config_out,
$first_common_letters, # optional integer argument; defaults to 20
);

consolidate_threads_single(
%config_in,
%config_out,
[
first_dummy_file_for_consolidation.thr.txt,
second_dummy_file_for_consolidation.thr.txt,
],
);

delete_deletables(%config_out);

Mail::Digest::Tools provides useful tools for processing mail which an individual receives in a daily digest version from a mailing list. Digest versions of mailing lists are provided by a variety of mail processing programs and by a variety of list hosts. Within the Perl community, digest versions of mailing lists are offered by such sponsors as Active State, Sourceforge, Yahoo! Groups and London.pm. However, you do not have to be interested in Perl to make use of Mail::Digest::Tools. Mail from any of the thousands of Yahoo! Groups, for example, may be processed with this module.

If, when you receive e-mail from the digest version of a mailing list, you simply read the digest in an e-mail client and then discard it, you may stop reading here. If, however, you wish to read or store such mail by subject, read on. As printed in a normal web browser, this document contains 40 pages of documentation. You are urged to print this documentation out and study it before using this module.

To understand how to use Mail::Digest::Tools, we will first take a look at a typical mailing list digest. We will then sketch how that digest looks once processed by Mail::Digest::Tool. We will then discuss Mail::Digest::Tools exportable functions. Next, we will study how to prepare the two configuration hashes which hold the configuration data. Finally, we will provide some tips for everyday use of Mail::Digest::Tools.