[glib] Document G_GNUC_DEPRECATED_FOR

[Will Thompson <wjt src gnome org>]

commit f291d3bb3ce1245981363395ac576d74e918cb0a
Author: Will Thompson <will thompson collabora co uk>
Date:   Thu Jun 3 15:08:58 2010 +0100

    Document G_GNUC_DEPRECATED_FOR

 docs/reference/glib/glib-sections.txt     |    1 +
 docs/reference/glib/tmpl/macros_misc.sgml |   13 +++++++++++++
 2 files changed, 14 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/glib/glib-sections.txt b/docs/reference/glib/glib-sections.txt
index ac74243..ca2fe57 100644
--- a/docs/reference/glib/glib-sections.txt
+++ b/docs/reference/glib/glib-sections.txt
@@ -346,6 +346,7 @@ G_GNUC_MALLOC
 G_GNUC_ALLOC_SIZE
 G_GNUC_ALLOC_SIZE2
 G_GNUC_DEPRECATED
+G_GNUC_DEPRECATED_FOR
 G_GNUC_NORETURN
 G_GNUC_UNUSED
 G_GNUC_PRINTF
diff --git a/docs/reference/glib/tmpl/macros_misc.sgml b/docs/reference/glib/tmpl/macros_misc.sgml
index b8f229d..387a8a5 100644
--- a/docs/reference/glib/tmpl/macros_misc.sgml
+++ b/docs/reference/glib/tmpl/macros_misc.sgml
@@ -250,6 +250,19 @@ See the GNU C documentation for details.
 @Since: 2.2
 
 
+<!-- ##### MACRO G_GNUC_DEPRECATED_FOR ##### -->
+<para>
+Like %G_GNUC_DEPRECATED, but names the intended replacement for the
+deprecated symbol if the version of <command>gcc</command> in use is
+new enough to support custom deprecation messages.
+See the GNU C documentation for details.
+</para>
+
+ f: the intended replacement for the deprecated symbol, such as the name of a
+    function
+ Since: 2.25.3
+
+
 <!-- ##### MACRO G_GNUC_NORETURN ##### -->
 <para>
 Expands to the GNU C <literal>noreturn</literal> function attribute if the