This is an automated email from the git hooks/post-receive script.
ebourg-guest pushed a commit to branch master
in repository saxonb.
commit 37158809bf8ae68beb10eaad70b9ba2d1888d9e5
Author: Michael Koch <konque...@gmx.de>
Date: Sat Feb 16 19:03:41 2008 +0000
* Added manpages for saxonb-xquery and saxonb-xslt.
---
debian/changelog | 1 +
debian/libsaxonb-java.manpages | 2 +
debian/manpages/Makefile | 10 +
debian/manpages/saxonb-common-options.ent | 211 ++++++++++++++++++++
debian/manpages/saxonb-parameters.ent | 24 +++
debian/manpages/saxonb-xquery.1 | 253 ++++++++++++++++++++++++
debian/manpages/saxonb-xquery.xml | 194 +++++++++++++++++++
debian/manpages/saxonb-xslt.1 | 309 ++++++++++++++++++++++++++++++
debian/manpages/saxonb-xslt.xml | 266 +++++++++++++++++++++++++
9 files changed, 1270 insertions(+)
diff --git a/debian/changelog b/debian/changelog
index b2231e6..cc1dd23 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ saxonb (9.0-3) UNRELEASED; urgency=low
Thanks to Stefano Zacchiroli for the patch.
* Added helpers to call XSLT and XQuery processors and documentation about
them in README.Debian. Closes: #465894.
+ * Added manpages for saxonb-xquery and saxonb-xslt.
-- Michael Koch <konque...@gmx.de> Fri, 15 Feb 2008 21:25:48 +0100
diff --git a/debian/libsaxonb-java.manpages b/debian/libsaxonb-java.manpages
new file mode 100644
index 0000000..e5452fe
--- /dev/null
+++ b/debian/libsaxonb-java.manpages
@@ -0,0 +1,2 @@
+debian/manpages/saxonb-xquery.1
+debian/manpages/saxonb-xslt.1
diff --git a/debian/manpages/Makefile b/debian/manpages/Makefile
new file mode 100644
index 0000000..2f1907b
--- /dev/null
+++ b/debian/manpages/Makefile
@@ -0,0 +1,10 @@
+DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl
+MANPAGES = saxonb-xquery.1 saxonb-xslt.1
+XML_ENTS = saxonb-common-options.ent saxonb-parameters.ent
+all: $(MANPAGES)
+clean:
+ -rm $(MANPAGES)
+saxonb-xquery.xml: $(XML_ENTS)
+saxonb-xslt.xml: $(XML_ENTS)
+%.1: %.xml
+ xsltproc -nonet $(DB2MAN) $<
diff --git a/debian/manpages/saxonb-common-options.ent
b/debian/manpages/saxonb-common-options.ent
new file mode 100644
index 0000000..7751709
--- /dev/null
+++ b/debian/manpages/saxonb-common-options.ent
@@ -0,0 +1,211 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<para>A summary of supported options is included below. Options can be passed
+ in any order.</para>
+
+<para>We first report the options which are shared by
+ <command>&dhpackage;</command> and <command>&dhother;</command>, then those
+ specific to <command>&dhpackage;</command> (or which have a different
+ semantics).</para>
+
+<para>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.</para>
+
+<refsect2>
+ <title>Common options</title>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-cr</option>:<replaceable>classname</replaceable></term>
+ <listitem>
+ <para>Specify a class to be used for processing collection URIs passed
+ to the <function>collection()</function> function. The class must
+ implement
+ <classname>net.sf.saxon.CollectionURIResolver</classname>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-dtd</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>Enable or disable DTD validation. Default: off.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-expand</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>When validation is enabled, expand default values in validated
+ documents. This option enables or disables such an expansion.
+ Default: on.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-explain</option><arg
choice="opt">:<replaceable>filename</replaceable></arg></term>
+ <listitem>
+ <para>Display an execution plan; the output is in XML format. If
+ filename is not given it will be displayed on standard
+ output.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-ext</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-l</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>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
+ <function>saxon:line-number()</function>. Default: off.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-outval</option>:<group
choice="req"><arg>recover</arg><arg>fatal</arg></group></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-p</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para> Enable or disable usage of the
+ <classname>PTreeURIResolver</classname>. Saxon-SA only.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-r</option>:<replaceable>classname</replaceable></term>
+ <listitem>
+ <para>Specify a class to be used for resolving all URIs.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-repeat</option>:<replaceable>N</replaceable></term>
+ <listitem>
+ <para>Repeat the transformation N times. For benchmarking
+ purposes.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sa</option></term>
+ <listitem>
+ <para>Perform Schema-aware processing. Saxon-SA only.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-strip</option>:<group
choice="req"><arg>all</arg><arg>none</arg><arg>ignorable</arg></group></term>
+ <listitem>
+ <para>Specify whitespace stripping policy for source documents: strip
+ all of them ("all"), strip none of them ("none"), strip ignorable
+ whitespace only ("ignorable"). Default: none.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-t</option></term>
+ <listitem>
+ <para>Display version, timing, and other debugging information on
+ standard error.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-tree</option>:<group
choice="req"><arg>tiny</arg><arg>linked</arg></group></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-T</option><arg
choice="opt">:<replaceable>classname</replaceable></arg></term>
+ <listitem>
+ <para>Trace various aspect of the processing; an optional class name can
+ be given to specify a user-chosen tracer. The class must implement
+ <classname>net.sf.saxon.trace.TraceListener</classname>. The default
+ is a system supplied tracer. This option implies
+ <option>-l</option>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-TJ</option></term>
+ <listitem>
+ <para>Enable tracing of external Java method invocation. See
+ <option>-ext</option>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-u</option></term>
+ <listitem>
+ <para>Force interpretation of source document names as URI. By default
+ they are considered to be file names, unless they start with "file:"
or
+ "http:".</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-val</option>:<group
choice="req"><arg>strict</arg><arg>lax</arg></group></term>
+ <listitem>
+ <para>When validation is enabled, choose among "strict" or "lax"
+ validation. Saxon-SA only.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-x</option>:<replaceable>classname</replaceable></term>
+ <listitem>
+ <para>Specify a class to be used as SAX parser for input documents. The
+ class must implement either <classname>org.xml.sax.Parser</classname>
+ or <classname>org.xml.sax.XMLReader</classname>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-xi</option></term>
+ <listitem>
+ <para>Apply XInclude processing to all input documents.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-xmlversion</option>:<group
choice="req"><arg>1.0</arg><arg>1.1</arg></group></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-?</option></term>
+ <listitem>
+ <para>Display a help message and exit.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+</refsect2>
diff --git a/debian/manpages/saxonb-parameters.ent
b/debian/manpages/saxonb-parameters.ent
new file mode 100644
index 0000000..ef41bfc
--- /dev/null
+++ b/debian/manpages/saxonb-parameters.ent
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<title>Parameters</title>
+
+<para>At the end of the command line, a list of <emphasis>parameters</emphasis>
+ can be given. Parameters are passed using the syntax
+ <replaceable>NAME</replaceable>=<replaceable>VALUE</replaceable>, to specify
+ parameters' names and values.</para>
+
+<para>A parameter name prefixed with "+" (plus sign) will be interpreted as a
+ <emphasis>filesystem path parameter</emphasis> 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.</para>
+
+<para>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.</para>
+
+<para>To pass parameters belonging to the non-null namespace, the syntax
+
{<replaceable>uri</replaceable>}<replaceable>localname</replaceable>=<replaceable>value</replaceable>
+ is provided.</para>
+
diff --git a/debian/manpages/saxonb-xquery.1 b/debian/manpages/saxonb-xquery.1
new file mode 100644
index 0000000..bb36541
--- /dev/null
+++ b/debian/manpages/saxonb-xquery.1
@@ -0,0 +1,253 @@
+.\" Title: saxonb-xquery
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
+.\" Date: February 2008
+.\" Manual:
+.\" Source:
+.\"
+.TH "SAXONB\-XQUERY" "1" "February 2008" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+saxonb-xquery - command line XQuery processor
+.SH "SYNOPSIS"
+.HP 14
+\fBsaxonb\-xquery\fR [\fIOPTION\fR...] \fI\fIQUERYFILE\fR\fR
[\fINAME\fR=\fIVALUE\fR...]
+.SH "DESCRIPTION"
+.PP
+This manual page documents briefly the
+\fBsaxonb\-xquery\fR
+command\. This page was written for the
+Debian(TM)
+distribution because the original program does not have a manual page\. Still,
it has HTML documentation which is shipped in the
+libsaxonb\-java\-doc
+package\.
+.PP
+\fBsaxonb\-xquery\fR
+is a command line wrapper around the Saxon\-B XSLT and XQuery processor\. Using
+\fBsaxonb\-xquery\fR
+you can evaluate
+\fIXQuery\fR
+queries directly from the command line\. Internally,
+\fBsaxonb\-xquery\fR
+is a wrapper around the Java class
+\fBnet\.sf\.saxon\.Query\fR
+implemented by Saxon\-B\.
+.PP
+\fBsaxonb\-xquery\fR
+should be invoked passing a (required) filename containing the XQuery query to
be evaluated; the special filename "\-" can be given to require reading the
query from standard input\.
+.PP
+Before the query filename a list of options can be given, see below\.
+.SS "Parameters"
+.PP
+At the end of the command line, a list of
+\fIparameters\fR
+can be given\. Parameters are passed using the syntax
+\fINAME\fR=\fIVALUE\fR, to specify parameters\' names and values\.
+.PP
+A parameter name prefixed with "+" (plus sign) will be interpreted as a
+\fIfilesystem path parameter\fR
+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\.
+.PP
+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\.
+.PP
+To pass parameters belonging to the non\-null namespace, the syntax
{\fIuri\fR}\fIlocalname\fR=\fIvalue\fR
+is provided\.
+.PP
+Parameters will be visible as external variables during query evaluation,
provided they have been declared in the query prolog\. See the XQuery
specification for more information on variables and their declarations\.
+.SH "OPTIONS"
+.PP
+A summary of supported options is included below\. Options can be passed in
any order\.
+.PP
+We first report the options which are shared by
+\fBsaxonb\-xquery\fR
+and
+\fBsaxonb\-xslt\fR, then those specific to
+\fBsaxonb\-xquery\fR
+(or which have a different semantics)\.
+.PP
+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\.
+.SS "Common options"
+.PP
+\fB\-cr\fR:\fIclassname\fR
+.RS 4
+Specify a class to be used for processing collection URIs passed to the
+\fBcollection()\fR
+function\. The class must implement
+net\.sf\.saxon\.CollectionURIResolver\.
+.RE
+.PP
+\fB\-dtd\fR: {[on] | [off]}
+.RS 4
+Enable or disable DTD validation\. Default: off\.
+.RE
+.PP
+\fB\-expand\fR: {[on] | [off]}
+.RS 4
+When validation is enabled, expand default values in validated documents\.
This option enables or disables such an expansion\. Default: on\.
+.RE
+.PP
+\fB\-explain\fR [:\fIfilename\fR]
+.RS 4
+Display an execution plan; the output is in XML format\. If filename is not
given it will be displayed on standard output\.
+.RE
+.PP
+\fB\-ext\fR: {[on] | [off]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-l\fR: {[on] | [off]}
+.RS 4
+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
+\fBsaxon:line\-number()\fR\. Default: off\.
+.RE
+.PP
+\fB\-outval\fR: {[recover] | [fatal]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-p\fR: {[on] | [off]}
+.RS 4
+Enable or disable usage of the
+PTreeURIResolver\. Saxon\-SA only\.
+.RE
+.PP
+\fB\-r\fR:\fIclassname\fR
+.RS 4
+Specify a class to be used for resolving all URIs\.
+.RE
+.PP
+\fB\-repeat\fR:\fIN\fR
+.RS 4
+Repeat the transformation N times\. For benchmarking purposes\.
+.RE
+.PP
+\fB\-sa\fR
+.RS 4
+Perform Schema\-aware processing\. Saxon\-SA only\.
+.RE
+.PP
+\fB\-strip\fR: {[all] | [none] | [ignorable]}
+.RS 4
+Specify whitespace stripping policy for source documents: strip all of them
("all"), strip none of them ("none"), strip ignorable whitespace only
("ignorable")\. Default: none\.
+.RE
+.PP
+\fB\-t\fR
+.RS 4
+Display version, timing, and other debugging information on standard error\.
+.RE
+.PP
+\fB\-tree\fR: {[tiny] | [linked]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-T\fR [:\fIclassname\fR]
+.RS 4
+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
+\fB\-l\fR\.
+.RE
+.PP
+\fB\-TJ\fR
+.RS 4
+Enable tracing of external Java method invocation\. See
+\fB\-ext\fR\.
+.RE
+.PP
+\fB\-u\fR
+.RS 4
+Force interpretation of source document names as URI\. By default they are
considered to be file names, unless they start with "file:" or "http:"\.
+.RE
+.PP
+\fB\-val\fR: {[strict] | [lax]}
+.RS 4
+When validation is enabled, choose among "strict" or "lax" validation\.
Saxon\-SA only\.
+.RE
+.PP
+\fB\-x\fR:\fIclassname\fR
+.RS 4
+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\.
+.RE
+.PP
+\fB\-xi\fR
+.RS 4
+Apply XInclude processing to all input documents\.
+.RE
+.PP
+\fB\-xmlversion\fR: {[1\.0] | [1\.1]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-?\fR
+.RS 4
+Display a help message and exit\.
+.RE
+.SS "Options specific to saxonb\-xquery"
+.PP
+\fB\-mr:\fR\fB\fIclassname\fR\fR
+.RS 4
+Use the specifed class as a
+ModuleURIResolver
+to resolve query module URIs\. The class must implement
+net\.sf\.saxon\.query\.ModuleURIResolver\.
+.RE
+.PP
+\fB\-o\fR:\fIfilename\fR
+.RS 4
+Send the query output to the specified filename\. If not specified the output
will be sent to standard output\. See also
+\fB\-wrap\fR\.
+.RE
+.PP
+\fB\-pipe\fR: {[push] | [pull]}
+.RS 4
+Internally, execute query in push or pull mode\. Mainly for testing purposes\.
Push mode is usually faster when intermediate tree are constructed in memory\.
Default: push\.
+.RE
+.PP
+\fB\-projection\fR: {[on] | [off]}
+.RS 4
+Enable or disable document projection, i\.e\. the ability to throw away tree
parts which will not be accessed by a query\. Saxon\-SA only\.
+.RE
+.PP
+\fB\-s\fR: {[\fIfile\fR] | [\fIURI\fR]}
+.RS 4
+Read document input from the specified filename ("\-" can be given to read
from standard input)\. The read document will be available to the query as the
context node\.
+\fB\-u\fR
+affects how filename is interpreted\.
+.RE
+.PP
+\fB\-wrap\fR: {[on] | [off]}
+.RS 4
+Enable or disable wrapping of query result in a XML structure which makes
explicit the kind of each output node or atomic value\. For example
free\-standing attributes will be wrapped in an explicit XML element stating
that they are attributes\. When this is off, the query output will be wrapped
only using a document node; in such a setting is possible that output parts,
such as free\-standing attributes, can\'t be serialized\. Default: off\.
+.RE
+.SH "SEE ALSO"
+.PP
+saxonb\-xslt (1), XQuery 1\.0: An XML Query Language (W3C Recommendation)\.
+.PP
+This program is fully documented by the HTML documentation of Saxon, available
in the
+libsaxon\-java\-doc
+Debian package\.
+.SH "AUTHOR"
+.PP
+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\.
+.PP
+On Debian systems, the complete text of the GNU General Public License can be
found in /usr/share/common\-licenses/GPL\.
+.SH "COPYRIGHT"
+Copyright \(co 2008 Stefano Zacchiroli
+.br
diff --git a/debian/manpages/saxonb-xquery.xml
b/debian/manpages/saxonb-xquery.xml
new file mode 100644
index 0000000..dc0af6d
--- /dev/null
+++ b/debian/manpages/saxonb-xquery.xml
@@ -0,0 +1,194 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"; [
+
+ <!ENTITY dhfirstname "<firstname>Stefano</firstname>">
+ <!ENTITY dhsurname "<surname>Zacchiroli</surname>">
+ <!ENTITY dhdate "<date>February 2008</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>z...@debian.org</email>">
+ <!ENTITY dhusername "&dhfirstname; &dhsurname;">
+ <!ENTITY dhucpackage "<refentrytitle>saxonb-xquery</refentrytitle>">
+ <!ENTITY dhpackage "saxonb-xquery">
+ <!ENTITY dhother "saxonb-xslt">
+ <!ENTITY docpackage "libsaxon-java-doc">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+ <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
+
+ <!ENTITY common-options SYSTEM "saxonb-common-options.ent">
+ <!ENTITY parameters SYSTEM "saxonb-parameters.ent">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <copyright>
+ <year>2008</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhpackage;</refname>
+
+ <refpurpose>command line XQuery processor</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhpackage;</command>
+ <arg rep="repeat"><replaceable>OPTION</replaceable></arg>
+ <arg
choice="plain"><replaceable><filename>QUERYFILE</filename></replaceable></arg>
+ <arg
rep="repeat"><replaceable>NAME</replaceable>=<replaceable>VALUE</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page documents briefly the <command>&dhpackage;</command>
+ command. This page was written for the &debian; distribution because the
+ original program does not have a manual page. Still, it has HTML
+ documentation which is shipped in the
+ <application>libsaxonb-java-doc</application> package.</para>
+
+ <para><command>&dhpackage;</command> is a command line wrapper around the
+ Saxon-B XSLT and XQuery processor. Using <command>&dhpackage;</command>
+ you can evaluate <emphasis>XQuery</emphasis> queries directly from the
+ command line. Internally, <command>&dhpackage;</command> is a wrapper
+ around the Java class <command>net.sf.saxon.Query</command> implemented
+ by Saxon-B.</para>
+
+ <para><command>&dhpackage;</command> should be invoked passing a (required)
+ filename containing the XQuery query to be evaluated; the special
+ filename "-" can be given to require reading the query from standard
+ input.</para>
+
+ <para>Before the query filename a list of options can be given, see
+ below.</para>
+
+ <refsect2>
+
+ ¶meters;
+
+ <para>Parameters will be visible as external variables during query
+ evaluation, provided they have been declared in the query prolog. See
+ the XQuery specification for more information on variables and their
+ declarations.</para>
+
+ </refsect2>
+
+ </refsect1>
+
+ <refsect1>
+ <title>OPTIONS</title>
+
+ &common-options;
+
+ <refsect2>
+ <title>Options specific to &dhpackage;</title>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-mr:<replaceable>classname</replaceable></option></term>
+ <listitem>
+ <para>Use the specifed class as a
+ <classname>ModuleURIResolver</classname> to resolve query module
+ URIs. The class must implement
+
<classname>net.sf.saxon.query.ModuleURIResolver</classname>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-o</option>:<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>Send the query output to the specified filename. If not
+ specified the output will be sent to standard output. See also
+ <option>-wrap</option>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-pipe</option>:<group
choice="req"><arg>push</arg><arg>pull</arg></group></term>
+ <listitem>
+ <para>Internally, execute query in push or pull mode. Mainly for
+ testing purposes. Push mode is usually faster when intermediate
+ tree are constructed in memory. Default: push.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-projection</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>Enable or disable document projection, i.e. the ability to
+ throw away tree parts which will not be accessed by a query.
+ Saxon-SA only.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-s</option>:<group
choice="req"><arg><replaceable>file</replaceable></arg><arg><replaceable>URI</replaceable></arg></group></term>
+ <listitem>
+ <para>Read document input from the specified filename ("-" can be
+ given to read from standard input). The read document will be
+ available to the query as the context node. <option>-u</option>
+ affects how filename is interpreted.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-wrap</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>Enable or disable wrapping of query result in a XML structure
+ which makes explicit the kind of each output node or atomic
+ value. For example free-standing attributes will be wrapped in an
+ explicit XML element stating that they are attributes. When this
+ is off, the query output will be wrapped only using a document
+ node; in such a setting is possible that output parts, such as
+ free-standing attributes, can't be serialized. Default:
+ off.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect2>
+
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>saxonb-xslt (1), XQuery 1.0: An XML Query Language (W3C
+ Recommendation).</para>
+
+ <para>This program is fully documented by the HTML documentation of Saxon,
+ available in the <application>&docpackage;</application> Debian
+ package.</para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>This manual page was written by &dhusername; &dhemail; for
+ the &debian; 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.
+ </para>
+ <para>
+ On Debian systems, the complete text of the GNU General Public
+ License can be found in /usr/share/common-licenses/GPL.
+ </para>
+
+ </refsect1>
+</refentry>
+
diff --git a/debian/manpages/saxonb-xslt.1 b/debian/manpages/saxonb-xslt.1
new file mode 100644
index 0000000..8bf0029
--- /dev/null
+++ b/debian/manpages/saxonb-xslt.1
@@ -0,0 +1,309 @@
+.\" Title: saxonb-xslt
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
+.\" Date: February 2008
+.\" Manual:
+.\" Source:
+.\"
+.TH "SAXONB\-XSLT" "1" "February 2008" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+saxonb-xslt - command line XSLT 2.0 processor
+.SH "SYNOPSIS"
+.HP 12
+\fBsaxonb\-xslt\fR [\fIOPTION\fR...] [\fB\-s:\fR\fB\fISOURCEFILE\fR\fR]
[\fB\-xsl:\fR\fB\fISTYLESHEET\fR\fR] [\fB\-o:\fR\fB\fIOUTPUT\fR\fR]
[\fINAME\fR=\fIVALUE\fR...]
+.SH "DESCRIPTION"
+.PP
+This manual page documents briefly the
+\fBsaxonb\-xslt\fR
+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\.
+.PP
+\fBsaxonb\-xslt\fR
+is a command line wrapper around the Saxon\-B XSLT and XQuery processor\. Using
+\fBsaxonb\-xslt\fR
+you can process XML documents with
+\fIXSLT 2\.0\fR
+stylesheets directly from the command line\. Internally,
+\fBsaxonb\-xslt\fR
+is a wrapper around the Java class
+\fBnet\.sf\.saxon\.Transform\fR
+implemented by Saxon\-B\.
+.PP
+\fBsaxonb\-xslt\fR
+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\.
+.SS "Parameters"
+.PP
+At the end of the command line, a list of
+\fIparameters\fR
+can be given\. Parameters are passed using the syntax
+\fINAME\fR=\fIVALUE\fR, to specify parameters\' names and values\.
+.PP
+A parameter name prefixed with "+" (plus sign) will be interpreted as a
+\fIfilesystem path parameter\fR
+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\.
+.PP
+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\.
+.PP
+To pass parameters belonging to the non\-null namespace, the syntax
{\fIuri\fR}\fIlocalname\fR=\fIvalue\fR
+is provided\.
+.PP
+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\.
+.SH "OPTIONS"
+.PP
+A summary of supported options is included below\. Options can be passed in
any order\.
+.PP
+We first report the options which are shared by
+\fBsaxonb\-xslt\fR
+and
+\fBsaxonb\-xquery\fR, then those specific to
+\fBsaxonb\-xslt\fR
+(or which have a different semantics)\.
+.PP
+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\.
+.SS "Common options"
+.PP
+\fB\-cr\fR:\fIclassname\fR
+.RS 4
+Specify a class to be used for processing collection URIs passed to the
+\fBcollection()\fR
+function\. The class must implement
+net\.sf\.saxon\.CollectionURIResolver\.
+.RE
+.PP
+\fB\-dtd\fR: {[on] | [off]}
+.RS 4
+Enable or disable DTD validation\. Default: off\.
+.RE
+.PP
+\fB\-expand\fR: {[on] | [off]}
+.RS 4
+When validation is enabled, expand default values in validated documents\.
This option enables or disables such an expansion\. Default: on\.
+.RE
+.PP
+\fB\-explain\fR [:\fIfilename\fR]
+.RS 4
+Display an execution plan; the output is in XML format\. If filename is not
given it will be displayed on standard output\.
+.RE
+.PP
+\fB\-ext\fR: {[on] | [off]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-l\fR: {[on] | [off]}
+.RS 4
+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
+\fBsaxon:line\-number()\fR\. Default: off\.
+.RE
+.PP
+\fB\-outval\fR: {[recover] | [fatal]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-p\fR: {[on] | [off]}
+.RS 4
+Enable or disable usage of the
+PTreeURIResolver\. Saxon\-SA only\.
+.RE
+.PP
+\fB\-r\fR:\fIclassname\fR
+.RS 4
+Specify a class to be used for resolving all URIs\.
+.RE
+.PP
+\fB\-repeat\fR:\fIN\fR
+.RS 4
+Repeat the transformation N times\. For benchmarking purposes\.
+.RE
+.PP
+\fB\-sa\fR
+.RS 4
+Perform Schema\-aware processing\. Saxon\-SA only\.
+.RE
+.PP
+\fB\-strip\fR: {[all] | [none] | [ignorable]}
+.RS 4
+Specify whitespace stripping policy for source documents: strip all of them
("all"), strip none of them ("none"), strip ignorable whitespace only
("ignorable")\. Default: none\.
+.RE
+.PP
+\fB\-t\fR
+.RS 4
+Display version, timing, and other debugging information on standard error\.
+.RE
+.PP
+\fB\-tree\fR: {[tiny] | [linked]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-T\fR [:\fIclassname\fR]
+.RS 4
+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
+\fB\-l\fR\.
+.RE
+.PP
+\fB\-TJ\fR
+.RS 4
+Enable tracing of external Java method invocation\. See
+\fB\-ext\fR\.
+.RE
+.PP
+\fB\-u\fR
+.RS 4
+Force interpretation of source document names as URI\. By default they are
considered to be file names, unless they start with "file:" or "http:"\.
+.RE
+.PP
+\fB\-val\fR: {[strict] | [lax]}
+.RS 4
+When validation is enabled, choose among "strict" or "lax" validation\.
Saxon\-SA only\.
+.RE
+.PP
+\fB\-x\fR:\fIclassname\fR
+.RS 4
+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\.
+.RE
+.PP
+\fB\-xi\fR
+.RS 4
+Apply XInclude processing to all input documents\.
+.RE
+.PP
+\fB\-xmlversion\fR: {[1\.0] | [1\.1]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-?\fR
+.RS 4
+Display a help message and exit\.
+.RE
+.SS "Options specific to saxonb\-xslt"
+.PP
+\fB\-a\fR
+.RS 4
+Use the "<?xml\-stylesheet \.\.\. ?>" processing instruction from the source
document to find the stylesheet to be used\. This option is not compatible with
+\fB\-xsl\fR\.
+.RE
+.PP
+\fB\-c\fR:\fIfilename\fR
+.RS 4
+Use the compiled stylesheet stored in filename\. This option is not compatible
with
+\fB\-xsl\fR\.
+.RE
+.PP
+\fB\-im\fR:\fImodename\fR
+.RS 4
+Use modename as the initial mode used for the transformation\. Qualified modes
can be specified as "{\fIuri\fR}\fIlocalname\fR"\.
+.RE
+.PP
+\fB\-it\fR:\fItemplatename\fR
+.RS 4
+Use templatename as the initial named template for the transformation\. When
this option is used,
+\fB\-xsl\fR
+is optional\.
+.RE
+.PP
+\fB\-m\fR:\fIclassname\fR
+.RS 4
+Specify a class to be used as the receiver for messages generated by
<xsl:message>\. The class must implement
+net\.sf\.saxon\.event\.Receiver\.
+.RE
+.PP
+\fB\-o\fR:\fIpath\fR
+.RS 4
+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\.
+.sp
+Additional output documents generated using the <xsl:result\-document> command
uses path as the basename for the "href" attribute of the command\. If
+\fB\-o\fR
+is missing they will be saved relatively to the current working directory\.
+.sp
+When
+\fB\-s\fR
+identifies a directory, also
+\fB\-o\fR
+should identify one\. All the output documents will then be written under such
a directory\.
+.RE
+.PP
+\fB\-or\fR:\fIclassname\fR
+.RS 4
+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\.
+.RE
+.PP
+\fB\-s\fR:\fIpath\fR
+.RS 4
+Specify the input file or directory\. This option is required unless
+\fB\-it\fR
+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\.
+.sp
+If path points to a directory all files directly contained in it will be
individually transformed\. In such a case
+\fB\-o\fR
+is required\.
+\fB\-u\fR
+affects the intepretation of path\.
+.RE
+.PP
+\fB\-versmsg\fR: {[on] | [off]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-warnings\fR: {[silent] | [recover] | [fatal]}
+.RS 4
+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\.
+.RE
+.PP
+\fB\-xsl\fR:\fIfilename\fR
+.RS 4
+Specify the main XSLT stylesheet to be used for the transformation\. This
option is required unless
+\fB\-a\fR
+or
+\fB\-c\fR
+are specified\. The special filename "\-" can be used to require reading the
sylesheet from standard input\.
+\fB\-u\fR
+affects the intepretation of filename\.
+.RE
+.PP
+\fB\-y\fR:\fIfilename\fR
+.RS 4
+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
+\fB\-x\fR\.
+.RE
+.SH "SEE ALSO"
+.PP
+saxonb\-xquery (1), XSL Transformations (XSLT) Version 2\.0 (W3C
Recommendation)\.
+.PP
+This program is fully documented by the HTML documentation of Saxon, available
in the
+libsaxon\-java\-doc
+Debian package\.
+.SH "AUTHOR"
+.PP
+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\.
+.PP
+On Debian systems, the complete text of the GNU General Public License can be
found in /usr/share/common\-licenses/GPL\.
+.SH "COPYRIGHT"
+Copyright \(co 2008 Stefano Zacchiroli
+.br
diff --git a/debian/manpages/saxonb-xslt.xml b/debian/manpages/saxonb-xslt.xml
new file mode 100644
index 0000000..a12be70
--- /dev/null
+++ b/debian/manpages/saxonb-xslt.xml
@@ -0,0 +1,266 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"; [
+
+ <!ENTITY dhfirstname "<firstname>Stefano</firstname>">
+ <!ENTITY dhsurname "<surname>Zacchiroli</surname>">
+ <!ENTITY dhdate "<date>February 2008</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>z...@debian.org</email>">
+ <!ENTITY dhusername "&dhfirstname; &dhsurname;">
+ <!ENTITY dhucpackage "<refentrytitle>saxonb-xslt</refentrytitle>">
+ <!ENTITY dhpackage "saxonb-xslt">
+ <!ENTITY dhother "saxonb-xquery">
+ <!ENTITY docpackage "libsaxon-java-doc">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+ <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
+
+ <!ENTITY common-options SYSTEM "saxonb-common-options.ent">
+ <!ENTITY parameters SYSTEM "saxonb-parameters.ent">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <copyright>
+ <year>2008</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhpackage;</refname>
+
+ <refpurpose>command line XSLT 2.0 processor</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhpackage;</command>
+ <arg rep="repeat"><replaceable>OPTION</replaceable></arg>
+ <arg><option>-s:<replaceable>SOURCEFILE</replaceable></option></arg>
+ <arg><option>-xsl:<replaceable>STYLESHEET</replaceable></option></arg>
+ <arg><option>-o:<replaceable>OUTPUT</replaceable></option></arg>
+ <arg
rep="repeat"><replaceable>NAME</replaceable>=<replaceable>VALUE</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page documents briefly the <command>&dhpackage;</command>
+ command. This page was written for the &debian; distribution because the
+ original program does not have a manual page. Instead, it has HTML
+ documentation which is shipped in the
+ <application>libsaxonb-java-doc</application> package.</para>
+
+ <para><command>&dhpackage;</command> is a command line wrapper around the
+ Saxon-B XSLT and XQuery processor. Using <command>&dhpackage;</command>
+ you can process XML documents with <emphasis>XSLT 2.0</emphasis>
+ stylesheets directly from the command line. Internally,
+ <command>&dhpackage;</command> is a wrapper around the Java class
+ <command>net.sf.saxon.Transform</command> implemented by Saxon-B.</para>
+
+ <para><command>&dhpackage;</command> 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.</para>
+
+ <refsect2>
+
+ ¶meters;
+
+ <para>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.</para>
+
+ </refsect2>
+
+ </refsect1>
+
+ <refsect1>
+ <title>OPTIONS</title>
+
+ &common-options;
+
+ <refsect2>
+ <title>Options specific to &dhpackage;</title>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-a</option></term>
+ <listitem>
+ <para>Use the "<?xml-stylesheet ... ?>" processing
+ instruction from the source document to find the stylesheet to be
+ used. This option is not compatible with
+ <option>-xsl</option>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-c</option>:<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>Use the compiled stylesheet stored in filename. This option
+ is not compatible with <option>-xsl</option>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-im</option>:<replaceable>modename</replaceable></term>
+ <listitem>
+ <para>Use modename as the initial mode used for the transformation.
+ Qualified modes can be specified as
+
"{<replaceable>uri</replaceable>}<replaceable>localname</replaceable>".</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+
<term><option>-it</option>:<replaceable>templatename</replaceable></term>
+ <listitem>
+ <para>Use templatename as the initial named template for the
+ transformation. When this option is used, <option>-xsl</option>
+ is optional.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-m</option>:<replaceable>classname</replaceable></term>
+ <listitem>
+ <para>Specify a class to be used as the receiver for messages
+ generated by <xsl:message>. The class must implement
+ <classname>net.sf.saxon.event.Receiver</classname>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-o</option>:<replaceable>path</replaceable></term>
+ <listitem>
+ <para>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.</para>
+ <para>Additional output documents generated using
+ the <xsl:result-document> command uses path as the basename
+ for the "href" attribute of the command. If <option>-o</option>
+ is missing they will be saved relatively to the current working
+ directory.</para>
+ <para>When <option>-s</option> identifies a directory, also
+ <option>-o</option> should identify one. All the output documents
+ will then be written under such a directory.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-or</option>:<replaceable>classname</replaceable></term>
+ <listitem>
+ <para>Specify a class to be used as the output resolver for the
+ "href" attribute of <xsl:result-document>. The class must
+ implement
+ <classname>net.sf.saxon.OutputURIResolver</classname>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-s</option>:<replaceable>path</replaceable></term>
+ <listitem>
+ <para>Specify the input file or directory. This option is required
+ unless <option>-it</option> 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.</para>
+ <para>If path points to a directory all files directly contained in
+ it will be individually transformed. In such a case
+ <option>-o</option> is required. <option>-u</option> affects the
+ intepretation of path.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-versmsg</option>:<group
choice="req"><arg>on</arg><arg>off</arg></group></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-warnings</option>:<group
choice="req"><arg>silent</arg><arg>recover</arg><arg>fatal</arg></group></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-xsl</option>:<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>Specify the main XSLT stylesheet to be used for the
+ transformation. This option is required unless
+ <option>-a</option> or <option>-c</option> are specified. The
+ special filename "-" can be used to require reading the sylesheet
+ from standard input. <option>-u</option> affects the
+ intepretation of filename.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-y</option>:<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>Specify a class to be used as SAX parser for stylesheets. The
+ class must implement either
+ <classname>org.xml.sax.Parser</classname> or
+ <classname>org.xml.sax.XMLReader</classname>. See also
+ <option>-x</option>.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect2>
+
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>saxonb-xquery (1), XSL Transformations (XSLT) Version 2.0 (W3C
+ Recommendation).</para>
+
+ <para>This program is fully documented by the HTML documentation of Saxon,
+ available in the <application>&docpackage;</application> Debian
+ package.</para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>This manual page was written by &dhusername; &dhemail; for
+ the &debian; 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.
+ </para>
+ <para>
+ On Debian systems, the complete text of the GNU General Public
+ License can be found in /usr/share/common-licenses/GPL.
+ </para>
+
+ </refsect1>
+</refentry>
+
--
Alioth's /usr/local/bin/git-commit-notice on
/srv/git.debian.org/git/pkg-java/saxonb.git
_______________________________________________
pkg-java-commits mailing list
pkg-java-comm...@lists.alioth.debian.org
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-java-commits
