X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gobject%2Fgobject.c;h=d7002665a656e467494da0484a42f8085fa69372;hb=a35d8a4c77fbb9a8dd143742c29c0807ec99412b;hp=c80da1623787ecd0cf90ecf03135d444dded43d4;hpb=42cf80780b4fbbe9063ed3d962bb13f341757b3f;p=platform%2Fupstream%2Fglib.git diff --git a/gobject/gobject.c b/gobject/gobject.c index c80da16..d700266 100644 --- a/gobject/gobject.c +++ b/gobject/gobject.c @@ -49,11 +49,11 @@ * * GInitiallyUnowned is derived from GObject. The only difference between * the two is that the initial reference of a GInitiallyUnowned is flagged - * as a floating reference. - * This means that it is not specifically claimed to be "owned" by - * any code portion. The main motivation for providing floating references is - * C convenience. In particular, it allows code to be written as: - * |[ + * as a "floating" reference. This means that it is not specifically + * claimed to be "owned" by any code portion. The main motivation for + * providing floating references is C convenience. In particular, it + * allows code to be written as: + * |[ * container = create_container (); * container_add_child (container, create_child()); * ]| @@ -62,7 +62,7 @@ * references, container_add_child() can only g_object_ref() the new child, * so to implement this code without reference leaks, it would have to be * written as: - * |[ + * |[ * Child *child; * container = create_container (); * child = create_child (); @@ -84,7 +84,7 @@ * across certain code portions (an example is #GtkMenu), to achieve this, * the following sequence can be used: * - * |[ + * |[ * /* save floating state */ * gboolean was_floating = g_object_is_floating (object); * g_object_ref_sink (object); @@ -473,7 +473,7 @@ g_object_do_class_init (GObjectClass *class) * This signal is typically used to obtain change notification for a * single property, by specifying the property name as a detail in the * g_signal_connect() call, like this: - * |[ + * |[ * g_signal_connect (text_view->buffer, "notify::paste-target-list", * G_CALLBACK (gtk_text_view_target_list_notify), * text_view) @@ -589,7 +589,7 @@ g_object_class_install_property (GObjectClass *class, * #GParamSpecs and g_object_notify_by_pspec(). For instance, this * class initialization: * - * |[ + * |[ * enum { * PROP_0, PROP_FOO, PROP_BAR, N_PROPERTIES * }; @@ -622,7 +622,7 @@ g_object_class_install_property (GObjectClass *class, * * allows calling g_object_notify_by_pspec() to notify of property changes: * - * |[ + * |[ * void * my_object_set_foo (MyObject *self, gint foo) * { @@ -809,11 +809,11 @@ g_object_interface_find_property (gpointer g_iface, * @name: the name of a property registered in a parent class or * in an interface of this class. * - * Registers @property_id as referring to a property with the - * name @name in a parent class or in an interface implemented - * by @oclass. This allows this class to override - * a property implementation in a parent class or to provide - * the implementation of a property from an interface. + * Registers @property_id as referring to a property with the name + * @name in a parent class or in an interface implemented by @oclass. + * This allows this class to "override" a property implementation in + * a parent class or to provide the implementation of a property from + * an interface. * * Internally, overriding is implemented by creating a property of type * #GParamSpecOverride; generally operations that query the properties of @@ -1209,7 +1209,7 @@ g_object_notify (GObject *object, * instead, is to store the GParamSpec used with * g_object_class_install_property() inside a static array, e.g.: * - *|[ + *|[ * enum * { * PROP_0, @@ -1234,7 +1234,7 @@ g_object_notify (GObject *object, * * and then notify a change on the "foo" property with: * - * |[ + * |[ * g_object_notify_by_pspec (self, properties[PROP_FOO]); * ]| * @@ -2229,7 +2229,7 @@ g_object_set (gpointer _object, * * Here is an example of using g_object_get() to get the contents * of three properties: an integer, a string and an object: - * |[ + * |[ * gint intval; * gchar *strval; * GObject *objval; @@ -2408,7 +2408,7 @@ g_object_get_property (GObject *object, * - 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) * - * |[ + * |[ * menu->toplevel = g_object_connect (g_object_new (GTK_TYPE_WINDOW, * "type", GTK_WINDOW_POPUP, * "child", menu, @@ -2858,8 +2858,8 @@ toggle_refs_notify (GObject *object, * to the proxy object, but when there are other references held to * @object, a strong reference is held. The @notify callback is called * when the reference from @object to the proxy object should be - * toggled from strong to weak (@is_last_ref - * true) or weak to strong (@is_last_ref false). + * "toggled" from strong to weak (@is_last_ref true) or weak to strong + * (@is_last_ref false). * * Since a (normal) reference must be held to the object before * calling g_object_add_toggle_ref(), the initial state of the reverse @@ -3324,7 +3324,7 @@ g_object_set_qdata_full (GObject *object, * set). * Usually, calling this function is only required to update * user data pointers with a destroy notifier, for example: - * |[ + * |[ * void * object_add_to_user_list (GObject *object, * const gchar *new_string)