如何处理每个文件中的许可证头

Question

我正在研究一个相当大的现有C代码。每个源文件都有一个多段版权和许可标题，我必须保留在顶部。当我在doxygen中生成文档时，这会使文档变得混乱。

到目前为止，我已尝试创建自定义别名，建议在此处搜索。但是，我还没有找到一种处理多个段落的方法，使用自定义命令。我真正喜欢的是一个隐藏的＆＃34;可扩展的＆＃34;页面底部的文件或类似内容。

处理此问题的最佳方法是什么？

Answer 1

版权和许可评论是否必须是“文档评论？”通常它们不是。获得文档注释的唯一原因（即，它们以///或/**开头）是因为您希望它们显示在文档中的某个位置。

如果他们需要提供文档评论，请查看https://jsfiddle.net/kurz/o2116mz2/1/和ENABLED_SECTIONS命令。