@param 描述以代码字体显示

Question

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

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

我运行javadoc test.java。

我希望x 的名称以非比例字体显示，而描述则以比例字体显示，就像官方 JDK javadocs 一样。相反，我得到了此捕获中显示的内容：

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

Answer 1

当您比较 Object.equals(obj) 和 Java 7 和 Java 8 的 Java API 文档时，您会看到字体的不同

参数：

obj - 要与之比较的参考对象。

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

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

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