Document G_GNUC_DEPRECATED_FOR

diff --git a/docs/reference/glib/glib-sections.txt b/docs/reference/glib/glib-sections.txt
index ac74243..ca2fe57 100644 (file)
--- 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 (file)
--- 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