Use the [`@deprecated` Javadoc tag](http://docs.oracle.com/javase/1.5.0/docs/guide/javadoc/deprecation/deprecation.html#javadoc_tag)? Renders more nicely in the Javadoc, then.

Happy to amend that myself as part of the merge if it's too much of a hassle.