[jdk11u-dev] RFR: 8251549: Update docs on building for Git

[Aleksey Shipilev]

On Fri, 6 Aug 2021 13:32:43 GMT, Severin Gehwolf <sgehwolf at openjdk.org> wrote:

> Hi,
> 
> Now that OpenJDK 11u is fully on Git we should update the docs to no longer refer to Mercurial and use Git instead. The JDK 16 patch doesn't apply clean due to some differences in the file (e.g. referring to JDK 8 vs. JDK 11 in head). `doc/building.html` is the result of running `make update-build-docs` when the `building.md` file has the relevant changes.
> 
> Thoughts?

The `*.md` change looks good, but `*.html` has a lot of irrelevant changes. This is usually caused by a different version of pandoc used to generate the HTML file. Please run `make update-build-docs` on master and see what changes it brings. The usual way is to find the pandoc version that produces the minimal changes to HTML. If we don't do this, then HTML would change every time a future contributor changes MD again.

-------------

PR: https://git.openjdk.java.net/jdk11u-dev/pull/205