diff --git a/gio/gproxyaddress.c b/gio/gproxyaddress.c
index 764e6f5d7..f600c91e2 100644
--- a/gio/gproxyaddress.c
+++ b/gio/gproxyaddress.c
@@ -29,21 +29,13 @@
 #include "gproxyaddress.h"
 #include "glibintl.h"
 
-/**
- * SECTION:gproxyaddress
- * @short_description: An internet address with proxy information
- * @include: gio/gio.h
- *
- * Support for proxied #GInetSocketAddress.
- */
-
 /**
  * GProxyAddress:
  *
- * A #GInetSocketAddress representing a connection via a proxy server
+ * A [class@Gio.InetSocketAddress] representing a connection via a proxy server.
  *
  * Since: 2.26
- **/
+ */
 
 /**
  * GProxyAddressClass: