tools/perl-5.8.0/doc/MHonArc/resources/add.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>MHonArc Resources: ADD</title>
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">&nbsp;
</td><td><nobr>[<a href="../resources.html#add">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="addressmodifycode.html">ADDRESSMODIFYCODE</a>]</td></tr></table>
<!--/x-rc-nav-->
<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>
<code>-add </code><var>folder1</var> ...<br>
<code>-add &lt; </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>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">&nbsp;
</td><td><nobr>[<a href="../resources.html#add">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="addressmodifycode.html">ADDRESSMODIFYCODE</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2002/07/27 05:13:10 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright &#169; 1997-1998, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org">mhonarc@mhonarc.org</a><br>
</address>

</body>
</html>