users@jaxb.java.net

Re: Schema Annotations/Documentation to Javadoc

From: Kohsuke Kawaguchi <Kohsuke.Kawaguchi_at_Sun.COM>
Date: Mon, 05 Jun 2006 22:49:16 -0700

Michael Vorburger wrote:
>> If you find cases where it doesn't work as you expected,
>
> . not the same complexType's sequence/element* documentation (which
> I'd think you'd expect on the respective getters/setters, instead of
> that pretty useless "Gets the value of the ... property."), nor a
> simpleType's annotation/documentation that turns into a @XmlEnum
> public enum, where one would expect both JavaDoc of the class as well
> as the individual enum values, from the
> simpleType/restriction/enumeration/annotation/documentation.
> (Additionally maybe putting schema/annotation/documentation into
> package-info.java as JavaDoc; although not sure how to deal with one
> namespace schema in several .xsd... not sure how that looks in XSOM by
> the time you process this?)

Aha! Yeah, please file an issue. I think we'd like to make it work.


>> please file a bug, hopefully with your schema, and we'll take a look.
>
> Can I just copy/paste the above or do you need full example schema?
> This Email enough?

More details is always better, and a test schema is always appreciated.
  But if you can't spare the cycle, at least please file an issue,
copying your e-mail text.


> I'm not familiar with the development process of JAXB on java.net -
> once get a chance to take a look and implement, does this then go into
> some 2.1 and I can't see it for quite a while, or are there
> intermediate builds (or can I build it?) to test it out relatively
> soon and give you feedback etc. ? Just asking!

If a change needs to be made in the spec, then that has to wait for the
next spec revision.

If a change is simply a bug fix, or a change allowed in the spec (such
as this one), then we can just make that change in the RI.

Those "fixes" will be available in two ways:

   1) we post nightlies, and so you can download
      it and use it to enjoy the latest fixes. (those are quite stable
      right now --- I should also start posting test results on
      them, too)

   2) we'll be posting bug fix releases for 2.0. In fact, we are planning
      JAXB RI 2.0.1 pretty soon.

-- 
Kohsuke Kawaguchi
Sun Microsystems                   kohsuke.kawaguchi_at_sun.com