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/19 17:02:40 UTC

cvs commit: xml-xalan/java/xdocs/sources/xalan BUGS DONE index.xml readme.xml

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 (&copy; 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 &amp;#10;.<br/><br/></li>
  -<li>In some cases, %hh encoding will be used in HTML URI attributes instead of a named character (e.g., &auml;) 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 &lt;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&reg; <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
  +     &lt;axsl:foo&gt; to be output as a literal result element, then it will be output as &lt;axsl:foo&gt; 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 (&amp;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;