Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / varregex.html
CommitLineData
86530b38
AT
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
2<html>
3<head>
4<title>MHonArc Resources: VARREGEX</title>
5</head>
6<body>
7<!--x-rc-nav-->
8<table border=0><tr valign="top">
9<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>
10<!--/x-rc-nav-->
11<hr>
12<h1>VARREGEX</h1>
13
14<!-- *************************************************************** -->
15<hr>
16<h2>Syntax</h2>
17
18<dl>
19
20<dt><strong>Envariable</strong></dt>
21<dd><p><code>M2H_VARREGEX=</code><var>Perl-regex</var>
22</p>
23</dd>
24
25<dt><strong>Element</strong></dt>
26<dd><p><code>&lt;VARREGEX&gt;</code><br>
27<var>Perl-regex</var><br>
28<code>&lt;/VARREGEX&gt;</code><br>
29</p>
30</dd>
31
32<dt><strong>Command-line Option</strong></dt>
33<dd><p><code>-varregex </code><var>Perl-regex</var>
34</p>
35</dd>
36
37</dl>
38
39<!-- *************************************************************** -->
40<hr>
41<h2>Description</h2>
42
43<p>VARREGEX defines the Perl regular expression matching
44<a href="../rcvars.html">resource variables</a>. The regex should
45define a back reference that contains the name of the resource
46variable and its arguments surround by parentheses.
47</p>
48<table border=0 cellpadding=4>
49<tr valign=top>
50<td><strong><font color="red">WARNING</font></strong></td>
51<td><p><b>DO NOT MESS WITH THIS RESOURCE UNLESS YOU KNOW WHAT YOU ARE
52DOING</b>. If not set properly, page output can become munged.
53One symptom of a bad VARREGEX setting is the occurrence of numerous
54'<tt>$</tt>' characters in generated pages. Make sure to test
55your VARREGEX setting before using it with production archives.
56</p>
57</td>
58</tr>
59</table>
60
61
62<!-- *************************************************************** -->
63<hr>
64<h2>Default Setting</h2>
65
66<pre>
67\$([^\$]*)\$
68</pre>
69
70<!-- *************************************************************** -->
71<hr>
72<h2>Resource Variables</h2>
73
74<p>N/A
75</p>
76
77<!-- *************************************************************** -->
78<hr>
79<h2>Examples</h2>
80
81<p>The following does a more stricter match:
82</p>
83<pre>
84\$([^(\$]+(?:\([^)]+\))?)\$
85</pre>
86<p>Although slower than the default, it minimizes potential conflicts
87in resource files encoded in multi-byte character sets like SJIS.
88</p>
89
90<!-- *************************************************************** -->
91<hr>
92<h2>Version</h2>
93
94<p>2.4.5
95</p>
96
97<!-- *************************************************************** -->
98<hr>
99<h2>See Also</h2>
100
101<p>
102</p>
103
104<!-- *************************************************************** -->
105<hr>
106<!--x-rc-nav-->
107<table border=0><tr valign="top">
108<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>
109<!--/x-rc-nav-->
110<hr>
111<address>
112$Date: 2002/07/27 05:13:11 $ <br>
113<img align="top" src="../monicon.png" alt="">
114<a href="http://www.mhonarc.org/"
115><strong>MHonArc</strong></a><br>
116Copyright &#169; 2000, <a href="http://www.earlhood.com/"
117>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
118>mhonarc@mhonarc.org</a><br>
119</address>
120
121</body>
122</html>