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
