[jdk23] RFR: 8325280: Update troff manpages in JDK 23 before RC

[Alan Bateman]

On Fri, 19 Jul 2024 05:47:15 GMT, David Holmes <dholmes at openjdk.org> wrote:

> Before RC we need to update the man pages in the repo from their Markdown sources. All pages at a minimum have 23-ea replaced with 23, and publication year set to 2024 if needed.
> 
> This also picks up the unpublished changes to java.1 from:
> 
> - [JDK-8324836](https://bugs.openjdk.org/browse/JDK-8324836): Update Manpage for obsoletion of RAMFraction flags
> - [JDK-8330807](https://bugs.openjdk.org/browse/JDK-8330807): Update Manpage for obsoletion of ScavengeBeforeFullGC
> 
> And a typo crept in to java.1 from:
> - [JDK-8331670](https://bugs.openjdk.org/browse/JDK-8331670): Deprecate the Memory-Access Methods in sun.misc.Unsafe for Removal
> 
> This also picks up the unpublished change to keytool.1 from:
> 
> - [JDK-8284500](https://bugs.openjdk.org/browse/JDK-8284500): Typo in Supported Named Extensions - BasicContraints
> 
> This also picks up the unpublished change to javadoc.1 from:
> 
> - [JDK-8324342](https://bugs.openjdk.org/browse/JDK-8324342): Doclet should default @since for a nested class to that of its enclosing class
> 
> and some formatting changes (unclear why - perhaps pandoc version) from the combined changeset for:
> 
> - [JDK-8298405](https://bugs.openjdk.org/browse/JDK-8298405): Implement JEP 467: Markdown Documentation Comments
> - [JDK-8329296](https://bugs.openjdk.org/browse/JDK-8329296): Update Elements for '///' documentation comments
> 
> The javac.1 file has its copyright year reverted to match what is in the source file (which should have been updated but wasn't).
> 
> Thanks.

Marked as reviewed by alanb (Reviewer).

Thanks for the tireless effort to update the man pages at the end of each release.

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

PR Review: https://git.openjdk.org/jdk/pull/20248#pullrequestreview-2187669729
PR Comment: https://git.openjdk.org/jdk/pull/20248#issuecomment-2238647463