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]
