Eclipse javadoc注释中的错误换行

Question

4

我认为Eclipse内置的Java格式化程序中有一个微小但令人烦恼的bug。我有一个看起来像这样的Javadoc注释：

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

具体来说，是在第81列添加一个句号。格式化程序已设置为在第80行换行Javadoc注释。不幸的是，当我对代码进行格式化时，它会出现如下问题：

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

这会在生成的输出中在文本和句号之间添加空格，因此呈现HTML的浏览器（例如Javadoc）也认为在那里断开是可以的。

除非句号跟随Javadoc标签，否则似乎不会发生这种情况。（例如，如果该行以右括号和句点结束，则会在最后一个单词之前正确换行。）

我可以移动换行列，但这只会移动问题位置。我不想关闭换行，因为我希望我的Javadoc源代码与生成的输出一样可读。是否有某些设置我错过了或者这实际上是一个错误？

- Ted Hopp

2个回答

0

现在，这是一个新的Eclipse bug。显然，在最初的Indigo版本中仍将存在。

- Ted Hopp

3

朱诺、开普勒、月球……:-( - Trevor Robinson

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

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

- stieg · Accepted Answer

好的，这个问题有一个不太有趣的解决方法。为了解决这个问题，请尝试在Eclipse格式化程序中启用Off/On标记。具体操作如下：

窗口 -> 首选项 -> Java -> 格式化程序 -> 编辑 -> Off/On标记 -> 启用Off/On标记

然后，您需要使用这些标记将您的注释括起来，以便格式化程序不会对其进行更改（请注意，这些标记需要在单独的注释块中，否则Eclipse将忽略它们）。例如：

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

Presto…格式化程序不会处理它。在Fedora 17上测试过Juno。希望这能帮到你。