When you need to change the parameters or name of a class or method you developed use the javadoc @deprecated tag and leave the old code. This allows other to be warned that they need to update their code without having to break a build process.
The following code illustrates its usage:
* Adds a resouce to list.
* @deprecated replaced by <code>addResource(String, String)</code>.
public void addResource( String name )
If you use the old method, you will get this message from the compiler:
Note: Test.java uses or overrides a deprecated API.
Note: Recompile with -deprecation for details.
Be sure to comment the reason for the change and the replacement method that should be used.