[PR #10568/8ac48306 backport][3.12] Docs fixups following implement socket factory (#10534) (#10637)

**This is a backport of PR #10568 as merged into master
(8ac4830).**

Co-authored-by: Tim Menninger <[email protected]>

Author: patchback[bot]

CHANGES/10474.feature.rst

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

docs/client_advanced.rst

@@ -465,8 +465,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

@@ -1138,31 +1138,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.
 
 
@@ -1294,9 +1290,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

@@ -84,7 +84,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.
@@ -420,6 +420,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