如何在doxygen中记录发出的Qt信号?

如何在doxygen中记录发出的Qt信号?,qt,doxygen,signals-slots,code-documentation,Qt,Doxygen,Signals Slots,Code Documentation,我知道信号只是一个函数,所以问题不在于记录信号本身。想象一下下面的函数体bar(): 显然,这只是一个例子。我在找像这样的东西 /** * @brief Does something and emits the following signals * @param x A value of some sort * @emit fooLess If x < 0 * @emit fooGreater If x > 0 * @emit fooZero If x = 0

我知道信号只是一个函数,所以问题不在于记录信号本身。想象一下下面的函数体
bar()

显然,这只是一个例子。我在找像这样的东西

/**
  * @brief Does something and emits the following signals
  * @param x A value of some sort
  * @emit fooLess If x < 0
  * @emit fooGreater If x > 0
  * @emit fooZero If x = 0
  */
/**
*@brief做了一些事情并发出以下信号
*@param x某种类型的值
*如果x<0,则@emit傻瓜
*@如果x>0,则会更大
*如果x=0,则@0
*/

但是很明显,这在doxygen中没有作为标记出现,因为它太过语言特定。

我总是查看官方Qt类是如何记录的。但我不知道它们是否会根据状态发出不同的信号,而是使用一个带有状态枚举的信号作为参数。也许可以尝试将您自己的命令“emit”定义为别名(在本例中我没有尝试过)。@xander我查看了Qt API,但没有找到任何结果。在我的例子中,我也使用标志作为我的函数的输入参数,我确实提到了当选择这个和那个标志(或它们的组合)时会发生什么,但为了可读性,我希望为每个函数提供一个单独的列表,其中包含它发出的所有信号(对于类也一样)。实际上,Qt类文档做了一些非常类似的事情(在给定类页面的单独部分中对信号、插槽等进行分组),但我不知道doxygen是否可以做到这一点,如果可以,如何做到。@albert Thank,将对此进行研究。甚至不知道可以在doxygen中定义自定义命令:D
/**
  * @brief Does something and emits the following signals
  * @param x Depending on its value following signals can be emitted:
  *           * fooLess - if x is less than 0
  *           * fooGreater - if x is greater than 0
  *           * fooZero - if x is equal to 0
  */
void bar(int x);
/**
  * @brief Does something and emits the following signals
  * @param x A value of some sort
  * @emit fooLess If x < 0
  * @emit fooGreater If x > 0
  * @emit fooZero If x = 0
  */