db2x_xsltproc — XSLT processor with docbook2X extensions
db2x_xsltproc [options] {xml-document}
db2x_xsltproc is a libxslt-based XSLT processor, similar to the standard xsltproc that comes with that library. It activates the XSLT extensions needed for docbook2X's Texinfo conversion. (In the opinion of the author, this program is also a bit more user-friendly.)
The document in the file xml-document is converted, and is written to standard output (unless changed with --output).
Display libxml, libxslt and docbook2X version.
Write output to the given file (or URI), instead of standard output.
Process XInclude directives in the source document.
Indicate that the input document is SGML DocBook, rather than XML DocBook. You need this set this option if xml-document is actually a SGML file.
Specify additional SGML or XML catalogs to use for resolving Formal Public Identifiers or URIs.
db2x_xsltproc will normally refuse to load external resources from the network. If you do want to load from the network, set this option.
Usually you want to have installed locally the relevent DTDs and other files, and set up catalogs for them, rather than load them automatically from the network.
Add or modify a parameter to the stylesheet. name is a XSLT parameter name, and expr is an XPath expression that evaluates to the desired value for the parameter. (This means that strings must be quoted, in addition to the usual quoting of shell arguments; use --string-param to avoid this.)
Add or modify a string-valued parameter to the stylesheet.
The string must be in UTF-8 (or ASCII).
Specify the filename (or URI) of the stylesheet to use. The special values man and texi are accepted as abbreviations for the public IDs of the corresponding stylesheets.
Display logs of what is happening during the transformation to standard error.
Change the maximum number of nested calls to XSL templates, used to detect template infinite loops. If not specified, the limit is 500 (libxslt's default).
Display profile information: the total number of calls to each template in the stylesheet and the time taken for each. This information is output to standard error.
Specify XML Catalogs. If not specified, the standard catalog (/etc/xml/catalog) is loaded, if available.
XML_CATALOG_FILES always takes precedence over SGML_CATALOG_FILES.
Specify OASIS TR9041 catalogs. If not specified, SGML catalogs are searched for in a few standard locations. (In the LSB standard, that is /etc/sgml/catalog.)
--sgml uses libxml's built-in “DocBook” parser, which is not a real SGML parser at all, and can fail with perfectly valid SGML DocBook documents. If there is enough demand, the program can be changed to use libsp or nsgmls instead.
The docbook2X manual fully describes how to convert DocBook to man pages and Texinfo.
To know how this program works, consult the libxml2, libxslt and xsltproc documentation.