diff --git a/gio/gzlibcompressor.c b/gio/gzlibcompressor.c
index a1c018a01..80084b135 100644
--- a/gio/gzlibcompressor.c
+++ b/gio/gzlibcompressor.c
@@ -43,21 +43,14 @@ enum {
 };
 
 /**
- * SECTION:gzlibcompressor
- * @short_description: Zlib compressor
- * @include: gio/gio.h
+ * GZlibCompressor:
  *
- * #GZlibCompressor is an implementation of #GConverter that
+ * `GZlibCompressor` is an implementation of [iface@Gio.Converter] that
  * compresses data using zlib.
  */
 
 static void g_zlib_compressor_iface_init          (GConverterIface *iface);
 
-/**
- * GZlibCompressor:
- *
- * Zlib decompression
- */
 struct _GZlibCompressor
 {
   GObject parent_instance;
diff --git a/gio/gzlibdecompressor.c b/gio/gzlibdecompressor.c
index f7045093e..1e24a74dc 100644
--- a/gio/gzlibdecompressor.c
+++ b/gio/gzlibdecompressor.c
@@ -42,11 +42,9 @@ enum {
 };
 
 /**
- * SECTION:gzlibdecompressor
- * @short_description: Zlib decompressor
- * @include: gio/gio.h
+ * GZlibDecompressor:
  *
- * #GZlibDecompressor is an implementation of #GConverter that
+ * `GZlibDecompressor` is an implementation of [iface@Gio.Converter] that
  * decompresses data compressed with zlib.
  */
 
@@ -58,11 +56,6 @@ typedef struct {
   GFileInfo *file_info;
 } HeaderData;
 
-/**
- * GZlibDecompressor:
- *
- * Zlib decompression
- */
 struct _GZlibDecompressor
 {
   GObject parent_instance;