Looks like this follows JEP 299 so OK by me. I do find it a bit strange
that we move the man pages out of the JDK/JRE images though.
/Erik
On 2017-05-11 05:56, Magnus Ihse Bursie wrote:
In preparation for JDK-8178317, the existing man page troff sources
will be moved to their corresponding modules, according to the layout
determined by JEP 299. During the docs build, they will be copied to
the man directory in the docs image, as specified by JEP 299. No
markdown conversion will be done for now, though.
Note that this will only apply to OpenJDK, not the Oracle JDK, which
do not ship the man pages from the OpenJDK repository. (This has not
been the case since at least JDK 8.) Also note that the man pages
themselves have not been updated. I did update "JDK 8" to "JDK 9", but
I have made no other changes. Nevertheless, I believe having man pages
(even if outdated) is better for the community than not having man pages.
The jhat and jsadebug tools have been removed in JDK 9, so I removed
these man pages as well.
Prior to this reorganisation, the man pages were duplicated in three
directories, one for each of solaris, linux and bsd. I have verified
that for the remaining man pages, there were no substantial difference
between these versions.
Bug: https://bugs.openjdk.java.net/browse/JDK-8180178
WebRev:
http://cr.openjdk.java.net/~ihse/JDK-8180178-restructure-man-pages/webrev.01
/Magnus