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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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 &quot;DOM006 Hierarchy request error&quot;">
     <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]

Reply via email to