You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@locus.apache.org on 2000/02/28 17:22:24 UTC
cvs commit: xml-xalan/xdocs/sources/xalan overview.xml
dleslie 00/02/28 08:22:24
Modified: xdocs/sources/xalan overview.xml
Log:
More fixes per Emily's comments.
Revision Changes Path
1.6 +13 -11 xml-xalan/xdocs/sources/xalan/overview.xml
Index: overview.xml
===================================================================
RCS file: /home/cvs/xml-xalan/xdocs/sources/xalan/overview.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- overview.xml 2000/02/24 22:21:59 1.5
+++ overview.xml 2000/02/28 16:22:24 1.6
@@ -72,14 +72,14 @@
XML Path language (XPath), a language for addressing parts of XML documents. For links to background materials,
discussion groups, frequently asked questions, and tutorials on XSLT, see <link anchor="uptospeed">Getting up
to speed with XSLT</link>.</p>
- <note>XSL also includes a formatting vocabulary, which is still under design and is not part of &xslt4j;.
+ <note>XSL also includes a vocabulary for formatting documents, which is still under design and is not part of &xslt4j;.
For more information, see <jump href="http://www.w3.org/TR/xsl/">W3C XSL Working Draft</jump> and the <jump
href="http://xml.apache.org/fop">Apache XML FOP (Formatting Objects Project)</jump>.</note>
- <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
+ <p>You use the XSLT language to compose XSL stylesheets. An XSL stylesheet contains instructions for
+ transforming XML documents from one document type into another document type (XML, HTML, or other). In structural
+ terms, an XSL stylesheet specifies the transformation of one tree of nodes (the XML input) into another tree of nodes
(the output or transformation result).</p>
- <note>The XSLT stylesheet may include cascading style sheets (CSS) in the result.</note>
+ <note>The XSL stylesheet may include cascading style sheets (CSS) in the result.</note>
<p>In the following example, the foo.xsl stylesheet is used to transform foo.xml into foo.out:</p>
<p>foo.xml:</p>
<source><?xml version="1.0"?>
@@ -93,16 +93,17 @@
</xsl:stylesheet></source>
<p>foo.out:</p>
<source><out>Hello</out></source>
-<p>By default, &xslt4j; uses a high-performance <link idref="dtm">Document Table Model (DTM)</link> to parse the input -- XML documents and XSL stylesheets, but it can be set to use the &xml4j; 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>By default, &xslt4j; uses a high-performance <link idref="dtm">Document Table Model (DTM)</link> to parse XML documents and XSL stylesheets. It can be set to use the &xml4j; 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>&xslt4j; performs the transformations specified in the XSL stylesheet and produces a document file, a character
stream, a byte stream, a <resource-ref idref="DOM"/>, or a series of <resource-ref idref="SAX"/> events, as you specify when you set up the transformation.</p>
</s2><anchor name="features"/>
<s2 title="&xslt4j; Features">
<ul>
<li>Implements the <resource-ref idref="xsl-draft-used"/></li>
- <li>Incorporates the <resource-ref idref="xpath"/></li>
- <li>Uses <jump href="http://xml.apache.org/xerces-j/index.html">&xml4j;</jump>
- (and <jump href="http://www.alphaworks.ibm.com/tech/xml4j">the alphaWorks XML Parser for Java</jump>)</li>
+ <li>Incorporates the <resource-ref idref="XPath"/></li>
+ <li>Optionally uses the high-performance DTM (Document Table Model) to avoid the object overhead involved in the
+ construction and manipulation of DOM trees</li>
+ <li>Interfaces directly to the <jump href="http://xml.apache.org/xerces-j/index.html">&xml4j; XML parser</jump></li>
<li>Can interface to a SAX document handler or to any XML parser that produces Java DOM Trees</li>
<li>Can output to SAX or DOM</li>
<li>May be run from the <link idref="commandline">command line</link></li>
@@ -110,7 +111,7 @@
<li>May be used in a <link idref="samples" anchor="servlet">servlet</link> to transform XML documents into HTML
and serve the results to clients</li>
<li>Supports <link idref="extensions">Java and scripting language extensions</link></li>
- <li>Provides <link idref="extensions" anchor="redirect">an extension to support the production of multiple
+ <li>Provides <link idref="extensions" anchor="redirect">a redirect extension to support the production of multiple
output documents in a single operation</link></li>
</ul>
</s2><anchor name="towork"/>
@@ -132,7 +133,8 @@
<li>Dave Pawson's <jump href="http://freespace.virgin.net/b.pawson/xsl/index.html#top">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><br/><br/></li>
+ HTML</jump> (oriented towards XMI, "an XML-based, stream representation of a UML model," but also covers "generic"
+ XML transformations)<br/><br/></li>
<li>Nic Miloslav's <jump href="http://zvon.vscht.cz/HTMLonly/XSLTutorial/Books/Book1/index.html">XSL Tutorial</jump>
<br/><br/></li>
<li>OASIS (the Organization for the Advancement of Structured Information Standards):