[hibernate-commits] Hibernate SVN: r15965 - in validator/trunk/hibernate-validator: src/main/docbook/en-US and 1 other directories.

Thu Feb 12 03:56:50 EST 2009

Author: hardy.ferentschik
Date: 2009-02-12 03:56:49 -0500 (Thu, 12 Feb 2009)
New Revision: 15965

Modified:
   validator/trunk/hibernate-validator/readme.txt
   validator/trunk/hibernate-validator/src/main/docbook/en-US/master.xml
   validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/gettingstarted.xml
Log:
Some more changes after Emmanuel's review

Modified: validator/trunk/hibernate-validator/readme.txt
===================================================================

--- validator/trunk/hibernate-validator/readme.txt	2009-02-12 08:36:09 UTC (rev 15964)
+++ validator/trunk/hibernate-validator/readme.txt	2009-02-12 08:56:49 UTC (rev 15965)
@@ -4,7 +4,7 @@
   What is it?
   -----------
 
-  This is a reference implementation of JSR 303 - Bean Validation. 
+  This is the reference implementation of JSR 303 - Bean Validation. 
   Bean Validation defines a metadata model and API for JavaBean validation. 
   The default metadata source is annotations, with the ability to override and extend 
   the meta-data through the use of XML validation descriptors.
@@ -16,6 +16,20 @@
   is not based JSR 303. This code can be accessed via 
   http://anonsvn.jboss.org/repos/hibernate/validator/trunk/hibernate-validator-legacy
 
+  Status
+  ------
+
+  This is an alpha release and not feature complete in relation to the latest version 
+  of JSR 303. The following features are not yet fully implemented:
+
+  - Group inheritance using interfaces and implicit grouping
+  - Implementation of the TraversableResolver interface to allow integration with JPA
+  - Polymorphism in graph validation
+  - XML configuration
+
+  You can find more information about the current state of the implementation on the
+  Bean Validation RI Roadmap - http://www.hibernate.org/459.html
+
   Documentation
   -------------
 

Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/master.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/master.xml	2009-02-12 08:36:09 UTC (rev 15964)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/master.xml	2009-02-12 08:56:49 UTC (rev 15965)
@@ -27,7 +27,7 @@
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 <!ENTITY versionNumber "4.0.0.Alpha1">
 <!ENTITY copyrightYear "2009">
-<!ENTITY copyrightHolder "Red Hat Middleware, LLC.">
+<!ENTITY copyrightHolder "Red Hat Middleware, LLC. &amp; Gunnar Morling">
 ]>
 <book lang="en">
   <bookinfo>
@@ -45,10 +45,11 @@
 
     <mediaobject>
       <imageobject role="fo">
-        <imagedata fileref="hibernate_logo_a.png" align="center" />
+        <imagedata align="center" fileref="hibernate_logo_a.png" />
       </imageobject>
+
       <imageobject role="html">
-        <imagedata fileref="hibernate_logo_a.png" depth="3cm" />
+        <imagedata depth="3cm" fileref="hibernate_logo_a.png" />
       </imageobject>
     </mediaobject>
 
@@ -81,7 +82,7 @@
       </listitem>
 
       <listitem>
-        <para>Polymorphism in graph validation </para>
+        <para>Polymorphism in graph validation</para>
       </listitem>
 
       <listitem>
@@ -91,17 +92,17 @@
 
     <para>You can find more information about the current state of the
     implementation on the <ulink url="http://www.hibernate.org/459.html">Bean
-    Validation Roadmap</ulink>. </para>
+    Validation Roadmap</ulink>.</para>
 
     <para>The documentation contains so far only a "Getting started" section.
     Work is in progress in this area and following releases will have more up
-    to date documentation. For now refer to <ulink
-    url="http://hibernate.org/~emmanuel/validation/">JSR 303</ulink> directly
-    for further examples.</para>
+    to date documentation. For now refer to JSR 303 directly for further
+    examples.</para>
 
     <para>Please report any problems or bugs in either <ulink
     url="http://opensource.atlassian.com/projects/hibernate/browse/HV">Jira
-      Hibernate Validator</ulink> or on the <ulink url="http://forum.hibernate.org/viewforum.php?f=9">Validator
+    Hibernate Validator</ulink> or on the <ulink
+    url="http://forum.hibernate.org/viewforum.php?f=9">Validator
     Forum</ulink>.</para>
   </preface>
 

Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/gettingstarted.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/gettingstarted.xml	2009-02-12 08:36:09 UTC (rev 15964)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/gettingstarted.xml	2009-02-12 08:56:49 UTC (rev 15965)
@@ -29,9 +29,9 @@
   <title>Getting started in 5 minutes</title>
 
   <para>This chapter will show you how to quickly get started with the
-  reference implementation (RI) of the Bean Validation API as specified by
-  <ulink url="http://jcp.org/en/jsr/detail?id=303">JSR 303</ulink>. Be sure to
-  fulfill the following prerequisites in order to proceed:</para>
+  reference implementation (RI) of the Bean Validation API as specified by JSR
+  303. Be sure to fulfill the following prerequisites in order to
+  proceed:</para>
 
   <itemizedlist>
     <listitem>
@@ -348,9 +348,8 @@
     <title>Where to go next?</title>
 
     <para>That concludes our 5 minute tour through the world of the Bean
-    Validation RI. You might next be interested in using some <link
-    linkend="validator-usingvalidator">advanced features of the Validator
-    API</link> or how to define your own <link
-    linkend="validator-customconstraints">custom constraint</link>.</para>
+    Validation RI. We will complete this documentation in our coming releases.
+    For now we recommend to refer to the JSR 303 specification directly for
+    more examples.</para>
   </section>
 </chapter>


