如何处理每个文件中的许可证 header
how to handle license header in every file
我正在编写相当大的现有 C 代码的文档。每个源文件的顶部都有 multi-paragraph 版权和许可 header,我必须保留这些文件。当我在 doxygen 中生成文档时,这会使文档变得混乱。
到目前为止,我已尝试创建一个自定义别名,建议从此处搜索。不过,我还没有找到一种方法来使用自定义命令来处理多个段落。我真正想要的是在文件或类似内容的页面底部的隐藏 "expandable" 部分。
处理此问题的最佳方法是什么?
版权和许可注释是否有必要 "documentation comments?" 通常不需要。有文档注释的唯一原因(即它们以 ///
或 /**
开头)是因为您希望它们出现在文档中的某个地方。
如果有什么原因需要文档注释,再看ENABLED_SECTIONS and the cond命令。
我正在编写相当大的现有 C 代码的文档。每个源文件的顶部都有 multi-paragraph 版权和许可 header,我必须保留这些文件。当我在 doxygen 中生成文档时,这会使文档变得混乱。
到目前为止,我已尝试创建一个自定义别名,建议从此处搜索。不过,我还没有找到一种方法来使用自定义命令来处理多个段落。我真正想要的是在文件或类似内容的页面底部的隐藏 "expandable" 部分。
处理此问题的最佳方法是什么?
版权和许可注释是否有必要 "documentation comments?" 通常不需要。有文档注释的唯一原因(即它们以 ///
或 /**
开头)是因为您希望它们出现在文档中的某个地方。
如果有什么原因需要文档注释,再看ENABLED_SECTIONS and the cond命令。