Java - メソッド注釈とともにjavadocを使用するための規約？

Question

私は次の方法があります。

@Override 
    public boolean myMethod() 
    { 
     // do stuff 
    } 

私は、このメソッドのjavadocを追加したい場合は、@Override注釈（またはその他の注釈）を有するとともに、これを行う方法上の任意の規則はありますか？

javadocのコメントは、メソッドの直前にある必要があります（2つの改行なし）。@Override注釈のすぐ上にjavadocコメントを置くとどうなるか分かりませんものアップ。

これは、たとえばこれを行う従来の方法ですか？これは機能しますか？

/** 
    * This is my method's javadoc comment. 
    */ 
    @Override 
    public boolean myMethod() 
    { 
     // do stuff 
    } 

Answer 1

はい、この方法は正しいですが、私はまだ別の方法を見ていませんでした。そして、はい、このように動作します。他の方法を試していない。

/** 
    * This is my method's javadoc comment. 
    */ 
    @Override 
    public boolean myMethod() 
    { 
     // do stuff 
    } 

しかし、インターフェイスを実装する場合は特に、基本的に私は通常、別のメソッドをオーバーライドするメソッドにJavadocコメントを追加しません。タグ@inheritDocは、大きな努力なしに文書を配布するのに役立ちます。しかし、これはこの例に固有のものです。他の注釈も追加することができます。

Answer 2

はい、正しく動作します。たとえば、openjdkのsource code of java.lang.Stringでは、@Deprecatedアノテーションの上にjavadocが使用されています。