Visual studio 如何从VisualStudio2015生成的XML创建可读的C++/CX文档

Visual studio 如何从VisualStudio2015生成的XML创建可读的C++/CX文档,visual-studio,visual-c++,documentation,Visual Studio,Visual C++,Documentation,我的项目是在VS2015上用C++/CX编写的,我正在寻找一种生成API文档的方法 在Google和stackoverflow之后,我尝试了doxygen、VSDocman、NDoc、Atomineer Pro Documentation和SandCastle,我发现这些工具不支持C++/CX语法,因此无法生成正确的文档 我还尝试生成VS支持的XML文件。但是很难读取XML文件 如何从C++/CX生成API文档?谢谢你的建议关于C++/CX语言扩展有很多误解。你尝试了太多的产品,但都没有希望成功

我的项目是在VS2015上用C++/CX编写的,我正在寻找一种生成API文档的方法

在Google和stackoverflow之后,我尝试了doxygen、VSDocman、NDoc、Atomineer Pro Documentation和SandCastle,我发现这些工具不支持C++/CX语法,因此无法生成正确的文档

我还尝试生成VS支持的XML文件。但是很难读取XML文件

如何从C++/CX生成API文档?谢谢你的建议

关于C++/CX语言扩展有很多误解。你尝试了太多的产品,但都没有希望成功。首先,它是一个本地C++扩展,并没有生成.NET兼容的程序集。因此,排除任何试图使用反射来解析元数据的方法。NDoc,VSDocman,Sandcastle。Atomineer已退出,它只是一个编辑器外接程序

所以你只剩下强力剂了

当然,它对C++/CX一无所知。常见问题解答指出,为了使其与语言兼容,您需要修改

看看它,我发现它已经支持C++/CLI扩展。这是支持生成MSIL的另一种C++语言扩展。C++/CX语法非常接近C++/CLI。只是一些细微的差别,比如gcnew关键字太过误导,被ref new取代。但这不是doxygen关心的语法类型,它只是想了解声明。这些关键词是相同的

所以我能猜到的唯一障碍就是你忘了告诉它关于语言的事。它不能正确地从文件名扩展中猜出,CPP和.h将解析纯C++。在配置文件中修改或添加此行:

   CPP_CLI_SUPPORT        = YES

必要时调整scanner.l。

非常感谢。然而,我仍然不明白为什么VisualStudio提供XML文档生成?如果不能使用,它看起来是多余的。它是用来生成IntelliSense信息的,当你编辑源代码时会弹出这种信息。它从未打算制作文档。它对DOC生成可能是有用的,必须解析C++是这里的障碍。