[New-bugs-announce] [issue44261] SocketType documentation misleading

[Sebastian Rittau]

New submission from Sebastian Rittau <srittau at rittau.biz>:

The documentation of socket.SocketType (https://docs.python.org/3/library/socket.html?highlight=sockettype#socket.SocketType) is misleading. It states:

    This is a Python type object that represents the socket object type. It is the same as type(socket(...)).

This is untrue. socket.SocketType is in reality re-exported from _socket, where it is an alias for class _socket.socket, a super type of class socket.socket. I think that either the documentation should be fixed, or SocketType should be moved to socket and made an alias of socket.socket.

----------
assignee: docs at python
components: Documentation
messages: 394665
nosy: docs at python, srittau
priority: normal
severity: normal
status: open
title: SocketType documentation misleading

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue44261>
_______________________________________