mhonarc-commits
[Top] [All Lists]

CVS: mhonarc/MHonArc/doc app-api.html,1.7,1.8 app-bugs.html,1.42,1.43 app-d...

2002-11-23 21:19:11
Update of /cvsroot/mhonarc/mhonarc/MHonArc/doc
In directory subversions:/tmp/cvs-serv9884

Modified Files:
	app-api.html app-bugs.html app-diagnos.html app-mimeconf.html 
	app-rcfileexs.html app-rcidx.html app-utilsprg.html 
	commontasks.html contacts.html docstyles.css index.html 
	install.html intro.html layout.html mhonarc.html 
	quickstart.html rcvars.html relnotes.html resources.html 
Log Message:
Documentation cleanup and enhancements.


Index: app-api.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-api.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -r1.7 -r1.8
*** app-api.html	20 Nov 2002 23:53:07 -0000	1.7
--- app-api.html	24 Nov 2002 04:18:35 -0000	1.8
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <html>
  <head>
--- 1,2 ----

Index: app-bugs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-bugs.html,v
retrieving revision 1.42
retrieving revision 1.43
diff -C2 -r1.42 -r1.43
*** app-bugs.html	20 Nov 2002 23:53:07 -0000	1.42
--- app-bugs.html	24 Nov 2002 04:18:35 -0000	1.43
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <html>
  <head>
--- 1,2 ----

Index: app-diagnos.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-diagnos.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -r1.17 -r1.18
*** app-diagnos.html	20 Nov 2002 23:53:07 -0000	1.17
--- app-diagnos.html	24 Nov 2002 04:18:35 -0000	1.18
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----

Index: app-mimeconf.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-mimeconf.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -r1.11 -r1.12
*** app-mimeconf.html	20 Nov 2002 23:53:07 -0000	1.11
--- app-mimeconf.html	24 Nov 2002 04:18:35 -0000	1.12
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----

Index: app-rcfileexs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-rcfileexs.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -r1.15 -r1.16
*** app-rcfileexs.html	20 Nov 2002 23:53:07 -0000	1.15
--- app-rcfileexs.html	24 Nov 2002 04:18:35 -0000	1.16
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----

Index: app-rcidx.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-rcidx.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -C2 -r1.20 -r1.21
*** app-rcidx.html	20 Nov 2002 23:53:07 -0000	1.20
--- app-rcidx.html	24 Nov 2002 04:18:35 -0000	1.21
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----

Index: app-utilsprg.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/app-utilsprg.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -r1.19 -r1.20
*** app-utilsprg.html	20 Nov 2002 23:53:07 -0000	1.19
--- app-utilsprg.html	24 Nov 2002 04:18:35 -0000	1.20
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 45,51 ****
  <p>Typical usage:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-dbedit -rcfile <var>res.mrc</var> -outdir <var>/path/to/archive</var></b>
! </pre>
  
  <hr>
--- 44,50 ----
  <p>Typical usage:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-dbedit <a class="shell" href="resources/rcfile.html">-rcfile</a> <var>res.mrc</var> <a class="shell" href="resources/outdir.html">-outdir</a> <var>/path/to/archive</var></b>
! </pre></td></tr></table>
  
  <hr>
***************
*** 59,65 ****
  <p>Typical usage:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-dbrecover -outdir <var>/path/to/archive</var></b>
! </pre>
  
  <p>If the archive used different resource settings from the defaults
--- 58,64 ----
  <p>Typical usage:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-dbrecover <a class="shell" href="resources/outdir.html">-outdir</a> <var>/path/to/archive</var></b>
! </pre></td></tr></table>
  
  <p>If the archive used different resource settings from the defaults
***************
*** 69,75 ****
  then you should invoke <b>mha-dbrecover</b> like the following:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-dbrecover -htmlext shtml -outdir <var>/path/to/archive</var></b>
! </pre>
  
  <p><b>mha-dbrecover</b> will only recreate non-layout message related data.
--- 68,74 ----
  then you should invoke <b>mha-dbrecover</b> like the following:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-dbrecover <a class="shell" href="resources/htmlext.html">-htmlext</a> shtml <a class="shell" href="resources/outdir.html">-outdir</a> <var>/path/to/archive</var></b>
! </pre></td></tr></table>
  
  <p><b>mha-dbrecover</b> will only recreate non-layout message related data.
***************
*** 78,84 ****
  invoking <b>mha-dbrecover</b>.  For example:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-dbrecover -rcfile <var>res.mrc</var> -outdir <var>/path/to/archive</var></b>
! </pre>
  
  <h3><a name="mha-dbrecover-options">Additional Options</a></h3>
--- 77,83 ----
  invoking <b>mha-dbrecover</b>.  For example:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-dbrecover <a class="shell" href="resources/rcfile.html">-rcfile</a> <var>res.mrc</var> <a class="shell" href="resources/outdir.html">-outdir</a> <var>/path/to/archive</var></b>
! </pre></td></tr></table>
  
  <h3><a name="mha-dbrecover-options">Additional Options</a></h3>
***************
*** 88,92 ****
  
  <dl>
! <dt><tt>-dbr-startnum <var>#</var></tt></dt>
  <dd>The starting message number to recover data from.  This option is
      useful if you have many message files in a directory, but you only
--- 87,91 ----
  
  <dl>
! <dt><strong><tt>-dbr-startnum <var>#</var></tt></strong></dt>
  <dd>The starting message number to recover data from.  This option is
      useful if you have many message files in a directory, but you only
***************
*** 96,100 ****
  </dl>
  <dl>
! <dt><tt>-dbr-endnum <var>#</var></tt></dt>
  <dd>The ending message number to recover data from.  This option is
      useful if you have many message files in a directory, but you only
--- 95,99 ----
  </dl>
  <dl>
! <dt><strong><tt>-dbr-endnum <var>#</var></tt></strong></dt>
  <dd>The ending message number to recover data from.  This option is
      useful if you have many message files in a directory, but you only
***************
*** 124,130 ****
  the database anyway:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-dbrecover -dbr-startnum 800 -outdir <var>/path/to/archive</var></b>
! </pre>
  
  <table class="note" width="100%">
--- 123,129 ----
  the database anyway:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-dbrecover -dbr-startnum 800 <a class="shell" href="resources/outdir.html">-outdir</a> <var>/path/to/archive</var></b>
! </pre></td></tr></table>
  
  <table class="note" width="100%">
***************
*** 175,179 ****
  
  <dl>
! <dt><tt>-dcd-digest</tt></dt>
  <dd>Do not parse message/rfc822 and message/news attachments.
      Normally, <b>mha-decode</b> will recursively parse message
--- 174,178 ----
  
  <dl>
! <dt><strong><tt>-dcd-digest</tt></strong></dt>
  <dd>Do not parse message/rfc822 and message/news attachments.
      Normally, <b>mha-decode</b> will recursively parse message
***************
*** 188,223 ****
  <p>Basic usage:
  </p>
! <pre class="shell">
  prompt&gt; <b>mha-decode inbox</b>
! </pre>
  <p>Use <tt>-outdir</tt> to have all decoded data placed into a
  separate directory:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-decode -outdir <var>/var/tmp</var> inbox</b>
! </pre>
  <p>And to decode a single message:</p>
! <pre class="shell">
! prompt&gt; <b>mha-decode -single <var>msg.822</var></b>
! </pre>
  <p>or from standard input:</p>
! <pre class="shell">
  prompt&gt; <b><var>some_program</var> | mha-decode -single</b>
! </pre>
  <p>Save out attached messages and then pass them into MHonArc
  to be added to a archive:
  </p>
! <pre class="shell">
! prompt&gt; <b>mha-decode -dcd-digest -single <var>digest</var></b>
! prompt&gt; <b>mhonarc -outdir <var>/path/to/archive</var> -mhpattern '^822.*\.822$' .</b>
! </pre>
  <p><b>Note:</b> There is a trailing dot, '<tt>.</tt>', at the end of the
  called to <b>mhonarc</b> to tell <b>mhonarc</b> to process the
  current working directory.
  </p>
! <p><b>Note:</b> You may need to reset the
  <a href="resources/mhpattern.html">MHPATTERN</a> resource if normal
  input into the archive is from MH-style mail folders.
  </p>
  
  <hr>
--- 187,228 ----
  <p>Basic usage:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mha-decode inbox</b>
! </pre></td></tr></table>
  <p>Use <tt>-outdir</tt> to have all decoded data placed into a
  separate directory:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-decode <a class="shell" href="resources/outdir.html">-outdir</a> <var>/var/tmp</var> inbox</b>
! </pre></td></tr></table>
  <p>And to decode a single message:</p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-decode <a class="shell" href="resources/single.html">-single</a> <var>msg.822</var></b>
! </pre></td></tr></table>
  <p>or from standard input:</p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b><var>some_program</var> | mha-decode -single</b>
! </pre></td></tr></table>
  <p>Save out attached messages and then pass them into MHonArc
  to be added to a archive:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mha-decode -dcd-digest <a class="shell" href="resources/single.html">-single</a> <var>digest</var></b>
! prompt&gt; <b>mhonarc <a class="shell" href="resources/outdir.html">-outdir</a> <var>/path/to/archive</var> <a class="shell" href="resources/mhpattern.html">-mhpattern</a> '^822.*\.822$' .</b>
! </pre></td></tr></table>
  <p><b>Note:</b> There is a trailing dot, '<tt>.</tt>', at the end of the
  called to <b>mhonarc</b> to tell <b>mhonarc</b> to process the
  current working directory.
  </p>
! <table class="note" width="100%">
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td width="100%"><p>You may need to reset the
  <a href="resources/mhpattern.html">MHPATTERN</a> resource if normal
  input into the archive is from MH-style mail folders.
  </p>
+ </td>
+ </tr>
+ </table>
  
  <hr>

Index: commontasks.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/commontasks.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -r1.16 -r1.17
*** commontasks.html	20 Nov 2002 23:53:07 -0000	1.16
--- commontasks.html	24 Nov 2002 04:18:35 -0000	1.17
***************
*** 1,9 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
! <HTML>
! <HEAD>
! <TITLE>MHonArc Reference -- Common Tasks</TITLE>
  <link rel="stylesheet" type="text/css" href="docstyles.css">
! </HEAD>
! <BODY>
  
  <!--X-NavButtons-Start-->
--- 1,8 ----
! <html>
! <head>
! <title>MHonArc Reference -- Common Tasks</title>
  <link rel="stylesheet" type="text/css" href="docstyles.css">
! </head>
! <body>
  
  <!--X-NavButtons-Start-->
***************
*** 18,25 ****
  
  <p>The following section describes how to perform some common tasks with
! MHonArc archives beyond those mentioned in
! <a href="quickstart.html">Quick Start</a>.  To get a complete picture
! of what you can do with MHonArc, see the section
! on <a href="resources.html">Resources</a>.
  </p>
  
--- 17,24 ----
  
  <p>The following section describes how to perform some common tasks with
! MHonArc, beyond those mentioned in
! <a href="quickstart.html"><cite>Quick Start</cite></a>.
! To get a complete picture of the capabilities of MHonArc, see the
! <a href="resources.html"><cite>Resources</cite></a> section.
  </p>
  
***************
*** 41,52 ****
  <h2><a name="chgtitle">Setting the Index Title</a></h2>
  
! <p>If you read the <a href="quickstart.html">Quick Start</a>
! section and ran MHonArc on some of your mail, 
! you have may have noticed that the titles of the main (date)
  and thread index pages are not very descriptive: "Mail Index"
  and "Mail Thread Index".  It would be much nicer if the the
! titles reflect what type of mail is in the archive.  For example,
! if the archive contains messages from a mailing list, the name
! of the list should probably be in the title.
  </p>
  <p>MHonArc allows you to change the titles via the
--- 40,48 ----
  <h2><a name="chgtitle">Setting the Index Title</a></h2>
  
! <p>If you tested MHonArc out on some of your mail,
! you may have noticed that the titles of the main (date)
  and thread index pages are not very descriptive: "Mail Index"
  and "Mail Thread Index".  It would be much nicer if the the
! titles reflect what type of mail is in the archive.
  </p>
  <p>MHonArc allows you to change the titles via the
***************
*** 58,65 ****
  the thread index title.  Example:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/title.html">-title</a> "The Widget List Archive" \
  	       <a class="shell" href="resources/ttitle.html">-ttitle</a> "The Widget List Thread Archive"</b> ...
! </pre>
  
  <!-- *************************************************************** -->
--- 54,61 ----
  the thread index title.  Example:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/title.html">-title</a> "The Widget List Archive" \
  	       <a class="shell" href="resources/ttitle.html">-ttitle</a> "The Widget List Thread Archive"</b> ...
! </pre></td></tr></table>
  
  <!-- *************************************************************** -->
***************
*** 67,77 ****
  <h2><a name="chg-idx-order">Changing Index Listing Order</a></h2>
  
! <p>By default, messages get listed in chronological order on
! the main/non-thread and thread index pages.
  </p>
! <table border=0 cellpadding=4>
  <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>The chronological order in the thread index is based on
  the root messages of each thread.
  </p>
--- 63,73 ----
  <h2><a name="chg-idx-order">Changing Index Listing Order</a></h2>
  
! <p>By default, messages are listed in chronological order on
! the main and thread index pages.
  </p>
! <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>The chronological order in the thread index is based on
  the root messages of each thread.
  </p>
***************
*** 107,113 ****
  do something like the following:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/sort.html">-sort</a> <a class="shell" href="resources/reverse.html">-reverse</a></b> ...
! </pre>
  
  <!-- *************************************************************** -->
--- 103,109 ----
  do something like the following:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/sort.html">-sort</a> <a class="shell" href="resources/reverse.html">-reverse</a></b> ...
! </pre></td></tr></table>
  
  <!-- *************************************************************** -->
***************
*** 131,137 ****
  like the following:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/expireage.html">-expireage</a> 2635200 <a class="shell" href="resources/add.html">-add</a> <a class="shell" href="resources/outdir.html">-outdir</a> /path/to/archive mailbox</b>
! </pre>
  <p>Here, we used the <a href="resources/expireage.html"><tt>-expireage</tt></a>
  option
--- 127,133 ----
  like the following:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/expireage.html">-expireage</a> 2635200 <a class="shell" href="resources/add.html">-add</a> <a class="shell" href="resources/outdir.html">-outdir</a> /path/to/archive mailbox</b>
! </pre></td></tr></table>
  <p>Here, we used the <a href="resources/expireage.html"><tt>-expireage</tt></a>
  option
***************
*** 140,144 ****
  I know, having to use seconds to specify the expiration age seems cumbersome.
  A table is provided in the <a href="resources/expireage.html">EXPIREAGE</a>
! reference page listing common time periods to their equivalence in seconds.
  </p>
  
--- 136,140 ----
  I know, having to use seconds to specify the expiration age seems cumbersome.
  A table is provided in the <a href="resources/expireage.html">EXPIREAGE</a>
! reference page listing common time periods and their equivalence in seconds.
  </p>
  
***************
*** 149,155 ****
  given date/time, will be automatically removed.  For example:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/expiredate.html">-expiredate</a> "1 Jan 1999 00:00:00" <a class="shell" href="resources/add.html">-add</a> <a class="shell" href="resources/outdir.html">-outdir</a> /path/to/archive mailbox</b>
! </pre>
  <p>In this example, before MHonArc adds any new messages, it will delete
  any messages with a date earlier than January 1, 1999.  See the
--- 145,151 ----
  given date/time, will be automatically removed.  For example:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/expiredate.html">-expiredate</a> "1 Jan 1999 00:00:00" <a class="shell" href="resources/add.html">-add</a> <a class="shell" href="resources/outdir.html">-outdir</a> /path/to/archive mailbox</b>
! </pre></td></tr></table>
  <p>In this example, before MHonArc adds any new messages, it will delete
  any messages with a date earlier than January 1, 1999.  See the
***************
*** 163,169 ****
  of an archive:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/maxsize.html">-maxsize</a> 500 <a class="shell" href="resources/add.html">-add</a> <a class="shell" href="resources/outdir.html">-outdir</a> /path/to/archive mailbox</b>
! </pre>
  
  <h3><a name="manualrmm">Manual Removal</a></h3>
--- 159,165 ----
  of an archive:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/maxsize.html">-maxsize</a> 500 <a class="shell" href="resources/add.html">-add</a> <a class="shell" href="resources/outdir.html">-outdir</a> /path/to/archive mailbox</b>
! </pre></td></tr></table>
  
  <h3><a name="manualrmm">Manual Removal</a></h3>
***************
*** 178,184 ****
  <a href="resources/rmm.html"><tt>-rmm</tt></a> option.  For example:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/rmm.html">-rmm</a> 24 28 39 48</b>
! </pre>
  <p>will delete messages 24, 28, 39, and 48.
  </p>
--- 174,180 ----
  <a href="resources/rmm.html"><tt>-rmm</tt></a> option.  For example:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/rmm.html">-rmm</a> 24 28 39 48</b>
! </pre></td></tr></table>
  <p>will delete messages 24, 28, 39, and 48.
  </p>
***************
*** 193,197 ****
  the <a href="resources/scan.html"><tt>-scan</tt></a> option.  For example:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/scan.html">-scan</a> <a class="shell" href="resources/outdir.html">-outdir</a> /home/ehood/html/archive</b>
  Reading database ...
--- 189,193 ----
  the <a href="resources/scan.html"><tt>-scan</tt></a> option.  For example:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/scan.html">-scan</a> <a class="shell" href="resources/outdir.html">-outdir</a> /home/ehood/html/archive</b>
  Reading database ...
***************
*** 216,220 ****
     13  1996/08/01  Steve McCullagh  Perl 5.002 and $| errors                   
  ...
! </pre>
  
  <p>With <a href="resources/scan.html">-scan</a>, you can get a listing
--- 212,216 ----
     13  1996/08/01  Steve McCullagh  Perl 5.002 and $| errors                   
  ...
! </pre></td></tr></table>
  
  <p>With <a href="resources/scan.html">-scan</a>, you can get a listing
***************
*** 299,305 ****
  file so our footer will show up:
  </p>
! <pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/rcfile.html">-rcfile</a> myresource.mrc</b> ...
! </pre>
  
  <!-- *************************************************************** -->
--- 295,301 ----
  file so our footer will show up:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc <a class="shell" href="resources/rcfile.html">-rcfile</a> myresource.mrc</b> ...
! </pre></td></tr></table>
  
  <!-- *************************************************************** -->

Index: contacts.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/contacts.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -C2 -r1.24 -r1.25
*** contacts.html	20 Nov 2002 23:53:07 -0000	1.24
--- contacts.html	24 Nov 2002 04:18:35 -0000	1.25
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 82,86 ****
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>The special <tt>mhonarc-allow</tt> list applies to all
  <tt>mhonarc.org</tt> mailing lists.  For example, if you subscribe
--- 81,85 ----
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>The special <tt>mhonarc-allow</tt> list applies to all
  <tt>mhonarc.org</tt> mailing lists.  For example, if you subscribe

Index: docstyles.css
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/docstyles.css,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** docstyles.css	20 Nov 2002 23:53:07 -0000	1.1
--- docstyles.css	24 Nov 2002 04:18:35 -0000	1.2
***************
*** 8,15 ****
  }
  
! :link { color: #0000EE; }
! :visited { color: #551A8B; }
! [href]:hover { color: #009900; }
! :active { color: #FF0000; }
  
  pre.code {
--- 8,25 ----
  }
  
! a:link { color: #0000EE; }
! a:visited { color: #551A8B; }
! a[href]:hover { color: #009900; }
! a:active { color: #FF0000; }
! 
! h1, h2 {
!   margin-top: 0.0em;
! }
! 
! hr {
!   background: #0000CC;
!   padding: 0em;
!   margin: 0em;
! }
  
  pre.code {
***************
*** 30,36 ****
    color: white;
    padding: 0.25em;
-   border-color: black;
-   border-style: solid;
-   border-width: thin;
  }
  tt.ishell {
--- 40,43 ----

Index: index.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/index.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -r1.15 -r1.16
*** index.html	20 Nov 2002 23:53:07 -0000	1.15
--- index.html	24 Nov 2002 04:18:35 -0000	1.16
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----

Index: install.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/install.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** install.html	20 Nov 2002 23:53:07 -0000	1.18
--- install.html	24 Nov 2002 04:18:35 -0000	1.19
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 21,31 ****
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>Make sure to read the
  <a href="relnotes.html">release notes</a> before installing MHonArc,
  especially if you are upgrading from a previous release.  If you
  are reading the text version of this installation document, a text
! version of the release notes is contained in the file <tt>RELNOTES</tt>
! contained within the root of the MHonArc distribution.
  </p>
  </td>
--- 20,30 ----
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>Make sure to read the
  <a href="relnotes.html">release notes</a> before installing MHonArc,
  especially if you are upgrading from a previous release.  If you
  are reading the text version of this installation document, a text
! version of the release notes, <tt>RELNOTES</tt>,
! exists within the root of the MHonArc distribution.
  </p>
  </td>
***************
*** 36,39 ****
--- 35,39 ----
  <!--X-TOC-Start-->
  <ul>
+ <li><a href="#impatient">For the Impatient</a>
  <li><a href="#sysreqs">System Requirements</a>
  <li><a href="#download">Downloading MHonArc</a>
***************
*** 58,61 ****
--- 58,78 ----
  <!-- *************************************************************** -->
  <hr>
+ <h2><a name="impatient">For the Impatient</a></h2>
+ 
+ <p>If you cannot wait to get going, try the following:
+ </p>
+ <table border="1" width="100%"><tr><td><pre class="shell">
+ prompt&gt; <b>wget 'http://www.mhonarc.org/release/MHonArc/MHonArc<var>X.X.X</var>'</b>
+ prompt&gt; <b>gzip -dc MHonArc<var>X.X.X</var> | tar xvf -</b>
+ prompt&gt; <b>cd MHonArc<var>X.X.X</var></b>
+ prompt&gt; <b>perl install.me</b>
+ </pre></td></tr></table>
+ <p>where <tt><var>X.X.X</var></tt> represents the version number.</p>
+ 
+ <p>If there were problems doing the above, then keep reading.
+ </p>
+ 
+ <!-- *************************************************************** -->
+ <hr>
  <h2><a name="sysreqs">System Requirements</a></h2>
  
***************
*** 69,73 ****
      </p>
      </li>
! <li><p>The standard modules are installed:
      </p>
      <ul>
--- 86,90 ----
      </p>
      </li>
! <li><p>The following standard modules are installed:
      </p>
      <ul>
***************
*** 78,84 ****
--- 95,109 ----
  	<li><b>Time::Local</b></li>
      </ul>
+     <p> </p>
+     <table class="note" width="100%">
+     <tr valign="baseline">
+     <td><strong>NOTE:</strong></td>
+     <td width="100%">
      <p>The <a href="#installingviainstallme">installation program</a>
      will verify that required modules are installed.
      </p>
+     </td>
+     </tr>
+     </table>
      </li>
  <li><p>The following modules are optional:
***************
*** 115,126 ****
  </p>
  <ul>
! <li><b>tar-bz2</b>: <tt class="icode">MHonArc<var>X.X.X</var>.tar.bz2</tt>
      </li>
! <li><b>tar-gzip</b>: <tt class="icode">MHonArc<var>X.X.X</var>.tar.gz</tt>
      </li>
! <li><b>zip</b>: <tt class="icode">MHonArc<var>X.X.X</var>.zip</tt>
      </li>
  </ul>
! <p>where <tt class="icode"><var>X.X.X</var></tt> represents the version number.
  </p>
  <p>Alternate distribution formats for MHonArc may be available, like
--- 140,151 ----
  </p>
  <ul>
! <li><b>tar-bz2</b>: <tt>MHonArc<var>X.X.X</var>.tar.bz2</tt>
      </li>
! <li><b>tar-gzip</b>: <tt>MHonArc<var>X.X.X</var>.tar.gz</tt>
      </li>
! <li><b>zip</b>: <tt>MHonArc<var>X.X.X</var>.zip</tt>
      </li>
  </ul>
! <p>where <tt><var>X.X.X</var></tt> represents the version number.
  </p>
  <p>Alternate distribution formats for MHonArc may be available, like
***************
*** 140,152 ****
  <dl>
  <dt><b>tar-bz2</b></dt>
! <dd><pre class="shell">
!   prompt&gt; <b>bzip2 -dc MHonArc<var>X.X.X</var>.tar.bz2 | tar xvf -</b></pre>
  <dt><b>tar-gzip</b></dt>
! <dd><pre class="shell">
!   prompt&gt; <b>gzip -dc MHonArc<var>X.X.X</var>.tar.gz | tar xvf -</b></pre>
      </dd>
  <dt><b>zip</b></dt>
! <dd><pre class="shell">
!   prompt&gt; <b>unzip MHonArc<var>X.X.X</var>.zip</b></pre>
      </dd>
  </dl>
--- 165,177 ----
  <dl>
  <dt><b>tar-bz2</b></dt>
! <dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>bzip2 -dc MHonArc<var>X.X.X</var>.tar.bz2 | tar xvf -</b></pre></td></tr></table>
  <dt><b>tar-gzip</b></dt>
! <dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>gzip -dc MHonArc<var>X.X.X</var>.tar.gz | tar xvf -</b></pre></td></tr></table>
      </dd>
  <dt><b>zip</b></dt>
! <dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>unzip MHonArc<var>X.X.X</var>.zip</b></pre></td></tr></table>
      </dd>
  </dl>
***************
*** 154,167 ****
  <p>For Win32 systems, you can use a program like <em>WinZip</em> to
  extract the tar-gzip or zip formats.  If using
! <em><a href="http://www.cygwin.com/";>Cygwin</a></em>, you can use
  the Unix-based extraction methods.
  </p>
  
! <p>After extraction, the subdirectory <tt class="icode">MHonArc<var>X.X.X</var></tt> will
  have been created containing all the files comprising MHonArc.
  </p>
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>IMPORTANT</strong></td>
  <td width="100%"><p>Please read the <a href="relnotes.html">release notes</a>
  before continuing for any news about compatibility
--- 179,205 ----
  <p>For Win32 systems, you can use a program like <em>WinZip</em> to
  extract the tar-gzip or zip formats.  If using
! <a href="http://www.cygwin.com/";>Cygwin</a>, you can use
  the Unix-based extraction methods.
  </p>
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><strong>NOTE:</strong></td>
+ <td width="100%"><p>If your are using
+ <a href="http://www.cygwin.com/";>Cygwin</a> and the
+ cygwin build of Perl, then the installation and usage of MHonArc is
+ the same as a Unix-based environment.  MHonArc treats the
+ cygwin environment as a Unix-type environment for determine default
+ resource values and for operational purposes.
+ </p>
+ </td>
+ </tr>
+ </table>
  
! <p>After extraction, the subdirectory <tt>MHonArc<var>X.X.X</var></tt> will
  have been created containing all the files comprising MHonArc.
  </p>
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>Please read the <a href="relnotes.html">release notes</a>
  before continuing for any news about compatibility
***************
*** 171,178 ****
  </tr>
  </table>
! <p>You
! will now want to change your current directory to <tt class="icode">MHonArc<var>X.X.X</var></tt>
! for the <a href="#installingfiles">next step</a>.
! </p>
  
  <!-- *************************************************************** -->
--- 209,219 ----
  </tr>
  </table>
! <p>Now, change your current directory to <tt>MHonArc<var>X.X.X</var></tt>
! for the <a href="#installingfiles">next step</a>.  On a Unix-type
! system, the following command will do it:
! </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>cd MHonArc<var>X.X.X</var></b>
! </pre></td></tr></table>
  
  <!-- *************************************************************** -->
***************
*** 181,194 ****
  
  <p>Provided in the MHonArc distribution is a Perl program,
! <b><tt>install.me</tt></b>
! that will install MHonArc on your system.  To run the program, type
! the following at your shell prompt:
! </p>
! <pre class="shell">
!   prompt&gt; <b>perl install.me</b>
! </pre>
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>You must be in the same directory as the <b><tt>install.me</tt></b>
  program when you run it.
--- 222,235 ----
  
  <p>Provided in the MHonArc distribution is a Perl program,
! <b><tt>install.me</tt></b>, for installing MHonArc on your system.
! To run the program, type the following command:
! </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>perl install.me</b>
! </pre></td></tr></table>
! <p> </p>
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>You must be in the same directory as the <b><tt>install.me</tt></b>
  program when you run it.
***************
*** 200,208 ****
  <p>The installation program will ask you a series of questions on where
  the perl executable is and where to put MHonArc files.  Just hit
! &lt;CR&gt; to accept the default values listed in ()'s.  Note, the default
  values are determined by the configuration of perl on your system.
! If you choose the defaults, you may need to possess root/admin privileges
! to have a successful install.
  </p>
  
  <p><b><tt>install.me</tt></b> can take several options on the
--- 241,256 ----
  <p>The installation program will ask you a series of questions on where
  the perl executable is and where to put MHonArc files.  Just hit
! &lt;Enter&gt; to accept the default values listed in ()'s.
! </p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>The default
  values are determined by the configuration of perl on your system.
! If you choose the defaults, you may need to possess root/admin privileges.
  </p>
+ </td>
+ </tr>
+ </table>
  
  <p><b><tt>install.me</tt></b> can take several options on the
***************
*** 210,214 ****
  is the list of options available:
  </p>
! <pre class="shell">
    -afs                  : Skip permission checks (useful if AFS)
    -batch                : Run in batch mode (do not ask questions)
--- 258,262 ----
  is the list of options available:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
    -afs                  : Skip permission checks (useful if AFS)
    -batch                : Run in batch mode (do not ask questions)
***************
*** 226,251 ****
    -perl &lt;pathname&gt;      : Pathname of perl interpreter
    -prefix &lt;path&gt;        : Set prefix for installation directories
! </pre>
  
  <p>For example, if you do not want to install the documentation, do
  the following:
  </p>
! <pre class="shell">
!   prompt&gt; <b>perl install.me -nodoc</b>
! </pre>
  
  <p>Later on, if you decide you want to install the documentation, but
  not re-install the other files, do the following:
  </p>
! <pre class="shell">
!   prompt&gt; <b>perl install.me -nobin -nolib -noman</b>
! </pre>
  
  <p>If you want to install files relative to your home directory, do the
  following:
  </p>
! <pre class="shell">
!   prompt&gt; <b>perl install.me -prefix $HOME</b>
! </pre>
  
  <h3><a name="installmenotes"><tt>install.me</tt> Notes</a></h3>
--- 274,299 ----
    -perl &lt;pathname&gt;      : Pathname of perl interpreter
    -prefix &lt;path&gt;        : Set prefix for installation directories
! </pre></td></tr></table>
  
  <p>For example, if you do not want to install the documentation, do
  the following:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>perl install.me -nodoc</b>
! </pre></td></tr></table>
  
  <p>Later on, if you decide you want to install the documentation, but
  not re-install the other files, do the following:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>perl install.me -nobin -nolib -noman</b>
! </pre></td></tr></table>
  
  <p>If you want to install files relative to your home directory, do the
  following:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>perl install.me -prefix $HOME</b>
! </pre></td></tr></table>
  
  <h3><a name="installmenotes"><tt>install.me</tt> Notes</a></h3>
***************
*** 259,279 ****
  <li><p>The installation lib directory is added to each program's
  search path so each program can find the libaries needed for
! proper execution.  Therefore, you should <b>NOT</b> have to set your
  PERL5LIB environment variable if you install the library files
! in a location not in the default perl library search path.
  </p>
  </li>
  <li><p>If you specify paths that do not exist, the <tt>install.me</tt>
! program will create the paths for you.	If running in
! interactive mode, you will be prompted before each path
! is created.
  </p>
  </li>
  <li><p><tt>install.me</tt> supports environment variable interpolation in
  pathnames specified during interactive installation.
! For example, if you want to install the program files into
  your local bin directory, you can enter the following when
! prompted for the location to install executables: <tt>$HOME/bin</tt>.
! Also, if the '~' (tilde) character is the first character of the
  pathname specified, it will be expanded to the value of the
  HOME environment variable.  Therefore, the following are
--- 307,327 ----
  <li><p>The installation lib directory is added to each program's
  search path so each program can find the libaries needed for
! proper execution.  Therefore, you do <b>NOT</b> have to set your
  PERL5LIB environment variable if you install the library files
! in a non-standard location.
  </p>
  </li>
  <li><p>If you specify paths that do not exist, the <tt>install.me</tt>
! program creates the paths for you.  If running in
! interactive mode, <tt>install.me</tt> prompts you for confirmation
! before creating a path.
  </p>
  </li>
  <li><p><tt>install.me</tt> supports environment variable interpolation in
  pathnames specified during interactive installation.
! For example, if you want to install program files into
  your local bin directory, you can enter the following when
! prompted for the location to install executables: <tt class="ishell">$HOME/bin</tt>.
! Also, if the '<tt>~</tt>' (tilde) character is the first character of the
  pathname specified, it will be expanded to the value of the
  HOME environment variable.  Therefore, the following are
***************
*** 287,292 ****
  </li>
  <li><p>If you want to abort the installation, just enter the
! termination character.	For Unix systems, it is normally
! Ctrl-C; for Win32 systems, it is normally Ctrl-Z.
  </p>
  </li>
--- 335,340 ----
  </li>
  <li><p>If you want to abort the installation, just enter the
! termination character, typically &lt;Ctrl-C&gt; for Unix systems and
! &lt;Ctrl-Z&gt; for Win32 systems.
  </p>
  </li>
***************
*** 299,320 ****
  <p>Of course, you can install MHonArc the standard way under Perl 5:
  </p>
! <pre class="shell">
!   prompt&gt; <b>perl Makefile.PL</b>
!   prompt&gt; <b>make</b>
!   prompt&gt; <b>make install</b>
! </pre>
  <p>If you want to install in a specific directory, try:
  </p>
! <pre class="shell">
!   prompt&gt; <b>perl Makefile.PL PREFIX=<var>/tmp/myperl5</var></b>
!   prompt&gt; <b>make</b>
!   prompt&gt; <b>make install</b>
! </pre>
! 
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE</strong></td>
  <td width="100%"><p><b><tt>install.me</tt></b> is actually called "behind the scenes"
! in batch mode to install the files.
  </p>
  </td>
--- 347,369 ----
  <p>Of course, you can install MHonArc the standard way under Perl 5:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>perl Makefile.PL</b>
! prompt&gt; <b>make</b>
! prompt&gt; <b>make install</b>
! </pre></td></tr></table>
  <p>If you want to install in a specific directory, try:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>perl Makefile.PL PREFIX=<var>/tmp/myperl5</var></b>
! prompt&gt; <b>make</b>
! prompt&gt; <b>make install</b>
! </pre></td></tr></table>
! <p></p>
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p><b><tt>install.me</tt></b> is actually called "behind the scenes"
! in batch mode to install the files.  Therefore, more unusually invocations
! methods of <tt class="ishell"><b>perl Makefile.PL</b></tt> may not be supported.
  </p>
  </td>
***************
*** 330,336 ****
  files.  Hence, if the path location of the main programs is
  in your PATH, you should be able to invoke them like any other
! program.  Note, the path to the perl executable must be in
  your PATH, also.
  </p>
  </li>
  <li><p>The main programs will also be copied to "<tt>.pl</tt>" files.
--- 379,393 ----
  files.  Hence, if the path location of the main programs is
  in your PATH, you should be able to invoke them like any other
! program.
! </p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>The path to the perl executable must be in
  your PATH, also.
  </p>
+ </td>
+ </tr>
+ </table>
  </li>
  <li><p>The main programs will also be copied to "<tt>.pl</tt>" files.
***************
*** 338,358 ****
  can invoke the programs directly (if the path location of the
  main programs are in your search path).  For example:
- </p><pre class="shell">
-   prompt&gt; <b>mhonarc.pl ...</b>
- </pre>
- <p>This is known to work under WinNT and under the Cygwin bash shell.
- </p>
- <p>This is better than going though the batch file mechanism since
- I/O redirection does not work when invoking a batch file.
- </p>
- </li>
- <li><p>In the <b><tt>logo</tt></b> directory of the distribution is a BMP file
- <b><tt>mhaicon.bmp</tt></b>.  You can copy the image into your Windows Icon
- directory.  Then through the file types editor of the file
- explorer, you can specify <b><tt>mhaicon.bmp</tt></b> as the icon for MHonArc
- resource (<b><tt>.mrc</tt></b>) files.
  </p>
! <p>This method of associating the icon to MHonArc resource files
! is known to work with Win9x systems.
  </li>
  </ul>
--- 395,413 ----
  can invoke the programs directly (if the path location of the
  main programs are in your search path).  For example:
  </p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mhonarc.pl ...</b>
! </pre></td></tr></table>
! <p>This is known to work under WinNT's command shell
! and under the Cygwin bash shell.
! </p>
! <p>This is better than using the batch files since
! I/O redirection does not work with batch files.
! </p>
! </li>
! <li><p>In the <b><tt>logo</tt></b> directory of the distribution contain
! <b><tt>.ico</tt></b> files for associating the MHonArc logo
! with MHonArc <b><tt>.mrc</tt></b> resource files.
! </p>
  </li>
  </ul>
***************
*** 362,366 ****
  <h2><a name="altos">Alternate Operating Systems</a></h2>
  
! <p>In many cases, the <tt>install.me</tt> program will work for other operating
  systems.  Please contact the author on any success stories for
  other operating systems, and please send any patches, if required.
--- 417,421 ----
  <h2><a name="altos">Alternate Operating Systems</a></h2>
  
! <p>In many cases, <tt>install.me</tt> works for other operating
  systems.  Please contact the author on any success stories for
  other operating systems, and please send any patches, if required.
***************
*** 371,376 ****
  <h2><a name="manual">Manual Installation</a></h2>
  
! <p>If <tt>install.me</tt> will not work properly for your system, here are the
! steps to install MHonArc manually:
  </p>
  <ul>
--- 426,431 ----
  <h2><a name="manual">Manual Installation</a></h2>
  
! <p>If <tt>install.me</tt> does not work for your system, here is how
! to install MHonArc manually:
  </p>
  <ul>
***************
*** 381,406 ****
  </li>
  <li><p>Copy the program files to the location you want them
! installed.  After copying, you must edit the each file
! as follows:
  </p>
  <ul>
! <li><p>Edit the "<tt>#!/...</tt>" line (the first line of each file)
! to be the complete pathname of your perl interpreter.
! Note, this step is only required for systems (Unix)
! that support "<tt>#!</tt>".
! </p>
! </li>
! <li><p>Add a new line right after the "<tt>#!/...</tt>" line to
! contain the following:
! </p><pre class="code">
!   use lib '/path/to/lib/files';
! </pre>
! <p>where "<tt>/path/to/lib/files/</tt>" is the path to where
! copied the library files to.
! </p>
! <p>Note, if the location you copied the libraries are
! already part of Perl's standard library search path,
! you do not need to add the "use lib" statement.
  </p>
  </li>
  </ul>
--- 436,482 ----
  </li>
  <li><p>Copy the program files to the location you want them
! installed.  After copying, do the following:
  </p>
  <ul>
! <li><p>Edit the "<tt class="icode">#!/...</tt>" line for each program
! file to reference the complete pathname of your perl interpreter.  The
! line should be the first line of each program file.
! </p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! This step is only needed for systems (Unix)
! that support "<tt class="icode">#!</tt>".
! </p>
! </td>
! </tr>
! </table>
! <li><p>Then do one of the following:
  </p>
+     <ul>
+     <li><p>Add a new line right after the "<tt class="icode">#!/...</tt>"
+ 	line of each program file to contain the following:
+ 	</p><pre class="code">
+   use lib '/path/to/lib/files';</pre>
+ 	<p>where "<tt class="icode">/path/to/lib/files/</tt>" is the
+ 	path to where copied the library files to.
+ 	</p>
+ 	<table class="note" width="100%">
+ 	<tr valign="baseline">
+ 	<td><strong>NOTE:</strong></td>
+ 	<td width="100%"><p>If the location you copied the libraries are
+ 	already part of Perl's standard library search path,
+ 	you do not need to add the "use lib" statement.
+ 	</p>
+ 	</td>
+ 	</tr>
+ 	</table>
+ 	</li>
+     <li><p><strong>Or</strong>, set your <b><tt>PERL5LIB</tt></b> environment
+ 	to include the path location you copied the library files to.
+ 	</p>
+ 	</li>
+     </ul>
  </li>
  </ul>
***************
*** 429,433 ****
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>It is advisable to create some local documentation for
  users describing
--- 505,509 ----
  <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>It is advisable to create some local documentation for
  users describing

Index: intro.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/intro.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** intro.html	20 Nov 2002 23:53:07 -0000	1.18
--- intro.html	24 Nov 2002 04:18:35 -0000	1.19
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 20,26 ****
  <li><a href="#whatis">What is MHonArc?</a>
  <li><a href="#whyuse">Why Use MHonArc?</a>
- <li><a href="#platforms">Supported Platforms</a>
  <li><a href="#availability">Availability</a>
  <li><a href="#license">License</a>
  </ul>
  <!--X-TOC-End-->
--- 19,26 ----
  <li><a href="#whatis">What is MHonArc?</a>
  <li><a href="#whyuse">Why Use MHonArc?</a>
  <li><a href="#availability">Availability</a>
  <li><a href="#license">License</a>
+ <li><a href="#help">Where to Get Help?</a>
+ <li><a href="#nomenclature">Documentation Nomenclature</a>
  </ul>
  <!--X-TOC-End-->
***************
*** 29,36 ****
  <H2><a name="whatis">What is MHonArc?</a></H2>
  
! <P>MHonArc is a <A HREF="http://perl.com/perl/";>Perl</A>
! program for converting e-mail messages as specified in RFC 822 and
! <A HREF="http://www.pobox.com/~ehood/MIME/MIME.html";>the
! MIME standard</A> to <A
  HREF="http://www.w3.org/pub/WWW/MarkUp/";>HTML</A>.
  MHonArc can perform the following tasks: </P>
--- 29,35 ----
  <H2><a name="whatis">What is MHonArc?</a></H2>
  
! <P>MHonArc is a highly customizable <A HREF="http://perl.com/perl/";>Perl</A>
! program for converting mail messages as specified in RFC 822 and
! <A HREF="http://www.mhonarc.org/~ehood/MIME/";>the MIME standard</A> to <A
  HREF="http://www.w3.org/pub/WWW/MarkUp/";>HTML</A>.
  MHonArc can perform the following tasks: </P>
***************
*** 81,84 ****
--- 80,85 ----
  on any platform that Perl has been ported to.
  
+ <li>MHonArc is <a href="#license">free software</a>.
+ 
  <LI>You think the MHonArc logo is really cool, and it deserves
  to be used.
***************
*** 90,104 ****
  
  <hr>
- <H2><a name="platforms">Supported Platforms</a></H2>
- 
- <P>See <a href="install.html#sysreqs"><cite>System Requirements</cite></a>
- of <a href="install.html"><cite>Installation</cite></a>.
- </P>
- 
- <hr>
  <H2><a name="availability">Availability</a></H2>
  
! <P>The latest information on MHonArc, where to get more help,
! and its availability, may be obtained at
  <A HREF="http://www.mhonarc.org/";>&lt;http://www.mhonarc.org/&gt;</A>.
  </P>
--- 91,98 ----
  
  <hr>
  <H2><a name="availability">Availability</a></H2>
  
! <P>The latest information about MHonArc, including its
! its availability, may be obtained at
  <A HREF="http://www.mhonarc.org/";>&lt;http://www.mhonarc.org/&gt;</A>.
  </P>
***************
*** 108,112 ****
  
  <table class="tip" width="100%"><tr><td>
! <p>This program is free software; you can redistribute it and/or modify
  it under the terms of the
  <a href="COPYING">GNU General Public License</a> as published by
--- 102,106 ----
  
  <table class="tip" width="100%"><tr><td>
! <p><strong>MHonArc</strong> is free software; you can redistribute it and/or modify
  it under the terms of the
  <a href="COPYING">GNU General Public License</a> as published by
***************
*** 120,123 ****
--- 114,195 ----
  </p>
  </td></tr></table>
+ <p> </p>
+ <table class="caution" width="100%">
+ <tr valign="baseline">
+ <td><strong style="color: red;">WARNING:</strong></td>
+ <td width="100%"><p>MHonArc is <strong>NOT</strong> in the public
+ domain, applicable copyrights still apply.
+ Using MHonArc that is inconsistent with the
+ <a href="COPYING">licensing terms</a> is a <b>violation</b>
+ of copyright law.
+ </p>
+ <p>If you cannot agree with the
+ <a href="COPYING">licensing terms</a> and would like to use <b>MHonArc</b>
+ under a different license, contact
+ <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org">mhonarc(_at_)mhonarc(_dot_)org</a>.
+ </p>
+ </td>
+ </tr>
+ </table>
+ 
+ <!-- ====================================================================== -->
+ <hr>
+ <h2><a name="help">Where to Get Help?</a></h2>
+ 
+ <ol>
+ <li><p>Read <a href="mhonarc.html">this documentation</a>.
+     </p></li>
+ <li><p>Read the <a href="faq/faq.html">FAQ</a>.
+     </p></li>
+ <li><p>Subscribe and post to one of the mailing lists described
+     in the <a href="contacts.html"><cite>Contacts</cite></a> section.
+     <a href="http://www.mhonarc.org/archive/html";>Searchable archives</a>
+     of the lists exist which provides a historical collection of helpful
+     information.
+     </p>
+ </ol>
+ 
+ <p>If you require professional help or consulting, you can contact
+ <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org">mhonarc(_at_)mhonarc(_dot_)org</a> with
+ your request.
+ </p>
+ 
+ <!-- ====================================================================== -->
+ <hr>
+ <h2><a name="nomenclature">Documentation Nomenclature</a></h2>
+ 
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><strong>NOTE:</strong></td>
+ <td width="100%"><p>Some rendering style semantics may not be available
+ if viewing this documentation with a text-based
+ and/or a non-CSS capable browser.
+ </p>
+ </td>
+ </tr>
+ </table>
+ 
+ <p>Shell examples are rendered as follows:</p>
+ <table border=1 width="100%"><tr><td><pre class="shell">
+ prompt&gt; <b>ls -CF</b>
+ ACKNOWLG  contrib/  etc/       INSTALL      Makefile.PL     mha-decode*  TODO
+ admin/    COPYING   examples/  install.me*  man/            mhonarc*
+ BUGS      dev.mk    extras/    lib/         mha-dbedit*     README
+ CHANGES   doc/      FILELIST   logo/        mha-dbrecover*  RELNOTES
+ </pre></td></tr></table>
+ 
+ <p>The text <tt class="ishell">prompt&gt;</tt> represents your
+ shell prompt.  Text you would type into the shell is rendered like this:
+ <tt class="ishell"><b>text&nbsp;you&nbsp;enter</b></tt>.  Any other
+ text is example output generated by the computer.  </p>
+ 
+ <p>Code examples are rendered as follows:</p>
+ <pre class="code">
+ <b>&lt;DefineVar&gt;</b>
+ MY-FOOTER-LINK
+ &lt;hr&gt;
+ Please visit &lt;a href="http://www.mhonarc.org"&gt;www.mhonarc.org&lt;/a&gt;.
+ <b>&lt;/DefineVar&gt;</b>
+ </pre>
  
  <hr>
***************
*** 135,139 ****
  <a href="http://www.mhonarc.org/";
  ><strong>MHonArc</strong></a><br>
! Copyright &#169; 1997-2000, <a href="http://www.mhonarc.org/~ehood/";
  >Earl Hood</a>, <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org"
  >mhonarc(_at_)mhonarc(_dot_)org</a><br>
--- 207,211 ----
  <a href="http://www.mhonarc.org/";
  ><strong>MHonArc</strong></a><br>
! Copyright &#169; 1997-2002, <a href="http://www.mhonarc.org/~ehood/";
  >Earl Hood</a>, <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org"
  >mhonarc(_at_)mhonarc(_dot_)org</a><br>

Index: layout.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/layout.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -C2 -r1.21 -r1.22
*** layout.html	20 Nov 2002 23:53:07 -0000	1.21
--- layout.html	24 Nov 2002 04:18:35 -0000	1.22
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 198,202 ****
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>If the <a href="resources/single.html">SINGLE</a> resource
  is set, <a href="resources/toplinks.html">TOPLINKS</a>
--- 197,201 ----
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>If the <a href="resources/single.html">SINGLE</a> resource
  is set, <a href="resources/toplinks.html">TOPLINKS</a>
***************
*** 239,243 ****
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>The line breaks above are used to show the sequence order of
  the resources and do not indicate any actual line breaks in the final
--- 238,242 ----
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>The line breaks above are used to show the sequence order of
  the resources and do not indicate any actual line breaks in the final
***************
*** 247,251 ****
  </tr>
  </table>
! 
  <h3><a name="msgbodylayout">Converted message body</a></h3>
  
--- 246,261 ----
  </tr>
  </table>
! <p> </p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>After a message is initially converted, the message
! header data is static.  Changes to resources that affect message header
! layout will only affect messages added after the changes have been
! applied.
! </p>
! </td>
! </tr>
! </table>
  <h3><a name="msgbodylayout">Converted message body</a></h3>
  
***************
*** 254,257 ****
--- 264,279 ----
  page for more information.
  </p>
+ 
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><strong>NOTE:</strong></td>
+ <td width="100%"><p>After a message is initially converted, the message
+ body data is static.  Changes to resources that affect message body
+ appearance will only affect messages added after the changes have been
+ applied.
+ </p>
+ </td>
+ </tr>
+ </table>
  
  <h3><a name="tslice">Thread slices</a></h3>

Index: mhonarc.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/mhonarc.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -C2 -r1.21 -r1.22
*** mhonarc.html	20 Nov 2002 23:53:07 -0000	1.21
--- mhonarc.html	24 Nov 2002 04:18:35 -0000	1.22
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 28,34 ****
  <li><a name="whatis" href="intro.html#whatis">What is MHonArc?</a></li>
  <li><a name="whyuse" href="intro.html#whyuse">Why Use MHonArc?</a></li>
- <li><a name="platforms" href="intro.html#platforms">Supported Platforms</a></li>
  <li><a name="availability" href="intro.html#availability">Availability</a></li>
  <li><a name="license" href="intro.html#license">License</a></li>
  </ul>
  </ul>
--- 27,34 ----
  <li><a name="whatis" href="intro.html#whatis">What is MHonArc?</a></li>
  <li><a name="whyuse" href="intro.html#whyuse">Why Use MHonArc?</a></li>
  <li><a name="availability" href="intro.html#availability">Availability</a></li>
  <li><a name="license" href="intro.html#license">License</a></li>
+ <li><a name="help" href="intro.html#help">Where to Get Help?</a></li>
+ <li><a name="nomenclature" href="intro.html#nomenclature">Documentation Nomenclature</a></li>
  </ul>
  </ul>
***************
*** 43,46 ****
--- 43,47 ----
  <li><a name="installation" href="install.html">Installation</a>
  <ul>
+ <li><a name="impatient" href="install.html#impatient">For the Impatient</a></li>
  <li><a name="sysreqs" href="install.html#sysreqs">System Requirements</a></li>
  <li><a name="download" href="install.html#download">Downloading MHonArc</a></li>

Index: quickstart.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/quickstart.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -r1.16 -r1.17
*** quickstart.html	20 Nov 2002 23:53:07 -0000	1.16
--- quickstart.html	24 Nov 2002 04:18:35 -0000	1.17
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <HTML>
  <HEAD>
--- 1,2 ----
***************
*** 16,20 ****
  <H1><a name="quickstart">Quick Start</a></H1>
  
! <P>This section will give you a "<EM>quick start</EM>" on using
  MHonArc.
  </P>
--- 15,19 ----
  <H1><a name="quickstart">Quick Start</a></H1>
  
! <P>This section gives you a "<EM>quick start</EM>" on using
  MHonArc.
  </P>
***************
*** 31,76 ****
  <H2><a name="folders">Converting mail</a></H2>
  
! <P>Since MHonArc supports <EM>MH</EM> mail folders and
! UUCP/Unix mailbox files, the term "<EM>mail folder</EM>" will represent
! the <EM>MH</EM> mail folder or mailbox file you want to process.
! To convert your mail folder to an HTML archive, use the following:
  </P>
  
! <pre class="shell">
  prompt&gt; <b>mhonarc </b><VAR>path</VAR><b>/inbox</b>
! </pre>
  
! <P>Where <VAR>path</VAR> represents the path to the directory
! that contains the mail folder <EM>inbox</EM>. If you are in the
! directory that contains inbox, then you can leave out the
  "<VAR>path</VAR><tt>/</tt>".
  </P>
  
! <P>You may specify more than one mail folder
! to process on the command-line:  </P>
  
! <pre class="shell">
  prompt&gt; <b>mhonarc </b><VAR>path</VAR><b>/inbox1</b> <VAR>path</VAR><b>/inbox2</b> ...
! </pre>
  
! <p>You may also specify standard input, "<b><tt>-</tt></b>",
! as the source of mail folder.
! This is useful if want to use MHonArc in a pipe:
  </p>
  
! <pre class="shell">
  prompt&gt; <b>mhonarc -- - </b><VAR>path</VAR><b>/inbox</b>
! </pre>
  
  <p>The "<b><tt>--</tt></b>" (two hyphens) is required to terminate
! command-line option parsing so "<b><tt>-</tt></b>" will not be
  treated as the start of an option.  The example also illustrates
! that you can still specify regular mail folders with standard
! input.  In this example, MHonArc will process standard input and
  then <tt><VAR>path</VAR>/inbox</tt>.
  </p>
  
! <P>When MHonArc finishes, the following
! files will be created: </P>
  
  <UL>
--- 30,83 ----
  <H2><a name="folders">Converting mail</a></H2>
  
! <P>MHonArc supports <EM>MH</EM> mail folders and
! UUCP/Unix mailbox files, so the term "<EM>mail folder</EM>" represents
! the <EM>MH</EM> mail folder or mailbox file to process.
! To convert a mail folder to an HTML archive, use the following:
  </P>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc </b><VAR>path</VAR><b>/inbox</b>
! </pre></td></tr></table>
  
! <P>Where <VAR>path</VAR> represents the directory path
! containing the mail folder <EM>inbox</EM>. If you are in the
! directory that contains inbox, you can leave out the
  "<VAR>path</VAR><tt>/</tt>".
  </P>
  
! <p>You can specify multiple mail folders to process:</p>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc </b><VAR>path</VAR><b>/inbox1</b> <VAR>path</VAR><b>/inbox2</b> ...
! </pre></td></tr></table>
  
! <p>You can also specify standard input, "<b><tt>-</tt></b>",
! as the source of mail folder:
  </p>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc -- - </b><VAR>path</VAR><b>/inbox</b>
! </pre></td></tr></table>
  
  <p>The "<b><tt>--</tt></b>" (two hyphens) is required to terminate
! command-line option parsing so "<b><tt>-</tt></b>" is not
  treated as the start of an option.  The example also illustrates
! that you can specify regular mail folders along with standard
! input.  In this example, MHonArc processes standard input and
  then <tt><VAR>path</VAR>/inbox</tt>.
  </p>
  
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>Mail folder data read in from standard input
! <strong>must</strong> be in UUCP-style mailbox format.
! </p>
! </td>
! </tr>
! </table>
! 
! <P>MHonArc creates the following files after processing the mail folders:
! </P>
  
  <UL>
***************
*** 91,116 ****
  
  <LI><P><tt><strong>.mhonarc.db</strong></tt>
! (or <tt>MHONARC.DB</tt> under Windows):
! This database file is 
! needed inorder for MHonArc to perform additions of new mail messages 
! to the archive. Information is stored to perform mail threading updates 
! when new messages are added, as well as any defined
! <a href="resources.html">resources</a>.
  </P>
  
! <LI><P><EM>Other</EM>: Depending on the content-types of the e-mail
! messages converted, other files may be created for images, videos,
! binaries, etc.
  </P>
  
  </UL>
  
! <p>The actual filenames may differ depending on the settings
! of various <a href="resources.html">resources</a>.
! </p>
! 
! <P>All the files created will be put into the current
! working directory, by default. You can control the
! destination of the output location by using the
  <a href="resources/outdir.html"><strong><tt>-outdir</tt></strong></a>
  option.  </P>
--- 98,116 ----
  
  <LI><P><tt><strong>.mhonarc.db</strong></tt>
! (or <tt>mhonarc.db</tt> under Windows):
! This database file contains archive information and
! <a href="resources.html">resource</a>
! settings for MHonArc to perform further updates.
  </P>
  
! <LI><P><EM>Other</EM>: If messages contain attachments, other files
! may be created for images, videos, binaries, etc.
  </P>
  
  </UL>
  
! <P>By default, all files created are put into the current
! working directory. You can control the location of archive files
! by using the
  <a href="resources/outdir.html"><strong><tt>-outdir</tt></strong></a>
  option.  </P>
***************
*** 118,133 ****
  <P><STRONG>Example</STRONG></P>
  
! <PRE class="shell">
  prompt&gt; <b>mhonarc -outdir /home/ehood/htmlarchive /home/ehood/mail/inbox</b>
! </PRE>
  
  <P>Here is a sample session converting a mail folder:
  </P>
  
! <PRE class="shell">
  prompt&gt; <b>mhonarc ~/mail/inbox</b>
  This is MHonArc v2.6.0, Perl 5.006001 linux
  Converting messages to .
! Reading /mnt/ehood/mail/inbox ..........
  Writing mail ...
  Writing ./maillist.html ...
--- 118,133 ----
  <P><STRONG>Example</STRONG></P>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc -outdir /home/ehood/htmlarchive /home/ehood/mail/inbox</b>
! </pre></td></tr></table>
  
  <P>Here is a sample session converting a mail folder:
  </P>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc ~/mail/inbox</b>
  This is MHonArc v2.6.0, Perl 5.006001 linux
  Converting messages to .
! Reading /home/ehood/mail/inbox ..........
  Writing mail ...
  Writing ./maillist.html ...
***************
*** 135,139 ****
  Writing database ...
  10 messages
! </PRE>
  
  <p>By default, MHonArc prints out information about its progress.
--- 135,139 ----
  Writing database ...
  10 messages
! </pre></td></tr></table>
  
  <p>By default, MHonArc prints out information about its progress.
***************
*** 147,151 ****
  
  <P>If you have new messages you want to add to an existing archive,
! you must utilizing the
  <a href="resources/add.html"><strong><tt>-add</tt></strong></a>
  command-line option. With the
--- 147,151 ----
  
  <P>If you have new messages you want to add to an existing archive,
! you must utilize the
  <a href="resources/add.html"><strong><tt>-add</tt></strong></a>
  command-line option. With the
***************
*** 154,161 ****
  
  <UL>
! <LI><P>Add a mail folder to an archive, or
! </P>
! <LI><P>Add a single message to an archive.
! </P>
  </UL>
  
--- 154,159 ----
  
  <UL>
! <LI>Add mail folders, or
! <LI>Add a single message.
  </UL>
  
***************
*** 163,172 ****
  can be done like the following: </P>
  
! <PRE class="shell">
  prompt&gt; <b>mhonarc -add </b><VAR>&lt;path&gt;</VAR><b>/mailfolder</b>
! </PRE>
  
  <P>If you are not in the same directory as the archive, then you
! can specify the location of the archive to add to with the
  <a href="resources/outdir.html"><strong><tt>-outdir</tt></strong></a>
  option. </P>
--- 161,170 ----
  can be done like the following: </P>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc -add </b><VAR>&lt;path&gt;</VAR><b>/mailfolder</b>
! </pre></td></tr></table>
  
  <P>If you are not in the same directory as the archive, then you
! can specify the location of the archive with the
  <a href="resources/outdir.html"><strong><tt>-outdir</tt></strong></a>
  option. </P>
***************
*** 174,181 ****
  <table class="note"  width="100%">
  <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td width="100%"><P>MHonArc will skip any messages that already exist in
! the archive.  Therefore, MHonArc can be used to rescan the
! same mail folder and only convert any new messages it finds.
  </P>
  </td>
--- 172,179 ----
  <table class="note"  width="100%">
  <tr valign=top>
! <td><strong>NOTE:</strong></td>
! <td width="100%"><P>MHonArc skips any messages that already exist in
! the archive.  Therefore, MHonArc can be used to rescan a
! mail folder to auto-find any new messages to add.
  </P>
  </td>
***************
*** 183,223 ****
  </table>
  
! <P>If no mail folder arguments are specified, then MHonArc
! will attempt to add a <EM>single</EM> message read in from standard
  input.  </P>
  
  <P><STRONG>Example</STRONG></P>
  
! <PRE class="shell">
  prompt&gt; <b>mhonarc -add &lt; single.msg</b> 
! </PRE>
  <P>Or, from a pipe:
  </P>
! <PRE class="shell">
  prompt&gt; <b>cat single.msg | mhonarc -add</b> 
! </PRE>
  
  <hr>
  <H2><a name="single">Converting a single message</a></H2>
  
! <P>MHonArc has the ability to process a single
! mail message independent of creating, or modifying, an
! archive. To convert a single message to HTML use the
  <a href="resources/single.html"><strong><tt>-single</tt></strong></a>
! command-line
! option. The message to process can be specified by a filename on the
! command-line, or by reading the message from standard input if no file
! is specified. The filtered message is sent to standard output. All
! formatting options apply to the single message as with messages
! being processed for an archive, with the exception of formatting
! related specificly to archive processing, like index links and mail
! thread links.  </P>
  
  <p><STRONG>Examples</STRONG></p>
  
  <p>Input from standard input:</p>
! <PRE class="shell">prompt&gt; <b>mhonarc -single &lt; messagefile &gt; file.html</b></PRE> 
  <p>Filename on command-line:</p>
! <PRE class="shell">prompt&gt; <b>mhonarc -single messagefile &gt; file.html</b></PRE> 
  
  <hr>
--- 181,222 ----
  </table>
  
! <P>If no mail folders are specified, MHonArc
! attempts to add a <EM>single</EM> message read in from standard
  input.  </P>
  
  <P><STRONG>Example</STRONG></P>
  
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>mhonarc -add &lt; single.msg</b> 
! </pre></td></tr></table>
  <P>Or, from a pipe:
  </P>
! <table border=1 width="100%"><tr><td><pre class="shell">
  prompt&gt; <b>cat single.msg | mhonarc -add</b> 
! </pre></td></tr></table>
  
  <hr>
  <H2><a name="single">Converting a single message</a></H2>
  
! <P>MHonArc converts a single
! mail message, independent of creating or modifying an
! archive, if the
  <a href="resources/single.html"><strong><tt>-single</tt></strong></a>
! option is specified.
! The message to process is specified by filename,
! or piped in from standard input.
! The resulting HTML is sent to standard output.
! </P>
  
  <p><STRONG>Examples</STRONG></p>
  
  <p>Input from standard input:</p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mhonarc -single &lt; messagefile &gt; file.html</b>
! </pre></td></tr></table>
  <p>Filename on command-line:</p>
! <table border=1 width="100%"><tr><td><pre class="shell">
! prompt&gt; <b>mhonarc -single messagefile &gt; file.html</b>
! </pre></td></tr></table>
  
  <hr>

Index: rcvars.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/rcvars.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -C2 -r1.21 -r1.22
*** rcvars.html	20 Nov 2002 23:53:07 -0000	1.21
--- rcvars.html	24 Nov 2002 04:18:35 -0000	1.22
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <html>
  <head>
--- 1,2 ----
***************
*** 67,73 ****
  <tt>$SUBJECT$</tt> will get expanded to the current message's
  subject<SUP><a href="#note1">[*]</a></SUP>.
! With the "<tt>NEXT</tt>" argument,
  we are instructing MHonArc to use the <em>next</em> message's
! subject.  <tt>$MSG(NEXT)$</tt> will get expanded to the next message's
  filename.  Therefore, the above resource value is creating a link to
  the next message in the archive.
--- 66,72 ----
  <tt>$SUBJECT$</tt> will get expanded to the current message's
  subject<SUP><a href="#note1">[*]</a></SUP>.
! With the "<tt class="icode">NEXT</tt>" argument,
  we are instructing MHonArc to use the <em>next</em> message's
! subject.  <tt class="icode">$MSG(NEXT)$</tt> will get expanded to the next message's
  filename.  Therefore, the above resource value is creating a link to
  the next message in the archive.
***************
*** 76,80 ****
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong><a name="note1">*</a>&nbsp;NOTE</strong></td>
  <td width="100%"><p>In the two examples given, the replacement value of
  <tt>$SUBJECT$</tt> is different (excluding the variable argument difference).
--- 75,79 ----
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong><a name="note1">*</a>&nbsp;NOTE:</strong></td>
  <td width="100%"><p>In the two examples given, the replacement value of
  <tt>$SUBJECT$</tt> is different (excluding the variable argument difference).
***************
*** 138,142 ****
      <table class="note" width="100%">
      <tr valign=top>
!     <td><strong>NOTE</strong></td>
      <td width="100%">Not all resource variables support clipping.
  	If a length specification is given for these variables, then
--- 137,141 ----
      <table class="note" width="100%">
      <tr valign=top>
!     <td><strong>NOTE:</strong></td>
      <td width="100%">Not all resource variables support clipping.
  	If a length specification is given for these variables, then
***************
*** 174,178 ****
  a semi-colon.  For example: <tt class="icode">$MSGLOCALDATE(NEXT;%H:%M)$</tt>.
  In the example, there are two arguments to the <tt>$MSGLOCALDATE$</tt>
! variable: "<tt>NEXT</tt>" and "<tt>%H:%M</tt>".
  </dd>
  
--- 173,177 ----
  a semi-colon.  For example: <tt class="icode">$MSGLOCALDATE(NEXT;%H:%M)$</tt>.
  In the example, there are two arguments to the <tt>$MSGLOCALDATE$</tt>
! variable: "<tt class="icode">NEXT</tt>" and "<tt class="icode">%H:%M</tt>".
  </dd>
  
***************
*** 184,194 ****
  
  <p>If an unrecognized variable is encountered, it gets replaced with an
! empty string, and a warning is generated. If a literal "<tt>$</tt>"
! is needed, use "<tt>$$</tt>".
  </p>
  
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>The
  <a href="resources/mailtourl.html">MAILTOURL</a>
--- 183,193 ----
  
  <p>If an unrecognized variable is encountered, it gets replaced with an
! empty string, and a warning is generated. If a literal "<tt class="icode">$</tt>"
! is needed, use "<tt class="icode">$$</tt>".
  </p>
  
  <table class="note" width="100%">
  <tr valign=top>
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>The
  <a href="resources/mailtourl.html">MAILTOURL</a>
***************
*** 201,205 ****
  <p>Also,
  variables in the MAILTOURL should <STRONG>NOT</STRONG>
! have "<tt>:<i>N</i>UJ</tt>" modifiers. This will prevent the
  variables from being recognized. MHonArc will automatically
  treat the replacement value as a part of a URL string.
--- 200,204 ----
  <p>Also,
  variables in the MAILTOURL should <STRONG>NOT</STRONG>
! have "<tt class="icode">:<i>N</i>UJ</tt>" modifiers. This will prevent the
  variables from being recognized. MHonArc will automatically
  treat the replacement value as a part of a URL string.
***************
*** 367,371 ****
  The <tt>NAME</tt> attribute provides a destination location when a message
  links to the index page.  This resource variable is equivalent to
! "<nobr><tt><a href="#A_NAME">$A_NAME$</a>&nbsp;<a href="#A_HREF">$A_HREF$</a></tt></nobr>".
  </td>
  </tr>
--- 366,370 ----
  The <tt>NAME</tt> attribute provides a destination location when a message
  links to the index page.  This resource variable is equivalent to
! "<nobr><tt class="icode"><a href="#A_NAME">$A_NAME$</a>&nbsp;<a href="#A_HREF">$A_HREF$</a></tt></nobr>".
  </td>
  </tr>
***************
*** 382,386 ****
  archived message.
  This variable is equivalent to
! "<tt>href="<a href="#MSG">$MSG$</a>"</tt>".
  </td>
  </tr>
--- 381,385 ----
  archived message.
  This variable is equivalent to
! "<tt class="icode">href="<a href="#MSG">$MSG$</a>"</tt>".
  </td>
  </tr>
***************
*** 397,401 ****
  to the index page.
  This variable is equivalent to
! "<tt>name="<a href="#MSGNUM">$MSGNUM$</a>"</tt>".
  </td>
  </tr>
--- 396,400 ----
  to the index page.
  This variable is equivalent to
! "<tt class="icode">name="<a href="#MSGNUM">$MSGNUM$</a>"</tt>".
  </td>
  </tr>
***************
*** 474,478 ****
  <td align=right><b>Description:</b></td>
  <td>The value of the environment variable specified by <i>variable_name</i>.
! For example, <tt>$ENV(HOME)$</tt> would expand to the value of the
  HOME environment variable.</td>
  </tr>
--- 473,477 ----
  <td align=right><b>Description:</b></td>
  <td>The value of the environment variable specified by <i>variable_name</i>.
! For example, <tt class="icode">$ENV(HOME)$</tt> would expand to the value of the
  HOME environment variable.</td>
  </tr>
***************
*** 509,513 ****
  <td align=right><b>Description:</b></td>
  <td>The username/local-part of the mail address in the <tt>From:</tt>
! field of the message.  For example, given the address "someuser(_at_)mhonarc(_dot_)org",
  <tt>$FROMADDRNAME$</tt> would equal "someuser".</td>
  </tr>
--- 508,512 ----
  <td align=right><b>Description:</b></td>
  <td>The username/local-part of the mail address in the <tt>From:</tt>
! field of the message.  For example, given the address "someuser(_at_)example(_dot_)com",
  <tt>$FROMADDRNAME$</tt> would equal "someuser".</td>
  </tr>
***************
*** 972,976 ****
  current page to create links to.  If either number argument is prefixed
  with a '<tt><b>T</b></tt>', then the list of links apply to the thread index.
! Examples: <tt>$PGLINKLIST(3;3)$</tt>, <tt>$PGLINKLIST(T2;T3)$</tt>.  The
  link text for to a give page is the page number.
  </p>
--- 971,975 ----
  current page to create links to.  If either number argument is prefixed
  with a '<tt><b>T</b></tt>', then the list of links apply to the thread index.
! Examples: <tt class="icode">$PGLINKLIST(3;3)$</tt>, <tt class="icode">$PGLINKLIST(T2;T3)$</tt>.  The
  link text for to a give page is the page number.
  </p>
***************
*** 1006,1010 ****
  the current message using the subject as the link text.  The
  no argument version is equivalent to:
! "<nobr><tt>&lt;a&nbsp;<a href="#A_ATTR">$A_ATTR$</a>&gt;<a href="#SUBJECTNA">$SUBJECTNA$</a>&lt;/a&gt;</tt></nobr>".
  </td>
  </tr>
--- 1005,1009 ----
  the current message using the subject as the link text.  The
  no argument version is equivalent to:
! "<nobr><tt class="icode">&lt;a&nbsp;<a href="#A_ATTR">$A_ATTR$</a>&gt;<a href="#SUBJECTNA">$SUBJECTNA$</a>&lt;/a&gt;</tt></nobr>".
  </td>
  </tr>
***************
*** 1112,1116 ****
  <td align=right><b>Description:</b></td>
  <td>The username/local-part of the e-mail address.
! For example, given the address "someuser(_at_)mhonarc(_dot_)org",
  <tt>$TOADDRNAME$</tt> would equal "someuser".
  This variable is only applicable for use in the
--- 1111,1115 ----
  <td align=right><b>Description:</b></td>
  <td>The username/local-part of the e-mail address.
! For example, given the address "someuser(_at_)example(_dot_)com",
  <tt>$TOADDRNAME$</tt> would equal "someuser".
  This variable is only applicable for use in the
***************
*** 1127,1132 ****
  <td align=right><b>Description:</b></td>
  <td>The domain part of the e-mail address.
! For example, given the address "someuser(_at_)mhonarc(_dot_)org",
! <tt>$TOADDRDOMAIN$</tt> would equal "mhonarc.org".
  This variable is only applicable for use in the
  <a href="resources/mailtourl.html">MAILTOURL</a>.</td>
--- 1126,1131 ----
  <td align=right><b>Description:</b></td>
  <td>The domain part of the e-mail address.
! For example, given the address "someuser(_at_)example(_dot_)com",
! <tt>$TOADDRDOMAIN$</tt> would equal "example.com".
  This variable is only applicable for use in the
  <a href="resources/mailtourl.html">MAILTOURL</a>.</td>

Index: relnotes.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/relnotes.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -r1.10 -r1.11
*** relnotes.html	20 Nov 2002 23:53:07 -0000	1.10
--- relnotes.html	24 Nov 2002 04:18:35 -0000	1.11
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <html>
  <head>
--- 1,2 ----
***************
*** 26,30 ****
  <table class="note" width="100%">
  <tr valign="top">
! <td><strong>NOTE</strong></td>
  <td width="100%"><p>
  Read the <tt>CHANGES</tt> document included in the distribution
--- 25,29 ----
  <table class="note" width="100%">
  <tr valign="top">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>
  Read the <tt>CHANGES</tt> document included in the distribution
***************
*** 126,138 ****
  
  <h3><a name="down">DOWNGRADING TO OLDER VERSIONS</a></h3>
!     
!     <p>Downgrading to an earlier version of MHonArc can be
!     dangerous, especially if downgrading to an older version that
      used different storage formats in archive database files from
      the current version in use.
      If an older version of MHonArc is
!     used to process an archive last updated by a new version, archive
      data can get lost and/or unexpected output can occur.
      </p>
      <p>Changes in archive format are not common, so downgrading
      can be okay depending on the versions involved.  The key versions
--- 125,144 ----
  
  <h3><a name="down">DOWNGRADING TO OLDER VERSIONS</a></h3>
! 
! <table class="caution" width="100%">
! <tr valign="baseline">
! <td><strong style="color: red;">CAUTION:</strong></td>
! <td width="100%"><p>Downgrading to an earlier version of MHonArc can be
!     <strong>dangerous</strong>, especially if downgrading to an older
!     version that
      used different storage formats in archive database files from
      the current version in use.
      If an older version of MHonArc is
!     used to process an archive last modified by a newer version, archive
      data can get lost and/or unexpected output can occur.
      </p>
+ </td>
+ </tr>
+ </table>
      <p>Changes in archive format are not common, so downgrading
      can be okay depending on the versions involved.  The key versions
***************
*** 156,165 ****
      downgraded to.
      </p>
!     <p>Of course, the safest way to downgrade is to recreate an archive
      from the original raw mail data.  It is good practice to preserve
!     the raw mail data in some form for cases like these and for
      general archive recovering situations due to file corruption or other
      system failures.
      </p>
  
  <!-- *************************************************************** -->
--- 162,178 ----
      downgraded to.
      </p>
! <table class="tip" width="100%">
! <tr valign="baseline">
! <td><strong>TIP:</strong></td>
! <td width="100%">
!     <p>The safest way to downgrade is to recreate an archive
      from the original raw mail data.  It is good practice to preserve
!     the raw mail data for cases like this and for
      general archive recovering situations due to file corruption or other
      system failures.
      </p>
+ </td>
+ </tr>
+ </table>
  
  <!-- *************************************************************** -->
***************
*** 170,184 ****
  
  <li><p>For v2.5, the default text/html filter (mhtxthtml.pl) will
!     now convert auto-loaded URL attributes to
!     '<tt class="icode">javascript:void(0);</tt>' for some HTML elements --
      <tt>IMG</tt>, <tt>BODY</tt>, <tt>IFRAME</tt>, <tt>FRAME</tt>,
      <tt>OBJECT</tt>, <tt>SCRIPT</tt>, <tt>INPUT</tt> -- except for cid:
!     URLs.    This behavior can be disabled if the '<tt>allownoncidurls</tt>'
      filter argument is specified.
      </p>
!     <p>The new behavior is to prevent malicious URLs that verify
      mail addresses for spam purposes, secretly set cookies, or
!     gather some statistical data automatically with the use of
!     elements that cause browsers to automatically fetch data.
      </p>
      </li>
--- 183,196 ----
  
  <li><p>For v2.5, the default text/html filter (mhtxthtml.pl) will
!     disable auto-loaded URL attributes for some HTML elements --
      <tt>IMG</tt>, <tt>BODY</tt>, <tt>IFRAME</tt>, <tt>FRAME</tt>,
      <tt>OBJECT</tt>, <tt>SCRIPT</tt>, <tt>INPUT</tt> -- except for cid:
!     URLs.  This behavior can be disabled if the '<tt>allownoncidurls</tt>'
      filter argument is specified.
      </p>
!     <p>The new behavior prevents malicious URLs used to verify
      mail addresses for spam purposes, secretly set cookies, or
!     gather some statistical data without the explicit consent of
!     the reader.
      </p>
      </li>
***************
*** 190,203 ****
      can run the following command,
      </p>
!     <pre class="shell">
  <a class="shell" href="app-utilsprg.html#mha-dbedit">mha-dbedit</a> -rcfile examples/<a class="shell" href="rcfileexs/def-mime.mrc.html">def-mime.mrc</a> \
! 	   -outdir /path/to/archive </pre>
      <p>where <tt class="ishell">examples/<a class="shell" href="rcfileexs/def-mime.mrc.html">def-mime.mrc</a></tt> represents the default MIME
      processing resources for MHonArc provided within the MHonArc
      distribution.
      </p>
!     <table width="100%">
      <tr valign="top">
!     <td><strong>NOTE</strong></td>
      <td width="100%"><p>v2.5.4, and later, generated archives will automatically
      inherit new
--- 202,215 ----
      can run the following command,
      </p>
!     <table border=1 width="100%"><tr><td><pre class="shell">
  <a class="shell" href="app-utilsprg.html#mha-dbedit">mha-dbedit</a> -rcfile examples/<a class="shell" href="rcfileexs/def-mime.mrc.html">def-mime.mrc</a> \
! 	   -outdir /path/to/archive</pre></td></tr></table>
      <p>where <tt class="ishell">examples/<a class="shell" href="rcfileexs/def-mime.mrc.html">def-mime.mrc</a></tt> represents the default MIME
      processing resources for MHonArc provided within the MHonArc
      distribution.
      </p>
!     <table class="note" width="100%">
      <tr valign="top">
!     <td><strong>NOTE:</strong></td>
      <td width="100%"><p>v2.5.4, and later, generated archives will automatically
      inherit new
***************
*** 268,276 ****
      in the examples directory.
      </p>
!     <table width="100%">
      <tr valign="top">
!     <td><strong>NOTE</strong></td>
      <td width="100%"><p>v2.5.4, and later, generated archives will automatically
!     inherit new MIMEFILTERS if the built-in defaults are being used.
      However, if you have defined MIMEFILTERS for your archives, you
      will need to explicitly update your archives if you want the new settings
--- 280,288 ----
      in the examples directory.
      </p>
!     <table class="note" width="100%">
      <tr valign="top">
!     <td><strong>NOTE:</strong></td>
      <td width="100%"><p>v2.5.4, and later, generated archives will automatically
!     inherit new <a href="resources/mimefilters.html">MIMEFILTERS</a> if the built-in defaults are being used.
      However, if you have defined MIMEFILTERS for your archives, you
      will need to explicitly update your archives if you want the new settings
***************
*** 282,288 ****
      <p>Example usage of <tt>mha-dbedit</tt>:
      </p>
!     <pre class="shell">
  mha-dbedit -rcfile examples/<a class="shell" href="rcfileexs/def-mime.mrc.html">def-mime.mrc</a> \
! 	   -outdir /path/to/archive </pre>
      <p>Change the <a href="resources/rcfile.html">-rcfile</a>
      and <a href="resources/outdir.html">-outdir</a> pathnames to reflect where
--- 294,300 ----
      <p>Example usage of <tt>mha-dbedit</tt>:
      </p>
!     <table border=1 width="100%"><tr><td><pre class="shell">
  mha-dbedit -rcfile examples/<a class="shell" href="rcfileexs/def-mime.mrc.html">def-mime.mrc</a> \
! 	   -outdir /path/to/archive</pre></td></tr></table>
      <p>Change the <a href="resources/rcfile.html">-rcfile</a>
      and <a href="resources/outdir.html">-outdir</a> pathnames to reflect where
***************
*** 317,321 ****
  <img align="top" src="monicon.png" alt="">
  <a href="http://www.mhonarc.org/";><strong>MHonArc</strong></a><br>
! Copyright &#169; 1997-2001, <a href="http://www.mhonarc.org/~ehood/";
  >Earl Hood</a>, <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org"
  >mhonarc(_at_)mhonarc(_dot_)org</a><br>
--- 329,333 ----
  <img align="top" src="monicon.png" alt="">
  <a href="http://www.mhonarc.org/";><strong>MHonArc</strong></a><br>
! Copyright &#169; 1997-2002, <a href="http://www.mhonarc.org/~ehood/";
  >Earl Hood</a>, <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org"
  >mhonarc(_at_)mhonarc(_dot_)org</a><br>

Index: resources.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/resources.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -C2 -r1.24 -r1.25
*** resources.html	20 Nov 2002 23:53:07 -0000	1.24
--- resources.html	24 Nov 2002 04:18:35 -0000	1.25
***************
*** 1,3 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
  <html>
  <head>
--- 1,2 ----

---------------------------------------------------------------------
To sign-off this list, send email to majordomo(_at_)mhonarc(_dot_)org with the
message text UNSUBSCRIBE MHONARC-DEV