我认为 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 上进行了测试。希望有帮助。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)