问没有HTML的Javadocs

EN

我同意。(这也是我强烈反对C#风格的"XML注释块“的原因；Javadoc DSL至少为顶级实体提供了一些逃避！)为此，我根本不想让javadoc看起来很漂亮.

...anyway，你可能对氧气感兴趣。这是一个非常快速的帖子DO2与Javadoc。它还提出了您所做的问题:-)

HTML不是我想在“普通”注释中看到的东西。但是对于像JavaDoc这样的工具，HTML增加了添加格式化信息、项目点等的可能性.

我要区分这两件事：

• 非javadoc代码注释是为维护或增强我所质疑的代码的程序员准备的。他必须挖掘现有的源代码，而coments中的任何HTML都不能使事情变得更容易。所以，禁止在正常的评论。
• javadoc-注释用于生成文档。在有帮助的地方使用HTML。但是一个非常有限的HTML子集就足够了。