RFR: docs JDK-8225134: Update man-page files

[Mandy Chung]

Bringing these pages to more recent version is better than
the current so outdated version even it's just a snapshot.

The list of new pages look okay (but I didn't validate the
content.)

Mandy

On 5/31/19 2:02 PM, Jonathan Gibbons wrote:
> Please review a change to refresh the content of the man pages (*.1 
> files) in the main repo,
> to contain essentially the exact same content as found in the Oracle 
> JDK man pages.
>
> Going forward, the intent is to bulk-update these pages towards the 
> end of each release
> cycle, until we can eventually open source the underlying files from 
> which the man pages
> are derived, at which time these files will be deleted.
>
> This email is to build-dev at ojn, even though there are no Makefile 
> changes, because that
> list includes the folk mostly likely to make direct use of these 
> files.  It is also cc jdk-dev at ojn
> so that the OpenJDK community is generally aware of this change.
>
> Note, although the current man pages share a history with the previous 
> versions of these
> files, the transformations that have occurred between then and now 
> make it all but
> impossible to compare the versions side by side with diff. For those 
> folk wanting to review
> the content, it is best to look at the "New" or "Raw" files in the 
> webrev.
>
> -- Jon
>
> JBS: https://bugs.openjdk.java.net/browse/JDK-8225134
> Webrev: http://cr.openjdk.java.net/~jjg/8225134/webrev.00/webrev/
>
>