mhonarc-commits
[Top] [All Lists]

CVS: mhonarc/MHonArc/doc/faq about.html,1.18,1.19 archives.html,1.20,1.21 g...

2003-01-02 21:32:41
Update of /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq
In directory subversions:/tmp/cvs-serv7879

Modified Files:
	about.html archives.html general.html indexpgs.html mime.html 
	msgpgs.html usage.html 
Log Message:
FAQ updates.


Index: about.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/about.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** about.html	18 Dec 2002 05:55:21 -0000	1.18
--- about.html	3 Jan 2003 04:32:32 -0000	1.19
***************
*** 84,88 ****
  </tr>
  <tr valign=top>
! <td align=right><strong><a href="http://ds.internic.net/ds/dspg1intdoc.html";>RFC</a></strong>
  <td><em>Request for Comments</em>: Notes about
  networking protocols, procedures, programs, and concepts of the Internet.
--- 84,88 ----
  </tr>
  <tr valign=top>
! <td align=right><strong>RFC</strong>
  <td><em>Request for Comments</em>: Notes about
  networking protocols, procedures, programs, and concepts of the Internet.
***************
*** 122,125 ****
--- 122,128 ----
  <p><a href="http://www.mhonarc.org/MHonArc/doc/faq/faq.html";
  >&lt;http://www.mhonarc.org/MHonArc/doc/faq/faq.html&gt;</a>
+ </p>
+ <p>A copy of the FAQ is also provided within the MHonArc
+ distribution.
  </p>
  

Index: archives.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/archives.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -C2 -r1.20 -r1.21
*** archives.html	18 Dec 2002 05:55:21 -0000	1.20
--- archives.html	3 Jan 2003 04:32:32 -0000	1.21
***************
*** 147,151 ****
  <a href="../resources/msgsep.html">MSGSEP</a>
  resource.  Therefore, the value of <tt>Content-Length</tt> can be less
! than the actual message size, and message extraction will probably
  work as expected.  However, if <tt>Content-Length</tt> for a message
  has a value that is larger than the actual size, MHonArc may include
--- 147,151 ----
  <a href="../resources/msgsep.html">MSGSEP</a>
  resource.  Therefore, the value of <tt>Content-Length</tt> can be less
! than the actual message size, and message extraction will
  work as expected.  However, if <tt>Content-Length</tt> for a message
  has a value that is larger than the actual size, MHonArc may include
***************
*** 213,218 ****
  
  <p>Many users use <b>Procmail</b>
! <a href="http://www.ii.com/internet/robots/procmail/";
! >&lt;http://www.ii.com/internet/robots/procmail/&gt;</a> to call MHonArc
  to archive messages.  Procmail provides the ability to preprocess
  mail as it arrives to do selective processing and automated tasks
--- 213,218 ----
  
  <p>Many users use <b>Procmail</b>
! <a href="http://www.procmail.org/";
! >&lt;http://www.procmail.org/&gt;</a> to call MHonArc
  to archive messages.  Procmail provides the ability to preprocess
  mail as it arrives to do selective processing and automated tasks
***************
*** 369,374 ****
  Or. you can use a tool like
  <b>Procmail</b>
! <a href="http://www.ii.com/internet/robots/procmail/";
! >&lt;http://www.ii.com/internet/robots/procmail/&gt;</a>.
  </p>
  
--- 369,374 ----
  Or. you can use a tool like
  <b>Procmail</b>
! <a href="http://www.procmail.org/";
! >&lt;http://www.procmail.org/&gt;</a>.
  </p>
  

Index: general.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/general.html,v
retrieving revision 1.32
retrieving revision 1.33
diff -C2 -r1.32 -r1.33
*** general.html	18 Dec 2002 05:55:21 -0000	1.32
--- general.html	3 Jan 2003 04:32:32 -0000	1.33
***************
*** 36,65 ****
  </td></tr></table>
  
! <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.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>
!  
! <UL>
! <LI>Convert <a href="http://www.ics.uci.edu/~mh/";><em>MH</em></a>
! mail folders or UUCP/Unix style mailboxes into an HTML mail archive.
! <LI>Add or remove messages to an existing HTML mail archive generated
! by MHonArc.
! <LI>Convert a single message to HTML.
! </UL>
! 
! <P>Along with these tasks, MHonArc provides the following:
! </P>
! 
! <UL>
! <LI>A main customizable index for mail messages archived.
! <LI>A customizable thread index listing messages by thread.
! <LI>Control over message formatting.
! <LI>The ability to hook in your own custom message filters.
! <LI>And other things to numerous to mention here.
! </UL>
! 
  
  <!-- ??????????????????????????????????????????????????????????????? -->
--- 36,47 ----
  </td></tr></table>
  
! <p>MHonArc is a <A HREF="http://perl.com/perl/";>Perl</A>
! program for converting mail or news messages
! into <A HREF="http://www.w3.org/pub/WWW/MarkUp/";>HTML</A>
! archives. It can also be used to convert individual
! messages into HTML documents. Other capabilities include robust
! <a href="http://www.mhonarc.org/~ehood/MIME/";>MIME</a>
! support and powerful user customization features.
! </p>
  
  <!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 101,105 ****
  
  <P>MHonArc is free software.  MHonArc is distributed under
! the GNU General Public License (GPL).  A copy of the license is included in
  the distribution.  Please read it for more information, or go
  to <a href="http://www.gnu.org/";>&lt;http://www.gnu.org/&gt;</a>.
--- 83,88 ----
  
  <P>MHonArc is free software.  MHonArc is distributed under
! the <a href="../COPYING">GNU General Public License</a> (GPL).
! A copy of the license is included in
  the distribution.  Please read it for more information, or go
  to <a href="http://www.gnu.org/";>&lt;http://www.gnu.org/&gt;</a>.
***************
*** 120,126 ****
  </p>
  
! <table class="note" width="100%">
  <tr valign="baseline">
! <td><strong><blink>NOTE:</blink></strong></td>
  <td width="100%"><p>MHonArc is <strong>NOT</strong>
  in the public domain.  Any mention of MHonArc in the public domain
--- 103,109 ----
  </p>
  
! <table class="caution" width="100%">
  <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
  <td width="100%"><p>MHonArc is <strong>NOT</strong>
  in the public domain.  Any mention of MHonArc in the public domain
***************
*** 153,198 ****
  and general help.  </P>
  
! <P>To subscribe to the mailing list, send mail to <A
! HREF="mailto:majordomo(_at_)mhonarc(_dot_)org"
! >majordomo(_at_)mhonarc(_dot_)org</A>
! with the command, </P>
! 
! <pre class="code">
! subscribe mhonarc-users</pre>
! 
! <P>as the message body.
! </P>
! 
! <P>If you send mail
! <A HREF="mailto:mhonarc-users(_at_)mhonarc(_dot_)org" >mhonarc-users(_at_)mhonarc(_dot_)org</A>,
! your message will be
! distributed to all subscribers on the list.  </P>
! 
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>The mailing list is restricted to subscribers only.  Any
! non-subscriber message sent to the list is manually filtered.
! Due to the nature
! of manual filtering, non-subscriber messages may have long delays
! before getting distributed to all subscribers.
! </p>
! <p><b>ABSOLUTELY NO SPAM IS TOLERATED</b>.  Any spam is happily
! redirected to /dev/null.
  </p>
- </td>
- </tr>
- </table>
- 
- <P>The mailing list is archived by
- Majordomo. You can also use the WWW to access
- the archive (with full text search using
- <a href="http://glimpse.cs.arizona.edu/";>Glimpse</a>) at
- <A HREF="http://www.xray.mpe.mpg.de/mailing-lists/";
- >&lt;http://www.xray.mpe.mpg.de/mailing-lists/&gt;</A>.
- An alternative web archive of the mailing list is at
- <A HREF="http://www.mail-archive.com/mhonarc-users(_at_)mhonarc(_dot_)org/"
- >&lt;http://www.mail-archive.com/mhonarc-users(_at_)mhonarc(_dot_)org/&gt;</A>.
- </P>
  
  <!-- ??????????????????????????????????????????????????????????????? -->
--- 136,144 ----
  and general help.  </P>
  
! <p>Information about the list, including how to subscribe and
! the locations of web-accessible archives, is available at
! <a href="http://www.mhonarc.org/archive/info/mhonarc-users.html";
! >&lt;http://www.mhonarc.org/archive/info/mhonarc-users.html&gt;</a>
  </p>
  
  <!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 203,279 ****
  </td></tr></table>
  
! <p><a href="http://www.landfield.com/hypermail/";>Hypermail</a>
! is probably the only other major free program (distributed under the
! <a href="http://www.gnu.org/";>GPL</a>) for archiving
! e-mail on the Web.  There are other free programs available,
! but Hypermail and MHonArc appear to be the two major programs
! in use.
! </p>
! 
! <p>The best comparison that can be made is by yourself, since the
! choosing between which tool to use will depend on your needs.
! The following is a brief list of some of the advantages of MHonArc
! over Hypermail:
  </p>
  
- <table class="note" width="100%">
- <tr valign="baseline">
- <td><strong>NOTE:</strong></td>
- <td width="100%"><p>If you notice any errors regarding the information related
- to Hypermail, please contact the FAQ maintainer.
- </p>
- </td>
- </tr>
- </table>
- 
  <ul>
- <li><p>Support variant mail folders types.  Hypermail supports only
- UUCP-style mailboxes.
- </p>
- </li>
- <li><p>MHonArc has fairly robust MIME support, including the ability to
- extend the list of media-types supported.
- Hypermail is supposed to have some
- some support for MIME, but it still appears to be a work in progress.
- </p>
- </li>
- <li><p>Page customization.  MHonArc gives you complete control
- on how pages are formatted.  Hypermail has some page customization
- features, but not at the level of MHonArc's.  With MHonArc, you
- can create archives with frame navigation or incorporate JavaScript
- to provided more sophisticated archives.
- </p>
- </li>
- <li><p>Multi-platform support.  MHonArc basically runs on any system
- that Perl runs.  Hypermail is only known to run on Unix systems,
- however, there may be a WinNT port.
- </p>
- </li>
- <li><p>Single message conversion.  MHonArc can be used to convert
- a message to HTML independent of archive processing.  Hence, MHonArc can
- be used as general MIME decoder.
- </p>
- </li>
- </ul>
  
! <p>The other major difference is that MHonArc is written in
! Perl, and Hypermail is written in C.
! There are pros and cons of both languages.  In sum, Perl allows
! for easier modification, portability, and extensiblility.  C
! provides better execution speed.
! </p>
  
! <p>There are other differences, so consult the documentation of
! both programs to get a more complete list.  Your needs willl
! ultimately decide which program is best for you.
! </p>
! 
! <p>For some time, there
! was a lack of development on Hypermail.  However, there is
! currently a maintainer.  Information about Hypermail can
! be obtained from
! <a href="http://www.landfield.com/hypermail/";
! >&lt;http://www.landfield.com/hypermail/&gt;</a>.
! </p>
  
  <!-- ??????????????????????????????????????????????????????????????? -->
--- 149,204 ----
  </td></tr></table>
  
! <p>Hypermail
! is probably the oldest major free mail archiver still in use, but over
! the years, others have popped up.  Which is best depends on your
! needs.  The following provides a summary of some of the free
! archiving programs available:
  </p>
  
  <ul>
  
! <li><p><a href="http://www.mhonarc.org/";
!     >MHonArc</a>: Distributed under the <a
!     href="http://www.gnu.org/licenses/gpl.txt";>GPL</a>, MHonArc is
!     a Perl program for converting mail or news messages into HTML
!     archives. It can also be used to convert individual messages into
!     HTML documents. Other capabilities include robust MIME support
!     and powerful user customization features.
!     </p>
! 
! <li><p><a href="http://www.mhonarc.org/mharc/";
!     >mharc</a>: Part of the
!     <a href="http://savannah.nongnu.org/projects/mhonarc/";
!     >MHonArc project</a>, it is a collection of Perl scripts for
!     generating and managing web-based searchable mail archives.
!     mharc is designed to make it easy to setup and configure large scale
!     mail archives.
!     </p>
! 
! <li><p><a href="http://www.landfield.com/hypermail/";
!     >Hypermail</a>: Distributed under the
!     <a href="http://www.gnu.org/licenses/gpl.txt";>GPL</a>.  Originally
!     written Lisp, it is now a C program.  There was time when it
!     was not being maintained, but it is now actively maintained and
!     updated.
!     </p>
! 
! <li><p><a href="http://www.amk.ca/python/unmaintained/pipermail.html";
!     >Pipermail</a>: Written Python, it is now only being maintained
!     inside the <a href="http://www.list.org/";>Mailman</a> mailing
!     list manager.
! 
! <li><p><a href="http://eyebrowse.tigris.org/";
!     >Eyebrowse</a>: A Java Servlet/Velocity-based browser for
!     Unix mbox format mail archives.  Quoting from the project
!     homepage: "Eyebrowse differs from other popular archive browsers
!     in that it does not require that mailing lists be exploded into
!     individual HTML files, and that the HTML rendering is done at
!     serving time, rather than at the time the message is received."
!     Eyebrowse is distributed under the
!     <a href="http://www.apache.org/LICENSE.txt";>Apache License</a>.
!     </p>
  
! </ul>
  
  <!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 344,350 ****
  <a href="http://www.hpc.uh.edu/majordomo-users";
  >&lt;http://www.hpc.uh.edu/majordomo-users&gt;</a>
! <li>Sourceware.cygnus.com Mailing Lists:<br>
! <a href="http://sourceware.cygnus.com/ml/";
! >&lt;http://sourceware.cygnus.com/ml/&gt;</a>
  <li>Liblicense-L List Archives:<br>
  <a href="http://www.library.yale.edu/~llicense/ListArchives/";
--- 269,275 ----
  <a href="http://www.hpc.uh.edu/majordomo-users";
  >&lt;http://www.hpc.uh.edu/majordomo-users&gt;</a>
! <li>sources.redhat.com mailing lists:<br>
! <a href="http://sources.redhat.com/lists.html";
! >&lt;http://sources.redhat.com/lists.html&gt;</a>
  <li>Liblicense-L List Archives:<br>
  <a href="http://www.library.yale.edu/~llicense/ListArchives/";
***************
*** 359,365 ****
  <a href="http://www.apsfilter.org/Lists-Archives/";
  >&lt;http://www.apsfilter.org/Lists-Archives/&gt;</a>
- <li>Giant Java Tree Archives:<br>
- <a href="http://www.git.org/servlets/MailingLists/ListOfLists.html";
- >&lt;http://www.git.org/servlets/MailingLists/ListOfLists.html&gt;</a>
  </ul>
  
--- 284,287 ----

Index: indexpgs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/indexpgs.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -r1.14 -r1.15
*** indexpgs.html	18 Dec 2002 05:55:21 -0000	1.14
--- indexpgs.html	3 Jan 2003 04:32:32 -0000	1.15
***************
*** 82,86 ****
  to contain the additional links.  See the
  <a href="../resources/listbegin.html">LISTBEGIN</a> and
! THEAD resources.
  </p>
  </td>
--- 82,86 ----
  to contain the additional links.  See the
  <a href="../resources/listbegin.html">LISTBEGIN</a> and
! <a href="../resources/thead.html">THEAD</a> resources.
  </p>
  </td>

Index: mime.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/mime.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** mime.html	18 Dec 2002 05:55:21 -0000	1.18
--- mime.html	3 Jan 2003 04:32:32 -0000	1.19
***************
*** 85,89 ****
  as described in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> resource.  Note, please review the
  options available for the default filters described in the <a href="../resources/mimefilters.html">MIMEFILTERS</a>
! resource page since they may already provide the capability you
  need.
  </p>
--- 85,89 ----
  as described in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> resource.  Note, please review the
  options available for the default filters described in the <a href="../resources/mimefilters.html">MIMEFILTERS</a>
! resource page since they may already provide the capabilities you
  need.
  </p>
***************
*** 127,138 ****
  
  <p>Yes.  See the <b><tt>m2h_external::filter</tt></b> options documented
! in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> page of the documentation.  Make note of the
! security cautions in the documentation.
  Example:
  </p>
  <pre class="code">
! &lt;MIMEArgs&gt;
  m2h_external::filter; usename
! &lt;/MIMEArgs&gt;
  </pre>
  
--- 127,139 ----
  
  <p>Yes.  See the <b><tt>m2h_external::filter</tt></b> options documented
! in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> page of
! the documentation.  <strong>Make note of the
! security cautions</strong> in the documentation.
  Example:
  </p>
  <pre class="code">
! <b>&lt;MIMEArgs&gt;</b>
  m2h_external::filter; usename
! <b>&lt;/MIMEArgs&gt;</b>
  </pre>
  
***************
*** 156,162 ****
  </p>
  <pre class="code">
! &lt;MIMEArgs&gt;
  m2h_text_plain::filter; nonfixed
! &lt;/MIMEArgs&gt;
  </pre>
  
--- 157,163 ----
  </p>
  <pre class="code">
! <b>&lt;MIMEArgs&gt;</b>
  m2h_text_plain::filter; nonfixed
! <b>&lt;/MIMEArgs&gt;</b>
  </pre>
  
***************
*** 174,180 ****
  <pre class="code">
  &lt;-- Make sure lines are no longer than 80 characters --&gt;
! &lt;MIMEArgs&gt;
  m2h_text_plain::filter; maxwidth=80
! &lt;/MIMEArgs&gt;
  </pre>
  
--- 175,181 ----
  <pre class="code">
  &lt;-- Make sure lines are no longer than 80 characters --&gt;
! <b>&lt;MIMEArgs&gt;</b>
  m2h_text_plain::filter; maxwidth=80
! <b>&lt;/MIMEArgs&gt;</b>
  </pre>
  
***************
*** 191,198 ****
  <pre class="code">
  &lt;-- Exclude all HTML and binary data --&gt;
! &lt;MIMEExcs&gt;
  text/html
  application/octet-steam
! &lt;/MIMEExcs&gt;
  </pre>
  
--- 192,199 ----
  <pre class="code">
  &lt;-- Exclude all HTML and binary data --&gt;
! <b>&lt;MIMEExcs&gt;</b>
  text/html
  application/octet-steam
! <b>&lt;/MIMEExcs&gt;</b>
  </pre>
  
***************
*** 208,215 ****
  </p>
  <pre class="code">
! &lt;MIMEAltPrefs&gt;
  text/plain
  text/html
! &lt;/MIMEAltPrefs&gt;
  </pre>
  
--- 209,216 ----
  </p>
  <pre class="code">
! <b>&lt;MIMEAltPrefs&gt;</b>
  text/plain
  text/html
! <b>&lt;/MIMEAltPrefs&gt;</b>
  </pre>
  

Index: msgpgs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/msgpgs.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -C2 -r1.12 -r1.13
*** msgpgs.html	18 Dec 2002 05:55:21 -0000	1.12
--- msgpgs.html	3 Jan 2003 04:32:32 -0000	1.13
***************
*** 55,92 ****
  cause message headers to be formatted with a table:
  </p>
! <pre>
! <b>&lt;<a href="../resources/fieldsbeg.html">FIELDSBEG</a>></b>
! &lt;table>
! &lt;tbody>
! <b>&lt;/<a href="../resources/fieldsbeg.html">FIELDSBEG</a>></b>
  <b>&lt;<a href="../resources/labelbeg.html">LABELBEG</a>></b>
! &lt;tr>
! &lt;td align="right" valign="top">
! <b>&lt;/<a href="../resources/labelbeg.html">LABELBEG</a>></b>
! <b>&lt;<a href="../resources/labelend.html">LABELEND</a>></b>
! &lt;/td>
! <b>&lt;/<a href="../resources/labelend.html">LABELEND</a>></b>
! <b>&lt;<a href="../resources/fldbeg.html">FLDBEG</a>></b>
! &lt;td align="left">
! <b>&lt;/<a href="../resources/fldbeg.html">FLDBEG</a>></b>
! <b>&lt;<a href="../resources/fldend.html">FLDEND</a>></b>
! &lt;/td>
! &lt;/tr>
! <b>&lt;/<a href="../resources/fldend.html">FLDEND</a>></b>
! <b>&lt;<a href="../resources/fieldsend.html">FIELDSEND</a>></b>
! &lt;/tbody>
! &lt;/table>
! <b>&lt;/<a href="../resources/fieldsend.html">FIELDSEND</a>></b>
  </pre>
  
  <p>You can also control the order message fields are displayed:
  </p>
! <pre>
! <b>&lt;<a href="../resources/fieldorder.html">FIELDORDER</a>></b>
  from
  subject
  date
  -extra-
! <b>&lt;/<a href="../resources/fieldorder.html">FIELDORDER</a>></b>
  </pre>
  <p>The "-extra-" signifies all other message fields in alphabetic
--- 55,90 ----
  cause message headers to be formatted with a table:
  </p>
! <pre class="code">
! <b>&lt;<a href="../resources/fieldsbeg.html">FIELDSBEG</a>&gt;</b>
! &lt;table&gt;
! <b>&lt;/FIELDSBEG&gt;</b>
  <b>&lt;<a href="../resources/labelbeg.html">LABELBEG</a>></b>
! &lt;tr&gt;
! &lt;td align="right" valign="top"&gt;
! <b>&lt;/LABELBEG&gt;</b>
! <b>&lt;<a href="../resources/labelend.html">LABELEND</a>&gt;</b>
! &lt;/td&gt;
! <b>&lt;/LABELEND&gt;</b>
! <b>&lt;<a href="../resources/fldbeg.html">FLDBEG</a>&gt;</b>
! &lt;td align="left"&gt;
! <b>&lt;/FLDBEG&gt;</b>
! <b>&lt;<a href="../resources/fldend.html">FLDEND</a>&gt;</b>
! &lt;/td&gt;
! &lt;/tr&gt;
! <b>&lt;/FLDEND&gt;</b>
! <b>&lt;<a href="../resources/fieldsend.html">FIELDSEND</a>&gt;</b>
! &lt;/table&gt;
! <b>&lt;/FIELDSEND&gt;</b>
  </pre>
  
  <p>You can also control the order message fields are displayed:
  </p>
! <pre class="code">
! <b>&lt;<a href="../resources/fieldorder.html">FIELDORDER</a>&gt;</b>
  from
  subject
  date
  -extra-
! <b>&lt;/FIELDORDER&gt;</b>
  </pre>
  <p>The "-extra-" signifies all other message fields in alphabetic
***************
*** 96,104 ****
  <p>You can also exclude specific message fields:
  </p>
! <pre>
! <b>&lt;<a href="../resources/excs.html">EXCS</a>></b>
  x-
  precendence
! <b>&lt;/<a href="../resources/excs.html">EXCS</a>></b>
  </pre>
  <p>Here, we are exluding all "X-..." fields and the Precendence
--- 94,102 ----
  <p>You can also exclude specific message fields:
  </p>
! <pre class="code">
! <b>&lt;<a href="../resources/excs.html">EXCS</a>&gt;</b>
  x-
  precendence
! <b>&lt;/EXCS&gt;</b>
  </pre>
  <p>Here, we are exluding all "X-..." fields and the Precendence
***************
*** 140,154 ****
  bogus header via the resource variables available.  For example:
  </p>
! <pre>
! <b>&lt;<a href="../resources/excs.html">EXCS</a> override></b>
  .
! <b>&lt;/<a href="../resources/excs.html">EXCS</a>></b>
! <b>&lt;<a href="../resources/msgfoot.html">MSGFOOT</a>></b>
! &lt;ul>
! &lt;li>From: $FROM$
! &lt;li>Subject: $SUBJECTNA$
! &lt;li>Date: $DATE$
! &lt;ul>
! <b>&lt;/<a href="../resources/msgfoot.html">MSGFOOT</a>></b>
  </pre>
  
--- 138,175 ----
  bogus header via the resource variables available.  For example:
  </p>
! <pre class="code">
! <b>&lt;<a href="../resources/excs.html">EXCS</a> override&gt;</b>
  .
! <b>&lt;/EXCS&gt;</b>
! <b>&lt;<a href="../resources/msgfoot.html">MSGFOOT</a>&gt;</b>
! &lt;ul&gt;
! &lt;li&gt;From: $FROM$
! &lt;li&gt;Subject: $SUBJECTNA$
! &lt;li&gt;Date: $DATE$
! &lt;ul&gt;
! <b>&lt;/MSGFOOT&gt;</b>
! </pre>
! 
! <p>In v2.6, you can include additional header fields by using the
! <a href="../resources/fieldstore.html">FIELDSTORE</a> resource
! and the <tt>$MSGHFIELD$</tt> resource variable.  For example, say
! you want to include the <tt>To:</tt> field in the previous example.
! You can do the following:
! </p>
! <pre class="code">
! <b>&lt;<a href="../resources/excs.html">EXCS</a> override&gt;</b>
! .
! <b>&lt;/EXCS&gt;</b>
! <b>&lt;<a href="../resources/fieldstore.html">FIELDSTORE</a>&gt;</b>
! to
! <b>&lt;/FIELDSTORE&gt;</b>
! <b>&lt;<a href="../resources/msgfoot.html">MSGFOOT</a>&gt;</b>
! &lt;ul&gt;
! &lt;li&gt;To: $MSGHFIELD(CUR;to)$
! &lt;li&gt;From: $FROM$
! &lt;li&gt;Subject: $SUBJECTNA$
! &lt;li&gt;Date: $DATE$
! &lt;ul&gt;
! <b>&lt;/MSGFOOT&gt;</b>
  </pre>
  
***************
*** 161,165 ****
  
  <p>Yes, mostly.  The only thing cannot be changed once converted
! is the message header and message body.  All other parts of the
  message page can be changed at any time.  To make any changes
  appear on existing archived messages, set the <a href="../resources/editidx.html">EDITIDX</a> resource.
--- 182,187 ----
  
  <p>Yes, mostly.  The only thing cannot be changed once converted
! is the message header and message body (but see
! <a href="#reconvert_note">note below</a>).  All other parts of the
  message page can be changed at any time.  To make any changes
  appear on existing archived messages, set the <a href="../resources/editidx.html">EDITIDX</a> resource.
***************
*** 167,170 ****
--- 189,205 ----
  pages.
  </p>
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><a name="reconvert_note"><strong>NOTE:</strong></a></td>
+ <td width="100%"><p>v2.6 introduced the
+ <a href="../resources/reconvert.html">RECONVERT</a> resource.  With
+ RECONVERT, you can reconvert messages if the original raw messages
+ are available.  See RECONVERT
+ <a href="../resources/reconvert.html#examples">examples</a> for
+ more information.
+ </p>
+ </td>
+ </tr>
+ </table>
  
  <!-- ??????????????????????????????????????????????????????????????? -->

Index: usage.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/usage.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -r1.19 -r1.20
*** usage.html	18 Dec 2002 05:55:21 -0000	1.19
--- usage.html	3 Jan 2003 04:32:32 -0000	1.20
***************
*** 43,47 ****
  Resources are set, or defined, by command-line options, environment
  variables, or a resource file.  For example, the MAXSIZE resource tells
! MHonArc the maximum number of messages in an archive.  To set
  the resource, you can use the <strong><code>-maxsize</code></strong>
  command-line option, the <strong>M2H_MAXSIZE</strong> envariable, or the
--- 43,47 ----
  Resources are set, or defined, by command-line options, environment
  variables, or a resource file.  For example, the MAXSIZE resource tells
! MHonArc the maximum number of messages allowed in an archive.  To set
  the resource, you can use the <strong><code>-maxsize</code></strong>
  command-line option, the <strong>M2H_MAXSIZE</strong> envariable, or the
***************
*** 174,179 ****
  <a href="http://www.namazu.org/";>&lt;http://www.namazu.org/&gt;</a>
  (MHonArc aware and supports Japanese)</li>
! <li><strong>UdmSearch</strong>:
! <a href="http://mysearch.udm.net/";>&lt;http://mysearch.udm.net/&gt;</a></li>
  </ul>
  <p>For more information, see
--- 174,179 ----
  <a href="http://www.namazu.org/";>&lt;http://www.namazu.org/&gt;</a>
  (MHonArc aware and supports Japanese)</li>
! <li><strong>mnoGoSearch</strong>:
! <a href="http://search.mnogo.ru/";>&lt;http://search.mnogo.ru/&gt;</a></li>
  </ul>
  <p>For more information, see
***************
*** 219,223 ****
  
  <p>No official ones.  Several users have created home-grown interfaces
! to perform various tasks.  An experimental web admin tool comes in
  with the MHonArc distribution under the "admin" directory.
  I recommend searching the
--- 219,224 ----
  
  <p>No official ones.  Several users have created home-grown interfaces
! to perform various tasks.  An experimental, <strong>unsecure</strong>
! web admin tool comes in
  with the MHonArc distribution under the "admin" directory.
  I recommend searching the
***************
*** 373,377 ****
  
  <p>This usually implies that you have duplicate messages.  MHonArc
! will not archive a message that has already been archived.
  A way to check if message duplication is the culprit, try the following
  on your mailbox:
--- 374,378 ----
  
  <p>This usually implies that you have duplicate messages.  MHonArc
! skips messages that have already been archived.
  A way to check if message duplication is the culprit, try the following
  on your mailbox:

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