解释 maven javadoc 插件空 <p> 标签错误

Question

我正在尝试为我的项目构建 javadoc，它给了我以下错误：

 [ERROR] /home/kshitiz/Documents/workspaces/ggts/log4j-weblayout/src/main/java/in/ksharma/weblayout/WebAppender.java:25: warning: empty <p> tag
 [ERROR] * <p>
 [ERROR] ^
 [ERROR] /home/kshitiz/Documents/workspaces/ggts/log4j-weblayout/src/main/java/in/ksharma/weblayout/WebAppender.java:30: error: unexpected end tag: </p>

有问题的课程有这个 Javadoc：

/**
 * <p>
 * Appender to allow logging to multiple files. Utilizes the roll over and
 * appending functionality of the FileRollingAppender.
 * 
 * Exceptions are stored in small HTML file called snippet. We use several small
 * HTML files instead of one large one due to performance reasons.
 * </p>
 * 
 * <p>
 * <h1>Usage:</h1>
 * It supports the same set of configuration options as
 * <code>org.apache.log4j.RollingFileAppender</code> Consult log4j documentation
 * for full list of options.
 * </p>
 * 
 * @author Kshitiz Sharma
 */

这

标签不为空。这个javadoc有什么问题？

Answer 1

该消息具有误导性。它说<p>是空的，但真正的问题是它不喜欢<h>嵌套在里面的标签<p>。

如果您想强调段落内的文本，请尝试使用<em>。