Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / add.html
CommitLineData
86530b38
AT
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
2<html>
3<head>
4<title>MHonArc Resources: ADD</title>
5</head>
6<body>
7<!--x-rc-nav-->
8<table border=0><tr valign="top">
9<td align="left" width="50%">&nbsp;
10</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>
11<!--/x-rc-nav-->
12<hr>
13<h1>ADD</h1>
14
15<!-- *************************************************************** -->
16<hr>
17<h2>Syntax</h2>
18
19<dl>
20
21<dt><strong>Envariable</strong></dt>
22<dd><p>N/A
23</p>
24</dd>
25
26<dt><strong>Element</strong></dt>
27<dd><p>N/A
28</p>
29</dd>
30
31<dt><strong>Command-line Option</strong></dt>
32<dd><p>
33<code>-add </code><var>folder1</var> ...<br>
34<code>-add &lt; </code><var>single-message</var>
35</p>
36</dd>
37
38</dl>
39
40<!-- *************************************************************** -->
41<hr>
42<h2>Description</h2>
43
44<p>The ADD resource instructs <em>MHonArc</em> to add messages
45to an existing archive. The archive specified does not exist,
46<em>MHonArc</em> will automatically create the archive. If input
47is coming from standard in, then the input is treated as a single
48message to add to the archive.
49</p>
50
51<table border=0 cellpadding=4>
52<tr valign=top>
53<td><strong><font color=red>CAUTION</font></strong></td>
54<td><p>If ADD is specified, and no archive currently exists, make
55sure there is no <b><tt>maillist.html</tt></b> file (or the filename
56specified by <a href="idxfname.html">IDXFNAME</a> resource) in
57the destination directory. This can may cause the main index to
58be incorrect. If this happens, remove <tt>maillist.html</tt> and
59use <a href="editidx.html">EDITIDX</a> to regenerate archive pages.
60</p>
61</td>
62</tr>
63</table>
64
65<p>When adding, <em>MHonArc</em> will skip any messages that
66already exists in the archive. This allows one to have <em>MHonArc</em>
67rescan a mail folder only add any new messages found.
68</p>
69
70<table border=0 cellpadding=4>
71<tr valign=top>
72<td><strong>NOTE</strong></td>
73<td><p>MHonArc determines duplicate messages by message-ids.
74</p>
75</td>
76</tr>
77</table>
78
79<!-- *************************************************************** -->
80<hr>
81<h2>Default Setting</h2>
82
83<p>Off
84</p>
85
86<!-- *************************************************************** -->
87<hr>
88<h2>Resource Variables</h2>
89
90<p>N/A
91</p>
92
93<!-- *************************************************************** -->
94<hr>
95<h2>Examples</h2>
96
97<p>The following example shows adding a mail folder:
98</p>
99
100<pre>
101 % <b>mhonarc -outdir /home/ehood/mailarch -add inbox</b>
102</pre>
103
104<p>The following shows how a single message can be added.
105The message comes from the output of the MH <em>show</em>
106program:
107</p>
108
109<pre>
110 % <b>show -noshow -noheader | mhonarc -add</b>
111</pre>
112
113
114
115<!-- *************************************************************** -->
116<hr>
117<h2>Version</h2>
118
119<p>1.0
120</p>
121
122<!-- *************************************************************** -->
123<hr>
124<h2>See Also</h2>
125
126<p><a href="outdir.html">OUTDIR</a>
127</p>
128
129<!-- *************************************************************** -->
130<hr>
131<!--x-rc-nav-->
132<table border=0><tr valign="top">
133<td align="left" width="50%">&nbsp;
134</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>
135<!--/x-rc-nav-->
136<hr>
137<address>
138$Date: 2002/07/27 05:13:10 $ <br>
139<img align="top" src="../monicon.png" alt="">
140<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
141Copyright &#169; 1997-1998, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org">mhonarc@mhonarc.org</a><br>
142</address>
143
144</body>
145</html>