[hibernate-commits] Hibernate SVN: r17471 - validator/trunk/hibernate-validator/src/main/docbook/en-US/modules.

[hibernate-commits at lists.jboss.org]

Author: hardy.ferentschik
Date: 2009-09-02 15:30:35 -0400 (Wed, 02 Sep 2009)
New Revision: 17471

Modified:
   validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml
Log:
HV-220

Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml	2009-09-02 18:50:50 UTC (rev 17470)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml	2009-09-02 19:30:35 UTC (rev 17471)
@@ -614,6 +614,17 @@
   <section id="validator-usingvalidator-validationgroups" revision="1">
     <title>Using groups</title>
 
+    <para>Groups allow you to restrict the set of constraints applied during
+    validation. This allows for example for wizard like validation where for
+    each step of the wizard only a specified subset of all defined constraints
+    get validated. The groups targeted are passed as var-args parameters to
+    <methodname>validate</methodname>,
+    <methodname>validateProperty</methodname> and
+    <methodname>validateValue</methodname>. All constraints belonging to the
+    targeted group are applied during the Section 3.5. When more than one
+    group is requested, the order in which the groups are evaluated is not
+    deterministic. </para>
+
     <section revision="1">
       <title>Group sequences</title>
 
@@ -625,7 +636,7 @@
     <title>Built-in constraints</title>
 
     <para>Hibernate Validator comes with some built-in constraints, which
-    covers most basic data checks. As we'll see later, you're not limited to
+    covers some basic data checks. As we'll see later, you're not limited to
     them, you can literally in a minute write your own constraints.</para>
 
     <table>