java-8 - @param 描述以代码字体显示

Question

我正在为以下简单示例生成 javadoc:

public class test {
  /**
   * foo does something.
   *
   * @param x the parameter
   */
  public void foo(int x) {}
}

我运行javadoc test.java。

我希望 x 的名称以非比例字体显示，描述以比例字体显示，就像官方 JDK javadoc 中发生的情况一样。相反，我得到了此捕获中显示的内容:

这对于简短的描述来说还可以，但是对于较长的描述来说就很难看了。我做错了什么？

Answer 1

当您比较 Object.equals(obj) 的 Java API 文档时 Java 7和 Java 8您将看到字体的差异

Parameters:

obj - the reference object with which to compare.

部分。您也会看到所有其他方法的参数，我只是选择了众所周知的方法作为示例。

换句话说，这是 Java 7 和当前版本的 Java 8 之间 JavaDoc 行为的一般变化，您没有做任何错误。

如果你查看the stylesheet您会发现负责从第 287 行开始的描述部分的定义，其中包含属性 font-family:'DejaVu Sans Mono',monospace;。