You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@locus.apache.org on 2000/12/07 23:12:02 UTC
cvs commit: xml-xalan/java/xdocs/sources/xalan DONE readme.xml resources.xml samples.xml whatsnew.xml
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>