Eclipse javadoc注释中的换行错误

如何解决Eclipse javadoc注释中的换行错误

| 我认为，Eclipse内置Java格式化程序中有一个小而烦人的错误。我有一个Javadoc注释，看起来像这样：

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

其中结尾的句点在第81列中。格式化程序设置为在第80行包装Javadoc注释。不幸的是，当我格式化代码时，它会这样做：

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

这样在生成的输出中在文本和句点之间放置了空格，因此，例如，以HTML呈现Javadoc的浏览器也认为可以在此处中断。除非句点后面跟随Javadoc标记，否则似乎不会发生这种情况。（例如，如果该行在第81列中以右括号和句点结尾，那么它将在最后一个单词之前正确地断开。）我可以移动换行列，但这只会解决问题。我不想转身离线中断，因为我希望Javadoc源代码与生成的输出一样可读。我是否缺少某些设置，或者这实际上是一个错误？

解决方法

好吧，这方面的工作不那么有趣。要解决此问题，请尝试在Eclipse格式化程序中启用“关闭/打开”标签。窗口->首选项-> Java->格式化程序->编辑->关闭/打开标签->启用关闭/打开标签然后，您需要在这些注释周围加上标签，以便格式化程序不会触摸它（请注意，标签必须位于单独的注释块中，否则Eclipse将忽略它们）。例如：

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

Presto ...格式化程序不会碰它。在Fedora 17上的Juno上进行了测试。希望能有所帮助。 , 好吧，现在它是一个新的Eclipse错误。显然它仍将存在于最初的Indigo版本中。