[Hibernate-commits] Hibernate Code SVN: r9687 - trunk/Hibernate3/doc/reference/en/modules

[<hib...@li...>]

Author: ste...@jb...
Date: 2006-03-27 11:48:39 -0500 (Mon, 27 Mar 2006)
New Revision: 9687

Modified:
   trunk/Hibernate3/doc/reference/en/modules/architecture.xml
   trunk/Hibernate3/doc/reference/en/modules/basic_mapping.xml
   trunk/Hibernate3/doc/reference/en/modules/configuration.xml
Log:
various doc updates

Modified: trunk/Hibernate3/doc/reference/en/modules/architecture.xml
===================================================================
--- trunk/Hibernate3/doc/reference/en/modules/architecture.xml	2006-03-27 16:47:06 UTC (rev 9686)
+++ trunk/Hibernate3/doc/reference/en/modules/architecture.xml	2006-03-27 16:48:39 UTC (rev 9687)
@@ -297,7 +297,7 @@
             See the Javadocs for the <literal>org.hibernate.context.CurrentSessionContext</literal>
             interface for a detailed discussion of its contract.  It defines a single method,
             <literal>currentSession()</literal>, by which the implementation is responsible for
-            tracking the current contextual session.  Out-of-the-box, Hibernate comes with two
+            tracking the current contextual session.  Out-of-the-box, Hibernate comes with three
             implementations of this interface.
         </para>
 

Modified: trunk/Hibernate3/doc/reference/en/modules/basic_mapping.xml
===================================================================
--- trunk/Hibernate3/doc/reference/en/modules/basic_mapping.xml	2006-03-27 16:47:06 UTC (rev 9686)
+++ trunk/Hibernate3/doc/reference/en/modules/basic_mapping.xml	2006-03-27 16:48:39 UTC (rev 9687)
@@ -734,6 +734,20 @@
                             </para>
                         </listitem>
                         </varlistentry>
+                        <varlistentry>
+                        <term><literal>sequence-identity</literal></term>
+                        <listitem>
+                            <para>
+                                a specialized sequence generation strategy which utilizes a
+                                database sequence for the actual value generation, but combines
+                                this with JDBC3 getGeneratedKeys to actually return the generated
+                                identifier value as part of the insert statement execution.  This
+                                strategy is only known to be supported on Oracle 10g drivers
+                                targetted for JDK 1.4.  Note comments on these insert statements
+                                are disabled due to a bug in the Oracle drivers.
+                            </para>
+                        </listitem>
+                        </varlistentry>
                     </variablelist>
 
                 </para>

Modified: trunk/Hibernate3/doc/reference/en/modules/configuration.xml
===================================================================
--- trunk/Hibernate3/doc/reference/en/modules/configuration.xml	2006-03-27 16:47:06 UTC (rev 9686)
+++ trunk/Hibernate3/doc/reference/en/modules/configuration.xml	2006-03-27 16:48:39 UTC (rev 9687)
@@ -698,9 +698,17 @@
                             transaction strategy.
                             <para>
                                 <emphasis role="strong">eg.</emphasis> 
-                                <literal>on_close</literal> (default) | <literal>after_transaction</literal> |
-                                <literal>after_statement</literal> | <literal>auto</literal>
+                                <literal>auto</literal> (default) | <literal>on_close</literal> |
+                                <literal>after_transaction</literal> | <literal>after_statement</literal>
                             </para>
+                            <para>
+                                Note that this setting only affects <literal>Session</literal>s returned from
+                                <literal>SessionFactory.openSession</literal>.  For <literal>Session</literal>s
+                                obtained through <literal>SessionFactory.getCurrentSession</literal>, the
+                                <literal>CurrentSessionContext</literal> implementation configured for use
+                                controls the connection release mode for those <literal>Session</literal>s.
+                                See <xref linkend="architecture-current-session"/>
+                            </para>
                         </entry>
                     </row>
                     <row>