Commit | Line | Data |
---|---|---|
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%"> | |
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: <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 < </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 | |
45 | to an existing archive. The archive specified does not exist, | |
46 | <em>MHonArc</em> will automatically create the archive. If input | |
47 | is coming from standard in, then the input is treated as a single | |
48 | message 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 | |
55 | sure there is no <b><tt>maillist.html</tt></b> file (or the filename | |
56 | specified by <a href="idxfname.html">IDXFNAME</a> resource) in | |
57 | the destination directory. This can may cause the main index to | |
58 | be incorrect. If this happens, remove <tt>maillist.html</tt> and | |
59 | use <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 | |
66 | already exists in the archive. This allows one to have <em>MHonArc</em> | |
67 | rescan 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. | |
105 | The message comes from the output of the MH <em>show</em> | |
106 | program: | |
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%"> | |
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: <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> | |
141 | Copyright © 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> |