如何格式化javadoc注释中的标题？

如何格式化javadoc注释中的标题，使其与

@param

、

@return

或

@throws

的格式相匹配。我不是在问如何定义我自己的关键词，而是如何用一个类似于它们的粗体标题

我试过

，但是在Eclipse的Javadoc视图中它看起来很糟糕，特别是它的大小要大得多。是否有其他选择或

方法

/**
 * foo
 *
 * @param x foo
 * @return foo
 * @throws foo
 */
public int foo(int x) { return x; }

截图来自Eclipse

更新

我认为

不够，因为它没有添加换行符：

/**
 * Introdcution
 * 
 * <strong>Heading</strong>There is no line break.
 * <strong>Heading</strong>There is no line break.
 *
 * @param x foo
 * @return foo
 * @throws foo
 */

/**
*介绍
* 
*标题没有换行符。
*标题没有换行符。
*
*@param x foo
*@returnfoo
*@foo
*/

使用：

/**
*标题没有换行符。
*
标题没有换行符。
*
*@param x foo
*@returnfoo
*@foo
*/
公共int foo（int x）{return x；}

只需查看Java API生成的Java文档，例如（查看HTML源代码）

他们使用html描述列表进行格式化，并使用

strong

CSS类对术语进行格式化。同样的道理：

/**
 * Introdcution
 * 
 * <dl>
 * <dt><span class="strong">Heading 1</span></dt><dd>There is a line break.</dd>
 * <dt><span class="strong">Heading 2</span></dt><dd>There is a line break.</dd>
 * </dl>
 *
 * @param x foo
 * @return foo
 * @throws foo
 */

/**
*介绍
* 
* 
*标题1这是换行符。
*航向2换行。
* 
*
*@param x foo
*@returnfoo
*@foo
*/

看起来像这样：

---

foo

-请注意，第一句话通常是自动加粗的（但在

foo

之后需要一个

）。我是否应该在前面和后面放一个

来获得换行符？它会自动添加一个换行符。对我来说，Eclipse javadoc视图和工具提示都没有添加换行符。但是在您附加的图像中，“foo”和参数之间有一个换行符。默认情况下，此换行符在那里<代码>对我来说不会改变任何关于换行符的信息。

/**
 * Introdcution
 * 
 * <dl>
 * <dt><span class="strong">Heading 1</span></dt><dd>There is a line break.</dd>
 * <dt><span class="strong">Heading 2</span></dt><dd>There is a line break.</dd>
 * </dl>
 *
 * @param x foo
 * @return foo
 * @throws foo
 */