Hi
I appriciate that I can annotate each individual type, attribute and
element, but I was looking to see if I could re-use the documentation
already present in the schema.
I can see that the information is available (as evidenced by the behaviour
of the enums), but not used for class and property generation.
If there is not an existing mechanism to do this then I was wondering if
someone could point me in the right direction as to how to build a
customisation to modify the documentation generated. I have written a
customisation, but I cannot see where the xs:documentation can be read and
associated with the generated fields
Is there any reason why this would be a bad idea?
Wolfgang Laun-2 wrote:
>
> Include the definition of xmlns:jxb="http://java.sun.com/xml/ns/jaxb" in
> your <xsd:schema>
> element.
>
> Add a child to <xsd:complexType> or <xsd: element> or <xsd:attribute>:
>
> <xsd:annotation><xsd:appinfo><jxb:XXX><jxb:javadoc>
> This is my comment for a class/property
> </jxb:javadoc></jxb:XXX></xsd:appinfo></xsd:annotation>
>
> where XXX is either "class" or "property".
>
> For a package you write a child to xsd:schema
> <xsd:annotation><xsd:appinfo><jxb:schemaBindings><jxb:package
> name="com.acme"><jxb:javadoc>
> This is my comment for a package
> </jxb:javadoc></jxb:package></jxb:schemaBindings></xsd:appinfo></xsd:annotation>
>
> Writing HTML document requires bracketing with <![CDATA[ --- ]]>
>
> Wolfgang
>
>
> On Tue, Sep 16, 2008 at 3:50 PM, Mike Skells
> <mike.skells_at_validsoft.com>wrote:
>
>>
>> Hi,
>> I am looking to generate javadoc from the xs:documentaton nodes in a
>> schema
>>
>> from what I can see the documentation for enums is generated from the
>> schema
>> documentation (for the fields), but pretty much nothing else
>>
>> is there a way to generate the documentation from the schama into
>> javadoc.
>>
>> --
>> View this message in context:
>> http://www.nabble.com/newbe%3A-how-can-I--generate-javadoc-from-the-schema-documentation-tp19512300p19512300.html
>> Sent from the java.net - jaxb users mailing list archive at Nabble.com.
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: users-unsubscribe_at_jaxb.dev.java.net
>> For additional commands, e-mail: users-help_at_jaxb.dev.java.net
>>
>>
>
>
--
View this message in context: http://www.nabble.com/newbe%3A-how-can-I--generate-javadoc-from-the-schema-documentation-tp19512300p19515416.html
Sent from the java.net - jaxb users mailing list archive at Nabble.com.