diff --git a/docs/reference/gtk/tmpl/gtkmisc.sgml b/docs/reference/gtk/tmpl/gtkmisc.sgml
index 434866014b..57ab5c7090 100644
--- a/docs/reference/gtk/tmpl/gtkmisc.sgml
+++ b/docs/reference/gtk/tmpl/gtkmisc.sgml
@@ -22,7 +22,7 @@ allocated area, the alignment settings will not alter the widgets position.
 <para>
 Note that the desired effect can in most cases be achieved by using the
 #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties
-on the child widget.
+on the child widget, so GtkMisc should not be used in new code.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/gtk/gtkalignment.c b/gtk/gtkalignment.c
index 44adfa107f..b3e0b85c79 100644
--- a/gtk/gtkalignment.c
+++ b/gtk/gtkalignment.c
@@ -44,7 +44,7 @@
  *
  * Note that the desired effect can in most cases be achieved by using the
  * #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties
- * on the child widget.
+ * on the child widget, so #GtkAlignment should not be used in new code.
  */
 
 #include "config.h"