From hibernate-commits at lists.jboss.org Fri Nov  3 08:38:31 2006
Content-Type: multipart/mixed; boundary="===============5836509502947054102=="
MIME-Version: 1.0
From: hibernate-commits at lists.jboss.org
To: hibernate-commits at lists.jboss.org
Subject: [hibernate-commits] Hibernate SVN: r10704 -
 trunk/Hibernate3/doc/reference/en/modules
Date: Fri, 03 Nov 2006 08:38:31 -0500
Message-ID: <E1GfzFf-0005Sq-9M@committer01.frg.pub.inap.atl.jboss.com>

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

Author: steve.ebersole(a)jboss.com
Date: 2006-11-03 08:38:30 -0500 (Fri, 03 Nov 2006)
New Revision: 10704

Modified:
   trunk/Hibernate3/doc/reference/en/modules/filters.xml
Log:
HHH-2127 : document default filter conditions

Modified: trunk/Hibernate3/doc/reference/en/modules/filters.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
--- trunk/Hibernate3/doc/reference/en/modules/filters.xml	2006-11-03 13:22:=
57 UTC (rev 10703)
+++ trunk/Hibernate3/doc/reference/en/modules/filters.xml	2006-11-03 13:38:=
30 UTC (rev 10704)
@@ -7,7 +7,7 @@
         enabled or disabled for a particular Hibernate session.
     </para>
 =

-    <sect1 id=3D"objectstate-filters">
+    <sect1 id=3D"objectstate-filters" revision=3D"1">
         <title>Hibernate filters</title>
 =

         <para>
@@ -123,6 +123,23 @@
             the operator.
         </para>
 =

+        <para>
+            After being defined a filter might be attached to multiple ent=
ities and/or
+            collections each with its own condition.  That can be tedious =
when the
+            conditions are the same each time.  Thus <literal>&lt;filter-d=
ef/&gt;</literal>
+            allows defining a default condition, either as an attribute or=
 CDATA:
+        </para>
+
+        <programlisting><![CDATA[<filter-def name=3D"myFilter" condition=
=3D"abc > xyz">...</filter-def>
+<filter-def name=3D"myOtherFilter">abc=3Dxyz</filter-def>]]></programlisti=
ng>
+
+        <para>
+            This default condition will then be used whenever the filter i=
s attached to something
+            without specifying a condition.  Note that this means you can =
give a specific condition
+            as part of the attachment of the filter which overrides the de=
fault condition in that
+            particular case.
+        </para>
+
     </sect1>
 =

 </chapter>


--===============5836509502947054102==--