[hibernate-issues] [JIRA] (BVAL-510) Fix JavaDoc warnings, copy changed/new JavaDoc into spec