diff --git a/gio/gfileicon.c b/gio/gfileicon.c
index bd727cd7a..e72bd699f 100644
--- a/gio/gfileicon.c
+++ b/gio/gfileicon.c
@@ -33,15 +33,13 @@
 
 
 /**
- * SECTION:gfileicon
- * @short_description: Icons pointing to an image file
- * @include: gio/gio.h
- * @see_also: #GIcon, #GLoadableIcon
+ * GFileIcon:
  * 
- * #GFileIcon specifies an icon by pointing to an image file
+ * `GFileIcon` specifies an icon by pointing to an image file
  * to be used as icon.
  * 
- **/
+ * It implements [iface@Gio.LoadableIcon].
+ */
 
 static void g_file_icon_icon_iface_init          (GIconIface          *iface);
 static void g_file_icon_loadable_icon_iface_init (GLoadableIconIface  *iface);
diff --git a/gio/gfileicon.h b/gio/gfileicon.h
index 230acdf24..971cf0c9d 100644
--- a/gio/gfileicon.h
+++ b/gio/gfileicon.h
@@ -38,11 +38,6 @@ G_BEGIN_DECLS
 #define G_IS_FILE_ICON_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_ICON))
 #define G_FILE_ICON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_ICON, GFileIconClass))
 
-/**
- * GFileIcon:
- *
- * Gets an icon for a #GFile. Implements #GLoadableIcon.
- **/
 typedef struct _GFileIconClass   GFileIconClass;
 
 GIO_AVAILABLE_IN_ALL