为什么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格式。