xml-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dles...@locus.apache.org
Subject cvs commit: xml-site/targets/xalan commandline.html dtm.html extensions.html getstarted.html overview.html readme.html samples.html usagepatterns.html xslt4c.html
Date Fri, 25 Feb 2000 22:37:17 GMT
dleslie     00/02/25 14:37:17

  Modified:    targets/xalan commandline.html dtm.html extensions.html
                        getstarted.html overview.html readme.html
                        samples.html usagepatterns.html xslt4c.html
  Log:
  Xalan doc weekly update
  
  Revision  Changes    Path
  1.10      +7 -4      xml-site/targets/xalan/commandline.html
  
  Index: commandline.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/commandline.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- commandline.html	2000/02/17 17:53:07	1.9
  +++ commandline.html	2000/02/25 22:37:09	1.10
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -43,8 +47,8 @@
       for performing XSL transformation. To perform a transformation from the command line or a script,
       do the following:</P>
    		<OL>
  -    <LI>Install Xalan. See <A href="install.html" target="_top">Installing Xalan</A>.<BR><BR></LI> 
  -    <LI>Set the java Classpath to include xalan.jar and xerces.jar. See <A href="getstarted.html#classpath">Setting the class path</A><BR><BR></LI>
  +    <LI><A href="getstarted.html#download">Download Xalan</A>. See <A href="install.html" target="_top">Installing Xalan</A>.<BR><BR></LI> 
  +    <LI><A href="getstarted.html#classpath">Set the java classpath</A> to include xalan.jar and xerces.jar<BR><BR></LI>
       <LI>Call java and the Process class with the appropriate flags and
       arguments (described below). The following command line, for example, includes the -IN, -XSL,
       and -OUT flags with their accompanying arguments -- the XML source document, the XSL
  @@ -59,7 +63,6 @@
           -LXCIN compiledStylesheetFileNameIn
           -LXCOUT compiledStylesheetFileNameOut
           -PARSER fully qualified class name of parser liaison
  -        -E (Keep--do not expand -- entity refs)
           -V (Version info)
           -QC (Quiet Pattern Conflicts Warnings)
           -Q  (Quiet Mode)
  @@ -82,7 +85,7 @@
         <P>Include -PARSER if you supply your own parser liaison class, which is required
         if you do not use the Xerces-Java parser.</P>
         <P>Use -TEXT if you want the output to include only element values (not element tags with element names and
  -      attributes). Use -HTML to write 4.0 transitional HTML (some elements, such as ltxxbr&gt;, are
  +      attributes). Use -HTML to write 4.0 transitional HTML (some elements, such as &lt;br&gt;, are
         not well formed.</P>
         <P>To set stylesheet parameters from the command line, use -PARAM name expression. If 
         you want to set the parameter to a string value, enclose the string in single quotes (') to
  
  
  
  1.8       +12 -4     xml-site/targets/xalan/dtm.html
  
  Index: dtm.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/dtm.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- dtm.html	2000/02/17 17:53:07	1.7
  +++ dtm.html	2000/02/25 22:37:09	1.8
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <IMG alt="Xalan DTM" border="0" height="12" hspace="0" src="graphics/dtm-label-1.jpg" vspace="0" width="120"><BR>
  @@ -42,13 +46,17 @@
        stylesheet, Xalan uses an implementation of the DOM interface. For large XML documents, however,
        this may involve considerable overhead, since Xalan must create one or more Java objects for each Node
        in the document.</P>
  -     <P>For those cases where you provide a URL, file, character stream, SAX input stream, or byte stream as input
  -     and use the  default XML liaison and parser, Xalan avoids this overhead by implementing a DTM, effectively
  -     a &quot;pseudo-DOM&quot; that uses integer arrays in place of the DOM. For larger input trees, the performance
  -      improvements can be very significant.</P>
  +     <P>For those cases where you provide a URL, file, character stream, SAX input stream, or byte stream as
  +      input, and use the default XML liaison and parser, Xalan avoids this overhead by implementing a DTM,
  +      effectively a &quot;pseudo-DOM&quot; that uses integer arrays in place of the DOM. For larger input trees, the
  +      performance improvements can be very significant.</P>
        <P>The XSLTProcessorFactory getProcessor() method sets up an XSLT processor to use the default liaison and
        parser. If your input is a DOM, you must use a &quot;standard&quot; DOM parser. In that case, you can use the 
        XercesLiaison and Xerces XML parser. For more information, see <A href="usagepatterns.html#dom-in">Processing DOM input</A>.</P>     
  +      <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>The DTM parser always attempts to expand entitity references in the source tree and stylesheet
  +      tree. If you attempt to turn off entity reference expansion -- with DTMLiaison
  +      setShouldExpandEntitityRefs(false) -- DTMLaison does not make the setting and issues a message to that
  +      effect. You can make this setting with XercesLiaison.</I></FONT></TD></TR></TABLE>
   	 </FONT></TD></TR></TABLE><BR>
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
                 Copyright &copy; 2000 The Apache Software Foundation.
  
  
  
  1.6       +10 -6     xml-site/targets/xalan/extensions.html
  
  Index: extensions.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/extensions.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- extensions.html	2000/02/17 17:53:06	1.5
  +++ extensions.html	2000/02/25 22:37:10	1.6
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -47,7 +51,7 @@
   <LI>Examples: <A href="#ex-basic">basic JavaScript example</A>, <A href="#ex-redirect">the Redirect extension</A>, <A href="#ex-java-namespace">using the java namespace</A>, <A href="#ex-java">using a Java Hashtable</A>, <A href="#ex-javascript">using a JavaScript array</A></LI>
   </UL><A name="intro"><!--anchor--></A>
     <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Introduction</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
  -  <P>For those situations where you would like to augment the functionality of XSLT with calls to a procedural language, Xalan supports the creation and use of extension elements and extension functions. An extension (a collection of elements and functions) inhabits a namespace, either a namespace you declare and designate as an extensions namespace, or the predefined java namespace that Xalan provides.</P>
  +  <P>For those situations where you would like to augment the functionality of XSLT with calls to a procedural language, Xalan supports the creation and use of extension elements and extension functions. An extension (a collection of elements and functions) inhabits a namespace, either a namespace you declare and designate as an extensions namespace, or the predefined java namespace that Xalan provides. For information about XML namespaces, see <A href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML</A>.</P>
   
   <P><B>Extension elements</B>  Unlike a literal result element, which the stylesheet simply transfers to the result tree, an extension element performs an action. For example, you can use the Redirect extension elements shipped with Xalan to redirect portions of your transformation output to one or more files. Extension elements may contain attributes, text nodes, other elements, basically any form of the content you can place in an XML element. Extension elements may perform quite sophisticated actions, given that the extension routine has direct access to the XSL processor context object and to the element. In many cases the implementation returns void or null; if it does return a value, that value is placed in the transformation result.</P>
   
  @@ -215,7 +219,7 @@
   <P>In the stylesheet element:</P> 
   <P><CODE><FONT face="courier, monospaced">extension-element-prefixes=&quot;<I>prefix-1 prefix-2 ...</I>&quot;</FONT></CODE></P>
   <P>In a literal result element or extension element include the xsl prefix:</P>
  -<P><CODE><FONT face="courier, monospaced">xsl:extension-element-prefixes=&quot;<I>prefix1 prefix 2 ...</I>&quot;</FONT></CODE></P>
  +<P><CODE><FONT face="courier, monospaced">xsl:extension-element-prefixes=&quot;<I>prefix1 prefix2 ...</I>&quot;</FONT></CODE></P>
   <P>Keep in mind that where you declare namespaces and designate extension prefixes determines the scope of those namespaces.To make your extensions available throughout the stylesheet, include these settings and attribute in the stylesheet element.</P>
   <P>By default, namespace declarations are included in the transformation output. To exclude namespaces from the output, use</P>
   <P><CODE><FONT face="courier, monospaced">exclude-result-prefixes=&quot;<I>prefix-1 prefix-2 ...</I>&quot;</FONT></CODE></P>
  @@ -230,7 +234,7 @@
      <CODE><FONT face="courier, monospaced">&nbsp;&nbsp;&nbsp;&nbsp;elements=&quot;<I>elem-1 elem-2 ...elem-n</I>&quot;&gt;</FONT></CODE><BR>
      <CODE><FONT face="courier, monospaced">&nbsp;&nbsp;&lt;!--See lxslt:script below--&gt;</FONT></CODE><BR>
      <CODE><FONT face="courier, monospaced">&lt;/xslt:component&gt;</FONT></CODE></P>
  -<P>where <I>func-1 func-2 ... func-n</I> and <I>elem-1 elem-2 elem-n</I> designate the functions and elements the extension provides and the stylesheet uses. You can use the function-available and element-available functions to determine at run time whether a function or element designated in the xslt:component is actually available.</P>
  +<P>where <I>func-1 func-2 ... func-n</I> and <I>elem-1 elem-2 ... elem-n</I> designate the functions and elements the extension provides and the stylesheet uses. You can use the function-available and element-available functions to determine at run time whether a function or element designated in the xslt:component is actually available.</P>
   <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>If your extension namespace is a fully qualified class name, you do not need to include the xslt:component. If you do not include it, you cannot use the function-available and element-available functions to determine whether a given element or function is actually available at runtime.</I></FONT></TD></TR></TABLE>
   </FONT></TD></TR></TABLE><BR>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>5. Set up the lxslt:script element</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/voi
d.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
  @@ -280,7 +284,7 @@
   </FONT></TD></TR></TABLE><BR>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>The Redirect extension</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspac
e="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
   <P>The Redirect extension (<A href="apidocsorg/apache/xalan/xslt/extensions/Redirect.html">org.apache.xalan.xslt.extensions.Redirect</A>) is shipped with Xalan (more extensions are on the way!).</P>
  -<P>A standard XSL transformation involves three parameters: the XML source tree, an XSL stylesheet, and the transformation result tree. Whether, the result tree is output to a file, a character stream, a byte stream, a DOM, or a SAX document handler, the initial transformation sends the entire result to a single target, represented by the <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A>.</P> 
  +<P>A standard XSL transformation involves three parameters: the XML source tree, an XSL stylesheet, and the transformation result tree. Whether the result tree is output to a file, a character stream, a byte stream, a DOM, or a SAX document handler, the initial transformation sends the entire result to a single target, represented by the <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A>.</P> 
   <P>The Redirect extension supplies three extension elements that you can use to redirect portions of your transformation output to multiple files: &lt;open&gt;, &lt;write&gt;, and &lt;close&gt;. If you use the &lt;write&gt; element alone, the extension opens a file, writes to it, and closes the file immediately. If you want explicit control over the opening and closing of files, use &lt;write&gt; in conjunction with the &lt;open&gt; and &lt;close&gt; elements.</P>
   <P>Each of these elements includes a file attribute and/or a select attribute to designate the output file. The file attribute takes a string, so you can use it to directly specify the output file name; The select attribute takes an XPath expression, so you can use it to dynamically generate the output file name. If you include both attributes, the Redirect extension first evaluates the select attribute, and falls back to the file attribute if the select attribute expression does not return a valid file name.</P>
   </FONT></TD></TR></TABLE><BR><A name="ex-redirect"><!--anchor--></A> 
  @@ -406,7 +410,7 @@
   <P><CODE><FONT face="courier, monospaced"><I>prefix</I>:<I>FQCN.methodName</I> (<I>args</I>)</FONT></CODE></P>
   <P>where <I>FQCN</I> is the fully qualified class name whose static method <I>methodName</I> is to be invoked using the <I>args</I> arguments.<BR>
   Example: <CODE><FONT face="courier, monospaced">variable new-pop</FONT></CODE><BR>
  -<CODE><FONT face="courier, monospaced">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;select=&quot;my-ext:java.lang.Integer.valueOf(string(@population)&quot;</FONT></CODE></P>
  +<CODE><FONT face="courier, monospaced">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;select=&quot;my-ext:java.lang.Integer.valueOf(string(@population))&quot;</FONT></CODE></P>
   
   <P><CODE><FONT face="courier, monospaced"><I>prefix</I>:<I>methodName</I> (<I>object</I>, <I>args</I>)</FONT></CODE></P>
   <P>where <I>methodName</I> is the name of the method to invoke on <I>object</I> with the <I>args</I> arguments.<BR>
  @@ -474,7 +478,7 @@
     <LI>The exclude-result-prefixes stylesheet attribute prevents the java namespace declaration from
      appearing in the output.</LI>
     <LI>The XSLT type returned by any LocationPath expression is node-set, so the XSLT string
  -    function is used to convert the format, year, month, and day attribute node-set values to
  +    function is used to convert the format, year, month, and day attribute values from node-sets to
       strings.</LI>
     <LI>The format attribute provides a String argument for constructing a java.text.SimpleDateFormat
       object.</LI>
  
  
  
  1.2       +11 -7     xml-site/targets/xalan/getstarted.html
  
  Index: getstarted.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/getstarted.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- getstarted.html	2000/02/17 17:53:06	1.1
  +++ getstarted.html	2000/02/25 22:37:11	1.2
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -40,23 +44,23 @@
   <LI><A href="#classpath">Setting up the system class path</A></LI>
   <LI><A href="#samples">Trying out the samples</A></LI>
   <LI><A href="#commandline">Performing your own transformations from the command line</A></LI>
  -<LI><A href="#java-apps">Creating your own XSLT applications</A></LI>
  +<LI><A href="#java-apps">Setting up your own XSLT applications</A></LI>
   </UL>
   <A name="download"><!--anchor--></A>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Downloading what you need</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/vo
id.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   <P>To use Xalan, you need the following:</P>
   <UL>
  -<LI>The JDK or JRE 1.1.6 or later</LI>
  +<LI>The JDK or JRE 1.1.8 or 1.2.2</LI>
   <LI>xalan.jar</LI>
   <LI>xerces.jar</LI>
   </UL>
  -<P>You can get the Sun JDK or JRE from <A href="http://www.java.sun.com">java.sun.com</A>. Download the latest release of Xalan and Xerces-java from <A href="http://xml.apache.org/dist/">xml.apache.org</A>. Check the <A href="readme.html#status">version release notes</A> to verify that you are using the correct version of Xerces. <B>Important</B> You may experience unpredicable difficulties and anomalies if your Xalan and Xerces-Java builds are not in synch. You can use Xalan with some other XML parser, but it is up to you to implement a liaison to that parser. Your liaison class should extend org.apache.xalan.xpath.xml.XMLParserLiaisonDefault and implement org.apache.xalan.xpath.XPathSupport.</P>
  +<P>You can get the Sun JDK or JRE from <A href="http://www.java.sun.com">java.sun.com</A>. Download the latest release of Xalan and Xerces-java from <A href="http://xml.apache.org/dist/">xml.apache.org</A>. Check the <A href="readme.html#status">version release notes</A> to verify that you are using the correct version of Xerces. <B>Important</B> You may experience unpredictable anomalies if your Xalan and Xerces-Java builds are not in synch. You can use Xalan with some other XML parser, but it is up to you to implement a liaison to that parser. Your liaison class should extend org.apache.xalan.xpath.xml.XMLParserLiaisonDefault and implement org.apache.xalan.xpath.XPathSupport.</P>
   <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>You may also download the latest releases of LotusXSL and the XML Parser for Java from <A href="http://www.alphaworks.ibm.com/tech/LotusXSL">alphaWorks</A>. LotusXSL and the XML Parser for Java are Xalan and Xerces-java respectively, along with additional features and with wrappers to support the core API in place on alphaWorks before the first releases of Xalan and Xerces-java on xml.apache.org in November 1999. The alphaWorks LotusXSL release also provides continued support for earlier alphaWorks releases of the XML4J DOM and TXDOM parsers.</I></FONT></TD></TR></TABLE>
   <P>If you plan to run <A href="extensions.html">XSLT extensions</A>. you need bsf.jar and bsfengines.jar, both of which are included in the Xalan distribution. If you plan to run XSLT extensions implemented in JavaScript or another scripting language, you will need one or more additional files as indicated in <A href="extensions.html#supported-lang">extensions language requirements</A>.</P>
   </FONT></TD></TR></TABLE><BR><A name="classpath"><!--anchor--></A>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Setting up the system class path</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resou
rces/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   <P>At the very minimum, you must include xalan.jar and xerces.jar on the system class path. To run the sample applications, include xalansamples.jar To run extensions, include bsf.jar and bsfengines.jar. All these JAR files are distributed with Xalan. For extensions implemented in JavaScript or another scripting language, see <A href="extensions.html#supported-lang">extensions language requirements</A> to identify any additional JAR files you must place on the class path and where you can get them.</P>
  -<P>If you are using JDK or JRE 1.1.x (at least 1.1.7, please), also include classes.zip on the class path.</P>
  +<P>If you are using JDK or JRE 1.1.8, also include classes.zip on the class path.</P>
   </FONT></TD></TR></TABLE><BR><A name="samples"><!--anchor--></A>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Trying out the samples</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.
gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   <P>The Xalan distribution includes a number of basic sample applications. These samples are easy to run, and you can review the source files -- all of which are brief -- to see just how they work.</P>
  @@ -65,7 +69,7 @@
   <LI>Set up your class path (see above), including xalansamples.jar.</LI>
   <LI>Be sure java.exe is on your path.</LI>
   <LI>Go to the samples subdirectory containing the sample (use the DOS shell if you are running Windows).</LI>
  -<LI>Run the sample from the command line.</LI>
  +<LI>Use java.exe to run the sample from the command line.</LI>
   <LI>Examine the application source files.</LI>
   </OL>
   <P>For example, go to the SimpleTransformation subdirectory and issue the following command:</P>
  @@ -86,7 +90,7 @@
   <P>You can start by using your own XML source files and XSL stylesheets with the sample applications, which illustrate a number of the <A href="#usage-patterns">basic usage patterns</A>.</P>
   <P>If you modify a java source file, be sure to compile the class and place it on the system class path. Here are some basic points to keep in mind as you are setting up transformations:</P>
   <UL>
  -<LI>Use one of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html" target="_top">XSLTProcessorFactory class</A> static getProcessor methods to set up an <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A>. <BR><BR>By default, the XSLTProcessor uses the <A href="apidocs/org/apache/xalan/xpath/dtm/DTMLiaison.html" target="_top">DTMLiaison class</A> and the high-performance <A href="dtm.html"> Document Table Model (DTM)</A>&quot;pseudo&quot; DOM parser to process the input.  If your input is a DOM node (rather than a file, character stream, byte stream, or SAX input stream), you must use a &quot;standard&quot; DOM liaison and parser, such as the <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> and the Xerces DOM parser. For an example, see <A href="#dom-in">Processing DOM input</A>.<BR><BR></LI>
  +<LI>Use one of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html" target="_top">XSLTProcessorFactory class</A> static getProcessor methods to set up an <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A>. <BR><BR>By default, the XSLTProcessor uses the <A href="apidocs/org/apache/xalan/xpath/dtm/DTMLiaison.html" target="_top">DTMLiaison class</A> and the high-performance <A href="dtm.html"> Document Table Model (DTM)</A> &quot;pseudo&quot; DOM parser to process the input.  If your input is a DOM node (rather than a file, character stream, byte stream, or SAX input stream), you must use a &quot;standard&quot; DOM liaison and parser, such as the <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> and the Xerces DOM parser. For an example, see <A href="#dom-in">Processing DOM input</A>.<BR><BR></LI>
   <LI>Set up <A href="apidocs/org/apache/xalan/xslt/XSLTInputSource.html" target="_top">XSLTInputSource class</A> objects for the XML input and XSL stylesheet. You can use a file name or URL, character streams, byte streams, or SAX input stream to instantiate an XSLTInputSource object.<BR><BR>
   If the XML document contains a stylesheet Processing Instruction (PI), you do not need to create a separate
   XSLTInputSource object for an XSL stylesheet.<BR><BR></LI>
  @@ -95,7 +99,7 @@
   instance, when you need to find out the output encoding in order to construct the right kind of Writer.
   You must also compile the stylesheet if you are using the XSLTProcessor as a SAX document handler.<BR><BR></LI>
   <LI>Set up an <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A> for the transformation output. You can use a file name or URL, character stream, byte stream, or SAX document handler to instantiate an XSLTOutputTarget object.<BR><BR></LI>
  -<LI>Use the XSLTProcessor (or, in some cases, the <A href="StylesheetRootDoc.html"></A>) process method to perform the transformation.<BR><BR>
  +<LI>Use the XSLTProcessor (or, in some cases, the <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html" target="_top">StylesheetRoot class</A>) process method to perform the transformation.<BR><BR>
   Xalan is thread-safe for one instance per thread. If you are using the same instance of XSLTProcessor to perform
   more than one transformation, call the reset method between transformations.</LI>
   </UL>
  
  
  
  1.14      +21 -9     xml-site/targets/xalan/overview.html
  
  Index: overview.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/overview.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- overview.html	2000/02/17 17:53:06	1.13
  +++ overview.html	2000/02/25 22:37:11	1.14
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -50,9 +54,10 @@
       to speed with XSLT</A>.</P> 
       <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>XSL also includes a formatting vocabulary, which is still under design and is not part of Xalan. 
       For more information, see <A href="http://www.w3.org/TR/xsl/">W3C XSL Working Draft</A> and the <A href="http://xml.apache.org/fop">Apache XML FOP (Formatting Objects Project)</A>.</I></FONT></TD></TR></TABLE>
  -    <P>You use XSLT to compose stylesheets (themselves XML documents) for transforming XML documents into other XML
  -    documents, HTML documents, or other document types. In structural terms, an XSLT stylesheet specifies the transformation
  -    of one tree of nodes (the XML input) into another tree of nodes (the output or transformation result).</P>
  +    <P>You use the XSLT language to compose XSL stylesheets. Itself an XML document, an XSL stylesheet contains instructions for
  +     transforming a range of XML documents into other XML documents, HTML documents, or other document types. In structural
  +     terms, an XSLT stylesheet specifies the transformation of one tree of nodes (the XML input) into another tree of nodes 
  +     (the output or transformation result).</P>
       <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>The XSLT stylesheet may include cascading style sheets (CSS) in the result.</I></FONT></TD></TR></TABLE> 
       <P>In the following example, the foo.xsl stylesheet is used to transform foo.xml into foo.out:</P>
       <P>foo.xml:</P>
  @@ -69,11 +74,12 @@
   <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>&lt;out&gt;Hello&lt;/out&gt;</PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="46
2"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
   <P>By default, Xalan uses a high-performance <A href="dtm.html">Document Table Model (DTM)</A> to parse the input -- XML documents and XSL stylesheets, but it can be set to use the Xerces-Java XML parser, and it can be adapted to work with other DOM-producing mechanisms and SAX document handlers. The input may appear in the form of a file, a character stream, a byte stream, a DOM, or a SAX input stream.</P>
   <P>Xalan performs the transformations specified in the XSL stylesheet and produces a document file, a character
  - stream, a byte stream, a DOM, or a series of SAX events, as you specify when you set up the transformation.</P>
  + stream, a byte stream, a <A href="http://www.w3.org/TR/PR-DOM-Level-1" target="_top">DOM</A>, or a series of <A href="http://www.megginson.com/SAX/sax.html" target="_top">SAX</A> events, as you specify when you set up the transformation.</P>
         </FONT></TD></TR></TABLE><BR><A name="features"><!--anchor--></A>
      	  <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Xalan Features</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gi
f" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   	    <UL> 
  -		    <LI>Implements the <A href="http://www.w3.org/TR/1999/REC-xslt-19991116" target="_top">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</A>.</LI> 
  +		    <LI>Implements the <A href="http://www.w3.org/TR/1999/REC-xslt-19991116" target="_top">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</A></LI> 
  +        <LI>Incorporates the <A href="" target="_top"></A></LI>
       	  <LI>Uses <A href="http://xml.apache.org/xerces-j/index.html">Xerces-Java</A> 
           (and <A href="http://www.alphaworks.ibm.com/tech/xml4j">the alphaWorks XML Parser for Java</A>)</LI>
       	  <LI>Can interface to a SAX document handler or to any XML parser that produces Java DOM Trees</LI>
  @@ -81,7 +87,7 @@
           <LI>May be run from the <A href="commandline.html">command line</A></LI>
       	  <LI>Includes an <A href="getstarted.html#applet">applet wrapper</A></LI>
           <LI>May be used in a <A href="samples.html#servlet">servlet</A> to transform XML documents into HTML
  -         and serve the results to clients.</LI>
  +         and serve the results to clients</LI>
           <LI>Supports <A href="extensions.html">Java and scripting language extensions</A></LI>
           <LI>Provides <A href="extensions.html#redirect">an extension to support the production of multiple 
           output documents in a single operation</A></LI>
  @@ -111,8 +117,9 @@
        <LI>OASIS (the Organization for the Advancement of Structured Information Standards): 
        <A href="http://www.oasis-open.org/cover/xsl.html">Extensible Stylesheet Language (XSL)</A> by Robin
        Cover</LI>
  +     <LI>Donald Ball's <A href="http://www.webslingerZ.com/balld/xsl/designer_manual.xml">A Guide to XML and XSL for Designers</A></LI>
       </UL>
  -    <P>When you come across other useful introductionary or background materials, please email <A href="mailto:donald_leslie@lotus.com">Don Leslie</A>, so he can add them to this list.</P>
  +    <P>When you come across other useful introductory or background materials, please email <A href="mailto:donald_leslie@lotus.com">Don Leslie</A>, so he can add them to this list.</P>
        
       </FONT></TD></TR></TABLE><BR><A name="glossary"><!--anchor--></A>
          <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Glossary</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vs
pace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
  @@ -120,6 +127,10 @@
           <DT>XSL Instruction</DT>
           <DD>Any tag with an XSL namespace prefix.<BR><BR></DD>
           
  +        <DT>Template</DT>
  +        <DD>An element, usually with child elements, that specifies a &quot;rule&quot; or set of 
  +        instructions to perform when a particular kind of node is encountered in the source tree.<BR><BR></DD>
  +                
           <DT>XSL Template Instruction</DT>
           <DD>Any tag with an XSL namespace prefix
               that occurs inside an xsl:template element.<BR><BR></DD>
  @@ -136,8 +147,9 @@
           <DT>Stylesheet Tree</DT>
           <DD>The stylesheet tree produced from the XSL file.<BR><BR></DD>
           
  -        <DT>Pattern List</DT>
  -        <DD>A parsed query or match pattern.<BR><BR></DD>
  +        <DT>Match Pattern</DT>
  +        <DD>The part of a template that defines the kind(s) of nodes to which the template applies.<BR><BR></DD>
  +
         </DL>
         <P>For more definitions of XSLT terminology, see Dave Lawson's 
         <A href="http://freespace.virgin.net/b.pawson/xsl/xslvocab.html#top">XSLT Terminology
  
  
  
  1.10      +6 -2      xml-site/targets/xalan/readme.html
  
  Index: readme.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/readme.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- readme.html	2000/02/17 17:53:06	1.9
  +++ readme.html	2000/02/25 22:37:11	1.10
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -42,7 +46,7 @@
    </UL>
     <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Status</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0
" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
      <UL>
  -    <LI><A href="#status">Version of Xerces-Java to use</A></LI>
  +    <LI><A href="#status">Version of Xerces to use</A></LI>
       <LI><A href="#done">Bug fixes</A></LI>
       <LI><A href="#bugs">Outstanding bugs</A></LI>
      </UL>
  @@ -174,7 +178,7 @@
          <LI>To build doc in a build/docs subdirectory, run StyleBook from the xdocs directory as follows:<BR><BR>
   <CODE><FONT face="courier, monospaced">java org.apache.stylebook.StyleBook &quot;targetDirectory=../build/docs/&quot; sources/xalanLocal.xml style</FONT></CODE>
          <BR><BR></LI>
  -       <LI>To build the html source files that javadoc needs for top-level and package-level documentation, run
  +       <LI>To build the HTML source files that javadoc needs for top-level and package-level documentation, run
           StyleBook from the xdocs directory as follows:<BR><BR>
           <CODE><FONT face="courier, monospaced">java org.apache.stylebook.StyleBook &quot;loaderConfig=sbk:/style/loaderjdoc.xml&quot; targetDirectory=../src sources/javadocPackages.xml style</FONT></CODE><BR><BR></LI>
           <LI>Before you run javadoc, make sure the following directory structure exists under the Xalan root
  
  
  
  1.2       +10 -5     xml-site/targets/xalan/samples.html
  
  Index: samples.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/samples.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- samples.html	2000/02/17 17:53:06	1.1
  +++ samples.html	2000/02/25 22:37:12	1.2
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -42,7 +46,7 @@
   <LI><A href="#xpath">ApplyXPath</A></LI>
   <LI><A href="#pipe">Pipe (SAX)</A></LI>
   <LI><A href="#extensions">Extensions</A></LI>
  -<LI><A href="#applet">Applet</A></LI>
  +<LI><A href="#AppletXMLtoHTML">Applet</A></LI>
   <LI><A href="#servlet">Servlet</A></LI>
   </UL>       
   	  <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Samples to help you get started</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="res
ources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
  @@ -87,13 +91,14 @@
          and prints the output to System.out. The stylesheet parameter appears as a text node in the output.</P>
       <P>Run this sample from the UseStylesheetParam subdirectory with</P> 
       <P><CODE><FONT face="courier, monospaced">java UseStylesheetParam <I>param</I></FONT></CODE></P>
  -    <P>where <I>param</I> is the stylesheet parameter.</P>  
  +    <P>where <I>param</I> is the stylesheet parameter (a string of your choice).</P>  
       </FONT></TD></TR></TABLE><BR><A name="xpath"><!--anchor--></A>
       <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>ApplyXPath</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
       <P>What it does: The ApplyXPath class executes an XPath expression against an XML document and returns
        information about the route it takes and the nodes (if any) it finds.</P>
        <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I>You can use this sample as an aid when you want to find out what a given XPath expression returns from a
  -     given XML file. Keep in mind that the context node for the XPath expression is the document root.</I></FONT></TD></TR></TABLE>
  +     given XML file. Keep in mind that the context node (base point of evaluation) for the XPath expression is the document
  +     root.</I></FONT></TD></TR></TABLE>
       <P>Run this sample from the ApplyXPath subdirectory with</P> 
       <P><CODE><FONT face="courier, monospaced">java ApplyXPath <I>XMLFile XPathExpression</I></FONT></CODE></P>
       <P>where <I>XMLFile</I> is an XML source file and <I>XPathExpression</I> is an XPath expression to
  @@ -103,7 +108,7 @@
       <P>and</P>
       <P><CODE><FONT face="courier, monospaced">java ApplyXPath foo.xml /doc/name/@first</FONT></CODE></P>
       </FONT></TD></TR></TABLE><BR><A name="pipe"><!--anchor--></A>
  -    <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Pipe</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0
" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
  +    <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Pipe (SAX)</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
       <P>What it does: The Pipe class uses the output of the first transformation as input to a second
        transformation.</P>
        <P>The first transformation produces a sequence of SAX events which the second transformation processes with
  @@ -119,7 +124,7 @@
        extensions implemented in JavaScript, and two of the samples use extensions implemented in Java. All of
        the samples are documented in <A href="extensions.html">Extensions</A>.</P>
        <P>To run these examples, you must place bsf.jar and bsfengines.jar (distributed with Xalan), and js.jar
  -     (available from http://www.mozilla.org/rhino) on the class path. You do not need js.jar
  +     (available from <A href="http://www.mozilla.org/rhino">http://www.mozilla.org/rhino</A>) on the class path. You do not need js.jar
        on the class path for the samples that use Java extensions. </P>
        <P>Use java.org.apache.xalan.xslt.Process, the Xalan command-line utility, to run these samples from
         the <A href="commandline.html">command line</A>. The command line must include an -in flag with the 
  
  
  
  1.3       +13 -4     xml-site/targets/xalan/usagepatterns.html
  
  Index: usagepatterns.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/usagepatterns.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- usagepatterns.html	2000/02/24 20:27:31	1.2
  +++ usagepatterns.html	2000/02/25 22:37:13	1.3
  @@ -20,6 +20,10 @@
               
     <IMG alt="Usage Patterns" border="0" height="12" hspace="0" src="graphics/usagepatterns-label-1.jpg" vspace="0" width="120"><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  @@ -54,14 +58,14 @@
   
     <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Introduction</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vsp
ace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">  
   <P>Xalan takes as primary input an XML source document and an XSL stylesheet, both represented by instances of the <A href="apidocs/org/apache/xalan/xslt/XSLTInputSource.html" target="_top">XSLTInputSource class</A>. You can use a URL or file, a character stream, a byte stream, a DOM tree, or a SAX input source to create an XSLTInputSource object. The stylesheet may also take the form of a compiled stylesheet (an instance of the <A href="apidocs/org/apache/xalan/xslt/StylesheetRoot.html" target="_top">StylesheetRoot class</A>. If the XML document contains a stylesheet Processing Instruction (PI), a separate stylesheet is not required.</P>
  -<P>Xalan uses an implementation of the <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaison.html" target="_top">XMLParserLiaison interface</A> to interact with an XML parser and sends the output to <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A>. Unless your ar processing a DOM, you probably want to use the default <A href="dtm.html">Document Table Model (DTM)</A> liaison and XML parser. When you process DOM input, you can use the <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> along with the Xerces-Java XML parser.</P>
  +<P>Xalan uses an implementation of the <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaison.html" target="_top">XMLParserLiaison interface</A> to interact with an XML parser and sends the output to <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A>. Unless your are processing a DOM, you probably want to use the default <A href="dtm.html">Document Table Model (DTM)</A> liaison and XML parser. When you process DOM input, you can use the <A href="apidocs/org/apache/xalan/xpath/xdom/XercesLiaison.html" target="_top">XercesLiaison class</A> along with the Xerces-Java XML parser.</P>
   <P>The XSLT and XPath engines are independent of any given DOM or XML implementation. All parser-dependent
   calls are funneled through the XMLParserLiaison.</P>
   <P>For detailed API documentation (javadoc), see <A href="apidocs/index.html" target="_top">API Documentation</A>. For an overview of the
   command-line utility, see <A href="commandline.html">Command-Line Utility</A>.</P>     
   </FONT></TD></TR></TABLE><BR>
   <A name="files"><!--anchor--></A>
  -<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using XML source, XSL stylesheet, and output files</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hsp
ace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
  +<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using a stylesheet file to transform an XML source file into an output file</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG 
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   <P>Use an XML file and an XSL file to instantiate XSLTInput objects, create a processor with the default DTM liaison, and send the transformation output to an output file. For example:</P>
   <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>public static void Transform(String xmlSourceURL, String xslURL, String outputURL)
     throws java.io.IOException, 
  @@ -99,7 +103,7 @@
   </FONT></TD></TR></TABLE><BR><A name="params"><!--anchor--></A>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Setting stylesheet parameters</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resource
s/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   <P>An XSL stylesheet can include parameters that get set at run time when a transformation takes place. When we generate the HTML documents that make up the Xalan doc set, for example, we send the stylesheet an id parameter along with each XML source document. The id identifies that document and enables the stylesheet to integrate it into the overall doc set.</P>
  -<P>To set a stylesheet parameter, use the XSLTProcessor setStylesheetParam(String paramName, String paramExpr) method. paramExpr is an XPath expression, so if the parameter is a String, enclose it in single quotes to make it a String expression.</P>
  +<P>To set a stylesheet parameter, use the XSLTProcessor setStylesheetParam(String key, String expression) method, where key is the parameter name and expression is an XPath expression. If the parameter is a String, enclose it in single quotes to make it a String expression.</P>
   <P>You can also use setStylesheetParam(String key, XObject value). This option is useful when you are working with the XPath API. For example, you could use the XObject returned by an Xpath function to set a parameter.</P>
   <P>From the <A href="commandline.html">command line</A>, include a -param argument. For example:</P>
   <P><CODE><FONT face="courier, monospaced">java org.apache.xalan.xsltProcess -in foo.xml -xsl foo.xsl -param 'boo'</FONT></CODE></P>
  @@ -126,7 +130,7 @@
   <P>If you want to use the XSLTProcessor as a SAX document handler, you must provide the processor a compiled stylesheet. See <A href="#sax">Generating and Responding to SAX events</A>.</P>
   </FONT></TD></TR></TABLE><BR><A name="dom-in"><!--anchor--></A>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Processing DOM input</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gi
f" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
  -<P>The XML source and XSL stylesheet for a transformation may appear in the form of a DOM Node. To perform transformations with DOM input, you cannot use the default high-performance DTM liaison and parser. <A href="dtm.html">DTM (Document Table model)</A> uses a table of integers to represent a DOM, thus avoiding much of the overhead of creating and manipulating actual DOM nodes, which often involve a large number of Java objects. If you are processing DOM input, you must use a DOM parser, such as the Xerces DOM parser. When you create the XSLTProcessor for the transformation, you must specify that it is to use the Liaison for such a DOM parser.</P>
  +<P>The XML source and XSL stylesheet for a transformation may appear in the form of a DOM Node. To perform transformations with DOM input, you cannot use the default high-performance DTM liaison and parser. <A href="dtm.html">DTM (Document Table Model)</A> uses a table of integers to represent a DOM, thus avoiding much of the overhead of creating and manipulating actual DOM nodes, which often involve a large number of Java objects. If you are processing DOM input, you must use a DOM parser, such as the Xerces DOM parser. When you create the XSLTProcessor for the transformation, you must specify that it is to use the Liaison for such a DOM parser.</P>
   <P>The following code fragments illustrate the procedure for working with DOM input:</P>
   <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>import org.apache.xerces.parsers.DOMParser;
   import org.w3c.dom.Document;
  @@ -247,6 +251,7 @@
   <LI>Specify the XML source document and XSL stylesheet.<BR><BR>
   You can use the DocumentURL and StyleURL PARAM tags or the <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#setDocumentURL(java.lang.String)" target="_top">XSLTProcessorApplet setDocumentURL() method</A> and <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#setStyleURL(java.lang.String)" target="_top">XSLTProcessorApplet setStyleURL() method</A>. If the XML document contains a stylesheet Processing Instruction (PI), you do not need to specify an XSL stylesheet.<BR><BR></LI>
   <LI>Call the <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#transformToHtml(java.lang.String, java.lang.String)" target="_top">XSLTProcessorApplet transformHTML() method</A> which performs the transformation and returns the new document as a String.</LI></OL>
  +<P>For an example, see the <A href="samples/applet/readme.html">sample applet readme</A>.</P>
   </FONT></TD></TR></TABLE><BR><A name="servlet"><!--anchor--></A>
   <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using Xalan in a servlet</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/voi
d.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
   <P>You can set up a servlet to use Xalan to respond to requests for XML documents by transforming those documents into HTML and serving them to clients. For a sample of how this might be done, see <A href="samples.html#servlet">sample servlet</A>.</P>
  @@ -271,7 +276,11 @@
   		  <LI>The <A href="apidocs/org/apache/xalan/xslt/trace/GenerateEvent.html" target="_top">GenerateEvent class</A> is an event that is 
   		  passed to the TraceListener.generated() function. It is called after an event 
   		  occurs to create something in the result tree.<BR><BR></LI>
  +      <LI>The <A href="apidocs/org/apache/xalan/xslt/trace/SelectionEvent.html" target="_top">SelectionEvent class</A> is an event triggered by the selection of a give
  +      style tree node.</LI>
   		</UL>
  +    <P>The <A href="commandline.html">command-line utility</A> uses the debugger interface when you include one or more of the
  +     following switches: -TT, -TG, -TS, -TTC.</P>
       <P>Example:</P>
       <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>
   import org.apache.xalan.xslt.XSLTProcessor;
  
  
  
  1.9       +4 -0      xml-site/targets/xalan/xslt4c.html
  
  Index: xslt4c.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/xalan/xslt4c.html,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- xslt4c.html	2000/02/17 17:53:05	1.8
  +++ xslt4c.html	2000/02/25 22:37:13	1.9
  @@ -20,6 +20,10 @@
               
     <A href="usagepatterns.html" onMouseOut="rolloverOff('side-usagepatterns');" onMouseOver="rolloverOn('side-usagepatterns');"><IMG alt="Usage Patterns" border="0" height="12" hspace="0" name="side-usagepatterns" onLoad="rolloverLoad('side-usagepatterns','graphics/usagepatterns-label-2.jpg','graphics/usagepatterns-label-3.jpg');" src="graphics/usagepatterns-label-3.jpg" vspace="0" width="120"></A><BR>
   
  +  <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
  +  
  +  <A href="apidocs/index.html" onMouseOut="rolloverOff('side-ext-24');" onMouseOver="rolloverOn('side-ext-24');"><IMG alt="Java API" border="0" height="12" hspace="0" name="side-ext-24" onLoad="rolloverLoad('side-ext-24','graphics/ext-24-label-2.jpg','graphics/ext-24-label-3.jpg');" src="graphics/ext-24-label-3.jpg" vspace="0" width="120"></A><BR>
  +   
     <IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>        
               
     <A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
  
  
  

Mime
View raw message