dleslie 00/12/19 08:02:39
Modified: java/xdocs/sources xalan-jlocal.xml xalan-jsite.xml
java/xdocs/sources/xalan BUGS DONE index.xml readme.xml
Log:
Updates for beta release.
Revision Changes Path
1.10 +1 -1 xml-xalan/java/xdocs/sources/xalan-jlocal.xml
Index: xalan-jlocal.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan-jlocal.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- xalan-jlocal.xml 2000/12/18 13:02:04 1.9
+++ xalan-jlocal.xml 2000/12/19 16:02:35 1.10
@@ -58,4 +58,4 @@
* <http://www.apache.org/>.
-->
-<book title="Xalan XSL Transformer User's Guide" copyright="2000 The Apache
Software Foundation"><resources
source="sbk:/sources/xalan/resources.xml"/><document id="whatsnew"
label="What's New" source="xalan/whatsnew.xml"/><separator/><document
id="overview" label="Overview" source="xalan/overview.xml"/><document
id="getstarted" label="Getting Started"
source="xalan/getstarted.xml"/><separator/><document id="samples" label="Sample
Apps" source="xalan/samples.xml"/><document id="commandline" label="Command
Line" source="xalan/commandline.xml"/><separator/><document id="usagepatterns"
label="Usage Patterns" source="xalan/usagepatterns.xml"/><separator/><external
href="apidocs/index.html" label="API (Javadoc)"/><separator/><document
id="extensions" label="Extensions" source="xalan/extensions.xml"/><document
id="extensionslib" label="Extensions Library"
source="xalan/extensionslib.xml"/><separator/><document id="readme"
label="Release Notes" source="xalan/readme.xml"/><separator/><external
href="http://xml.ap
ache.org/xalan/design/design2_0_0.html" label="Xalan 2 Design"/><external
href="todo.html" label="To-Do List"/><separator/><external
href="http://xml.apache.org/xalan-j/test/overview.html"; label="Testing"/></book>
+<book title="Xalan XSL Transformer User's Guide" copyright="2000 The Apache
Software Foundation"><resources
source="sbk:/sources/xalan/resources.xml"/><document id="whatsnew"
label="What's New" source="xalan/whatsnew.xml"/><separator/><document
id="overview" label="Overview" source="xalan/overview.xml"/><document
id="getstarted" label="Getting Started"
source="xalan/getstarted.xml"/><separator/><document id="samples" label="Sample
Apps" source="xalan/samples.xml"/><document id="commandline" label="Command
Line" source="xalan/commandline.xml"/><separator/><document id="usagepatterns"
label="Usage Patterns" source="xalan/usagepatterns.xml"/><separator/><external
href="apidocs/index.html" label="API (Javadoc)"/><separator/><document
id="extensions" label="Extensions" source="xalan/extensions.xml"/><document
id="extensionslib" label="Extensions Library"
source="xalan/extensionslib.xml"/><separator/><document id="readme"
label="Release Notes" source="xalan/readme.xml"/><separator/><external
href="http://xml.ap
ache.org/xalan/design/design2_0_0.html" label="Xalan 2
Design"/><separator/><external
href="http://xml.apache.org/xalan-j/test/overview.html"; label="Testing"/></book>
1.8 +1 -1 xml-xalan/java/xdocs/sources/xalan-jsite.xml
Index: xalan-jsite.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan-jsite.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- xalan-jsite.xml 2000/12/18 21:27:51 1.7
+++ xalan-jsite.xml 2000/12/19 16:02:35 1.8
@@ -58,4 +58,4 @@
* <http://www.apache.org/>.
-->
-<book title="Xalan XSL Transformer User's Guide" copyright="2000 The Apache
Software Foundation"><resources
source="sbk:/sources/xalan/resources.xml"/><external href="../index.html"
label="Home"/><separator/><document id="index" label="Xalan-J 2.0.D04"
source="xalan/index.xml"/><document id="whatsnew" label="What's New"
source="xalan/whatsnew.xml"/><separator/><document id="overview"
label="Overview" source="xalan/overview.xml"/><document id="getstarted"
label="Getting Started" source="xalan/getstarted.xml"/><separator/><document
id="samples" label="Sample Apps" source="xalan/samples.xml"/><document
id="commandline" label="Command Line"
source="xalan/commandline.xml"/><separator/><document id="usagepatterns"
label="Usage Patterns" source="xalan/usagepatterns.xml"/><separator/><external
href="apidocs/index.html" label="API (Javadoc)"/><separator/><document
id="extensions" label="Extensions" source="xalan/extensions.xml"/><document
id="extensionslib" label="Extensions Library" source="xalan/extensionslib.xm
l"/><separator/><document id="readme" label="Release Notes"
source="xalan/readme.xml"/><separator/><external
href="http://xml.apache.org/xalan/design/design2_0_0.html"; label="Xalan 2
Design"/><external href="todo.html" label="To-Do List"/><separator/><external
href="http://xml.apache.org/xalan-j/test/overview.html"; label="Testing"/></book>
+<book title="Xalan XSL Transformer User's Guide" copyright="2000 The Apache
Software Foundation"><resources
source="sbk:/sources/xalan/resources.xml"/><external href="../index.html"
label="Home"/><separator/><document id="index" label="Xalan-J 2.0.D04"
source="xalan/index.xml"/><document id="whatsnew" label="What's New"
source="xalan/whatsnew.xml"/><separator/><document id="overview"
label="Overview" source="xalan/overview.xml"/><document id="getstarted"
label="Getting Started" source="xalan/getstarted.xml"/><separator/><document
id="samples" label="Sample Apps" source="xalan/samples.xml"/><document
id="commandline" label="Command Line"
source="xalan/commandline.xml"/><separator/><document id="usagepatterns"
label="Usage Patterns" source="xalan/usagepatterns.xml"/><separator/><external
href="apidocs/index.html" label="API (Javadoc)"/><separator/><document
id="extensions" label="Extensions" source="xalan/extensions.xml"/><document
id="extensionslib" label="Extensions Library" source="xalan/extensionslib.xm
l"/><separator/><document id="readme" label="Release Notes"
source="xalan/readme.xml"/><separator/><external
href="http://xml.apache.org/xalan/design/design2_0_0.html"; label="Xalan 2
Design"/><separator/><external
href="http://xml.apache.org/xalan-j/test/overview.html"; label="Testing"/></book>
1.9 +3 -8 xml-xalan/java/xdocs/sources/xalan/BUGS
Index: BUGS
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/BUGS,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- BUGS 2000/12/18 22:24:47 1.8
+++ BUGS 2000/12/19 16:02:38 1.9
@@ -1,13 +1,8 @@
<s3 title="Open bugs and bug reporting">
-<p>We are aware of the following limitations and problems in this beta
release:</p>
+<p>&xslt4j-current; passes all conformance tests in our comprehensive test
suite. We are not aware of any outstanding bugs in this release. We are aware,
however, of a Xerces bug in &xml4j-used; which does affect &xslt4j;:</p>
<ul>
-<li>There are differences in the way 1.x and 2.0. handle space and linefeed
characters.<br/><br/></li>
-<li>In some cases, a named character (© etc.) will be output where 1.x
would put out a literal character.<br/><br/></li>
-<li>In some cases, a linefeed will be output where 1.x put out
&#10;.<br/><br/></li>
-<li>In some cases, %hh encoding will be used in HTML URI attributes instead
of a named character (e.g., ä) or a literal character.<br/><br/></li>
-<li>Sometimes a declaration for the default or XSLT namespace is added when
not needed.<br/><br/></li>
-<li>The <xsl:namespace-alias... does not output the correct
prefix.<br/><br/></li>
-<li>Some required CDATA markers are not being output.<br/><br/></li>
+<li>&xml4j; 1.2.3 does not process namespaces in SAX events when parsing
UTF-16 documents, which causes &xslt4j; to fail with UTF-16 documents.
+Xerces will post a fix shortly.<br/><br/></li>
</ul>
<p>The Apache XML Bug Tracking System is currently not working. If you find
a bug, please report it (with "Xalan-J 2 bug" in the subject line) to the
<human-resource-ref idref="xalandev"/>. We strongly encourage you write patches
for problems you find and submit them to <human-resource-ref
idref="xalandev"/>. We review the patches we receive to make sure they do not
break something else, and (assuming they do not) include them in our next
release. In the interest of fixing bugs, adding enhancements, and addressing
outstanding design issues, we sincerely want (and need!) your active
participation in the ongoing development of Xalan.</p>
</s3>
1.7 +2 -3 xml-xalan/java/xdocs/sources/xalan/DONE
Index: DONE
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/DONE,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- DONE 2000/12/18 22:24:47 1.6
+++ DONE 2000/12/19 16:02:38 1.7
@@ -1,7 +1,6 @@
<s3 title="Changes since &xslt4j; version 2.0.D01">
-<p>Most of the bugs reported in &xslt4j; 2.0.D01 have been fixed. For a list
of outstanding bugs, see <link anchor="bugs">Open Bugs</link>.</p>
-<p>For a list of completed to-do tasks, see <jump
href="todo.html#release-date-completed">Tasks completed</jump>.</p>
-<p>The remainder of this section discusses two changes that are especially
visible:</p>
+<p>All of the bugs reported in &xslt4j; 2.0.D01 have been fixed. For a list
of tasks in the &xslt4j2; To-Do list that have been completed, see <jump
href="todo.html#release-date-completed">Tasks completed</jump>.</p>
+<p>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><em>Output properties</em></p>
1.11 +6 -4 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.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- index.xml 2000/12/18 23:07:12 1.10
+++ index.xml 2000/12/19 16:02:38 1.11
@@ -70,10 +70,12 @@
<p>For more information, see <link idref="whatsnew">What's new in
&xslt4j2;</link>.</p>
</s2>
<s2 title="How about this release?">
- <p>&xslt4j-current; is a beta Developer's release of &xslt4j2;. Since
&xslt4j; 2.0.D01, TrAX has been revised and integrated
- with the XMP Parser API in the Java API for XML Processing, so &xslt4j;
has been revised accordingly. &xslt4j-current; represents a stable build
- that conforms to the XSLT and XPath 1.0 specifications. For the details,
see the
- <link idref="readme">Release notes</link>. Please send your comments,
bug reports, and feedback to the <human-resource-ref idref="xalandev"/></p>
+ <p>&xslt4j-current; is a beta Developer's release of &xslt4j2;. It
represents a stable build that conforms to the XSLT
+ and XPath 1.0 specifications.</p>
+ <p>Since &xslt4j; 2.0.D01, TrAX has been revised and integrated with the
XMP Parser API in the Java API for XML Processing,
+ so &xslt4j; has been revised accordingly. This release also includes
greatly expanded support for custom stylesheet control
+ over output properties. For the details, see the <link
idref="readme">Release notes</link>. Please send your comments, bug reports,
+ and feedback to the <human-resource-ref idref="xalandev"/>.</p>
</s2>
<s2 title="How do I get it?">
<p>Download and unzip either of the following:</p>
1.12 +21 -1 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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- readme.xml 2000/12/18 13:35:37 1.11
+++ readme.xml 2000/12/19 16:02:38 1.12
@@ -71,13 +71,33 @@
<s2 title="Status">
<ul>
<li><link anchor="done">Changes since version 2.0.D01</link></li>
+ <li><link anchor="other">Other points of interest</link></li>
<li><link anchor="bugs">Open bugs and bug reporting</link></li>
<li><link anchor="status">Version of Xerces to use</link></li>
<li><link anchor="to-do">To-do tasks for future &xslt4j;
releases</link></li>
</ul>
<anchor name="done"/>
&done-j;
- <anchor name="bugs"/>
+ <anchor name="other"/>
+ <s3 title="Other points of interest">
+ <ul>
+ <li>Handling xsl:namespace-alias declarations: In release 2.0.D01, we
reported the need to do some research concerning exactly how Xalan
+ should handle xsl:namespace-alias declarations. As a result of
discussions among members of the W3C Working Group on XSL, we have reached a
+ more precise concensus on how namespaces should be represented when an
xsl:namespace-alias declaration is in effect.<br/><br/>
+ If a literal result element has a namespace prefix, the prefix will be
preserved and the namespace URI of the element will be as
+ specified in the xsl:namespace-alias element, but the result-prefix is
not required to appear in the result. This also applies to the
+ two other cases of "Literal namespace URI" mentioned in the XSLT
Recommendation on
+ <jump href="http://www.w3.org/TR/xslt#literal-result-element";>Literal
Result Elements</jump>. More simply, if the stylesheet calls for
+ <axsl:foo> to be output as a literal result element, then it will
be output as <axsl:foo> in the result, but the namespace
+ associated with this "axsl" prefix will be as designated in the
xsl:namespace-alias declaration.<br/><br/></li>
+ <li>For HTML output, &xslt4j2; outputs character entity references
(&copy; etc.) for all the special characters designated in
+ <jump href="http://www.w3.org/TR/xhtml1/#dtds";>Appendix A. DTDs of the
XHTML 1.0: The Extensible HyperText Markup
+ Language</jump>. &xslt4j; 1.x, on the other hand, outputs literal
characters for some of these special characters.<br/><br/></li>
+ <li>In conformance with the <jump
href="http://www.w3.org/TR/xslt#section-HTML-Output-Method";>XSLT Recommendation
on the HTML
+ Output Method</jump> and <jump
href="http://www.w3.org/TR/REC-html40/appendix/notes.html#h-B.2.1";>Section
B.2.1 of the HTML 4.0
+ Recommendation</jump>, &xslt4j2; uses %hh encoding for non-ASCII
characters in HTML URI attributes.</li>
+ </ul>
+ </s3><anchor name="bugs"/>
&bugs-j;
<anchor name="status"/>
&status-j;
