Any way to get schema comments into the generated files?

Question

Hi there,
I have a schema that in part looks like this:
<xsd:complexType name="LinkType">
<xsd:annotation><xsd:documentation>
A link joins two distinct primary entities to each other. There is no provision
for more than two primary entities participating in a link.
Entity can have only one link per "right" entity.
@ejb.bean name="EntitiesLink"
</xsd:documentation></xsd:annotation>
<xsd:sequence>
</xsd:sequence>
</xsd:complexType>
I would like the comments to be passed through. So I would like to have a comment block that looks like:
* A link joins two distinct primary entities to each other. There is no provision
* for more than two primary entities participating in a link.
* Entity can have only one link per "right" entity.
* <p>The following schema fragment specifies the expected content contained within this java content object.
* <p>
* <pre>
* <complexType name="LinkType">
* <complexContent>
* <restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
* (The rest of the auto generated comment about the schema that jaxb currently generates.)
* </pre>
* @ejb.bean name="EntitiesLink"
*/

Answer 1

The problem with this is that the @tags appear at the top of the comment, which is of course not legal.
So this:
<xsd:appinfo>
<jaxb:class>
<jaxb:javadoc>
@ejb.bean name="EntitiesLink"
</jaxb:javadoc>
</jaxb:class>
</xsd:appinfo>
ends up looking like this:
* @ejb.bean name="EntitiesLink"
* Java content class for LinkType complex type.
* <p>The following schema fragment specifies the expected content contained within this java content object.
* <p>
* <pre>
* <complexType name="LinkType">
* <complexContent>
* <restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
* <sequence>
* <element name="Id" type="{http://www.sworddance.com/RelationshipBook}FullIdType"/>
* <element name="Description" type="{http://www.sworddance.com/RelationshipBook}DescriptionType"/>
* <element name="Left" type="{http://www.sworddance.com/RelationshipBook}LinkEndpointType" minOccurs="0"/>
* <element name="Right" type="{http://www.sworddance.com/RelationshipBook}LinkEndpointType"/>
* <element name="LinkInitiateDate" type="{http://www.sworddance.com/RelationshipBook}DateRefType" minOccurs="0"/>
* <element name="LinkTerminateDate" type="{http://www.sworddance.com/RelationshipBook}DateRefType" minOccurs="0"/>
* <element name="LinkAwarenessDate" type="{http://www.sworddance.com/RelationshipBook}DateRefType"/>
* <element name="CommonOpinion" type="{http://www.sworddance.com/RelationshipBook}OpinionType" minOccurs="0"/>
* <element name="Secondary" type="{http://www.sworddance.com/RelationshipBook}LinkEndpointType" maxOccurs="unbounded" minOccurs="0"/>
* <element name="RootLinkId" type="{http://www.sworddance.com/RelationshipBook}LocalIdType" maxOccurs="unbounded" minOccurs="0"/>
* <element name="Properties" type="{http://www.sworddance.com/RelationshipBook}PropertiesType" minOccurs="0"/>
* <element name="Locations" type="{http://www.sworddance.com/RelationshipBook}LocationCollectionType" minOccurs="0"/>
* <element name="Encounter" type="{http://www.sworddance.com/RelationshipBook}EncounterType" maxOccurs="unbounded" minOccurs="0"/>
* </sequence>
* <attribute name="directional" type="{http://www.sworddance.com/RelationshipBook}DirectionalType" />
* <attribute name="LinkSourceId" type="{http://www.sworddance.com/RelationshipBook}LocalIdType" />
* <attribute name="implicit" type="{http://www.w3.org/2001/XMLSchema}boolean" />
* <attribute name="family" type="{http://www.w3.org/2001/XMLSchema}boolean" />
* <attribute name="LinkOwnerId" type="{http://www.sworddance.com/RelationshipBook}LocalIdType" />
* <attribute name="isKnown" type="{http://www.w3.org/2001/XMLSchema}boolean" />
* <attribute name="confidence" type="{http://www.sworddance.com/RelationshipBook}PercentRangeType" />
* </restriction>
* </complexContent>
* </complexType>
* </pre>