diff --git a/docs/reference/glib/tmpl/macros.sgml b/docs/reference/glib/tmpl/macros.sgml
index 7f40eb380..cf411ee1c 100644
--- a/docs/reference/glib/tmpl/macros.sgml
+++ b/docs/reference/glib/tmpl/macros.sgml
@@ -227,5 +227,6 @@ turn it off. This macro should only be used for return values and for
 <emphasis>in</emphasis> parameters. 
 </para>
 
-
-
+@Deprecated: 2.30: API providers should replace all existing uses with
+  <literal>const</literal> and API consumers should adjust their code
+  accordingly.
diff --git a/glib/gmacros.h b/glib/gmacros.h
index 9f9c25dcb..538ded61f 100644
--- a/glib/gmacros.h
+++ b/glib/gmacros.h
@@ -250,11 +250,13 @@
  * (usually char*) are const or not.  Don't try using this feature for
  * functions with C++ linkage.
  */
+#ifndef G_DISABLE_DEPRECATED
 #ifdef G_DISABLE_CONST_RETURNS
 #define G_CONST_RETURN
 #else
 #define G_CONST_RETURN const
 #endif
+#endif
 
 /*
  * The G_LIKELY and G_UNLIKELY macros let the programmer give hints to