1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
<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>
|
