doc/testing.md
changeset 58930 a4ddd1667c72
parent 58296 7b534a5088d9
equal deleted inserted replaced
58929:03f182a0f62c 58930:a4ddd1667c72
   419 
   419 
   420     $ make test TEST="jtreg:sun/security/pkcs11/Secmod/AddTrustedCert.java" JTREG="JAVA_OPTIONS=-Dtest.nss.lib.paths=/path/to/your/latest/NSS-libs"
   420     $ make test TEST="jtreg:sun/security/pkcs11/Secmod/AddTrustedCert.java" JTREG="JAVA_OPTIONS=-Dtest.nss.lib.paths=/path/to/your/latest/NSS-libs"
   421 
   421 
   422 For more notes about the PKCS11 tests, please refer to test/jdk/sun/security/pkcs11/README.
   422 For more notes about the PKCS11 tests, please refer to test/jdk/sun/security/pkcs11/README.
   423 
   423 
       
   424 ### Client UI Tests
       
   425 
       
   426 Some Client UI tests use key sequences which may be reserved by the operating
       
   427 system. Usually that causes the test failure. So it is highly recommended to disable
       
   428 system key shortcuts prior testing. The steps to access and disable system key shortcuts
       
   429 for various platforms are provided below.
       
   430 
       
   431 #### MacOS
       
   432 Choose Apple menu; System Preferences, click Keyboard, then click Shortcuts;
       
   433 select or deselect desired shortcut.
       
   434 
       
   435 For example, test/jdk/javax/swing/TooltipManager/JMenuItemToolTipKeyBindingsTest/JMenuItemToolTipKeyBindingsTest.java fails
       
   436 on MacOS because it uses `CTRL + F1` key sequence to show or hide tooltip message
       
   437 but the key combination is reserved by the operating system. To run the test correctly
       
   438 the default global key shortcut should be disabled using the steps described above, and then deselect
       
   439 "Turn keyboard access on or off" option which is responsible for `CTRL + F1` combination.
       
   440 
       
   441 #### Linux
       
   442 Open the Activities overview and start typing Settings; Choose Settings, click Devices,
       
   443 then click Keyboard; set or override desired shortcut.
       
   444 
       
   445 #### Windows
       
   446 Type `gpedit` in the Search and then click Edit group policy; navigate to
       
   447 User Configuration -> Administrative Templates -> Windows Components -> File Explorer;
       
   448 in the right-side pane look for "Turn off Windows key hotkeys" and double click on it;
       
   449 enable or disable hotkeys.
       
   450 
       
   451 Note: restart is required to make the settings take effect.
       
   452 
   424 ---
   453 ---
   425 # Override some definitions in the global css file that are not optimal for
   454 # Override some definitions in the global css file that are not optimal for
   426 # this document.
   455 # this document.
   427 header-includes:
   456 header-includes:
   428  - '<style type="text/css">pre, code, tt { color: #1d6ae5; }</style>'
   457  - '<style type="text/css">pre, code, tt { color: #1d6ae5; }</style>'