You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by sh...@apache.org on 2012/09/09 07:54:46 UTC
svn commit: r1382403 [6/11] - in
/xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources: ./
xalan-apache-org/ xalan-c-graphic/ xalan-c/ xalan/
Added: xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/index.xml
URL: http://svn.apache.org/viewvc/xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/index.xml?rev=1382403&view=auto
==============================================================================
--- xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/index.xml (added)
+++ xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/index.xml Sun Sep 9 05:54:44 2012
@@ -0,0 +1,375 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
+<!--
+ * Copyright 1999-2012 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+<!-- $Id: index.xml 478654 2006-11-23 19:52:02Z minchau $ -->
+<s1 title="&xslt4j-current;">
+<ul>
+ <li><link anchor="whatisit">What is it?</link></li>
+ <li><link anchor="current">How about this release?</link></li>
+ <li><link anchor="moreinfo">For more information...</link></li>
+ <li><link anchor="license">Apache License Version 2.0</link></li>
+ <li><link anchor="notice">Notice file</link></li>
+ <li><link anchor="license1.1">Apache License Version 1.1</link></li>
+</ul>
+
+<p>The current stable version for download is 2.7.1</p>
+
+<p>&xslt4j-current; is still under development and is available from
+the subversion repository at <jump href="http://svn.apache.org/repos/asf/xalan/java/trunk">
+http://svn.apache.org/repos/asf/xalan/java/trunk</jump>.</p>
+
+<anchor name="whatisit"/>
+<s2 title="What is it?">
+ <p>&xslt4j; is an XSLT processor for transforming XML documents into
+ HTML, text, or other XML document types. It implements <resource-ref idref="xslt"/> and
+ <resource-ref idref="xpath"/> and can be used from the command line, in an applet or a
+ servlet, or as a module in other program.</p>
+ <p>&xslt4j; implements the javax.xml.transform interface in
+ <resource-ref idref="jaxp13-longname-withacronym"/>. This interface provides a modular
+ framework and a standard API for performing XML transformations, and utilizes system
+ properties to determine which Transformer and which XML parser to use.</p>
+ <p>&xslt4j; also implements the javax.xml.xpath interface in &jaxp13-short;, which provides an
+ object-model neutral API for evaluation of XPath expressions and access to the evaluation
+ environment.</p>
+ <p>&xslt4j; also builds on <resource-ref idref="sax2"/> and <resource-ref idref="dom3"/>.</p>
+
+ <p>For more information, see <link idref="readme">the release notes</link>.</p>
+ <note>&xslt4j; version 1 is no longer supported and no longer available from xml.apache.org.</note>
+</s2>
+
+<anchor name="current"/>
+<s2 title="How about this release?">
+ <p>This release includes new features as well as a number of bug fixes. See the
+ <link idref="whatsnew">What's New</link> and <link idref="readme" anchor="done">Release
+ Notes</link> for more details.</p>
+ <p>&xslt4j-current; works with &xml4j;, and the distribution includes xercesImpl.jar from &xml4j-used;.</p>
+ <p>The &xslt4j; implementation is in xalan.jar and serializer.jar.
+ The SAX, DOM, and &jaxp13-short; interfaces are in xml-apis.jar.</p>
+</s2>
+
+<anchor name="moreinfo"/>
+<s2 title="For more information...">
+ <p>For more information, go to <link idref="overview">&xslt4j; Overview</link>,
+ <link idref="downloads">&xslt4j; Downloads</link>, <link idref="getstarted">Getting Started
+ with Interpretive Processing</link> and <link idref="xsltc_usage">Getting Started with &xslt4jc-short;</link>.
+ All of the &xslt4j; documentation on this website is included in the &xslt4j; download, as are a number of
+ <link idref="samples">Samples</link> to help you start using &xslt4j; to transform XML documents.</p>
+</s2>
+
+<anchor name="license"/>
+<s2 title="Apache License Version 2.0">
+<p>The Apache Software License Version 2.0 applies to all releases of Xalan-Java starting with
+Version 2.6.0. A copy of this license is included in the distribution.</p>
+<source>
+
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+</source>
+</s2>
+
+<anchor name="notice"/>
+<s2 title="NOTICE file">
+<p>A NOTICE file that accompanies The Apache Software License Version 2.0 is also included
+in the Xalan-Java distribution..</p>
+<source>
+ ======================================================================================
+ == NOTICE file corresponding to the section 4d of the Apache License, Version 2.0, ==
+ == in this case for the Apache Xalan distribution. ==
+ ======================================================================================
+
+ This product includes software developed by
+ The Apache Software Foundation (http://www.apache.org/).
+
+ Portions of this software was originally based on the following:
+
+ - software copyright (c) 1999-2002, Lotus Development Corporation., http://www.lotus.com.
+ - software copyright (c) 2001-2002, Sun Microsystems., http://www.sun.com.
+ - software copyright (c) 2003, IBM Corporation., http://www.ibm.com.
+ - voluntary contributions made by Ovidiu Predescu (ovidiu@cup.hp.com) on behalf of the
+ Apache Software Foundation and was originally developed at Hewlett Packard Company.
+</source>
+</s2>
+
+<anchor name="license1.1"/>
+<s2 title="Apache License Version 1.1">
+<p>The Apache Software License, Version 1.1, applies to all versions up to and including Xalan Java 2.5.2.</p>
+<source>
+/*
+ * The Apache Software License, Version 1.1
+ *
+ * Copyright (c) 1999-2012 The Apache Software Foundation. All rights
+ * reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * 3. The end-user documentation included with the redistribution,
+ * if any, must include the following acknowledgment:
+ * "This product includes software developed by the
+ * Apache Software Foundation (http://www.apache.org/)."
+ * Alternately, this acknowledgment may appear in the software itself,
+ * if and wherever such third-party acknowledgments normally appear.
+ *
+ * 4. The names "Xalan" and "Apache Software Foundation" must
+ * not be used to endorse or promote products derived from this
+ * software without prior written permission. For written
+ * permission, please contact apache@apache.org.
+ *
+ * 5. Products derived from this software may not be called "Apache",
+ * nor may "Apache" appear in their name, without prior written
+ * permission of the Apache Software Foundation.
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation and was
+ * originally based on software copyright (c) 1999, Lotus
+ * Development Corporation., http://www.lotus.com. For more
+ * information on the Apache Software Foundation, please see
+ * http://www.apache.org/.
+ */
+
+</source>
+</s2>
+
+<s2 title="Other licenses">
+ <p>For the licences that apply to the JARs other than xalan.jar, see the licenses and
+ associated readme files in the root directory of this distribution.</p>
+</s2>
+</s1>
Added: xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/overview.xml
URL: http://svn.apache.org/viewvc/xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/overview.xml?rev=1382403&view=auto
==============================================================================
--- xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/overview.xml (added)
+++ xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/overview.xml Sun Sep 9 05:54:44 2012
@@ -0,0 +1,188 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
+
+<!--
+ * Copyright 1999-2012 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+<!-- $Id: overview.xml 338218 2005-07-19 17:38:45Z mcnamara $ -->
+
+<s1 title="&xslt4j; Overview">
+<ul>
+<li><link anchor="intro">Introduction</link></li>
+<li><link anchor="features">&xslt4j; Features</link></li>
+<li><link anchor="towork">Getting to work with &xslt4j;</link></li>
+<li><link anchor="uptospeed">Getting up to speed with XSLT</link></li>
+<li><link anchor="glossary">Glossary</link></li>
+</ul>
+<anchor name="intro"/>
+<s2 title="Introduction">
+<p>&xslt4j; fully implements <resource-ref idref="xslt"/>
+ and the <resource-ref idref="xpath"/>. XSLT is the first part of the XSL stylesheet language for
+ XML. It includes the XSL Transformation vocabulary and 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 vocabulary for formatting documents, which is not part of &xslt4j;.
+ For more information, see <resource-ref idref="xsl"/> and the <jump
+ href="http://xmlgraphics.apache.org/fop">Apache XML FOP (Formatting Objects Project)</jump>.</note>
+<p>XSL stylesheets are written in the XSLT language. An XSL stylesheet contains instructions
+ for transforming XML documents into XML, HTML, XHTML or plain text. 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 XSL stylesheet may generate and refer to cascading style sheets (<jump
+ href="http://www.w3.org/Style/CSS/">CSS</jump>) as part of its output.</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"?>
+<doc>Hello</doc></source>
+ <p>foo.xsl:</p>
+ <source><?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<xsl:template match="doc">
+<out><xsl:value-of select="."/></out>
+</xsl:template>
+</xsl:stylesheet></source>
+<p>foo.out:</p>
+<source><out>Hello</out></source>
+<p>By default, &xslt4j; uses &xml4j;, but it may be configured with system properties to work with
+ other XML parsers (see <link idref="usagepatterns" anchor="plug">Plugging in a Transformer and
+ XML parser</link>). The input may be submitted in the form of a stream of XML markup (from a URI,
+ a character or byte stream, or another transformation), a SAX InputStream, or a DOM Node.</p>
+<p>&xslt4j; performs the transformations specified in the XSL stylesheet and packages a sequence of
+ SAX events that may be serialized to an output stream or writer, used to build a DOM tree, or
+ forwarded as input to another transformation.</p>
+</s2>
+
+<anchor name="features"/>
+<s2 title="&xslt4j; Features">
+<ul>
+ <li>Includes an Interpretive processor for use in a tooling and debugging environment and
+ a Compiling processor (XSLTC) for use in a high performance runtime environment.<br/><br/></li>
+ <li>Implements the relevant W3C specifications: <resource-ref idref="xslt"/> and
+ <resource-ref idref="xpath"/>.<br/><br/></li>
+ <li>Implements <resource-ref idref="jaxp13-longname-withacronym"/>, and builds on
+ <resource-ref idref="sax2"/> and <resource-ref idref="dom3"/>.<br/><br/></li>
+ <li>Implements the XPath API in <resource-ref idref="jaxp13"/>.<br/><br/></li>
+ <li>May be configured to work with any XML parser, such as
+ <jump href="http://xml.apache.org/xerces-j/index.html">&xml4j;</jump>, that implements
+ <resource-ref idref="jaxp13"/> (see <link idref="usagepatterns" anchor="plug">Plugging in an XML
+ parser</link>).<br/><br/></li>
+ <li>Can process Stream, SAX or DOM input, and output to a Stream, SAX or DOM.<br/><br/></li>
+ <li>Transformations may be chained (the output of one transformation may be the input for
+ another).<br/><br/></li>
+ <li>May be run from the <link idref="commandline">command line</link> for convenient file-to-file
+ transformations.<br/><br/></li>
+ <li>Includes an <link idref="usagepatterns" anchor="applet">applet wrapper</link>.<br/><br/></li>
+ <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.<br/><br/></li>
+ <li>Supports the creation of <link idref="extensions">Java and scripting language extensions</link>.
+ and provides a growing library of extension elements and functions.</li>
+</ul>
+</s2>
+
+<anchor name="towork"/>
+<s2 title="Getting to work with &xslt4j;">
+<p>For instructions and some suggestions about how to get started using the XSLT Interpretive
+ processor, see <link idref="getstarted">Getting Started with Interpretive Processing</link>.</p>
+<p>For instructions and some suggestions about how to get started using the XSLT Compiling
+ processor, see <link idref="xsltc_usage">Getting Started with XSLTC</link>.</p>
+</s2>
+
+<anchor name="uptospeed"/>
+<s2 title="Getting up to speed with XSLT">
+<p>If you are still working through the details of the XSLT spec (the W3C 1.0 Recommendation), you
+ may want to consult one or more of the following:</p>
+<ul>
+ <li>XSLT - XSL Transformations in
+ <jump href="http://www.brics.dk/~amoeller/XML/">
+ The XML Revolution: Technologies for the future Web</jump> by Anders Møller and Michael
+ I. Schwartzbach (Web pages, but designed for sequential reading)<br/><br/></li>
+ <li>Crane Softwright's <jump href="http://www.CraneSoftwrights.com/training/">Free preview of
+ Practical Transformation Using XSLT and XPath</jump><br/><br/></li>
+ <li>Doug Tidwell's <jump href="http://www.oreilly.com/catalog/xslt/">XSLT</jump>, O'Reilly, 2001
+ <br/><br/></li>
+ <li>Bob Ducharme's <jump href="http://www.manning.com/ducharme/index.html">XSLT Quickly</jump>,
+ Manning Publications, 2001<br/><br/></li>
+ <li>John Robert Gardner and Zarella Rendon's
+ <jump href="http://vig.prenhall.com/catalog/academic/product/1,4096,0130404462,00.html">XSLT
+ and XPath: A Guide to Transformations</jump>, Prentice-Hall, 2001<br/><br/></li>
+ <li>Michael Kay's <jump href="http://www.wrox.com/books/0764543814.shtml">XSLT
+ Programmer's Reference</jump>, 2nd ed., Wrox Press, 2001<br/><br/></li>
+<!--
+ <li>Neil Bradley's <jump href="http://www.awlonline.com/product/0,2627,0201674874,00.html">XSL
+ Companion</jump>, Addison-Wesley, 2000<br/><br/></li>
+ <li>Khun Yee Fung's <jump href="http://www.awlonline.com/product/0,2627,0201711036,00.html">XSLT:
+ Working with XML and HTML</jump>, Addison-Wesley, 2001<br/><br/></li> -->
+ <li>Dave Pawson's <resource-ref idref="dpawsonxslfaq"/> to search out particular answers and
+ techniques<br/><br/></li>
+ <li>Miloslav Nic's <jump href="http://zvon.vscht.cz/HTMLonly/XSLTutorial/Books/Book1/index.html">XSL
+ Tutorial</jump>, a collection of stylesheet examples<br/><br/></li>
+ <li>Elliotte Rusty Harold's <jump href="http://www.ibiblio.org/xml/books/bible2/chapters/ch17.html">
+ Chapter 17 of the XML Bible: XSL Transformations</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>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" XML transformations) and their related
+ <jump href="http://objectsbydesign.com/projects/xslt/xslt_by_example.html">XSLT by Example</jump>
+ <br/><br/></li>
+ <li>OASIS (the Organization for the Advancement of Structured Information Standards):
+ <jump href="http://www.oasis-open.org/cover/xsl.html">Extensible Stylesheet Language (XSL)</jump>
+ by Robin Cover<br/><br/></li>
+</ul>
+<p>When you come across other useful introductory or background materials, please email
+ <human-resource-ref idref="xalandev"/>, so we can add them to this list.</p>
+
+</s2><anchor name="glossary"/>
+<s2 title="Glossary">
+<gloss>
+ <label>XSLT Namespace</label>
+ <item>The <jump href="http://www.w3.org/TR/REC-xml-names/">XML namespace</jump> for XSLT. An XML
+ namespace is a collection of element and attribute names, identified by a Unique Resource
+ Identifier (URI), which often takes the form of a URL, but is really just a unique string,
+ not a pointer to a web page. The XSLT namespace URI is http://www.w3.org/1999/XSL/Transform.
+ In each XSLT stylesheet, you must declare this namespace in the stylesheet element tag and
+ bind it to a local prefix. Like the XSLT specification, we always use xsl as the XSLT
+ namespace prefix in our descriptions and examples, although you are free to bind any prefix
+ to this namespace.<br/><br/></item>
+
+ <label>XSL Instruction</label>
+ <item>Any tag associated with the XSLT namespace.<br/><br/></item>
+
+ <label>Template</label>
+ <item>An element, usually with child elements, that specifies a "rule" or set of
+ instructions to perform when a particular kind of node is encountered in the source
+ tree.<br/><br/></item>
+
+ <label>XSL Template Instruction</label>
+ <item>Any tag that occurs inside an xsl:template element and is associated with the XSLT
+ namespace.<br/><br/></item>
+
+ <label>Source Tree</label>
+ <item>The XML tree input to the XSL process.<br/><br/></item>
+
+ <label>Result Tree</label>
+ <item>The tree that is output by the XSL process.<br/><br/></item>
+
+ <label>Match Pattern</label>
+ <item>The part of a template that defines the kind(s) of nodes to which the template
+ applies.<br/><br/></item>
+
+</gloss>
+<p>For more definitions of XSLT terminology, see Dave Pawson's
+ <jump href="http://www.dpawson.co.uk/xsl/xslvocab.html">XSLT Terminology
+ Clarification</jump> and the Glossary in Michael Kay's
+ <jump href="http://www.wrox.com/books/0764543814.shtml">XSLT Programmer's Reference</jump>.</p>
+</s2>
+</s1>
Added: xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/public_apis.xml
URL: http://svn.apache.org/viewvc/xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/public_apis.xml?rev=1382403&view=auto
==============================================================================
--- xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/public_apis.xml (added)
+++ xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/sources/xalan/public_apis.xml Sun Sep 9 05:54:44 2012
@@ -0,0 +1,128 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
+<!--
+ * Copyright 2004 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+<s1 title="Supported Interfaces in &xslt4j;">
+ <ul>
+ <li><link anchor="public">Public interfaces</link></li>
+ <li><link anchor="experimental">Experimental interfaces</link></li>
+ <li><link anchor="internal">Internal interfaces</link></li>
+ </ul><anchor name="public"/>
+ <s2 title="Public interfaces">
+ <p>A public interface of &xslt4j2; is an API that a typical client developer
+ should code against. Such interfaces are usually based upon
+ World-Wide Web Consortium (W3C) recommendations, such as XSLT 1.0 and
+ XPath 1.0, or Java Specification Requests (JSR's) with a status of
+ "Final Release", such as JAXP.</p>
+ <p>The &xslt4j2; team will support use of public interfaces, and will
+ attempt to fix severe bugs in such interfaces.</p>
+ <p>A particular version of a public interface will be supported for all
+ the maintenance drops of a particular version and release of &xslt4j2;
+ (that is, for a release that changes just the third digit of the
+ version number). At the point a new version of &xslt4j2; is made
+ available, (that is, a release that changes the first or second digit
+ of the version number) such interfaces could change to reflect the
+ latest standard specifications.</p>
+ <p>The public interfaces of &xslt4j2; are:</p>
+ <ul>
+ <li><jump href="http://java.sun.com/xml/jaxp/">JAXP 1.3</jump>
+ interfaces found in the
+ <jump href="apidocs/javax/xml/parsers/package-summary.html">
+ <code>javax.xml.parsers</code></jump>,
+ <jump href="apidocs/javax/xml/transform/package-summary.html">
+ <code>javax.xml.transform</code></jump>,
+ <jump href="apidocs/org/xml/sax/package-summary.html">
+ <code>org.xml.sax</code></jump>,
+ <jump href="apidocs/org/w3c/dom/package-summary.html">
+ <code>org.w3c.dom</code></jump> and
+ <jump href="apidocs/javax/xml/xpath/package-summary.html">
+ <code>javax.xml.xpath</code></jump> packages. </li>
+ <li>The &xslt4j2; specific XPath API, defined by the classes
+ <ul>
+ <li><jump href="apidocs/org/apache/xpath/XPathAPI.html">
+ <code>org.apache.xpath.XPathAPI</code></jump></li>
+ <li><jump href="apidocs/org/apache/xpath/CachedXPathAPI.html">
+ <code>org.apache.xpath.CachedXPathAPI</code></jump></li>
+ </ul>
+ </li>
+ <li>API's for using, configuring or defining a serializer, from the
+ <code>org.apache.xml.serializer</code> package:
+ <ul>
+ <li><jump href="apidocs/org/apache/xml/serializer/OutputPropertiesFactory.html">
+ <code>OutputPropertiesFactory</code></jump></li>
+ <li><jump href="apidocs/org/apache/xml/serializer/SerializerFactory.html">
+ <code>SerializerFactory</code></jump></li>
+ <li><jump href="apidocs/org/apache/xml/serializer/Serializer.html">
+ <code>Serializer</code></jump></li>
+ </ul>
+ </li>
+ <li>Properties files for configuring a serializer. (See
+ <link idref="usagepatterns" anchor="outputprops">Setting output
+ properties in your stylesheets</link> for more information.)
+ <ul>
+ <li><code>org/apache/xml/serializer/output_xml.properties</code></li>
+ <li><code>org/apache/xml/serializer/output_html.properties</code></li>
+ <li><code>org/apache/xml/serializer/output_text.properties</code></li>
+ </ul>
+ </li>
+ <li>Command-line interfaces for performing transformations:
+ <ul>
+ <li><link idref="commandline">&xslt4j; Command-line utility</link></li>
+ <li><link idref="xsltc_usage" anchor="compile">Compiling translets
+ from the command line</link></li>
+ <li><link idref="xsltc_usage" anchor="run">Running translets
+ from the command line</link></li>
+ </ul>
+ </li>
+ </ul>
+ </s2><anchor name="experimental"/>
+ <s2 title="Experimental interfaces">
+ <p>Interfaces and classes that are designated experimental reflect recent
+ World-Wide Web Consortium (W3C) draft recommendations or draft
+ Java Specification Requests (JSR's). Such an API is based upon
+ a specification that is subject to change, and so is itself subject
+ to change as the relevant standards body makes changes to the
+ specification.</p>
+ <p>If and when the specification upon which the API is based reaches its
+ final published form, the API could become a Public interface in
+ a subsequent release of &xslt4j2;, although the &xslt4j2; team could
+ decide to simply withdraw the API, if it decided that making the API
+ a public interface would not be appropriate.</p>
+ <p>As the name suggests, experimental interfaces are provided in order to
+ give users the opportunity to experiment with new features so that they
+ can provide feed-back on those features. They should not be used in
+ production-level code. The &xslt4j2; team may fix severe bugs in
+ experimental interfaces.</p>
+ <p>The experimental interfaces of &xslt4j2; are:</p>
+ <ul>
+ <li>The
+ <jump href="http://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226">
+ DOM Level 3 XPath API</jump> found in the
+ <jump href="apidocs/org/apache/xpath/domapi/package-summary.html">
+ <code>org.apache.xpath.domapi</code></jump> package.</li>
+ </ul>
+ </s2><anchor name="internal"/>
+ <s2 title="Internal interfaces">
+ <p>All other classes are considered to be part of the internal interface of
+ &xslt4j2;. Some such classes or members of such classes may themselves
+ be designated as <code>public</code> using the Java keyword, but that is
+ a consequence of the internal organization of &xslt4j2;.</p>
+ <p>Users who have complex and specific needs, such as the need to build
+ their own XSLT or XPath processors, might use these internal interfaces,
+ but their use is not supported. In addition these interfaces are subject
+ to change without notice.</p>
+ </s2>
+</s1>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xalan.apache.org
For additional commands, e-mail: commits-help@xalan.apache.org