idea生成javadoc
在 “Tools->Gerenate JavaDoc” 面版的 “Other command line arguments:” 栏里输入 “-encoding utf-8 -charset utf-8”,可以解决中文注释乱码的问题
Java注释
Java注释规则
// 注释一行
/* …… */ 注释若干行
/* …… / 注释若干行,并写入 javadoc 文档
通常这种注释的多行写法如下:
/**
* ………
* ………
*/
Java注释标记
javadoc 标记由“@”及其后所跟的标记类型和专用注释引用组成
javadoc 标记有如下一些:
@author 作者
@version 版本
@see 参考或相关部分
@param 对方法中某参数的说明
@return 对方法返回值的说明
@exception 对方法可能抛出的异常进行说明
{@code}
{@link #**}