update ssl documentation

diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index a41c6ea6217c1d4f2d76d52a8a2e699049b6448f..df161fd3c032856c6528da527bd7b04e1b2f0c9a 100644 (file)
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -322,6 +322,15 @@ SSLSocket Objects
                 else:
                     raise
 
+.. method:: SSLSocket.unwrap()
+
+   Performs the SSL shutdown handshake, which removes the TLS layer
+   from the underlying socket, and returns the underlying socket
+   object.  This can be used to go from encrypted operation over a
+   connection to unencrypted.  The returned socket should always be
+   used for further communication with the other side of the
+   connection, rather than the original socket
+
 .. index:: single: certificates
 
 .. index:: single: X509 certificate