Bug 17243 - TP_UNKNOWN_CONNECTION_STATUS is expanded in documentation
Summary: TP_UNKNOWN_CONNECTION_STATUS is expanded in documentation
Status: RESOLVED WONTFIX
Alias: None
Product: Telepathy
Classification: Unclassified
Component: tp-glib (show other bugs)
Version: unspecified
Hardware: Other All
: low minor
Assignee: Telepathy bugs list
QA Contact: Telepathy bugs list
URL: http://bugzilla.gnome.org/show_bug.cg...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-08-21 07:28 UTC by Will Thompson
Modified: 2008-10-14 04:00 UTC (History)
0 users

See Also:
i915 platform:
i915 features:

Attachments

Description Will Thompson 2008-08-21 07:28:18 UTC 
Looking at the documentation for TpConnection::status:

> This connection's status, or TP_UNKNOWN_CONNECTION_STATUS if we don't know yet.
> 
> Default value: 4294967295

Is there any way to stop gtkdoc expanding TP_UNKNOWN_CONNECTION_STATUS, which is #defined to -1?
Comment 1 Will Thompson 2008-10-13 04:30:06 UTC 
We could work around gtk-doc expanding the #define by replacing:

  #define TP_UNKNOWN_CONNECTION_STATUS ((TpConnectionStatus) -1)

with something like:

  enum { _TP_UNKNOWN_CONNECTION_STATUS = -1 };
  #define TP_UNKNOWN_CONNECTION_STATUS ((TpConnectionStatus) _TP_UNKNOWN_CONNECTION_STATUS)

if we were so inclined.
Comment 2 Will Thompson 2008-10-13 04:45:50 UTC 
Forwarded to http://bugzilla.gnome.org/show_bug.cgi?id=556120
Comment 3 Will Thompson 2008-10-14 04:00:56 UTC 
gtk-doc can't work around this, so we can't fix this without using a dummy anonymous enum.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.