警告:悬空的Javadoc评论 [英] Warning: Dangling Javadoc comment

问题描述

自从我更新了Android Studio(2.3.1)和构建工具(2.3.1)以来，我收到了警告，

Since I updated my Android Studio (2.3.1) and build tools (2.3.1), I'm getting warning,

警告:悬而未决的Javadoc评论

Warning: Dangling Javadoc comment

对于类似的评论

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

如您所见，我使用javadoc样式注释进行链接等.我想知道是否还有其他具有链接功能的注释替代方法.

As you can see, I use javadoc style comment for linking and others. I'm wondering if there are other comment alternatives that have linking feature.

谢谢.

推荐答案

当您调用方法setNameText时，似乎正在使用Javadoc注释. Javadoc注释将插入 上方 ，类声明，方法声明或字段声明.

It looks like you are using a Javadoc comment when you call the method setNameText. Javadoc comments are to be inserted above a class declaration, a method declaration, or a field declaration.

如果仅在调用方法时需要注释，请使用单行注释:// get formatted name based on {@link FORMAT_NAME}.

If you simply want a comment when calling the method, use the one-line comment: // get formatted name based on {@link FORMAT_NAME}.

这篇关于警告:悬空的Javadoc评论的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！