Properly deprecate g_type_init()
authorRyan Lortie <desrt@desrt.ca>
Mon, 15 Oct 2012 16:01:01 +0000 (12:01 -0400)
committerRyan Lortie <desrt@desrt.ca>
Tue, 16 Oct 2012 13:39:24 +0000 (09:39 -0400)
Now that all internal users of it are gone.

https://bugzilla.gnome.org/show_bug.cgi?id=686161

gobject/gtype.c
gobject/gtype.h

index 75ba044..15a47a1 100644 (file)
@@ -4261,6 +4261,8 @@ _g_type_boxed_init (GType          type,
  *
  * If you need to enable debugging features, use the GOBJECT_DEBUG
  * environment variable.
+ *
+ * Deprecated: 2.36: the type system is now initialised automatically
  */
 void
 g_type_init_with_debug_flags (GTypeDebugFlags debug_flags)
@@ -4277,6 +4279,8 @@ g_type_init_with_debug_flags (GTypeDebugFlags debug_flags)
  * This function used to initialise the type system.  Since GLib 2.36,
  * the type system is initialised automatically and this function does
  * nothing.
+ *
+ * Deprecated: 2.36: the type system is now initialised automatically
  */
 void
 g_type_init (void)
index f2c4f08..80a4ddf 100644 (file)
@@ -646,12 +646,14 @@ struct _GTypeQuery
  * @G_TYPE_DEBUG_OBJECTS: Print messages about object bookkeeping.
  * @G_TYPE_DEBUG_SIGNALS: Print messages about signal emissions.
  * @G_TYPE_DEBUG_MASK: Mask covering all debug flags.
- * 
- * The <type>GTypeDebugFlags</type> enumeration values can be passed to
- * g_type_init_with_debug_flags() to trigger debugging messages during runtime.
- * Note that the messages can also be triggered by setting the
- * <envar>GOBJECT_DEBUG</envar> environment variable to a ':'-separated list of 
- * "objects" and "signals".
+ *
+ * These flags used to be passed to g_type_init_with_debug_flags() which
+ * is now deprecated.
+ *
+ * If you need to enable debugging features, use the GOBJECT_DEBUG
+ * environment variable.
+ *
+ * Deprecated: 2.36: g_type_init() is now done automatically
  */
 typedef enum   /*< skip >*/
 {
@@ -663,7 +665,9 @@ typedef enum        /*< skip >*/
 
 
 /* --- prototypes --- */
+GLIB_DEPRECATED_IN_2_36
 void                  g_type_init                    (void);
+GLIB_DEPRECATED_IN_2_36
 void                  g_type_init_with_debug_flags   (GTypeDebugFlags  debug_flags);
 const gchar *         g_type_name                    (GType            type);
 GQuark                g_type_qname                   (GType            type);