5

Hibernate 3 and 4 used to document the available configuration properties:

The documentation for Hibernate 5 (http://docs.jboss.org/hibernate/orm/5.0/userGuide/en-US/html_single/) does not contain anything similar. Is it just not ready?

Vlad Mihalcea
  • 142,745
  • 71
  • 566
  • 911
Bogdan Calmac
  • 7,993
  • 6
  • 51
  • 64
  • http://docs.jboss.org/hibernate/orm/5.0/manual/en-US/html_single/#configuration-optional – Dragan Bozanovic Feb 02 '16 at 18:51
  • Interesting. Your link is from July 2015 and it corresponds to 5.0.0.CR2. The link from the official website is from Jan 2016 and corresponds to 5.0.7.Final. So it was removed then? – Bogdan Calmac Feb 02 '16 at 19:39
  • Also comparing the size of the 2 versions, the HTML file went from 1.57MB down to 703KB. Was half of the documentation really obsolete and unnecessary? – Bogdan Calmac Feb 02 '16 at 19:43
  • My link is to manual, you are referring to user guide. – Dragan Bozanovic Feb 02 '16 at 19:49
  • The documentation home page for 5.0 does not list any Manual, just the User Guide: http://hibernate.org/orm/documentation/5.0/ Is it missing? On the other hand, the documentation home page for 4.3 does not list any User Guide, just the Manual: http://hibernate.org/orm/documentation/4.3/. So, in 5.0 will there be both a User Guide (present) and a Manual (currently missing)? Or is the User Guide replacing the Manual in 5.0? – Bogdan Calmac Feb 02 '16 at 20:01
  • There are different kinds of docs on jboss site: http://docs.jboss.org/hibernate/orm/5.0/ I am not sure how docs on hibernate.org are classified though. – Dragan Bozanovic Feb 02 '16 at 20:13
  • It looks to me like the manual was removed. Even on the jboss site, the manual hasn't been updated since July 2015 while all other pieces of documentation are current as of Jan 2016. To ask this differently, where is the manual for 5.0.7? – Bogdan Calmac Feb 02 '16 at 20:21
  • The documentation for every release are supplied with the release itself. You can download Hibernate's older version of your choice from: http://sourceforge.net/projects/hibernate/files/hibernate-orm/ and the documentations are available in hibernate-release-5.0.4.Final.zip\hibernate-release-5.0.4.Final\documentation\userGuide These are the same like the online user guide. – Raman Sahasi Feb 03 '16 at 06:23
  • I'm not looking for older documentation. The downloaded version is the same as the one on the web site. During this conversation I realized that the "Manual" from the previous version was replaced by a "User Guide" which is half the size and among others it also misses the documentation for the configuration properties. If all this a mistake on my side answer this question: Where are the configuration properties documented in the Hibernate 5.0.7 release? Hibernate website, Jboss website, downloadable version, anywhere ... – Bogdan Calmac Feb 03 '16 at 21:37

2 Answers2

6

When I joined the Hibernate team, my first task was to rewrite the entire Hibernate User Guide. So, starting from Hibernate 5.1, there's a new section dedicated to Hibernate configurations.

Enjoy reading it!

Vlad Mihalcea
  • 142,745
  • 71
  • 566
  • 911
0

NOTE: This is no longer relevant, the problem was resolved.

Based on the discussion in the comments, it looks like the comprehensive "Manual" from 4.3 was replaced in 5.0 with a more limited "User Guide" which among other things does not document the configuration properties. To give you an idea about the changes, the HTML for the 5.0 "User Guide" is about half the size of the 4.3 "Manual".

Bogdan Calmac
  • 7,993
  • 6
  • 51
  • 64