======Calling from Ant======

xmlsh can be called from ant as a custom ant task.
The xmlsh task is defined using an the <taskdef> task.
See the ant docs on [[http://ant.apache.org/manual/develop.html Writing your Own Task]].

The <taskdef> task defines the name for the xmlsh task, the class name and the classpath to xmlsh.jar

An example of a taskdef for calling xmlsh
%%
<taskdef name="xmlsh"
classname="org.xmlsh.ant.XmlshTask"
classpath="../../bin/xmlsh-1.1.jar"/>
%%

You can then call xmlsh by using the <xmlsh> task. Xmlsh scripts can be called by filename, or by embedding the script. If calling by filename then the arguments may be specified using the <arg value="argument"/> element.

An example of calling the xmlsh script "test.xsh" passing 2 argumuments

%%
<xmlsh script="test.xsh">
<arg value="arg1"/>
<arg value="arg2"/>
</xmlsh>
%%


The xmlsh script can be passed inline as text content to the task. This should be enclosed in a CDATA section if it contains special XML charactors ( < , & ) which are common in xmlsh scripts.

A simple example with no special charactors

%%
<xmlsh>
xls
</xmlsh>
%%

An example with special charactors

%%
<xmlsh>
<![CDATA[
xslt -f xslt.xsl < file.xml > output.xml
]]>
</xmlsh>
%%