Reading the purple book gave me an idea for a javadoc enhancement.
I think it would be helpful if you could categorize your methods
into categories. This has no effect on the java language, but could
be used by javadoc, IDE's, and other tools.

/**
* Get Foo
* @category getters
* @return Foo
*/

Javadoc's framed layout is already similar to a Class Browser, it would be great if the Javadoc Class page allowed you to view only methods of a certain category, or all categories, etc.

Similarly eclipse and other IDE have the ability to collapse blocks of code, with this functionality you show only a certain category, or sort your class outline by category.

Currently I find myself adding comments like
//- Begin getters
...
//- Begin setters

But these comments are fragile and invisible once they are scrolled away.