How to mark deprecated in Java. http://stackoverflow.com/a/9031854

deprecated.java

/**
 * You shouldn't call this method anymore.
 * 
 * Don't forget to add a clarifying javadoc field for the programmer:
 *
 * @deprecated Use {@link #new()} instead.  
 */
@Deprecated
public void old() {
// ...
}