Why not use java annotations to resolve this issue ?
I think that is the right solution to the wrong problem :-)
Annotations don't in this case create any further knowledge that
would not be visible in the API description itself already... If we
had a lot of APIs, then we might benefit from the machine processing
abilities that annotations would produce, but as it stands, I don't
think we have that many. All it means is that the developer will
need to learn a non-standard way of interpreting our javadoc
documentation.
/Janne
