From hibernate-commits at lists.jboss.org Fri Nov  2 10:27:42 2007
Content-Type: multipart/mixed; boundary="===============2262964641621511546=="
MIME-Version: 1.0
From: hibernate-commits at lists.jboss.org
To: hibernate-commits at lists.jboss.org
Subject: [hibernate-commits] Hibernate SVN: r14177 -
 core/trunk/documentation/manual/src/main/docbook/en-US/content.
Date: Fri, 02 Nov 2007 10:27:42 -0400
Message-ID: <E1InxUs-0006Oc-2S@committer01.frg.pub.inap.atl.jboss.com>

--===============2262964641621511546==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: steve.ebersole(a)jboss.com
Date: 2007-11-02 10:27:41 -0400 (Fri, 02 Nov 2007)
New Revision: 14177

Modified:
   core/trunk/documentation/manual/src/main/docbook/en-US/content/basic_map=
ping.xml
   core/trunk/documentation/manual/src/main/docbook/en-US/content/collectio=
n_mapping.xml
   core/trunk/documentation/manual/src/main/docbook/en-US/content/performan=
ce.xml
   core/trunk/documentation/manual/src/main/docbook/en-US/content/persisten=
t_classes.xml
   core/trunk/documentation/manual/src/main/docbook/en-US/content/tutorial.=
xml
Log:
corrected DTD incongruities

Modified: core/trunk/documentation/manual/src/main/docbook/en-US/content/ba=
sic_mapping.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- core/trunk/documentation/manual/src/main/docbook/en-US/content/basic_ma=
pping.xml	2007-11-02 04:31:34 UTC (rev 14176)
+++ core/trunk/documentation/manual/src/main/docbook/en-US/content/basic_ma=
pping.xml	2007-11-02 14:27:41 UTC (rev 14177)
@@ -1821,13 +1821,13 @@
                             <literal>entity-name</literal> (optional): The=
 entity name of the associated class.
                         </para>
                     </callout>
-                </calloutlist>
                     <callout arearefs=3D"manytoone16">
                         <para>
                             <literal>formula</literal> (optional): an SQL =
expression that defines the value for a
                             <emphasis>computed</emphasis> foreign key.
                         </para>
                     </callout>
+                </calloutlist>
             </programlistingco>
 =

             <para>

Modified: core/trunk/documentation/manual/src/main/docbook/en-US/content/co=
llection_mapping.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- core/trunk/documentation/manual/src/main/docbook/en-US/content/collecti=
on_mapping.xml	2007-11-02 04:31:34 UTC (rev 14176)
+++ core/trunk/documentation/manual/src/main/docbook/en-US/content/collecti=
on_mapping.xml	2007-11-02 14:27:41 UTC (rev 14177)
@@ -80,6 +80,14 @@
     <sect1 id=3D"collections-mapping" revision=3D"4">
         <title>Collection mappings</title>
 =

+        <tip>
+            <para>
+                There are quite a range of mappings that can be generated =
for collections, covering
+                many common relational models. We suggest you experiment w=
ith the schema generation tool
+                to get a feeling for how various mapping declarations tran=
slate to database tables.
+            </para>
+        </tip>
+
         <para>
             The Hibernate mapping element used for mapping a collection de=
pends upon
             the type of the interface. For example, a <literal>&lt;set&gt;=
</literal> =

@@ -409,12 +417,6 @@
             =

         </sect2>
 =

-        <para>
-            There are quite a range of mappings that can be generated for =
collections, covering =

-            many common relational models. We suggest you experiment with =
the schema generation tool =

-            to get a feeling for how various mapping declarations translat=
e to database tables.
-        </para>
-
     <sect2 id=3D"collections-ofvalues" revision=3D"2">
         <title>Collections of values and many-to-many associations</title>
 =


Modified: core/trunk/documentation/manual/src/main/docbook/en-US/content/pe=
rformance.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- core/trunk/documentation/manual/src/main/docbook/en-US/content/performa=
nce.xml	2007-11-02 04:31:34 UTC (rev 14176)
+++ core/trunk/documentation/manual/src/main/docbook/en-US/content/performa=
nce.xml	2007-11-02 14:27:41 UTC (rev 14177)
@@ -829,69 +829,79 @@
             </para>
 =

         </sect2>
-        =

-        <para>
-            None of the cache providers support all of the cache concurren=
cy strategies. The following table shows
-            which providers are compatible with which concurrency strategi=
es.
-        </para>
 =

-        <table frame=3D"topbot">
-            <title>Cache Concurrency Strategy Support</title>
-            <tgroup cols=3D'5' align=3D'left' colsep=3D'1' rowsep=3D'1'>
-            <colspec colname=3D'c1' colwidth=3D"1*"/>
-            <colspec colname=3D'c2' colwidth=3D"1*"/>
-            <colspec colname=3D'c3' colwidth=3D"1*"/>
-            <colspec colname=3D'c4' colwidth=3D"1*"/>
-            <colspec colname=3D'c5' colwidth=3D"1*"/>
-            <thead>
-            <row>
-              <entry>Cache</entry>
-              <entry>read-only</entry>
-              <entry>nonstrict-read-write</entry>
-              <entry>read-write</entry>
-              <entry>transactional</entry>
-            </row>
-            </thead>
-            <tbody>
-            <row>
-                <entry>Hashtable (not intended for production use)</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry></entry>
-            </row>
-            <row>
-                <entry>EHCache</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry></entry>
-            </row>
-            <row>
-                <entry>OSCache</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry></entry>
-            </row>
-            <row>
-                <entry>SwarmCache</entry>
-                <entry>yes</entry>
-                <entry>yes</entry>
-                <entry></entry>
-                <entry></entry>
-            </row>
-            <row>
-                <entry>JBoss TreeCache</entry>
-                <entry>yes</entry>
-                <entry></entry>
-                <entry></entry>
-                <entry>yes</entry>
-            </row>
-            </tbody>
-            </tgroup>
-        </table>
+        <sect2 id=3D"performance-cache-compat-matrix">
+            <title>Cache-provider/concurrency-strategy compatibility</titl=
e>
 =

+            <important>
+                <para>
+                    None of the cache providers support all of the cache c=
oncurrency strategies.
+                </para>
+            </important>
+
+            <para>
+                The following table shows which providers are compatible w=
ith which concurrency strategies.
+            </para>
+
+            <table frame=3D"topbot">
+                <title>Cache Concurrency Strategy Support</title>
+                <tgroup cols=3D'5' align=3D'left' colsep=3D'1' rowsep=3D'1=
'>
+                <colspec colname=3D'c1' colwidth=3D"1*"/>
+                <colspec colname=3D'c2' colwidth=3D"1*"/>
+                <colspec colname=3D'c3' colwidth=3D"1*"/>
+                <colspec colname=3D'c4' colwidth=3D"1*"/>
+                <colspec colname=3D'c5' colwidth=3D"1*"/>
+                <thead>
+                <row>
+                  <entry>Cache</entry>
+                  <entry>read-only</entry>
+                  <entry>nonstrict-read-write</entry>
+                  <entry>read-write</entry>
+                  <entry>transactional</entry>
+                </row>
+                </thead>
+                <tbody>
+                <row>
+                    <entry>Hashtable (not intended for production use)</en=
try>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry></entry>
+                </row>
+                <row>
+                    <entry>EHCache</entry>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry></entry>
+                </row>
+                <row>
+                    <entry>OSCache</entry>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry></entry>
+                </row>
+                <row>
+                    <entry>SwarmCache</entry>
+                    <entry>yes</entry>
+                    <entry>yes</entry>
+                    <entry></entry>
+                    <entry></entry>
+                </row>
+                <row>
+                    <entry>JBoss TreeCache</entry>
+                    <entry>yes</entry>
+                    <entry></entry>
+                    <entry></entry>
+                    <entry>yes</entry>
+                </row>
+                </tbody>
+                </tgroup>
+            </table>
+
+        </sect2>
+
     </sect1>
 =

     <sect1 id=3D"performance-sessioncache" revision=3D"2">

Modified: core/trunk/documentation/manual/src/main/docbook/en-US/content/pe=
rsistent_classes.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- core/trunk/documentation/manual/src/main/docbook/en-US/content/persiste=
nt_classes.xml	2007-11-02 04:31:34 UTC (rev 14176)
+++ core/trunk/documentation/manual/src/main/docbook/en-US/content/persiste=
nt_classes.xml	2007-11-02 14:27:41 UTC (rev 14177)
@@ -526,9 +526,12 @@
 =

     </sect1>
 =

-    <para>
-        TODO: Document user-extension framework in the property and proxy =
packages
-    </para>
+    <sect1 id=3D"persistent-classes-extensions">
+        <title>Extentsions</title>
+        <para>
+            TODO: Document user-extension framework in the property and pr=
oxy packages
+        </para>
+    </sect1>
 =

 </chapter>
 =


Modified: core/trunk/documentation/manual/src/main/docbook/en-US/content/tu=
torial.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- core/trunk/documentation/manual/src/main/docbook/en-US/content/tutorial=
.xml	2007-11-02 04:31:34 UTC (rev 14176)
+++ core/trunk/documentation/manual/src/main/docbook/en-US/content/tutorial=
.xml	2007-11-02 14:27:41 UTC (rev 14177)
@@ -1260,16 +1260,16 @@
 =

         </sect2>
 =

-        <para>
-            Let's turn this into a small web application.
-        </para>
-
     </sect1>
 =

     <sect1 id=3D"tutorial-webapp">
         <title>Part 3 - The EventManager web application</title>
 =

         <para>
+            Let's turn the following discussion into a small web applicati=
on...
+        </para>
+
+        <para>
             A Hibernate web application uses <literal>Session</literal> an=
d <literal>Transaction</literal>
             almost like a standalone application. However, some common pat=
terns are useful. We now write
             an <literal>EventManagerServlet</literal>. This servlet can li=
st all events stored in the


--===============2262964641621511546==--