2011-05-30 95 views
4

我认为在Eclipse内置的Java格式化程序中存在一个小问题但令人讨厌的错误。我有一个Javadoc注释,如下所示:Eclipse中的坏行破解javadoc评论

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

其中期结束时是81列的格式设置为包裹在线路80遗憾的是javadoc注释,当我格式化代码,它这样做:

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

这使文本和生成的输出期间,之间的空白使浏览器渲染HTML的Javadoc,例如,将也觉得没关系打破那里。

这似乎并没有发生,除非该周期遵循Javadoc标签。 (例如,如果行在第81列结尾处有一个右括号和一个句点,则它会在最后一个单词之前正确打破。)

我可以移动换行列,但那只会移动问题。我不想将 关闭,因为我喜欢我的Javadoc源代码与生成的输出一样可读。有一些设置我错过了,或者这实际上是一个错误?

回答

0

那么,现在是新的Eclipse bug。它显然仍然会出现在最初的Indigo版本中。

+2

和朱诺。和开普勒。和卢娜...... :-( – 2014-04-30 17:19:55

2

好吧,这是一个不太有趣的工作。要解决该问题,请尝试在Eclipse格式化程序中启用Off/On Tags。

窗口 - >首选项 - >爪哇 - >格式化 - >编辑 - >关闭/打开标签 - >启用关闭/打开标签

然后,你需要围绕这些标记您的评论等等格式化不碰它(注意,标签需要位于单独的注释块中,否则Eclipse将忽略它们)。例如:

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

Presto ...格式化程序不会触及它。在Fedora 17上测试Juno。希望有帮助。