我认为,在Eclipse内置的Java格式化程序中,存在一个轻微但烦人的错误。我有一个看起来像这样的Javadoc评论:
/**
* - - - stuff - - - {@code mTasksBelow}.
*/
结尾的句点在第81列。格式化程序设置为在第80行包装Javadoc注释。不幸的是,当我格式化代码时,它会这样做:
/**
* - - - stuff - - - {@code mTasksBelow}
* .
*/
这会在文本和生成的输出中的句点之间放置空格,因此,例如,用HTML呈现Javadoc的浏览器也会认为可以在那里打破。
除非句点遵循Javadoc标记,否则似乎不会发生这种情况。 (例如,如果该行以右括号和第81列中的句点结束,则它将在最后一个单词之前正确地中断。)
我可以移动换行列,但这只会移动问题。我不想转 离线中断,因为我喜欢我的Javadoc源与生成的输出一样可读。是否有一些我缺少的设置或者这实际上是一个错误?
答案 0 :(得分:2)
对于这一点,有一个不太有趣的工作。要解决此问题,请尝试在Eclipse格式化程序中启用Off / On标记。
窗口 - >偏好 - > Java - >格式化程序 - >编辑 - >关/开标签 - >启用关/开标签
然后你需要用这些标签包围你的评论,这样格式化程序就不会碰它(注意标签需要在单独的注释块中,否则Eclipse会忽略它们)。例如:
//@formatter:off
/**
* Oddly formatted comment. MUHAHAHAHAH :)
**/
//@formatter:on
Presto ...格式化程序不会触及它。在Fedora上测试Juno 17.希望有所帮助。
答案 1 :(得分:0)
好吧,它现在是一个新的Eclipse bug。它显然仍然存在于最初的Indigo版本中。