Name: dk30142 Date: 10/03/2002


The doc comment for innerClasses() is currently:

  an array of ClassDoc for representing the visible classes defined in
  this class. Anonymous and local classes are not included.

An inner classes is defined in JLS as "a nested class that is not
explicitly or implicitly declared static." (JLS p. 140 2nd Ed.)
This method actually returns static and non-static nested classes.

This method was named long before the JLS definition came into effect;
we were originally advised that "inner class" was the proper term.

Therefore, I believe we should deprecate innerClasses() and replace it
with nestedClasses(). Same for innerClasses(boolean).

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