java - javadoc 中未提及的弃用方法

Question

我有 2 个类(class)。第一个包含已弃用的方法。第二个类实例化第一个类并使用其已弃用的方法。

编译器确实会显示警告，但是:

问题:为什么在运行 javadoc Test.java 后生成的 Java 文档中没有列出已弃用的方法？

代码如下:

import java.lang.annotation.*;
class Tester{
   private int a = 1;
   /**
   * @deprecated
   * This is deprecated because I do not like it
   */
   @Deprecated
   public void afficher(){
       System.out.println("a is: " + a);
   }
}
public class Test{
   public static void main(String[] args){
       Tester T = new Tester();
       T.afficher();
   }
}

这是生成的 Java 文档文件的屏幕截图，其中根本没有列出已弃用的方法:

Answer 1

正如评论中所指出的:Tester 类将不会被记录，因为它不被视为与 javadoc 相关。 默认情况下，仅收集 public 或 protected 用于文档 (http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html)。

要么改变它的可见性(例如让它protected 或public)，要么生成带有标记-package 或- 的javadoc私有(private)。但请注意，您可能会生成大量文档，而您可能根本不需要这些文档。

javadoc -package Test.java