You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by ga...@locus.apache.org on 2000/12/22 19:06:04 UTC

cvs commit: xml-xalan/java/xdocs/sources/xalan extensions.xml overview.xml

garyp       00/12/22 10:06:04

  Modified:    java/xdocs/sources/xalan extensions.xml overview.xml
  Log:
  Add paragraph about XSLT extensions in general per suggestion from John Gentilin <jo...@eyecatching.com>.
  Updated url for Dave Pawson's FAQ.
  
  Revision  Changes    Path
  1.9       +3 -1      xml-xalan/java/xdocs/sources/xalan/extensions.xml
  
  Index: extensions.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/extensions.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- extensions.xml	2000/12/21 16:46:07	1.8
  +++ extensions.xml	2000/12/22 18:06:03	1.9
  @@ -23,7 +23,9 @@
   
   <p><em>Extension elements</em>  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 &xslt4j; to redirect portions of your transformation output to one or more files. Extension elements may contain attributes, text nodes, other elements, basically any valid XML. Extension elements may perform quite sophisticated actions, given that the extension routine (the implementation) has direct access to the XSLT 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 tree.</p>
   
  -<p><em>Extension functions</em>You can think of extension functions as extending the core library of functions that XPath provides. An extension function passes arguments to the extension implementation and returns a value. You can use extension functions to return values that XSLT can interact with directly (node-set, result tree fragment, string, boolean, and number) as well as values (of any type) that you pass in turn to other extension functions. Extension functions written in Java can also access certain items in the XSLT execution environment through an <jump href="apidocs/org/apache/xalan/extensions/ExpressionContext.html">ExpressionContext</jump> interface.</p>
  +<p><em>Extension functions</em>  You can think of extension functions as extending the core library of functions that XPath provides. An extension function passes arguments to the extension implementation and returns a value. You can use extension functions to return values that XSLT can interact with directly (node-set, result tree fragment, string, boolean, and number) as well as values (of any type) that you pass in turn to other extension functions. Extension functions written in Java can also access certain items in the XSLT execution environment through an <jump href="apidocs/org/apache/xalan/extensions/ExpressionContext.html">ExpressionContext</jump> interface.</p>
  +
  +<p>XSLT extensions are specified in the <jump href="http://www.w3.org/TR/xslt#extension">XSLT Recommendation</jump>.  This document focuses on the &xslt4j; implementation of those requirements, not on XSLT extensions in general. For additional information on extensions, consult the Recommendation or the other resources listed in <link idref="overview" anchor="uptospeed">Getting up to speed with XSLT</link>.</p>
   </s2><anchor name="supported-lang"/>
   <s2 title="Supported languages">
   <p>Extensions written in Java are directly supported by &xslt4j;.  For extensions written in languages other than Java, &xslt4j; uses the <jump href="http://www.alphaworks.ibm.com/tech/bsf">Bean Scripting Framework (BSF)</jump>, an architecture for incorporating scripting into Java applications and applets. BSF allows an application to take advantage of scripting while being independent of any specific scripting language. To date, we have tested extensions implemented in JavaScript. Other languages with BSF support appear in the table below.</p>
  
  
  
  1.8       +1 -1      xml-xalan/java/xdocs/sources/xalan/overview.xml
  
  Index: overview.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/overview.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- overview.xml	2000/12/07 17:05:56	1.7
  +++ overview.xml	2000/12/22 18:06:03	1.8
  @@ -137,7 +137,7 @@
            Transformation Using XSLT and XPath</jump><br/><br/></li>
           <li>The Mulberry <jump href="http://www.mulberrytech.com/xsl/xsl-list/">XSL-List -- Open Forum on XSL</jump> 
           (of interest to XSL users at all levels)<br/><br/></li>
  -        <li>Dave Pawson's <jump href="http://www.dpawson.freeserve.co.uk/">XSL Frequently Asked
  +        <li>Dave Pawson's <jump href="http://www.dpawson.co.uk/xsl/xslfaq.html">XSL Frequently Asked
            Questions</jump><br/><br/></li>
           <li>Objects by Design's <jump href="http://www.objectsbydesign.com/projects/xmi_to_html.html">Transforming XMI to
            HTML</jump> (oriented towards XMI, "an XML-based, stream representation of a UML model," but also covers "generic"