After some refactoring, the javadoc in the ObjectLock and TypeInfo is not right now.
In this patch, I correct some javadoc, and add some extra javadoc.
This issue will need a patch after CASTOR-3186 is submmitted. I'll provide the new patch soon.
Patch looks good. Can you please commit and close jira issue after CASTOR-3186 has been resolved.