[jdk8u-dev] RFR: 8139668: Generate README-build.html from markdown

[George Adams]

On Tue, 12 Jul 2022 15:55:49 GMT, Andrew John Hughes <andrew at openjdk.org> wrote:

>> This updates the build documentation so it `README-builds.html` is generated from `README-builds,md`
>> 
>> This is a precursor to [JDK-8176509](https://bugs.openjdk.org/browse/JDK-8176509) which also updates the `README`, simplifying #75 
>> 
>> There are deliberately no content changes here. In fact, JDK 9 changes to the documentation prior to this change are reverted (VS2010->VS2013 bump and other build requirement changes (namely [JDK-8041593](https://bugs.openjdk.org/browse/JDK-8041593) (JDK9 update), [JDK-8062223](https://bugs.openjdk.org/browse/JDK-8062223) (ccache update), [JDK-8076531](https://bugs.openjdk.org/browse/JDK-8076531) (Windows default compiler change) and [JDK-8072023](https://bugs.openjdk.org/browse/JDK-8072023) (make version change)). We can make our own updates once these changes are in.
>> 
>> The updated `README-builds.html` was generated from the new `README-builds.md`. I fixed a bug in `common/bin/update-build-readme.sh` which checks the variable `MARKDOWN` for the location of the processor but then uses a bare `markdown` in the actual invocation.  This script is removed in JDK-8176509 anyway, being replaced with `pandoc`.
>
> I can look at when the `doc` directory was added, but, if we add this to 8u, it should be a separate change, rather than part of this backport. I would prefer backports are as close to the original issue as possible, plus there's a follow-on fix I plan to backport that also happens before the directory is added.
> 
> I'll come back to this once the July security update is out. That's taking up all my time right now.

@gnu-andrew once you've got this good to merge I'll tackle [JDK-8176509](https://bugs.openjdk.org/browse/JDK-8176509) which should tidy up the README

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

PR: https://git.openjdk.org/jdk8u-dev/pull/79