RFR: JDK-8268422: Find a better way to select releases in "New API" page

Jonathan Gibbons jjg at openjdk.java.net
Thu May 26 23:40:32 UTC 2022


On Thu, 26 May 2022 23:36:29 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> For test classes containing multiple test methods the output directory is actually the best way to identify which run of javadoc generated the output. If a test were to do multiple runs of javadoc with the same output directory I would certainly consider it a serious bug. Also, a single test method could easily do multiple runs of javadoc (I'm not sure we do that in our test suite, but I wouldn't be too surprised).  Adding the output directory disambiguates the file name which is already there, making it easy to locate the file itself and the code that generated it.
>
> OK; just verify it doesn't break existing tests!

> I'm trying to understand the merit of this, since the output directory is often just `out` or `api` isn't it? Don't you want the test method name in there, for increased resolution?

I guess the simple filename of the output directory is often `out` or `api`, but the filename relative to the current directory is (or should be) unique.

-------------

PR: https://git.openjdk.java.net/jdk/pull/8657


More information about the javadoc-dev mailing list