RFR: JDK-8179892 Update build documentation for JDK 9

[Magnus Ihse Bursie]

On 2017-06-21 10:07, Erik Joelsson wrote:
> Wow, this is massive, and very good!

Thanks you. It's been in the making for a long time, and I almost didn't 
get to complete it in time for JDK 9.

> IMO, we should just push this as is and handle any updates/corrections 
> as followups. Otherwise we risk not getting this in at all.

Agree. I'm sure there are lots of things left to improve. Please open a 
new bug for JDK 10 with your comments, or we can discuss in person when 
I'm back from my vacation.

/Magnus

>
> Looks good enough to me.
>
> /Erik
>
>
> On 2017-06-21 02:46, Magnus Ihse Bursie wrote:
>> Also known as: "!!!!!!!!!!!!!!! THIS IS A MAJOR RE-WRITE of this 
>> document. !!!!!!!!!!!!!" :-)
>>
>> The build documentation has been in need of an overhaul for a very 
>> long time. The document is not very well structured, and contains not 
>> only outdated but also irrelevant information, all the while valuable 
>> information is missing.
>>
>> For some time now, I've worked as a background project to rewrite the 
>> build documentation to address these shortcomings. Now it's finally 
>> done.
>>
>> Here is the new documentation in html format: 
>> http://cr.openjdk.java.net/~ihse/demo-new-build-readme/common/doc/building.html
>>
>> And here it is in markdown: 
>> http://cr.openjdk.java.net/~ihse/JDK-8179892-update-build-readme/webrev.01/raw_files/new/common/doc/building.md
>>
>> I've tried to make the document as readable as possible in raw 
>> markdown, hoping it can be of assistance for command-line users.
>>
>> Bug: https://bugs.openjdk.java.net/browse/JDK-8179892
>> WebRev: 
>> http://cr.openjdk.java.net/~ihse/JDK-8179892-update-build-readme/webrev.01
>>
>> /Magnus
>