JBuilder2005创建开发文档之编写注释 (4) | |||||
---|---|---|---|---|---|
http://www.sina.com.cn 2005年07月05日 18:37 天极yesky | |||||
此时,General设置页的class Javadoc fields列表的设置情况如下图所示:
5、Javadoc注释冲突
每条冲突注释不但给出了冲突原因的简要描述,还指定了冲突发生的位置。你可以点击某冲突项,在弹出的对话框中选择Fix Javadoc Conflict for "XXX"修复这个冲突。你也可以右击Javadoc Conflicts文件夹,在弹出的菜单中选择Fix Javadoc Conflicts修复全部的冲突。 注意: Javadoc冲突只有在Errors文件夹中所有的语法错误都已经得到解决后才会报告出来。 6、todo标签 todo是JBuilder自定义的标签,但它并不用于生成Javadoc文档的内容。它相当于一个"助记符",表示此处有一个未完成的工作或一个待改进的工作,方便日后检索和处理这些未尽之事。 当前程序文件中的所有todo标签归结在结构窗格的To Do文件夹下。假设我们在Person.java中添加两个todo标签,如下所示:
在第8、19行添加上两个todo标签。todo标签可以放在程序的任何地方,而不象Javadoc标签一样必须放置在类、接口、方法等定义语句的前面。此时,这两个todo标签都将出现在结构窗格的To Do文件夹下,如下图所示:
点击To Do文件夹下的项目,编辑器定位到代码中相应的位置。
|