<HTML> <HEAD> <TITLE>MHonArc Reference -- Introduction</TITLE> <link rel="stylesheet" type="text/css" href="docstyles.css"> </HEAD> <BODY> <!--X-NavButtons-Start--> <table width="100%"> <tr valign="top"> <td align="left"><nobr><img src="blank.png"border=0 alt="[Prev]"> </nobr></td><td align="center" width="99%"><a href="mhonarc.html"><img src="up.png" border=0 alt="[TOC]"></a><a href="faq/faq.html"><img src="faq.png" border=0 alt="[FAQ]"></a><a href="app-bugs.html"><img src="bug.png" border=0 alt="[Bugs]"></a><a href="http://www.mhonarc.org/"><img src="home.png" border=0 alt="[Home]"></a></td><td align="right"><nobr> <a href="relnotes.html"><img src="next.png" border=0 alt="[Next]"></a></nobr></td></tr></table> <!--X-NavButtons-End--> <HR> <H1><a name="intro">Introduction</a></H1> <!--X-TOC-Start--> <ul> <li><a href="#whatis">What is MHonArc?</a> <li><a href="#whyuse">Why Use MHonArc?</a> <li><a href="#availability">Availability</a> <li><a href="#license">License</a> <li><a href="#help">Where to Get Help?</a> <li><a href="#nomenclature">Documentation Nomenclature</a> </ul> <!--X-TOC-End--> <hr> <H2><a name="whatis">What is MHonArc?</a></H2> <p>MHonArc is a Perl program for converting mail or news messages into HTML archives. It can also be used to convert individual messages into HTML documents. Other capabilities include robust MIME support and powerful user customization features. </p> <hr> <H2><a name="whyuse">Why Use MHonArc?</a></H2> <P>Here are some reasons for using MHonArc: </P> <UL> <LI>You want to keep organized archives of mail or news articles for a <A HREF="http://www.w3.org/hypertext/WWW/TheProject.html">World Wide Web</A> (WWW) server; complete with live hypertext pointers to their authors and to any url's mentioned. <LI>You would like to control the layout of your archives to keep a consistent style to your WWW pages. <LI>You have MIME messages that you want to include in your archives. <LI>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. <LI>Multi-platform support: Unix, Windows, MacOS, etc. Basically, MHonArc should be usable on any platform that Perl has been ported to. <li>MHonArc is <a href="#license">free software</a>. <LI>You think the MHonArc logo is really cool, and it deserves to be used. <LI>You like Perl, and you want to see what it can do. <LI>Just cuz. </UL> <hr> <H2><a name="availability">Availability</a></H2> <P>The latest information about MHonArc, including its its availability, may be obtained at <A HREF="http://www.mhonarc.org/"><http://www.mhonarc.org/></A>. </P> <hr> <h2><a name="license">License</a></H2> <table class="tip" width="100%"><tr><td> <p><strong>MHonArc</strong> is free software; you can redistribute it and/or modify it under the terms of the <a href="COPYING">GNU General Public License</a> as published by the <a href="http://www.gnu.org/">Free Software Foundation</a>; either version 2 of the License, or (at your option) any later version. </p> <p>This program is distributed in the hope that it will be useful, but <b>WITHOUT ANY WARRANTY</b>; without even the implied warranty of <b>MERCHANTABILITY</b> or <b>FITNESS FOR A PARTICULAR PURPOSE</b>. See the <a href="COPYING">GNU General Public License</a> for more details. </p> </td></tr></table> <p> </p> <table class="caution" width="100%"> <tr valign="baseline"> <td><strong style="color: red;">WARNING:</strong></td> <td width="100%"><p>MHonArc is <strong>NOT</strong> in the public domain, applicable copyrights still apply. Using MHonArc that is inconsistent with the <a href="COPYING">licensing terms</a> is a <b>violation</b> of copyright law. </p> <p>If you cannot agree with the <a href="COPYING">licensing terms</a> and would like to use <b>MHonArc</b> under a different license, contact <a href="mailto:mhonarc%40mhonarc.org">mhonarc<!-- -->@<!-- -->mhonarc.org</a>. </p> </td> </tr> </table> <!-- ====================================================================== --> <hr> <h2><a name="help">Where to Get Help?</a></h2> <ol> <li><p>Read <a href="mhonarc.html">this documentation</a>. </p></li> <li><p>Read the <a href="faq/faq.html">FAQ</a>. </p></li> <li><p>Subscribe and post to one of the mailing lists described in the <a href="contacts.html"><cite>Contacts</cite></a> section. <a href="http://www.mhonarc.org/archive/html">Searchable archives</a> of the lists exist which provides a historical collection of helpful information. </p> </ol> <p><a href="contacts.html#consulting">Professional consulting</a> is also available. Contact <a href="mailto:earl%40earlhood.com">earl<!-- -->@<!-- -->earlhood.com</a> with your request. </p> <!-- ====================================================================== --> <hr> <h2><a name="nomenclature">Documentation Nomenclature</a></h2> <table class="note" width="100%"> <tr valign="baseline"> <td><strong>NOTE:</strong></td> <td width="100%"><p>Some rendering style semantics may not be available if viewing this documentation with a text-based and/or a non-CSS capable browser. </p> </td> </tr> </table> <p>Shell examples are rendered as follows:</p> <table border=1 width="100%"><tr><td><pre class="shell"> prompt> <b>ls -CF</b> ACKNOWLG contrib/ etc/ INSTALL Makefile.PL mha-decode* TODO admin/ COPYING examples/ install.me* man/ mhonarc* BUGS dev.mk extras/ lib/ mha-dbedit* README CHANGES doc/ FILELIST logo/ mha-dbrecover* RELNOTES </pre></td></tr></table> <p>The text <tt class="ishell">prompt></tt> represents your shell prompt. Text you would type into the shell is rendered like this: <tt class="ishell"><b>text you enter</b></tt>. Any other text is example output generated by the computer. </p> <p>Code examples are rendered as follows:</p> <pre class="code"> <b><DefineVar></b> MY-FOOTER-LINK <hr> Please visit <a href="http://www.mhonarc.org">www.mhonarc.org</a>. <b></DefineVar></b> </pre> <hr> <!--X-NavButtons-Start--> <table width="100%"> <tr valign="top"> <td align="left"><nobr><img src="blank.png"border=0 alt="[Prev]"> </nobr></td><td align="center" width="99%"><a href="mhonarc.html"><img src="up.png" border=0 alt="[TOC]"></a><a href="faq/faq.html"><img src="faq.png" border=0 alt="[FAQ]"></a><a href="app-bugs.html"><img src="bug.png" border=0 alt="[Bugs]"></a><a href="http://www.mhonarc.org/"><img src="home.png" border=0 alt="[Home]"></a></td><td align="right"><nobr> <a href="relnotes.html"><img src="next.png" border=0 alt="[Next]"></a></nobr></td></tr></table> <!--X-NavButtons-End--> <!-- *************************************************************** --> <hr> <address> $Date: 2003/10/06 22:04:14 $ <br> <img align="top" src="monicon.png" alt=""> <a href="http://www.mhonarc.org/" ><strong>MHonArc</strong></a><br> Copyright © 1997-2002, <a href="http://www.mhonarc.org/~ehood/" >Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org" >mhonarc<!-- -->@<!-- -->mhonarc.org</a><br> </address> </BODY> </HTML>