我同意你的看法,HTML不属于源代码。 可悲的是,我没有find很多的帮助search这个。 这实际上很容易实现。
以下是您可以编译和使用的自定义Doclet:
import com.sun.javadoc.*; import com.sun.tools.doclets.standard.*; /** * Formats text-only comments with HTML. */ @SuppressWarnings("restriction") public final class TextDoclet { private static final Pattern NEWLINE_REGEX = Pattern.compile("\\n"); private static final String BR = "
\n"; public static boolean start(RootDoc rootDoc) { for ( ClassDoc classdoc : rootDoc.classes()) classdoc.setRawCommentText(formatText(classdoc.getRawCommentText())); return Standard.start(rootDoc); } private static String formatText(String text) { return NEWLINE_REGEX.matcher(text).replaceAll(BR); } }
如何使用javadoc调用它的一个例子:
javadoc -docletpath ~/project/text-doclet/target/text-doclet-1.0.0-SNAPSHOT.jar -doclet com.myorg.textdoclet.TextDoclet -sourcepath ~/project/myapp/src/main/java -subpackages com.myorg.myapp