Update of /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq
In directory subversions:/tmp/cvs-serv27402/doc/faq
Modified Files:
about.html archives.html envs.html faq.html general.html
indexpgs.html mime.html msgpgs.html security.html threads.html
usage.html
Log Message:
* A bunch of documentation updates.
Index: about.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/about.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -r1.17 -r1.18
*** about.html 18 Apr 2002 06:19:27 -0000 1.17
--- about.html 18 Dec 2002 05:55:21 -0000 1.18
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: About the FAQ</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [Prev][<a href="general.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: About the FAQ</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[Prev]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="general.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 36,40 ****
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";>MIME</a> to <A
HREF="http://www.w3.org/hypertext/WWW/MarkUp/MarkUp.html";>HTML</A>.
MHonArc has the ability to maintain an archive of converted
--- 35,39 ----
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/";>MIME</a> to <A
HREF="http://www.w3.org/hypertext/WWW/MarkUp/MarkUp.html";>HTML</A>.
MHonArc has the ability to maintain an archive of converted
***************
*** 65,69 ****
</tr>
<tr valign=top>
! <td align=right><strong><a HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html";>MIME</a></strong>
<td><em>Multipurpose Internet Mail Extensions</em>.
</tr>
--- 64,68 ----
</tr>
<tr valign=top>
! <td align=right><strong><a HREF="http://www.mhonarc.org/~ehood/MIME/";>MIME</a></strong>
<td><em>Multipurpose Internet Mail Extensions</em>.
</tr>
***************
*** 139,144 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [Prev][<a href="general.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 138,142 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[Prev]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="general.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: archives.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/archives.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -r1.19 -r1.20
*** archives.html 21 Jun 2002 22:28:16 -0000 1.19
--- archives.html 18 Dec 2002 05:55:21 -0000 1.20
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Archives</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="usage.html">Prev</a>][<a href="indexpgs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Archives</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="usage.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="indexpgs.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 54,63 ****
with a `<code>></code>'. </P>
! <P>To fix the problem, use the <strong>MSGSEP</strong> resource to
instruct MHonArc to use a stricter test detecting a message
! separator. The following <strong>MSGSEP</strong> resource setting is
known to work well: </P>
! <pre>
<b><MsgSep></b>
^From \S+\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
--- 53,64 ----
with a `<code>></code>'. </P>
! <P>To fix the problem, use the
! <a href="../resources/msgsep.html">MSGSEP</a> resource to
instruct MHonArc to use a stricter test detecting a message
! separator. The following <a href="../resources/msgsep.html">MSGSEP</a>
! resource setting is
known to work well: </P>
! <pre class="code">
<b><MsgSep></b>
^From \S+\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
***************
*** 69,73 ****
</p>
! <pre>
<b><MsgSep></b>
^From\s+(?:"[^"]+"@\S+|\S+)\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
--- 70,74 ----
</p>
! <pre class="code">
<b><MsgSep></b>
^From\s+(?:"[^"]+"@\S+|\S+)\s+\S+\s+\S+\s+\d+\s+\d+:\d+:\d+\s+\d+
***************
*** 79,84 ****
</p>
! <p>If this fails, you can try the <strong>CONLEN</strong>
! resource available in v2.0 and later. The CONLEN resource, when set, tells
MHonArc to utilize the <code>Content-Length</code> fields
in the message head. If your MTA defines this field accurately,
--- 80,87 ----
</p>
! <p>If this fails, you can try the
! <a href="../resources/conlen.html">CONLEN</a>
! resource available in v2.0 and later. The
! <a href="../resources/conlen.html">CONLEN</a> resource, when set, tells
MHonArc to utilize the <code>Content-Length</code> fields
in the message head. If your MTA defines this field accurately,
***************
*** 96,100 ****
9 moons ago:
</p>
! <pre>
:0fhw # B won't help; size conditions ignore H and B flags on the :0 line
* ! ^Content-Length:.*[0-9]
--- 99,103 ----
9 moons ago:
</p>
! <pre class="code">
:0fhw # B won't help; size conditions ignore H and B flags on the :0 line
* ! ^Content-Length:.*[0-9]
***************
*** 121,125 ****
actually think of using this</u>:
</p>
! <pre>
define(`LOCAL_MAILER_FLAGS',`SPfhn9Z')
define(`LOCAL_MAILER_ARGS',`procmail -a $h -d $u')
--- 124,128 ----
actually think of using this</u>:
</p>
! <pre class="code">
define(`LOCAL_MAILER_FLAGS',`SPfhn9Z')
define(`LOCAL_MAILER_ARGS',`procmail -a $h -d $u')
***************
*** 137,143 ****
<p>If possible, try to avoid relying on the use of
<tt>Content-Length</tt> since it is hard to guarantee that it is
! set properly. When <b>CONLEN</b> is specified, MHonArc will read at
least the number of bytes specified by <tt>Content-Length</tt> before
! checking for the message separator, as defined by the <b>MSGSEP</b>
resource. Therefore, the value of <tt>Content-Length</tt> can be less
than the actual message size, and message extraction will probably
--- 140,149 ----
<p>If possible, try to avoid relying on the use of
<tt>Content-Length</tt> since it is hard to guarantee that it is
! set properly. When
! <a href="../resources/conlen.html">CONLEN</a>
! is specified, MHonArc will read at
least the number of bytes specified by <tt>Content-Length</tt> before
! checking for the message separator, as defined by the
! <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
***************
*** 185,192 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>As an archive increases in size, performing updates as
a message is received takes more processing time. Therefore, for
large archives, you may need to do updates through a periodic
--- 191,199 ----
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! As an archive increases in size, performing updates as
a message is received takes more processing time. Therefore, for
large archives, you may need to do updates through a periodic
***************
*** 198,202 ****
</table>
-
<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
--- 205,208 ----
***************
*** 218,222 ****
like Procmail.
This example assumes you are on a Unix-based system
! using <b>sendmail</b> as the mail transfer agent.
Please refer to documentation about <b>sendmail</b> if you
are not familiar with it
--- 224,229 ----
like Procmail.
This example assumes you are on a Unix-based system
! using <a href="http://www.sendmail.org/";><b>sendmail</b></a>
! as the mail transfer agent.
Please refer to documentation about <b>sendmail</b> if you
are not familiar with it
***************
*** 232,247 ****
to invoke MHonArc on incoming mail: </P>
! <pre>
\ehood, "|/home/ehood/bin/webnewmail #ehood"
</pre>
! <DL>
! <DT><strong>NOTE</strong> on <tt>.forward</tt> entry:
! <DD><P> The "<code>\ehood</code>" tells <tt>sendmail</tt>
to still deposit the incoming message to my mail spool file. The
"<code>#ehood</code>" Bourne shell comment is needed to insure the
command is unique from another user. Otherwise, <tt>sendmail</tt>
may not invoke the program for you or the other user.
! </P></DL>
<P><tt>webnewmail</tt> is a Perl program that calls
--- 239,259 ----
to invoke MHonArc on incoming mail: </P>
! <pre class="code">
\ehood, "|/home/ehood/bin/webnewmail #ehood"
</pre>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! The "<code>\ehood</code>" tells <tt>sendmail</tt>
to still deposit the incoming message to my mail spool file. The
"<code>#ehood</code>" Bourne shell comment is needed to insure the
command is unique from another user. Otherwise, <tt>sendmail</tt>
may not invoke the program for you or the other user.
! </p>
! </td>
! </tr>
! </table>
<P><tt>webnewmail</tt> is a Perl program that calls
***************
*** 252,256 ****
<tt>webnewmail</tt> program: </P>
! <pre>
#!/usr/local/bin/perl
# Edit above path to point to where perl is on your system.
--- 264,268 ----
<tt>webnewmail</tt> program: </P>
! <pre class="code">
#!/usr/local/bin/perl
# Edit above path to point to where perl is on your system.
***************
*** 282,289 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>For better scalability and resource usage, the author
recommends calling MHonArc from a facility like <b><tt>cron</tt></b>,
which is provided on Unix-based operating systems.
--- 294,302 ----
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! For better scalability and resource usage, the author
recommends calling MHonArc from a facility like <b><tt>cron</tt></b>,
which is provided on Unix-based operating systems.
***************
*** 306,310 ****
Majordomo list to include in sendmail's <tt>aliases</tt> file:
</p>
! <pre>
<em>xxxx</em>: "|<em>/usr/lib/majordomo/</em>wrapper resend -l <em>xxxx</em> <em>xxxx</em>-outgoing"
<em>xxxx</em>-outgoing: :include:<em>/var/lib/majordomo/lists/</em><em>xxxx</em>, <em>xxxx</em>-mhonarc
--- 319,323 ----
Majordomo list to include in sendmail's <tt>aliases</tt> file:
</p>
! <pre class="code">
<em>xxxx</em>: "|<em>/usr/lib/majordomo/</em>wrapper resend -l <em>xxxx</em> <em>xxxx</em>-outgoing"
<em>xxxx</em>-outgoing: :include:<em>/var/lib/majordomo/lists/</em><em>xxxx</em>, <em>xxxx</em>-mhonarc
***************
*** 316,320 ****
</pre>
! <p>Replace text that <em>is rendered like this</em> with
what is appropriate for your configuration.
</p>
--- 329,333 ----
</pre>
! <p>Replace text that <tt class="icode"><em>is rendered like this</em></tt> with
what is appropriate for your configuration.
</p>
***************
*** 324,329 ****
program directory to where MHonArc is installed. For example:
</p>
! <pre>
! shell> <b>ln -s <em>/usr/bin/mhonarc</em> <em>/usr/lib/majordomo/mhonarc</em></b>
</pre>
<p>Make sure <em><tt>/usr/bin/mhonarc</tt></em> is readable and executable
--- 337,342 ----
program directory to where MHonArc is installed. For example:
</p>
! <pre class="shell">
! prompt> <b>ln -s <em>/usr/bin/mhonarc</em> <em>/usr/lib/majordomo/mhonarc</em></b>
</pre>
<p>Make sure <em><tt>/usr/bin/mhonarc</tt></em> is readable and executable
***************
*** 331,336 ****
to insure this:
</p>
! <pre>
! shell> <b>chmod <em>755</em> <em>/usr/bin/mhonarc</em></b>
</pre>
<p>If you redirect stderr to a logfile, the logfile must
--- 344,349 ----
to insure this:
</p>
! <pre class="shell">
! prompt> <b>chmod <em>755</em> <em>/usr/bin/mhonarc</em></b>
</pre>
<p>If you redirect stderr to a logfile, the logfile must
***************
*** 360,367 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>You may want to check out the following:
<strong><a href="http://www.mhonarc.org/release/mharc/";>mharc</a></strong>
at <a href="http://www.mhonarc.org/release/mharc/";
--- 373,380 ----
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>You may want to check out the following:
<strong><a href="http://www.mhonarc.org/release/mharc/";>mharc</a></strong>
at <a href="http://www.mhonarc.org/release/mharc/";
***************
*** 370,379 ****
lists using Procmail, MHonArc, and Namazu.
</p>
! </td><tr></table>
<p>Here are a some messages from users about using Procmail:
</p>
! <blockquote>
<UL>
<LI><em>From</em>: Achim Bohnet <<A HREF="mailto:ach(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de">ach(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de</A>></LI>
--- 383,394 ----
lists using Procmail, MHonArc, and Namazu.
</p>
! </td>
! </tr>
! </table>
<p>Here are a some messages from users about using Procmail:
</p>
! <blockquote class="mail">
<UL>
<LI><em>From</em>: Achim Bohnet <<A HREF="mailto:ach(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de">ach(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de</A>></LI>
***************
*** 407,412 ****
</blockquote>
! <blockquote>
! <hr noshade size=1>
<UL>
<LI><em>From</em>: "Eric D. Friedman" <<A HREF="mailto:friedman(_at_)hydra(_dot_)acs(_dot_)uci(_dot_)edu">friedman(_at_)hydra(_dot_)acs(_dot_)uci(_dot_)edu</A>></LI>
--- 422,426 ----
</blockquote>
! <blockquote class="mail">
<UL>
<LI><em>From</em>: "Eric D. Friedman" <<A HREF="mailto:friedman(_at_)hydra(_dot_)acs(_dot_)uci(_dot_)edu">friedman(_at_)hydra(_dot_)acs(_dot_)uci(_dot_)edu</A>></LI>
***************
*** 462,467 ****
</blockquote>
! <blockquote>
! <hr noshade size=1>
<UL>
<LI><em>From</em>: Paul McKinley <<A HREF="mailto:mckinley(_at_)austin(_dot_)asc(_dot_)slb(_dot_)com">mckinley(_at_)austin(_dot_)asc(_dot_)slb(_dot_)com</A>></LI>
--- 476,480 ----
</blockquote>
! <blockquote class="mail">
<UL>
<LI><em>From</em>: Paul McKinley <<A HREF="mailto:mckinley(_at_)austin(_dot_)asc(_dot_)slb(_dot_)com">mckinley(_at_)austin(_dot_)asc(_dot_)slb(_dot_)com</A>></LI>
***************
*** 555,559 ****
</td></tr></table>
! <p>Version 2.4, or later, does via the <b>CHECKNOARCHIVE</b> resource.
</p>
--- 568,574 ----
</td></tr></table>
! <p>Version 2.4, or later, does via the
! <a href="../resources/checknoarchive.html">CHECKNOARCHIVE</a>
! resource.
</p>
***************
*** 564,568 ****
</p>
! <blockquote>
<UL>
<LI><em>Subject</em>: Re: No archive</LI>
--- 579,583 ----
</p>
! <blockquote class="mail">
<UL>
<LI><em>Subject</em>: Re: No archive</LI>
***************
*** 603,610 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong><font color="red">WARNING</font></strong></td>
! <td><p>If using MHonArc versions 2.4, or earlier, make sure the file
<tt>maillist.html</tt> (or the value
of the IDXFNAME resource) does not exist if no archive exists and
--- 618,626 ----
</p>
! <table class="caution" width="100%">
! <tr valign="baseline">
! <td><strong style="color: red;">WARNING:</strong></td>
! <td width="100%"><p>
! If using MHonArc versions 2.4, or earlier, make sure the file
<tt>maillist.html</tt> (or the value
of the IDXFNAME resource) does not exist if no archive exists and
***************
*** 617,621 ****
</table>
-
<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
--- 633,636 ----
***************
*** 626,634 ****
<p>Big gaps in the message number sequence may occur if you
! defined the <strong>MAXSIZE</strong> resource and you have
MHonArc rescanning a mail folder for adding new messages.
The problem occurs when MHonArc
reads in messages that will automatically get deleted due
! to MAXSIZE. Ie. Messages subject to automatic deletion are
the oldest ones. If the input contains old messages that will
get deleted at the end of processing, the old messages will
--- 641,653 ----
<p>Big gaps in the message number sequence may occur if you
! defined the
! <a href="../resources/maxsize.html">MAXSIZE</a>
! resource and you have
MHonArc rescanning a mail folder for adding new messages.
The problem occurs when MHonArc
reads in messages that will automatically get deleted due
! to
! <a href="../resources/maxsize.html">MAXSIZE</a>.
! Ie. Messages subject to automatic deletion are
the oldest ones. If the input contains old messages that will
get deleted at the end of processing, the old messages will
***************
*** 643,649 ****
messages to MHonArc instead of having MHonArc
rescanning the same mail folder for new messages. Another
! approach is to set either the <strong>EXPIREAGE</strong> or
! <strong>EXPIREDATE</strong> resources (available in v2.0 beta 2,
! or later). These work as an alternative to MAXSIZE and will help in
preventing message number jumping since expiration of a message is
checked when it is initially read (bypassing the assignment of
--- 662,672 ----
messages to MHonArc instead of having MHonArc
rescanning the same mail folder for new messages. Another
! approach is to set either the
! <a href="../resources/expireage.html">EXPIREAGE</a> or
! <a href="../resources/expiredate.html">EXPIREDATE</a>
! resources (available in v2.0 beta 2,
! or later). These work as an alternative to
! <a href="../resources/maxsize.html">MAXSIZE</a>
! and will help in
preventing message number jumping since expiration of a message is
checked when it is initially read (bypassing the assignment of
***************
*** 676,683 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>In MHonArc v2.4 and later, and if you have
the <b>Digest::MD5</b> module installed, MHonArc will compute
the MD5 digest of message headers without message-ids. This
--- 699,707 ----
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! In MHonArc v2.4 and later, and if you have
the <b>Digest::MD5</b> module installed, MHonArc will compute
the MD5 digest of message headers without message-ids. This
***************
*** 702,710 ****
</td></tr></table>
! <p>Automatic removal can be done via the <strong>EXPIREAGE</strong> or
! <strong>EXPIREDATE</strong> resources (available in v2.0 beta 2,
! or later) or the <strong>MAXSIZE</strong> resource.
</p>
! <p>Explicit message removal can be done with the <strong>RMM</strong>
resource. Please read the RMM resource page for more information
and examples.
--- 726,739 ----
</td></tr></table>
! <p>Automatic removal can be done via the
! <a href="../resources/expireage.html">EXPIREAGE</a> or
! <a href="../resources/expiredate.html">EXPIREDATE</a>
! resources (available in v2.0 beta 2,
! or later) or the
! <a href="../resources/maxsize.html">MAXSIZE</a>
! resource.
</p>
! <p>Explicit message removal can be done with the
! <a href="../resources/rmm.html">RMM</a>
resource. Please read the RMM resource page for more information
and examples.
***************
*** 730,735 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="usage.html">Prev</a>][<a href="indexpgs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 759,763 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="usage.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="indexpgs.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: envs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/envs.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -r1.16 -r1.17
*** envs.html 20 Jul 2002 00:48:48 -0000 1.16
--- envs.html 18 Dec 2002 05:55:21 -0000 1.17
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Supported Environments</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="general.html">Prev</a>][<a href="usage.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Supported Environments</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="general.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="usage.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 31,34 ****
--- 30,34 ----
<li><a href="#otherformats">What about other mailbox/folder formats?</a></li>
<li><a href="#nonenglish">Can MHonArc create non-English archives?</a></li>
+ <li><a href="#japanese">How about Japanese?</a></li>
<li><a href="#bilingual">Can I create bilingual archives?</a></li>
<li><a href="#unicode">Does MHonArc support Unicode?</a></li>
***************
*** 118,128 ****
Trumpet</EM>, and <EM>NUPop</EM>. </P>
! <DL>
! <DT><STRONG>NOTE</STRONG>
!
! <DD><P>To support some MUA's, it may require redefining the
! MSGSEP or MHPATTERN resource. Please consult the documentation
! for more information about these resources.</P>
! </DL>
<!-- ??????????????????????????????????????????????????????????????? -->
--- 118,134 ----
Trumpet</EM>, and <EM>NUPop</EM>. </P>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! To support some MUA's, it may require redefining the
! <a href="../resources/msgsep.html">MSGSEP</a> or
! <a href="../resources/mhpattern.html">MHPATTERN</a>
! resource. Please consult the documentation
! for more information about these resources.
! </p>
! </td>
! </tr>
! </table>
<!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 137,141 ****
>MHonArc mailing list</A>:
</p>
! <BLOCKQUOTE>
<UL>
<LI><em>Subject</em>: Re: Majordomo Digest -> MHonarc?</LI>
--- 143,147 ----
>MHonArc mailing list</A>:
</p>
! <BLOCKQUOTE class="mail">
<UL>
<LI><em>Subject</em>: Re: Majordomo Digest -> MHonarc?</LI>
***************
*** 170,175 ****
</PRE>
</BLOCKQUOTE>
! <BLOCKQUOTE>
! <hr noshade size=1>
<UL>
<LI><em>Subject</em>: Majordomo Digests to mbox format for MHonarc (perl script)</LI>
--- 176,180 ----
</PRE>
</BLOCKQUOTE>
! <BLOCKQUOTE class="mail">
<UL>
<LI><em>Subject</em>: Majordomo Digests to mbox format for MHonarc (perl script)</LI>
***************
*** 238,242 ****
<p>An answer from a MHonArc user:
</p>
! <blockquote>
<UL>
<LI><em>To</em>: <A HREF="mailto:mhonarc(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de">mhonarc(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de</A></LI>
--- 243,247 ----
<p>An answer from a MHonArc user:
</p>
! <blockquote class="mail">
<UL>
<LI><em>To</em>: <A HREF="mailto:mhonarc(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de">mhonarc(_at_)rosat(_dot_)mpe-garching(_dot_)mpg(_dot_)de</A></LI>
***************
*** 319,324 ****
command will process all messages of list:
</p>
! <pre>
! shell> <b>mhonarc <var>/list/archive/</var>[0-9]*</b>
</pre>
<p>Replace "<tt>/list/archive/</tt>" to what is appropriate for your
--- 324,329 ----
command will process all messages of list:
</p>
! <pre class="shell">
! prompt> <b>mhonarc <var>/list/archive/</var>[0-9]*</b>
</pre>
<p>Replace "<tt>/list/archive/</tt>" to what is appropriate for your
***************
*** 331,336 ****
should work:
</p>
! <pre>
! shell> <b>mhonarc `find <var>/list/archive/</var> -type d -name '[0-9]*' -print`</b>
</pre>
<p>Note, make sure to add any additional options to mhonarc as needed
--- 336,341 ----
should work:
</p>
! <pre class="shell">
! prompt> <b>mhonarc `find <var>/list/archive/</var> -type d -name '[0-9]*' -print`</b>
</pre>
<p>Note, make sure to add any additional options to mhonarc as needed
***************
*** 356,361 ****
all non-dotfiles. Example:
</p>
! <pre>
! shell> <b>mhonarc -mhpattern '^[^\.]' <var>MAILDIR</var>/cur</b>
</pre>
<p>If all you will ever do is process qmail maildir folders, it may be best
--- 361,366 ----
all non-dotfiles. Example:
</p>
! <pre class="shell">
! prompt> <b>mhonarc -mhpattern '^[^\.]' <var>MAILDIR</var>/cur</b>
</pre>
<p>If all you will ever do is process qmail maildir folders, it may be best
***************
*** 365,371 ****
<dl>
<dt>csh:
! <dd><b><tt>setenv M2H_MHPATTERN '^[^\.]'</tt></b>
<dt>sh:
! <dd><b><tt>M2H_MHPATTERN='^[^\.]'; export M2H_MHPATTERN</tt></b>
</dl>
--- 370,376 ----
<dl>
<dt>csh:
! <dd><b><tt class="ishell">setenv M2H_MHPATTERN '^[^\.]'</tt></b>
<dt>sh:
! <dd><b><tt class="ishell">M2H_MHPATTERN='^[^\.]'; export M2H_MHPATTERN</tt></b>
</dl>
***************
*** 394,399 ****
mail in your Inbox, do something like the following:
</p>
! <pre>
! shell> <b>mhonarc $HOME/nsmail/Inbox</b>
</pre>
--- 399,404 ----
mail in your Inbox, do something like the following:
</p>
! <pre class="shell">
! prompt> <b>mhonarc $HOME/nsmail/Inbox</b>
</pre>
***************
*** 427,431 ****
<p>Here is a response from a user:
</p>
! <blockquote>
<UL>
<LI><em>Subject</em>: Re: CompuServe --> html</LI>
--- 432,436 ----
<p>Here is a response from a user:
</p>
! <blockquote class="mail">
<UL>
<LI><em>Subject</em>: Re: CompuServe --> html</LI>
***************
*** 523,526 ****
--- 528,544 ----
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
+ <h3><b><a name="japanese">How about Japanese?</a></b></h3>
+ </td></tr></table>
+
+ <p>Yes. For details about Japanese usage of MHonArc, goto:<br>
+ <a href="http://www.shiratori.riec.tohoku.ac.jp/~p-katoh/Hack/Docs/mhonarc-jp/index.html";><http://www.shiratori.riec.tohoku.ac.jp/~p-katoh/Hack/Docs/mhonarc-jp/index.html></a><br>
+ <a href="http://www.shiratori.riec.tohoku.ac.jp/~p-katoh/Hack/Docs/mhonarc-jp/mhonarc-jp-2_4.html";><http://www.shiratori.riec.tohoku.ac.jp/~p-katoh/Hack/Docs/mhonarc-jp/mhonarc-jp-2_4.html></a><br>
+ (documents are in Japanese).
+ </p>
+
+ <!-- ??????????????????????????????????????????????????????????????? -->
+ <hr noshade size=1>
+ <table border=0>
+ <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="bilingual">Can I create bilingual archives?</a></b></h3>
</td></tr></table>
***************
*** 532,551 ****
to use whatever text (English or non-English) you desire.
</p>
! <dl>
! <dt><strong>NOTE</strong></dt>
! <dd><p>There is no support for mulitple variations of message
pages in an archive. Therefore, a single language must be
chosen for message pages, or you can include redundant information
using multiple languages.
</p>
! </dd>
! </dl>
! <dl>
! <dt><strong>NOTE</strong></dt>
! <dd><p>Actual message data will be in the language used in the
message. MHonArc has no built-in language translation.
</p>
! </dd>
! </dl>
<dl>
--- 550,576 ----
to use whatever text (English or non-English) you desire.
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! There is no support for mulitple variations of message
pages in an archive. Therefore, a single language must be
chosen for message pages, or you can include redundant information
using multiple languages.
</p>
! </td>
! </tr>
! </table>
! <p> </p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! Actual message data will be in the language used in the
message. MHonArc has no built-in language translation.
</p>
! </td>
! </tr>
! </table>
<dl>
***************
*** 562,570 ****
</td></tr></table>
! <p>Not directly, but it is possible to have MHonArc generate
! UTF-8 HTML pages. See the <tt>utf-8.mrc</tt> example resource
! file in the <cite>Appendix: Resource File Examples</cite> section
! of the documentation for more information and caveats.
</p>
<!-- ===================================================================== -->
--- 587,600 ----
</td></tr></table>
! <p>Yes, mostly. It depends on where you require the support and
! what version of Perl you are using and what Perl modules you have
! installed. Checking out the following for more information:
</p>
+ <ul>
+ <li><a href="../resources/charsetconverters.html">CHARSETCONVERTERS</a>
+ resource.</li>
+ <li><a href="../rcfileexs/utf-8.mrc.html"><tt>utf-8.mrc</tt></a> example
+ resource file.</li>
+ </ul>
<!-- ===================================================================== -->
***************
*** 572,577 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="general.html">Prev</a>][<a href="usage.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 602,606 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="general.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="usage.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: faq.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/faq.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -C2 -r1.26 -r1.27
*** faq.html 14 Nov 2002 02:55:35 -0000 1.26
--- faq.html 18 Dec 2002 05:55:21 -0000 1.27
***************
*** 1,6 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc Frequently Asked Questions</TITLE></HEAD>
<BODY>
--- 1,6 ----
<HTML>
<HEAD>
<TITLE>MHonArc Frequently Asked Questions</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
***************
*** 15,23 ****
asked question on MHonArc. MHonArc is
a <A HREF="http://language.perl.com/";>Perl</A> program
! for converting e-mail messages as specified in RFC 822 and <A
! HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html";>MIME</a> to <A
HREF="http://www.w3.org/hypertext/WWW/MarkUp/MarkUp.html";>HTML</A>.
MHonArc has the ability to maintain an archive of converted
! messages, or it can be used as a basic e-mail->HTML converter. </P>
<!-- ===================================================================== -->
--- 15,23 ----
asked question on MHonArc. MHonArc is
a <A HREF="http://language.perl.com/";>Perl</A> program
! for converting mail messages as specified in RFC 822 and <A
! HREF="http://www.mhonarc.org/~ehood/MIME/";>MIME</a> to <A
HREF="http://www.w3.org/hypertext/WWW/MarkUp/MarkUp.html";>HTML</A>.
MHonArc has the ability to maintain an archive of converted
! messages, or it can be used as a basic mail->HTML converter. </P>
<!-- ===================================================================== -->
***************
*** 68,71 ****
--- 68,72 ----
<li><a name="otherformats" href="envs.html#otherformats">What about other mailbox/folder formats?</a></li>
<li><a name="nonenglish" href="envs.html#nonenglish">Can MHonArc create non-English archives?</a></li>
+ <li><a name="japanese" href="envs.html#japanese">How about Japanese?</a></li>
<li><a name="bilingual" href="envs.html#bilingual">Can I create bilingual archives?</a></li>
<li><a name="unicode" href="envs.html#unicode">Does MHonArc support Unicode?</a></li>
***************
*** 161,165 ****
<li><a name="contact" href="security.html#contact">Who do I contact if I find a vulnerability with MHonArc?</a></li>
<li><a name="spam" href="security.html#spam">Can I obscure email addresses?</a></li>
! <li><a name="spam" href="security.html#spam">How can I prevent web access to <tt>.mhonarc.db</tt> files?</a></li>
<li><a name="htmldata" href="security.html#htmldata">Why are HTML messages a security risk?</a></li>
<li><a name="attachments" href="security.html#attachments">Why doesn't MHonArc, by default, use the specified filename when saving attachments?</a></li>
--- 162,166 ----
<li><a name="contact" href="security.html#contact">Who do I contact if I find a vulnerability with MHonArc?</a></li>
<li><a name="spam" href="security.html#spam">Can I obscure email addresses?</a></li>
! <li><a name="mhonarc_db" href="security.html#mhonarc_db">How can I prevent web access to <tt>.mhonarc.db</tt> files?</a></li>
<li><a name="htmldata" href="security.html#htmldata">Why are HTML messages a security risk?</a></li>
<li><a name="attachments" href="security.html#attachments">Why doesn't MHonArc, by default, use the specified filename when saving attachments?</a></li>
Index: general.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/general.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -C2 -r1.31 -r1.32
*** general.html 21 Jun 2002 22:28:16 -0000 1.31
--- general.html 18 Dec 2002 05:55:21 -0000 1.32
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: General Information</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="about.html">Prev</a>][<a href="envs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: General Information</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="about.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="envs.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 39,43 ****
<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.nacs.uci.edu/indiv/ehood/MIME/MIME.html";>the
MIME standard</A> to <A
HREF="http://www.w3.org/pub/WWW/MarkUp/";>HTML</A>.
--- 38,42 ----
<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>.
***************
*** 121,130 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top><td></td><td><hr noshade></td></tr>
! </tr>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>MHonArc is <strong>NOT</strong>
in the public domain. Any mention of MHonArc in the public domain
is <strong>WRONG</strong>. Applicable copyrights still apply.
--- 120,127 ----
</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
is <strong>WRONG</strong>. Applicable copyrights still apply.
***************
*** 132,136 ****
</td>
</tr>
- <tr valign=top><td></td><td><hr noshade></td></tr>
</table>
--- 129,132 ----
***************
*** 162,166 ****
with the command, </P>
! <pre>
subscribe mhonarc-users</pre>
--- 158,162 ----
with the command, </P>
! <pre class="code">
subscribe mhonarc-users</pre>
***************
*** 173,180 ****
distributed to all subscribers on the list. </P>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>The mailing list is restricted to subscribers only. Any
non-subscriber message sent to the list is manually filtered.
Due to the nature
--- 169,176 ----
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
***************
*** 221,228 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>If you notice any errors regarding the information related
to Hypermail, please contact the FAQ maintainer.
</p>
--- 217,224 ----
</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>
***************
*** 327,330 ****
--- 323,329 ----
</p>
<ul>
+ <li>mhonarc.org mail archives:<br>
+ <a href="http://http://www.mhonarc.org/archive/html/";
+ ><http://www.mhonarc.org/archive/html/></a>
<li>WWW Mailing List Archives & References:<br>
<a href="http://www.xray.mpe.mpg.de/mailing-lists/";
***************
*** 403,408 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="about.html">Prev</a>][<a href="envs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 402,406 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="about.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="envs.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: indexpgs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/indexpgs.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -r1.13 -r1.14
*** indexpgs.html 24 Dec 2001 14:38:39 -0000 1.13
--- indexpgs.html 18 Dec 2002 05:55:21 -0000 1.14
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Index Pages</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="archives.html">Prev</a>][<a href="msgpgs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Index Pages</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="archives.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="msgpgs.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 49,53 ****
refer to the main index apply to either an author, date, or
subject index. The type of main index is controled by
! the SORT, SUBSORT, AUTHSORT resources.
</p>
--- 48,52 ----
refer to the main index apply to either an author, date, or
subject index. The type of main index is controled by
! the <a href="../resources/sort.html">SORT</a>, <a href="../resources/subsort.html">SUBSORT</a>, AUTHSORT resources.
</p>
***************
*** 65,86 ****
<P>Yes. In version 1.2 (or later), a resource was added called
! <strong>OTHERINDEXES</strong>. With this resource, you are able to
define an arbitrary number of indexes you desire. The additional
indexes may be in any format you desire and that is supported
by MHonArc. Refer to the documentation for the usage of
! <strong>OTHERINDEXES</strong> (also see
"<a href="#otherindexes">How does the OTHERINDEXES resource work?</a>").
</P>
! <dl>
! <dt><strong>NOTE</strong></dt>
! <dd><p>MHonArc will <strong>NOT</strong> automatically
! create links to any indexes created via the OTHERINDEXES resource.
You will need to modify the relevant index and messages resources
! to contain the additional links. See the LISTBEGIN and
THEAD resources.
</p>
! </dd>
! </dl>
<!-- ??????????????????????????????????????????????????????????????? -->
--- 64,90 ----
<P>Yes. In version 1.2 (or later), a resource was added called
! <a href="../resources/otherindexes.html">OTHERINDEXES</a>. With this resource, you are able to
define an arbitrary number of indexes you desire. The additional
indexes may be in any format you desire and that is supported
by MHonArc. Refer to the documentation for the usage of
! <a href="../resources/otherindexes.html">OTHERINDEXES</a> (also see
"<a href="#otherindexes">How does the OTHERINDEXES resource work?</a>").
</P>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! MHonArc will <strong>NOT</strong> automatically
! create links to any indexes created via the
! <a href="../resources/otherindexes.html">OTHERINDEXES</a> resource.
You will need to modify the relevant index and messages resources
! to contain the additional links. See the
! <a href="../resources/listbegin.html">LISTBEGIN</a> and
THEAD resources.
</p>
! </td>
! </tr>
! </table>
<!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 91,96 ****
</td></tr></table>
! <p>Yes, in v2.0 or later. Setting the MULTIPG and IDXSIZE will cause
! indexes to to be listed across multiple pages with IDXSIZE determine
the number of messages listed per page.
</p>
--- 95,103 ----
</td></tr></table>
! <p>Yes, in v2.0 or later. Setting the
! <a href="../resources/multipg.html">MULTIPG</a> and
! <a href="../resources/idxsize.html">IDXSIZE</a> will cause
! indexes to to be listed across multiple pages with
! <a href="../resources/idxsize.html">IDXSIZE</a> determine
the number of messages listed per page.
</p>
***************
*** 113,117 ****
</td></tr></table>
! <p>I am going to describe a basic example on how OTHERINDEXES can be used.
</p>
<p>First, lets have the top resource file (call it "top.mrc") that
--- 120,124 ----
</td></tr></table>
! <p>I am going to describe a basic example on how <a href="../resources/otherindexes.html">OTHERINDEXES</a> can be used.
</p>
<p>First, lets have the top resource file (call it "top.mrc") that
***************
*** 119,128 ****
a thread). Example:
</p>
! <pre>*** snip "top.mrc" ***
! <MAIN>
! <THREAD>
! <SORT>
! <NOTREVERSE>
! <NOREVERSE>
*** snip "top.mrc" ***
</pre>
--- 126,135 ----
a thread). Example:
</p>
! <pre class="code">*** snip "top.mrc" ***
! <<a href="../resources/main.html">MAIN</a>>
! <<a href="../resources/thread.html">THREAD</a>>
! <<a href="../resources/sort.html">SORT</a>>
! <<a href="../resources/treverse.html">NOTREVERSE</a>>
! <<a href="../resources/reverse.html">NOREVERSE</a>>
*** snip "top.mrc" ***
</pre>
***************
*** 138,143 ****
In "top.mrc" I would add the following:
</p>
! <pre>*** snip "top.mrc" ***
! <OTHERINDEXES>
subject.mrc
author.mrc
--- 145,150 ----
In "top.mrc" I would add the following:
</p>
! <pre class="code">*** snip "top.mrc" ***
! <<a href="../resources/otherindexes.html">OTHERINDEXES</a>>
subject.mrc
author.mrc
***************
*** 154,213 ****
<p>The following now shows the important settings for each file:
</p>
! <pre>*** snip "subject.mrc" ***
! <MAIN>
! <NOTHREAD>
! <SUBSORT>
! <IDXFNAME>
subject.html
</IDXFNAME>
! <IDXPREFIX>
subject
</IDXPREFIX>
! <NOREVERSE>
*** snip "subject.mrc" ***
</pre>
! <pre>*** snip "author.mrc" ***
! <MAIN>
! <NOTHREAD>
<AUTHSORT>
! <IDXFNAME>
author.html
</IDXFNAME>
! <IDXPREFIX>
author
</IDXPREFIX>
! <NOREVERSE>
*** snip "author.mrc" ***
</pre>
<p>Again, notice how I am being explicit. MHonArc does not reset
resources when reading the otherindexes resource files. with one
! <em>exception</em>: THREAD is shut-off. To avoid overriding the default
! index files, I must explicitly redefine IDXFNAME (amd IDXPREFIX
! if MULTIPG is active). If I want different layouts for my
other indexes, I must explicitly define those, or they will
use what was ever set in top.mrc (or the applicable default resource setting(s)
when no explicit setting provided).
</p>
! <p><strong>NOTE</strong>:
! Otherindexes resource file only defines a *single* index type: main
! or thread. If you specify the THREAD, a thread index will be
! created and all MAIN related resources are ignored. I.e. THREAD
! overrides MAIN.
! </p>
! <p><strong>WARNING</strong>:
! Do <b>NOT</b> define OTHERINDEXES in your otherindexes resource files.
Also, make sure there is no self references. If you do not heed
these warnings, you will cause an infinite loop, and/or
unpredictable results.
</p>
! <p>Make sure OTHERINDEXES resource files are present for all
updates to an archive. Mhonarc only stores settings for the
default indexes, so the resource files are needed each time
for other indexes.
</p>
! <p>What I left out in this example is the redefinition of the navigational
! based resources. Since I am adding more indexes, I would have to
! redefine resources like TOPLINK, BOTLINKS, LISTBEGIN, THEAD, etc, so
! there will be links to the other indexes.
</p>
--- 161,239 ----
<p>The following now shows the important settings for each file:
</p>
! <pre class="code">*** snip "subject.mrc" ***
! <<a href="../resources/main.html">MAIN</a>>
! <<a href="../resources/thread.html">NOTHREAD</a>>
! <<a href="../resources/subsort.html">SUBSORT</a>>
! <<a href="../resources/idxfname.html">IDXFNAME</a>>
subject.html
</IDXFNAME>
! <<a href="../resources/idxprefix.html">IDXPREFIX</a>>
subject
</IDXPREFIX>
! <<a href="../resources/reverse.html">NOREVERSE</a>>
*** snip "subject.mrc" ***
</pre>
! <pre class="code">*** snip "author.mrc" ***
! <<a href="../resources/main.html">MAIN</a>>
! <<a href="../resources/thread.html">NOTHREAD</a>>
<AUTHSORT>
! <<a href="../resources/idxfname.html">IDXFNAME</a>>
author.html
</IDXFNAME>
! <<a href="../resources/idxprefix.html">IDXPREFIX</a>>
author
</IDXPREFIX>
! <<a href="../resources/reverse.html">NOREVERSE</a>>
*** snip "author.mrc" ***
</pre>
<p>Again, notice how I am being explicit. MHonArc does not reset
resources when reading the otherindexes resource files. with one
! <em>exception</em>: <a href="../resources/thread.html">THREAD</a> is shut-off. To avoid overriding the default
! index files, I must explicitly redefine <a href="../resources/idxfname.html">IDXFNAME</a> (amd <a href="../resources/idxprefix.html">IDXPREFIX</a>
! if <a href="../resources/multipg.html">MULTIPG</a> is active). If I want different layouts for my
other indexes, I must explicitly define those, or they will
use what was ever set in top.mrc (or the applicable default resource setting(s)
when no explicit setting provided).
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! Otherindexes resource file only defines a <strong>single</strong>
! index type: main
! or thread. If you specify the <a href="../resources/thread.html">THREAD</a>, a thread index will be
! created and all <a href="../resources/main.html">MAIN</a> related resources are ignored. I.e. <a href="../resources/thread.html">THREAD</a>
! overrides <a href="../resources/main.html">MAIN</a>.
! </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>
! Do <b>NOT</b> define <a href="../resources/otherindexes.html">OTHERINDEXES</a> in your otherindexes resource files.
Also, make sure there is no self references. If you do not heed
these warnings, you will cause an infinite loop, and/or
unpredictable results.
</p>
! </td>
! </tr>
! </table>
! <p>Make sure <a href="../resources/otherindexes.html">OTHERINDEXES</a> resource files are present for all
updates to an archive. Mhonarc only stores settings for the
default indexes, so the resource files are needed each time
for other indexes.
</p>
!
! <p>What I left out in this example is the redefinition
! of the navigational based resources. Since I am adding
! more indexes, I would have to redefine resources like
! <a href="../resources/toplinks.html">TOPLINKS</a>,
! <a href="../resources/botlinks.html">BOTLINKS</a>,
! <a href="../resources/listbegin.html">LISTBEGIN</a>,
! <a href="../resources/thead.html">THEAD</a>, etc, so there will be links
! to the other indexes.
</p>
***************
*** 231,235 ****
deleted if the message is removed from the archive.
</p>
! <p>Then, you define the LITEMPLATE resource to use a server-side include
to include the file as part of the message listing. I did say
it was dirty, but it should work.
--- 257,262 ----
deleted if the message is removed from the archive.
</p>
! <p>Then, you define the <a href="../resources/litemplate.html">LITEMPLATE</a>
! resource to use a server-side include
to include the file as part of the message listing. I did say
it was dirty, but it should work.
***************
*** 240,245 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="archives.html">Prev</a>][<a href="msgpgs.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 267,271 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="archives.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="msgpgs.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: mime.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/mime.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -r1.17 -r1.18
*** mime.html 28 Jun 2002 03:28:10 -0000 1.17
--- mime.html 18 Dec 2002 05:55:21 -0000 1.18
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: MIME</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="threads.html">Prev</a>][<a href="security.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: MIME</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="threads.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="security.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 41,45 ****
Mail Extensions</EM>.
An HTML version of the RFCs that define MIME are available at (<A
! HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html";>http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html</A>).
</P>
--- 40,44 ----
Mail Extensions</EM>.
An HTML version of the RFCs that define MIME are available at (<A
! HREF="http://www.mhonarc.org/~ehood/MIME/";>http://www.mhonarc.org/~ehood/MIME/</A>).
</P>
***************
*** 47,52 ****
allow multi-part textual and non-textual message bodies to
be represented and exchanged without loss of information." [<A
! HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/1521/rfc1521ToC.html";>RFC
! 1521</A>] </P>
<!-- ??????????????????????????????????????????????????????????????? -->
--- 46,51 ----
allow multi-part textual and non-textual message bodies to
be represented and exchanged without loss of information." [<A
! HREF="http://www.mhonarc.org/~ehood/MIME/1521/rfc1521ToC.html";>RFC 1521</A>]
! </P>
<!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 57,61 ****
</td></tr></table>
! <P>v2.0 or later. Review the CHARSETCONVERTERS resource page for
which character sets are supported by MHonArc and how to extend
MHonArc to support other character sets.
--- 56,60 ----
</td></tr></table>
! <P>v2.0 or later. Review the <a href="../resources/charsetconverters.html">CHARSETCONVERTERS</a> resource page for
which character sets are supported by MHonArc and how to extend
MHonArc to support other character sets.
***************
*** 69,73 ****
</td></tr></table>
! <P>This question can be anwsered by reading about the MIMEFILTERS
resource of the
MHonArc documentation. The solution may require registering
--- 68,72 ----
</td></tr></table>
! <P>This question can be anwsered by reading about the <a href="../resources/mimefilters.html">MIMEFILTERS</a>
resource of the
MHonArc documentation. The solution may require registering
***************
*** 84,89 ****
<p>Yes. MHonArc's default filters are hooked in
! as described in the MIMEFILTERS resource. Note, please review the
! options available for the default filters described in the MIMEFILTERS
resource page since they may already provide the capability you
need.
--- 83,88 ----
<p>Yes. MHonArc's default filters are hooked in
! 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.
***************
*** 116,120 ****
is have the senders of the messages label the data properly. You
can also check out the <b><tt>m2h_external::filter</tt></b> options documented
! in the MIMEFILTERS page of the documentation for some possible alternate
solutions.
</p>
--- 115,119 ----
is have the senders of the messages label the data properly. You
can also check out the <b><tt>m2h_external::filter</tt></b> options documented
! in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> page of the documentation for some possible alternate
solutions.
</p>
***************
*** 128,136 ****
<p>Yes. See the <b><tt>m2h_external::filter</tt></b> options documented
! in the MIMEFILTERS page of the documentation. Make note of the
security cautions in the documentation.
Example:
</p>
! <pre>
<MIMEArgs>
m2h_external::filter; usename
--- 127,135 ----
<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">
<MIMEArgs>
m2h_external::filter; usename
***************
*** 153,160 ****
<p>Yes. See the options available for the <b>m2h_text_plain::filter</b>
! described in the MIMEFILTERS resource page of the documentation.
Example:
</p>
! <pre>
<MIMEArgs>
m2h_text_plain::filter; nonfixed
--- 152,159 ----
<p>Yes. See the options available for the <b>m2h_text_plain::filter</b>
! described in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> resource page of the documentation.
Example:
</p>
! <pre class="code">
<MIMEArgs>
m2h_text_plain::filter; nonfixed
***************
*** 170,177 ****
<p>Yes. See the options available for the <b>m2h_text_plain::filter</b>
! described in the MIMEFILTERS resource page of the documentation.
Example:
</p>
! <pre>
<-- Make sure lines are no longer than 80 characters -->
<MIMEArgs>
--- 169,176 ----
<p>Yes. See the options available for the <b>m2h_text_plain::filter</b>
! described in the <a href="../resources/mimefilters.html">MIMEFILTERS</a> resource page of the documentation.
Example:
</p>
! <pre class="code">
<-- Make sure lines are no longer than 80 characters -->
<MIMEArgs>
***************
*** 187,194 ****
</td></tr></table>
! <p>Yes. See the MIMEEXCS resource.
Example:
</p>
! <pre>
<-- Exclude all HTML and binary data -->
<MIMEExcs>
--- 186,193 ----
</td></tr></table>
! <p>Yes. See the <a href="../resources/mimeexcs.html">MIMEEXCS</a> resource.
Example:
</p>
! <pre class="code">
<-- Exclude all HTML and binary data -->
<MIMEExcs>
***************
*** 205,212 ****
</td></tr></table>
! <p>Yes, in v2.5.8, and later, via the MIMEALTPREFS resource.
Example:
</p>
! <pre>
<MIMEAltPrefs>
text/plain
--- 204,211 ----
</td></tr></table>
! <p>Yes, in v2.5.8, and later, via the <a href="../resources/mimealtprefs.html">MIMEALTPREFS</a> resource.
Example:
</p>
! <pre class="code">
<MIMEAltPrefs>
text/plain
***************
*** 219,224 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="threads.html">Prev</a>][<a href="security.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 218,222 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="threads.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="security.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: msgpgs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/msgpgs.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -r1.11 -r1.12
*** msgpgs.html 24 Dec 2001 14:38:39 -0000 1.11
--- msgpgs.html 18 Dec 2002 05:55:21 -0000 1.12
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Message Pages</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="indexpgs.html">Prev</a>][<a href="threads.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Message Pages</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="indexpgs.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="threads.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 36,41 ****
<p>No. However, with the exceptions of the message header and body
(but see next questions), those resource can be defined
! anyway you like. For example, I can change the TOPLINKS resource
! to look like the BOTLINKS resource. Or, I can change the
default meaning of the resource so it really outputs something
else entirely. If you look at the documentation, the resources
--- 35,40 ----
<p>No. However, with the exceptions of the message header and body
(but see next questions), those resource can be defined
! anyway you like. For example, I can change the <a href="../resources/toplinks.html">TOPLINKS</a> resource
! to look like the <a href="../resources/botlinks.html">BOTLINKS</a> resource. Or, I can change the
default meaning of the resource so it really outputs something
else entirely. If you look at the documentation, the resources
***************
*** 57,82 ****
</p>
<pre>
! <b><FIELDSBEG></b>
<table>
<tbody>
! <b></FIELDSBEG></b>
! <b><LABELBEG></b>
<tr>
<td align="right" valign="top">
! <b></LABELBEG></b>
! <b><LABELEND></b>
</td>
! <b></LABELEND></b>
! <b><FLDBEG></b>
<td align="left">
! <b></FLDBEG></b>
! <b><FLDEND></b>
</td>
</tr>
! <b></FLDEND></b>
! <b><FIELDSEND></b>
</tbody>
</table>
! <b></FIELDSEND></b>
</pre>
--- 56,81 ----
</p>
<pre>
! <b><<a href="../resources/fieldsbeg.html">FIELDSBEG</a>></b>
<table>
<tbody>
! <b></<a href="../resources/fieldsbeg.html">FIELDSBEG</a>></b>
! <b><<a href="../resources/labelbeg.html">LABELBEG</a>></b>
<tr>
<td align="right" valign="top">
! <b></<a href="../resources/labelbeg.html">LABELBEG</a>></b>
! <b><<a href="../resources/labelend.html">LABELEND</a>></b>
</td>
! <b></<a href="../resources/labelend.html">LABELEND</a>></b>
! <b><<a href="../resources/fldbeg.html">FLDBEG</a>></b>
<td align="left">
! <b></<a href="../resources/fldbeg.html">FLDBEG</a>></b>
! <b><<a href="../resources/fldend.html">FLDEND</a>></b>
</td>
</tr>
! <b></<a href="../resources/fldend.html">FLDEND</a>></b>
! <b><<a href="../resources/fieldsend.html">FIELDSEND</a>></b>
</tbody>
</table>
! <b></<a href="../resources/fieldsend.html">FIELDSEND</a>></b>
</pre>
***************
*** 84,93 ****
</p>
<pre>
! <b><FIELDORDER></b>
from
subject
date
-extra-
! <b></FIELDORDER></b>
</pre>
<p>The "-extra-" signifies all other message fields in alphabetic
--- 83,92 ----
</p>
<pre>
! <b><<a href="../resources/fieldorder.html">FIELDORDER</a>></b>
from
subject
date
-extra-
! <b></<a href="../resources/fieldorder.html">FIELDORDER</a>></b>
</pre>
<p>The "-extra-" signifies all other message fields in alphabetic
***************
*** 98,105 ****
</p>
<pre>
! <b><EXCS></b>
x-
precendence
! <b></EXCS></b>
</pre>
<p>Here, we are exluding all "X-..." fields and the Precendence
--- 97,104 ----
</p>
<pre>
! <b><<a href="../resources/excs.html">EXCS</a>></b>
x-
precendence
! <b></<a href="../resources/excs.html">EXCS</a>></b>
</pre>
<p>Here, we are exluding all "X-..." fields and the Precendence
***************
*** 138,149 ****
declarations are used to mark off the different sections of a message).
Therefore, you cannot have the body come before the message header.
! The best you can do is suppress the header (via EXCS) and create a
bogus header via the resource variables available. For example:
</p>
<pre>
! <b><EXCS override></b>
.
! <b></EXCS></b>
! <b><MSGFOOT></b>
<ul>
<li>From: $FROM$
--- 137,148 ----
declarations are used to mark off the different sections of a message).
Therefore, you cannot have the body come before the message header.
! The best you can do is suppress the header (via <a href="../resources/excs.html">EXCS</a>) and create a
bogus header via the resource variables available. For example:
</p>
<pre>
! <b><<a href="../resources/excs.html">EXCS</a> override></b>
.
! <b></<a href="../resources/excs.html">EXCS</a>></b>
! <b><<a href="../resources/msgfoot.html">MSGFOOT</a>></b>
<ul>
<li>From: $FROM$
***************
*** 151,155 ****
<li>Date: $DATE$
<ul>
! <b></MSGFOOT></b>
</pre>
--- 150,154 ----
<li>Date: $DATE$
<ul>
! <b></<a href="../resources/msgfoot.html">MSGFOOT</a>></b>
</pre>
***************
*** 164,169 ****
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 EDITIDX resource.
! The EDITIDX resource tells MHonArc to recreate all archive
pages.
</p>
--- 163,168 ----
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.
! The <a href="../resources/editidx.html">EDITIDX</a> resource tells MHonArc to recreate all archive
pages.
</p>
***************
*** 197,202 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="indexpgs.html">Prev</a>][<a href="threads.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 196,200 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="indexpgs.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="threads.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: security.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/security.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** security.html 10 Dec 2002 04:08:02 -0000 1.3
--- security.html 18 Dec 2002 05:55:21 -0000 1.4
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Security</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="mime.html">Prev</a>][Next][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Security</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="mime.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[Next]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 19,23 ****
<li><a href="#contact">Who do I contact if I find a vulnerability with MHonArc?</a></li>
<li><a href="#spam">Can I obscure email addresses?</a></li>
! <li><a href="#spam">How can I prevent web access to <tt>.mhonarc.db</tt> files?</a></li>
<li><a href="#htmldata">Why are HTML messages a security risk?</a></li>
<li><a href="#attachments">Why doesn't MHonArc, by default, use the specified filename when saving attachments?</a></li>
--- 18,22 ----
<li><a href="#contact">Who do I contact if I find a vulnerability with MHonArc?</a></li>
<li><a href="#spam">Can I obscure email addresses?</a></li>
! <li><a href="#mhonarc_db">How can I prevent web access to <tt>.mhonarc.db</tt> files?</a></li>
<li><a href="#htmldata">Why are HTML messages a security risk?</a></li>
<li><a href="#attachments">Why doesn't MHonArc, by default, use the specified filename when saving attachments?</a></li>
***************
*** 70,74 ****
</td></tr></table>
! <p>See the <b>SPAMMODE</b> resource.
</p>
--- 69,73 ----
</td></tr></table>
! <p>See the <a href="../resources/spammode.html">SPAMMODE</a> resource.
</p>
***************
*** 92,96 ****
the following configuration directive can be used:
</p>
! <pre>
<Files .mhonarc.db>
Order allow,deny
--- 91,95 ----
the following configuration directive can be used:
</p>
! <pre class="code">
<Files .mhonarc.db>
Order allow,deny
***************
*** 101,105 ****
instead:
</p>
! <pre>
RewriteRule ^(.*)/.mhonarc.db $1 [R=permanent]
</pre>
--- 100,104 ----
instead:
</p>
! <pre class="code">
RewriteRule ^(.*)/.mhonarc.db $1 [R=permanent]
</pre>
***************
*** 109,116 ****
<p>An alternative to a web server-based solution, you can use the
! <b>DBFILE</b> resource to place the database file in a non-web server
accessible location by specifying a full pathname of the database file
! to use. <strong>Note:</strong> Using a full pathname for DBFILE is
! supported only in v2.5.13, or later. </p>
<!-- ??????????????????????????????????????????????????????????????? -->
--- 108,125 ----
<p>An alternative to a web server-based solution, you can use the
! <a href="../resources/dbfile.html">DBFILE</a> resource to place the database file in a non-web server
accessible location by specifying a full pathname of the database file
! to use. </p>
!
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! Using a full pathname for <a href="../resources/dbfile.html">DBFILE</a> is
! supported only in v2.5.13, or later.
! </p>
! </td>
! </tr>
! </table>
<!-- ??????????????????????????????????????????????????????????????? -->
***************
*** 152,160 ****
</ul>
! <p>MHonArc's HTML filter (documented under the <b>MIMEFILTERS</b>)
resource provides functionality of stripping out HTML data to
minimize security exploits. Check the document for full details.
The general recommendation for the security conscience is to exclude
! any HTML message data via the <b>MIMEEXCS</b> resource, especially
for publicly accessible archives. </p>
--- 161,169 ----
</ul>
! <p>MHonArc's HTML filter (documented under the <a href="../resources/mimefilters.html">MIMEFILTERS</a>)
resource provides functionality of stripping out HTML data to
minimize security exploits. Check the document for full details.
The general recommendation for the security conscience is to exclude
! any HTML message data via the <a href="../resources/mimeexcs.html">MIMEEXCS</a> resource, especially
for publicly accessible archives. </p>
***************
*** 186,190 ****
<p>It is because of the above reasons that the
! <tt><b>m2h_external::filter</b></tt> documented in the <b>MIMEFILTERS</b>
resource advises caution when using the filter options that enable
the usage of attachment filenames or filename extensions.
--- 195,200 ----
<p>It is because of the above reasons that the
! <a href="../resources/mimefilters.html#m2h_external"><tt>m2h_external::filter</tt></a>
! documented in the <a href="../resources/mimefilters.html">MIMEFILTERS</a>
resource advises caution when using the filter options that enable
the usage of attachment filenames or filename extensions.
***************
*** 209,214 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="mime.html">Prev</a>][Next][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 219,223 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="mime.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[Next]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: threads.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/threads.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -C2 -r1.12 -r1.13
*** threads.html 24 Dec 2001 14:38:40 -0000 1.12
--- threads.html 18 Dec 2002 05:55:21 -0000 1.13
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Threading</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="msgpgs.html">Prev</a>][<a href="mime.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: Threading</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="msgpgs.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="mime.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 70,74 ****
</P>
! <PRE>%<{date}In-reply-to: Your message of "\
%<(nodate{date})%{date}%|%(pretty{date})%>."%<{message-id}
%{message-id}%>\n%>\
--- 69,73 ----
</P>
! <PRE class="code">%<{date}In-reply-to: Your message of "\
%<(nodate{date})%{date}%|%(pretty{date})%>."%<{message-id}
%{message-id}%>\n%>\
***************
*** 79,83 ****
<CODE>References</CODE> field format: </P>
! <PRE>%<{message-id}References: \
%<{references}%(void{references})%(trim)%(putstr) %>
%(void{message-id})%(trim)%(putstr)\n%>\
--- 78,82 ----
<CODE>References</CODE> field format: </P>
! <PRE class="code">%<{message-id}References: \
%<{references}%(void{references})%(trim)%(putstr) %>
%(void{message-id})%(trim)%(putstr)\n%>\
***************
*** 92,97 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="msgpgs.html">Prev</a>][<a href="mime.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 91,95 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="msgpgs.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="mime.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
Index: usage.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/usage.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** usage.html 21 Jun 2002 22:28:16 -0000 1.18
--- usage.html 18 Dec 2002 05:55:21 -0000 1.19
***************
*** 1,11 ****
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: General Usage</TITLE></HEAD>
<BODY>
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="envs.html">Prev</a>][<a href="archives.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 1,10 ----
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: General Usage</TITLE></HEAD>
+ <link rel="stylesheet" type="text/css" href="../docstyles.css">
<BODY>
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="envs.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="archives.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
***************
*** 50,54 ****
</p>
! <p>See the documentation for more information.
</p>
--- 49,54 ----
</p>
! <p>See the <a href="../resources.html"><cite>Resources</cite></a>
! section of the documentation for more information.
</p>
***************
*** 67,71 ****
and add something like the following to your .vimrc file:
</p>
! <pre>
au BufNewFile,BufRead *.mrc so $HOME/share/vim/syntax/mhonarc.vim
</pre>
--- 67,71 ----
and add something like the following to your .vimrc file:
</p>
! <pre class="code">
au BufNewFile,BufRead *.mrc so $HOME/share/vim/syntax/mhonarc.vim
</pre>
***************
*** 88,103 ****
your resource file:
</p>
! <pre>
! <BotLinks>
! </BotLinks>
</pre>
<p>Notice the blank line. If you specify no content, MHonArc will
fallback to the default value of the resource.
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong><font color="red">WARNING</font></strong></td>
! <td><p>Only do the above for page layout related resources.
For other resources, the above technique will have no effect, or
it may cause unexpected results. See
--- 88,104 ----
your resource file:
</p>
! <pre class="code">
! <b><BotLinks></b>
! <b></BotLinks></b>
</pre>
<p>Notice the blank line. If you specify no content, MHonArc will
fallback to the default value of the resource.
</p>
! <table class="caution" width="100%">
! <tr valign="baseline">
! <td><strong style="color: red;">WARNING:</strong></td>
! <td width="100%"><p>
! Only do the above for page layout related resources.
For other resources, the above technique will have no effect, or
it may cause unexpected results. See
***************
*** 120,128 ****
resource values:
</p>
! <pre>
! shell> <b>mha-dbedit -nosaveresources -outdir <var>/path/to/your/archive</var></b>
! shell> <b>mhonarc -saveresources -editidx -outdir <var>/path/to/your/archive</var></b>
</pre>
! <p>You could also include <tt>-rcfile</tt> option(s) to the last step if
you want to modify some resources from the default in case you want
to reset some resources and not all of them.
--- 121,131 ----
resource values:
</p>
! <pre class="shell">
! prompt> <b>mha-dbedit <a class="shell" href="../resources/saveresources.html">-nosaveresources</a> <a class="shell" href="../resources/outdir.html">-outdir</a> <var>/path/to/your/archive</var></b>
! prompt> <b>mhonarc <a class="shell" href="../resources/saveresources.html">-saveresources</a> <a class="shell" href="../resources/editidx.html">-editidx</a> <a class="shell" href="../resources/outdir.html">-outdir</a> <var>/path/to/your/archive</var></b>
</pre>
! <p>You could also include
! <a href="../resources/rcfile.html"><tt>-rcfile</tt></a> option
! to the last step if
you want to modify some resources from the default in case you want
to reset some resources and not all of them.
***************
*** 141,148 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>v2.3 and later use <b>Getopt::Long</b>, which is included
in the Perl 5 distribution.
</p>
--- 144,151 ----
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>v2.3 and later use <b>Getopt::Long</b>, which is included
in the Perl 5 distribution.
</p>
***************
*** 151,155 ****
</table>
-
<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
--- 154,157 ----
***************
*** 180,187 ****
</p>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>You may also want to check out the following:
</p>
<ul>
--- 182,189 ----
</p>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>You may also want to check out the following:
</p>
<ul>
***************
*** 203,206 ****
--- 205,209 ----
by Majordomo's archive2.pl script.
</li>
+ <p> </p>
</ul>
</td>
***************
*** 247,254 ****
in the layout of the archive. </P>
! <table border=0 cellpadding=4>
! <tr valign=top>
! <td><strong>NOTE</strong></td>
! <td><p>When utilizing the <strong>OTHERINDEXES</strong> resource,
the resource filenames listed in the main resource file are stored
in the database, but the resources for each additional index are
--- 250,258 ----
in the layout of the archive. </P>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! When utilizing the <strong>OTHERINDEXES</strong> resource,
the resource filenames listed in the main resource file are stored
in the database, but the resources for each additional index are
***************
*** 277,282 ****
called "messages". I'd do the following:
</p>
! <pre>
! shell> <b>mhonarc -mhpattern "^[^.]" messages</b>
</pre>
<p>MHPATTERN can be any Perl regular expression. The one in
--- 281,286 ----
called "messages". I'd do the following:
</p>
! <pre class="shell">
! prompt> <b>mhonarc -mhpattern "^[^.]" messages</b>
</pre>
<p>MHPATTERN can be any Perl regular expression. The one in
***************
*** 288,295 ****
it one at a time. For example:
</p>
! <pre>
! shell> <b>mhonarc -add < file1.822</b>
! shell> <b>mhonarc -add < file2.822</b>
! ...
</pre>
--- 292,299 ----
it one at a time. For example:
</p>
! <pre class="shell">
! prompt> <b>mhonarc -add < file1.822</b>
! prompt> <b>mhonarc -add < file2.822</b>
! ...
</pre>
***************
*** 304,309 ****
the capability). The syntax is something like the following:
</p>
! <pre>
! shell> <b>mhonarc </b><var>[options-here]</var> <b>-- -</b>
</pre>
<p>The "--" tells MHonArc to terminate all command-line
--- 308,313 ----
the capability). The syntax is something like the following:
</p>
! <pre class="shell">
! prompt> <b>mhonarc </b><var>[options-here]</var> <b>-- -</b>
</pre>
<p>The "--" tells MHonArc to terminate all command-line
***************
*** 318,323 ****
make it suitable for processing by MHonArc. For example:
</p>
! <pre>
! shell> <b>mypreproc | mhonarc -- -</b>
</pre>
--- 322,327 ----
make it suitable for processing by MHonArc. For example:
</p>
! <pre class="shell">
! prompt> <b>mypreproc | mhonarc -- -</b>
</pre>
***************
*** 373,382 ****
on your mailbox:
</p>
! <pre>
! grep -i '^message-id:' my.mbox | sort | uniq | wc -l
</pre>
and
! <pre>
! grep -i '^message-id:' my.mbox | sort | wc -l
</pre>
--- 377,386 ----
on your mailbox:
</p>
! <pre class="shell">
! prompt> <b>grep -i '^message-id:' <var>my.mbox</var> | sort | uniq | wc -l</b>
</pre>
and
! <pre class="shell">
! prompt> <b>grep -i '^message-id:' <var>my.mbox</var> | sort | wc -l</b>
</pre>
***************
*** 388,393 ****
<!--X-NavButtons-Start-->
! <p align=center>
! [<a href="envs.html">Prev</a>][<a href="archives.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/";>Home</a>]
</p>
<!--X-NavButtons-End-->
--- 392,396 ----
<!--X-NavButtons-Start-->
! <table width="100%"><tr><td align="left"><nobr>[<a href="envs.html">Prev</a>]</nobr></td><td align="center" width="100%">[<a href="faq.html">TOC</a>][<a href="../mhonarc.html">Manual</a>][<a href="http://www.mhonarc.org/";>Home</a>]</td><td align="right"><nobr>[<a href="archives.html">Next</a>]</nobr></td></tr></table>
</p>
<!--X-NavButtons-End-->
---------------------------------------------------------------------
To sign-off this list, send email to majordomo(_at_)mhonarc(_dot_)org with the
message text UNSUBSCRIBE MHONARC-DEV