Issue #22564: ssl doc: mention how SSLSocket are usually created

diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index 5f4a118225dd75bf4149b18b252b3ceb0733e744..6489ecfc25793a4583269e566903b67b7651d36c 100644 (file)
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -782,6 +782,9 @@ SSL Sockets
    the specification of normal, OS-level sockets.  See especially the
    :ref:`notes on non-blocking sockets <ssl-nonblocking>`.
 
+   Usually, :class:`SSLSocket` are not created directly, but using the
+   :func:`wrap_socket` function or the :meth:`SSLContext.wrap_socket` method.
+
 SSL sockets also have the following additional methods and attributes:
 
 .. method:: SSLSocket.read(len=0, buffer=None)