不带HTML的Javadocs

我同意(这也是我强烈反对C风格的“XML注释块”的原因;javadocdsl至少提供 顶级实体的转义!)。为此,我只是 不要

……不管怎样,你可能对强生感兴趣。这是一个很快的帖子 Doxygen versus Javadoc . 它还提出了您需要解决的问题:-)

我不想在“普通”评论中看到HTML。但是对于像JavaDoc这样的工具,HTML增加了添加格式信息、要点等的可能性。。。

我要区分这两件事:

• javadoc注释用于生成文档。在有帮助的地方使用HTML。但是一个非常有限的HTML子集就足够了。