mhonarc-commits
[Top] [All Lists]

CVS: mhonarc/MHonArc/doc/faq envs.html,1.15,1.16 faq.html,1.24,1.25

2002-07-19 17:49:09
Update of /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq
In directory subversions:/tmp/cvs-serv26830/doc/faq

Modified Files:
	envs.html faq.html 
Log Message:
* Added MHonArc::UTF8 CHARSETCONVERTER module as recommended at
  <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=131512&repeatmerged=yes>.
  However, module redone to use utf8 pragma in Perl where appropriate
  and to remove unnecessary code.  Use of module does require that
  the Unicode::MapUTF8 module is installed and the utf8 pragma is
  supported in the version of Perl you are using.

  A example resource file, "utf-8.mrc", has been added to the
  resource file example appendix section on how UTF-8 output can
  be done in MHonArc.

  NOTE: The MHonArc core is still not UTF-8-aware, so some text
	processing may not work as expected on UTF-8 data.
	Possible problem points:

	. Auto-URL hyperlinking in text/plain messages in
	  mhtxtplain.pl.
	. Auto-message-id detection in messages.
	. Resource variable text clipping.

	There may be others, but in general, if there is a problem,
	it should be uncommon and should not affect the overall
	functionality of MHonArc.  Problems can be avoided by
	not using, or disabling, various resources.

* mhtxtplain.pl:
  . Removed exception case of iso-2022-jp character data since it
    does not allow alternative iso-2022-jp character set conversion
    functions via CHARSETCONVERTERS.

    NOTE: This does eliminate the smart handling of URL detection
	  for the variable-width character set.  Hence, the URL
	  detection could technically match non-URLs, or munge
	  a character at URL boundaries, but it is unknown on how
	  likely this is.  If it is a problem, the "nourl" argument
	  should be specified to this filter.

    NOTE: The old-style "smart" URL functionality can be re-enabled by
	  writing a custom CHARSETCONVERTER for iso-2022-jp that
	  just calls iso_2022_jp::jp2022_to_html in iso2022jp.pl.

  . Minor modification to flowed text/plain formatting that hopefully
    makes quoted text look better than before.

* FAQ changes:
  + Added, "Does MHonArc support Unicode?"
  * Changed, "Can MHonArc create non-English archives?"
  + Added, "Can MHonArc process Evolution folders?"


Index: envs.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/envs.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -r1.15 -r1.16
*** envs.html	24 Dec 2001 14:38:39 -0000	1.15
--- envs.html	20 Jul 2002 00:48:48 -0000	1.16
***************
*** 27,34 ****
--- 27,36 ----
  <li><a href="#maildir">Can MHonArc process qmail's maildir style mail folders?</a></li>
  <li><a href="#netscape">Can MHonArc process Netscape Messenger folders?</a></li>
+ <li><a href="#evolution">Can MHonArc process Evolution folders?</a></li>
  <li><a href="#compuserve">Can MHonArc process Compuserve messages?</a></li>
  <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="#bilingual">Can I create bilingual archives?</a></li>
+ <li><a href="#unicode">Does MHonArc support Unicode?</a></li>
  </ul>
  <!--X-TOC-End-->
***************
*** 169,172 ****
--- 171,175 ----
  </BLOCKQUOTE>
  <BLOCKQUOTE>
+ <hr noshade size=1>
  <UL>
  <LI><em>Subject</em>: Majordomo Digests to mbox format for MHonarc (perl script)</LI>
***************
*** 404,407 ****
--- 407,425 ----
  <table border=0>
  <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
+ <h3><b><a name="evolution">Can MHonArc process Evolution folders?</a></b></h3>
+ </td></tr></table>
+ 
+ <p>Yes.  Each Evolution folder has a corresponding mailbox file
+ that stores the raw mail messages for the folder.  The location
+ of the mailbox file will be in your mail directory which is
+ typically <b><tt>$HOME/evolution/local/<em>folder-name</em></tt></b>.
+ In the directory is a file called <tt>mbox</tt> which contains
+ the raw messages that can be passed into MHonArc directly.
+ </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="compuserve">Can MHonArc process Compuserve messages?</a></b></h3>
  </td></tr></table>
***************
*** 491,499 ****
  you can have MHonArc create pages in any language supported
  by Web client software.  Plus, messages containing non-English text
! is supported during message conversion.  For text messages,
! MHonArc supports the ISO-8859 character sets and the
! ISO-2022-JP character set.
  </p>
  
  <!-- ??????????????????????????????????????????????????????????????? -->
  <hr noshade size=1>
--- 509,522 ----
  you can have MHonArc create pages in any language supported
  by Web client software.  Plus, messages containing non-English text
! is supported during message conversion via the CHARSETCONVERTERS
! resource.
  </p>
  
+ <dl>
+ <dt>See also:</dt>
+ <dd><a href="#unicde"
+     >Does MHonArc support Unicode?</a></dd>
+ </dl>
+ 
  <!-- ??????????????????????????????????????????????????????????????? -->
  <hr noshade size=1>
***************
*** 525,528 ****
--- 548,570 ----
  </dd>
  </dl>
+ 
+ <dl>
+ <dt>See also:</dt>
+ <dd><a href="#unicde"
+     >Does MHonArc support Unicode?</a></dd>
+ </dl>
+ 
+ <!-- ??????????????????????????????????????????????????????????????? -->
+ <hr noshade size=1>
+ <table border=0>
+ <tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
+ <h3><b><a name="unicode">Does MHonArc support Unicode?</a></b></h3>
+ </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>
  
  <!-- ===================================================================== -->

Index: faq.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/faq/faq.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -C2 -r1.24 -r1.25
*** faq.html	28 Jun 2002 03:28:10 -0000	1.24
--- faq.html	20 Jul 2002 00:48:48 -0000	1.25
***************
*** 64,71 ****
--- 64,73 ----
  <li><a name="maildir" href="envs.html#maildir">Can MHonArc process qmail's maildir style mail folders?</a></li>
  <li><a name="netscape" href="envs.html#netscape">Can MHonArc process Netscape Messenger folders?</a></li>
+ <li><a name="evolution" href="envs.html#evolution">Can MHonArc process Evolution folders?</a></li>
  <li><a name="compuserve" href="envs.html#compuserve">Can MHonArc process Compuserve messages?</a></li>
  <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="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>
  </ul>
  </ul>

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