[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / msgexcfilter.html

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

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

<dl>

<dt><strong>Envariable</strong></dt>
<dd><p>
<code>M2H_MSGEXCFILTER=</code><var>Perl_expressions</var>
</p>
</dd>

<dt><strong>Element</strong></dt>
<dd><p>
<code>&lt;MSGEXCFILTER&gt;</code><br>
<var>Perl_expressions</var><br>
<code>&lt;/MSGEXCFILTER&gt;</code><br>
</p>
</dd>

<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-msgexcfilter </code><var>Perl_expressions</var>
</p>
</dd>

</dl>

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

<p>MSGEXCFILTER may be used to define Perl expressions to
selectively exclude messages during an
<a href="add.html">ADD</a> operation.  Unlike the
<a href="checknoarchive.html">CHECKNOARCHIVE</a> resource,
MSGEXCFILTER allows you to explicitly examine entire message headers
to determine which messages should be added.
</p>
<p>When defining the expressions, the raw message header will be in
the <b><tt>$_</tt></b> variable.  If the last evaluated expression
of MSGEXCFILTER returns a true value, or there is an explicit
<tt>return</tt> statement that returns a true value, MHonArc will
exclude the message.
</p>


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

<p>Nil.
</p>

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

<p>N/A
</p>

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

<p>A typical usage of MSGEXCFILTER is to define a pattern match
operation:
</p>
<pre>
<b>&lt;MsgExcFilter&gt;</b>
/^From: .*\behood@/im;
<b>&lt;/MsgExcFilter&gt;</b>
</pre>
<p>Here, we are excluding any messages that are from "ehood".  The
"<tt>m</tt>" modifier to the pattern match exists because the
header will contain newlines.
</p>

<p>The following example attempts to exclude all messages not addressed
to <tt>mhonarc-users@mhonarc.org</tt>:
</p>
<pre>
<b>&lt;MsgExcFilter&gt;</b>
!/\bmhonarc-users@mhonarc.org\b/i;
<b>&lt;/MsgExcFilter&gt;</b>
</pre>

<p>Here, we do what the <a href="checknoarchive.html">CHECKNOARCHIVE</a>
resource basically does:
</p>
<pre>
<b>&lt;MsgExcFilter&gt;</b>
/^restrict:\s+no-external-archive/im ||
/^x-no-archive:\s+yes/im;
<b>&lt;/MsgExcFilter&gt;</b>
</pre>


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

<p>2.4.1
</p>

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

<p>
<a href="add.html">ADD</a>,
<a href="checknoarchive.html">CHECKNOARCHIVE</a>
</p>

<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="msgbodyend.html">MSGBODYEND</a>]</td><td><nobr>[<a href="../resources.html#msgexcfilter">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="msgfoot.html">MSGFOOT</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; 1999, <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
>mhonarc@mhonarc.org</a><br>
</address>

</body>
</html>
Commit	Line	Data
86530b38 AT	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
	2	<html>
	3	<head>
	4	<title>MHonArc Resources: MSGEXCFILTER</title>
	5	</head>
	6	<body>
	7	<!--x-rc-nav-->
	8	<table border=0><tr valign="top">
	9	<td align="left" width="50%">[Prev: <a href="msgbodyend.html">MSGBODYEND</a>]</td><td><nobr>[<a href="../resources.html#msgexcfilter">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="msgfoot.html">MSGFOOT</a>]</td></tr></table>
	10	<!--/x-rc-nav-->
	11	<hr>
	12	<h1>MSGEXCFILTER</h1>
	13
	14	<!-- *************************************************************** -->
	15	<hr>
	16	<h2>Syntax</h2>
	17
	18	<dl>
	19
	20	<dt><strong>Envariable</strong></dt>
	21	<dd><p>
	22	<code>M2H_MSGEXCFILTER=</code><var>Perl_expressions</var>
	23	</p>
	24	</dd>
	25
	26	<dt><strong>Element</strong></dt>
	27	<dd><p>
	28	<code><MSGEXCFILTER></code><br>
	29	<var>Perl_expressions</var><br>
	30	<code></MSGEXCFILTER></code><br>
	31	</p>
	32	</dd>
	33
	34	<dt><strong>Command-line Option</strong></dt>
	35	<dd><p>
	36	<code>-msgexcfilter </code><var>Perl_expressions</var>
	37	</p>
	38	</dd>
	39
	40	</dl>
	41
	42	<!-- *************************************************************** -->
	43	<hr>
	44	<h2>Description</h2>
	45
	46	<p>MSGEXCFILTER may be used to define Perl expressions to
	47	selectively exclude messages during an
	48	<a href="add.html">ADD</a> operation. Unlike the
	49	<a href="checknoarchive.html">CHECKNOARCHIVE</a> resource,
	50	MSGEXCFILTER allows you to explicitly examine entire message headers
	51	to determine which messages should be added.
	52	</p>
	53	<p>When defining the expressions, the raw message header will be in
	54	the <b><tt>$_</tt></b> variable. If the last evaluated expression
	55	of MSGEXCFILTER returns a true value, or there is an explicit
	56	<tt>return</tt> statement that returns a true value, MHonArc will
	57	exclude the message.
	58	</p>
	59
	60
	61	<!-- *************************************************************** -->
	62	<hr>
	63	<h2>Default Setting</h2>
	64
65	<p>Nil.
66	</p>
67
68	<!-- *************************************************************** -->
69	<hr>
70	<h2>Resource Variables</h2>
71
72	<p>N/A
73	</p>
74
75	<!-- *************************************************************** -->
76	<hr>
77	<h2>Examples</h2>
78
79	<p>A typical usage of MSGEXCFILTER is to define a pattern match
80	operation:
81	</p>
82	<pre>
83	<b><MsgExcFilter></b>
84	/^From: .*\behood@/im;
85	<b></MsgExcFilter></b>
86	</pre>
87	<p>Here, we are excluding any messages that are from "ehood". The
88	"<tt>m</tt>" modifier to the pattern match exists because the
89	header will contain newlines.
90	</p>
91
92	<p>The following example attempts to exclude all messages not addressed
93	to <tt>mhonarc-users@mhonarc.org</tt>:
94	</p>
95	<pre>
96	<b><MsgExcFilter></b>
97	!/\bmhonarc-users@mhonarc.org\b/i;
98	<b></MsgExcFilter></b>
99	</pre>
100
101	<p>Here, we do what the <a href="checknoarchive.html">CHECKNOARCHIVE</a>
102	resource basically does:
103	</p>
104	<pre>
105	<b><MsgExcFilter></b>
106	/^restrict:\s+no-external-archive/im \|\|
107	/^x-no-archive:\s+yes/im;
108	<b></MsgExcFilter></b>
109	</pre>
110
111
112	<!-- *************************************************************** -->
113	<hr>
114	<h2>Version</h2>
115
116	<p>2.4.1
117	</p>
118
119	<!-- *************************************************************** -->
120	<hr>
121	<h2>See Also</h2>
122
123	<p>
124	<a href="add.html">ADD</a>,
125	<a href="checknoarchive.html">CHECKNOARCHIVE</a>
126	</p>
127
128	<!-- *************************************************************** -->
129	<hr>
130	<!--x-rc-nav-->
131	<table border=0><tr valign="top">
132	<td align="left" width="50%">[Prev: <a href="msgbodyend.html">MSGBODYEND</a>]</td><td><nobr>[<a href="../resources.html#msgexcfilter">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="msgfoot.html">MSGFOOT</a>]</td></tr></table>
133	<!--/x-rc-nav-->
134	<hr>
135	<address>
136	$Date: 2002/07/27 05:13:10 $ <br>
137	<img align="top" src="../monicon.png" alt="">
138	<a href="http://www.mhonarc.org/"
139	><strong>MHonArc</strong></a><br>
140	Copyright © 1999, <a href="http://www.earlhood.com/"
141	>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
142	>mhonarc@mhonarc.org</a><br>
143	</address>
144
145	</body>
146	</html>