diff --git a/gio/gemblem.c b/gio/gemblem.c
index af1ba0006..bf40bc6bc 100644
--- a/gio/gemblem.c
+++ b/gio/gemblem.c
@@ -31,14 +31,11 @@
 
 
 /**
- * SECTION:gemblem
- * @short_description: An object for emblems
- * @include: gio/gio.h
- * @see_also: #GIcon, #GEmblemedIcon, #GLoadableIcon, #GThemedIcon
+ * GEmblem:
  *
- * #GEmblem is an implementation of #GIcon that supports
+ * `GEmblem` is an implementation of [iface@Gio.Icon] that supports
  * having an emblem, which is an icon with additional properties.
- * It can than be added to a #GEmblemedIcon.
+ * It can than be added to a [class@Gio.EmblemedIcon].
  *
  * Currently, only metainformation about the emblem's origin is
  * supported. More may be added in the future.
diff --git a/gio/gemblem.h b/gio/gemblem.h
index eb00c3b34..3fa6b610b 100644
--- a/gio/gemblem.h
+++ b/gio/gemblem.h
@@ -37,11 +37,6 @@ G_BEGIN_DECLS
 #define G_IS_EMBLEM_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_EMBLEM))
 #define G_EMBLEM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_EMBLEM, GEmblemClass))
 
-/**
- * GEmblem:
- *
- * An object for Emblems
- */
 typedef struct _GEmblem        GEmblem;
 typedef struct _GEmblemClass   GEmblemClass;