After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 731997 - Contradictory documentation of interface initialization
Contradictory documentation of interface initialization
Status: RESOLVED OBSOLETE
Product: glib
Classification: Platform
Component: docs
2.40.x
Other Linux
: Normal normal
: ---
Assigned To: gtkdev
gtkdev
Depends on:
Blocks:
 
 
Reported: 2014-06-21 01:48 UTC by Michael Catanzaro
Modified: 2018-05-24 16:41 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Michael Catanzaro 2014-06-21 01:48:12 UTC
Table 2. Interface Initialization in the GObject documentation [1] seems to contradict itself.  The rightmost column of the table claims that the interface's base_init function is called once per instantiated class type implementing the interface and that the default_init function is called once period, in agreement with the surrounding documentation. However, the leftmost column claims that base_init is called during the first call to g_type_create_instance for *any* type implementing the interface, while default init is called during the first call to g_type_create_instance for *each* type implementing the interface, contradicting the rightmost column and the surrounding documentation. I guess the leftmost column of the table ought to say base_init is called for *each* type (rather than *any* type) and default_init for *any* type (rather than *each* type)?

Similarly, the leftmost column claims that interface_init is called during the first call to g_type_create_instance for *any* implementing type, whereas the rightmost column and surrounding documention are quite clear that it is called once for *each* implementing type.

To summarize, the leftmost column currently reads, from top to bottom, Any Each Any, but I think it should actually be Each Any Each.

[1] https://developer.gnome.org/gobject/stable/gtype-non-instantiable-classed.html
Comment 1 GNOME Infrastructure Team 2018-05-24 16:41:07 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/glib/issues/893.