that was the idea, but before we go overboard someone needs to figure out which IDEs display what how, since I could not get Eclipse to show me these in a half-way decent form; it seems that Eclipse does not actually use the -javadoc artifact, instead it parses the attached source if present.

So, in conclusion: I’d like to keep this in an figure out later whether that can fill the gap left by Java’s weaker deprecation support (i.e. without message).