Ubuntu Manpage: saxonb-xslt - command line XSLT 2.0 processor

Provided by: libsaxonb-java_9.1.0.8+dfsg-1_all

NAME

       saxonb-xslt - command line XSLT 2.0 processor

SYNOPSIS

       saxonb-xslt [OPTION...] [-s:SOURCEFILE] [-xsl:STYLESHEET] [-o:OUTPUT] [NAME=VALUE...]

DESCRIPTION

This manual page documents briefly the saxonb-xslt command. This page was written for the
Debian(TM) distribution because the original program does not have a manual page. Instead,
it has HTML documentation which is shipped in the libsaxonb-java-doc package.

saxonb-xslt is a command line wrapper around the Saxon-B XSLT and XQuery processor. Using
saxonb-xslt you can process XML documents with XSLT 2.0 stylesheets directly from the
command line. Internally, saxonb-xslt is a wrapper around the Java class
net.sf.saxon.Transform implemented by Saxon-B.

saxonb-xslt is usually invoked passing the 3 options made explicit in the above synopsis.
Usually, those options correspond respectively to the input XML file to be transformed,
the XSLT stylesheet describing the desired transformation, and the output file where to
save the result. However, the meaning and the need of passing them is affected by a number
of other options that can be specified. See the option reference below for more
information.

Parameters
At the end of the command line, a list of parameters can be given. Parameters are passed
using the syntax NAME=VALUE, to specify parameters´ names and values.

A parameter name prefixed with "+" (plus sign) will be interpreted as a filesystem path
parameter If the path points to a single file, that file will be parsed as XML and its
document node will be passed as the parameter value. If the path points to a directory,
all directly contained files will be parsed as XML files, and the sequence of their
document nodes will be passed as the parameter value.

A parameter name prefixed with "!" (exclamation mark) will be interpted as a
output/serialization parameter. See the specifications of XQuery and XSLT 2.0 for more
information on output/serialization parameters.

To pass parameters belonging to the non-null namespace, the syntax {uri}localname=value is
provided.

Parameters will be visible as global variables during XSLT processing, provided they have
been declared with <xsl:param>. evaluation, provided they have been declared in the query
prolog. See the XSLT specification for more information on variables and their
declarations.

OPTIONS

       A summary of supported options is included below. Options can be passed in any order.

       We first report the options which are shared by saxonb-xslt and saxonb-xquery, then those
       specific to saxonb-xslt (or which have a different semantics).

       Some options are flagged as "Saxon-SA only", such options work only if Saxon-SA is
       installed. Note that Saxon-SA is a commercial product, as such it is not available in
       Debian.

   Common options
       -cr:classname
           Specify a class to be used for processing collection URIs passed to the collection()
           function. The class must implement net.sf.saxon.CollectionURIResolver.

       -dtd: {[on] | [off]}
           Enable or disable DTD validation. Default: off.

       -expand: {[on] | [off]}
           When validation is enabled, expand default values in validated documents. This option
           enables or disables such an expansion. Default: on.

       -explain [:filename]
           Display an execution plan; the output is in XML format. If filename is not given it
           will be displayed on standard output.

       -ext: {[on] | [off]}
           Enable or disable the ability to invoke external Java functions from query files and
           stylesheets. Beware that enabling them is a potential security risk when processing
           untrusted files. Default: off.

       -l: {[on] | [off]}
           Keep (when on) or throw away (when off) line numbers in tress corresponding to source
           documents. When kept, line numbers can be accessed using the function
           saxon:line-number(). Default: off.

       -outval: {[recover] | [fatal]}
           When validation is required, set whether validation errors are fatal (when "fatal" is
           passed) or if they only trigger warnings (when "recover" is). Default: fatal.

       -p: {[on] | [off]}
           Enable or disable usage of the PTreeURIResolver. Saxon-SA only.

       -r:classname
           Specify a class to be used for resolving all URIs.

       -repeat:N
           Repeat the transformation N times. For benchmarking purposes.

       -sa
           Perform Schema-aware processing. Saxon-SA only.

       -strip: {[all] | [none] | [ignorable]}
           Specify whitespace stripping policy for source documents: strip all of them ("all"),
           strip none of them ("none"), strip ignorable whitespace only ("ignorable"). Default:
           none.

       -t
           Display version, timing, and other debugging information on standard error.

       -tree: {[tiny] | [linked]}
           Select the implementation of the internal tree model: tiny tree model ("tiny") or
           linked tree model ("linked"). See the Saxon documentation for more information on the
           internal tree model. Default: tiny.

       -T [:classname]
           Trace various aspect of the processing; an optional class name can be given to specify
           a user-chosen tracer. The class must implement net.sf.saxon.trace.TraceListener. The
           default is a system supplied tracer. This option implies -l.

       -TJ
           Enable tracing of external Java method invocation. See -ext.

       -u
           Force interpretation of source document names as URI. By default they are considered
           to be file names, unless they start with "file:" or "http:".

       -val: {[strict] | [lax]}
           When validation is enabled, choose among "strict" or "lax" validation. Saxon-SA only.

       -x:classname
           Specify a class to be used as SAX parser for input documents. The class must implement
           either org.xml.sax.Parser or org.xml.sax.XMLReader.

       -xi
           Apply XInclude processing to all input documents.

       -xmlversion: {[1.0] | [1.1]}
           Choose the XML version for processing input documents. "1.1" must be specified to
           process XML 1.1 and Namespaces 1.1 constructs. Default: 1.0.

       -?
           Display a help message and exit.

   Options specific to saxonb-xslt
       -a
           Use the "<?xml-stylesheet ... ?>" processing instruction from the source document to
           find the stylesheet to be used. This option is not compatible with -xsl.

       -c:filename
           Use the compiled stylesheet stored in filename. This option is not compatible with
           -xsl.

       -im:modename
           Use modename as the initial mode used for the transformation. Qualified modes can be
           specified as "{uri}localname".

       -it:templatename
           Use templatename as the initial named template for the transformation. When this
           option is used, -xsl is optional.

       -m:classname
           Specify a class to be used as the receiver for messages generated by <xsl:message>.
           The class must implement net.sf.saxon.event.Receiver.

       -o:path
           Specify the path to be used for saving generated output. Usually path points to a
           filename where the main result document will be saved. If not specified such a
           document will be written to standard output.

           Additional output documents generated using the <xsl:result-document> command uses
           path as the basename for the "href" attribute of the command. If -o is missing they
           will be saved relatively to the current working directory.

           When -s identifies a directory, also -o should identify one. All the output documents
           will then be written under such a directory.

       -or:classname
           Specify a class to be used as the output resolver for the "href" attribute of
           <xsl:result-document>. The class must implement net.sf.saxon.OutputURIResolver.

       -s:path
           Specify the input file or directory. This option is required unless -it has been
           given. If path points to a filename, that file will be parsed as an XML document and
           its document node will be the context item at the beginning of the transformation. The
           special filename "-" can be used to require reading the input document from standard
           input.

           If path points to a directory all files directly contained in it will be individually
           transformed. In such a case -o is required.  -u affects the intepretation of path.

       -versmsg: {[on] | [off]}
           Enable or disable the warning about using an XSLT 2.0 processor (which Saxon-B is) on
           stylesheets which specify version="1.0" in their root element. Default: on.

       -warnings: {[silent] | [recover] | [fatal]}
           Set the policy for handling recoverable errors: "silent" for silent recovery,
           "recover" for recovery with warning output on standard error, "fatal" for no recovery.
           Default: recover.

       -xsl:filename
           Specify the main XSLT stylesheet to be used for the transformation. This option is
           required unless -a or -c are specified. The special filename "-" can be used to
           require reading the sylesheet from standard input.  -u affects the intepretation of
           filename.

       -y:filename
           Specify a class to be used as SAX parser for stylesheets. The class must implement
           either org.xml.sax.Parser or org.xml.sax.XMLReader. See also -x.

AUTHOR

       This manual page was written by Stefano Zacchiroli <zack@debian.org> for the Debian(TM)
       system (but may be used by others). Permission is granted to copy, distribute and/or
       modify this document under the terms of the GNU General Public License, Version 3 or any
       later version published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in
       /usr/share/common-licenses/GPL.

COPYRIGHT