yamad's Homepage

Note

[BUG] 8378157: The section hyperlink in doc/testing.md points to building.html instead of building.md

I updated references to the build documentation from the Gtest section in doc/testing.md for both HTML and Markdown formats.

Summary#

In the Gtest section of doc/testing.md, it referenced the "Running Tests" section in the build documentation. However, the link destination was only set to building.html#running-tests from the Markdown source file doc/testing.md.

When reading the generated HTML, linking to building.html is sufficient. On the other hand, when viewing Markdown files on GitHub or locally within a source tree, it would be more natural if there were also an option to move to building.md#running-tests. Therefore, I have revised the reference so that both HTML and Markdown links are available1.

-section ["Running Tests" in the build documentation](building.html#running-tests).
+section **"Running Tests" in the build documentation** ([html](building.html#running-tests), [markdown](building.md#running-tests)).

The changes target doc/testing.md and the corresponding generated file, doc/testing.html. This is a document-only modification that does not affect program functionality.

2026/04/05 PR Created#

In the PR, I changed the link in the Gtest section of doc/testing.md to indicate both HTML and Markdown2. The existing practice was to include links for both HTML and Markdown in the same directory's building.md, so I aligned with that format.

2026/04/06 Review#

I received Approve from Erik Joelsson3 and Iris Clark4, and /integrate was issued.

2026/04/07 Integration#

Approve and /sponsor were given by Albert Mingkun Yang5, and it was integrated into JDK as 34ac9266.

Footnotes#

  1. 8378157: Section hyperlink in doc/testing.md refers to building.html instead of building.md by PeyaPeyaPeyang · Pull Re…Enhance documentation for Gtest suite with hyperlink options in HTML and Markdown. Note that while the original source only included Markdown links, I followed the convention foun…GitHub
     ↩
  2. 8378157: Section hyperlink in doc/testing.md refers to building.html instead of building.md by PeyaPeyaPeyang · Pull Re…JDK main-line development https://openjdk.org/projects/jdk - 8378157: Section hyperlink in doc/testing.md refers to building.html instead of building.md by PeyaPeyaPeyang · Pull R…GitHub
     ↩
  3. https://openjdk.org/census#erikjopenjdk.org
     ↩
  4. https://openjdk.org/census#irisopenjdk.org
     ↩
  5. https://openjdk.org/census#ayangopenjdk.org
     ↩
  6. 8378157: Section hyperlink in doc/testing.md refers to building.html … · openjdk/jdk@34ac926JDK main-line development https://openjdk.org/projects/jdk - 8378157: Section hyperlink in doc/testing.md refers to building.html … · openjdk/jdk@34ac926GitHub
     ↩