重新生成javadoc文档,检查@deprecated标签是否正确显示: 在添加了@deprecated标签后,你应该重新生成javadoc文档,并检查生成的文档中是否正确显示了过时信息。这通常可以通过IDE的内置功能或使用javadoc工具来完成。 sh javadoc -d doc -sourcepath src -subpackages com.yourpackage 上述命令会生成位于doc目录下的javadoc...
* 这是抛出异常的条件1(非必须),注意格式 * * @throws 注意如果方法还存在其他异常,可并列多个 */ public int test(int capacity){ if (capacity < 0) throw new IllegalArgumentException("Illegal initial capacity"); return capacity; } @deprecated用于指出一些旧特性已由改进的新特性所取代,建议用户不要...
{@tag} 格式的标签(由{ }包围的标签)为内联标签,可以放在主要描述中的任何位置或块标签的注释中。 标签 描述 示例 @author 标识一个类的作者,一般用于类注释 @author description @deprecated 指名一个过期的类或成员,表明该类或方法不建议使用 @deprecated description {@docRoot} 指明当前文档根目录的路径 Dire...
deprecation-comment 宣言の"deprecated"ステータスを記述するブロック内の詳細のクラス。 description-from-type-label 説明のコピー元の要素を示すラベルのクラス。 permits-note シール済クラスの許可されたサブタイプに関する情報を提供するノートのクラス。 preview-block 宣言の"プレビュー"ステー...
值得注意,@Deprecated这个annotation类型和javadoc中的 @deprecated这个tag是有区别的:前者是java编译器识别的,而后者是被javadoc工具所识别用来生成文档(包含程序成员为什么已经过时、它应当如何被禁止或者替代的描述)。 在java5.0,java编译器仍然像其从前版本那样寻找@deprecated这个javadoc tag,并使用它们产生警告信息。但是...
Javadoc 可以识别的标签如下表所示:标签 描述 示例 @author 标识一个类的作者,一般用于类注释 @author description @deprecated 指名一个过期的类或成员,表明该类或方法不建议使用 @deprecated description {@docRoot} 指明当前文档根目录的路径 Directory Path @exception 可能抛出异常的说明,一般用于方法注释 @...
-nodeprecatedlist 不生成已过时的列表 -notree 不生成类分层结构 -noindex 不生成索引 -nohelp 不生成帮助链接 -nonavbar 不生成导航栏 -serialwarn 生成有关 @serial 标记的警告 -tag <name>:<locations>: 指定单个参数定制标记 -taglet 要注册的 Taglet 的全限定名称 -tagletpath...
javadoc 标签说明大全.docx,javadoc 标签 javadoc 工具软件识别以下标签: 标签 描述 示例 @author 标识一个类的作者 @author description @deprecated 指名一个过期的类或成员 @deprecated description {@docRoot} 指明当前文档根目录的路径 Directory Path @exception 标
-nosince 不包括 @since 信息 -notimestamp 不包括隐藏时间戳 -nodeprecatedlist 不生成已过时的列表 -notree 不生成类分层结构 -noindex 不生成索引 -nohelp 不生成帮助链接 -nonavbar 不生成导航栏 -serialwarn 生成有关 @serial 标记的警告 -tag <name>:<locations>: 指定单个參数定制标记 -taglet 要注冊...
/** * @deprecated As of JDK 1.1, replaced by * {@link #setBounds(int,int,int,int)} */ 1. 2. Javadoc注释编写风格 Javadoc注释本质上仍是注释,因此在编写风格上并不存在强制的要求。但是为增强Javadoc文档可读性,Oracle提供了如下的风格指南: ...