RFR: JDK-8179892 Update build documentation for JDK 9

[Thomas Stüfe]

Hi Magnus,

excellent work! Some minor remarks:

You also mentioned Cygwin hg in the "Special considerations" section.
However, because updating Cygwin is a bit of a pain (you need to close all
consoles to do this) it may make sense to move the "Install Cygwin and all
required packages" up to the beginning of the document and include
"mercurial" in the list of cygwin packages to install.

In addition to that (if contributing to the OpenJDK is in the scope for
this document?) it may make sense to install at least ksh (for webrevs) and
sftp (for uploading webrevs) for Cygwin.

As for AIX, so far we have not yet broken compatibility with AIX 5.3. While
this is something which we may give up in the future, currently jdk9/10
still build and run on AIX 5.3 and 6.1. I think we can flesh out this
section a lot. We will discuss this in our team.

Kind Regards, Thomas



On Wed, Jun 21, 2017 at 2:46 AM, Magnus Ihse Bursie <
magnus.ihse.bursie at oracle.com> 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/commo
> n/doc/building.html
>
> And here it is in markdown: http://cr.openjdk.java.net/~ih
> se/JDK-8179892-update-build-readme/webrev.01/raw_files/new/c
> ommon/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-re
> adme/webrev.01
>
> /Magnus
>