svn commit: r1537251 - in /db/derby/docs/trunk/src: adminguide/radminapps811974.dita ref/crefjavstateautogen.dita

[ch...@apache.org]

Author: chaase3
Date: Wed Oct 30 19:24:26 2013
New Revision: 1537251

URL: http://svn.apache.org/r1537251
Log:
DERBY-6389  Update adminguide's list of differences between client and embedded

Deleted an Admin Guide topic, modified a Reference Manual topic.

Patch: DERBY-6389-2.diff

Removed:
    db/derby/docs/trunk/src/adminguide/radminapps811974.dita
Modified:
    db/derby/docs/trunk/src/ref/crefjavstateautogen.dita

Modified: db/derby/docs/trunk/src/ref/crefjavstateautogen.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefjavstateautogen.dita?rev=1537251&r1=1537250&r2=1537251&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefjavstateautogen.dita (original)
+++ db/derby/docs/trunk/src/ref/crefjavstateautogen.dita Wed Oct 30 19:24:26 2013
@@ -28,9 +28,16 @@ limitations under the License.
 from columns that are part of an index or have a default value assigned. <ph
 conref="../conrefs.dita#prod/productshortname"></ph> supports the auto-increment
 feature, which allows users to create columns in tables for which the database
-system automatically assigns increasing integer values. Users can call the method <i>Statement.getGeneratedKeys</i>
-to retrieve the value of such a column. This method returns a <i>ResultSet</i> object
-with a column for the automatically generated key. Calling <i>ResultSet.getMetaData</i> on
+system automatically assigns increasing integer values. Users can call the
+method <i>Statement.getGeneratedKeys</i> to retrieve the value of such a column.
+This method returns a <i>ResultSet</i> object with a column for the
+automatically generated key. The
+<ph conref="../conrefs.dita#prod/productshortname"></ph> implementation of
+<i>Statement.getGeneratedKeys</i> returns meaningful results only if the last
+statement was a single-row insert statement. If it was a multi-row insert,
+<i>Statement.getGeneratedKeys</i> will return a result set with only a single
+row, even though it should return one row for each inserted row.</p>
+<p>Calling <i>ResultSet.getMetaData</i> on
 the <i>ResultSet</i> object returned by <i>getGeneratedKeys</i> produces a <i>ResultSetMetaData</i> object
 that is similar to that returned by <xref href="rrefidentityvallocal.dita#rrefidentityvallocal">IDENTITY_VAL_LOCAL</xref>. </p>
 <p> Users can indicate that auto-generated columns should be made available