There are several case where javac/javadoc ignores doc comments. We should warn user to prevent mistakes in doc comments.

example

class A {
/** will be ignored */
/** will be used */
public void m(){ }
}

/** ignored */
import something;
class B { }

class C {
  void m() {
    /** ignored */
  }
}