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

Sergey Bylokhov serb at openjdk.org
Fri Jun 24 18:26:57 UTC 2022


On Fri, 24 Jun 2022 17:34:34 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`.

Probably we should move this document to the new doc folder? Do we have a plans to align Readme/BuildDoc to the jdk/jdk version, simple readme with a few links and other docs in "doc" folder?: https://urldefense.com/v3/__https://github.com/openjdk/jdk__;!!ACWV5N9M2RV99hQ!MgDRDMzTYEPGYgxcsEe8WaXc2x0JlksBSF3hzD9X3HLlfv1G14eXWp8X1UQOZDrM866hHQ9XBLyFkr06KtY$ 

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

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


More information about the jdk8u-dev mailing list