Return-Path: 
 <derby-commits-return-4602-apmail-db-derby-commits-archive=db.apache.org@db.apache.org>
Delivered-To: apmail-db-derby-commits-archive@www.apache.org
Received: (qmail 9904 invoked from network); 23 Aug 2006 18:57:42 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 23 Aug 2006 18:57:42 -0000
Received: (qmail 21886 invoked by uid 500); 23 Aug 2006 18:57:42 -0000
Delivered-To: apmail-db-derby-commits-archive@db.apache.org
Received: (qmail 21807 invoked by uid 500); 23 Aug 2006 18:57:42 -0000
Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:derby-commits-help@db.apache.org>
list-unsubscribe: <mailto:derby-commits-unsubscribe@db.apache.org>
List-Post: <mailto:derby-commits@db.apache.org>
Reply-To: "Derby Development" <derby-dev@db.apache.org>
List-Id: <derby-commits.db.apache.org>
Delivered-To: mailing list derby-commits@db.apache.org
Received: (qmail 21796 invoked by uid 99); 23 Aug 2006 18:57:42 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 23 Aug 2006 11:57:42 -0700
X-ASF-Spam-Status: No, hits=-9.4 required=10.0
	tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Received: from [140.211.166.113] (HELO eris.apache.org) (140.211.166.113)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 23 Aug 2006 11:57:41 -0700
Received: by eris.apache.org (Postfix, from userid 65534)
	id E1A8E1A981A; Wed, 23 Aug 2006 11:57:20 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r434125 - in /db/derby/docs/trunk/src/devguide:
 cdevdvlp30653.dita cdevstandards805975.dita cdevstandardsxml.dita
 derbydev.ditamap
Date: Wed, 23 Aug 2006 18:57:20 -0000
To: derby-commits@db.apache.org
From: jta@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20060823185720.E1A8E1A981A@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: jta
Date: Wed Aug 23 11:57:19 2006
New Revision: 434125

URL: http://svn.apache.org/viewvc?rev=434125&view=rev
Log:
DERBY-1655: Documentation for XML functionality to the Developers Guide.

Reverted the patch committed in revision 433708 because the addition of
src/devguide/cdevstandardsxml.dita (or perhaps the corresponding modification
to src/devguide/derbydev.ditamap) causes the DITA PDF build to fail.

Removed:
    db/derby/docs/trunk/src/devguide/cdevstandardsxml.dita
Modified:
    db/derby/docs/trunk/src/devguide/cdevdvlp30653.dita
    db/derby/docs/trunk/src/devguide/cdevstandards805975.dita
    db/derby/docs/trunk/src/devguide/derbydev.ditamap

Modified: db/derby/docs/trunk/src/devguide/cdevdvlp30653.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevdvlp30653.dita?rev=434125&r1=434124&r2=434125&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevdvlp30653.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevdvlp30653.dita Wed Aug 23 11:57:19 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
- 
+
 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
  "../dtd/concept.dtd">
 <!-- 
@@ -19,28 +19,31 @@
 limitations under the License.
 -->
 <concept id="cdevdvlp30653" xml:lang="en-us">
-<title><ph conref="devconrefs.dita#prod/productshortname"></ph> database limitations</title>
+<title>Database limitations</title>
 <shortdesc><ph conref="devconrefs.dita#prod/productshortname"></ph> databases
 have a few limitations.</shortdesc>
 <prolog><metadata>
-<keywords><indexterm>limitations<indexterm>Derby databases</indexterm></indexterm>
-<indexterm>indexes<indexterm>limitations</indexterm></indexterm></keywords>
+<keywords><indexterm>Limitations<indexterm>in current version</indexterm></indexterm>
+<indexterm>Indexes<indexterm>limitations of</indexterm><indexterm>not supported
+for CLOB, BLOB, and LONG VARCHAR data types</indexterm></indexterm></keywords>
 </metadata></prolog>
 <conbody>
-<section><title>Indexes</title><p>Indexes are not supported for columns defined
-on CLOB, BLOB, LONG VARCHAR, and XML data types.</p><p>If the length of the
-key columns in an index is larger than half the page size of the index, creating
-an index on those key columns for the table fails. For existing indexes, an
-insert of new rows for which the key columns are larger than half of the index
-page size causes the insert to fail.</p><p>Avoid creating indexes on long
-columns. Create indexes on small columns that provide a quick look-up to larger,
-unwieldy data in the row. You might not see performance improvements if you
-index long columns. For information about indexes, see <cite><ph conref="devconrefs.dita#pub/cittuning"></ph></cite>. </p></section>
-<section><title>System shutdowns</title><p>The system shuts down if the database
-log cannot allocate more disk space.</p><p>A "LogFull" error or some sort
-of <codeph>IOException</codeph> occurs in the <filepath>derby.log</filepath> file
-when the system runs out of space. If the system has no more disk space to
-append to the <filepath>derby.log</filepath> file, you might not see the error
-messages.</p></section>
+<ul>
+<li><i>Indexes are not supported for columns defined on CLOB, BLOB, and LONG
+VARCHAR data types.</i>   <p>If the length of the key columns in an index
+is larger than half the page size of the index, creating an index on those
+key columns for the table fails. For existing indexes, an insert of new rows
+for which the key columns are larger than half of the index page size causes
+the insert to fail.</p> <p>It is generally not recommended to create indexes
+on long columns. It is best to create indexes on small columns that provide
+a quick look-up to larger, unwieldy data in the row. You might not see performance
+improvements if you index long columns. For information about indexes, see <cite><ph
+conref="devconrefs.dita#pub/cittuning"></ph></cite>. </p></li>
+<li><i>The system shuts down if the database log cannot allocate more disk
+space.</i>   <p>A "LogFull" error or some sort of <codeph><i>IOException</i></codeph> will
+occur in the <i>derby.log </i> if the system runs out of space. If the system
+has no more disk space to append to the <i>derby.log</i>, you might not see
+the error messages.</p></li>
+</ul>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/devguide/cdevstandards805975.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevstandards805975.dita?rev=434125&r1=434124&r2=434125&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevstandards805975.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevstandards805975.dita Wed Aug 23 11:57:19 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
- 
+
 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
  "../dtd/concept.dtd">
 <!-- 
@@ -19,13 +19,10 @@
 limitations under the License.
 -->
 <concept id="cdevstandards805975" xml:lang="en-us">
-<title>CLOB and BLOB</title>
+<title>CLOB, and BLOB</title>
 <shortdesc><ph conref="devconrefs.dita#prod/productshortname"></ph> supports
 the standard CLOB and BLOB data types. BLOB and CLOB values are limited to
 a maximum of 2,147,483,647 characters.</shortdesc>
-<prolog><metadata>
-<keywords><indexterm>data types<indexterm>CLOB</indexterm></indexterm><indexterm>data
-types<indexterm>BLOB</indexterm></indexterm></keywords>
-</metadata></prolog>
+<prolog></prolog>
 <conbody></conbody>
 </concept>

Modified: db/derby/docs/trunk/src/devguide/derbydev.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/derbydev.ditamap?rev=434125&r1=434124&r2=434125&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/derbydev.ditamap (original)
+++ db/derby/docs/trunk/src/devguide/derbydev.ditamap Wed Aug 23 11:57:19 2006
@@ -1817,7 +1817,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1840,7 +1840,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1862,7 +1862,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1883,7 +1883,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1903,7 +1903,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1921,7 +1921,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1937,7 +1937,7 @@
 </topicref>
 <topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
 </topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1963,7 +1963,7 @@
 </topicref>
 </relcell>
 <relcell>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
 <topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
@@ -1971,7 +1971,7 @@
 </relrow>
 <relrow>
 <relcell>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB and BLOB"></topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
 </relcell>
 <relcell>
 <topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
@@ -1997,13 +1997,6 @@
 <topicref href="cdevdvlp40724.dita" navtitle="The database directory"></topicref>
 </relcell>
 </relrow>
-<relrow>
-<relcell>
-<topicref href="cdevstandardsxml.dita" navtitle="XML data types and operators">
-</topicref>
-</relcell>
-<relcell></relcell>
-</relrow>
 </reltable>
 <topicref href="rdevcopyright.dita" navtitle="Copyright"></topicref>
 <topicref href="cdevdgpref29520.dita" navtitle="About this guide">
@@ -2442,26 +2435,24 @@
 <topicref href="cdevin38113.dita" navtitle="Messages libraries"></topicref>
 </topicref>
 <topicref href="cdevstandards806118.dita" navtitle="Derby and standards">
-<topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
-<topicref href="cdevstandards805768.dita" navtitle="Calling functions and procedures">
-</topicref>
-<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
-<topicref href="cdevstandards805664.dita" navtitle="Cursors"></topicref>
-<topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
-</topicref>
 <topicref href="cdevstandards805644.dita" navtitle="Dynamic SQL"></topicref>
-<topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
-</topicref>
+<topicref href="cdevstandards805664.dita" navtitle="Cursors"></topicref>
 <topicref href="cdevstandards805690.dita" navtitle="Information schema"></topicref>
-<topicref href="cdevstandards805893.dita" navtitle="NOT NULL characteristic">
-</topicref>
 <topicref href="cdevstandards805716.dita" navtitle="Transactions"></topicref>
 <topicref href="cdevstandards805742.dita" navtitle="Stored routines and PSM">
 </topicref>
+<topicref href="cdevstandards805768.dita" navtitle="Calling functions and procedures">
+</topicref>
 <topicref href="cdevstandards805841.dita" navtitle="Unique constraints and nulls">
 </topicref>
-<topicref href="cdevstandardsxml.dita" navtitle="XML data types and operators">
+<topicref href="cdevstandards805893.dita" navtitle="NOT NULL characteristic">
+</topicref>
+<topicref href="cdevstandards805949.dita" navtitle="DECIMAL max precision">
+</topicref>
+<topicref href="cdevstandards805975.dita" navtitle="CLOB, and BLOB"></topicref>
+<topicref href="cdevstandards806001.dita" navtitle="Expressions on LONGs">
 </topicref>
+<topicref href="cdevstandards806027.dita" navtitle="ALTER TABLE"></topicref>
 </topicref>
 <topicref href="rdevtrademderby.dita" navtitle="Trademarks"></topicref>
 </map>