dleslie 01/07/17 07:28:30
Modified: java/xdocs/sources/xalan history.xml index.xml overview.xml
resources.xml samples.xml whatsnew.xml
Log:
replace resource-refs to TrAX with standard links, now that trax.xml
is in xdocs/sources/xalan.
Revision Changes Path
1.12 +2 -3 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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- history.xml 2001/07/11 20:43:57 1.11
+++ history.xml 2001/07/17 14:28:22 1.12
@@ -22,13 +22,12 @@
</s3>
<anchor name="dtm"/>
<s3 title="Changes for &xslt4j; 2.2.D2">
- <p>This release includes the following non-XSLTC changes:</p>
+ <p>This release includes the following changes:</p>
<ul>
<li>Deprecation of the <link idref="usagepatterns"
anchor="compat">Xalan-Java 1 compatiblity API</link></li>
<li>The DTM</li>
<li>Other optimization work</li>
</ul>
- <anchor name="dtm"/>
<p>The primary focus of the 2.2 Developer releases is incorporation of all our
work over the past several months on the Document Table
Model (<link idref="dtm">DTM</link>).</p>
@@ -705,7 +704,7 @@
<s3 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 <resource-ref idref="trax"/>, 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>
1.29 +1 -1 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.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- index.xml 2001/07/11 19:29:54 1.28
+++ index.xml 2001/07/17 14:28:22 1.29
@@ -63,7 +63,7 @@
in an applet or a servlet, or as a module in other program.</p>
</s2>
<s2 title="I've heard of &xslt4j;, but what is version 2?">
- <p>&xslt4j; version 2 recasts Xalan as an implementation of the <resource-ref
idref="trax"/> interfaces, part of the <resource-ref idref="jaxp11"/>. TRaX provides a
+ <p>&xslt4j; version 2 recasts Xalan as an implementation of the <link
idref="trax">TRaX (Transformation API for XML)</link> interfaces, part of the
<resource-ref idref="jaxp11"/>. 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; version 2 also builds on <resource-ref idref="sax2"/>,
<resource-ref idref="dom2"/>, and the XML parser API in
<resource-ref idref="jaxp"/>.</p>
1.13 +2 -2 xml-xalan/java/xdocs/sources/xalan/overview.xml
Index: overview.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/overview.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- overview.xml 2001/02/20 17:08:24 1.12
+++ overview.xml 2001/07/17 14:28:23 1.13
@@ -73,7 +73,7 @@
discussion groups, frequently asked questions, and tutorials on XSLT, see <link
anchor="uptospeed">Getting up
to speed with XSLT</link>.</p>
<note>XSL also includes a vocabulary for formatting documents, which is not
part of &xslt4j;.
- For more information, see <resource-ref idref="xsl"/> and the <jump
+ For more information, see <resource-ref idref="xslt"/> and the <jump
href="http://xml.apache.org/fop";>Apache XML FOP (Formatting Objects
Project)</jump>.</note>
<p>You use the XSLT language to compose XSL stylesheets. An XSL stylesheet
contains instructions for
transforming XML documents from one document type into another document type
(XML, HTML, or other). In structural
@@ -100,7 +100,7 @@
<s2 title="&xslt4j; Features">
<ul>
<li>Implements the relevant W3C specifications: <resource-ref
idref="xslt"/> and <resource-ref idref="xpath"/>.<br/><br/></li>
- <li>Implements <resource-ref idref="trax"/>, now part of <resource-ref
idref="jaxp"/>, and builds on
+ <li>Implements <link idref="trax">TRaX (Transformation API for XML)</link>,
now part of <resource-ref idref="jaxp"/>, and builds on
<resource-ref idref="sax2"/> and <resource-ref
idref="dom2"/>.<br/><br/></li>
<li>May be configured to work with any XML parser, such
<jump href="http://xml.apache.org/xerces-j/index.html";>&xml4j;</jump>, that
implements <resource-ref
1.17 +0 -3 xml-xalan/java/xdocs/sources/xalan/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/resources.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- resources.xml 2001/06/12 18:28:00 1.16
+++ resources.xml 2001/07/17 14:28:23 1.17
@@ -86,9 +86,6 @@
<resource id="jsr063"
title="Java Specification Request 63"
location="http://java.sun.com/aboutJava/communityprocess/review/jsr063"/>
- <resource id="trax"
- title="TRaX (Transformation API for XML)"
- location="trax.html"/>
<resource id="compatapi"
title="Xalan-Java 1 compatibility Javadoc"
1.34 +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.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- samples.xml 2001/07/12 16:03:14 1.33
+++ samples.xml 2001/07/17 14:28:24 1.34
@@ -459,7 +459,7 @@
Interface</link></p>
</s2><anchor name="trax"/>
<s2 title="trax">
- <p>What it does: run a number of samples illustrating uses of the
<resource-ref idref="trax"/> 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.25 +1 -1 xml-xalan/java/xdocs/sources/xalan/whatsnew.xml
Index: whatsnew.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/whatsnew.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- whatsnew.xml 2001/07/11 19:30:04 1.24
+++ whatsnew.xml 2001/07/17 14:28:25 1.25
@@ -65,7 +65,7 @@
<p>&xslt4j2; represents a fundamental redesign of Xalan. The primary objective of
this redesign is an easier-to-use, more understandable, and more modular API that
encourages wider participation in its ongoing development by the open-source XML
developer community, and that lends itself to "streaming," the production of
transformation output while the input is still being parsed.</p>
<p>&xslt4j2; builds on <resource-ref idref="sax2"/>, <resource-ref idref="dom2"/>,
and the <resource-ref idref="jaxp"/>. For example, &xslt4j2; incorporates the SAX
parsing event model in its support for the incremental production of transformation
output. &xslt4j2; also implements the standard TrAX API (see below) that enables you
to code your XML applications without reference to the internal details of a
particular Transformer or XML parser.</p>
<p>Given the scope of the redesign, the changes with respect to <jump
href="http://xml.apache.org/xalan/index.html";>&xslt4j; 1.x</jump> are global in
nature. For an introduction to the &xslt4j2; usage patterns, see <link
idref="usagepatterns">Basic Usage Patterns</link>.</p>
-<p>&xslt4j2; implements the <resource-ref idref="trax"/> interfaces. The product of
extensive open-source collaboration by members of the XML developer community, TrAX
provides a conceptual framework and a standard API for performing XML transformations.
During its evolution, the TrAX API has undergone several revisions. We believe this
API has now reached or is very close to final form. In November 2000, TrAX was
incorporated into <resource-ref idref="jsr063"/>, the Java API for XML Processing 1.1
, which has been published for public review (see <resource-ref idref="jaxp11"/>). We
strongly encourage you to utilize the TrAX framework when you use &xslt4j2; to perform
XML transformations.</p>
+<p>&xslt4j2; implements the <link idref="trax">TRaX (Transformation API for
XML)</link> interfaces. The product of extensive open-source collaboration by members
of the XML developer community, TrAX provides a conceptual framework and a standard
API for performing XML transformations. During its evolution, the TrAX API has
undergone several revisions. We believe this API has now reached or is very close to
final form. In November 2000, TrAX was incorporated into <resource-ref
idref="jsr063"/>, the Java API for XML Processing 1.1 , which has been published for
public review (see <resource-ref idref="jaxp11"/>). We strongly encourage you to
utilize the TrAX framework when you use &xslt4j2; to perform XML transformations.</p>
<p>The basic organization of TrAX is quite simple: use a TransformerFactory to
process transformation instructions and generate a Transformer, with which you can
apply the processed transformation instructions to your XML Source, producing a
transformation Result. For more detail, see <link idref="usagepatterns"
anchor="basic">Basic steps</link>.</p>
<p>As part of the Java API for XML Processing, TraX provides a stable framework for
plugging Transformers (like &xslt4j;) and XML parsers (like &xml4j;) into your
applications without tying yourself to the internal details of those implementations.
See <link idref="usagepatterns" anchor="plug">Plugging in a Transformer and XML
parser</link>.</p>
</s2><anchor name="dtm"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
