javadoc and API docs (original) (raw)

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