From hibernate-commits at lists.jboss.org Tue Jul  1 09:33:38 2008
Content-Type: multipart/mixed; boundary="===============0346256863730817239=="
MIME-Version: 1.0
From: hibernate-commits at lists.jboss.org
To: hibernate-commits at lists.jboss.org
Subject: [hibernate-commits] Hibernate SVN: r14834 -
 annotations/trunk/doc/reference/en/modules.
Date: Tue, 01 Jul 2008 09:33:38 -0400
Message-ID: <E1KDfzG-0006g3-Jz@committer01.frg.pub.inap.atl.jboss.com>

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

Author: hardy.ferentschik
Date: 2008-07-01 09:33:38 -0400 (Tue, 01 Jul 2008)
New Revision: 14834

Modified:
   annotations/trunk/doc/reference/en/modules/setup.xml
Log:
ANN-741:
Added some documentation regarding the switch to slf4j

Modified: annotations/trunk/doc/reference/en/modules/setup.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
--- annotations/trunk/doc/reference/en/modules/setup.xml	2008-07-01 10:05:1=
6 UTC (rev 14833)
+++ annotations/trunk/doc/reference/en/modules/setup.xml	2008-07-01 13:33:3=
8 UTC (rev 14834)
@@ -7,12 +7,14 @@
 =

     <itemizedlist>
       <listitem>
-        <para>Download and unpack the Hibernate Annotations distribution f=
rom
-        the Hibernate website.</para>
+        <para><ulink url=3D"http://www.hibernate.org/6.html">Download</uli=
nk>
+        and unpack the Hibernate Annotations distribution from the Hiberna=
te
+        website.</para>
       </listitem>
 =

       <listitem>
-        <para><emphasis>This release requires Hibernate Core 3.3 and above=
.</emphasis></para>
+        <para><emphasis>This release requires Hibernate Core 3.3 and
+        above.</emphasis></para>
       </listitem>
 =

       <listitem>
@@ -47,12 +49,14 @@
         </listitem>
       </itemizedlist></para>
 =

-    <para>If you wish to use Hibernate Validator (TODO make a link to HV d=
oc),
-    download it from the Hibernate website and add
+    <para>If you wish to use <ulink
+    url=3D"http://validator.hibernate.org">Hibernate Validator</ulink>, do=
wnload
+    it from the Hibernate website and add
     <filename>hibernate-validator.jar</filename> in your classpath.</para>
 =

-    <para>If you wish to use Hibernate Search (TODO make a link to HSearch
-    doc), download it from the Hibernate website and add
+    <para>If you wish to use <ulink
+    url=3D"http://search.hibernate.org">Hibernate Search</ulink>, download=
 it
+    from the Hibernate website and add
     <filename>hibernate-search.jar</filename> and
     <filename>lucene-core-x.y.z.jar</filename> in your classpath.</para>
 =

@@ -159,34 +163,51 @@
 =

     <para>Asides from the Hibernate core properties, Hibernate Annotations
     reacts to the following one</para>
+  </section>
 =

+  <section>
+    <title>Logging</title>
+
+    <para>Hibernate Annotations utlizes <ulink
+    url=3D"http://www.slf4j.org/">Simple Logging Facade for Java</ulink> (=
SLF4J)
+    in order to log various system events. SLF4J can direct your logging
+    output to several logging frameworks (NOP, Simple, log4j version 1.2, =
JDK
+    1.4 logging, JCL or logback) depending on your chosen binding. In orde=
r to
+    setup logging properly you will need <filename>slf4j-api.jar</filename=
> in
+    your classpath together with the jar file for your preferred binding -
+    <filename>slf4j-log4j12.jar</filename> in the case of Log4J. See the S=
LF4J
+    <ulink type=3D""
+    url=3D"http://www.slf4j.org/manual.html">documentation</ulink> for more
+    detail.</para>
+
+    <para>The logging categories interesting for Hibernate Annotations
+    are:</para>
+
     <table>
-      <title>List of properties</title>
+      <title>Hibernate Annotations Log Categories</title>
 =

       <tgroup cols=3D"2">
         <thead>
           <row>
-            <entry align=3D"center">Property</entry>
+            <entry align=3D"center">Category</entry>
 =

-            <entry align=3D"center">Definition</entry>
+            <entry align=3D"center">Function</entry>
           </row>
         </thead>
 =

         <tbody>
           <row>
-            <entry>hibernate.validator.apply_to_ddl</entry>
+            <entry><emphasis>org.hibernate.cfg</emphasis></entry>
 =

-            <entry>Use Hibernate Validator annotations to refine the datab=
ase
-            schema generation. Default to true.</entry>
+            <entry>Log all configuration related events (not only
+            annotations).</entry>
           </row>
-
-          <row>
-            <entry></entry>
-
-            <entry></entry>
-          </row>
         </tbody>
       </tgroup>
     </table>
+
+    <para>For further category configuration refer to the <ulink
+    url=3D"http://www.hibernate.org/hib_docs/v3/reference/en/html_single/#=
configuration-logging">Logging</ulink>
+    in the Hibernate Core documentation.</para>
   </section>
 </chapter>
\ No newline at end of file


--===============0346256863730817239==--