<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML//EN">
<title>MHonArc Resources: DEFINEVAR
</title>
<table border=
0><tr valign=
"top">
<td align=
"left" width=
"50%">[Prev:
<a href=
"definederived.html">DEFINEDERIVED
</a>]
</td><td><nobr>[
<a href=
"../resources.html#definevar">Resources
</a>][
<a href=
"../mhonarc.html">TOC
</a>]
</nobr></td><td align=
"right" width=
"50%">[Next:
<a href=
"defrcfile.html">DEFRCFILE
</a>]
</td></tr></table>
<!-- *************************************************************** -->
<dt><strong>Envariable
</strong></dt>
<dt><strong>Element
</strong></dt>
<code><DEFINEVAR
><br></code>
<var>variable-name
</var><br>
<code></DEFINEVAR
><br></code>
<dt><strong>Command-line Option
</strong></dt>
<code>-definevar
</code><var>variable-specification-list
</var>
<!-- *************************************************************** -->
<p>DEFINEVAR is used for creating user-defined resource variables.
DEFINEVAR can be defined on the command-line or in the resource file.
<p>On the command-line, the option is called
<code>-definevar
</code>
The following argument after
<code>-definevar
</code>
is treated as a variable specification list. The specification list
is a string containing name/value pairs with the following format:
</p>
<p><var>NAME
</var><code>=
</code><var>VALUE
</var></p>
<p>Multiple name/value pairs are separated
If
<var>VALUE
</var> contains whitespace, then it must be surrounded
by quotes to prevent the command shell from treating the string
Multiple
<code>-definevar
</code> options can be specified on the
command-line. This can help reduce the ugliness of specify mutliple
variable definitions with a single option.
<table border=
0 cellpadding=
4>
<td><strong>NOTE
</strong></td>
<td><p>If you intend to include resource variables as part of the
<var>VALUE
</var>, you may need to escape the '$' characters (and possible
prevent interpolation by the command shell. See your command
shell documentation for more information.
<p>In a resource file the
<DEFINEVAR
> element may occur mutliple times
to define multiple variables. The first line of the
<DEFINEVAR
>
element is the name of the variables. All subsequent lines represent
the content of the variable. If you do not want
the last newline of a
<DEFINEVAR
> element content to be part of
variable content, then specify the
<b><tt>chop
</tt></b> attribute.
<!-- *************************************************************** -->
<!-- *************************************************************** -->
<h2>Resource Variables
</h2>
<!-- *************************************************************** -->
<p>The following is a simple example of defining a variable to
represent the base text for the title of an archive:
<b><DefineVar chop
></b>
<b></DefineVar
></b>
<p>Now, the variable can be refernced as follows:
<b><<a href=
"ttitle.html">TTitle
</a> chop
></b>
<p>If you wanted to use the same resource file for multiple arcvhives
it may better to define
<code>$MAIN-TITLE$
</code> on the command-line
%
<b>mhonarc -definevar MAIN-TITLE='mhonarc mailing list'
</b> ...
<!-- *************************************************************** -->
<!-- *************************************************************** -->
<!-- *************************************************************** -->
<table border=
0><tr valign=
"top">
<td align=
"left" width=
"50%">[Prev:
<a href=
"definederived.html">DEFINEDERIVED
</a>]
</td><td><nobr>[
<a href=
"../resources.html#definevar">Resources
</a>][
<a href=
"../mhonarc.html">TOC
</a>]
</nobr></td><td align=
"right" width=
"50%">[Next:
<a href=
"defrcfile.html">DEFRCFILE
</a>]
</td></tr></table>
$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
© 1997-
1998,
<a href=
"http://www.earlhood.com/">Earl Hood
</a>,
<a href=
"mailto:mhonarc@mhonarc.org">mhonarc@mhonarc.org
</a><br>