ilene 2003/06/07 14:12:16
Modified: java/xdocs/sources/xalan samples.xml trax.xml getstarted.xml
usagepatterns.xml faq.xml index.xml history.xml
Log:
Documentation update: Replaced all occurrences of TRaX with the properly
capitalized TrAX.
Revision Changes Path
1.56 +1 -1 xml-xalan/java/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.55
retrieving revision 1.56
diff -u -r1.55 -r1.56
--- samples.xml 10 Apr 2003 14:34:58 -0000 1.55
+++ samples.xml 7 Jun 2003 21:12:15 -0000 1.56
@@ -562,7 +562,7 @@
</s2>
<anchor name="trax"/>
<s2 title="trax">
- <p>What it does: run a number of samples illustrating uses of the <link
idref="trax">TRaX (Transformation API for XML)</link> interfaces.</p>
+ <p>What it does: run a number of samples illustrating uses of the <link
idref="trax">TrAX (Transformation API for XML)</link> interfaces.</p>
<p>Run this sample from the trax subdirectory with</p>
<p><code>java Examples</code></p>
<p>and examine the source in Examples.java and
ExampleContentHandler.java.</p>
1.5 +3 -3 xml-xalan/java/xdocs/sources/xalan/trax.xml
Index: trax.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/trax.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- trax.xml 27 Jan 2003 18:45:36 -0000 1.4
+++ trax.xml 7 Jun 2003 21:12:15 -0000 1.5
@@ -253,7 +253,7 @@
<p>The section defines the abstract model for TrAX, apart from the details
of the interfaces.</p>
-<p>A TRaX <link
anchor="pattern-TransformerFactory">TransformerFactory</link> is an object
+<p>A TrAX <link
anchor="pattern-TransformerFactory">TransformerFactory</link> is an object
that processes transformation instructions, and produces
<link anchor="pattern-Templates">Templates</link> (in the technical
terminology). A <link anchor="pattern-Templates">Templates</link>
@@ -261,7 +261,7 @@
more <link anchor="pattern-Source">Source</link>s into one or more
<link anchor="pattern-Result">Result</link>s.</p>
-<p>To use the TRaX interface, you create a
+<p>To use the TrAX interface, you create a
<link anchor="pattern-TransformerFactory">TransformerFactory</link>,
which may directly provide a <link
anchor="pattern-Transformer">Transformers</link>, or which can provide
<link anchor="pattern-Templates">Templates</link> from a variety of
@@ -279,7 +279,7 @@
<ref>serialization</ref>. We believe this is the most suitable term for
this process, despite the overlap with Java object serialization.</p>
</s2><anchor name="patterns"/>
-<s2 title="TRaX Patterns">
+<s2 title="TrAX Patterns">
<p>The intent, responsibilities, and thread safety of TrAX objects:</p>
<ul>
<li><link anchor="pattern-Processor">Processor</link></li>
1.28 +1 -1 xml-xalan/java/xdocs/sources/xalan/getstarted.xml
Index: getstarted.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/getstarted.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- getstarted.xml 21 Feb 2003 20:10:07 -0000 1.27
+++ getstarted.xml 7 Jun 2003 21:12:15 -0000 1.28
@@ -129,7 +129,7 @@
<s2 title="Setting up your own Java applications">
<p>You can start by using your own XML source files and XSL stylesheets
with the sample applications,
which illustrate a number of the <link idref="usagepatterns">basic
usage patterns</link>.</p>
- <p>Here is the basic TRaX procedure to keep in mind when you set up a
transformation:</p>
+ <p>Here is the basic TrAX procedure to keep in mind when you set up a
transformation:</p>
<ol>
<li>Use the <jump
href="apidocs/javax/xml/transform/TransformerFactory.html">TransformerFactory</jump>
static newInstance() method to instantiate a TransformerFactory.<br/><br/></li>
<li>Use the TransformerFactory newTransformer(Source stylesheet) method
to process the
1.57 +1 -1 xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml
Index: usagepatterns.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -r1.56 -r1.57
--- usagepatterns.xml 7 May 2003 14:00:29 -0000 1.56
+++ usagepatterns.xml 7 Jun 2003 21:12:15 -0000 1.57
@@ -277,7 +277,7 @@
</ol>
</s2><anchor name="serialize"/>
<s2 title="Serializing output">
-<p>In some cases, you may want to "transform" a DOM tree into a stream,
which the XML community calls serialization. <link idref="trax">TRaX
(Transformation API for XML)</link> and the &xslt4j; Transformer implementation
provide direct support for this operation. Simply use the TransformerFactory
newTransformer() method (no arguments) to create a Transformer that you can use
to "copy" a DOMSource to a StreamResult. For examples, see
Examples.exampleDOM2DOM(), Examples.exampleSerializeNode(), and
Examples.exampleAsSerializer() in the <link idref="samples" anchor="trax">trax
sample</link>.</p>
+<p>In some cases, you may want to "transform" a DOM tree into a stream,
which the XML community calls serialization. <link idref="trax">TrAX
(Transformation API for XML)</link> and the &xslt4j; Transformer implementation
provide direct support for this operation. Simply use the TransformerFactory
newTransformer() method (no arguments) to create a Transformer that you can use
to "copy" a DOMSource to a StreamResult. For examples, see
Examples.exampleDOM2DOM(), Examples.exampleSerializeNode(), and
Examples.exampleAsSerializer() in the <link idref="samples" anchor="trax">trax
sample</link>.</p>
</s2><anchor name="params"/>
<s2 title="Setting stylesheet parameters">
<p>An XSLT stylesheet may include parameters that are set at run time each
time a transformation is performed. To set a stylesheet parameter, use the
Transformer
1.36 +1 -1 xml-xalan/java/xdocs/sources/xalan/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/faq.xml,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- faq.xml 7 Jun 2003 21:01:26 -0000 1.35
+++ faq.xml 7 Jun 2003 21:12:15 -0000 1.36
@@ -93,7 +93,7 @@
that API (javax.xml.transform....), and includes xercesImpl.jar
from
<resource-ref idref='xml4j-used' />, which implements the parser
portion of the API
(javax.xml.parser....).</p>
- <p>For more information, see <link idref='trax'>TRaX (Transformation
API for XML)</link> and
+ <p>For more information, see <link idref='trax'>TrAX (Transformation
API for XML)</link> and
<resource-ref idref='jaxp12' />.
</p>
</a>
1.54 +2 -2 xml-xalan/java/xdocs/sources/xalan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/index.xml,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -r1.53 -r1.54
--- index.xml 10 Apr 2003 14:34:58 -0000 1.53
+++ index.xml 7 Jun 2003 21:12:15 -0000 1.54
@@ -74,8 +74,8 @@
<resource-ref idref="xpath"/>. It can be used from the command line,
in an applet or a
servlet, or as a module in other program.</p>
<p>&xslt4j; recasts &xslt; as an implementation of the <link
idref="trax">
- Transformation API for XML (TRaX)</link> interfaces, part of the
<resource-ref idref="jaxp12"/>.
- TRaX provides a modular framework and a standard API for performing
XML transformations, and
+ Transformation API for XML (TrAX)</link> interfaces, part of the
<resource-ref idref="jaxp12"/>.
+ TrAX provides a modular framework and a standard API for performing
XML transformations, and
it utilizes system properties to determine which Transformer and
which XML parser to use.</p>
<p>&xslt4j; also builds on <resource-ref idref="sax2"/> and
<resource-ref idref="dom2"/>.</p>
1.38 +1 -1 xml-xalan/java/xdocs/sources/xalan/history.xml
Index: history.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/history.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- history.xml 30 May 2003 14:17:37 -0000 1.37
+++ history.xml 7 Jun 2003 21:12:15 -0000 1.38
@@ -3791,7 +3791,7 @@
<s2 title="Changes for &xslt4j; version 2.0.D05">
<p>All of the bugs reported in &xslt4j; 2.0.D01 have been fixed. The
remainder of this section discusses two changes that we believe are of
particular importance:</p>
<p><em>TrAX</em></p>
-<p>The Transformation API for XML (TrAX) that &xslt4j2; implements has
undergone substantial revisions since the release of &xslt4j; 2.0.D01. TrAX has
joined the Java API for XML Parsing (JAXP) as part of the Sun®
<resource-ref idref="jsr063"/>. Accordingly, the TrAX package names have
changed. The conceptual organization has also changed somewhat: The primary
transformation interfaces are defined in javax.xml.transform, with concrete
classes for managing stream input/output, SAX parsers and ContentHandler, and
DOM parsers and DOM trees in javax.xml.transform.stream,
javax.xml.transform.sax, and javax.xml.transform.dom. For more information, see
<link idref="trax">TRaX (Transformation API for XML)</link>, and review <link
idref="usagepatterns">Usage Patterns</link>.</p>
+<p>The Transformation API for XML (TrAX) that &xslt4j2; implements has
undergone substantial revisions since the release of &xslt4j; 2.0.D01. TrAX has
joined the Java API for XML Parsing (JAXP) as part of the Sun®
<resource-ref idref="jsr063"/>. Accordingly, the TrAX package names have
changed. The conceptual organization has also changed somewhat: The primary
transformation interfaces are defined in javax.xml.transform, with concrete
classes for managing stream input/output, SAX parsers and ContentHandler, and
DOM parsers and DOM trees in javax.xml.transform.stream,
javax.xml.transform.sax, and javax.xml.transform.dom. For more information, see
<link idref="trax">TrAX (Transformation API for XML)</link>, and review <link
idref="usagepatterns">Usage Patterns</link>.</p>
<anchor name="outputprops"/><p><em>Output properties</em></p>
<p>The handling of xsl:output properties has changed:
org.apache.xalan.serialize.OutputFormat and
apache.xalan.templates.OutputFormatExtended were removed and replaced with
org.apache.xalan.templates.OutputProperties. The SerializerFactory
getSerializer() method now takes Properties rather than a String indicating the
output method. You can replace <code>getSerializer("xml")</code>, for example,
with
<code>getSerializer(OutputProperties.getDefaultMethodProperties("xml"))</code>.</p>
<p>HTML, XML, and text xsl:output properties are specified in property files
in org.apache.xalan.templates: output_html.properties, output_xml.properties,
and output_text.properties.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
