RFR: 7903683 Document how to run individual self-tests

[Jaikiran Pai]

On Tue, 27 Feb 2024 11:02:46 GMT, Ludvig Janiuk <lujaniuk at openjdk.org> wrote:

> Add documentation on how to run individual self-tests with their ".ok" files to building.md.

doc/building.md line 113:

> 111: ```
> 112: bash build/make.sh -- $(pwd)/build/test/ControlTest.ok
> 113: ```

Hello Ludvig, I think the idea of documenting this is a good one. I myself struggled to find a way to run individual tests until I saw your PR.

As for the proposed text, I think it will still leave open a lot of questions - like, how does one find the right `.ok` target to pass to this command. The answer to that already resides in https://github.com/openjdk/jtreg/blob/master/test/README.md#makefiles. I think as part of the current proposed change, we may have to include a pointer to that other file to provide context about the `.ok` target or maybe just migrate that README.md file contents into this building.md file.

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

PR Review Comment: https://git.openjdk.org/jtreg/pull/184#discussion_r1519677938