MHonArc

 view release on metacpan or  search on metacpan

doc/resources/mimeincs.html  view on Meta::CPAN

<html>
<head>
<title>MHonArc Resources: MIMEINCS</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="mimefilters.html">MIMEFILTERS</a>]</td><td><nobr>[<a href="../resources.html#mimeincs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="m...
<!--/x-rc-nav-->

<hr>
<h1>MIMEINCS</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>
<ul>
<li><small><a href="#incmsg">Supporting Message-based Attachments</a></small>
</ul>
<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>&lt;MIMEINCS&gt;</code><br>
<var>content-type</var><br>
<var>content-type</var><br>
...<br>
<code>&lt;/MIMEINCS&gt;</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>MIMEINCS defines the list of content-types (aka media-types) to allow.
If the MIMEINCS resource is not empty, only media-types listed will
be allowed.  All other media-types will be excluded.
</p>
<p>For example, if MIMEINCS is set to the following:
</p>
<pre class="code">
<b>&lt;MIMEIncs&gt;</b>
text/plain
text/html
<b>&lt;/MIMEIncs&gt;</b>
</pre>
<p>Then only text/plain and text/html media-types are allowed.  All
other media-types will be excluded.
</p>

<table class="note" width="100%">
<tr valign="baseline">
<td><strong>NOTE:</strong></td>
<td width="100%"><p>If a media-type is listed in the
<a href="mimeexcs.html">MIMEEXCS</a>, it is always excluded, regardless
of the value of MIMEINCS.
</p>
</td>
</tr>
</table>

<p>If all you want to do is exclude a specified set of media-types, then
use the 
<a href="mimeexcs.html">MIMEEXCS</a> resource instead.
</p>

<p>Base types can also be listed to allow all media-types
with a give base.  For example, <tt>image/jpg</tt> will only allow
JPEG images, but <tt>image</tt> will allow all images.
</p>

<table class="note" width="100%">
<tr valign="baseline">
<td><strong>NOTE:</strong></td>
<td width="100%"><p>Use care when setting MIMEINCS since you may
unintentionally exclude media-types that you do not want to exclude.
See <a href="#incmsg">Examples</a> below.
</p>
</td>
</tr>
</table>

<p>
</p>

<!-- *************************************************************** -->
<hr>
<h2><a name="default">Default Setting</a></h2>

<p>Nil.
</p>

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



( run in 1.170 second using v1.01-cache-2.11-cpan-524268b4103 )