The Java EE 5 Tutorial (PDF) - Oracle Software Downloads

For inline annotations, the declaration must be specified in the
annotation element of the element. The must be
specified in the annotation element of the enumeration member. This allows the enumeration
member to be customized independently from the enumeration class.
For information about typesafe enum design patterns, see the sample chapter of Joshua Bloch’s
Effective Java Programming on the Java Developer Connection (http://java.sun.com/
developer/Books/shiftintojava/page1.html).
javadoc Binding Declarations
The declaration lets you add custom Javadoc tool annotations to schema-derived
JAXB packages, classes, interfaces, methods, and fields. Note that declarations
cannot be applied globally; they are only valid as sub-elements of other binding customizations.
The syntax for the customization is:
Contents in <b>Javadoc<\b> format.
or
format
]]>
Note that documentation strings in declarations applied at the package level must
contain open and close tags; for example:
Package level documentation for generated package primer.myPo.]]>
Customization Namespace Prefix
Customizing JAXB Bindings
All standard JAXB binding declarations must be preceded by a namespace prefix that maps to
the JAXB namespace URI (http://java.sun.com/xml/ns/jaxb). For example, in this sample,
jxb: is used. To this end, any schema you want to customize with standard JAXB binding
declarations must include the JAXB namespace declaration and JAXB version number at the
top of the schema file. For example, in po.xsd for the Customize Inline example, the namespace
declaration is as follows:
Chapter 17 • Binding between XML Schema and Java Classes 523