Using {@inheritDoc} in a method of a class that implements an interface does not cause the doc to be copied from the interface's method; javadoc incorrectly warns:
    warning - @inheritDoc used but foo() does not override any method.

Simple example:

public interface Foo {
    /** javadoc */
    void foo();
}

public class Bar implements Foo {
    /** {@inheritDoc} */
    public void foo() {}
}