doxygen - 编写 doxygen 代码注释的最佳工具或技术是什么

Question

公共(public)c++头文件必须提供大量注释。格式化和包装 doxygen 注释很困难。有没有一些格式化工具？

具有第 80 个字符自动换行等功能，易于视觉功能分组。理想情况下，文档编写者单独准备文档，然后将其注入(inject)或使用 doxytags 与代码链接。

此时我们正在使用记事本/IDE 来记录代码。

Answer 1

你没有说你正在使用哪个 IDE - 如果你在 Visual Studio 中工作，那么我编写了一个插件 ( AtomineerUtils ) 可能会帮助你 - 它生成/更新 XML、Doxygen 或JavaDoc 文档在源文件中添加注释，并且可以为您自动换行和格式化注释，从而最大程度地减少保持注释整洁所需的工作量。它还使注释与代码保持同步(参数、类型参数、抛出的异常等)。

(在 Visual Studio 2010、2008、2005 中支持 C、C++、C++/CLI、C#、Visual Basic 和 Java)。