[jdk8u-dev] RFR: 8323197: [8u] building doc fixes

[Zdenek Zambersky]

On Mon, 8 Jan 2024 17:44:51 GMT, Zdenek Zambersky <zzambers at openjdk.org> wrote:

> Fixes for various issues in "building" doc:
> - removed information about mercurial and replaced with git as appropriate (as mercurial repos are no longer active)
> - fixed broken section references
> - fixed broken links, updated to web archive, where original site no longer exists ( with exception of `Windows FreeType DLL build instructions` link, where archived page is not available :( )
> - updated md tables to use `|`, so they would correctly display in GH (e.g. compare [old](https://github.com/openjdk/jdk8u-dev/blob/d898d4018e0a16f2115f4b1cbf93eb5e653b789b/doc/building.md#cygwin) [new](https://github.com/zzambers/jdk8u-dev/blob/fix-doc/doc/building.md#cygwin))
> - avoided use of block quotes (using `>`) in md, as it produces ugly result in GH (e.g. compare [old](https://github.com/openjdk/jdk8u-dev/blob/d898d4018e0a16f2115f4b1cbf93eb5e653b789b/doc/building.md#configure-options) [new](https://github.com/zzambers/jdk8u-dev/blob/fix-doc/doc/building.md#configure-options))
> - regenerated html (visual changes in generated html are quite minor)

Some additional notes:
- apart from hg->git info, this PR only does fixes to formating/style/links
- there are probably no more useful doc backports for 8u (as far as I know), last one was [JDK-8176509](https://bugs.openjdk.org/browse/JDK-8176509), following change is [JDK-8179892](https://bugs.openjdk.org/browse/JDK-8179892) (Update build documentation for JDK 9)

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

PR Comment: https://git.openjdk.org/jdk8u-dev/pull/416#issuecomment-1934267805