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]
