在javadoc中@value的意外结果

Question

Javadoc似乎只处理@value声明引用字段的类上的标记,而只处理没有classname的引用.

例:

我有课

/** {@value #F} */
public class A {
    public static final String F = "field";
}

和

/** {@value A#F} */
public class B {}

jdk 1.7 javadoc工具处理@value标签,A但是B我得到以下警告:

warning - A#F (referenced by @value tag) is an unknown reference.

当我尝试引用的javadoc的领域这华林也occures A用A#F.当我使用@link标签时,一切都按预期工作.

我找不到任何文档提到@value标签可能只引用javadoc所在类中声明的字段.这是一个错误还是有另一种方法让@value标签显示值？

Answer 1

提供带有引用类的整个包名解决了我的问题：假设在包 com.example 中定义了类 A，这对我有用：

/** 
* {@value com.example.A#F} 
*/
public class B {}

希望能帮助到你。