svn commit: r1537259 - in /db/derby/docs/branches/10.10/src: adminguide/radminapps811974.dita ref/crefjavstateautogen.dita

[ch...@apache.org]

Author: chaase3
Date: Wed Oct 30 19:55:00 2013
New Revision: 1537259

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

Merged DERBY-6389-2.diff to 10.10 doc branch from trunk revision 1537251.

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

Modified: db/derby/docs/branches/10.10/src/ref/crefjavstateautogen.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/branches/10.10/src/ref/crefjavstateautogen.dita?rev=1537259&r1=1537258&r2=1537259&view=diff
==============================================================================
--- db/derby/docs/branches/10.10/src/ref/crefjavstateautogen.dita (original)
+++ db/derby/docs/branches/10.10/src/ref/crefjavstateautogen.dita Wed Oct 30 19:55:00 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