Deprecate g_atexit

This function was just not a good idea to begin with.
Its documentation gives plenty of reason not to use it.

diff --git a/glib/gutils.c b/glib/gutils.c
index 934452d..4b77dbc 100644 (file)
--- a/glib/gutils.c
+++ b/glib/gutils.c
@@ -251,6 +251,9 @@ g_memmove (gpointer      dest,
  * As can be seen from the above, for portability it's best to avoid
  * calling g_atexit() (or atexit()) except in the main executable of a
  * program.
+ *
+ * Deprecated:2.32: It is best to avoid g_atexit(), for the reasons
+ *     outlined above.
  */
 void
 g_atexit (GVoidFunc func)

diff --git a/glib/gutils.h b/glib/gutils.h
index b1c1460..b365701 100644 (file)
--- a/glib/gutils.h
+++ b/glib/gutils.h
@@ -214,7 +214,6 @@ gchar *g_format_size        (guint64          size);
 #ifndef G_DISABLE_DEPRECATED
 GLIB_DEPRECATED_FOR(g_format_size)
 gchar *g_format_size_for_display (goffset size);
-#endif
 
 /**
  * GVoidFunc:
@@ -234,6 +233,7 @@ typedef void (*GVoidFunc) (void);
  * (if there is any in the implementation) and doesn't encounter
  * missing include files.
  */
+GLIB_DEPRECATED
 void   g_atexit                (GVoidFunc    func);
 
 #ifdef G_OS_WIN32
@@ -249,6 +249,8 @@ int atexit (void (*)(void));
 #define g_atexit(func) atexit(func)
 #endif
 
+#endif  /* G_DISABLE_DEPRECATED */
+
 #ifndef __GTK_DOC_IGNORE__
 #ifdef G_OS_WIN32
 #define g_find_program_in_path g_find_program_in_path_utf8