Mention that SSL sockets provide the basic socket API.

diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index ab7ffdb0d35944ae85720e03f38f6f197894e533..4ab21d2e0d43b8c08376edc40f45183bc93c0904 100644 (file)
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -325,6 +325,12 @@ Functions, Constants, and Exceptions
 SSL Sockets
 -----------
 
+SSL sockets provide the basic interface of :ref:`socket-objects`. However,
+not all functionality is supported (for example, passing a non-zero ``flags``
+argument to :meth:`recv()` is not allowed).
+
+SSL sockets also have the following additional methods and attributes:
+
 .. method:: SSLSocket.read(nbytes=1024, buffer=None)
 
    Reads up to ``nbytes`` bytes from the SSL-encrypted channel and returns them.