RFR: JDK-8180178 Restructure existing man pages according to JEP 299

[Jonathan Gibbons]

On 05/11/2017 05:44 PM, Erik Joelsson wrote:
>
> On 2017-05-11 15:38, Mandy Chung wrote:
>> Magnus,
>>
>> I’m surprised to see the man pages are moved to src/$MODULE/share/man 
>> directory.  These man pages are not maintained and not updated. It’s 
>> agreed that the man pages are specification for the tools that we 
>> should write and include in the source under src/$MODULE/share/man 
>> directory.  However, it’s not intended to move these unmaintained man 
>> page to the source.
> My quick skimming through JEP 299 led me to think this was indeed the 
> intention, at least as placeholders until better documentation can be 
> provided. 

That was the original intent when we (optimistically) thought that we 
would have time to do a pass over these docs to bring them up to date 
for JDK 9.

-- jon