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]
