Why does the Eclipse code formatter break in a Javadoc @see tag?我正在使用Eclipse 3.4,并且已配置Java代码格式化程序,并且在"注释"选项卡上启用了所有选项。 问题是当我格式化包含以下内容的文档注释时:
代码格式化程序在结束的HTML中插入一个空格,将其断开:
为什么? 如何阻止这种情况发生? 通过禁用"注释"选项卡上的任何选项(例如"格式化HTML"标记)无法解决此问题。 我发现的唯一解决方法是通过同时禁用"启用Javadoc注释格式"和"启用块注释格式"选项来完全禁用Javadoc格式,这意味着我必须手动设置注释块的格式。 我只能假定这是Eclipse中的错误。 它仅在@see标记中发生,对于所有3种内置代码格式化程序设置也都发生。 在社区中已经有一些有趣的错误报告,但是我找不到这个特定的错误。 例如,请参阅在Eclipse Bugzilla中对@see的搜索。 这可能是Eclipse 3.4中的错误。 我正在使用3.3(M20080221-1800),并且没有观察到此行为。 严格的XML规范要求自闭标签在闭斜杠之前应有一个空格,如下所示:
我只能像巴特所说的那样假设,Eclipse的重新格式化程序中有一个错误,它认为关闭标签实际上是一个自关闭标签。 另一个想法:您可以验证标签是否平衡(例如,文档中没有更高的未闭合标签)吗? |