The RootDoc.classes() and PackageDoc.allClasses()
appear to do the same thing, but have different names.
If different, the api comments should make it clear.

Note:
allClasses() indicates that it includes errors
and exceptions, but classes() doesn't. But classes()
must do so, so that should be clarified, as well.

======================================================================

======================================================================

Changed synopsis from:
  JavaDoc API inconsistency

  RootDoc.classes() and PackageDoc.allClasses() inconsistent comments

The methods do similar things:
RootDoc.classes() gets all doc'd classes & interfaces in all packages, while
PackageDoc.allClasses() gets all doc'd classes & interfaces in given package.

  xxxxx@xxxxx   2002-09-25