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...@apache.org on 2001/05/21 17:13:02 UTC

cvs commit: xml-xalan/java/xdocs/sources/xalan index.xml readme.xml xsltc_constraints.xml xsltc_usage.xml

dleslie     01/05/21 08:13:01

  Modified:    java/xdocs/sources entities.ent xalan-jsite.xml
               java/xdocs/sources/xalan index.xml readme.xml
                        xsltc_constraints.xml xsltc_usage.xml
  Log:
  Updates for releae 2.1
  
  Revision  Changes    Path
  1.19      +10 -6     xml-xalan/java/xdocs/sources/entities.ent
  
  Index: entities.ent
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/entities.ent,v
  retrieving revision 1.18
  retrieving revision 1.19
  diff -u -r1.18 -r1.19
  --- entities.ent	2001/05/18 16:50:20	1.18
  +++ entities.ent	2001/05/21 15:12:20	1.19
  @@ -2,14 +2,14 @@
   
   <!ENTITY xslt4j "Xalan-Java">
   <!ENTITY xslt4j2 "Xalan-Java 2">
  -<!ENTITY xslt4j-dist "xalan-j_2_0_2">
  -<!ENTITY xslt4j-current "&xslt4j; version 2.0.2">
  +<!ENTITY xslt4j-dist "xalan-j_2_1_0">
  +<!ENTITY xslt4j-current "&xslt4j; version 2.1.0">
   <!ENTITY xml4j "Xerces-Java">
   <!ENTITY xml4j-used "&xml4j; version 1.3.1?">
   <!ENTITY xslt4c "Xalan-C++">
   <!ENTITY xml4c "Xerces-C++">
   <!ENTITY download "The &xslt4j-current; download from xml.apache.org includes xerces.jar from &xml4j-used;.">
  -<!ENTITY traxsamplenote "To run the trax sample, you must be using an XML parser (such as Xerces 1.3.0 or Crimson 1.1) 
  +<!ENTITY traxsamplenote "To run the trax sample, you must be using an XML parser (such as Xerces 1.3.1 or Crimson 1.1) 
                            that fully implements the JAXP 1.1 javax.xml.parsers interface.">
   
   <!ENTITY xsltcwhatsnewhead '<ul>
  @@ -24,7 +24,9 @@
                   see <link idref="xsltc_usage">Using XSLTC</link>.</p>
                   </s2>'>
                   
  -<!ENTITY xsltcreadme 
  +<!ENTITY xsltcreleasenotesentry '<li><link anchor="xsltcreleasenotes">XSLTC Release Notes</link></li>'>
  +
  +<!ENTITY xsltcdone 
                   '<p>The Sun XSLTC team (david.hofert@east.sun.com, tom.amiro@east.sun.com, todd.miller@east.sun.com, 
                    morten.jorgensen@Ireland.sun.com) has checked <link idref="xsltc_usage">XSLTC</link> into the Xalan
                    source tree, and we have begun the process of merging XSLTC into Xalan. XSLTC provides a compiler for compiling
  @@ -32,7 +34,8 @@
                    In the near term, XSLTC will appear in a separate JAR file (xsltc.jar) with its own API and command-line
                    utilities. You can already use the same JAXP interfaces to perform
                    transformations with the Xalan transformer and with translets. Over time, we plan to merge the two codebases.
  -                 <ref>See <jump href="xsltc/index.html">XSLTC Design Documents</jump>.</ref></p>'>
  +                 <ref>See <jump href="xsltc/index.html">XSLTC Design Documents</jump>.</ref></p>
  +                 <p>See <link anchor="xsltcreleasenotes">XSLTC Release Notes</link>.</p>'>
   
   <!ENTITY xsltcsampleshead '<li><link anchor="translets">translets</link></li>'>
   
  @@ -40,7 +43,8 @@
                    <ul>
                    <li><link anchor="xsltc1">JAXPTransletOneTransformation</link></li>
                    <li><link anchor="xsltc2">JAXPTransletMultipleTransformations</link></li>
  -                 </ul><anchor name="xsltc1"/>
  +                 </ul>
  +                 <p>See also: <link idref="readme" anchor="xsltcdemos">XSLTC demos</link>.</p><anchor name="xsltc1"/>
                    <p>You can use the TrAX/JAXP 1.1 interfaces to compile and run translets. For this release, you must still
                    use StreamSource objects for the XSL stylesheet and XML input document, and a StreamResult object for the 
                    transformation output. For an overview of the usage patterns these samples illustrate, see 
  
  
  
  1.19      +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.18
  retrieving revision 1.19
  diff -u -r1.18 -r1.19
  --- xalan-jsite.xml	2001/05/10 18:08:22	1.18
  +++ xalan-jsite.xml	2001/05/21 15:12:23	1.19
  @@ -62,7 +62,7 @@
     <resources source="sbk:/sources/xalan/resources.xml"/>
     <external href="../index.html" label="Home"/>
     <separator/>
  -  <document id="index" label="Xalan-J 2.0.1" source="xalan/index.xml"/>
  +  <document id="index" label="Xalan-J 2.1.0" source="xalan/index.xml"/>
     <document id="whatsnew" label="What's New" source="xalan/whatsnew.xml"/>
     <document id="xsltc_usage" label="XSLTC Translets" source="xalan/xsltc_usage.xml"/>
     <separator/>
  
  
  
  1.21      +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.20
  retrieving revision 1.21
  diff -u -r1.20 -r1.21
  --- index.xml	2001/05/10 18:09:46	1.20
  +++ index.xml	2001/05/21 15:12:37	1.21
  @@ -71,7 +71,7 @@
     </s2>
     <s2 title="How about this release?">
     <p>&xslt4j-current; is a production release. This is the first &xslt4j; release to include the 
  -  <link idref="xsltcusage">XSLTC</link> translet compiler and runtime,. This release also incorporates a number of bug fixes.
  +  <link idref="xsltc_usage">XSLTC</link> translet compiler and runtime,. This release also incorporates a number of bug fixes.
      For the details, see <link idref="readme">Release Notes</link>. Please send your feedback to the <human-resource-ref idref="xalandev"/>.</p>
     </s2> 
     <s2 title="How do I get it?">
  
  
  
  1.33      +6 -9      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.32
  retrieving revision 1.33
  diff -u -r1.32 -r1.33
  --- readme.xml	2001/05/10 18:09:47	1.32
  +++ readme.xml	2001/05/21 15:12:39	1.33
  @@ -2,6 +2,7 @@
   <!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd"[
   <!ENTITY done-j SYSTEM "DONE">
   <!ENTITY status-j SYSTEM "STATUS">
  +<!ENTITY xsltcreleasenotes SYSTEM "xsltc_constraints.xml">
   <!ENTITY history-j SYSTEM "history.xml">]>
   
   <!--
  @@ -63,7 +64,7 @@
   <s1 title="Release Notes">
   <p>&xslt4j-current;</p>
    <ul>
  -  <li><link anchor="status0">Status</link></li>
  +  <li><link anchor="status0">Status</link></li>&xsltcreleasenotesentry;
     <li><link anchor="build">Build Notes</link></li>
     <li><link anchor="contact">Getting in touch</link></li>
     <li><link anchor="history">History of software changes</link></li>
  @@ -77,15 +78,11 @@
       <li><link anchor="to-do">To-do tasks for future &xslt4j; releases</link></li>
      </ul>
        <anchor name="done"/>
  -     <s3 title="Changes since &xslt4j; 2.0.1">&xsltcreadme;
  +     <s3 title="Changes since &xslt4j; 2.0.1">
  +     &xsltcdone;
        <p>This release also includes a number of bug fixes to the &xslt4j; and TrAX core and Xalan-Java 1 compability API. 
        We have also enhanced the ApplyXSLT servlet. It can now be set up to use a compiled Templates object to respond to multiple
        client transformation requests involving the same stylesheet.</p>
  -     <ul>
  -     <li></li>
  -     <li><br/><br/></li> 
  -     <li></li>
  -     </ul>
        &done-j;
        </s3>
        <anchor name="other"/>
  @@ -142,8 +139,8 @@
          <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-xalan/java/todo.xml">xml-xalan/java/todo.xml</jump>.</p>
         </s3> 
     </s2>
  -  <anchor name="build"/>
  -  
  +  &xsltcreleasenotes;
  +  <anchor name="build"/>  
     <s2 title="Build Notes">
   <ul>
   <li><link anchor="ant">Using Ant</link></li>
  
  
  
  1.3       +36 -33    xml-xalan/java/xdocs/sources/xalan/xsltc_constraints.xml
  
  Index: xsltc_constraints.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/xsltc_constraints.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- xsltc_constraints.xml	2001/05/18 22:03:42	1.2
  +++ xsltc_constraints.xml	2001/05/21 15:12:42	1.3
  @@ -1,15 +1,16 @@
  -<s2 title="XSLTC Usage Constraints">
  -<p>As of this release, the following changes, additions, omissions, oddities, problems, etc exist in XSLT may impact 
  -your use of XSLTC.
  +<anchor name="xsltcreleasenotes"/>
  +<s2 title="XSLTC Release Notes">
  +<p>For this release, please note the following changes, additions, omissions, problems, procedures for running demos, and new support 
  +for the TrAX API.
   </p>
   <ul>
  -  <li><link anchor="new">Changes and New Features</link></li>
  -  <li><link anchor="conf">Conformance</link></li>
  -  <li><link anchor="demos">Running Demos</link></li>
  -  <li><link anchor="knownproblems">Known Problems</link></li>
  -  <li><link anchor="trax">Translets and TrAX</link></li>
  +  <li><link anchor="xsltcnew">Changes and New Features</link></li>
  +  <li><link anchor="xsltcconf">Conformance</link></li>
  +  <li><link anchor="xsltcknownproblems">Known Problems</link></li>
  +  <li><link anchor="xsltcdemos">Running Demos</link></li>  
  +  <li><link anchor="xsltctrax">Translets and TrAX</link></li>
   </ul>
  -<anchor name="new"/>
  +<anchor name="xsltcnew"/>
   <s3 title="Changes and New Features">
   <p>This - being the first release of XSLTC on Apache (xml.apache.org) - "What's changed" is 
   relative to Preview 5 of XSLTC posted on www.sun.com/xml/developers.</p>
  @@ -26,7 +27,7 @@
     and exception is encountered.</li>
   </ul>
   </s3>
  -<anchor name="conf"/>
  +<anchor name="xsltcconf"/>
   <s3 title="XSLT 1.0 Conformance and Extensions">
   <p>XSLTC does not yet support the following features of the <resource-ref idref="xsl"/>:</p>
   <ul>
  @@ -47,28 +48,8 @@
       node-sets. This would enable sorting and grouping of nodes assigned to a tree </li>
   </ul>
   </s3>
  -<anchor name="demos"/>
  -<s3 title="Running Demos">
  -<p>XSLTC provides demos for using XSLTC as a servlet and as a handler for 
  -Brazil (a new and powerful Web techology from Sun labs). To run these demos,
  -download Brazil from sunlabs:</p>
  -<p><code>&nbsp;&nbsp;&nbsp;&nbsp;<jump href="http://research.sun.com/research/download/index.html">http://research.sun.com/research/download/index.html</jump></code></p>
  -<p>and the java extensions for servlets from Sun:</p>
  -<p><code>&nbsp;&nbsp;&nbsp;&nbsp;
  -<jump href="http://java.sun.com/products/servlet/download.html">
  -http://java.sun.com/products/servlet/download.html</jump>
  -</code></p>
  -<p>The translet must be specified as a pure class name, accessible
  -through the Brazil handler's classpath. For example:</p>
  -<p><code>&nbsp;&nbsp;&nbsp;&nbsp;translet=mk054</code></p>
  -<p>The document must be specified as a valid URL. For example:</p>
  -<p><code>&nbsp;&nbsp;&nbsp;&nbsp;document=http://server/path/to/filename.xml</code></p>
  -<p>If the file is local to the Brazil handler, it has to be
  -specified using the "file:filename.xml" format.</p>
  -<note>You also need to make the Brazil and javax classes available from you classpath</note>
  -</s3>
  -<anchor name="knowproblems"/>
  -<s3 title="Know Problems">
  +<anchor name="xsltcknownproblems"/>
  +<s3 title="Known Problems">
   <ul>
     <li>Casting variables. XSLTC requires you to explicitly type cast values 
     returned by variables or expressions, when you use them in tests. Always a good
  @@ -101,8 +82,30 @@
     it may compile without a warning. In some cases, the compiler aborts with an error 
     about too many branches.</li>
   </ul>
  +</s3>
  +<anchor name="xsltcdemos"/>
  +<s3 title="Running Demos">
  +<p>XSLTC provides demos for using XSLTC as a servlet and as a handler for 
  +Brazil (a new and powerful Web techology from Sun labs). To run these demos,
  +download Brazil from sunlabs:</p>
  +<p><code>&nbsp;&nbsp;&nbsp;&nbsp;<jump href="http://research.sun.com/research/download/index.html">http://research.sun.com/research/download/index.html</jump></code></p>
  +<p>and the java extensions for servlets from Sun:</p>
  +<p><code>&nbsp;&nbsp;&nbsp;&nbsp;
  +<jump href="http://java.sun.com/products/servlet/download.html">
  +http://java.sun.com/products/servlet/download.html</jump>
  +</code></p>
  +<p>The translet must be specified as a pure class name, accessible
  +through the Brazil handler's classpath. For example:</p>
  +<p><code>&nbsp;&nbsp;&nbsp;&nbsp;translet=mk054</code></p>
  +<p>The document must be specified as a valid URL. For example:</p>
  +<p><code>&nbsp;&nbsp;&nbsp;&nbsp;document=http://server/path/to/filename.xml</code></p>
  +<p>If the file is local to the Brazil handler, it has to be
  +specified using the "file:filename.xml" format.</p>
  +<note>You also need to make the Brazil and javax classes available from your classpath</note>
  +<p>See also: <link idref="samples" anchor="translets">sample JAXP translets</link>.</p>
   </s3>
  -<anchor name="trax"/>
  +
  +<anchor name="xsltctrax"/>
   <s3 title="Translets and TrAX">
   <p>
   The Translet API has been extended to conform with the JAXP1.1 TrAX model.
  
  
  
  1.16      +5 -3      xml-xalan/java/xdocs/sources/xalan/xsltc_usage.xml
  
  Index: xsltc_usage.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/xsltc_usage.xml,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- xsltc_usage.xml	2001/05/18 20:39:05	1.15
  +++ xsltc_usage.xml	2001/05/21 15:12:44	1.16
  @@ -1,6 +1,5 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd"[
  -<!ENTITY xsltc_constraints SYSTEM "xsltc_constraints.xml">]>
  +<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
   <!--
    * The Apache Software License, Version 1.1
    *
  @@ -386,5 +385,8 @@
   <p>For a working sample that illustrates this usage pattern, see <link idref="samples" anchor="xsltc2">JAXPTransletMultipleTransformations</link>.</p>
   </s3>
   </s2><anchor name="constraints"/>
  -&xsltc_constraints;
  +<s2 title="XSLTC usage constraints">
  +<p>See <link idref="readme" anchor="xsltcconf">Conformance issues</link> and <link idref="readme" 
  +anchor="xsltcknownproblems">Known problems</link>.</p>
  +</s2>
   </s1>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org