设置为在 Doxygen 中包含 //?
Setting to include // in Doxygen?
我有一个大型代码库,我想用 Doxygen 制作第一遍文档,但它没有所需的 /// 注释格式——它们都是 //。是否有包含所有评论的设置?我过去使用过 Doxygen 并且理解为什么您需要这两种格式,所以请不要了解它们的区别 :)。之前在这里问过这个问题 - // comments in doxygen - 但没有回答。
您可以做几件事:
首先,让 Doxygen 使用 EXTRACT_ALL = TRUE
或 HIDE_UNDOC_CLASSES = FALSE
和 HIDE_UNDOC_MEMBERS = FALSE
.
从代码结构自动生成文档
然后,Doxygen 支持预处理器。也许您可以编写一个过滤器,而不是自动将 /*
更改为 /**
并将 //
更改为 ///
?根据您的代码,哑过滤器可能会或可能不会破坏某些东西(例如,这些组合是否出现在字符串文字中?)
最后,Doxygen 代码并不难破解。您应该能够毫不费力地将 //
和 /*
识别为文档。
我有一个大型代码库,我想用 Doxygen 制作第一遍文档,但它没有所需的 /// 注释格式——它们都是 //。是否有包含所有评论的设置?我过去使用过 Doxygen 并且理解为什么您需要这两种格式,所以请不要了解它们的区别 :)。之前在这里问过这个问题 - // comments in doxygen - 但没有回答。
您可以做几件事:
首先,让 Doxygen 使用 EXTRACT_ALL = TRUE
或 HIDE_UNDOC_CLASSES = FALSE
和 HIDE_UNDOC_MEMBERS = FALSE
.
然后,Doxygen 支持预处理器。也许您可以编写一个过滤器,而不是自动将 /*
更改为 /**
并将 //
更改为 ///
?根据您的代码,哑过滤器可能会或可能不会破坏某些东西(例如,这些组合是否出现在字符串文字中?)
最后,Doxygen 代码并不难破解。您应该能够毫不费力地将 //
和 /*
识别为文档。