Changes between Version 6 and Version 7 of Recipe Commands

Timestamp:

Oct 3, 2005, 9:49:52 PM (19 years ago)

Author:

cmlenz

Comment:

Add doc for new XSLT command

Recipe Commands

@@ -153 +153 @@
 || `file` || Path of the script to execute, relative to the project source directory. ||
 || `module` || Name of the Python module to execute. ||
+|| `function` || Name of the function in the Python module to run. Only works when also specifying the `module` attribute. ||
 || `args` || Any arguments that should be passed to the script. ||
 || `output` || Path to a file where any output by the script should be recorded. ||
@@ -234 +235 @@
  <python:pylint file="build/pylint.out" />
 }}}
+
+----
+
+== XML Tools ==
+
+A collection of recipe commands for XML processing.
+
+ ''Namespace'':: `http://bitten.cmlenz.net/tools/xml`
+ ''Common prefix'':: `x`
+
+=== `<x:transform>` ===
+
+Apply an XSLT stylesheet .
+
+''Note that this command requires either [http://xmlsoft.org/XSLT/ libxslt] (with [http://xmlsoft.org/XSLT/python.html Python bindings]) or, on Windows platforms, MSXML (version 3 or later) to be installed on the slave machine.''
+
+==== Parameters ====
+
+|| Name || Description ||
+|| `src` || Path of the source XML file. ||
+|| `dest` || Path of the destition XML file. ||
+|| `stylesheet` || Path to the XSLT stylesheet file. ||
+
+All these are interpreted relative to the project source directory.
+
+==== Examples ====
+
+{{{
+ <x:transform src="src.xml" dest="dest.xml" stylesheet="util/convert.xsl" />
+}}}
+
+This applies the stylesheet in `util/convert.xsl` to the source file `src.xml`, and writes the resulting XML document to `dest.xml`.