javadoc and API docs (original) (raw)

Alan Bateman Alan.Bateman at oracle.com
Mon Mar 26 12:43:44 UTC 2012

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

More information about the build-dev mailing list