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

[Jonathan Gibbons]

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/