[jdk19] RFR: 8278274: Update nroff pages in JDK 19 before RC

[David Holmes]

Hi Patrick,

On 6/08/2022 7:05 pm, Patrick Pfeifer wrote:
> On Mon, 18 Jul 2022 15:22:01 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:
> 
>>> Please review these changes to the nroff manpage files so that they match their markdown sources that Oracle maintains.
>>
>> Not a problem with this PR as such, but we still have a `?` character in the output.
> 
> Hello @jonathan-gibbons
> 
> Excuse my hijacking / piggy-backing on this conversation!
> 
> When you say
> 
>> Not a problem with this PR as such, but we still have a `?` character in the output.
> 
> This strongly suggests that there must be an input to those man pages somewhere. :-) Would you mind to point me to it? Are they even included in the git repo?

The sources to the manpages are not currently open sourced and so are 
held in Oracle's internal repository. Making them open-sourced has been 
a goal for some time now but has to overcome legal obstacles, but we are 
hopeful it will be "soon".

> Also, I was wondering why these man pages (i.e. the outputs) are obviously not included any more in the OpenJDK builds, e.g. https://jdk.java.net/19/ ? I am not sure when they were removed or if they were ever included in _open_jdk builds at all, but I see them in the Oracle JDK 1.8 Build.
> 
> I find them really nice to read! Are there other output formats, e.g. HTML, that might be are deployed somewhere on the web?

As you found, Oracle does provide these in html format.

Cheers,
David


> -------------
> 
> PR: https://git.openjdk.org/jdk19/pull/145