Eclipse Javadoc格式：如何允许/禁止单行Javadoc注释？

Question

Eclipse Javadoc格式：如何允许/禁止单行Javadoc注释？

3

所以，随机问题：

我有一个代码库，其中许多枚举等都有像这样的注释：

public enum SomeEnum {
  /** value1 */
  VALUE1,
  /** value2 */
  VALUE2;
}

有没有办法强制Eclipse格式化程序将Javadocs分成“标准”的多行格式，例如下面的格式？我的当前设置对上面的代码片段没有影响。

public enum SomeEnum {
  /**
   * value1
   */
  VALUE1,
  /**
   * value2
   */
  VALUE2;
}

当前行为并未实现此功能 - 运行 Eclipse 4.4.0，勾选以下 Javadoc 注释设置：

(X) Format HTML tags
(X) Format Java code snippets inside 'pre' tags
(X) Blank line before Javadoc tags
(X) Indent Javadoc tags
  ( ) Indent description after @param
( ) New line after @param tags
(X) /** and */ on separate lines
( ) Remove blank lines

谢谢！

- Sbodd

1

这是Eclipse代码格式化程序中的许多错误之一，包括Javadoc注释。您应该在此处打开错误报告（https://bugs.eclipse.org/bugs/）。 - user1803551

2个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- user1803551 · Answer 1

解决方法：打开 查找/替换（ctrl+F），在 查找 字段中输入 \Q/**\E，在 替换为 字段中输入 /**\R，然后点击 全部替换。完成后激活格式化程序，它应该按照您想要的方式进行格式化。（您所做的是在每个 Javadoc 注释的开头添加一个新行，这迫使格式化程序使用多行格式。）

- Lii · Answer 2

格式化程序未将/**和*/移动到不同行可能是由于勾选了格式化程序→注释→常规设置→永不合并行选框所导致。