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/01/10 22:23:03 UTC

cvs commit: xml-xalan/docs resources.xml overview.xml install.xml commandline.xml api.xml

dleslie     00/01/10 13:23:03

  Modified:    docs     resources.xml overview.xml install.xml
                        commandline.xml api.xml
  Log:
  editorial and link fixes per SPR SCUU4FER9P
  
  Revision  Changes    Path
  1.18      +3 -6      xml-xalan/docs/resources.xml
  
  Index: resources.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/docs/resources.xml,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- resources.xml	2000/01/07 22:13:09	1.17
  +++ resources.xml	2000/01/10 21:23:02	1.18
  @@ -111,11 +111,11 @@
   	location="http://www.w3.org/TR/PR-DOM-Level-1 "/>
   
       <!-- The version of the XML4J used for testing. -->
  -  <resource id="xml4j-used" name="XML4J 3.0.0"
  -	long-title="Version 3.0.0 of the XML Parser for Java" name-is-abrev="yes"
  +  <resource id="xml4j-used" name="XML4J 3.0.0EA3"
  +	long-title="Version 3.0.0EA3 of the XML Parser for Java" name-is-abrev="yes"
   	location="http://www.alphaworks.ibm.com/tech/xml4j"/>    
     <resource id="xerces-used" name="Xerces-Java"
  -	long-title="Version 1.0.0 of Xerces-Java" name-is-abrev="yes"
  +	long-title="Version 1.0.1 of Xerces-Java" name-is-abrev="yes"
   	location="http://xml.apache.org/xerces-j/index.html"/>   
     
     <resource id="JRE1.2" name="JRE-1.2" long-title="Sun's JRE-1.2"
  @@ -251,9 +251,6 @@
   <resource id="NSInfoJava" location="src/org/apache/xalan/xpath/xml/NSInfo.java" name-is-abrev="no" long-title="NSInfo class" name="NSInfo class"/>
   <resource id="FormatterDoc" location="apidocs/org/apache/xalan/xpath/xml/Formatter.html" name-is-abrev="no" long-title="Formatter class" name="Formatter class"/>
   <resource id="FormatterJava" location="src/org/apache/xalan/xpath/xml/Formatter.java" name-is-abrev="no" long-title="Formatter class" name="Formatter class"/>
  -<resource id="FormatterListenerDoc" location="apidocs/org/apache/xalan/xpath/xml/FormatterListener.html" 
  -name-is-abrev="no" long-title="FormatterListener" name="FormatterListener"/>
  -<resource id="FormatterListenerJava" location="src/org/apache/xalan/xpath/xml/FormatterListener.java" name-is-abrev="no" long-title="FormatterListener class" name="FormatterListener class"/>
   <resource id="AttListDoc" location="apidocs/org/apache/xalan/xpath/xml/AttList.html" name-is-abrev="no" long-title="AttList class" name="AttList class"/>
   <resource id="AttListJava" location="src/org/apache/xalan/xpath/xml/AttList.java" name-is-abrev="no" long-title="AttList class" name="AttList class"/>
   <resource id="DefaultErrorHandlerDoc" location="apidocs/org/apache/xalan/xpath/xml/DefaultErrorHandler.html" name-is-abrev="no" long-title="DefaultErrorHandler class" name="DefaultErrorHandler class"/>
  
  
  
  1.10      +2 -2      xml-xalan/docs/overview.xml
  
  Index: overview.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/docs/overview.xml,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- overview.xml	2000/01/06 20:41:00	1.9
  +++ overview.xml	2000/01/10 21:23:02	1.10
  @@ -90,7 +90,7 @@
           </source>
           <p>foo.xsl:</p>
           <source>
  -&lt;xx?xml version="1.0"?> 
  +&lt;?xml version="1.0"?> 
   &lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
   &lt;xsl:template match="doc">
   &lt;out>&lt;xsl:value-of select="."/>&lt;/out>
  @@ -108,7 +108,7 @@
      	  <s2 title="&xslt4j; Features">
   	    <ul> 
   		    <li>Implements the <resource-ref idref="xsl-draft-used"/>.</li> 
  -    	  <li>Uses &xml4j;></li>
  +    	  <li>Uses &xml4j;</li>
       	  <li>Can interface to any XML parser that produces Java DOM Trees</li>
       	  <li>Can output to SAX or DOM</li>
       	  <li>Includes an applet wrapper</li>
  
  
  
  1.7       +7 -7      xml-xalan/docs/install.xml
  
  Index: install.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/docs/install.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- install.xml	2000/01/07 22:13:09	1.6
  +++ install.xml	2000/01/10 21:23:02	1.7
  @@ -81,9 +81,9 @@
   	</s2>
     
     <s2 title="Using &xslt4j; with an &xml4j; Parser">
  -     <p>By default, Xalan 0.19.2 uses the high-performance DTM parser in Xalan 1.0.0 to parse XML documents
  +     <p>By default, Xalan 0.19.2 uses the high-performance DTM parser in Xerces 1.0.1 to parse XML documents
        and XSL stylesheets.  As indicated in the preceding section, you provide &xslt4j; access to this parser by downloading
  -     &xml4j; from http://xml.apache.org and placing xalan.jar in the classpath. &xslt4j; also provides a liaison for the 
  +     &xml4j; from http://xml.apache.org and placing xerces.jar in the classpath. &xslt4j; also provides a liaison for the 
        &xml4j; 1.0.0 DOM parser.</p>
        <note><p>If you want to use earlier alphaWorks releases of the XML4J DOM or TXDOM parsers, you should download 
        LotusXSL 0.19.2 from http://www.alphaworks.ibm.com/tech/LotusXSL.</p></note>
  @@ -99,12 +99,12 @@
          <li><p>Set up GNU or the equivalent build environment on your workstation.</p>
          <p> If you are running Windows 95/98/NT, you can use the Cygwin port of GNU. Be sure to put the
          appropriate Cygwin bin directory at the beginning of your system path. For information about Cygwin, see 
  -       <link idref="http://sourceware.cygnus.com/cygwin/">Cygwin</link>.</p></li>
  +       <jump href="http://www.sourceware.cygnus.com/cygwin/">Cygwin</jump>.</p></li>
          <li><p>Place <resource-ref idref="xerces-used"/> xerces.jar in the Java classpath.</p></li>
          <li><p>If you are working in Windows, set MAKE_MODE as follows:</p>
          <p><code>set MAKE_MODE=UNIX</code></p></li>
  -       <li><p>Run the lMakefile in the &xslt4j; root directory:</p>
  -       <p><code>make -f lMakefile build</code></p></li>
  +       <li><p>Run the make file in the &xslt4j; root directory:</p>
  +       <p><code>make build</code></p></li>
        </ol>
      </s2>
      <s2 title="Generating the documentation">
  @@ -113,7 +113,7 @@
         and the overview and package-level documents used during the generation of Javadoc.</p>
        <p>To generate the Xalan User's Guide, run the Xalan make file in the Xalan <em>docs</em> 
        directory:</p>
  -     <p><code>make -f lMakefile stylebook</code></p>
  +     <p><code>make stylebook</code></p>
        <p>To generate Xalan API documentation, set up the make file to use the Javadoc tool in the Java JDK 1.2.2 bin 
        directory. </p>
        <p>Do the following:</p>
  @@ -121,7 +121,7 @@
            <li><p>Put the Java JDK 1.2.2 bin directory on your path (in front of any JDK 1.1.x bin 
            directory that appears on the path).</p></li>
            <li><p>In the Xalan docs directory, run the Xalan make file as follows:</p>
  -         <p><code>make -f lMakefile javadoc</code></p></li>
  +         <p><code>make javadoc</code></p></li>
         </ol>
     </s2>
   </s1>
  
  
  
  1.6       +1 -1      xml-xalan/docs/commandline.xml
  
  Index: commandline.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/docs/commandline.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- commandline.xml	1999/12/08 17:11:35	1.5
  +++ commandline.xml	2000/01/10 21:23:02	1.6
  @@ -64,7 +64,7 @@
      <s2 title="Using the Command-Line Utility">
         <p>To perform a transformation, you can call &xslt4j; from the command line (or script), 
         an applet, an application, or a servlet. see <resource-ref idref="APIOverview"/> and <resource-ref idref="APIDocumentation"/>.</p>
  -     <p>The org.apache.xml.xslt4j.Process main() method provides a comand-line interface
  +     <p>The org.apache.xalan.xslt.Process main() method provides a comand-line interface
       for performing XSL transformation. To perform a transformation from the command line or a script,
       do the following:</p>
    		<ol>
  
  
  
  1.8       +2 -41     xml-xalan/docs/api.xml
  
  Index: api.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/docs/api.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- api.xml	1999/12/17 20:52:45	1.7
  +++ api.xml	2000/01/10 21:23:02	1.8
  @@ -71,51 +71,12 @@
       compiled stylesheet. If the XML document contains a stylesheet Processing Instruction (PI), a separate stylesheet is not
       required.</p>
       <p>&xslt4j; uses an implementation of the <resource-ref idref="XMLParserLiaisonDoc"/> to interact with &xml4j; (or another
  -     XML parsser) and sends output events to a <resource-ref idref="FormatterListenerDoc"/>, an extension of
  +     XML parsser) and sends output events to an extension of
        <resource-ref idref="SAX"/> <resource-ref idref="SAXDocumentHandler"/>.</p>
        <p>The XSLT and XPath engines are independent from any given DOM or XML implementation. All parser-dependent calls are
        funneled through the XMLParserLiaison.</p>
     </s2>
  -  <s2 title="Packages">
  -     <p>&xslt4j; is composed of three XPATH4J packages and four &xslt4j; packages. The XPATH4J packages can be used on their
  -     own, but for convenience are packaged in the same JAR as the XSLT processor.</p>
  -     <p>XPATH4J packages:</p> 
  -     <ul>
  -     <li><p><resource-ref idref="org.apache.xalan.xpathDoc"/> -- Contains the infrastructure for processing 
  -     XPATH expressions.</p></li>
  -     <li><p><resource-ref idref="org.apache.xalan.xpath.xmlDoc"/> -- The <resource-ref idref="XMLParserLiaisonDoc"/>
  -     provides a liaison between the XSLT processor and an XML parser. Unless you specify an XML parser and your own
  -     implementation of the XMLParserLiaison interface, &xslt4j; uses <resource-ref idref="XMLParserLiaisonDefaultDoc"/> to
  -     interface the &xml4j; parser. This package also includes four implementations of the 
  -     <resource-ref idref="FormatterListenerDoc"/>, a SAX-based formatter interface for the XSL
  -     processor: the <resource-ref idref="FormatterToDOMDoc"/>, the <resource-ref idref="FormatterToXMLDoc"/>, the
  -     <resource-ref idref="FormatterToHTMLDoc"/> (an extension of FormatterToXML), and the 
  -     <resource-ref idref="FormatterToTextDoc"/>.</p></li>
  -     <li><p><resource-ref idref="org.apache.xalan.xpath.xml4j2domDoc"/> -- Contains the 
  -     <resource-ref idref="XML4JLiaison4domDoc"/>, an extension of the XMLParserLiaisonDefault that provides an interface to
  -     XML4J Version 2.0.15.</p></li>
  -     </ul>
  -     <p>&xslt4j; packages:</p>
  -     <ul>
  -     <li><p><resource-ref idref="org.apache.xalan.xsltDoc"/> -- This is the main &xslt4j; package.</p>
  -     <p>The <resource-ref idref="XSLTProcessorDoc"/> defines the XSLT processor API. The 
  -     <resource-ref idref="XSLTProcessorFactoryDoc"/> provides methods for creating an instance of the XSLT processor, 
  -     which actually uses <resource-ref idref="XSLTEngineImplDoc"/>, an implementation of XSLTProcessor that users never need
  -     to call directly.</p>
  -     <p>To perform a transformation, you also need <resource-ref idref="XSLTInputSourceDoc"/> objects to represent the the 
  -     XML source document and the XSL stylesheet, and an <resource-ref idref="XSLTResultTargetDoc"/> object to represent the
  -     result of the transformation.</p>
  -     </li>
  -     <li><p><resource-ref idref="org.apache.xalan.xslt.clientDoc"/> -- Contains 
  -     <resource-ref idref="XSLTProcessorAppletDoc"/>, a simple applet for hosting the &xslt4j; processor.</p></li>  
  -     <li><p><resource-ref idref="org.apache.xalan.xslt.extensionsDoc"/> -- Contains <resource-ref idref="RedirectDoc"/>, 
  -     an element extension class that allows an XSLT transformation to redirect its output to multiple FormatterListeners 
  -     and documents.</p></li>
  -     <li><p><resource-ref idref="org.apache.xalan.xslt.traceDoc"/> -- Contains a 
  -     <jump href="#debugger-interface">debugger interface</jump> for &xslt4j;.</p></li>
  -     </ul>
  -     </s2>     
  -     <s2 title="Performing XSL Transformations">
  +   <s2 title="Performing XSL Transformations">
        <p>This release of &xslt4j; supports three mechanisms for transforming an xml document.</p>
        <ul>
        <li>Calling the &xslt4j; processor from the command-line</li>