RFR: 8344056: Use markdown format for man pages [v2]

[Magnus Ihse Bursie]

On Wed, 13 Nov 2024 21:55:53 GMT, Iris Clark <iris at openjdk.org> wrote:

>> src/java.base/share/man/java.md line 9:
>> 
>>> 7: # published by the Free Software Foundation.  Oracle designates this
>>> 8: # particular file as subject to the "Classpath" exception as provided
>>> 9: # by Oracle in the LICENSE file that accompanied this code.
>> 
>> Documentation files should not have the Classpath exception.
>> 
>> make/data/license-templates/gpl-header
>
> Agree.

Yeah, sorry for that, and thanks for catching it. 

I just copied the header from a build file, since it was conveniently already formatted with the leading `#`. I just assumed that this was the pure GPL and did not check close enough to verify. But it turns out that most of the build system files actually have the classpath exception, which makes no sense. 

I've filed https://bugs.openjdk.org/browse/JDK-8344191 to deal with that.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/22081#discussion_r1842039722