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