Eclipse javadoc注释中的坏行

2024年1月21日 250次阅读

我认为,在
Eclipse内置的Java格式化程序中,存在一个小但烦人的错误.我有一个看起来像这样的Javadoc注释：

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

结尾的句点在第81列.格式化程序设置为在第80行包装Javadoc注释.不幸的是,当我格式化代码时,它执行以下操作：

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

这会在文本和生成的输出中的句点之间放置空格,因此,例如,用HTML呈现Javadoc的浏览器也会认为可以在那里打破.

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

我可以移动换行列,但这只会移动问题.我不想转
离线中断,因为我喜欢我的Javadoc源与生成的输出一样可读.是否有一些设置我缺少或这实际上是一个错误？

最佳答案 那么有一个不太有趣的工作.要解决此问题,请尝试在Eclipse格式化程序中启用Off / On标记.

窗口 – >偏好 – > Java – >格式化程序 – >编辑 – >关/开标签 – >启用关/开标签

然后你需要用这些标签包围你的评论,这样格式化程序就不会碰它(注意标签需要在单独的注释块中,否则Eclipse会忽略它们).例如：

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

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

点赞