RFR: 8007072: Update Core Reflection for Type Annotations to match latest spec

[Joel Borggren-Franck]

Hi,

Here is an update to the javadoc and implementation of reflection for
type annotations.

The biggest change is an update to the javadoc of Class and Executable
to match return types of the getGeneric* functions. That is, when
getGenericFoo returns an empty array getAnnotatedFoo should return an
empty array. Likewise for null.

Also the javadoc wording is updated to better match the style of
existing docs, for example type names in {@code }.

Change is actually quite small:

http://cr.openjdk.java.net/~jfranck/8007072/webrev.00/

Two of the three bugs fixed:

https://bugs.openjdk.java.net/browse/JDK-8007072
https://bugs.openjdk.java.net/browse/JDK-8024915

Please review.

cheers
/Joel