为什么C ++标头中的XML DOC注释不会生成输出？

Question

我有一个创建DLL的C ++项目，我们称之为my.dll。与它一起，我提供了一个名为my.h的头文件，其中包含从my.dll导出的函数的声明。 my.dll＃的源代码包含my.h头文件。我已经在my.h中的函数声明中添加了XML DOC注释，并在cl.exe命令行上设置了/ doc开关。在编译时，每个* .cpp文件只有一个* .xdc文件，但它们都不包含my.h中的XML DOC注释。

cl.exe上的/ doc开关似乎只处理来自c / c ++文件的XML DOC注释。这是真的？如果没有，如何让它在头文件中处理XML DOC注释？

Answer 1

对于代码内文档，我强烈建议使用doxygen（使用javadoc格式）而不是专有的xmldoc格式。