c++ - 如何编写出现在 Intellisense 中的 C++ 注释？

Question

我正在使用 Visual Studio 2010 Ultimate 进行 C++ 编程。我想记录一些函数，并且希望文档显示在 Intellisense 中。

根据MSDN ，我只需要将注释放在声明之前或之后的同一行。所以我尝试了这个:

// This is a test.
void foo();
void bar() { foo(); }

将鼠标移到 foo() 上时，评论不会出现在工具提示中。我也试过了:

• ///
• <summary></summary> 标签
• 使用 /doc 构建(通过在项目设置中设置“生成 XML 文档文件”选项)

到目前为止，我还没有运气。有谁知道如何实现这项工作？

Answer 1

现在 VS 2012 支持此功能!

以前，注释中的 XML 标记只能由 C++/CLI 读取，而不是普通的旧 C++。VS 2012 现在至少将其中的一部分引入常规 C++ - 它位于 What's New in Visual Studio 2012 中。在 MSDN 文档中:XML Documentation (Visual C++) .

我在2012 Ultimate中用自己的应用测试过，可以确认summary、para、seealso标签都被拉出一个格式化的tooltips。