javadoc and API docs

[Alan Bateman]

On 26/03/2012 12:34, Jonathan Gibbons wrote:
> 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
The cross-compile case, say to an embedded target, means the newly built 
JDK is not directly runnable although one could image skipping the 
javadoc in such a build.

In the Jigsaw build then it already has to run tools such as jmod on the 
built JDK. For the cross-compile case it means doing two builds, one for 
the host platform, and then a second build for the target.  When 
building for the target then the host JDK is specified via the 
JDK_HOST_PATH variable. If you are changing the generation of the API 
docs then you may need to have something similar.

-Alan