cmlenz 02/03/18 06:25:49
Modified: src/doc Tag: SLIDE_1_0 howto-tomcat.xml howto-jdbcstore.xml
src/doc/stylesheets Tag: SLIDE_1_0 slide.xsl
Log:
Port documentation improvements from the HEAD branch:
- slide.xsl: "index/split subsections"
- howto-tomcat.xml: update
- howto-jdbcstore.xml: various improvements and fixes
Revision Changes Path
No revision
No revision
1.14.2.1 +10 -4 jakarta-slide/src/doc/howto-tomcat.xml
Index: howto-tomcat.xml
===================================================================
RCS file: /home/cvs/jakarta-slide/src/doc/howto-tomcat.xml,v
retrieving revision 1.14
retrieving revision 1.14.2.1
diff -u -r1.14 -r1.14.2.1
--- howto-tomcat.xml 11 Sep 2001 06:48:09 -0000 1.14
+++ howto-tomcat.xml 18 Mar 2002 14:25:48 -0000 1.14.2.1
@@ -34,7 +34,7 @@
<section name="Tomcat 3.x">
<p>
- Slide has been successfully tested with Tomcat 3.1 and 3.2.
+ Slide has been successfully tested with Tomcat 3.1.x, 3.2.x and 3.3.x.
</p>
<p>
@@ -43,8 +43,14 @@
</p>
<p>
- Important note : Some versions of Tomcat 3.x can report a
- java.util.MIssingResourceException when excuting a PROPFIND request.
+ Versions of AJP prior to 1.3 had issues with uploading resources,
+ especially when using chunking, so using them is not recommended with
+ Slide. AJP 1.3 support is included in Tomcat 3.3.x.
+ </p>
+
+ <p>
+ Important note : Versions of Tomcat prior to 3.3.x can report a
+ java.util.MissingResourceException when excuting a PROPFIND request.
This exception is harmless and can be ignored.
</p>
@@ -53,7 +59,7 @@
<section name="Tomcat 4.x">
<p>
- Slide has been successfully tested with Tomcat 4.0 or later. Use
+ Slide has been successfully tested with Tomcat 4.0.x. Use
of Slide with Tomcat 4.0 versions prior to beta 2 is not recommended
due to classloading issues.
</p>
1.7.2.1 +76 -24 jakarta-slide/src/doc/howto-jdbcstore.xml
Index: howto-jdbcstore.xml
===================================================================
RCS file: /home/cvs/jakarta-slide/src/doc/howto-jdbcstore.xml,v
retrieving revision 1.7
retrieving revision 1.7.2.1
diff -u -r1.7 -r1.7.2.1
--- howto-jdbcstore.xml 11 Sep 2001 00:37:36 -0000 1.7
+++ howto-jdbcstore.xml 18 Mar 2002 14:25:48 -0000 1.7.2.1
@@ -37,7 +37,7 @@
</section>
- <section name="Tables">
+ <section name="Tables" split-subsections="true">
<p>
This section presents the database schema which is used by the JDBC
@@ -66,7 +66,7 @@
<subsection name="Links">
<ul>
- <li>uri: String</li>
+ <li>link: String</li>
<li>linkto: String</li>
</ul>
@@ -94,7 +94,7 @@
<li>type: String</li>
<li>expirationdate: String</li>
<li>inheritable: int</li>
- <li>xeclusive: int</li>
+ <li>xexclusive: int</li>
</ul>
</subsection>
@@ -133,7 +133,7 @@
<ul>
<li>uri: String</li>
- <li>xnumebr: String</li>
+ <li>xnumber: String</li>
<li>childnumber: String</li>
</ul>
@@ -184,13 +184,16 @@
</subsection>
</section>
-
- <section name="Hypersonic SQL">
-
+
+ <section name="Database creation scripts">
<p>
- The initialization script for hSQL is the one which is run at the
- startup of the store.
+ The initialization script for Hypersonic SQL is the one which is run at the
+ startup of the default JDBC store.
</p>
+
+ <subsection-index title="Supported databases:"/>
+
+ <subsection name="Hypersonic SQL">
<p>
<pre>
@@ -235,9 +238,9 @@
</pre>
</p>
- </section>
+ </subsection>
- <section name="mySQL">
+ <subsection name="mySQL">
<p>
<pre>
@@ -281,9 +284,56 @@
</pre>
</p>
- </section>
+ </subsection>
+
+ <subsection name="PostgreSQL">
+
+ <p>
+<pre>
+create table objects(uri varchar(3200) primary key, classname varchar(4000));
+
+create table children(uri varchar(4000), childuri varchar(4000));
+
+create table links(link varchar(4000), linkto varchar(4000));
+
+create table permissions(object varchar(4000), revisionnumber varchar(20),
+ subject varchar(4000), action varchar(4000), inheritable int, negative int);
+
+create table locks(id varchar(4000), object varchar(4000),
+ subject varchar(4000), type varchar(4000),
+ expirationdate varchar(15), inheritable int, xexclusive int);
+
+create table revisions(uri varchar(3200) primary key,
+ isversioned int, initialrevision varchar(10));
+
+create table workingrevision(uri varchar(4000),
+ baserevision varchar(20), xnumber varchar(20));
+
+create table latestrevisions(uri varchar(4000),
+ branchname varchar(4000), xnumber varchar(20));
+
+create table branches(uri varchar(4000), xnumber varchar(20),
+ childnumber varchar(20));
+
+create table revision(uri varchar(4000), xnumber varchar(20),
+ branchname varchar(4000));
+
+create table label(uri varchar(4000), xnumber varchar(20),
+ label varchar(4000));
+
+create table property(uri varchar(4000), xnumber varchar(20),
+ name varchar(4000), value varchar(4000), namespace varchar(4000),
+ type varchar(100), protected int);
+
+create table revisioncontent(uri varchar(4000), xnumber varchar(20),
+ content oid);
+
+</pre>
+ </p>
+
+ </subsection>
- <section name="Oracle 8i">
+ <subsection name="Oracle 8i">
<p>
<pre>
@@ -327,9 +377,9 @@
</pre>
</p>
- </section>
+ </subsection>
- <section name="Cloudscape">
+ <subsection name="Cloudscape">
<p>
<pre>
@@ -373,9 +423,9 @@
</pre>
</p>
- </section>
+ </subsection>
- <section name="Microsoft SQL Server">
+ <subsection name="Microsoft SQL Server">
<p>
<pre>
@@ -393,16 +443,17 @@
create table locks(id uri, object uri, subject uri, type uri,
expirationdate varchar(15), inheritable int, xexclusive int);
-create table revisions(uri uri primary key, isversioned int, initialrevision
varchar(10) );
+create table revisions(uri uri primary key,
+ isversioned int, initialrevision varchar(10) );
-create table workingrevision(uri uri, baserevision varchar(20), xnumber
- varchar(20) );
+create table workingrevision(uri uri, baserevision varchar(20),
+ xnumber varchar(20) );
-create table latestrevisions(uri uri, branchname text, xnumber
- varchar(20) );
+create table latestrevisions(uri uri, branchname text,
+ xnumber varchar(20) );
-create table branches(uri uri, xnumber varchar(20), childnumber
- varchar(20) );
+create table branches(uri uri, xnumber varchar(20),
+ childnumber varchar(20) );
create table revision(uri uri, xnumber varchar(20), branchname text);
@@ -415,6 +466,7 @@
</pre>
</p>
+ </subsection>
</section>
</body>
No revision
No revision
1.4.2.1 +47 -2 jakarta-slide/src/doc/stylesheets/slide.xsl
Index: slide.xsl
===================================================================
RCS file: /home/cvs/jakarta-slide/src/doc/stylesheets/slide.xsl,v
retrieving revision 1.4
retrieving revision 1.4.2.1
diff -u -r1.4 -r1.4.2.1
--- slide.xsl 24 Sep 2001 21:59:43 -0000 1.4
+++ slide.xsl 18 Mar 2002 14:25:49 -0000 1.4.2.1
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- Temporary Stylesheet for Catalina Developer Documentation -->
-<!-- $Id: slide.xsl,v 1.4 2001/09/24 21:59:43 cmlenz Exp $ -->
+<!-- $Id: slide.xsl,v 1.4.2.1 2002/03/18 14:25:49 cmlenz Exp $ -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
version="1.0">
@@ -157,11 +157,42 @@
</td></tr>
<!-- Section body -->
<tr><td><blockquote>
- <xsl:apply-templates/>
+ <xsl:if test="not(@split-subsections)">
+ <xsl:apply-templates/>
+ </xsl:if>
+ <xsl:if test="@split-subsections">
+ <xsl:apply-templates select="p" />
+ <xsl:call-template name="split-subsections" />
+ </xsl:if>
</blockquote></td></tr>
</table>
</xsl:template>
+ <!-- display subsection in 2 columns -->
+ <xsl:template name="split-subsections">
+ <xsl:variable name="middle">
+ <xsl:value-of select="ceiling((count(subsection) div 2))"/>
+ </xsl:variable>
+
+ <table width="100%"><tr><td valign="top" width="45%">
+
+ <xsl:for-each select="subsection">
+ <xsl:if test="position() <= $middle">
+ <xsl:apply-templates select="." />
+ </xsl:if>
+ </xsl:for-each>
+
+ </td><td valign="top" width="10%"> </td><td valign="top" width="*">
+
+ <xsl:for-each select="subsection">
+ <xsl:if test="position() > $middle">
+ <xsl:apply-templates select="." />
+ </xsl:if>
+ </xsl:for-each>
+
+ </td></tr></table>
+
+ </xsl:template>
<!-- Process a documentation subsection -->
<xsl:template match="subsection">
@@ -180,6 +211,20 @@
<xsl:apply-templates/>
</blockquote></td></tr>
</table>
+ </xsl:template>
+
+ <!-- create an index of the subsections of the current section -->
+ <xsl:template match="section/subsection-index">
+ <table><th><td><xsl:value-of select="@title" /></td></th>
+ <tr><td>
+ <ul>
+ <xsl:for-each select="../subsection">
+ <li>
+ <a><xsl:attribute name="href">#<xsl:value-of select="@name"
/></xsl:attribute><xsl:value-of select="@name" /></a>
+ </li>
+ </xsl:for-each>
+ </ul>
+ </td></tr></table><br/>
</xsl:template>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
