c++ - 为缺少 XML 文档启用 C++ 编译器警告

Question

当为我的 C++ 项目(托管)启用 XML 文档时，编译器不会针对缺少注释发出任何警告。

我已通过将“生成 XML 文档文件”(/doc) 设置为 true 来启用文档生成，如所述here .该项目被配置为具有/clr 和警告级别 4 (/W4) 的动态库。

对于 C# 项目，编译器会引发 Missing XML comment for publicly visible type or member 'Type_or_Member'缺少评论时发出警告。为了迫使开发人员做出适当的评论，我希望 C++ 项目具有相同的行为。我如何获得它？

Answer 1

VC++ XML 注释的处理方式与 .NET 不同。 VC++ 编译器处理注释并生成 .xdc 文件，这些文件稍后由名为 xdcmake.exe 的工具组装成 xml 文件。但是，没有选项告诉编译器在缺少 .NET 已知的 XML 注释时发出警告。

(参见 http://msdn.microsoft.com/en-us/library/ms177227.aspx 和 http://msdn.microsoft.com/en-us/library/ms177247.aspx)