Shawn Jiang
added a comment - 12/Mar/10 08:57 - edited There are problems in final jaxb 2.2 spec PDF:
1, There's no TOC in the doc, it's hard to navigate the content.
2, The content is not intact. At least, the changes log section of 2.2 spec is exactly the same with that of 2.0 spec.
Does anyone know how to report these problems to JCP ?

If you download the jaxb-2_2-mrel2-spec.zip file from the JAXB JSR page, there is zip file in there named javadoc-diff.zip. That zip file contains very detailed information about what has changed in the API. The changes look relatively minor (one new class, two changed classes).

Rick McGuire
added a comment - 16/Mar/10 13:40 Shawn,
If you download the jaxb-2_2-mrel2-spec.zip file from the JAXB JSR page, there is zip file in there named javadoc-diff.zip. That zip file contains very detailed information about what has changed in the API. The changes look relatively minor (one new class, two changed classes).

The changes are so minor, they are only documented in the javadoc. The changes.html file in the javadoc-diff zip file gives you a very detailed summary of what has changed in the API. There really appears to be just one substantial change to the API. The setDataTypeConverter() method can now throw a security exception and there is a new JAXBPermission class associated with that change. The rest of javadoc updates appear to be clarifications of how the JAXBContext.newInstance() methods are expected to work, and not necessarily changes to the APIs. None of this information is directly contained in the PDF file, so there's really are not any changes to the pdf version of the spec.

Rick McGuire
added a comment - 16/Mar/10 14:46 The changes are so minor, they are only documented in the javadoc. The changes.html file in the javadoc-diff zip file gives you a very detailed summary of what has changed in the API. There really appears to be just one substantial change to the API. The setDataTypeConverter() method can now throw a security exception and there is a new JAXBPermission class associated with that change. The rest of javadoc updates appear to be clarifications of how the JAXBContext.newInstance() methods are expected to work, and not necessarily changes to the APIs. None of this information is directly contained in the PDF file, so there's really are not any changes to the pdf version of the spec.

Shawn Jiang
added a comment - 17/Mar/10 02:23 Got it. I've made the changes according to the javadoc diff with Rev.924100. Will see if the changes satisfy the TCK after my TCK request is approved.
Thanks Rick for the suggestion.