禁止Doxygen解析代码片段（解析Qt Q_PROPERT 疑似BUG）

要点

使用宏定义让 Doxygen 跳过代码段。

一、问题描述

Doxygen 认为 property 和 function 是相似项目，在文档中 \property 命令的解释为

Indicates that a comment block contains documentation for a property (either global or as a member of a class). This command is equivalent to \fn, \typedef, and \var.

在 Qt 中，property 是以字符串来索引的，因此可以使用与 property 相同名字的 function 作为其 READ 方法，这也是比较常见的命名方式。但是在 Doxygen 中（版本1.8.2），二者会导致命名“冲突”。样例如下：

main.h 文件

#include "qpushbutton.h"

class CMyButton : public QPushButton
{
    Q_OBJECT
    Q_PROPERTY(int type READ type WRITE setType)

public:
    int