diff --git a/gio/gseekable.c b/gio/gseekable.c
index 805e0a055..0b0ec27aa 100644
--- a/gio/gseekable.c
+++ b/gio/gseekable.c
@@ -26,25 +26,22 @@
 
 
 /**
- * SECTION:gseekable
- * @short_description: Stream seeking interface
- * @include: gio/gio.h
- * @see_also: #GInputStream, #GOutputStream
+ * GSeekable:
  *
- * #GSeekable is implemented by streams (implementations of
- * #GInputStream or #GOutputStream) that support seeking.
+ * `GSeekable` is implemented by streams (implementations of
+ * [class@Gio.InputStream] or [class@Gio.OutputStream]) that support seeking.
  *
  * Seekable streams largely fall into two categories: resizable and
  * fixed-size.
  *
- * #GSeekable on fixed-sized streams is approximately the same as POSIX
- * lseek() on a block device (for example: attempting to seek past the
- * end of the device is an error).  Fixed streams typically cannot be
+ * `GSeekable` on fixed-sized streams is approximately the same as POSIX
+ * [`lseek()`](man:lseek(2)) on a block device (for example: attempting to seek
+ * past the end of the device is an error).  Fixed streams typically cannot be
  * truncated.
  *
- * #GSeekable on resizable streams is approximately the same as POSIX
- * lseek() on a normal file.  Seeking past the end and writing data will
- * usually cause the stream to resize by introducing zero bytes.
+ * `GSeekable` on resizable streams is approximately the same as POSIX
+ * [`lseek()`](man:lseek(2)) on a normal file.  Seeking past the end and writing
+ * data will usually cause the stream to resize by introducing zero bytes.
  **/
 
 typedef GSeekableIface GSeekableInterface;
diff --git a/gio/gseekable.h b/gio/gseekable.h
index 34510de6f..e9978016b 100644
--- a/gio/gseekable.h
+++ b/gio/gseekable.h
@@ -36,11 +36,6 @@ G_BEGIN_DECLS
 #define G_IS_SEEKABLE(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_SEEKABLE))
 #define G_SEEKABLE_GET_IFACE(obj)  (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_SEEKABLE, GSeekableIface))
 
-/**
- * GSeekable:
- *
- * Seek object for streaming operations.
- **/
 typedef struct _GSeekableIface   GSeekableIface;
 
 /**