设置为在 Doxygen 中包含 //?

Setting to include // in Doxygen?

我有一个大型代码库,我想用 Doxygen 制作第一遍文档,但它没有所需的 /// 注释格式——它们都是 //。是否有包含所有评论的设置?我过去使用过 Doxygen 并且理解为什么您需要这两种格式,所以请不要了解它们的区别 :)。之前在这里问过这个问题 - // comments in doxygen - 但没有回答。

您可以做几件事:

首先,让 Doxygen 使用 EXTRACT_ALL = TRUEHIDE_UNDOC_CLASSES = FALSEHIDE_UNDOC_MEMBERS = FALSE.

从代码结构自动生成文档

然后,Doxygen 支持预处理器。也许您可以编写一个过滤器,而不是自动将 /* 更改为 /** 并将 // 更改为 ///?根据您的代码,哑过滤器可能会或可能不会破坏某些东西(例如,这些组合是否出现在字符串文字中?)

最后,Doxygen 代码并不难破解。您应该能够毫不费力地将 ///* 识别为文档。