I suppose some documentation update is needed for Hibernate.
I'm really excited about Hibernate, but the documentation does not look 100% ready.
some of the paragraphs are not clear, do not provide many examples and do not specify the default values.
e.g.
page hibernate-3.1/doc/reference/en/html/mapping.html#mapping-declaration-manytoone

this paragraph:

no default value is specified.

should I post other issues as well?

Much better would be to provide *patches* in jira against the Hibernate 3.2 docs.

well, I would do that, but I'm just a beginner with Hibernate, so don't know what to write in the docs :)

then find out ;)

the DTD is a good place to start.