Bug 17243

Summary:	TP_UNKNOWN_CONNECTION_STATUS is expanded in documentation
Product:	Telepathy	Reporter:	Will Thompson <will>
Component:	tp-glib	Assignee:	Telepathy bugs list <telepathy-bugs>
Status:	RESOLVED WONTFIX	QA Contact:	Telepathy bugs list <telepathy-bugs>
Severity:	minor
Priority:	low
Version:	unspecified
Hardware:	Other
OS:	All
URL:	http://bugzilla.gnome.org/show_bug.cgi?id=556120
Whiteboard:
i915 platform:		i915 features:

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.