没有扩展的文档宏

Question

在我使用 doxygen 1.9.1 记录的 C 项目中，我有几个记录的宏，例如

/**
 * @brief Does a thing.
 */
#define DO_THING() someFunc(1, 2, 3)

当我生成文档时，列出了DO_THING但它显示了扩展（即someFunc(1, 2, 3) ）。 有没有办法让doxygen隐藏扩展？ 我希望我的宏对我的用户是不透明的。 也就是说，我希望他们只知道，“有一个名为DO_THING()的宏，它做了一件事。”

Answer 1

Doxygen 可以通过设置来设置最大初始化行数： MAX_INITIALIZER_LINES

MAX_INITIALIZER_LINES

MAX_INITIALIZER_LINES 标签决定了变量或宏/定义的初始值在文档中出现的最大行数。 如果初始化程序包含的行数多于此处指定的行数，它将被隐藏。 使用值 0 完全隐藏初始值设定项。 无论此设置如何，都可以使用文档中的 \showinitializer 或 \hideinitializer 命令控制单个变量和宏/定义值的外观。

并有命令\hideinitializer

\隐藏初始化程序

默认情况下会显示定义的值和变量的初始值设定项，除非它们超过 30 行。 通过将此命令放在定义或变量的注释块中，初始值设定项始终被隐藏。 可以通过配置参数 MAX_INITIALIZER_LINES 更改初始化行的最大数量，默认值为 30。

所以你可以通过任一设置来解决你的问题

• MAX_INITIALIZER_LINES到 `0 虽然这对所有初始化值都有效
• 对于相关部分\hideinitializer