tools/perl-5.8.0/doc/MHonArc/resources/decodeheads.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>MHonArc Resources: DECODEHEADS</title>
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="dbfile.html">DBFILE</a>]</td><td><nobr>[<a href="../resources.html#decodeheads">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="definederived.html">DEFINEDERIVED</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>DECODEHEADS</h1>

<!-- *************************************************************** -->
<hr>
<h2>Syntax</h2>

<dl>

<dt><strong>Envariable</strong></dt>
<dd><p>
<code>M2H_DECODEHEADS=</code>[ <code>0</code> | <code>1</code> ]
</p>
</dd>

<dt><strong>Element(s)</strong><dt>
<dd><p>
<code>&lt;DECODEHEADS&gt;</code><br>
<code>&lt;NODECODEHEADS&gt;</code>
</p>
</dd>

<dt><strong>Command-line Option(s)</strong><dt>
<dd><p>
<code>-decodeheads</code><br>
<code>-nodecodeheads</code>
</p>
</dd>

</dl>

<!-- *************************************************************** -->
<hr>
<h2>Description</h2>

<p>MIME encoded message header data is decoded when creating
HTML output and the (relevant) data stored in the database stays
in encoded form.  The DECODEHEADS resource can be set to decode
"decode-only" charsets (as specified by the
<a href="charsetconverters.html">CHARSETCONVERTERS</a> resource)
when message headers are read.  This will cause
decode-only charsets to be stored in decoded "raw" form.  Regular MIME
processing is still done to still-encoded data when generating output.
</p>

<p>This resource may be useful to decode known character sets
that are handle by default in the current locale.  This will reduce
the overhead performed each time MHonArc translates message header
data for inclusion in generated pages.
</p>

<!-- *************************************************************** -->
<hr>
<h2>Default Setting</h2>

<p>Off
</p>

<!-- *************************************************************** -->
<hr>
<h2>Resource Variables</h2>

<p>N/A
</p>

<!-- *************************************************************** -->
<hr>
<h2>Examples</h2>

<p>The following will tell MHonArc to just decode all non-ASCII
encoded data, causing all character data to be treated by the
default locale setting:
</p>
<pre>
<b>&lt;DecodeHeads&gt;</b>
<b><a href="charsetconverters.html">&lt;CharsetConverters override&gt;</a></b>
plain;          mhonarc::htmlize;
default;        -decode-
<b>&lt;/CharsetConverters&gt;</b>
</pre>


<!-- *************************************************************** -->
<hr>
<h2>Version</h2>

<p>2.0
</p>

<!-- *************************************************************** -->
<hr>
<h2>See Also</h2>

<p>
<a href="charsetconverters.html">CHARSETCONVERTERS</a>
</p>

<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="dbfile.html">DBFILE</a>]</td><td><nobr>[<a href="../resources.html#decodeheads">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="definederived.html">DEFINEDERIVED</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2002/07/27 05:13:10 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright &#169; 1997-1998, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org">mhonarc@mhonarc.org</a><br>
</address>

</body>
</html>