The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
<html>
<head>
<title>MHonArc Resources: EXCS</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="editidx.html">EDITIDX</a>]</td><td><nobr>[<a href="../resources.html#excs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="expireage.html">EXPIREAGE</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>EXCS</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>&lt;EXCS&gt;<br></code>
<var>field-name</var><br>
<var>field-name</var><br>
<var>...</var><br>
<code>&lt;/EXCS&gt;<br></code>
</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>The EXCS resource allows you to specify what fields should be
excluded in the HTML output.  </P>

<P>Each line of the &lt;EXCS&gt; element specifies a mail header
field to exclude in the converted HTML output. Each line is treated
as a Perl regular expression (<STRONG>NOTE</STRONG>: <EM>the regular
expression is already anchored to the begining of the line</EM>).  </P>

<P>Any fields you specify for the EXCS resource will
augment the default list, unless the "<CODE>Override</CODE>" attribute
is specified. If "<CODE>Override</CODE>" is specified, the default
list is discarded along with any other lists specified from previous
&lt;EXCS&gt; elements; and only header fields specified in the
&lt;EXCS&gt; element are excluded.  </P>

<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>NOTE</strong></td>
<td><p>EXCS takes precedence over the
<a href="fieldorder.html">FIELDORDER</a> resource.  Therefore,
any field matched by EXCS will always be excluded regardless if the field is
listed in FIELDORDER.
</p>
</td>
</tr>
</table>

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

<PRE class="code">
content-
errors-to
forward
lines
message-id
mime-
nntp-
originator
path
precedence
received
replied
return-path
status
via
x-
</PRE>

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

<p>N/A
</p>

<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></h2>

<p>The following example shows how to exclude all message headers:
</p>

<PRE class="code">
<b>&lt;Excs Override&gt;</b>
.
<b>&lt;/Excs&gt;</b>
</PRE>

<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>

<p>1.0
</p>

<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>

<p>
<a href="fieldorder.html">FIELDORDER</a>,
<a href="fieldsbeg.html">FIELDSBEG</a>,
<a href="fieldsend.html">FIELDSEND</a>,
<a href="fieldstyles.html">FIELDSTYLES</a>,
<a href="fldbeg.html">FLDBEG</a>,
<a href="fldend.html">FLDEND</a>,
<a href="labelbeg.html">LABELBEG</a>,
<a href="labelend.html">LABELEND</a>,
<a href="labelstyles.html">LABELSTYLES</a>
</p>

<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="editidx.html">EDITIDX</a>]</td><td><nobr>[<a href="../resources.html#excs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="expireage.html">EXPIREAGE</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>