eclipse - Eclipse javadoc 注释中的错误换行

Question

我认为，在 Eclipse 内置 Java 格式化程序中存在一个小但令人讨厌的错误。我有一个看起来像这样的 Javadoc 评论:

/**
 * - - - stuff - - - {@code mTasksBelow}.
 */

其中末尾的句点在第 81 列中。格式化程序设置为在第 80 行包装 Javadoc 注释。不幸的是，当我格式化代码时，它执行以下操作:

/**
 * - - - stuff - - - {@code mTasksBelow}
 * .
 */

这会在生成的输出中的文本和句点之间放置空白，因此，例如，以 HTML 格式呈现 Javadoc 的浏览器也会认为可以在此处中断。

除非句点跟在 Javadoc 标记之后，否则这似乎不会发生。 (例如，如果该行以右括号和第 81 列中的句点结束，则它会在最后一个单词之前正确断开。)

我可以移动环绕列，但这只会移动问题。我不想转
换行符，因为我喜欢我的 Javadoc 源代码与生成的输出一样可读。是否有一些我遗漏的设置或者这实际上是一个错误？

Answer 1

那么有一个不太有趣的解决方法。要解决此问题，请尝试在 Eclipse 格式化程序中启用 Off/On Tags。

窗口 -> 首选项 -> Java -> 格式化程序 -> 编辑 -> 关/开标签 -> 启用关/开标签

然后你需要用这些标签包围你的评论，这样格式化程序就不会触及它(注意标签需要在单独的评论块中，否则 Eclipse 将忽略它们)。例如:

//@formatter:off
/**
 * Oddly formatted comment.              MUHAHAHAHAH :)
 **/
//@formatter:on

Presto...格式化程序不会碰它。在 Fedora 17 上的 Juno 上进行了测试。希望有所帮助。