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 754855 - Object instantiation documentation refers to example that no longer exists
Object instantiation documentation refers to example that no longer exists
Status: RESOLVED FIXED
Product: glib
Classification: Platform
Component: docs
2.45.x
Other Linux
: Normal minor
: ---
Assigned To: gtkdev
gtkdev
Depends on:
Blocks:
 
 
Reported: 2015-09-10 23:24 UTC by Michael Catanzaro
Modified: 2015-10-01 14:27 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
docs: Tidy up GObject construction discussion in the GObject tutorial (3.96 KB, patch)
2015-09-30 23:40 UTC, Philip Withnall
committed Details | Review

Description Michael Catanzaro 2015-09-10 23:24:25 UTC
From [1]:

"Once g_object_new has obtained a reference to an initialized class structure, it invokes its constructor method to create an instance of the new object. Since it has just been overridden by maman_bar_class_init to maman_bar_constructor..."

This is referring to an example that used to exist in the tutorial. The example nowadays shows how to use construted instead of constructor, though, so it doesn't make sense anymore. Something along the lines of:

"Once g_object_new has obtained a reference to an initialized class structure, it invokes its constructor method to create an instance of the new object, if it has been overridden by maman_bar_class_init"

would make more sense.

It would probably also be good to add constructed to the table immediately below....

https://developer.gnome.org/gobject/unstable/chapter-gobject.html
Comment 1 Philip Withnall 2015-09-30 23:40:47 UTC
Created attachment 312453 [details] [review]
docs: Tidy up GObject construction discussion in the GObject tutorial

Remove some outdated references to an old example, and add a row in the
table of steps in object initialization for the GObjectClass.constructed
virtual method.
Comment 2 Colin Walters 2015-10-01 13:29:21 UTC
Review of attachment 312453 [details] [review]:

I only glanced at this but it seems reasonable.
Comment 3 Philip Withnall 2015-10-01 14:27:33 UTC
Attachment 312453 [details] pushed as 4a5a30f - docs: Tidy up GObject construction discussion in the GObject tutorial