dleslie 02/01/31 07:55:22
Modified: java/xdocs/sources/xalan commandline.xml dtm.xml
extensionslib.xml features.xml
Log:
Updates per Joe Kesselman's 'source_location' revisions.
Revision Changes Path
1.20 +2 -2 xml-xalan/java/xdocs/sources/xalan/commandline.xml
Index: commandline.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/commandline.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- commandline.xml 30 Jan 2002 22:23:12 -0000 1.19
+++ commandline.xml 31 Jan 2002 15:55:22 -0000 1.20
@@ -106,7 +106,7 @@
false)
-RL recursionLimit (Set numeric limit on depht of stylesheet
recursion)
--L (Turn on source-location attribute)
+-L (Turn on source_location attribute)
</source>
<p>Use <code>-IN</code> to specify the XML source document.</p>
<p>Use <code>-XSL</code> to specify the XSL stylesheet file.</p>
@@ -120,7 +120,7 @@
<p>For information about incremental and optimized stylesheet processing, see
<link idref="dtm" anchor="settings">DTM settings</link>.</p>
<p>Use <code>-L</code> to obtain access to a SourceLocator that a stylesheet
extension can use to get information about the location
of nodes in the source document. For more information, see <link
idref="extensionslib" anchor="nodeinfo">NodeInfo extension functions</link>
- and <link idref="features"
anchor="source-location">source-location</link>.</p>
+ and <link idref="features"
anchor="source_location">source_location</link>.</p>
<p>Use <code>-URIRESOLVER</code> with a fully qualified class name to utilize
a custom implementation of the
<jump href="apidocs/javax/xml/transform/URIResolver.html">URIResolver</jump>
TrAX interface to resolve URIs for
xsl:include, xsl:import, and the document() function.</p>
1.3 +62 -6 xml-xalan/java/xdocs/sources/xalan/dtm.xml
Index: dtm.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/dtm.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- dtm.xml 15 Jun 2001 16:50:50 -0000 1.2
+++ dtm.xml 31 Jan 2002 15:55:22 -0000 1.3
@@ -1,7 +1,61 @@
<?xml version="1.0" standalone="no"?>
-
<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
-
+<!--
+ * The Apache Software License, Version 1.1
+ *
+ *
+ * Copyright (c) 1999 The Apache Software Foundation. All rights
+ * reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * 3. The end-user documentation included with the redistribution,
+ * if any, must include the following acknowledgment:
+ * "This product includes software developed by the
+ * Apache Software Foundation (http://www.apache.org/)."
+ * Alternately, this acknowledgment may appear in the software itself,
+ * if and wherever such third-party acknowledgments normally appear.
+ *
+ * 4. The names "Xalan" and "Apache Software Foundation" must
+ * not be used to endorse or promote products derived from this
+ * software without prior written permission. For written
+ * permission, please contact [EMAIL PROTECTED]
+ *
+ * 5. Products derived from this software may not be called "Apache",
+ * nor may "Apache" appear in their name, without prior written
+ * permission of the Apache Software Foundation.
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation and was
+ * originally based on software copyright (c) 1999, Lotus
+ * Development Corporation., http://www.lotus.com. For more
+ * information on the Apache Software Foundation, please see
+ * <http://www.apache.org/>.
+ -->
<s1 title="&xslt4j; DTM">
<ul>
<li><link anchor="intro">Introduction</link></li>
@@ -49,11 +103,13 @@
<td>"http://xml.apache.org/xalan/features/optimize";</td>
<td>true</td>
<td><link anchor="optimized">optimized transforms</link></td>
- </tr>
+ </tr>
</table>
<p>Both of these DTM settings are described below.</p>
+ <note>The DTM also provides a setting that you can use to track location
information for each node in the source document. See
+ <link idref="features"
anchor="source_location">"http://apache.org/xalan/features/source_location";</link></note>
<anchor name="incremental"/>
- <s3 title="http://xml.apache.org/xalan/features/incremental";>
+ <s3 title="'http://xml.apache.org/xalan/features/incremental'">
<p>Set this feature to true to enable incremental transformations. If set to
false (the default), the transform and the parse
are performed on the same thread.</p>
<note> When set to true: If the parser is Xerces, we perform an
@@ -71,9 +127,9 @@
java.lang.Boolean.TRUE);
...</source>
</s3><anchor name="optimized"/>
- <s3 title="http://xml.apache.org/xalan/features/optimize";>
+ <s3 title="'http://xml.apache.org/xalan/features/optimize'">
<p>When set to true (the default), this feature enables optimizations that may
involve structural rewrites of the stylesheet.
Any tool that requires direct access to the stylesheet structure should set this
feature to false.</p>
-</s3>
+ </s3>
</s2>
</s1>
1.22 +8 -6 xml-xalan/java/xdocs/sources/xalan/extensionslib.xml
Index: extensionslib.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/extensionslib.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- extensionslib.xml 30 Jan 2002 22:23:12 -0000 1.21
+++ extensionslib.xml 31 Jan 2002 15:55:22 -0000 1.22
@@ -200,7 +200,7 @@
</s2><anchor name="intersection"/>
<s2 title="intersection">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/Extensions.html">org.apache.xalan.lib.Extensions</jump>,<br/>
-<code>intersection (node-set1, node-set2)</code> function returns a node-set with
all nodes that are in ns1 and in ns2 .</p>
+<code>intersection (node-set1, node-set2)</code> function returns a node-set with
all nodes that are in ns1 and in ns2 .</p>
</s2><anchor name="difference"/>
<s2 title= "difference">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/Extensions.html">org.apache.xalan.lib.Extensions</jump>,<br/>
@@ -220,12 +220,12 @@
use to get information about the location of nodes in the source document:</p>
<ul>
<li><link anchor="systemid">systemId</link></li>
-<li><link anchor="publicid">publicId</link></li>
+<li><link anchor="publicid">publicId</link> (to be done)</li>
<li><link anchor="linenumber">lineNumber</link></li>
<li><link anchor="columnnumber">columnNumber</link></li>
</ul>
<note>If you want to use the NodeInfo extension elements, you MUST set the
TransformerFactory
-<link idref="features" anchor="source-location">source-location</link> attribute to
Boolean.TRUE.
+<link idref="features" anchor="source_location">source_location</link> attribute to
true.
You can use the <link idref="commandline">command-line utility</link> -L flag or
the <jump
href="apidocs/javax/xml/transform/TransformerFactory.html#setAttribute(java.lang.String,
java.lang.Object)">TransformerFactory.setAttribute()</jump>
method to set this attribute.</note>
<anchor name="systemid"/>
@@ -235,19 +235,21 @@
<code>systemId(node-set)</code> returns the system ID of the first node in the
node-set.</p>
</s3><anchor name="publicid"/>
<s3 title="publicId">
-<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
-<code>publicId()</code> returns the public ID for the current node, and<br/>
-<code>publicId(node-set)</code> returns the public ID of the first node in the
node-set.</p>
+<p><em>To be done.</em> Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
+<code>publicId()</code> will return the public ID for the current node, and<br/>
+<code>publicId(node-set)</code> will return the public ID of the first node in the
node-set.</p>
</s3><anchor name="linenumber"/>
<s3 title="lineNumber">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
<code>lineNumber()</code> returns the line number in the source document for the
current node, and<br/>
<code>lineNumber(node-set)</code> returns the line number in the source document
for the first node in the node-set.</p>
+<note>This function returns -1 if the line number is not known (for example, the
source is a DOM Document).</note>
</s3><anchor name="columnnumber"/>
<s3 title="columnNumber">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
<code>columnNumber()</code> returns the column number in the source document for
the current node, and<br/>
<code>columnNumber(node-set)</code> returns the column number in the source
document for the first node in the node-set.</p>
+<note>This function returns -1 if the column number is not known (for example, the
source is a DOM Document).</note>
</s3></s2><anchor name="sql"/>
<s2 title= "SQL library">
<note>For UML Diagrams of the SQL Library, see <jump
href="http://xml.apache.org/xalan-j/Xalan-SQL-Extension/DiagramIndex.html";>SQL Library
UML Diagrams</jump>.</note>
1.3 +86 -20 xml-xalan/java/xdocs/sources/xalan/features.xml
Index: features.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/features.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- features.xml 30 Jan 2002 22:23:12 -0000 1.2
+++ features.xml 31 Jan 2002 15:55:22 -0000 1.3
@@ -1,5 +1,61 @@
<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
+<!--
+ * The Apache Software License, Version 1.1
+ *
+ *
+ * Copyright (c) 1999 The Apache Software Foundation. All rights
+ * reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * 3. The end-user documentation included with the redistribution,
+ * if any, must include the following acknowledgment:
+ * "This product includes software developed by the
+ * Apache Software Foundation (http://www.apache.org/)."
+ * Alternately, this acknowledgment may appear in the software itself,
+ * if and wherever such third-party acknowledgments normally appear.
+ *
+ * 4. The names "Xalan" and "Apache Software Foundation" must
+ * not be used to endorse or promote products derived from this
+ * software without prior written permission. For written
+ * permission, please contact [EMAIL PROTECTED]
+ *
+ * 5. Products derived from this software may not be called "Apache",
+ * nor may "Apache" appear in their name, without prior written
+ * permission of the Apache Software Foundation.
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation and was
+ * originally based on software copyright (c) 1999, Lotus
+ * Development Corporation., http://www.lotus.com. For more
+ * information on the Apache Software Foundation, please see
+ * <http://www.apache.org/>.
+ -->
<s1 title="Transform Features">
<p>Transform features are identified by URI Strings and fall into the following
categories:</p>
<ul>
@@ -103,10 +159,10 @@
<p>For a example that uses this feature, see <link idref="samples"
anchor="sax2sax">SAX2SAX</link>.</p>
</s3><anchor name="saxtransformerfactory"/>
<s3 title='"http://javax.xml.transform.sax.SAXTransformerFactory/feature";'>
-<p>The implementation provides a <jump
href="apidocs/javax/xml/transform/sax/SAXTransformerFactory.html">SAXTransformerFactory</jump>.
You may safely cast
-the TransformerFactory returned by TransformerFactory.newInstance() to a
SAXTransformerFactory.</p>
-<p>To determine whether your implementation supports this feature (&xslt4j; does),
you can use the static SAXTransformerFactory.FEATURE variable
-(equivalent to the URI String above) as follows:</p>
+<p>The implementation provides a <jump
href="apidocs/javax/xml/transform/sax/SAXTransformerFactory.html">SAXTransformerFactory</jump>.
+You may safely cast the TransformerFactory returned by
TransformerFactory.newInstance() to a SAXTransformerFactory.</p>
+<p>To determine whether your implementation supports this feature (&xslt4j; does),
you can use the static SAXTransformerFactory.FEATURE
+variable (equivalent to the URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import javax.xml.sax.SAXTransformerFactory;
..
@@ -118,9 +174,11 @@
<p>For a example that uses this feature, see <link idref="samples"
anchor="sax2sax">SAX2SAX</link>.</p>
</s3><anchor name="xmlfilter"/>
<s3
title='"http://javax.xml.transform.sax.SAXTransformerFactory/feature/xmlfilter";'>
-<p>The implementation supports the use of <jump
href="apidocs/org/xml/sax/XMLFilter.html">XMLFilter</jump> to use the output of one
transformation as input for another transformation. The SAXTransformerFactory
newXMLFilter(Source) and newXMLFilter(Templates) methods
+<p>The implementation supports the use of <jump
href="apidocs/org/xml/sax/XMLFilter.html">XMLFilter</jump> to use the output of one
+transformation as input for another transformation. The SAXTransformerFactory
newXMLFilter(Source) and newXMLFilter(Templates) methods
are supported.</p>
-<p>To determine whether your implementation supports this feature (&xslt4j; does),
you can use the static SAXTransformerFactory.FEATURE_XMLFilter variable (equivalent to
the URI String above) as follows:</p>
+<p>To determine whether your implementation supports this feature (&xslt4j; does),
you can use the static
+SAXTransformerFactory.FEATURE_XMLFilter variable (equivalent to the URI String
above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import javax.xml.sax.SAXTransformerFactory;
..
@@ -138,13 +196,17 @@
<ul>
<li><link anchor="optimize">"http://apache.org/xalan/features/optimize";</link></li>
<li><link
anchor="incremental">"http://apache.org/xalan/features/incremental";</link></li>
-<li><link
anchor="source-location">"http://apache.org/xalan/features/source-location";</link></li>
+<li><link
anchor="source_location">"http://apache.org/xalan/features/source_location";</link></li>
</ul>
<p>To get an attribute setting, use the TransformerFactory.getAttribute(String)
method, which returns an Object. For these three &xslt4j;
-attributes, you can cast the return value to a boolean. To set an attribute, use
the TransformerFactory.setAttribute(String, Object) method. For the String argument,
provide the static String variable or literal URI String as detailed below. For the
Object argument, use Boolean.TRUE or Boolean.FALSE.</p><anchor name="optimize"/>
+attributes, you can cast the return value to a boolean. To set an attribute, use
the TransformerFactory.setAttribute(String, Object) method.
+For the String argument, provide the static String variable or literal URI String
as detailed below. For the Object argument, use
+Boolean.TRUE or Boolean.FALSE.</p><anchor name="optimize"/>
<s3 title='"http://apache.org/xalan/features/optimize";'>
-<p>Optimize stylesheet processing. By default, this attribute is on. You may need
to turn it off for tooling applications. For more information, see <link idref="dtm"
anchor="optimize">optimize</link>.</p>
-<p>To turn optimization off, you can use the
TransformerFactoryImpl.FEATURE_OPTIMIZE static variable (equivalent to the URI String
above) as follows:</p>
+<p>Optimize stylesheet processing. By default, this attribute is set to true. You
may need to set it to false for tooling applications.
+For more information, see <link idref="dtm" anchor="optimize">optimize</link>.</p>
+<p>To turn optimization off, you can use the
TransformerFactoryImpl.FEATURE_OPTIMIZE static variable (equivalent to the URI String
above)
+as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import org.apache.xalan.processor.TransformerFactoryImpl;
..
@@ -155,7 +217,9 @@
}</source>
</s3><anchor name="incremental"/>
<s3 title='"http://apache.org/xalan/features/incremental";'>
-<p>Produce output incrementally, rather than waiting to finish parsing the input
before generating any output. By default this attribute is off. You can turn this
attribute on to transform large documents where the stylesheet structure is optimized
to execute individual templates without having to parse scattered sections of the
document. For more information, see <link idref="dtm"
anchor="incremental">incremental</link>.</p>
+<p>Produce output incrementally, rather than waiting to finish parsing the input
before generating any output. By default this attribute is set
+to false. You can turn this attribute on to transform large documents where the
stylesheet structure is optimized to execute individual templates
+without having to parse the entire document. For more information, see <link
idref="dtm" anchor="incremental">incremental</link>.</p>
<p>To turn incremental transformations on, you can use the
TransformerFactoryImpl.FEATURE_INCREMENTAL static variable (equivalent to the URI
String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import org.apache.xalan.processor.TransformerFactoryImpl;
@@ -165,15 +229,17 @@
tFact.setAttribute(TransformerFactoryImpl.FEATURE_INCREMENTAL,
Boolean.FALSE);
}</source>
-</s3><anchor name="source-location"/>
-<s3 title='"http://apache.org/xalan/features/source-location";'>
-<p>Provide a <jump
href="apidocs/javax/xml/transform/SourceLocator.html">SourceLocator</jump> that can be
used from within a stylesheet,
-programatically, or in the command-line utility to obtain the location in a source
document (system ID, public ID, line number, and column number)
-of individual nodes.</p>
-<p>By default, this attribute is off. The <link idref="commandline">command-line
utility</link> -L flag sets this attribute to Boolean.TRUE.
-You must set this attribute to Boolean.TRUE if you want to use the <link
idref="extensionslib" anchor="nodeinfo">NodeInfo</link> extension
-functions.</p>
-<p>To set the source-location attribute, you can use the
TransformerFactoryImpl.FEATURE_SOURCE_LOCATION static variable (equivalent to the URI
String above) as follows:</p>
+</s3><anchor name="source_location"/>
+<s3 title='"http://apache.org/xalan/features/source_location";'>
+<p>Provide a <jump
href="apidocs/javax/xml/transform/SourceLocator.html">SourceLocator</jump> that can be
used during a transformation
+to obtain the location of individual nodes in a source document (system ID, line
number, and column number).</p>
+<p>By default, this attribute is set to false. Setting this attribute to true
involves a substantial increase in storage cost per source
+document node. If you want to use the <link idref="extensionslib"
anchor="nodeinfo">NodeInfo</link> extension functions (or some other mechanism)
+to provide this information during a transform, you must set the attribute to true
before generating the Transformer and processing the
+stylesheet.</p>
+<p>The <link idref="commandline">command-line utility</link> -L flag sets this
attribute to true. To set the source_location attribute
+programmatically, you can use the TransformerFactoryImpl.FEATURE_SOURCE_LOCATION
static variable (equivalent to the URI String above)
+as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import org.apache.xalan.transformer.TransformerImpl;
import org.apache.xalan.transformer.XalanProperties;
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
