[jdk8u-dev] RFR: 8176509: Use pandoc for converting build readme to html

[Andrew John Hughes]

On Thu, 7 Sep 2023 20:09:14 GMT, Zdenek Zambersky <zzambers at openjdk.org> wrote:

> This backport switches to pandoc for coversion of building readme to html. It also does some style/formating changes/fixes to building readme, which is moved to new location and also removes redundant information in other Readme files.
> 
> Backport is not clear. Code for coversion to html had to be modified to work with JDK8 build system. Change set (patch) for building readme mostly applied automatically, but some parts had to be done by hand due to few differences.
> 
> Unlike in original change set, this backport moves `README-builds.{md,html}` files directly to `doc/building.{md,html}` and not to intermediate location `common/doc/building.{md,html}`. (additional move was done in jdk10 as part of [JDK-8187443](https://bugs.openjdk.org/browse/JDK-8187443))

Looks good to me. 8u build requirements seem to have been retained as is and I think moving the file to the final place here is the right thing to do.

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

Marked as reviewed by andrew (Reviewer).

PR Review: https://git.openjdk.org/jdk8u-dev/pull/370#pullrequestreview-1726077834