c - GTK-doc 不呈现结构的文档注释

Question

我在 .h 文件中有以下代码:

/**
 * udp_result_s:
 * @available: indicates the availability of the property stored in @data
 * @data: the property value (will only be meaningful if @available indicates its presence)
 * 
 * A transparent struct, representing the result of a query on a UDP object. Note that the @data field will contain unspecified junk *unless* @available is `udp_PRESENT`.
 */
typedef struct udp_result_s
{
  /*< public > */
  udp_availability available;
  void *data;
} udp_result_s;

出于某种原因我完全无法理解，这并没有出现在 GTK-doc 生成的文档中。应该从此文件生成的所有其他内容是 - 我是否遗漏了一些非常明显的东西？

Answer 1

尝试:

typedef struct
{
  /*< public > */
  udp_availability available;
  void *data;
} udp_result_s;