RFR: 8355515: Clarify the purpose of forcePass() and forceFail() methods [v3]

[Alexey Ivanov]

On Mon, 19 May 2025 12:57:43 GMT, Manukumar V S <mvs at openjdk.org> wrote:

>> Clarified the purpose of forcePass() and forceFail() methods and recommended usage of these methods.
>> 
>> forcePass() contained an incorrect sample; it's addressed by [JDK-8355441](https://bugs.openjdk.org/browse/JDK-8355441).
>> 
>> The description of forceFail() has been expanded, too.
>> 
>> 
>> A new section in the description of the PassFailJFrame added to describe forcePass() and forceFail().
>
> Manukumar V S has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Review comments fixed : Forcibly wordings changed

I've regenerated the javadoc for `PassFailJFrame`:

* [Description of `forcePass` and `forceFail` methods](https://cr.openjdk.org/~aivanov/PassFailJFrame/api/PassFailJFrame.html#forcePassAndFail) in the top documentation;
* [`forcePass`](https://cr.openjdk.org/~aivanov/PassFailJFrame/api/PassFailJFrame.html#forcePass()),
* [`forceFail`](https://cr.openjdk.org/~aivanov/PassFailJFrame/api/PassFailJFrame.html#forceFail()),
* [`forceFail(String)`](https://cr.openjdk.org/~aivanov/PassFailJFrame/api/PassFailJFrame.html#forceFail(java.lang.String)).

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

PR Comment: https://git.openjdk.org/jdk/pull/25091#issuecomment-2891248330