RFR: 8340818: Add a new jtreg test root to test the generated documentation [v10]

[Nizar Benalla]

On Wed, 16 Oct 2024 16:19:51 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:

>> Please review this change that adds a new test root `docs` dedicated to testing the documentation, which has been a work in progress for a while. Tests for links, encoding, HTML, accessibility will be later added in following PRs. 
>> 
>> We also define a new make target `test-docs` meant for local use and depends on the docs.
>> This also adds the necessary configurations needed at Oracle.
>> 
>> This patch includes a test `TestDocs` which serves to show developers how they are meant to resolve the docs to test them, I want to include it temporarily until better tests are added later.
>> 
>> TIA
>
> Nizar Benalla has updated the pull request incrementally with one additional commit since the last revision:
> 
>   ADD TEST_DEPS when calling tests using test-$1
>   
>   drop docs/req.flg

I did and it works as intended, thanks for the suggestion.

Building master failed on all platforms after [JDK-8338023](https://bugs.openjdk.org/browse/JDK-8338023) so I couldn't test this in our CI yesterday. I will push after testing the new code with Mikael and Eric's suggestions to avoid any surprises.

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

PR Comment: https://git.openjdk.org/jdk/pull/21272#issuecomment-2419865112