diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 0f361f3..64e968c 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -188,7 +188,9 @@ typedef enum
  *
  * Returns the widget flags from @wid.
  *
- * Deprecated: 2.20: Do not use it.
+ * Deprecated: 2.20: Use functions to test individual states, such as
+ * gtk_widget_is_sensitive(), gtk_widget_has_focus() and
+ * gtk_widget_get_visible().
  */
 #define GTK_WIDGET_FLAGS(wid)		  (GTK_OBJECT_FLAGS (wid))
 /* FIXME: Deprecating GTK_WIDGET_FLAGS requires fixing GTK internals. */
