The JAWT guide/specification is in need of updating to document new API added
(see https://bugs.openjdk.java.net/browse/JDK-8148109)
In fact the document is even more out-dated than that so it minimally needs to
be updated to cover all the current functions supported.

Additionally the JAWT guide is currently published on the web along with the docs bundle
For JDK 9 not all guides will be published in time for GA as they are undergoing revisions in
the editing and publishing toolchain.
So updating it in its current (closed) location is not going to help.
JEP 299 (Reorganize Documentation) https://bugs.openjdk.java.net/browse/JDK-8167227
is providing a new location for specs.

Whilst some other AWT specifications might be candidates to be moved as per
https://bugs.openjdk.java.net/browse/JDK-8177563
the JAWT one seems like a good place to start as it needs to be updated and moved regardless.