为什么我生成的Javadocs看起来很糟糕？

Question

我正在尝试为我的项目生成Javadoc HTML文件.我通过Maven Javadoc插件(maven-javadoc-plugin)生成它们.我正在使用Maven 2.2.1.一切都产生了所有适当的信息,但HTML看起来很糟糕.太糟糕了,我不想那样发布它.这是一个截图:

(注意:是的,我看到'JavaScript已在您的浏览器上禁用'消息.即使我单击关于活动内容的IE 8警告并启用它,它也没有区别)

有各种不必要的换行符,基本格式只是废话.我错过了什么吗？我希望看到生成的Javadocs看起来类似于我在Eclipse中看到的,如果我将鼠标悬停在类或方法上并看到弹出的Javadoc面板.

我已经尝试在我的POM文件中添加设置,但在配置Javadoc生成器时我真的不知道我在做什么.这是我现在所拥有的(在<reporting>元素内):

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <configuration>
        <javadocExecutable>C:\Java\jdk1.7.0_05\bin\javadoc.exe</javadocExecutable>
        <javadocVersion>1.7</javadocVersion>
        <locale>en_US</locale>
        <show>package</show>
        <verbose />
    </configuration>
</plugin>

有什么建议？

---

更新:

Paulius提供的解决方案非常完美.我从我的<reporting>部分删除了上面的部分,因为它完全没必要.我<plugin>按照下面的说明添加了新元素.我的POM文件现在包含这个新块:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.8.1</version>
            <executions>
                <execution>
                    <id>attach-javadocs</id>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>           
        ...
    </plugins>
</build>

这是固定输出的样子:

Answer 1

maven-javadoc-plugin尝试从部分中删除reporting。如果您使用的是 Maven 3，则报告部分已被弃用，应删除。

尝试添加以下内容：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.8.1</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

到你的 Mavenplugins部分并运行它。我maven-javadoc-plugin这样使用它会生成正常的javadocs。

希望这可以帮助。