socket.socket should be a class instead of a function

[arhadthedev]

BPO	45772
Nosy	@terryjreedy, @pitrou, @asvetlov, @miss-islington, @arhadthedev
PRs	bpo-45772: socket.socket should be a class instead of a function #23960 [3.10] bpo-45772: socket.socket should be a class instead of a function (GH-23960) #29542 [3.9] bpo-45772: socket.socket should be a class instead of a function (GH-23960) #29543 [3.8] bpo-45772: socket.socket should be a class instead of a function (GH-23960) #29544

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2021-11-13.06:20:12.578>
created_at = <Date 2021-11-09.19:55:56.174>
labels = ['3.11', 'type-bug', '3.9', '3.10', 'docs']
title = 'socket.socket should be a class instead of a function'
updated_at = <Date 2021-11-13.06:29:08.115>
user = 'https://github.com/arhadthedev'

bugs.python.org fields:

activity = <Date 2021-11-13.06:29:08.115>
actor = 'miss-islington'
assignee = 'docs@python'
closed = True
closed_date = <Date 2021-11-13.06:20:12.578>
closer = 'arhadthedev'
components = ['Documentation']
creation = <Date 2021-11-09.19:55:56.174>
creator = 'arhadthedev'
dependencies = []
files = []
hgrepos = []
issue_num = 45772
keywords = ['patch']
message_count = 5.0
messages = ['406045', '406246', '406268', '406269', '406270']
nosy_count = 7.0
nosy_names = ['terry.reedy', 'pitrou', 'asvetlov', 'docs@python', 'xuhdev', 'miss-islington', 'arhadthedev']
pr_nums = ['23960', '29542', '29543', '29544']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue45772'
versions = ['Python 3.9', 'Python 3.10', 'Python 3.11']

[arhadthedev]

Found a twice stale bpo-less but useful pull request 23960, so publish it here:

Currently socket.socket is documented as a function, but it is really
a class (and thus has function-like usage to construct an object). This
correction would ensure that Python projects that are interlinking
Python's documentation can properly locate socket.socket as a type.