<AWT Dev> RFR: 8179365 : JAWT (AWT Native Interface) specification needs to be updated for JDK 9

[Phil Race]

Bug: https://bugs.openjdk.java.net/browse/JDK-8179365
webrev: http://cr.openjdk.java.net/~prr/8179365/

the JAWT spec as currently published has not been maintained
http://docs.oracle.com/javase/8/docs/technotes/guides/awt/AWT_Native_Interface.html

and worse that location will not be published for 9.
Also the spec needs to be updated for 9 to document the EmbeddedFrame 
support.

This moves the JAWT spec into the new "spec" area specified by JEP 299 (see
the bug report for links on that) and will ensure that JAWT will be 
documented in 9.

As well as documenting the missing APIs (including some from earlier 
releases)
it "freshens" the textual parts of the document.

Since the "spec" part is essentially a regurgitation of the header files 
those
had a few updates too. And the Mac one was not previously listed.

-phil.