svn commit: r1099817 - in /db/derby/docs/trunk/src/ref: refderby.ditamap rrefattribderegister.dita rrefattribretrievemsgtext.dita

[ch...@apache.org]

Author: chaase3
Date: Thu May  5 14:20:24 2011
New Revision: 1099817

URL: http://svn.apache.org/viewvc?rev=1099817&view=rev
Log:
DERBY-5191  Documentation needed for connection URL attribute retrieveMessageText

1 new Reference Manual topic, 1 modified, plus map file change. 

Patches: DERBY-5191-2.diff

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

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=1099817&r1=1099816&r2=1099817&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Thu May  5 14:20:24 2011
@@ -638,7 +638,7 @@ URL syntax"></topicref>
 </topicref>
 <topicref href="rrefattrib15290.dita" navtitle="dataEncryption=true attribute">
 </topicref>
-<topicref href="rrefattribderegister.dita" navtitle="deregister=true attribute">
+<topicref href="rrefattribderegister.dita" navtitle="deregister=false attribute">
 </topicref>
 <topicref href="rrefattribdrop.dita" navtitle="drop=true attribute">
 </topicref>
@@ -660,6 +660,8 @@ URL syntax"></topicref>
 </topicref>
 <topicref href="rrefrestorefrom.dita" navtitle="restoreFrom=path attribute">
 </topicref>
+<topicref href="rrefattribretrievemsgtext.dita" navtitle="retrieveMessageText=false attribute">
+</topicref>
 <topicref href="rrefrollforward.dita" navtitle="rollForwardRecoveryFrom=path attribute">
 </topicref>
 <topicref href="rrefattribsecmech.dita" navtitle="securityMechanism=value attribute">

Modified: db/derby/docs/trunk/src/ref/rrefattribderegister.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribderegister.dita?rev=1099817&r1=1099816&r2=1099817&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribderegister.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattribderegister.dita Thu May  5 14:20:24 2011
@@ -19,9 +19,9 @@ See the License for the specific languag
 limitations under the License.
 -->
 <reference id="rrefattribderegister" xml:lang="en-us">
-<title>deregister=true attribute</title>
+<title>deregister=false attribute</title>
 <prolog><metadata>
-<keywords><indexterm>deregister=true database connection URL
+<keywords><indexterm>deregister=false database connection URL
 attribute</indexterm>
 <indexterm>embedded driver<indexterm>deregistering</indexterm></indexterm>
 <indexterm>driver<indexterm>deregistering embedded</indexterm></indexterm>

Added: db/derby/docs/trunk/src/ref/rrefattribretrievemsgtext.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribretrievemsgtext.dita?rev=1099817&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribretrievemsgtext.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribretrievemsgtext.dita Thu May  5 14:20:24 2011
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribretrievemsgtext" xml:lang="en-us">
+<title>retrieveMessageText=false attribute</title>
+<prolog><metadata>
+<keywords><indexterm>retrieveMessageText=false database connection URL
+attribute</indexterm>
+<indexterm>messages<indexterm>turning off</indexterm></indexterm>
+<indexterm>exception messages<indexterm>turning off</indexterm></indexterm>
+<indexterm>attributes<indexterm>retrieveMessageText</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>If set to <i>true</i> (the default), retrieves the message text for each
+<i>SQLException</i> from the server. A stored procedure call retrieves the
+message text and may start a new unit of work.</p>
+<p>Set this property to false if you do not want the performance impact of the
+procedure call or do not want to start a new unit of work.</p>
+<p>This attribute is meaningful only if used with the network driver.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You can combine this attribute with other attributes.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>-- do not retrieve message text for SQLExceptions
+jdbc:derby:salesDB;retrieveMessageText=false
+</b></codeblock>
+</example>
+</refbody>
+</reference>

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