If you mean <xsd:annotation><xsd:documentation>... then this
works as a child for <xsd:complexType> but not for <xsd:element> or
<xsd:attribute>. Changing the schema might be the simplest way.
-W
On Tue, Sep 16, 2008 at 6:28 PM, Mike Skells <mike.skells_at_validsoft.com>wrote:
>
> 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.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe_at_jaxb.dev.java.net
> For additional commands, e-mail: users-help_at_jaxb.dev.java.net
>
>