Integrated: 8340785: Update description of PassFailJFrame and samples

[Alexey Ivanov]

On Tue, 24 Sep 2024 15:51:09 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:

> I re-worked the entire description of `PassFailJFrame`:
> 
> Add description of what UI elements it provides and how to interact with them.
> Add anchors for linking to the sections.
> 
> Use `{@snippet}` instead of `<pre>{@code}</pre>` for sample code.
> Use method references instead of lambdas in samples.
> Document required jtreg tags to use `PassFailJFrame`.
> Rename `SampleOldManualTest` to `ObsoleteManualTest`.
> 
> Provide an overview of `Builder` methods to configure `PassFailJFrame`.
> 
> As in #21145, the generated javadoc [PassFailJFrame.html](https://cr.openjdk.org/~aivanov/PassFailJFrame/api/PassFailJFrame.html) could be easier to read and review.
> 
> The current version of the generated docs contains changes from #21145 and this PR. The PRs can be integrated independently.

This pull request has now been integrated.

Changeset: 5063494f
Author:    Alexey Ivanov <aivanov at openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/5063494f5b0859a396b4e41096793c777d4650b8
Stats:     159 lines in 1 file changed: 126 ins; 0 del; 33 mod

8340785: Update description of PassFailJFrame and samples

Reviewed-by: prr

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

PR: https://git.openjdk.org/jdk/pull/21162