公共 c++ 头文件必须提供大量注释。doxygen 注释很难格式化和包装。是否存在一些格式化工具?
具有第 80 个字符自动换行等功能,易于视觉功能分组。理想情况下,文档编写者单独准备文档,然后将其注入或使用带有代码的 doxytags 链接。
此时我们正在使用记事本/IDE 来记录代码。
公共 c++ 头文件必须提供大量注释。doxygen 注释很难格式化和包装。是否存在一些格式化工具?
具有第 80 个字符自动换行等功能,易于视觉功能分组。理想情况下,文档编写者单独准备文档,然后将其注入或使用带有代码的 doxytags 链接。
此时我们正在使用记事本/IDE 来记录代码。
你没有说你正在使用哪个 IDE - 如果你在 Visual Studio 中工作,那么我已经编写了一个可以帮助你的插件(AtomineerUtils) - 它生成/更新你的 XML、Doxygen 或 JavaDoc 文档注释源文件,并且可以为您自动换行和格式化评论,最大限度地减少您需要做的工作以保持它们整洁。它还使注释与代码(参数、类型参数、抛出的异常等)保持同步。
(它在 Visual Studio 2010、2008、2005 中支持 C、C++、C++/CLI、C#、Visual Basic 和 Java)。
Emacs + doxymacs对我来说很好用。