<html>
<head>
<title>MHonArc Resources: RECONVERT</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%">[Prev: <a href="rcfile.html">RCFILE</a>]</td><td><nobr>[<a href="../resources.html#reconvert">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="refsbegin.html">REFSBEGIN</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>RECONVERT</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>
<code>M2H_RECONVERT=</code>[ <code>0</code> | <code>1</code> ]
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p>N/A
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-reconvert</code><br>
<code>-noreconvert</code><br>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>When RECONVERT is active during an
<a href="add.html">add operation</a>, if a message currently exists
in the archive, it will be reconverted. This is basically the
same ad deleting a message and re-adding it, with the exception
that the message number will be preserved.
</p>
<!-- *************************************************************** -->
<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>Generally, RECONVERT is used to selectively re-process individual messages:
</p>
<table border="1" width="100%"><tr><td><pre class="shell">
prompt> <b>mhonarc -add -reconvert -outdir <var>/path/to/archive</var> < mesg.822</b>
</pre></td></tr></table>
<p>However, RECONVERT can be used to "rebuild" an archive where
message numbers are preserved:
</p>
<table border="1" width="100%"><tr><td><pre class="shell">
prompt> mhonarc <b>-add -reconvert -outdir <var>/path/to/archive</var> <var>folder</var></b>
</pre></td></tr></table>
<p>(assuming that <var>folder</var> contains all the original raw messages).
</p>
<p>The RECONVERT method is less efficient than the following:
</p>
<table border="1" width="100%"><tr><td><pre class="shell">
prompt> <b>rm -r <var>/path/to/archive</var></b>
prompt> <b>mkdir <var>/path/to/archive</var></b>
prompt> <b>mhonarc -outdir <var>/path/to/archive</var> <var>folder</var></b>
</pre></td></tr></table>
<p>But, if <var>folder</var> has had messages deleted from it before
the rebuild (for example, to remove spam or objectionable messages),
some messages may get assigned different message numbers from the
pre-rebuild archive. This can be a problem if people maintain
bookmarks to individual messages.
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>
<p>2.6.0
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>
<p>
<a href="add.html">ADD</a>
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="rcfile.html">RCFILE</a>]</td><td><nobr>[<a href="../resources.html#reconvert">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="refsbegin.html">REFSBEGIN</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2003/10/06 22:04:20 $<br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright © 2002, <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org"
>mhonarc<!--
-->@<!--
-->mhonarc.org</a><br>
</address>
</body>
</html>