Docs fixups following implement socket factory (#10534) (#10568)

Author: TimMenninger

CHANGES/10474.feature.rst

@@ -0,0 +1 @@
+10520.feature.rst

docs/client_advanced.rst

@@ -472,8 +472,8 @@ Custom socket creation
 ^^^^^^^^^^^^^^^^^^^^^^
 
 If the default socket is insufficient for your use case, pass an optional
-`socket_factory` to the :class:`~aiohttp.TCPConnector`, which implements
-`SocketFactoryType`. This will be used to create all sockets for the
+``socket_factory`` to the :class:`~aiohttp.TCPConnector`, which implements
+:class:`SocketFactoryType`. This will be used to create all sockets for the
 lifetime of the class object. For example, we may want to change the
 conditions under which we consider a connection dead. The following would
 make all sockets respect 9*7200 = 18 hours::

docs/client_reference.rst

@@ -1122,31 +1122,27 @@ is controlled by *force_close* constructor's parameter).
       overridden in subclasses.
 
 
-.. autodata:: AddrInfoType
-
-.. note::
+.. py:class:: AddrInfoType
 
    Refer to :py:data:`aiohappyeyeballs.AddrInfoType` for more info.
 
 .. warning::
 
    Be sure to use ``aiohttp.AddrInfoType`` rather than
    ``aiohappyeyeballs.AddrInfoType`` to avoid import breakage, as
-   it is likely to be removed from ``aiohappyeyeballs`` in the
+   it is likely to be removed from :mod:`aiohappyeyeballs` in the
    future.
 
 
-.. autodata:: SocketFactoryType
-
-.. note::
+.. py:class:: SocketFactoryType
 
    Refer to :py:data:`aiohappyeyeballs.SocketFactoryType` for more info.
 
 .. warning::
 
    Be sure to use ``aiohttp.SocketFactoryType`` rather than
    ``aiohappyeyeballs.SocketFactoryType`` to avoid import breakage,
-   as it is likely to be removed from ``aiohappyeyeballs`` in the
+   as it is likely to be removed from :mod:`aiohappyeyeballs` in the
    future.
 
 
@@ -1278,9 +1274,9 @@ is controlled by *force_close* constructor's parameter).
 
         .. versionadded:: 3.10
 
-   :param :py:data:``SocketFactoryType`` socket_factory: This function takes an
-      :py:data:``AddrInfoType`` and is used in lieu of ``socket.socket()`` when
-      creating TCP connections.
+   :param SocketFactoryType socket_factory: This function takes an
+      :py:data:`AddrInfoType` and is used in lieu of
+      :py:func:`socket.socket` when creating TCP connections.
 
         .. versionadded:: 3.12
 

docs/conf.py

@@ -83,7 +83,7 @@
     "aiohttpsession": ("https://aiohttp-session.readthedocs.io/en/stable/", None),
     "aiohttpdemos": ("https://aiohttp-demos.readthedocs.io/en/latest/", None),
     "aiojobs": ("https://aiojobs.readthedocs.io/en/stable/", None),
-    "aiohappyeyeballs": ("https://aiohappyeyeballs.readthedocs.io/en/stable/", None),
+    "aiohappyeyeballs": ("https://aiohappyeyeballs.readthedocs.io/en/latest/", None),
 }
 
 # Add any paths that contain templates here, relative to this directory.
@@ -419,6 +419,7 @@
     ("py:class", "aiohttp.web.MatchedSubAppResource"),  # undocumented
     ("py:attr", "body"),  # undocumented
     ("py:class", "socket.socket"),  # undocumented
+    ("py:func", "socket.socket"),  # undocumented
     ("py:class", "socket.AddressFamily"),  # undocumented
     ("py:obj", "logging.DEBUG"),  # undocumented
     ("py:class", "aiohttp.abc.AbstractAsyncAccessLogger"),  # undocumented