Question

如何使用javadoc

Answer 1

1.Javadoc注释由Javadoc标签和描述性文本组成，你可以为类、接口添加注释，也可为构造函数、值域、方法等类中的元素添加注释。
可以通过代码模板快速的录入Javadoc注释，你也可以选择通过Javadoc对话框以一种形象化的方式录入Javadoc注释。此外，JBuilder还提供了各种Javadoc的辅助功能，如JavadocInsight诱导录入，冲突报告和更正，特殊的todo标签等。
2.虽然在Java文件中编写注释后，马上可以切换到内容窗格的Doc视图页代码中对应的Javadoc文档，但在Doc视图页中生成的文档仅是不完整的"范本"。首先，没有导航树，其次没有生成通过@see或@link关联内容的链接。所以你可以把Doc视图页中的Javadoc文档看成是Javadoc最终版本的预览。
3我们介绍了Javadoc的标签，讲解了如何在JBuilder编辑Javadoc注释，你应该尽量使用JavadocInsight、ClassInsight和ParameterInsight快速而正确地编写Javadoc注释。此外你应该将常用的注释做成模板，方便快速录入。
JBuilder提供的注释冲突报告和恢复的功能可以使你轻松解决注释冲突的问题，免除了单调的手工调整操作。