首先介绍 Java 的 3 种注释：
1. // 单行注释
2. /*
多行注释
*/
3. /**
文档注释 可以借助 javadoc 的命令将文档注释(markdown)生成为html
*/
建个 CommentTest 类，路径 csu\src\CommentTest.java
package com.shuai.test;
/**
* Created by shuai
* on 2017/8/15.
* @author shuai 作者
* @since 1.0 JDK 版本
*/
public class CommentTest {
/**
* @param s String
* @return String
*/
public String test(String s) {
return "hello";
}
public static void main(String[] args) {
}
}
命令行执行命令
ShuaideMacBook-Pro:src shuai$ javadoc -d ../doc CommentTest.java
正在加载源文件CommentTest.java...
正在构造 Javadoc 信息...
正在创建目标目录: "../doc/"
标准 Doclet 版本 1.8.0_131
正在构建所有程序包和类的树...
正在生成../doc/com/shuai/test/CommentTest.html...
正在生成../doc/com/shuai/test/package-frame.html...
正在生成../doc/com/shuai/test/package-summary.html...
正在生成../doc/com/shuai/test/package-tree.html...
正在生成../doc/constant-values.html...
正在构建所有程序包和类的索引...
正在生成../doc/overview-tree.html...
正在生成../doc/index-all.html...
正在生成../doc/deprecated-list.html...
正在构建所有类的索引...
正在生成../doc/allclasses-frame.html...
正在生成../doc/allclasses-noframe.html...
正在生成../doc/index.html...
正在生成../doc/help-doc.html...
之后就生成了完整的注释，路径 csu\doc
