Currently there are 19 classes defining oldSerialVersionUID and newSerialVersionUID, and setting in a static initialization block their actual serialVersionUID to either one of these values depending on the system property jmx.serial.form.
Ideally we would like this information to appear in the Serialized Form javadoc page, as the first information for each class. I did not manage to achieve that so far because the @serial tag must document default serializable fields (so in particular non static) and is ignored in other cases. It is also ignored if used in the main description of the class to add a comment for the Serialized Form page.
Unless I am missing something, possible options I see are:
* either add this serialVersionUID information to the the main javadoc description of the class (but it will not appear in the Serialized Form page)
* or add it to the writeObject and readObject methods javadoc information for the 2 classes that extend the default mechanism, and to the @serial information of an already existing field for the 17 others (a bit ugly though).
For information, the impacted classes are: