diff --git a/gio/ginetsocketaddress.c b/gio/ginetsocketaddress.c
index 0dee6468f..3f0b7bf90 100644
--- a/gio/ginetsocketaddress.c
+++ b/gio/ginetsocketaddress.c
@@ -33,20 +33,14 @@
 #include "glibintl.h"
 
 
-/**
- * SECTION:ginetsocketaddress
- * @short_description: Internet GSocketAddress
- * @include: gio/gio.h
- *
- * An IPv4 or IPv6 socket address; that is, the combination of a
- * #GInetAddress and a port number.
- */
-
 /**
  * GInetSocketAddress:
  *
- * An IPv4 or IPv6 socket address, corresponding to a struct
- * sockaddr_in or struct sockaddr_in6.
+ * An IPv4 or IPv6 socket address. That is, the combination of a
+ * [class@Gio.InetAddress] and a port number.
+ *
+ * In UNIX terms, `GInetSocketAddress` corresponds to a
+ * [`struct sockaddr_in` or `struct sockaddr_in6`](man:sockaddr(3type)).
  */
 
 struct _GInetSocketAddressPrivate