When you already add a javadoc comment, then please also add a synopsis and explain the passed parameters.

Also add an @Deprecated annotation to the method, as this is then flagged in the IDE in various places.