<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN"> <html> <head> <title>MHonArc Resources: ADD</title> </head> <body> <address> <a href="../resources.html#add">MHonArc Resource List</a> </address> <hr> <h1>ADD</h1> <!-- *************************************************************** --> <hr> <h2>Syntax</h2> <dl> <dt><strong>Envariable</strong><dt> <dd><p>N/A </p> </dd> <dt><strong>Element</strong><dt> <dd><p>N/A </p> </dd> <dt><strong>Command-line Option</strong><dt> <dd><p><br> <code>-add </code><var>folder1</var> ...<br> <code>-add < </code><var>single-message</var> </p> </dd> </dl> <!-- *************************************************************** --> <hr> <h2>Description</h2> <p>The ADD resource instructs <em>MHonArc</em> to add messages to an existing archive. The archive specified does not exist, <em>MHonArc</em> will automatically create the archive. If input is coming from standard in, then the input is treated as a single message to add to the archive. </p> <table border=0 cellpadding=4> <tr valign=top> <td><strong><font color=red>CAUTION</font></strong></td> <td><p>If ADD is specified, and no archive currently exists, make sure there is no <b><tt>maillist.html</tt></b> file (or the filename specified by <a href="idxfname.html">IDXFNAME</a> resource) in the destination directory. This can may cause the main index to be incorrect. If this happens, remove <tt>maillist.html</tt> and use <a href="editidx.html">EDITIDX</a> to regenerate archive pages. </p> </td> </tr> </table> <p>When adding, <em>MHonArc</em> will skip any messages that already exists in the archive. This allows one to have <em>MHonArc</em> rescan a mail folder only add any new messages found. </p> <table border=0 cellpadding=4> <tr valign=top> <td><strong>NOTE</strong></td> <td><p>MHonArc determines duplicate messages by message-ids. </p> </td> </tr> </table> <!-- *************************************************************** --> <hr> <h2>Default Setting</h2> <p>Off </p> <!-- *************************************************************** --> <hr> <h2>Resource Variables</h2> <p>N/A </p> <!-- *************************************************************** --> <hr> <h2>Examples</h2> <p>The following example shows adding a mail folder: </p> <pre> % <b>mhonarc -outdir /home/ehood/mailarch -add inbox</b> </pre> <p>The following shows how a single message can be added. The message comes from the output of the MH <em>show</em> program: </p> <pre> % <b>show -noshow -noheader | mhonarc -add</b> </pre> <!-- *************************************************************** --> <hr> <h2>Version</h2> <p>1.0 </p> <!-- *************************************************************** --> <hr> <h2>See Also</h2> <p><a href="outdir.html">OUTDIR</a> </p> <!-- *************************************************************** --> <hr> <address> 00/10/28 11:12:50<br> <img align="top" src="../monicon.gif" alt=""> <a href="http://www.pobox.com/~ehood/mhonarc.html"><strong>MHonArc</strong></a><br> Copyright © 1997-1998, <a href="http://www.pobox.com/~ehood/">Earl Hood</a>, <a href="mailto:mhonarc@pobox.com">mhonarc@pobox.com</a><br> </address> </body> </html>