diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index b85b4732a1..4ef6d574d6 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -1325,13 +1325,13 @@ gtk_style_context_restore (GtkStyleContext *context)
  * In the CSS file format, a #GtkEntry defining a “search”
  * class, would be matched by:
  *
- * |[
+ * |[ <!-- language="CSS" -->
  * entry.search { ... }
  * ]|
  *
  * While any widget defining a “search” class would be
  * matched by:
- * |[
+ * |[ <!-- language="CSS" -->
  * .search { ... }
  * ]|
  *
@@ -1495,15 +1495,15 @@ _gtk_style_context_check_region_name (const gchar *str)
  * In the CSS file format, a #GtkTreeView defining a “row”
  * region, would be matched by:
  *
- * |[
- * GtkTreeView row { ... }
+ * |[ <!-- language="CSS" -->
+ * treeview row { ... }
  * ]|
  *
  * Pseudo-classes are used for matching @flags, so the two
  * following rules:
- * |[
- * GtkTreeView row:nth-child(even) { ... }
- * GtkTreeView row:nth-child(odd) { ... }
+ * |[ <!-- language="CSS" -->
+ * treeview row:nth-child(even) { ... }
+ * treeview row:nth-child(odd) { ... }
  * ]|
  *
  * would apply to even and odd rows, respectively.
@@ -2257,7 +2257,7 @@ gtk_style_context_lookup_color (GtkStyleContext *context,
  *
  * As a practical example, a #GtkButton notifying a state transition on
  * the prelight state:
- * |[<!-- language="C" -->
+ * |[ <!-- language="C" -->
  * gtk_style_context_notify_state_change (context,
  *                                        gtk_widget_get_window (widget),
  *                                        NULL,
@@ -2266,12 +2266,12 @@ gtk_style_context_lookup_color (GtkStyleContext *context,
  * ]|
  *
  * Can be handled in the CSS file like this:
- * |[
- * GtkButton {
+ * |[ <!-- language="CSS" -->
+ * button {
  *     background-color: #f00
  * }
  *
- * GtkButton:hover {
+ * button:hover {
  *     background-color: #fff;
  *     transition: 200ms linear
  * }