web-dev-qa-db-ja.com

警告：Javadocコメントの宙ぶらりん

Android Studio（2.3.1）およびビルドツール（2.3.1）を更新したため、警告が表示されます。

警告：Javadocコメントの宙ぶらりん

次のようなコメントのために、

/** set name with format, {@Link FORMAT_NAME} **/
setNameText(getFormattedName(FORMAT_NAME));

ご覧のとおり、私はリンクなどにjavadocスタイルのコメントを使用しています。リンク機能を持つ他のコメントの選択肢があるかどうか疑問に思っています。

ありがとう。

androidandroid-studiojavadocandroid-studio-2.3
14
Dhunju_likes_to_Learn

メソッドsetNameTextをcallするときにJavadocコメントを使用しているようです。 Javadocコメント を挿入するaboveaクラス宣言、メソッド宣言、またはフィールド宣言。

メソッドを呼び出すときに単にコメントが必要な場合は、1行のコメントを使用します：// get formatted name based on {@link FORMAT_NAME}。

14
gjigandi

「ファイル-設定-エディタ-検査-Java-Javadocの問題-Javadocコメントのダングリング」ページでオフにすることができます。

4
Qian Sijianhao

/ *で始まるブロックコメント形式ではなく、/ **で始まるJavadoc形式を使用しています。

この警告を軽減するには、メソッド内のコメントを常に/ **ではなく/ *で開始します。

3
dev_mjm

「Dangling Javadoc Comment」をブロックコメントに置き換えるだけです。

1
Cobain

私には、このコメントの正しい場所はメソッドgetFormattedName（）と並んでいるように思えます。なぜなら、あなたのコメントは、あなたがそれを呼び出している理由ではなく、そのメソッドの機能を説明しているからです。

0
pedram bashiri