JDK documentation

[Mark Thornton]

Andy Tripp wrote:
> to keep the quality up while keeping it very simple to make changes? 
> In short,
> how do you let me quickly fix a typo in the API, but stop me from adding
> the comment "this method sucks!"
There are quite a few methods (and classes) where a @notRecommended tag 
might be appropriate.

A JavaDoc that moved these (and @deprecated) methods to a supplementary 
page would be great too.

Mark Thornton