[hibernate-issues] [Hibernate-JIRA] Created: (HHH-4710) Hibernate Core Tutorial Documentation Fix

[Ben C (JIRA)]

Hibernate Core Tutorial Documentation Fix 
------------------------------------------

                 Key: HHH-4710
                 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-4710
             Project: Hibernate Core
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 3.3.2, 3.3.1
         Environment: 3.3.2, 3.3.1
            Reporter: Ben C
            Priority: Minor


Hi,

I was following the Hibernate Tutorial in Part One of the Hibernate Core documentation (Hibernate_Core/hibernate_3.2/source_3.3.2.GA/documentation/manual/target/docbook/publish/en-US/html_single/index.html) and encountered a few exceptions for which fixes are suggested on Hibernate forums. These fixes include:

a) https://forum.hibernate.org/viewtopic.php?p=2400801
b) https://forums.hibernate.org/viewtopic.php?f=1&t=998189


Solution summary a)
  1. Remove file:
  hibernate-3.3.1.GA\lib\required\slf4j-api-1.5.2.jar

  2. Add to your project two new files:
  slf4j-api-1.5.6.jar
  slf4j-log4j12-1.5.6.jar  

Solution summary b) 
  ...
  <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-core</artifactId>
        <version>3.3.1.GA</version> <!-- Version added as fix -->
  </dependency>

I am in the process of documenting a JBoss DevStudio (eclipse) Hibernate application for Red Hat (EAP 5.0) which consists of the Hibernate 3.3.2.GA component.

Having discovered the exceptions in the existing code, I am going to create a patch for the Community documentation including all of the code fixes (some paths in hibernate.cfg.xml files are wrong) and pom.xml alterations (<version>3.3.1.GA</version> tags) etc.

* Which version of Hibernate which you like me to focus on considering the Community (5.1 AS) and Red Hat (EAP 5.1) Hibernate versions differ?

* Also, as I have configured the tutorial in DevStudio (eclipse) and will be writing a Red Hat guide, would you like me to add the eclipse version to a Community document?

* I configured the tutorial for use with an Mysql database and will be writing the Red Hat version accordingly. Please advise whether you would like that content added to the community docs in place of the "in memory" hsqld database ?

Thanks,


Ben Clare

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira