Socket documentation links socket object `.close` methods to module level `socket.close(fd)`

[zevisert]

Documentation

Docs link: https://docs.python.org/3/library/socket.html#socket-objects

The documentation for socket objects refers to the socket object's .close() method without arguments, but the meth hyperlinks point at the socket module level close(fd) function.

Linked PRs

• gh-115426: Fix the socket object close() cross-references #157295
• [3.15] gh-115426: Fix cross-references to socket.socket.close() (GH-157295) #157330
• [3.14] gh-115426: Fix cross-references to socket.socket.close() (GH-157295) #157331
• [3.13] gh-115426: Fix cross-references to socket.socket.close() (GH-157295) #157332

[zevisert]

I think I could fix this, I'm assuming from the HTML fragments for these hyperlinks that a few places where the documentation uses :meth:`~socket.close` but should be using something like :meth:`~socket.socket.close` instead. I'd have to build the docs to check, unless someone knows otherwise?

I think I could also fix #75920 while I'm in there.

[StanFromIreland]

@zevisert sorry we never replied, but someone has since opened a PR for this. You can open a separate PR for the other issue. :-)