[docbook-checkins] CVS: xsl/docsrc extensions.xml,1.1,1.2

[Norman W. <nw...@us...>]

Update of /cvsroot/docbook/xsl/docsrc
In directory usw-pr-cvs1:/tmp/cvs-serv5448

Modified Files:
	extensions.xml 
Log Message:
Improved instructions for using Saxon/Xalan extensions

Index: extensions.xml
===================================================================
RCS file: /cvsroot/docbook/xsl/docsrc/extensions.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** extensions.xml	2001/04/02 13:03:43	1.1
--- extensions.xml	2001/09/29 17:00:58	1.2
***************
*** 1,8 ****
  <chapter>
! <title>Saxon Extensions</title>
  <?dbhtml filename="extensions.html"?>
  
! <para>Beginning with release 1.25, the DocBook XSL Stylesheets include
! a set of Java extensions for Saxon.</para>
  
  <para>These extensions enable callouts, numbered program listings, and
--- 1,7 ----
  <chapter>
! <title>Extensions</title>
  <?dbhtml filename="extensions.html"?>
  
! <para>Extensions are supported in recent releases of Saxon and Xalan.</para>
  
  <para>These extensions enable callouts, numbered program listings, and
***************
*** 74,83 ****
  </programlistingco>
  
  <section><title>Installation</title>
  
  <para>The extensions are included in the distribution in
! <filename>extensions/nwalsh.jar</filename>. Just make sure that jar
! file is in your CLASSPATH when you run Saxon.</para>
  
  </section>
  
--- 73,94 ----
  </programlistingco>
  
+ <section>
+ <title>Saxon Extensions</title>
+ 
+ <para>The DocBook XSL Stylesheets include a set of Java extensions for
+ Saxon.</para>
+ 
  <section><title>Installation</title>
  
  <para>The extensions are included in the distribution in
! <filename>extensions/saxon642.jar</filename> and
! <filename>extensions/saxon643.jar</filename>. Use the former for Saxon
! version 6.4.2 and the latter for Saxon 6.4.3 or Saxon 6.4.4.  Saxon
! version 6.4.1 and all prior releases contained a significant bug, they
! are not supported.</para>
  
+ <para>Just make sure that the right jar file is in your CLASSPATH when
+ you run Saxon.</para>
+ 
  </section>
  
***************
*** 92,95 ****
--- 103,137 ----
  <olink type="title" localinfo="html/param.html"
                      targetdocent="html-param.xml"/>.</para>
+ </section>
+ </section>
+ 
+ <section>
+ <title>Xalan Extensions</title>
+ 
+ <para>The DocBook XSL Stylesheets include a set of Java extensions for
+ XalanJ version 2. Extensions are not provided for XalanC at this time.</para>
+ 
+ <section><title>Installation</title>
+ 
+ <para>The extensions are included in the distribution in
+ <filename>extensions/xalan2.jar</filename>.
+ Xalan 1 is not supported.</para>
+ 
+ <para>Just make sure that the jar file is in your CLASSPATH when
+ you run Xalan.</para>
+ 
+ </section>
+ 
+ <section><title>Using the Extensions</title>
+ 
+ <para>For compatibility with other processors, the extensions are disabled
+ by default. To enable the extensions, turn on
+ <literal>$xalan.extensions</literal>, for example by passing
+ <literal>-PARAM xalan.extensions 1</literal> to Xalan.</para>
+ 
+ <para>For more control over the specific extensions, see
+ <olink type="title" localinfo="html/param.html"
+                     targetdocent="html-param.xml"/>.</para>
+ </section>
  </section>