javadoc and API docs

Fredrik Öhrström fredrik.ohrstrom at oracle.com
Mon Mar 26 13:01:18 UTC 2012


2012-03-26 13:34, Jonathan Gibbons skrev:
> Right now, in the current build, we use a "hybrid" javadoc to build 
> the API documentation, where "hybrid" means: latest sources, running 
> on bootstrap JDK.
>
> Looking to the future, at least for Jigsaw, and now maybe for JSR 308, 
> we may need to run javadoc on the newly built JDK.  Does anyone see 
> any problems with doing that?
>
> -- Jon

It seems counter intuitive that, something as trivial, as extracting 
documentation
from source files, should require the entire new jdk.... You need to 
give us more
information Jon.  Why can't we build a bootstrap javadoc that knows how 
to deal
with the new jdk sources (modules, type annotations et al)
in the same way that we can build a bootstrap javac?

//Fredrik



More information about the build-dev mailing list