maven-javadoc-plugin 生成的库 javadoc 在 Eclipse 上链接时不起作用

Question

UPDATE1: 不仅仅是参数名称，eclipse 根本不显示任何 javadoc 信息。当您将鼠标悬停在 class 上时，不会显示任何内容。

UPDATE2: 我的 eclipse 版本是 4.2.0.

我正在使用 Eclipse，我想将一个库的 javadoc 附加到我的项目中，这样当我实现一个接口并选择选项 添加未实现的方法 方法参数名称 正确显示，而不是 arg0、arg1 等

问题是：

当我通过 eclipse（项目 > 生成 Javadocs...）生成 javadoc 并link它到我的项目时它有效，在换句话说，我看到了正确的方法参数名称。
当我通过 maven-javadoc-plugin 生成 javadocs 并link它到我的项目时它不起作用，换句话说，我看到 arg0、arg1 等

也许我没有正确配置我的 maven-javadoc-plugin？下面是我的 pom.xml:

的配置

  <plugin>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.8</version>
    <executions>
      <execution>
        <id>attach-javadocs</id>
        <goals>
          <goal>jar</goal>
        </goals>
      </execution>
    </executions>
  </plugin>

如有任何帮助，我们将不胜感激。看不到参数名称非常糟糕。

Answer 1

这与仅在 4.3 版中修复的 this eclipse bug 有关。基本上，eclipse 在以下行停止处理 javadoc html 文件：

<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">

因为它需要内容属性中的字符集，如下所示：

 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

我认为没有办法告诉 maven javadoc 插件更改此元标记，但您可以运行下面来自 maven 的 ANT 任务来修复所有 html 文件:

<replace dir="target/apidocs">
    <include name="**/*.html"/>
    <replacetoken><![CDATA[<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">]]></replacetoken>
    <replacevalue><![CDATA[<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">]]></replacevalue>
</replace>

maven-javadoc-plugin 生成的库 javadoc 在 Eclipse 上链接时不起作用

Library javadocs generated by maven-javadoc-plugin does not work when linked on Eclipse

java

javadoc

maven-plugin

maven