！”开头Qt Creator 中的蓝色？

【问题标题】：Why are comments that start with "//!" colored blue in Qt Creator?为什么注释以“//！”开头Qt Creator 中的蓝色？
【发布时间】：2014-03-29 10:43:36
【问题描述】：

Qt Creator 通常将 cmets 着色为绿色，但我在 Qt 示例中看到了蓝色 cmets，并且 Qt Creator 似乎将每个以 //! 开头的评论都着色为蓝色。

这是一个示例截图：

这是某种约定吗？蓝色代表什么？

【问题讨论】：

【解决方案1】：

这是Doxygen comment。

有多种样式：

Qt 块注释：

/*!
... text ...
*/

Qt 单行注释：

//! ... one line of text ...

JavaDoc 块注释：

/**
  * ... text ...
*/

JavaDoc 单行注释：

/// ... one line of text ...

【讨论】：

【解决方案2】：

以//! 开头的注释是用于代码文档的 Qt 样式，与常规 cmets 不同。有关其结构的详细信息，请参阅the doxygen manual，但基本上，这些类型的 cmets 旨在自动提取到有关代码的文档中。

【讨论】：