Gilad writes, from JLS 2nd edition draft:
- A nested class is any class whose declaration occurs within the body of
another class or interface.
- A top-level class is class that is not a nested class.
- An inner class is a nested class that is not declared (implicitly or
"Nested class" is the more general term, as it applies to both
static and non-static classes. Therefore, wherever javadoc uses "inner class", it should be replaced by "nested class"
For example, "Inner Class Summary" should become "Nested Class Summary"
since it can contain both static and non-static classes:
See suggested fix for particular places this change needs to be made.