Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / varregex.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>MHonArc Resources: VARREGEX</title>
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="usinglastpg.html">USINGLASTPG</a>]</td><td><nobr>[<a href="../resources.html#varregex">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="weekdays.html">WEEKDAYS</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>VARREGEX</h1>
<!-- *************************************************************** -->
<hr>
<h2>Syntax</h2>
<dl>
<dt><strong>Envariable</strong></dt>
<dd><p><code>M2H_VARREGEX=</code><var>Perl-regex</var>
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p><code>&lt;VARREGEX&gt;</code><br>
<var>Perl-regex</var><br>
<code>&lt;/VARREGEX&gt;</code><br>
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p><code>-varregex </code><var>Perl-regex</var>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2>Description</h2>
<p>VARREGEX defines the Perl regular expression matching
<a href="../rcvars.html">resource variables</a>. The regex should
define a back reference that contains the name of the resource
variable and its arguments surround by parentheses.
</p>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong><font color="red">WARNING</font></strong></td>
<td><p><b>DO NOT MESS WITH THIS RESOURCE UNLESS YOU KNOW WHAT YOU ARE
DOING</b>. If not set properly, page output can become munged.
One symptom of a bad VARREGEX setting is the occurrence of numerous
'<tt>$</tt>' characters in generated pages. Make sure to test
your VARREGEX setting before using it with production archives.
</p>
</td>
</tr>
</table>
<!-- *************************************************************** -->
<hr>
<h2>Default Setting</h2>
<pre>
\$([^\$]*)\$
</pre>
<!-- *************************************************************** -->
<hr>
<h2>Resource Variables</h2>
<p>N/A
</p>
<!-- *************************************************************** -->
<hr>
<h2>Examples</h2>
<p>The following does a more stricter match:
</p>
<pre>
\$([^(\$]+(?:\([^)]+\))?)\$
</pre>
<p>Although slower than the default, it minimizes potential conflicts
in resource files encoded in multi-byte character sets like SJIS.
</p>
<!-- *************************************************************** -->
<hr>
<h2>Version</h2>
<p>2.4.5
</p>
<!-- *************************************************************** -->
<hr>
<h2>See Also</h2>
<p>
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="usinglastpg.html">USINGLASTPG</a>]</td><td><nobr>[<a href="../resources.html#varregex">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="weekdays.html">WEEKDAYS</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2002/07/27 05:13:11 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"
><strong>MHonArc</strong></a><br>
Copyright &#169; 2000, <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
>mhonarc@mhonarc.org</a><br>
</address>
</body>
</html>