<refentry id="xexpr">

<refmeta>
<refentrytitle>xexpr</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">User Commands</refmiscinfo>
</refmeta>

<refnamediv>
<refname>xexpr</refname>
<refpurpose>XEXPR Interpreter</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>xexpr</command>
<arg choice="opt" rep="repeat">OPTION</arg>
<arg>script</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para><command>xexpr</command> is an XEXPR interpreter. It loads and executes
XEXPR programs.
</para>
</refsect1>

<refsect1><title>Options</title>
<variablelist>

<varlistentry>
<term><option>-h</option>, <option>--help</option></term>
<listitem><para>
print help and exit
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-d</option>, <option>--dump-tree</option></term>
<listitem><para>
Instead of executing the XEXPR program, dump the parsed tree after loading
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-D</option>, <option>--dump-result</option></term>
<listitem><para>
After executing the XEXPR program, dump the result
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-t</option>, <option>--test-result</option></term>
<listitem><para>
After executing the XEXPR program, test the result and exit 0 if it evaluates
to &lt;true/&gt; and non-zero if it evaluates to &lt;false/&gt;
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-T=<replaceable>id</replaceable></option>, <option>--trace <replaceable>id</replaceable></option></term>
<listitem><para>
Adds <replaceable>id</replaceable> to the set of symbols to trace.

When variables with the name of a traced symbol are created or changed,
<command>xexpr</command> will output a suitable tracing message and a stack
dump
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--xinclude</option></term>
<listitem><para>
Do XInclude processing
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--param <replaceable>name</replaceable>,<replaceable>number</replaceable></option></term>
<listitem><para>
Set a global XEXPR variable of the given <replaceable>name</replaceable> with a
numeric value of <replaceable>number</replaceable>. A float or integer type
will be selected automatically.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--stringparam <replaceable>name</replaceable>,<replaceable>value</replaceable></option></term>
<listitem><para>
Set a global XEXPR variable of the given <replaceable>name</replaceable> with a
string value of <replaceable>value</replaceable>.
</para></listitem>
</varlistentry>

</variablelist>
</refsect1>
</refentry>
