dleslie 02/01/25 11:38:50
Modified: java/xdocs/sources/xalan readme.xml samples.xml
Log:
Removed InstantDB and added info on how to get and use the "Developer
license" copy.
Revision Changes Path
1.72 +11 -3 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.71
retrieving revision 1.72
diff -u -r1.71 -r1.72
--- readme.xml 24 Jan 2002 20:46:48 -0000 1.71
+++ readme.xml 25 Jan 2002 19:38:50 -0000 1.72
@@ -77,9 +77,17 @@
</ul>
<anchor name="done"/>
<s3 title="Changes since &xslt4j; 2.2">
- <p>This release does not include support for the deprecated &xslt4j; 1
compatability API.</p>
- <p>This release is integrated with release 2 of &xml4j;.</p>
- <note>The &xslt4j; 1 compatability code does NOT compile with
&xml4j2;</note>
+ <p>&xslt4j-current; includes a couple of global adjustments:</p>
+ <ul>
+ <li>This release is integrated with release 2 of &xml4j;.</li>
+ <li>This release does not include support for the deprecated &xslt4j; 1
compatability API. The &xslt4j; 1 compatability code does
+ NOT compile with &xml4j2;.</li>
+ </ul>
+ <p>Our <link idref="samples" anchor="sql">SQL extension samples</link>
continue to use InstantDB, but based on our realization of changes
+ that have occurred in the licensing of InstantDB, we no longer include
InstantDB and the associated sample database with our distibution.
+ We do, however, provide information on how to <link idref="samples"
anchor="instantdbsetup">set up InstantDB</link> to support our SQL
+ extension samples.</p>
+
&done-j;
</s3>
<anchor name="other"/>
1.44 +35 -18 xml-xalan/java/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- samples.xml 22 Jan 2002 17:25:36 -0000 1.43
+++ samples.xml 25 Jan 2002 19:38:50 -0000 1.44
@@ -354,14 +354,30 @@
<br/> <code>-xsl 5-numlistJscript.xsl</code></p>
</s3>
</s2><anchor name="sql"/>
- <s2 title="SQL Library extensions">
- <p>The SQL Library extension samples use <link idref="extensionslib"
anchor="sql">SQL library XConnection
- extension</link>to connect to an InstantDB datasource, perform
queries, and return query result sets.</p>
- <note>To run these samples, you must include idb.jar on the classpath.
We have placed a copy of idb.jar from
- InstantDB version 3.25 in samples/extensions/instantdb. For
information about InstantDB, see
- <jump
href="http://instantdb.enhydra.org/software/documentation/index.html";>InstantDB</jump>
- and the <jump
href="http://instantdb.enhydra.org/software/license/index.html";>Enydra Public
- License</jump>.</note>
+ <s2 title="SQL library extensions">
+ <p>The <link idref="extensionslib" anchor="sql">SQL library </link>
extension enables you to execute SQL queries from within a stylesheet,
+ and to incorporate query result sets in the XML output. To use the SQL
library, you need
+ a JDBC driver, the underying DBMS, and a database. Our samples use
Lutris® InstantDB, available "free of charge for research and
+ development use."</p><anchor name="instantdbsetup"/>
+ <s3 title="Setting up the InstantDB samples">
+ <p>To run the SQL library extension samples, do the following:</p>
+ <ol>
+ <li>Obtain a copy of InstantDB. You can download a free "Development
license" copy for research and development from
+ <jump href="http://www.lutris.com/downloads/index.html";>Lutris
Downloads</jump>.<br/><br/></li>
+ <li>Follow the instructions Lutris provides for installing InstantDB
and generating the sample database.<br/><br/></li>
+ <li>Add idb.jar and the Java Transaction API JAR (jta-spec1_0_1.jar in
the InstantDB 4.0 release) to the system class path.<br/><br/></li>
+ <li>Create an instantdb directory in the samples/extensions
subdirectory, and copy the sample database to instantdb. The sample database
+ is in the Examples subdirectory where you installed InstantDB. For our
purposes, it includes samples.prp and three subdirectories:
+ indexes, system, and tables.<br/><br/>
+ Alternative: You can adjust the references to samples.prp in the XSL
stylesheets and XML document dburl nodes to point to sample.prp in
+ its original location, in which case you do not need to copy the
samples database. For example, if you have installed InstantDB in /idb,
+ you can change 'jdbc:idb:./instantdb/sample.prp' in the XConnection
new() call in extensions/6-sqllib-instantdb to
+ 'jdbc:idb:/idb/Examples/sample.prp'.<br/><br/></li>
+ </ol>
+ <p>For more information about InstantDB, see the <jump
href="http://www.lutris.com/products/instantDB/software/documentation/";>InstantDB
+ Documentation</jump>.</p>
+ </s3>
+ <s3 title="SQL Library samples with InstantDB">
<ul>
<li><link anchor="ext6">6-sqllib-instantdb</link></li>
<li><link anchor="basic-conn">Basic Connections</link></li>
@@ -373,11 +389,11 @@
<note>Except for 6-sqllib-instantdb, all these samples have been
created by John Gentilin
([EMAIL PROTECTED]) to take illustrate the rich feature set he has
contributed to the SQL Library.
To run each of these samples, be sure you are in the appropriate
extensions/sql subdirectory.</note>
- <anchor name="ext6"/>
+ </s3><anchor name="ext6"/>
<s3 title="6-sqllib-instantdb">
<p>What it does: Uses the SQL library XConnection extension to connect
to the InstantDB sample database,
performs a query, and returns the query result in an HTML table.</p>
- <p>Add idb.jar to the classpath, and run this sample from the
extensions subdirectory:</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this
sample from the extensions subdirectory:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/> <code>-xsl 6-sqllib-instantdb.xsl -out
import1.html</code></p>
</s3><anchor name="basic-conn"/>
@@ -389,7 +405,7 @@
in the form of stylesheet parameters.</p>
<p>The second strategy is to get connection information from a nodeset
in an XML source document (dbInfo.xml).</p>
- <p>Add extensions/instantdb/idb.jar to the classpath, and run this
sample from the extensions/sql/basic-connection
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this
sample from the extensions/sql/basic-connection
directory.</p>
<p>1. To get connection information from the stylesheet:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
@@ -407,11 +423,12 @@
<p>What it does: The ExternalConnection classes uses the default
implementation of the ConnectionPool interface
to create a pool of connections. A stylesheet in turn uses a connection
from this pool to instantiate an
XConnection object and connect to a datasouce.</p>
- <p>The stylesheet uses this named connection pool to instantiate an
XConnection object and connect to the datasource.</p>
- <p>The ExternalConnection class is in xalansamples.jar. Be sure
xalansamples.jar and idb.jar are on the classpath, and
- run this sample from the extensions/sql/ext-connection directory:</p>
+ <p>The stylesheet uses this named connection pool to instantiate an
XConnection object and connect to the datasource.
+ The ExternalConnection class is in xalansamples.jar.</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, be sure
xalanxamples.jar is on the class path, and run this
+ sample from the extensions/sql/ext-connection directory:</p>
<p><code>java ExternalConnection</code></p>
- <p>ExternalConnection creates the ConnectionPool, and performs a
transformation wiht dbtest.xsl, which draws
+ <p>ExternalConnection creates the ConnectionPool, and performs a
transformation with dbtest.xsl, which draws
from the pool to instantiate an XConnection object, connect to the
datasource, execute a static query, and return the
query result.</p>
</s3><anchor name="pquery"/>
@@ -421,7 +438,7 @@
provides the parameter value as well as the connection information. The
parameter value is in a node in the XML source.</p>
<p>The stylesheet gets the required connection and parameter information
from the XML source, sets up and executes the
parameterized query, and retuns the query result set.</p>
- <p>Be sure idb.jar is on the classpath, and run this sample from the
sql/pquery subdirectory:</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this
sample from the sql/pquery subdirectory:</p>
<p><code>java org.apache.xalan.xslt.Process -in dbInfo.xml</code>
<br/><code>-xsl dbTest.xsl -out dbTest.html</code></p>
</s3><anchor name="streamable"/>
@@ -429,7 +446,7 @@
<p><em>Contributed by John Gentilin ([EMAIL PROTECTED]).</em></p>
<p>What it does: Illustrates enabling and disabling of caching the
streamable result set returned by a query.</p>
<p>The stylesheets use the XConnection enableCacheNodes() and
disableCacheNodes() methods.</p>
- <p>Be sure idb.jar is on the classpath, and run these samples from the
sql/streamable subdirectory.</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run these
samples from the sql/streamable subdirectory.</p>
<p>1. To turn caching on:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/><code>-xsl cachedNodes.xsl</code></p>
@@ -445,7 +462,7 @@
<source><xsl:variable name="table" select='sql:query($db,
$query)'/>
<xsl:apply-templates select="$table/row-set" />
<xsl:apply-templates select="$table/ext-error"/></source>
- <p>With idb.jar on the classpath, run this sample from the
extensions/sql/show-error subdirectory:</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this
sample from the extensions/sql/show-error subdirectory:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/><code> -xsl <ref>invalidSomething.xsl</ref> -out
dbtestout.html</code></p>
<p>where <ref>invalidSomething.xsl</ref> is <code>invalidConn.xsl</code>
(specifies a database that does not exist),
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
