svn commit: r817850 - /db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita

[ch...@apache.org]

Author: chaase3
Date: Tue Sep 22 21:36:04 2009
New Revision: 817850

URL: http://svn.apache.org/viewvc?rev=817850&view=rev
Log:
DERBY-4377: Developer's Guide statement on shutting down Derby needs 
qualification

Added more information to topic on shutting down Derby and databases.

Patch: DERBY-4377-3.diff

Modified:
    db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita

Modified: db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita?rev=817850&r1=817849&r2=817850&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita Tue Sep 22 21:36:04 2009
@@ -22,8 +22,8 @@
 <title>Shutting down Derby or an individual database</title>
 <shortdesc>Applications in an embedded environment shut down the <ph conref="../conrefs.dita#prod/productshortname"></ph> system
 by specifying the <i>shutdown=true</i> attribute in the connection URL. To
-shut down the system, you do not specify a database name, and you must not
-specify any other attribute.</shortdesc>
+shut down the system, you do not specify a database name, and you do not
+ordinarily specify any other attribute.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>Shutting down a single database</indexterm><indexterm>Shutting
 down Derby<indexterm>using database connection URL attribute</indexterm></indexterm>
@@ -33,7 +33,14 @@
 <taskbody>
 <context> <codeblock>jdbc:derby:;<ph>shutdown=true</ph></codeblock><p>A successful
 shutdown always results in an <i>SQLException</i> to indicate that <ph conref="../conrefs.dita#prod/productshortname"></ph> has
-shut down and that there is no other exception.</p><p>You can also shut down
+shut down and that there is no other exception.</p>
+<p>If you have enabled <ph conref="../conrefs.dita#prod/productshortname"></ph>
+BUILTIN user authentication and created some users at the system level (for
+example, by setting some usernames and passwords in the <i>derby.properties</i>
+file), you will need to specify credentials (that is, a username and password)
+in order to shut down a <ph conref="../conrefs.dita#prod/productshortname"></ph>
+system.</p>
+<p>You can also shut down
 an individual database if you specify the <i>databaseName</i>. You can shut
 down the database of the current connection if you specify the default connection
 instead of a database name<i> </i>(within an SQL statement).</p><codeblock><b>// shutting down a database from your application</b>