MHonArc
view release on metacpan or search on metacpan
doc/resources/mimealtprefs.html view on Meta::CPAN
<html>
<head>
<title>MHonArc Resources: MIMEALTPREFS</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: <a href="mhpattern.html">MHPATTERN</a>]</td><td><nobr>[<a href="../resources.html#mimealtprefs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="m...
<!--/x-rc-nav-->
<hr>
<h1>MIMEALTPREFS</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>N/A
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p>
<code><MIMEALTPREFS></code><br>
<var>content-type</var><br>
<var>content-type</var><br>
...<br>
<code></MIMEALTPREFS></code><br>
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p>N/A
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>MIMEALTPREFS allows you to specify media-type preferences
for <tt>multipart/alternative</tt> data, overriding the default
preferences as specified in mail messages.
</p>
<p>When a <tt>multipart/alternative</tt> entity is processed,
the last filterable media-type is normally used. However, it is sometimes
desirable to override this behavior for certain media-types. For example,
it has become common for many MUAs to generate the following
message structures:
</p>
<pre>
multipart/alternative
text/plain
text/html</pre>
<p>A message with HTML and a plain text equivalent for receiving
MUAs who cannot render HTML. When MHonArc processes
such a message, MHonArc will use the <tt>text/html</tt> part since it
is filterable and comes after <tt>text/plain</tt>.
</p>
<p>There are many who would like to have nothing to do with HTML in
email (for
<a href="../faq/security.html#htmldata">security reasons</a>).
With MIMEALTPREFS, you can tell
MHonArc to use the <tt>text/plain</tt> entity (if it exists) over
the <tt>text/html</tt> part with the following setting:
</p>
<pre class="code">
<b><MIMEAltPrefs></b>
text/plain
text/html
<b></MIMEAltPrefs></b>
</pre>
<p>Media-types listed in MIMEALTPREFS are from most prefered to least
prefered.
</p>
<p>MIMEALTPREFS augments the normal processing of
<tt>multipart/alternative</tt> entities. For example, say the following
message entity structure exists,
</p>
( run in 0.766 second using v1.01-cache-2.11-cpan-524268b4103 )