RFR: 8157606: deprecate com.sun.javadoc API

[Jonathan Gibbons]

Please review this change to deprecate the old com.sun.javadoc API, and 
along with that, to also deprecate the corresponding implementation classes.

You can see the updated API docs, and the webrev, at the link below.

The webrev can be reviewed in two parts:
1. The types in com.sun.javadoc have had added both an @Deprecated 
annotation and an @deprecated tag pointing at the replacement API.
2. The types in the implementation packages have just had an @Deprecated 
annotation added.
This may be one of those reviews where it is easier to scan the patch 
file than to click on the links for 224 files.

JBS: https://bugs.openjdk.java.net/browse/JDK-8157606
API: http://cr.openjdk.java.net/~jjg/8157606/api.02/
Webrev: http://cr.openjdk.java.net/~jjg/8157606/webrev.02/

-- Jon