dleslie 02/02/08 07:56:33
Modified: java/xdocs/sources entities.ent
java/xdocs/sources/xalan dtm.xml extensions.xml
extensionslib.xml faq.xml getstarted.xml index.xml
readme.xml usagepatterns.xml
Log:
Cleanup of use of "Xalanxx" and equivalent entity refs
Revision Changes Path
1.50 +1 -0 xml-xalan/java/xdocs/sources/entities.ent
Index: entities.ent
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/entities.ent,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -r1.49 -r1.50
--- entities.ent 7 Feb 2002 20:08:38 -0000 1.49
+++ entities.ent 8 Feb 2002 15:56:32 -0000 1.50
@@ -1,5 +1,6 @@
<?xml encoding="US-ASCII"?>
+<!ENTITY xslt "Xalan">
<!ENTITY xslt4j "Xalan-Java">
<!ENTITY xslt4j2 "Xalan-Java 2">
<!ENTITY xslt4j-dist "xalan-j_2_3_0">
1.4 +1 -1 xml-xalan/java/xdocs/sources/xalan/dtm.xml
Index: dtm.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/dtm.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- dtm.xml 31 Jan 2002 15:55:22 -0000 1.3
+++ dtm.xml 8 Feb 2002 15:56:32 -0000 1.4
@@ -79,7 +79,7 @@
<li>DOM2DTM (which provides DTM access to an existing DOM)</li>
</ul>
<p>Both DTMs can be built incrementally (see <link
anchor="incremental">incremental transforms</link>). When operating
incrementally, the
- DTM allows the Xalan processor to begin reading the DTM and performing the
transformation while the DTM is still being assembled
+ DTM allows the &xslt4j; processor to begin reading the DTM and performing
the transformation while the DTM is still being assembled
(for example, while the parser is still parsing the XML source), and
attempts to do only as much work as is needed to support the
read requests actually made by the XPath or XSLT processor.</p>
<p>For the convenience of user-written extensions, a proxy mechanism
presents the contents of the DTM as a read-only subset of the DOM.</p>
1.19 +2 -2 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.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- extensions.xml 15 Jul 2001 05:58:32 -0000 1.18
+++ extensions.xml 8 Feb 2002 15:56:32 -0000 1.19
@@ -135,7 +135,7 @@
<note>The extension function could include both numdays and multiplier as
arguments, thus bypassing the need for the extension element, but the purpose
here is to illustrate the usage pattern for extension elements.</note>
<p>As you review this stylesheet, please note the following:</p>
<ol>
- <li>The declaration of the Xalan lxslt namespace, which provides
support for the component and
+ <li>The declaration of the &xslt; lxslt namespace, which provides
support for the component and
component/script elements:<br/><br/>
<code>xmlns:lxslt="http://xml.apache.org/xslt"</code><br/><br/></li>
<li>The declaration of a namespace for this extension:<br/><br/>
@@ -499,7 +499,7 @@
</s3>
</s2><anchor name="java-namespace"/>
<s2 title="Alternative: using the abbreviated syntax for extensions
implemented in Java">
-<p>For extension functions and extension elements implemented in Java, Xalan
permits an abbreviated syntax. When you use the abbreviated syntax, you do not
use an lxslt:component to designate the functions.</p>
+<p>For extension functions and extension elements implemented in Java,
&xslt4j; permits an abbreviated syntax. When you use the abbreviated syntax,
you do not use an lxslt:component to designate the functions.</p>
<p>The abbreviated syntax supports the use of extension functions and
extension elements implemented in Java. You cannot use this syntax with
extensions implemented in JavaScript or another scripting language.</p>
<anchor name="java-namespace-declare"/>
<s3 title="Declare the namespace">
1.23 +5 -5 xml-xalan/java/xdocs/sources/xalan/extensionslib.xml
Index: extensionslib.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/extensionslib.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- extensionslib.xml 31 Jan 2002 15:55:22 -0000 1.22
+++ extensionslib.xml 8 Feb 2002 15:56:32 -0000 1.23
@@ -59,7 +59,7 @@
<s1 title="Extensions library">
<ul>
<li><link anchor="intro">Introduction</link></li>
-<li><link anchor="xalanns">Xalan namespace</link></li>
+<li><link anchor="xalanns">&xslt; namespace</link></li>
<li><link anchor="redirect">Redirect</link></li>
<li><link anchor="nodeset">nodeset</link></li>
<li><link anchor="intersection">intersection</link></li>
@@ -82,11 +82,11 @@
<s2 title= "Introduction">
<p>Extension elements and functions provide a powerful mechanism
for extending and simplifying what you can do with an XLST processor like
-Xalan. With input and contributions from the XML open-source developer
community, we are working on placing the most useful
+&xslt;. With input and contributions from the XML open-source developer
community, we are working on placing the most useful
extensions in an extensions library distributed with &xslt4j;. If you have
ideas and/or contributions you would like to make, please email us at the
<human-resource-ref idref="xalandev"/>.</p>
</s2><anchor name="xalanns"/>
-<s2 title="Xalan namespace">
-<p>Where it makes sense, we are placing the new Xalan extensions in the
org.apache.xalan.lib.Extensions class and we have defined a namespace for this
class:</p>
+<s2 title="&xslt; namespace">
+<p>Where it makes sense, we are placing the new &xslt; extensions in the
org.apache.xalan.lib.Extensions class and we have defined a namespace for this
class:</p>
<p> <code>http://xml.apache.org/xalan</code></p>
<p>If you are calling &xslt4j;-supplied extensions, we recommend that you
define this namespace in your stylesheet element, and call the extension using
the namespace prefix that you have associated with that namespace. That way, if
we later reorganize how the &xslt4j;-supplied extensions are stored, you won't
have to modify your stylesheet.</p>
<p>For an example that uses this namespace, see <link
anchor="ex-nodeset">Example with the nodeset extension function</link>.</p>
@@ -454,7 +454,7 @@
<s3 title="Variation: using pipeDocument in an empty stylesheet">
<p>Suppose you want to pipe a document through a series of transformations.
You can use the pipeDocument extension element
to perform this operation by placing the extension element in an otherwise
empty stylesheet.</p>
-<p>The following stylesheet is used to merge the Xalan documents into a book
(the first transformation), and transform the book
+<p>The following stylesheet is used to merge the &xslt; documents into a
book (the first transformation), and transform the book
into a tree of formatting objects, which can then be used to generate a PDF
file. This transformation is invoked as follows:</p>
<p><code>java org.apache.xalan.xslt.Process -in printbook.xml</code><br/>
<code> -param source printbook.xml</code><br/>
1.21 +16 -19 xml-xalan/java/xdocs/sources/xalan/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/faq.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- faq.xml 1 Feb 2002 20:00:53 -0000 1.20
+++ faq.xml 8 Feb 2002 15:56:32 -0000 1.21
@@ -18,7 +18,7 @@
<faq title="Compatibility with &xslt4j; version 1">
<q>How do I run applications that use the &xslt4j; version 1 API with
&xslt4j2;</q>
- <a><p>The Xalan-Java 1 compatibility API has been deprecated and now
purged, so you must use the &xslt4j2; API. We strongly encourage you to
+ <a><p>The &xslt4j; 1 compatibility API has been deprecated and now
purged, so you must use the &xslt4j2; API. We strongly encourage you to
use the JAVAX 1.1/TrAX API. For more information ,see the next
FAQ.</p></a>
</faq>
@@ -46,20 +46,20 @@
another transformation</link>.<anchor name="jdk13"/></p></a>
</faq>
- <faq title="Issues running Xalan on JDK 1.3">
+ <faq title="Issues running &xslt4j; on JDK 1.3">
<q>I'm having a problem building or running &xslt4j; on the JDK 1.3.</q>
<a><p>The JDK 1.3 automatically places everything in the lib/ext directory
in front of everything you place on the classpath. If this directory contains a
version of DOM, JAXP, or Xerces that predates the &xslt4j; distribution you are
using, you may have problems!</p>
-<p>The IBM JDK 1.3 includes an earlier version of xerces.jar in the lib/ext
directory, a version that does not implement the JAXP 1.1 interfaces and
therefore does not work with the current Xalan release. Accordingly, you must
either purge the xerces.jar that is in that directory or replace it with the
&xml4j-jar; that is included with the Xalan distribution.</p>
+<p>The IBM JDK 1.3 includes an earlier version of xerces.jar in the lib/ext
directory, a version that does not implement the JAXP 1.1 interfaces and
therefore does not work with the current &xslt4j; release. Accordingly, you
must either purge the xerces.jar that is in that directory or replace it with
the &xml4j-jar; that is included with the &xslt4j; distribution.</p>
<p>The SUN JDK 1.3 includes a pre-1.1 version of the JAXP in crimson.jar.
Either purge the crimson.jar in that directory or overwrite it with a newer
crimson.jar that includes and implements the JAXP 1.1 interfaces.</p></a>
</faq>
<faq title="a "DOM006 Hierarchy request error"">
<q>Why do I get a "DOM006 Hierarchy request error" when I try to transform
into a DOM Document node?</q>
<a>
- <p>This error occurs when Xalan tries to add a Node to a Document node
where it isn't allowed. For example, attempting to add non-whitespace
+ <p>This error occurs when &xslt4j; tries to add a Node to a Document node
where it isn't allowed. For example, attempting to add non-whitespace
text to the DOM Document node produces this error.</p>
<p>The error can also occur when a Document node is created with the
DOMImplementation createDocument() method, which takes a qualified name
- as an argument and creates an element node. If you then pass the
returned Document node to Xalan, you get a "DOM006 Hierarchy request
- error" when Xalan tries to add a second element to the Document node.
The solution is to either use the DocumentBuilder newDocument() method
+ as an argument and creates an element node. If you then pass the
returned Document node to &xslt4j;, you get a "DOM006 Hierarchy request
+ error" when &xslt4j; tries to add a second element to the Document node.
The solution is to either use the DocumentBuilder newDocument() method
to create a Document that does not contain an element node, or use a
DocumentFragment. It should be noted that the
DocumentBuilder newDocument() method is "Non-preferred" according to the
JAXP 1.1 documentation.</p>
</a>
@@ -104,14 +104,11 @@
<li>To run extensions (including the samples in samples/extensions),
bsf.jar, and bsfengines.jar must be on the
classpath. To run extensions implemented in JavaScript, js.jar must also
be on the classpath. For information on what
you need to run extensions implemented in other scripting languages, see
<link idref="extensions"
- anchor="supported-lang">Supported languages</link>.<br/><br/></li>
- <li>To run applications that use the &xslt4j; version 1 API, you must
put xalanj1compat.jar on the classpath, recompile the application,
- and be sure xalanj1compat.jar is on the classpath at run time (see <link
idref="usagepatterns" anchor="compat">Using the &xslt4j; version 1
- API)</link>.</li>
+ anchor="supported-lang">Supported languages</link>.</li>
</ol>
<p>For more information, see <link idref="getstarted"
anchor="classpath">Setting up the system classpath</link>.</p>
<p><anchor name="environmentcheck"/></p>
- <p><em>Using the EnvironmentCheck utility:</em> To help diagnose
classpath problems, try running Xalan's environment checking utility, checked
in at
+ <p><em>Using the EnvironmentCheck utility:</em> To help diagnose
classpath problems, try running &xslt4j;'s environment checking utility,
checked in at
xml-xalan/java/src/org/apache/xalan/xslt/EnvironmentCheck.</p>
<p>You can run this utility from the command line as follows:</p>
<p><code>java org.apache.xalan.xslt.EnvironmentCheck [-out
outFile]</code></p>
@@ -154,12 +151,12 @@
<faq title="Using the 'signature' file to verify a download">
<q>How do I use the "signature" file to verify my download?</q>
<a>
- <p>For each Xalan download file in <resource-ref
idref="xslt4j-distdir"/>, there is a corresponding signature file.
+ <p>For each &xslt4j; download file in <resource-ref
idref="xslt4j-distdir"/>, there is a corresponding signature file.
The signature file for xalan-j_2_0_1.tar.gz, for example, is
xalan-j_2_0_1.tar.gz.sig.</p>
<p>The .sig files are PGP signatures of the actual .zip or .tar.gz
download files. You can use these files to verify the authenticiy
of the download. You do not need the .sig file to
use the corresponding donwload file.</p>
- <p>To check the authenticity of a Xalan distribution, you need a
copy of
+ <p>To check the authenticity of a &xslt4j; distribution, you need a
copy of
PGP which is available in a number of licenses, including some free
non-commercial licenses, either from an mit.edu site or on
the pgp.com site. Once you have a version of PGP installed, you
@@ -183,8 +180,8 @@
<q>My servlet cannot find classes that implement extension functions or
elements. What can I do?</q>
<a>
<p>If you install xalan.jar in the servlet engine's lib directory (e.g.,
tomcat/lib), as opposed to the servlet's
- lib directory, then the Xalan classes are loaded by a classloader that
does not see the classes in the servlet's
- classloader (i.e., the extension classes, if you placed them there). The
Xalan classes try to load the extension
+ lib directory, then the &xslt4j; classes are loaded by a classloader
that does not see the classes in the servlet's
+ classloader (i.e., the extension classes, if you placed them there). The
&xslt4j; classes try to load the extension
classes using their own classloader, and that attempt fails.</p>
<p>Workaround: place xalan.jar in the servlet's lib directory and NOT in
the servlet engine's lib directory.
Another workaround is to place the extension classes also in the servlet
engine's lib directory, but you
@@ -207,7 +204,7 @@
<p>SAX1 should not be on your classpath. The SAX1 interfaces and
implementations of the SAX1 SAXPparser
are not namespace aware.</p>
<p>To help diagnose your classpath, you can use the <link
anchor="environmentcheck">EnvironmentCheck
- utility</link>. If you are running under JDK 1.3, see <link
anchor="jdk13">Issues running Xalan on JDK
+ utility</link>. If you are running under JDK 1.3, see <link
anchor="jdk13">Issues running &xslt4j; on JDK
1.3</link>. If you are running a servlet, make sure the servlet engine is
not placing SAX1 on the
classpath.</p>
<p><em>Setting the parser to be namespace aware</em></p>
@@ -284,13 +281,13 @@
return locator;
}</source>
-<note><em>Xalan exception handling:</em> The exception architecture in
Xalan and with transforms in general is tricky because of multiple layers of
exception handling, involving movement back and forth between SAX and
Transformer exceptions and across pipes. Xalan often uses a
WrappedRuntimeException to throw over many layers of checked exceptions, in
order not to have every possible checked exception be declared for every
function in the stack, which means it has to catch this exception at the upper
levels and unwrap the exception to pass it on as a TransformerException.
+<note><em>&xslt4j; exception handling:</em> The exception architecture in
&xslt4j; and with transforms in general is tricky because of multiple layers of
exception handling, involving movement back and forth between SAX and
Transformer exceptions and across pipes. &xslt4j; often uses a
WrappedRuntimeException to throw over many layers of checked exceptions, in
order not to have every possible checked exception be declared for every
function in the stack, which means it has to catch this exception at the upper
levels and unwrap the exception to pass it on as a TransformerException.
<br/><br/>
-A JAXP 1.1 TransformerException often wraps another exception. Two of the
TransformerException structures that are frequently used to construct contained
exceptions in JAXP 1.1 do not set the locator. The locator is not set because
we don't know the type of exception that the Throwable argument represents.
The solution is to chase up the contained exceptions to find the root cause,
which will usually have a location set for you. This can be somewhat tricky,
as not all the exceptions may be TransformerExceptions. A good sample is in
the DefaultHandler static printLocation() method, which the Xalan command-line
processor uses to report errors. You can also roll your own functions along the
lines of the getRootSourceLocator() example above.</note>
+A JAXP 1.1 TransformerException often wraps another exception. Two of the
TransformerException structures that are frequently used to construct contained
exceptions in JAXP 1.1 do not set the locator. The locator is not set because
we don't know the type of exception that the Throwable argument represents.
The solution is to chase up the contained exceptions to find the root cause,
which will usually have a location set for you. This can be somewhat tricky,
as not all the exceptions may be TransformerExceptions. A good sample is in
the DefaultHandler static printLocation() method, which the &xslt4j;
command-line processor uses to report errors. You can also roll your own
functions along the lines of the getRootSourceLocator() example above.</note>
</a>
</faq>
<faq title="StackOverflowError with recursive stylesheet">
-<q>Xalan dies with a java.lang.StackOverflowError when I run a deeply
recursive stylesheet. The same stylesheet worked fine in the past (or on other
machines). What's happening?</q>
+<q>&xslt4j; dies with a java.lang.StackOverflowError when I run a deeply
recursive stylesheet. The same stylesheet worked fine in the past (or on other
machines). What's happening?</q>
<a>
<p>That may not be our fault. As of JDK 1.3.x, many Java Virtual Machine
publishers reduced the default size of a thread's call stack from 1MB to 256KB.
This allows more threads to run simultaneously, but it means that each thread
is more limited in how deeply its function calls can be nested. </p>
1.22 +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.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- getstarted.xml 7 Feb 2002 20:05:32 -0000 1.21
+++ getstarted.xml 8 Feb 2002 15:56:32 -0000 1.22
@@ -11,7 +11,7 @@
</ul>
<anchor name="download"/>
<s2 title="Downloading what you need">
-<p>To use Xalan, you need the following:</p>
+<p>To use &xslt4j;, you need the following:</p>
<ul>
<li>The JDK or JRE 1.2.2, or 1.3.x</li>
<li>xalan.jar</li>
1.46 +6 -6 xml-xalan/java/xdocs/sources/xalan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/index.xml,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -r1.45 -r1.46
--- index.xml 1 Feb 2002 19:10:14 -0000 1.45
+++ index.xml 8 Feb 2002 15:56:32 -0000 1.46
@@ -59,12 +59,12 @@
<s1 title="&xslt4j-current;">
<!--note>A later Developer release has been posted in the <resource-ref
idref="xslt4j-distdir"/>. For the changes that have occurred since
&xslt4j-current;, consult the [EMAIL PROTECTED] mailing list, or download the
release and consult the release notes.</note-->
<s2 title="What is it?">
- <p>Xalan is an XSLT processor for transforming XML documents into HTML,
text, or other XML document types. It implements the
+ <p>&xslt4j; is an XSLT processor for transforming XML documents into
HTML, text, or other XML document types. It implements the
W3C Recommendations for XSL Transformations (XSLT) and the XML Path
Language (XPath). It can be used from the command line,
in an applet or a servlet, or as a module in other program.</p>
</s2>
<s2 title="I've heard of &xslt4j;, but what is version 2?">
- <p>&xslt4j; version 2 recasts Xalan as an implementation of the <link
idref="trax">TRaX (Transformation API for XML)</link> interfaces, part of the
<resource-ref idref="jaxp11"/>. TRaX provides a
+ <p>&xslt4j; version 2 recasts &xslt; as an implementation of the <link
idref="trax">TRaX (Transformation API for XML)</link> interfaces, part of the
<resource-ref idref="jaxp11"/>. TRaX provides a
modular framework and a standard API for performing XML transformations,
and it utilizes system properties to determine which Transformer and which XML
parser to use.</p>
<p>&xslt4j; version 2 also builds on <resource-ref idref="sax2"/>,
<resource-ref idref="dom2"/>, and the XML parser API in
<resource-ref idref="jaxp"/>.</p>
@@ -93,8 +93,8 @@
</s2>
<s2 title="Where do I get Xerces?">
- <p>The Xalan download includes &xml4j-jar; from &xml4j-used;. In
conjunction with xml-apis.jar, this is all you need to run Xalan with
- the Xerces XML parser. You can, however, download the complete Xerces
binary or source distribution from the
+ <p>The &xslt4j; download includes &xml4j-jar; from &xml4j-used;. In
conjunction with xml-apis.jar, this is all you need to run &xslt4j; with
+ the &xml4j; XML parser. You can, however, download the complete Xerces
binary or source distribution from the
<resource-ref idref="xml4j-distdir"/>.</p>
<note>If you plan to use a different XML parser, see <link
idref="usagepatterns" anchor="plug">Plugging in a Transformer
and XML parser</link>.</note>
@@ -104,8 +104,8 @@
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>
</s2>
<s2 title="For more information...">
- <p>For more information, go to <link idref="overview">Xalan
Overview</link> and <link idref="getstarted">Getting
- Started</link>. All of the Xalan documentation on this website is
included in the Xalan download, as are a number of
+ <p>For more information, go to <link idref="overview">&xslt4j;
Overview</link> and <link idref="getstarted">Getting
+ Started</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 &xslt4j2;
to transform XML documents.</p>
</s2>
</s1>
1.76 +6 -14 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.75
retrieving revision 1.76
diff -u -r1.75 -r1.76
--- readme.xml 31 Jan 2002 18:06:19 -0000 1.75
+++ readme.xml 8 Feb 2002 15:56:32 -0000 1.76
@@ -72,8 +72,8 @@
<li><link anchor="done">Changes since version 2.2</link></li>
<li><link anchor="other">Other points of interest</link></li>
<li><link anchor="bugs">Bugs</link></li>
- <li><link anchor="status">Version of Xerces to use</link></li>
- <li><link anchor="developer-list">Xalan developers</link></li>
+ <li><link anchor="status">Version of &xml4j; to use</link></li>
+ <li><link anchor="developer-list">&xslt4j; developers</link></li>
</ul>
<anchor name="done"/>
<s3 title="Changes since &xslt4j; 2.2">
@@ -97,7 +97,7 @@
<li>If an attempt is made to coerce a different namespace onto a prefix
already in use in xsl:attribute, the attribute will come out
in the wrong namespace. Workaround: either provide an NCName instead of
a QName for the attribute, or provide a QName with a prefix not
used elsewhere.<br/><br/></li>
- <li>Handling xsl:namespace-alias declarations: In release 2.0.D01, we
reported the need to do some research concerning exactly how Xalan
+ <li>Handling xsl:namespace-alias declarations: In release 2.0.D01, we
reported the need to do some research concerning exactly how &xslt;
should handle xsl:namespace-alias declarations. As a result of
discussions among members of the W3C Working Group on XSL, we have reached a
more precise consensus on how namespaces should be represented when an
xsl:namespace-alias declaration is in effect.<br/><br/>
If a literal result element has a namespace prefix, the prefix will be
preserved and the namespace URI of the element will be as
@@ -138,25 +138,17 @@
<p>We strongly encourage you write patches for problems you find and
submit them to
[EMAIL PROTECTED] We review the patches we receive to make sure they
do not break something else, and (assuming they
do not) include them in our next release. In the interest of fixing
bugs, adding enhancements, and addressing outstanding design
- issues, we sincerely want (and need!) your active participation in the
ongoing development of Xalan.</p>
+ issues, we sincerely want (and need!) your active participation in the
ongoing development of &xslt;.</p>
</s3>
<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 Xalan and Xerces builds are not in synch. If you download an update to
Xalan, check the release notes to determine which version of Xerces you should
use.</p>
- <note>You can use Xalan with other XML parsers that implement the
<resource-ref idref="jaxp"/>. See
+ <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>
</s3>
- <anchor name="to-do"/>
- <s3 title="To-do tasks">
- <p>For a list of goals, tasks, and target dates for completion, see
<jump href="todo.html">Xalan-Java Version 2: Things To Do</jump>.
- As tasks are completed, they are moved from the to-do list to
- <jump href="todo.html#release-date-completed">Completed</jump>.</p>
- <p>The source document for the to-do list is an active document in
the Apache CVS repository:
- <jump
href="http://xml.apache.org/websrc/cvsweb.cgi/xml-xalan/java/todo.xml">xml-xalan/java/todo.xml</jump>.</p>
- </s3>
</s2>
<anchor name="build"/>
<s2 title="Build Notes">
1.50 +1 -1 xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml
Index: usagepatterns.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -r1.49 -r1.50
--- usagepatterns.xml 30 Jan 2002 22:23:12 -0000 1.49
+++ usagepatterns.xml 8 Feb 2002 15:56:32 -0000 1.50
@@ -118,7 +118,7 @@
</s2><anchor name="plug"/>
<s2 title="Plugging in a Transformer and XML parser">
<p>The Java API for XML Processing interfaces enable you to isolate your
application from the internal implementation details of a given Transformer,
SAX parser, or DOM parser. For each of these objects, there is an abstract
Factory class with a static newInstance() method that instantiates a concrete
Factory which wraps the underlying implementation. These newInstance() methods
use system property settings to determine which implementation to
instantiate.</p>
-<p>&xslt4j; is distributed with a system property setting for the Xalan XSLT
Transformer. This setting is in xalan.jar in META-INF/services (see
src/META-INF/services).</p>
+<p>&xslt4j; is distributed with a system property setting for the &xslt4j;
processor. This setting is in xalan.jar in META-INF/services (see
src/META-INF/services).</p>
<gloss>
<label>System property</label>
<item>Setting</item>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]