<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN"> <HTML> <HEAD> <TITLE>MHonArc v2.4 -- Quick Start</TITLE> </HEAD> <BODY background="ssbg75.jpg" text="#000000" link="#0000ee" vlink="#551a8b" alink="ff0000"> <!--X-NavButtons-Start--> <p align=center> <a href="install.html"><img src="prev.gif" border=0 alt="[Prev]"></a><a href="commontasks.html"><img src="next.gif" border=0 alt="[Next]"></a><a href="mhonarc.html"><img src="up.gif" border=0 alt="[TOC]"></a><a href="faq/faq.html"><img src="faq.gif" border=0 alt="[FAQ]"></a><a href="app-bugs.html"><img src="bug.gif" border=0 alt="[Bugs]"></a><a href="http://www.mhonarc.org/"><img src="home.gif" border=0 alt="[Home]"></a> </p> <!--X-NavButtons-End--> <HR> <H1><a name="quickstart">Quick Start</a></H1> <P>This section will give you a "<EM>quick start</EM>" on using MHonArc. </P> <!--X-TOC-Start--> <ul> <li><a href="#folders">Converting mail</a> <li><a href="#adding">Adding Messages to an Archive</a> <li><a href="#single">Converting a single message</a> </ul> <!--X-TOC-End--> <hr> <H2><a name="folders">Converting mail</a></H2> <P>Since MHonArc supports <EM>MH</EM> mail folders and UUCP/Unix mailbox files, the term "<EM>mail folder</EM>" will represent the <EM>MH</EM> mail folder or mailbox file you want to process. To convert your mail folder to an HTML archive, use the following: </P> <blockquote> <pre> shell> <b>mhonarc </b><VAR>path</VAR><b>/inbox</b> </pre> </blockquote> <P>Where <VAR>path</VAR> represents the path to the directory that contains the mail folder <EM>inbox</EM>. If you are in the directory that contains inbox, then you can leave out the "<VAR>path</VAR><tt>/</tt>". </P> <table border=0 cellpadding=4> <tr valign=top> <td><strong>NOTE</strong></td> <td>The "<b><tt>shell></tt></b>" represents your shell's prompt. </td> </tr> </table> <P>You may specify more than one mail folder to process on the command-line: </P> <blockquote> <pre> shell> <b>mhonarc </b><VAR>path</VAR><b>/inbox1</b> <VAR>path</VAR><b>/inbox2</b> ... </pre> </blockquote> <p>You may also specify standard input, "<b><tt>-</tt></b>", as the source of mail folder. This is useful if want to use MHonArc in a pipe: </p> <blockquote> <pre> shell> <b>mhonarc -- - </b><VAR>path</VAR><b>/inbox</b> </pre> </blockquote> <p>The "<b><tt>--</tt></b>" (two hyphens) is required to terminate command-line option parsing so "<b><tt>-</tt></b>" will not be treated as the start of an option. The example also illustrates that you can still specify regular mail folders with standard input. In this example, MHonArc will process standard input and then <tt><VAR>path</VAR>/inbox</tt>. </p> <P>When MHonArc finishes, the following files will be created: </P> <UL> <LI><P><tt><strong>maillist.html</strong></tt>: The main index file containing links to all mail messages converted. Messages are listed with subjects and who the messages are from. All messages are listed in sorted order by date received/sent. </P> <LI><P><tt><strong>threads.html</strong></tt>: The file listing messages by thread. </P> <LI><P><tt><strong>msg*.html</strong></tt>: HTML versions of the mail messages, where<CODE> * </CODE>represents a message number from 0 to the number of message processed minus 1. </P> <LI><P><tt><strong>.mhonarc.db</strong></tt> (or <tt>MHONARC.DB</tt> under Windows): This database file is needed inorder for MHonArc to perform additions of new mail messages to the archive. Information is stored to perform mail threading updates when new messages are added, as well as any defined <a href="resources.html">resources</a>. </P> <LI><P><EM>Other</EM>: Depending on the content-types of the e-mail messages converted, other files may be created for images, videos, binaries, etc. </P> </UL> <p>The actual filenames may differ depending on the settings of various <a href="resources.html">resources</a>. </p> <P>All the files created will be put into the current working directory, by default. You can control the destination of the output location by using the <a href="resources/outdir.html"><strong><tt>-outdir</tt></strong></a> option. </P> <DL> <DT><STRONG>Example</STRONG> <DD><PRE> shell> <b>mhonarc -outdir /home/ehood/htmlarchive /home/ehood/mail/inbox</b> </PRE> </DL> <P>Here is a sample session converting a mail folder: </P> <blockquote> <PRE> shell> <b>mhonarc ~/mail/inbox</b> Converting messages to . Reading /mnt/ehood/mail/inbox .......... Writing mail ... Writing ./maillist.html ... Writing ./threads.html ... Writing database ... 10 messages </PRE> </blockquote> <p>By default, MHonArc prints out information about its progress. This can be disabled with the <a href="resources/quiet.html"><strong><tt>-quiet</tt></strong></a> option. </p> <hr> <H2><a name="adding">Adding Messages to an Archive</a></H2> <P>If you have new messages you want to add to an existing archive, you must utilizing the <a href="resources/add.html"><strong><tt>-add</tt></strong></a> command-line option. With the <a href="resources/add.html"><strong><tt>-add</tt></strong></a>, you can do the following: </P> <UL> <LI><P>Add a mail folder to an archive, or </P> <LI><P>Add a single message to an archive. </P> </UL> <P>Adding a mail folder to an archive in the current working directory can be done like the following: </P> <blockquote> <PRE> shell> <b>mhonarc -add </b><VAR><path></VAR><b>/mailfolder</b> </PRE> </blockquote> <P>If you are not in the same directory as the archive, then you can specify the location of the archive to add to with the <a href="resources/outdir.html"><strong><tt>-outdir</tt></strong></a> option. </P> <table border=0 cellpadding=4> <tr valign=top> <td><strong>NOTE</strong></td> <td><P>MHonArc will skip any messages that already exist in the archive. Therefore, MHonArc can be used to rescan the same mail folder and only convert any new messages it finds. </P> </td> </tr> </table> <P>If no mail folder arguments are specified, then MHonArc will attempt to add a <EM>single</EM> message read in from standard input. </P> <P><STRONG>Example</STRONG></P> <blockquote> <PRE> shell> <b>mhonarc -add < single.msg</b> </PRE> </blockquote> <P>Or, from a pipe: </P> <blockquote> <PRE> shell> <b>cat single.msg | mhonarc -add</b> </PRE> </blockquote> <hr> <H2><a name="single">Converting a single message</a></H2> <P>MHonArc has the ability to process a single mail message independent of creating, or modifying, an archive. To convert a single message to HTML use the <a href="resources/single.html"><strong><tt>-single</tt></strong></a> command-line option. The message to process can be specified by a filename on the command-line, or by reading the message from standard input if no file is specified. The filtered message is sent to standard output. All formatting options apply to the single message as with messages being processed for an archive, with the exception of formatting related specificly to archive processing, like index links and mail thread links. </P> <p><STRONG>Examples</STRONG></p> <DL> <DT>Input from standard input: <DD><P><tt>shell> <b>mhonarc -single < messagefile > file.html</b></tt> </P> </DL> <DL> <DT>Filename on command-line: <DD> <P><tt>shell> <b>mhonarc -single messagefile > file.html</b></tt> </P> </DL> <hr> <!--X-NavButtons-Start--> <p align=center> <a href="install.html"><img src="prev.gif" border=0 alt="[Prev]"></a><a href="commontasks.html"><img src="next.gif" border=0 alt="[Next]"></a><a href="mhonarc.html"><img src="up.gif" border=0 alt="[TOC]"></a><a href="faq/faq.html"><img src="faq.gif" border=0 alt="[FAQ]"></a><a href="app-bugs.html"><img src="bug.gif" border=0 alt="[Bugs]"></a><a href="http://www.mhonarc.org/"><img src="home.gif" border=0 alt="[Home]"></a> </p> <!--X-NavButtons-End--> <HR> <address> 01/06/10 17:47:40<br> <img align="top" src="monicon.gif" alt=""> <a href="http://www.mhonarc.org" ><strong>MHonArc</strong></a><br> Copyright © 1997-1999, <a href="http://www.mhonarc.org/~ehood/" >Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org" >mhonarc@mhonarc.org</a><br> </address> </BODY> </HTML>