users@jaxb.java.net

Re: Schema Annotations/Documentation to Javadoc

From: Kohsuke Kawaguchi <Kohsuke.Kawaguchi_at_Sun.COM>
Date: Thu, 01 Jun 2006 10:26:16 -0700

Michael Vorburger wrote:
> It would be "handy" (not Spec required, I understand) if normal Schema
> Annotations would be turned into JavaDoc of classes, getters/setters
> and enums etc. (For example the JAX-RPC Code Generator in Axis1 did
> this.)

JAXB already does this to some extent.

If you find cases where it doesn't work as you expected, please file a
bug, hopefully with your schema, and we'll take a look.

>
> Reading a thread from last year at
> https://jaxb.dev.java.net/servlets/ReadMsg?list=users&msgNo=4328 makes
> one think that's the case... is there a special option required to
> turn this on? It doesn't seem to work in all cases (using
> jaxb-ri-20060426)... unless I'm not getting it.
>
> How I'd imaging this to work is that IFF a jaxb:javadoc is available,
> then that takes precedence over the xsd:annotation/documentation, as
> the former is more specific (some HTML allowed, JavaDoc @see etc.
> stuff) but if there isn't, then xsd:annotation would be used wherever
> available.
>
> Thanks!
>


-- 
Kohsuke Kawaguchi
Sun Microsystems                   kohsuke.kawaguchi_at_sun.com