Java needs better Javadoc

What the deal with Javadoc?

That shit is non-semantic and non-standard and totally needs a revamp!

Who's with me.

The Python stuff is good for what it does, but it needs to come with a full-text search client. And it's horrible when you want to know how a function will react in edge cases, like what exceptions a function will cast. Javadoc is much better here of course, because of their Forced Handling of Exceptions, but at what cost?

I wish they'd do some static inference of this, with an option to supplement/override it in the doc.