svn commit: r582235 - in /db/derby/docs/trunk/src/ref: refderby.ditamap rrefattribupgrade.dita

[ka...@apache.org]

Author: kahatlen
Date: Fri Oct  5 05:55:05 2007
New Revision: 582235

URL: http://svn.apache.org/viewvc?rev=582235&view=rev
Log:
DERBY-2680: Reference manual section "Setting attributes.." lacks upgrade=true attribute

Contributed by Kim Haase.

Added:
    db/derby/docs/trunk/src/ref/rrefattribupgrade.dita   (with props)
Modified:
    db/derby/docs/trunk/src/ref/refderby.ditamap

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=582235&r1=582234&r2=582235&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Fri Oct  5 05:55:05 2007
@@ -609,6 +609,8 @@
 </topicref>
 <topicref href="rrefattrib56769.dita" navtitle="territory=ll_CC attribute">
 </topicref>
+<topicref href="rrefattribupgrade.dita" navtitle="upgrade=true attribute">
+</topicref>
 <topicref href="rrefattrib10035.dita" navtitle="user=userName attribute">
 </topicref>
 <topicref href="rrefattribssl.dita" navtitle="ssl=sslMode attribute"></topicref>

Added: db/derby/docs/trunk/src/ref/rrefattribupgrade.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribupgrade.dita?rev=582235&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribupgrade.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribupgrade.dita Fri Oct  5 05:55:05 2007
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefattribupgrade" xml:lang="en-us">
+<title>upgrade=true attribute</title>
+<prolog>
+<metadata><keywords>
+<indexterm>upgrade=true database connection URL attribute</indexterm>
+</keywords></metadata>
+</prolog>
+<refbody>
+<section><title>Function</title>
+<p>Upgrades a database that was created using an earlier version of
+<ph conref="../conrefs.dita#prod/productshortname"></ph> to the current version
+of <ph conref="../conrefs.dita#prod/productshortname"></ph>, then connects to
+it. If the database does not exist, an error appears in the error log and the
+connection attempt fails with an <i>SQLException</i> indicating that the
+database cannot be found.</p>
+<p>This operation performs a full upgrade, as defined in "Upgrading a database"
+in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>. For more information
+about upgrades, see the other topics under "Upgrades" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+<p>For a database for which authentication and SQL authorization are both
+enabled, only the <xref href="rrefattrib26867.dita#rrefattrib26867">database
+owner</xref> can perform a full upgrade. See also "Enabling user
+authentication" and "Setting the SQL standard authorization mode" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph> for more information.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You must specify a <i>databaseName</i> (after the subprotocol in the
+database connection URL) or a
+<i><xref href="rrefattrib17246.dita#rrefattrib17246">databaseName=nameofDatabase</xref></i>
+attribute with this attribute.</p>
+<p>You cannot combine this attribute with the
+<i><xref href="rrefattribcollation.dita#rrefattribcollation">collation</xref></i>
+or <i><xref href="rrefattrib56769.dita#rrefattrib56769">territory=ll_CC</xref></i>
+attributes.</p>
+</section>
+<example>
+<codeblock><b>jdbc:derby:sampleDB;upgrade=true
+
+jdbc:derby:;databaseName=sampleDB;upgrade=true;</b></codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribupgrade.dita
------------------------------------------------------------------------------
    svn:eol-style = native