Requested by Josh Bloch:
Ideally, I wouldn't display protected members of a non-abstract class at all
(on the class's main JavaDoc page).

In more detail:

For non-abstract classes: hide the protected members by default.
   Allow an "extenders" view of the same page that shows the protected members

For abstract classes: show the protected members (the theory being that
   abstract classes can only be extended and not instantiated)

We should pass this by a few other smart people and see if they agree.
The show/hide feature of non-abstract classes might generate bulky
documentation from the standard doclet. It would be more cleanly implemented
in pages that are served up (such as from XML).

doug.kramer@Eng 2000-01-18