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

[Patrick Pfeifer]

On Sat, 6 Aug 2022 09:01:39 GMT, Patrick Pfeifer <duke at openjdk.org> wrote:

>> src/java.base/share/man/keytool.1 line 456:
>> 
>>> 454: \f[CB]PrivateKeyEntry\f[R] for the signer that already exists in the
>>> 455: keystore.
>>> 456: This option is used to sign the certificate with the signer?s private
>> 
>> 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?
> 
> 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?

It did not take much effort to answer the last of the above question myself.

> Are there other output formats, e.g. HTML, that might be are deployed somewhere on the web?

Obviously "yes". HTML renderings can be found by following the, e.g. "[Java Development Kit Version 18 Tool Specifications](https://docs.oracle.com/en/java/javase/18/docs/specs/man/index.html)" Link on the "Specifications Overview" page at, e.g. "https://docs.oracle.com/en/java/javase/18/docs/specs/".

Still hunting for the sources.

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

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