From 9b631cb80d4520027d269cc8025c9dabd1a837aa Mon Sep 17 00:00:00 2001 From: John Fleck Date: Tue, 22 Mar 2005 04:05:14 +0000 Subject: [PATCH] Mon Mar 21 20:56:43 MST 2005 John Fleck (jfleck@inkstain.net) Mon Mar 21 20:56:43 MST 2005 John Fleck (jfleck@inkstain.net) * doc/xsltproc.xml, xsltproc.html, xsltproc.1 update documentation to reflect addition of --nodtdattr command line flag. Bug #171098 --- ChangeLog | 6 +++ doc/xsltproc.1 | 10 +++-- doc/xsltproc.html | 107 ++++++++++++++++++++++++++++++------------------------ doc/xsltproc.xml | 12 +++++- 4 files changed, 83 insertions(+), 52 deletions(-) diff --git a/ChangeLog b/ChangeLog index c5708d4..51dd45a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Mon Mar 21 20:56:43 MST 2005 John Fleck (jfleck@inkstain.net) + + * doc/xsltproc.xml, xsltproc.html, xsltproc.1 + update documentation to reflect addition of --nodtdattr + command line flag. Bug #171098 + Wed Mar 16 17:19:24 HKT 2005 William Brack (wbrack@mmm.com.hk) * libxslt/xslt.c: fixed problem with text node on stylesheet diff --git a/doc/xsltproc.1 b/doc/xsltproc.1 index 721c75a..8aaabbd 100644 --- a/doc/xsltproc.1 +++ b/doc/xsltproc.1 @@ -24,7 +24,7 @@ xsltproc \- command line xslt processor .ad l .hy 0 .HP 9 -\fBxsltproc\fR [\fB\-V\fR | \fB\-v\fR | \fB\-o\ \fIfile\fR\fR | \fB\-\-timing\fR | \fB\-\-repeat\fR | \fB\-\-debug\fR | \fB\-\-novalid\fR | \fB\-\-noout\fR | \fB\-\-maxdepth\ \fIval\fR\fR | \fB\-\-html\fR | \fB\-\-param\ \fIname\fR\ \fIvalue\fR\fR | \fB\-\-stringparam\ \fIname\fR\ \fIvalue\fR\fR | \fB\-\-nonet\fR | \fB\-\-path\ \fIpaths\fR\fR | \fB\-\-load\-trace\fR | \fB\-\-catalogs\fR | \fB\-\-xinclude\fR | \fB\-\-profile\fR | \fB\-\-dumpextensions\fR | \fB\-\-nowrite\fR | \fB\-\-nomkdir\fR | \fB\-\-writesubtree\fR] [\fB\fIstylesheet\fR\fR] [\fIfile1\fR] [\fIfile2\fR] [\fI\&.\&.\&.\&.\fR] +\fBxsltproc\fR [\fB\-V\fR | \fB\-v\fR | \fB\-o\ \fIfile\fR\fR | \fB\-\-timing\fR | \fB\-\-repeat\fR | \fB\-\-debug\fR | \fB\-\-novalid\fR | \fB\-\-noout\fR | \fB\-\-maxdepth\ \fIval\fR\fR | \fB\-\-html\fR | \fB\-\-param\ \fIname\fR\ \fIvalue\fR\fR | \fB\-\-stringparam\ \fIname\fR\ \fIvalue\fR\fR | \fB\-\-nonet\fR | \fB\-\-path\ \fIpaths\fR\fR | \fB\-\-load\-trace\fR | \fB\-\-catalogs\fR | \fB\-\-xinclude\fR | \fB\-\-profile\fR | \fB\-\-dumpextensions\fR | \fB\-\-nowrite\fR | \fB\-\-nomkdir\fR | \fB\-\-writesubtree\fR | \fB\-\-nodtdattr\fR] [\fB\fIstylesheet\fR\fR] [\fIfile1\fR] [\fIfile2\fR] [\fI\&.\&.\&.\&.\fR] .ad .hy @@ -54,7 +54,7 @@ Output each step taken by xsltproc in processing the stylesheet and the document .TP \fB\-o\fR or \fB\-\-output\fR \fIfile\fR -Direct output to the file named \fIfile\fR\&. For multiple outputs, also known as "chunking", \fB\-o\fR \fBdirectory/\fR directs the output files to a specified directory\&. The directory must already exist\&. +Direct output to the file named \fIfile\fR\&. For multiple outputs, also known as "chunking", \fB\-o\fR \fBdirectory/\fR directs the output files to a specified directory\&. The directory must already exist\&. .TP \fB\-\-timing\fR @@ -110,7 +110,7 @@ Use the SGML catalog specified in \fBSGML_CATALOG_FILES\fR to resolve the locati .TP \fB\-\-xinclude\fR -Process the input document using the Xinclude specification\&. More details on this can be found in the Xinclude specification: http://www\&.w3\&.org/TR/xinclude/: \fIhttp://www.w3.org/TR/xinclude/\fR +Process the input document using the Xinclude specification\&. More details on this can be found in the Xinclude specification: http://www\&.w3\&.org/TR/xinclude/: \fIhttp://www.w3.org/TR/xinclude/\fR .TP \fB\-\-profile\fR or \fB\-\-norman\fR @@ -132,6 +132,10 @@ Refuses to create directories\&. \fB\-\-writesubtree\fR \fIpath\fR Allow file write only within the \fIpath\fR subtree\&. +.TP +\fB\-\-nodtdattr\fR +Do not apply default attributes from the document's DTD\&. + .SH "RETURN VALUES" .PP diff --git a/doc/xsltproc.html b/doc/xsltproc.html index fd34a3b..2aafaec 100644 --- a/doc/xsltproc.html +++ b/doc/xsltproc.html @@ -1,90 +1,101 @@ -xsltproc

Name

xsltproc — command line xslt processor

Synopsis

xsltproc [[-V] | [-v] | [-o file] | [--timing] | [--repeat] | [--debug] | [--novalid] | [--noout] | [--maxdepth val] | [--html] | [--param name value] | [--stringparam name value] | [--nonet] | [--catalogs] | [--xinclude] | [--profile] | [--dumpextensions] | [--nowrite] | [--nomkdir] | [--writesubtree]] [stylesheet] [file1] [file2] [....]

Introduction

- xsltproc is a command line tool for applying - XSLT stylesheets to XML - documents. It is part of libxslt, the XSLT C +xsltproc

Name

xsltproc — command line xslt processor

Synopsis

xsltproc [[-V] | [-v] | [-o file] | [--timing] | [--repeat] | [--debug] | [--novalid] | [--noout] | [--maxdepth val] | [--html] | [--param name value] | [--stringparam name value] | [--nonet] | [--path paths] | [--load-trace] | [--catalogs] | [--xinclude] | [--profile] | [--dumpextensions] | [--nowrite] | [--nomkdir] | [--writesubtree] | [--nodtdattr]] [stylesheet] [file1] [file2] [....]

Introduction

+ xsltproc is a command line tool for applying + XSLT stylesheets to XML + documents. It is part of libxslt, the XSLT C library for GNOME. While it was developed as part of the GNOME project, it can operate independently of the GNOME desktop.

- xsltproc is invoked from the command line with + xsltproc is invoked from the command line with the name of the stylesheet to be used followed by the name of the file or - files to which the stylesheet is to be applied. + files to which the stylesheet is to be applied. It will use the standard + input if a filename provided is - .

- If a stylesheet is included in an XML document with a + If a stylesheet is included in an XML document with a Stylesheet Processing Instruction, no stylesheet need be named at the - command line. xsltproc will automatically + command line. xsltproc will automatically detect the included stylesheet and use it.

By default, output is to stdout. You can specify a file for output using - the -o option. -

Command Line Options

-V or --version
Show the version of - libxml and libxslt used. + the -o option. +

Command Line Options

-V or --version
Show the version of + libxml and libxslt used.
- -v or --verbose
Output each step taken - by xsltproc in processing the stylesheet and the document. + -v or --verbose
Output each step taken + by xsltproc in processing the stylesheet and the document.
- -o or --output file
Direct output to the file named - file. For multiple outputs, also known as - "chunking", -o directory/ directs the + -o or --output file
Direct output to the file named + file. For multiple outputs, also known as + "chunking", -o directory/ directs the output files to a specified directory. The directory must already exist.
- --timing
Display the time used for parsing the + --timing
Display the time used for parsing the stylesheet, parsing the document and applying the stylesheet and saving the result. Displayed in milliseconds.
- --repeat
Run the transformation 20 times. Used for + --repeat
Run the transformation 20 times. Used for timing tests.
- --debug
Output an XML tree of the + --debug
Output an XML tree of the transformed document for debugging purposes.
- --novalid
Skip loading the document's DTD. + --novalid
Skip loading the document's DTD.
- --noout
Do not output the result. + --noout
Do not output the result.
- --maxdepth value
Adjust the + --maxdepth value
Adjust the maximum depth of the template stack before - libxslt concludes it is in an infinite + libxslt concludes it is in an infinite loop. The default is 500.
- --html
The input document is an HTML + --html
The input document is an HTML file.
- --param name value
Pass a parameter of name - name and value - value to the stylesheet. You may pass multiple + --param name value
Pass a parameter of name + name and value + value to the stylesheet. You may pass multiple name/value pairs up to a maximum of 32. If the value being passed is a string rather than a node identifier, use - --stringparam instead. + --stringparam instead.
- --stringparam name value
Pass a paramenter of name name and - value value where - value is a string rather than a node + --stringparam name value
Pass a paramenter of name name and + value value where + value is a string rather than a node identifier. (Note: The string must be utf-8.)
- --nonet
Do not use the Internet to fetch DTD's or - entities. -
- --catalogs
Use the SGML catalog specified in - SGML_CATALOG_FILES to resolve the location of - external entities. By default, xsltproc + --nonet
Do not use the Internet to fetch DTD's, + entities or documents. +
--path paths
+ Use the list (separated by space or column) of filesystem paths + specified by paths to load + DTDs, entities or documents. +
--load-trace
+ Display to stderr all the documents loaded during the processing. +
+ --catalogs
Use the SGML catalog specified in + SGML_CATALOG_FILES to resolve the location of + external entities. By default, xsltproc looks for the catalog specified in - XML_CATALOG_FILES. If that is not specified, it uses - /etc/xml/catalog. + XML_CATALOG_FILES. If that is not specified, it uses + /etc/xml/catalog.
- --xinclude
Process the input document using the + --xinclude
Process the input document using the Xinclude specification. More details on this can be found in the Xinclude specification: http://www.w3.org/TR/xinclude/
- --profile or --norman
Output profiling + --profile or --norman
Output profiling information detailing the amount of time spent in each part of the stylesheet. This is useful in optimizing stylesheet performance.
- --dumpextensions
Dumps the list of all registered extensions on stdout. + --dumpextensions
Dumps the list of all registered extensions on stdout. +
+ --nowrite
Refuses to write to any file or resource.
- --nowrite
Refuses to write to any file or resource. + --nomkdir
Refuses to create directories.
- --nomkdir
Refuses to create directories. + --writesubtree path
Allow file write only within the + path subtree.
- --writesubtree path
Allow file write only within the - path subtree. -

Return values

xsltproc's return codes provide information - that can be used when calling it from scripts.

0: normal

1: no argument

2: too many parameters

3: unknown option

4: failed to parse the stylesheet

5: error in the stylesheet

6: error in one of the documents

7: unsupported xsl:output method

8: string parameter contains both quote and double-quotes

9: internal processing error

10: processing was stopped by a terminating message

More Information

libxml web page: http://www.xmlsoft.org/

W3C XSLT page: http://www.w3.org/TR/xslt

+ --nodtdattr +
Do not apply default attributes from the document's + DTD. +

Return values

xsltproc's return codes provide information + that can be used when calling it from scripts.

0: normal

1: no argument

2: too many parameters

3: unknown option

4: failed to parse the stylesheet

5: error in the stylesheet

6: error in one of the documents

7: unsupported xsl:output method

8: string parameter contains both quote and double-quotes

9: internal processing error

10: processing was stopped by a terminating message

More Information

libxml web page: http://www.xmlsoft.org/

W3C XSLT page: http://www.w3.org/TR/xslt

diff --git a/doc/xsltproc.xml b/doc/xsltproc.xml index a24d217..f759506 100644 --- a/doc/xsltproc.xml +++ b/doc/xsltproc.xml @@ -56,6 +56,7 @@ --nowrite --nomkdir --writesubtree + --nodtdattr file1 @@ -340,7 +341,16 @@ - + + + + + + Do not apply default attributes from the document's + DTD. + + + -- 2.7.4