<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>