From: Victor Stinner <victor.stinner@gmail.com>
Date: Fri, 10 Oct 2014 10:07:19 +0000 (+0200)
Subject: Issue #22564: ssl doc: mention how SSLSocket are usually created
X-Git-Tag: v3.4.3rc1~519
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=d28fe8c8f461c153b1d3252d52d7b0c494402a4e;p=thirdparty%2FPython%2Fcpython.git

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

diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index 5f4a118225dd..6489ecfc2579 100644
--- 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)