diff --git a/gio/gunixsocketaddress.c b/gio/gunixsocketaddress.c
index 3ccb2cbf1..3640f1f90 100644
--- a/gio/gunixsocketaddress.c
+++ b/gio/gunixsocketaddress.c
@@ -35,22 +35,21 @@
 #endif
 
 /**
- * SECTION:gunixsocketaddress
- * @short_description: UNIX GSocketAddress
- * @include: gio/gunixsocketaddress.h
+ * GUnixSocketAddress:
  *
- * Support for UNIX-domain (also known as local) sockets.
+ * Support for UNIX-domain (also known as local) sockets, corresponding to
+ * `struct sockaddr_un`.
  *
  * UNIX domain sockets are generally visible in the filesystem.
  * However, some systems support abstract socket names which are not
  * visible in the filesystem and not affected by the filesystem
  * permissions, visibility, etc. Currently this is only supported
  * under Linux. If you attempt to use abstract sockets on other
- * systems, function calls may return %G_IO_ERROR_NOT_SUPPORTED
- * errors. You can use g_unix_socket_address_abstract_names_supported()
+ * systems, function calls may return `G_IO_ERROR_NOT_SUPPORTED`
+ * errors. You can use [func@Gio.UnixSocketAddress.abstract_names_supported]
  * to see if abstract names are supported.
  *
- * Since GLib 2.72, #GUnixSocketAddress is available on all platforms. It
+ * Since GLib 2.72, `GUnixSocketAddress` is available on all platforms. It
  * requires underlying system support (such as Windows 10 with `AF_UNIX`) at
  * run time.
  *
@@ -59,13 +58,6 @@
  * when using it. This is no longer necessary since GLib 2.72.
  */
 
-/**
- * GUnixSocketAddress:
- *
- * A UNIX-domain (local) socket address, corresponding to a
- * struct sockaddr_un.
- */
-
 enum
 {
   PROP_0,