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

vstinner · vstinner · commit d28fe8c8f461 · 2014-10-10T12:07:19.000+02:00
diff --git 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)
