The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
<html>
<head>
<title>MHonArc Resources: DECODEHEADS</title>
<link rel="stylesheet" type="text/css" href="../docstyles.css">
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="dbfileperms.html">DBFILEPERMS</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="defcharset.html">DEFCHARSET</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>DECODEHEADS</h1>
<!--X-TOC-Start-->
<ul>
<li><a href="#syntax">Syntax</a>
<li><a href="#description">Description</a>
<li><a href="#default">Default Setting</a>
<li><a href="#rcvars">Resource Variables</a>
<li><a href="#examples">Examples</a>
<li><a href="#version">Version</a>
<li><a href="#seealso">See Also</a>
</ul>
<!--X-TOC-End-->

<!-- *************************************************************** -->
<hr>
<h2><a name="syntax">Syntax</a></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><a name="description">Description</a></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><a name="default">Default Setting</a></h2>

<p>Off
</p>

<!-- *************************************************************** -->
<hr>
<h2><a name="rcvars">Resource Variables</a></h2>

<p>N/A
</p>

<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></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 class="code">
<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><a name="version">Version</a></h2>

<p>2.0
</p>

<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></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="dbfileperms.html">DBFILEPERMS</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="defcharset.html">DEFCHARSET</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2003/10/06 22:04:16 $ <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&#37;40mhonarc.org">mhonarc<!--
-->&#64;<!--
-->mhonarc.org</a><br>
</address>

</body>
</html>