Issue #6774: Back out c8b77efe8b56, which only brings confusion.
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index a8d3b93..cb2ab23 100644
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -1071,9 +1071,7 @@
Shut down one or both halves of the connection. If *how* is :const:`SHUT_RD`,
further receives are disallowed. If *how* is :const:`SHUT_WR`, further sends
are disallowed. If *how* is :const:`SHUT_RDWR`, further sends and receives are
- disallowed. Depending on the platform, shutting down one half of the connection
- can also close the opposite half (e.g. on Mac OS X, ``shutdown(SHUT_WR)`` does
- not allow further reads on the other end of the connection).
+ disallowed.
Note that there are no methods :meth:`read` or :meth:`write`; use
:meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument instead.