Details

[Home]

Issue of the Standard # D0085

Brief

Improvement to the documentation of the "g_object_connect" interface

Detailed Description

Description of the interface "g_object_connect" contains the following text:

  • signal - equivalent to g_signal_connect_data (...)
  • object_signal, object-signal - equivalent to g_signal_connect_object (...)
  • swapped_signal, swapped-signal - equivalent to g_signal_connect_data (..., G_CONNECT_SWAPPED)
  • swapped_object_signal, swapped-object-signal - equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED)
  • signal_after, signal-after - equivalent to g_signal_connect_data (..., G_CONNECT_AFTER)
  • object_signal_after, object-signal-after - equivalent to g_signal_connect_object (..., G_CONNECT_AFTER)
  • swapped_signal_after, swapped-signal-after - equivalent to g_signal_connect_data (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)
  • swapped_object_signal_after, swapped-object-signal-after - equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)

Problem location(s) in the standard

Linux Standard Base Desktop Specification 3.1, Chapter 12. Libraries, 12.5.1 glib-2.0/glib-object.h; http://www.gtk.org/api/2.6/gobject/gobject-The-Base-Object-Type.html#g-object-connect

Possible solutions

It is proposed to improve the documentation by specifying the missing parameter values:

  • signal equivalent to g_signal_connect_data (..., NULL, 0)
  • object_signal, object-signal, equivalent to g_signal_connect_object (..., 0)
  • swapped_signal, swapped-signal, equivalent to g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)
  • swapped_object_signal, swapped-object-signal, equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED)
  • signal_after, signal-after, equivalent to g_signal_connect_data (..., NULL, G_CONNECT_AFTER)
  • object_signal_after, object-signal-after, equivalent to g_signal_connect_object (..., G_CONNECT_AFTER)
  • swapped_signal_after, swapped-signal-after, equivalent to g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED | G_CONNECT_AFTER)
  • swapped_object_signal_after, swapped-object-signal-after, equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)

Accepted

Gnome Bugzilla 528719

Status

Accepted in glib 2.18

[Home]

»