RFR: JDK-8272984: javadoc support for reproducible builds [v2]

[Jonathan Gibbons]

On Sun, 23 Jan 2022 08:58:18 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> I'll change the range to 10 years. 
>> 
>> I was expecting that the common use of reproducible builds was to compare builds created within a reasonably short period of time. I was wanting to set a range that was less than the seemingly arbitrary range of 1980-2099 allowed by the jar tool.
>
>> I was expecting that the common use of reproducible builds was to compare builds created within a reasonably short period of time. I was wanting to set a range that was less than the seemingly arbitrary range of 1980-2099 allowed by the jar tool.
> 
> The restriction that the year be in the range 1980-2099 is because of the legacy ZIP format and the use of extended DOS time stamps. It would require introducing new APIs to support a wider date range. I don't think javadoc needs to put any restriction on the range. I don't have any objection to 10 years, I was mostly curious why it is needed.

I was following the jmod code, which uses a range, and I guessed (apparently correctly) that the chosen range was ip-specific.

I think it is worthwhile having a sanity-check on the provided range.

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

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