From hibernate-commits at lists.jboss.org Tue Feb 19 17:46:59 2008
Content-Type: multipart/mixed; boundary="===============5074256493081975442=="
MIME-Version: 1.0
From: hibernate-commits at lists.jboss.org
To: hibernate-commits at lists.jboss.org
Subject: [hibernate-commits] Hibernate SVN: r14341 -
 search/trunk/doc/reference/en/modules.
Date: Tue, 19 Feb 2008 17:46:59 -0500
Message-ID: <E1JRbEp-0007ZG-Ba@committer01.frg.pub.inap.atl.jboss.com>

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

Author: epbernard
Date: 2008-02-19 17:46:59 -0500 (Tue, 19 Feb 2008)
New Revision: 14341

Modified:
   search/trunk/doc/reference/en/modules/configuration.xml
Log:
more doc

Modified: search/trunk/doc/reference/en/modules/configuration.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
--- search/trunk/doc/reference/en/modules/configuration.xml	2008-02-19 19:1=
6:06 UTC (rev 14340)
+++ search/trunk/doc/reference/en/modules/configuration.xml	2008-02-19 22:4=
6:59 UTC (rev 14341)
@@ -503,6 +503,35 @@
           engine</para>
         </listitem>
       </itemizedlist>
+
+      <section>
+        <title>Hibernate Core 3.2.6 and beyond</title>
+
+        <para>If you use Hibernate Core 3.2.6 and beyond, make sure to add
+        three additional event listeners that cope with collection
+        events</para>
+
+        <programlisting>&lt;hibernate-configuration&gt;
+     &lt;session-factory&gt;
+        ...
+        &lt;event type=3D"post-collection-recreate"/&gt;
+            &lt;listener class=3D"org.hibernate.search.event.FullTextIndex=
CollectionEventListener"/&gt;
+        &lt;/event&gt;
+        &lt;event type=3D"post-collection-remove"/&gt;
+            &lt;listener class=3D"org.hibernate.search.event.FullTextIndex=
CollectionEventListener"/&gt;
+        &lt;/event&gt;
+        &lt;event type=3D"post-collection-update"/&gt;
+            &lt;listener class=3D"org.hibernate.search.event.FullTextIndex=
CollectionEventListener"/&gt;
+        &lt;/event&gt;
+    &lt;/session-factory&gt;
+&lt;/hibernate-configuration&gt;</programlisting>
+
+        <para>Those additional event listeners have been introduced in
+        Hibernate 3.2.6. note the
+        <classname>FullTextIndexCollectionEventListener</classname> usage.=
 You
+        need to explicitly reference those event listeners unless you use
+        Hibernate Annotations 3.3.1 and above.</para>
+      </section>
     </section>
 =

     <section>
@@ -542,30 +571,30 @@
     settings depending on the use case. During indexing operations trigger=
ed
     by database modifications, the following ones are used: <itemizedlist>
         <listitem>
-          <literal>hibernate.search.[default|&lt;indexname&gt;].transactio=
n.merge_factor</literal>
+          <para><literal>hibernate.search.[default|&lt;indexname&gt;].tran=
saction.merge_factor</literal></para>
         </listitem>
 =

         <listitem>
-          <literal>hibernate.search.[default|&lt;indexname&gt;].transactio=
n.max_merge_docs</literal>
+          <para><literal>hibernate.search.[default|&lt;indexname&gt;].tran=
saction.max_merge_docs</literal></para>
         </listitem>
 =

         <listitem>
-          <literal>hibernate.search.[default|&lt;indexname&gt;].transactio=
n.max_buffered_docs</literal>
+          <para><literal>hibernate.search.[default|&lt;indexname&gt;].tran=
saction.max_buffered_docs</literal></para>
         </listitem>
       </itemizedlist>When indexing occurs via
     <literal>FullTextSession.index()</literal> (see <xref
     linkend=3D"search-batchindex" />), the following properties are used:
     <itemizedlist>
         <listitem>
-          <literal>hibernate.search.[default|&lt;indexname&gt;].batch.merg=
e_factor</literal>
+          <para><literal>hibernate.search.[default|&lt;indexname&gt;].batc=
h.merge_factor</literal></para>
         </listitem>
 =

         <listitem>
-          <literal>hibernate.search.[default|&lt;indexname&gt;].batch.max_=
merge_docs</literal>
+          <para><literal>hibernate.search.[default|&lt;indexname&gt;].batc=
h.max_merge_docs</literal></para>
         </listitem>
 =

         <listitem>
-          <literal>hibernate.search.[default|&lt;indexname&gt;].batch.max_=
buffered_docs</literal>
+          <para><literal>hibernate.search.[default|&lt;indexname&gt;].batc=
h.max_buffered_docs</literal></para>
         </listitem>
       </itemizedlist></para>
 =



--===============5074256493081975442==--