[glib] Add our own deprecation macros

[Matthias Clasen <matthiasc src gnome org>]

commit a1acf35653ac5d437bdd8dce1b2b56333b005c0c
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Oct 11 13:33:07 2011 -0400

    Add our own deprecation macros
    
    This will allow to suppress deprecation warnings on a per-module
    basis, if needed. They are on by default now, though.

 docs/reference/glib/glib-sections.txt |    2 ++
 glib/gmacros.h                        |   14 ++++++++++++++
 2 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/glib/glib-sections.txt b/docs/reference/glib/glib-sections.txt
index 992443a..0e34cb0 100644
--- a/docs/reference/glib/glib-sections.txt
+++ b/docs/reference/glib/glib-sections.txt
@@ -406,6 +406,8 @@ G_HAVE_GNUC_VARARGS
 G_HAVE_ISO_VARARGS
 G_HAVE_GROWING_STACK
 G_VA_COPY_AS_ARRAY
+GLIB_DEPRECATED
+GLIB_DEPRECATED_FOR
 </SECTION>
 
 <SECTION>
diff --git a/glib/gmacros.h b/glib/gmacros.h
index 83eef9e..47adc8a 100644
--- a/glib/gmacros.h
+++ b/glib/gmacros.h
@@ -304,4 +304,18 @@
 #endif
 
 
+/* These macros are used to mark deprecated functions in GLib headers,
+ * and thus have to be exposed in installed headers. But please
+ * do *not* use them in other projects. Instead, use G_DEPRECATED
+ * or define your own wrappers around it.
+ */
+
+#ifdef GLIB_DISABLE_DEPRECATION_WARNINGS
+#define GLIB_DEPRECATED
+#define GLIB_DEPRECATED_FOR(f)
+#else
+#define GLIB_DEPRECATED G_DEPRECATED
+#define GLIB_DEPRECATED_FOR(f) G_DEPRECATED_FOR(f)
+#endif
+
 #endif /* __G_MACROS_H__ */