javadoc will need to be enhanced in a variety of ways to handle the enhanced deprecation annotations. Of particular note is the new forRemoval element of the @Deprecated annotation. There are a couple ideas:

1) Change the wording of the text that's inserted into the specification of an API that is deprecated for removal. The wording should make clear that the API is to be removed, and it should be made stronger. The formatting could also be changed in order to attract more attention.

2) The list of deprecated APIs should note the forRemoval status of the API as well as displaying the text of the "since" element of the @Deprecated annotation.