<html>
<head>
<title>MHonArc Resources: ADD</title>
<link rel="stylesheet" type="text/css" href="../docstyles.css">
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">
</td><td><nobr>[<a href="../resources.html#add">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="addressmodifycode.html">ADDRESSMODIFYCODE</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>ADD</h1>
<!--X-TOC-Start-->
<ul>
<li><a href="#syntax">Syntax</a>
<li><a href="#description">Description</a>
<li><a href="#default">Default Setting</a>
<li><a href="#rcvars">Resource Variables</a>
<li><a href="#examples">Examples</a>
<li><a href="#version">Version</a>
<li><a href="#seealso">See Also</a>
</ul>
<!--X-TOC-End-->
<!-- *************************************************************** -->
<hr>
<h2><a name="syntax">Syntax</a></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>
<code>-add </code><var>folder1</var> ...<br>
<code>-add < </code><var>single-message</var>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>The ADD resource instructs <em>MHonArc</em> to add messages
to an existing archive. If 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>
<p>When adding, <em>MHonArc</em> will skip any messages that
already exists in the archive: allowing <em>MHonArc</em>
to rescan a mail folder to add only new messages found.
</p>
<table class="note" width="100%">
<tr valign="baseline">
<td><strong>NOTE:</strong></td>
<td width="100%"><p>MHonArc determines duplicate messages by message-ids.
</p>
</td>
</tr>
</table>
<!-- *************************************************************** -->
<hr>
<h2><a name="default">Default Setting</a></h2>
<p>Off
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="rcvars">Resource Variables</a></h2>
<p>N/A
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></h2>
<p>The following example shows adding a mail folder:
</p>
<table border=1 width="100%"><tr><td><pre class="shell">
prompt> <b>mhonarc -outdir /home/ehood/mailarch -add inbox</b>
</pre></td></tr></table>
<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>
<table border=1 width="100%"><tr><td><pre class="shell">
prompt> <b>show -noshow -noheader | mhonarc -add</b>
</pre></td></tr></table>
<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>
<p>1.0
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>
<p>
<a href="outdir.html">OUTDIR</a>,
<a href="reconvert.html">RECONVERT</a>
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">
</td><td><nobr>[<a href="../resources.html#add">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="addressmodifycode.html">ADDRESSMODIFYCODE</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2005/05/13 00:00:36 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright © 1997-1998, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org">mhonarc<!--
-->@<!--
-->mhonarc.org</a><br>
</address>
</body>
</html>