我用javadoc命令生成api文档,为什么用包生成的,和用文件生成的,里面的构造器的注释不一样呢?

用包生成的api文档中,构造器函数的注释是空的,而用文件生成的构造器函数注释是能正常显示的。
第一次是直接用的javadoc+包名来生成的文档。
第二次是用javadoc+*.java文件来生成的文档。
文件都是一样的。但是生成的文档注释却不一样。

说明是下面这样的,结构上有点不同。构造中,是不是没点开来看。

用“javadoc+包名”命令生成的文档被框架分成了三部分:包列表、类列表和类说明。在包列表中选择了某个包之后,类列表中就会列出该包中的所有类;在类列表中选择了某个类之后,类说明部分就会显示出该类的详细文档。

而用“javadoc+*.java”令生成的文档只有两部分,类列表和类说明,没有包列表。这就是两种方式生成文档的最大区别了。
温馨提示:内容为网友见解,仅供参考
第1个回答  2013-01-08
你的这种情况我没试过,我一般都是用eclipse自带的导出api

/***/这种格式,都是会被javadoc获取的
我猜想,你第一次是多了对包的注释吧
第二次只是对类的注释追问

我是java初学者,看疯狂java讲义这本书里,讲到javadoc命令生成api,我就把这本书里面的Testjavadoc这个文件自己加了个构造器 public Testjavadoc() {} ,然后自己用了文档注释,把这个构造器注释了一下,在cmd里用javadoc生成api,结果用包名来生成的api 就是没有这个构造器的注释信息。而用文件名生成就能正常显示。

追答

哦,那可能就是只收集包的注释吧....这个我没验证

如果你是初学,建议你别费太大的功夫去研究这个,没太大意义,(我学java都7年了,我也没有玩过这个东东,不过虽然我没有玩过,但是想玩,也很容易,原因不是我厉害,只是学的多了,就知道处理的方法,也是常说的经验吧)

现在的书编写的,没有重点....
后面有很多东西要学的, 别死扣一个技术点,如果理解不了,就记住,越过,学习后面的东东,过段时间,再回过头来再看,学习要循序渐进么...

追问

呵呵,谢谢!我就是有点迷糊,不过听了您这话,我就不纠结了,也不是很重要的点,我就一点一点往后学习吧。谢谢您的解答!

追答

恩,没事,记住这个疑惑,若干时间后,你再回头想想,再来看,相信那时候,你会迎刃而解的.

本回答被提问者采纳
相似回答