爲什麼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格式。