dleslie 02/02/15 08:02:09
Modified: java/xdocs/sources/xalan getstarted.xml overview.xml
readme.xml resources.xml whatsnew.xml
Log:
link and editorial fixes.
Revision Changes Path
1.25 +1 -1 xml-xalan/java/xdocs/sources/xalan/getstarted.xml
Index: getstarted.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/getstarted.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- getstarted.xml 8 Feb 2002 18:17:31 -0000 1.24
+++ getstarted.xml 15 Feb 2002 16:02:09 -0000 1.25
@@ -19,7 +19,7 @@
<li>&xml4j-jar;, or another <link idref="usagepatterns" anchor="plug">XML
Parser</link></li>
</ul>
<p>You can get the JDK or JRE from <jump
href="http://www.ibm.com/java/jdk";>ibm.com/java/jdk/</jump> or <jump
href="http://www.java.sun.com";>java.sun.com</jump>.</p>
-<p>For the binary distribution, which includes everything required to use and build
applications with &xslt4j;, download <resource-ref idref="xslt4j-dist-bin-zip"/> or
<resource-ref idref="xslt4j-dist-bin-targz"/>. Both of these files contain
<resource-ref idref="xslt4j-current"/> (with xalan.jar and xml-apis.jar) and
&xml4j-jar; from <resource-ref idref="xml4j-used"/>. You can use a zip or tar utility
to expand these files into a full build.</p>
+<p>For the binary distribution, which includes everything required to use and build
applications with &xslt4j;, download <resource-ref idref="xslt4j-dist-bin-zip"/> or
<resource-ref idref="xslt4j-dist-bin-targz"/>. Both of these files contain
&xslt4j-current; (with xalan.jar and xml-apis.jar) and &xml4j-jar; from <resource-ref
idref="xml4j-used"/>. You can use a zip or tar utility to expand these files into a
full build.</p>
<p>If you want the &xslt4j; source files, download <resource-ref
idref="xslt4j-dist-src-zip"/> or <resource-ref idref="xslt4j-dist-src-targz"/>. After
you expand these files into the complete source tree, you can use <resource-ref
idref="ant"/> to do your own builds. For more information, see <link idref="readme"
anchor="build">Build notes</link>.</p>
<p>If you plan to run <link idref="extensions">XSLT extensions</link>, you need
bsf.jar, which is included in the &xslt4j; 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 <link idref="extensions"
anchor="supported-lang">extensions language requirements</link>.</p>
1.15 +2 -2 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.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- overview.xml 14 Aug 2001 19:09:41 -0000 1.14
+++ overview.xml 15 Feb 2002 16:02:09 -0000 1.15
@@ -67,13 +67,13 @@
<li><link anchor="glossary">Glossary</link></li>
</ul><anchor name="intro"/>
<s2 title="Introduction">
- <p>&xslt4j; (named after a rare musical instrument) fully implements the
<resource-ref idref="xslt"/> and the
+ <p>&xslt4j; (named after a rare musical instrument) 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="xslt"/> and the <jump
+ For more information, see <resource-ref idref="xsl"/> 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. An XSL stylesheet
contains instructions for
transforming XML documents from one document type into another document type
(XML, HTML, or other). In structural
1.79 +7 -9 xml-xalan/java/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.78
retrieving revision 1.79
diff -u -r1.78 -r1.79
--- readme.xml 11 Feb 2002 20:46:50 -0000 1.78
+++ readme.xml 15 Feb 2002 16:02:09 -0000 1.79
@@ -143,8 +143,6 @@
<anchor name="status"/>
<s3 title="Version of Xerces to use">
<p>The &xslt4j-current; has been tested with &xml4j-used;. &download; For
information about including &xml4j-jar; on the system class path, see <link
idref="getstarted" anchor="classpath">Setting up the system class path</link>.</p>
- <note>You may also use &xslt4j-current; for prototyping or beta testing with
&xml4j; 2.0.0.beta3. <em>You may not use the
- <link idref="usagepatterns" anchor="compat">&xslt4j; version 1 API
(deprecated)</link> with &xml4j; 2.0.0.beta3.</em></note>
<p><em>Important</em> You may experience unpredictable anomalies if your
&xslt4j; and &xml4j; builds are not in synch. If you download an update to &xslt4j;,
check the release notes to determine which version of &xml4j; you should use.</p>
<note>You can use &xslt4j; with other XML parsers that implement the
<resource-ref idref="jaxp"/>. See
<link idref="usagepatterns" anchor="plug">Plugging in the Transformer and
XML parser</link>.</note>
@@ -212,7 +210,7 @@
</s3><anchor name="samples"/>
<s3 title="Rebuilding a sample application">
<p>If you modify a sample and want to recompile it, you can run the Java
compiler in the directory containing the
- example. Be sure xalan.jar and &xml4j-jar; are on the classpath. To recompile
(and run!) the class files in the
+ example. Be sure xalan.jar, xml-apis.jar, and &xml4j-jar; are on the classpath.
To recompile (and run!) the class files in the
Servlet subdirectory, the javax.servlet and javax.servlet.http packages must
also be on the classpath. Sun
distributes these packages in the JSWDK 1.0.1 servlet.jar file.</p>
<p>After recompiling a sample, you can use the Sun jar utility to place your new
.class files in
@@ -236,7 +234,7 @@
<ul>
<li>Unzip xml-site-style.tar.gz into the xdocs directory (the operation
places files in a number of subdirectories).
<br/><br/></li>
- <li>Be sure stylebook-1.0-b2.jar, xalanjdoc.jar, xalan.jar, bsf.jar,
bsfengines.jar, and &xml4j-jar; are on the class
+ <li>Be sure stylebook-1.0-b2.jar, xalan2jdoc.jar, xalan.jar, bsf.jar,
bsfengines.jar, and &xml4j-jar; are on the class
path.<br/><br/></li>
<li>To build doc in a build/docs subdirectory, run StyleBook from the xdocs
directory as follows:<br/><br/>
<code>java org.apache.stylebook.StyleBook "targetDirectory=../build/docs/"
sources/xalanLocal.xml style</code>
@@ -300,7 +298,7 @@
<!-- in alphabetical order, by last name -->
<ul>
<li><human-resource-ref idref="sboag"/>
- <br/>Xalan architect, lead developer on Xalan-J 2.x.
+ <br/>Xalan architect, lead developer on Xalan-J.
</li>
<li><human-resource-ref idref="scurcuru"/>
<br/>Lead tester for API issues, automation framework.
@@ -309,22 +307,22 @@
<br/>XSLT Conformance stylesheet issues and Xalan-C testing.
</li>
<li><human-resource-ref idref="jkesselman"/>
- <br/>Xalan-J 2.x developer, compiling/compiled stylesheets experiments.
+ <br/>Xalan-J developer, compiling/compiled stylesheets experiments.
</li>
<li><human-resource-ref idref="dleslie"/>
<br/>Xalan-J and -C documentation, servlets, applets, and samples.
</li>
<li><human-resource-ref idref="cmanolache"/>
- <br/>Xalan-J 2.x developer and JAXP expert.
+ <br/>Xalan-Jdeveloper and JAXP expert.
</li>
<li><human-resource-ref idref="dmarston"/>
<br/>Lead tester for XSLT Conformance stylesheet issues.
</li>
<li><human-resource-ref idref="mmidy"/>
- <br/>Xalan-J 1.x and 2.x developer.
+ <br/>Xalan-J developer.
</li>
<li><human-resource-ref idref="gpeskin"/>
- <br/>Xalan-J 1.x and 2.x developer, especially extension mechanisim.
+ <br/>Xalan-J developer, especially extension mechanisim.
</li>
<li><human-resource-ref idref="jgentilin"/>
<br/>Major work on the SQL extensions library.
1.24 +7 -3 xml-xalan/java/xdocs/sources/xalan/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/resources.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- resources.xml 17 Jan 2002 20:07:30 -0000 1.23
+++ resources.xml 15 Feb 2002 16:02:09 -0000 1.24
@@ -17,7 +17,7 @@
<resources>
<resource id="xslt4j-current"
title="&xslt4j-current;"
- location="http://xml.apache.org/xalan"/>
+ location="http://xml.apache.org/xalan-j"/>
<resource id="xslt4j-distdir"
title="xalan-j distribution directory"
@@ -70,8 +70,12 @@
<resource id="dpawsonxslfaq" title="XSL Frequently Asked Questions"
location="http://www.dpawson.co.uk/xsl/xslfaq.html"/>
+ <resource id="xsl"
+ title="Extensible Stylesheet Language (XSL) Version 1.0"
+ location="http://www.w3.org/TR/xsl"/>
+
<resource id="xslt"
- title="W3C Recommendation XSL Transformations (XSLT) Version 1.0"
+ title="XSL Transformations (XSLT) Version 1.0"
location="http://www.w3.org/TR/xslt"/>
<resource id="xpath"
@@ -120,7 +124,7 @@
name="Paul Dick"
mailto="[EMAIL PROTECTED]"/>
<human-resource id="jkesselman"
- name="Josepah Kesselman"
+ name="Joseph Kesselman"
mailto="[EMAIL PROTECTED]"/>
<human-resource id="dleslie"
name="Donald Leslie"
1.27 +1 -1 xml-xalan/java/xdocs/sources/xalan/whatsnew.xml
Index: whatsnew.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/whatsnew.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- whatsnew.xml 8 Feb 2002 17:16:49 -0000 1.26
+++ whatsnew.xml 15 Feb 2002 16:02:09 -0000 1.27
@@ -64,7 +64,7 @@
<s2 title="New Design">
<p>&xslt4j2; represents a fundamental redesign of &xslt4j;. The primary objective
of this redesign is an easier-to-use, more understandable, and more modular API that
encourages wider participation in its ongoing development by the open-source XML
developer community, and that lends itself to "streaming," the production of
transformation output while the input is still being parsed.</p>
<p>&xslt4j2; builds on <resource-ref idref="sax2"/>, <resource-ref idref="dom2"/>,
and the <resource-ref idref="jaxp"/>. For example, &xslt4j2; incorporates the SAX
parsing event model in its support for the incremental production of transformation
output. &xslt4j2; also implements the standard TrAX API (see below) that enables you
to code your XML applications without reference to the internal details of a
particular Transformer or XML parser.</p>
-<p>Given the scope of the redesign, the changes with respect to <jump
href="http://xml.apache.org/xalan/index.html";>&xslt4j; 1.x</jump> are global in
nature. For an introduction to the &xslt4j2; usage patterns, see <link
idref="usagepatterns">Basic Usage Patterns</link>.</p>
+<p>Given the scope of the redesign, the changes with respect to &xslt4j; 1 (no
longer available) are global in nature. For an introduction to the &xslt4j2; usage
patterns, see <link idref="usagepatterns">Basic Usage Patterns</link>.</p>
<p>&xslt4j2; implements the <link idref="trax">TRaX (Transformation API for
XML)</link> interfaces. The product of extensive open-source collaboration by members
of the XML developer community, TrAX provides a conceptual framework and a standard
API for performing XML transformations. During its evolution, the TrAX API has
undergone several revisions. We believe this API has now reached or is very close to
final form. In November 2000, TrAX was incorporated into <resource-ref
idref="jsr063"/>, the Java API for XML Processing 1.1 , which has been published for
public review (see <resource-ref idref="jaxp11"/>). We strongly encourage you to
utilize the TrAX framework when you use &xslt4j2; to perform XML transformations.</p>
<p>The basic organization of TrAX is quite simple: use a TransformerFactory to
process transformation instructions and generate a Transformer, with which you can
apply the processed transformation instructions to your XML Source, producing a
transformation Result. For more detail, see <link idref="usagepatterns"
anchor="basic">Basic steps</link>.</p>
<p>As part of the Java API for XML Processing, TraX provides a stable framework for
plugging Transformers (like &xslt4j;) and XML parsers (like &xml4j;) into your
applications without tying yourself to the internal details of those implementations.
See <link idref="usagepatterns" anchor="plug">Plugging in a Transformer and XML
parser</link>.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
