diff --git a/gtk/deprecated/gtkaction.c b/gtk/deprecated/gtkaction.c
index d87b8acc41..b27e71bd96 100644
--- a/gtk/deprecated/gtkaction.c
+++ b/gtk/deprecated/gtkaction.c
@@ -32,11 +32,9 @@
  * @Title: GtkAction
  * @See_also: #GtkActionGroup, #GtkUIManager, #GtkActivatable
  *
- * <warning>
- * In GTK+ 3.10, GtkAction has been deprecated. Use #GAction instead, and
- * associate actions with #GtkActionable widgets. Use #GMenuModel for creating
- * menus with gtk_menu_new_from_model().
- * </warning>
+ * > In GTK+ 3.10, GtkAction has been deprecated. Use #GAction
+ * > instead, and associate actions with #GtkActionable widgets. Use
+ * > #GMenuModel for creating menus with gtk_menu_new_from_model().
  *
  * Actions represent operations that the user can be perform, along with
  * some information how it should be presented in the interface. Each action
diff --git a/gtk/deprecated/gtkrc.c b/gtk/deprecated/gtkrc.c
index 60214f0cb4..82a3abdede 100644
--- a/gtk/deprecated/gtkrc.c
+++ b/gtk/deprecated/gtkrc.c
@@ -71,10 +71,8 @@
  * various aspects of the operation of a GTK+ program
  * at runtime.
  *
- * <warning>
- * In GTK+ 3.0, resource files have been deprecated and replaced
- * by CSS-like style sheets, which are understood by #GtkCssProvider.
- * </warning>
+ * > In GTK+ 3.0, resource files have been deprecated and replaced by
+ * > CSS-like style sheets, which are understood by #GtkCssProvider.
  *
  * # Default files #
  *
diff --git a/gtk/deprecated/gtkstyle.c b/gtk/deprecated/gtkstyle.c
index fb6f1d57fa..bf2a5ebbfa 100644
--- a/gtk/deprecated/gtkstyle.c
+++ b/gtk/deprecated/gtkstyle.c
@@ -54,9 +54,8 @@
  * A #GtkStyle object encapsulates the information that provides the look and
  * feel for a widget.
  *
- * <warning>
- * In GTK+ 3.0, GtkStyle has been deprecated and replaced by #GtkStyleContext.
- * </warning>
+ * > In GTK+ 3.0, GtkStyle has been deprecated and replaced by
+ * > #GtkStyleContext.
  *
  * Each #GtkWidget has an associated #GtkStyle object that is used when
  * rendering that widget. Also, a #GtkStyle holds information for the five
diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index 23f346492d..b1292d3cbe 100644
--- a/gtk/gtkliststore.c
+++ b/gtk/gtkliststore.c
@@ -1443,8 +1443,8 @@ gtk_list_store_clear (GtkListStore *list_store)
  * @list_store: A #GtkListStore.
  * @iter: A #GtkTreeIter.
  *
- * <warning>This function is slow. Only use it for debugging and/or testing
- * purposes.</warning>
+ * > This function is slow. Only use it for debugging and/or testing
+ * > purposes.
  *
  * Checks if the given iter is a valid iter for this #GtkListStore.
  *