The API modeling sealed classes and interfaces in javax.lang.model may benefit from some refinement.

In particular, the "getPermittedSubclasses" may be renamed to convey subtypes are classes or interfaces can be returned. In any case, the discussion of the nature of "permitted subclasses" should be explained in more detail.