RFR: 8345144: Robot does not specify all causes of IllegalThreadStateException [v5]

[Alisen Chung]

> When robot.autoWaitForIdle is set to true, all mouse and key-related methods when invoked on the EDT will throw java.lang.IllegalThreadStateException which is not in the Robot specification.
> 
> This PR updates the specification by adding warnings to avoid calling lengthy and delay-type methods on EDT and including exceptions thrown when autoWaitForIdle is set to true and mouse/key-handling methods are called on the EDT.

Alisen Chung has updated the pull request incrementally with one additional commit since the last revision:

  api note

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/22564/files
  - new: https://git.openjdk.org/jdk/pull/22564/files/89a48d37..164e927f

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=22564&range=04
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=22564&range=03-04

  Stats: 2 lines in 1 file changed: 0 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/22564.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/22564/head:pull/22564

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