[jdk17] RFR: JDK-8270872: Final nroff manpage update for JDK 17

Mark Reinhold mr at openjdk.java.net
Thu Aug 5 21:44:36 UTC 2021


On Thu, 5 Aug 2021 21:40:40 GMT, Naoto Sato <naoto at openjdk.org> wrote:

>> According to the comments in the makefile (`closed/make/UpdateOpenManPages.gmk`) the copyright line is taken from the original Markdown file, so if the year is wrong there, it will be wrong in the generated nroff file.
>> 
>> I think it would be incorrect to edit the dates locally in these files, because they'll just be overwritten when we generate the files again. Ideally, the dates should be fixed (if necessary) in the Markdown files, but that seems out of scope for this P1.
>> 
>> This is "just" an issue with copyright dates in source files ... and yes, while I know copyright dates are important, this problem is arguably part of an ongoing more general problem.
>> 
>> I note that the generated files *do* correctly identify themselves with `2021` in the visible output generated to the console by the `man` command.
>
> Thanks for the explanation, Jon. Fine by me.

I agree that fixing this date is not necessary at this time.

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

PR: https://git.openjdk.java.net/jdk17/pull/303


More information about the serviceability-dev mailing list