users@jaxb.java.net

Re: javadocs

From: Malachi de AElfweald <malachi_at_EOTI.ORG>
Date: Wed, 02 Apr 2003 10:05:52 -0700

On Tue, 1 Apr 2003 14:47:44 -0500, Ryan Shoemaker - JavaSoft East <Ryan.Shoemaker_at_Sun.COM> wrote:
>Understood. Like I said, from the spec / portability perspective, your
>client code should never import and use code from the generated impl
>packages. As soon as you start using them, you throw portability out
>the window and are locked into using that particular JAXB provider.

Yeah, I don't plan on actually using the impl classes directly -- but it sometimes makes debugging stack traces easier when the javadocs are there.

>Having said that, if you really want to javadoc the impl packages, you'll
>have to live with the javadoc warnings because the source code for the
>com.sun libraries that our generated code depends on is not available.

I don't actually need the source to them, I just need the javadocs posted online, since the ant task just requires the href of the docs. IE: I don't want to build the com.sun javadocs, just want to link against them.

Malachi