Introduction

MHonArc is a Perl program for converting e-mail messages as specified in RFC 822 and RFC 1521 (MIME) to HTML. MHonArc can perform the following tasks:

• Convert mh(1) mail folders or UUCP/Unix style mailboxes into an HTML mail archive.
• Add or remove messages to an existing HTML mail archive generated by MHonArc.

• Convert a single message to HTML.

Along with these tasks, MHonArc provides the following:

• A main customizable index page for mail messages archived.
• A customizable thread index page listing messages by thread.
• Control over message formatting.
• The ability to hook in your own custom message filters.

Why Use MHonArc?

Here are some reasons for using MHonArc:

• You want to keep organized archives of mail messages and/or news articles for a World Wide Web (WWW) server; complete with live hypertext pointers to their authors and to any url's mentioned.
• You would like to control the layout of mail/news archives to keep a consistent style to your WWW pages.
• You have a WWW client, but no MIME mail reader. MHonArc will allow you to read MIME messages that includes images, audio, video, etc via your Web client.
• Muli-platform support: MS-DOS and Unix.
• You think the MHonArc logo is really cool, and it deserves to be used.
• You like Perl, and you want to see what it can do.
• Just cuz.

Supported Platforms

MHonArc (version 1.1, or later) will run under Unix or MS-DOS operating systems with Perl 4 or 5 installed.

Availability

The latest information on MHonArc, and its availability, may be obtained at <URL:http://www.oac.uci.edu/indiv/ehood/mhonarc.html>.

About the Documentation

The documentation is oriented towards Unix users. However, the section on Installation does conver MS-DOS installation instructions. Notes are made in the documentation when something may differ due to the operating system.