diff --git a/gio/gproxyresolver.c b/gio/gproxyresolver.c
index 61f61a797..8a69b202a 100644
--- a/gio/gproxyresolver.c
+++ b/gio/gproxyresolver.c
@@ -131,7 +131,7 @@ g_proxy_resolver_is_supported (GProxyResolver *resolver)
  *
  * Looks into the system proxy configuration to determine what proxy,
  * if any, to use to connect to @uri. The returned proxy URIs are of
- * the form `<protocol>://[user[:password]@]host:port` or
+ * the form `<protocol>://[user[:password]@]host[:port]` or
  * `direct://`, where <protocol> could be http, rtsp, socks
  * or other proxying protocol.
  *
diff --git a/gio/gsimpleproxyresolver.c b/gio/gsimpleproxyresolver.c
index fc4432921..8de26cb7b 100644
--- a/gio/gsimpleproxyresolver.c
+++ b/gio/gsimpleproxyresolver.c
@@ -426,10 +426,6 @@ g_simple_proxy_resolver_class_init (GSimpleProxyResolverClass *resolver_class)
    * Note that as a special case, if this URI starts with
    * "socks://", #GSimpleProxyResolver will treat it as referring
    * to all three of the socks5, socks4a, and socks4 proxy types.
-   *
-   * If you are making an HTTP or HTTPS proxy resolver, you must explicitly
-   * add the port to the URI even if the default port is used. For example:
-   * `https://example.com:443` or `http://example.com:80`.
    */
   g_object_class_install_property (object_class, PROP_DEFAULT_PROXY,
 				   g_param_spec_string ("default-proxy",