telepathy-glib features the following property definition:

  /**
   * TpConnection:status:
   *
   * This connection's status, or TP_UNKNOWN_CONNECTION_STATUS if we don't
   * know yet.
   */
  param_spec = g_param_spec_uint ("status", "Status",
      "The status of this connection", 0, G_MAXUINT32,
      TP_UNKNOWN_CONNECTION_STATUS,
      G_PARAM_READABLE
      | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK);
  g_object_class_install_property (object_class, PROP_STATUS,
      param_spec);

where:

  #define TP_UNKNOWN_CONNECTION_STATUS ((TpConnectionStatus) -1)
  typedef enum {
      TP_CONNECTION_STATUS_CONNECTED = 0,
      TP_CONNECTION_STATUS_CONNECTING = 1,
      TP_CONNECTION_STATUS_DISCONNECTED = 2,
  } TpConnectionStatus;

In the generated documentation, this becomes:

  The "status" property

    "status"                   guint                 : Read

  This connection's status, or TP_UNKNOWN_CONNECTION_STATUS if we don't know yet.

  Default value: 4294967295

which is kind of unfortunate.  :-)

How hard would it be not to expand #defines in this case?