<Swing Dev> <AWT Dev> RFR 8232880: Update test documentation with additional settings for client UI tooltip tests

[Erik Joelsson]

On 2019-10-25 08:42, Alexey Ivanov wrote:
> Hi Dmitry,
>
> Apple uses macOS to refer to its operating system, so should we also 
> use it instead of former OS X?
>
> For HTML version, I would suggest using the following markup 
> <kbd><kbd>Ctrl</kbd> +<kbd>F1</kbd></kbd> for the keyboard shortcut. [1]
>
The HTML is generated from the markup and should not be edited by hand.

/Erik

> I think using <pre><code> elements for instructions on how to disable 
> the shortcut is incorrect. In fact, it does not require any special 
> markup.
>
>
> What about this text?
> <p>Some client UI tests devoted to tooltips may fail on macOS 
> platform. The tests use <kbd><kbd>Ctrl</kbd> +<kbd>F1</kbd></kbd> key 
> sequence to show/hide a tooltip. However, this key combination is 
> reserved by the operating system. To run these tests correctly, the 
> default global shortcut should be disabled: choose Apple menu > 
> System Preferences, click Keyboard, then click Shortcuts; deselect 
> "Turn keyboard access on/of" property.<p>
>
> I copied the way Apple uses in its documentation to refer to commands.
>
> On 25/10/2019 11:27, Dmitry Markov wrote:
>> Hello,
>>
>> Could you review the fix for jdk14, please?
>>
>> bug: https://bugs.openjdk.java.net/browse/JDK-8232880
>> webrev: http://cr.openjdk.java.net/~dmarkov/8232880/webrev.00/
>>
>> Some Client UI tests use the following key sequence to show/hide 
>> tooltip message: “CTRL” + “F1". However this key combination is 
>> reserved by operating system on OS X platform. As a results the tests 
>> fail.
>> Test documentation should be updated with some notes regarding this.
>>
>> Thanks,
>> Dmitry
>>
>
> [1] https://www.w3.org/TR/html52/textlevel-semantics.html#the-kbd-element
>