他のクラスのメソッドへのJavadocリンク

現在、私はこのJavadoc構文で他のクラスのメソッドを参照しています：

@see {@link com.my.package.Class#method()}

そして、私がドキュメントから理解していることでは、これはこれを行う正しい方法です。しかし、今面白い部分、またはイライラします。このjavadocを生成すると、まず次のエラーが発生します。

warning - Tag @see:illegal character: "123" in "{@link com.my.package.Class#method()}"
warning - Tag @see:illegal character: "64" in "{@link com.my.package.Class#method()}"
warning - Tag @see: reference not found: {@link com.my.package.Class#method()}

これの生成されたHTMLコードは次のとおりです。

"," <code>com.my.package.Class#method()}</code> ","

そしてもちろん私にはリンクがありません。誰が何が起こっているのか、そしてこれを修正する方法についてのヒントはありますか？

ASCIIテーブルによれば、woldの文字123および64は{および@を表すので、ドキュメントに従ってこの構文が正しい場合、これらの文字はなぜ有効ではないのでしょうか。

Javadocタグの@see場合、を使用する必要はありません@link。Javadocがリンクを作成します。試す

@see com.my.package.Class#method()

についての詳細はこちら@seeです。

を除いて@see、別のクラス、およびおそらくそのクラスのメソッドを参照するより一般的な方法は{@link somepackage.SomeClass#someMethod(paramTypes)}です。これには、javadocの説明の途中で使用できるという利点があります。

javadocドキュメントから（@linkタグの説明）：

このタグは@seeに非常に似ています。どちらも同じ参照を必要とし、package.class＃memberとlabelにまったく同じ構文を受け入れます。主な違いは、{@ link}は「関連項目」セクションにリンクを配置するのではなく、インラインリンクを生成することです。また、{@ link}タグは、他のインラインテキストと区切るために中括弧で開始および終了します。

したがって、元の問題の解決策は、「@ see」と「{@link ...}」の両方の参照を同じ行に必要としないことです。「@link」タグは十分なものであり、前述のように、javadocブロック内の任意の場所に配置できます。したがって、2つのアプローチを組み合わせることができます。

/**
 * some javadoc stuff
 * {@link com.my.package.Class#method()}
 * more stuff
 * @see com.my.package.AnotherClass
 */