incorporate fixes from issue 3162; SSL doc patch
diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index df161fd..4fcc2f4 100644
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -327,9 +327,10 @@
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
+ connection to unencrypted. The socket instance returned should always be
used for further communication with the other side of the
- connection, rather than the original socket
+ connection, rather than the original socket instance (which may
+ not function properly after the unwrap).
.. index:: single: certificates