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
