dleslie 00/12/07 14:12:01
Modified: java/xdocs/sources/xalan DONE readme.xml resources.xml
samples.xml whatsnew.xml
Log:
Updates for Xalan-J 2.0.D02.
Revision Changes Path
1.4 +24 -1 xml-xalan/java/xdocs/sources/xalan/DONE
Index: DONE
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/DONE,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- DONE 2000/12/07 17:05:56 1.3
+++ DONE 2000/12/07 22:11:57 1.4
@@ -1,9 +1,32 @@
<s3 title="Changes since &xslt4j; version 2.0.D01">
+<p>For a list of completed to-do tasks, see <jump
href="todo.html#release-date-completed">Tasks completed</jump>. The remainder
of this
+section discusses two changes that are especially visible:</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><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>
<p>You can start using the output proprties defined in these files in your
stylesheets. For example, you can turn URL escaping off in HTML output, by
setting use-url-escaping=no, and you can set indent-amount to control
indenting.</p>
-<p>Character-to-entity mapping is specified in org.apache.xalan.serialize:
HTMLEntities.res and XMLEntities.res. We need to do some more work in this area
before such .res files will really be usable.</p>
+<p>Character-to-entity mapping is specified in org.apache.xalan.serialize:
HTMLEntities.res and XMLEntities.res. You can override entity ref
+mapping from a stylesheet. For example:</p>
+<source><?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
+ xmlns:xalan="http://xml.apache.org/xslt"; version="1.0">
+
+ <xsl:output xalan:entities="myentities.ent"/>
+
+ <xsl:template match="/">
+ <out>&#125;</out>
+ </xsl:template>
+
+</xsl:stylesheet></source>
+<p>=== myentities.ent ===</p>
+<source>quot 34
+amp 38
+lt 60
+gt 62
+lala 125</source>
+<p>The output is:</p>
+<source><?xml version="1.0" encoding="UTF-8"?>
+<out>&lala;</out></source>
</s3>
1.10 +28 -17 xml-xalan/java/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- readme.xml 2000/12/07 17:05:57 1.9
+++ readme.xml 2000/12/07 22:11:58 1.10
@@ -182,7 +182,8 @@
a build/docs/apdidocs/javax/xml/transform directory and run the Xalan
command-line utility from the xdocs directory
as follows (all one line):<br/><br/>
<code>
-java org.apache.xalan.xslt.Process -in sources/trax/trax.xml
+java org.apache.xalan.xslt.Process
+ -in sources/trax/trax.xml
-param package-root '../../../src/'
-xsl style/stylesheets/spec.xsl
-out build/docs/apidocs/javax/xml/transform/trax.html</code><br/><br/></li>
@@ -190,29 +191,39 @@
directory: build/docs/apidocs.<br/><br/></li>
<li>To build the API documentation, run the JDK 1.2.2 javadoc tool
from the xdocs directory (all one line):<br/><br/>
<code>
-javadoc -doclet xalanjdoc.Standard -docletpath ../bin/xalanjdoc.jar -private
+javadoc -doclet xalanjdoc.Standard
+ -docletpath ../bin/xalanjdoc.jar
+ -private
-overview ../src/javadocOverview.html -sourcepath ../src
-group TrAX "javax.xml.transform*"
- -group Xalan_Core "org.apache.xalan.processor:org.apache.xalan.templates:
+ -group Xalan_Core "org.apache.xalan.processor:
+ org.apache.xalan.templates:
org.apache.xalan.transformer"
-group XPath "org.apache.xpath*"
-group Utilities "org.apache.xml.utils*"
- -group Xalan_Other "org.apache.xalan.client:org.apache.xalan.dtm:
- org.apache.xalan.extensions:org.apache.xalan.res:org.apache.xalan.stree:
- org.apache.xalan.trace:org.apache.xalan.xslt"
+ -group Xalan_Other "org.apache.xalan.client:
+ org.apache.xalan.dtm:
+ org.apache.xalan.extensions:org.apache.xalan.res:
+ org.apache.xalan.stree:org.apache.xalan.trace:
+ org.apache.xalan.xslt"
-group Xalan_Extensions "org.apache.xalan.lib*"
-group Serializers "org.apache.xalan.serialize"
- org.apache.xalan.client org.apache.xalan.dtm org.apache.xalan.extensions
- org.apache.xalan.lib org.apache.xalan.lib.sql org.apache.xalan.processor
- org.apache.xalan.res org.apache.xalan.stree org.apache.xalan.templates
- org.apache.xalan.trace org.apache.xalan.transformer org.apache.xalan.xslt
- org.apache.xpath org.apache.xpath.axes org.apache.xpath.compiler
- org.apache.xpath.functions org.apache.xpath.objects
- org.apache.xpath.operations org.apache.xpath.patterns org.apache.xpath.res
- org.apache.xalan.serialize javax.xml.transform javax.xml.transform.dom
- javax.xml.transform.sax javax.xml.transform.stream javax.xml.parsers
- -d ../build/docs/apidocs -windowtitle "Xalan-Java 2" -doctitle "Xalan-Java
2"
- -bottom "Copyright © 2000 Apache XML Project. All Rights Reserved."
+ org.apache.xalan.client org.apache.xalan.dtm
+ org.apache.xalan.extensions org.apache.xalan.lib
+ org.apache.xalan.lib.sql org.apache.xalan.processor
+ org.apache.xalan.res org.apache.xalan.stree
+ org.apache.xalan.templates org.apache.xalan.trace
+ org.apache.xalan.transformer org.apache.xalan.xslt
+ org.apache.xpath org.apache.xpath.axes
+ org.apache.xpath.compiler org.apache.xpath.functions
+ org.apache.xpath.objects org.apache.xpath.operations
+ org.apache.xpath.patterns org.apache.xpath.res
+ org.apache.xalan.serialize javax.xml.transform
+ javax.xml.transform.dom javax.xml.transform.sax
+ javax.xml.transform.stream javax.xml.parsers
+ -d ../build/docs/apidocs -windowtitle "Xalan-Java 2"
+ -doctitle "Xalan-Java 2" -bottom "Copyright ©
+ 2000 Apache XML Project. All Rights Reserved."
</code></li>
</ul>
</s3>
1.7 +4 -1 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.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- resources.xml 2000/12/04 17:23:43 1.6
+++ resources.xml 2000/12/07 22:11:58 1.7
@@ -65,8 +65,11 @@
title="SAX 2"
location="http://www.megginson.com/SAX/Java/index.html"/>
<resource id="jaxp"
- title="Java API for XML Parsing"
+ title="Java API for XML Parsing 1.0"
location="http://java.sun.com/xml/docs/api/index.html"/>
+ <resource id="jaxp11"
+ title="Java API for XML Processing 1.1 Public Review 2"
+
location="http://java.sun.com/aboutJava/communityprocess/review/jsr063/jaxp-pd2.pdf"/>
<resource id="jsr063"
title="Java Specification Request 63"
location="http://java.sun.com/aboutJava/communityprocess/review/jsr063"/>
1.16 +7 -0 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.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- samples.xml 2000/12/07 17:05:57 1.15
+++ samples.xml 2000/12/07 22:11:58 1.16
@@ -70,6 +70,7 @@
<li><link anchor="servlet">Servlet</link></li>
<li><link anchor="extensions">Extensions</link></li>
<li><link anchor="trace">Trace</link></li>
+<li><link anchor="trax">trax</link></li>
</ul>
<s2 title="Samples to help you get started">
<p>Each of the subdirectories in the &xslt4j; java/samples directory
contains the source files for one or more
@@ -275,5 +276,11 @@
<p><code>java Trace</code></p>
<p>and examine the result in events.log. For more information, see
<link idref="usagepatterns" anchor="debugging">Debugger
Interface</link></p>
+ </s2><anchor name="trax"/>
+ <s2 title="trax">
+ <p>What it does: run a number of samples illustrating uses of the <link
idref="trax"/> 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>
</s2>
</s1>
1.16 +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.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- whatsnew.xml 2000/12/07 17:05:57 1.15
+++ whatsnew.xml 2000/12/07 22:11:59 1.16
@@ -62,7 +62,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 Version 1.1, which has been
published for public review. We strongly encourage you to utilize the TrAX
framework when you use &xslt4j2; to perform XML transformations.</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 <link 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>
