Doc tweaks [skip ci]

doc/intro.rst

@@ -43,6 +43,14 @@ without pre-built wheels or if wheel installation is disabled, a C compiler
 `cffi`_ can optionally be installed to build the CFFI backend in
 addition to the Cython backend on CPython.
 
+
+.. tip:: Some Linux distributions are now mounting their temporary
+         directories with the ``noexec`` option. This can cause a
+         standard ``pip install gevent`` to fail with an error like
+         ``cannot run C compiled programs``. One fix is to mount the
+         temporary directory without that option. See :issue:`570` and
+         :issue:`612` for examples.
+
 __ http://pypi.python.org/pypi/greenlet
 .. _`pip`: https://pip.pypa.io/en/stable/installing/
 .. _`wheels`: http://pythonwheels.com

doc/whatsnew_1_1.rst

@@ -143,7 +143,8 @@ include:
   correctness, and performance. (Previously, the Python 2 implementation used the
   undocumented class :class:`socket._fileobject`.)
 - Locks raise the same error as standard library locks if they are
-  over-released.
+  over-released. Likewise, SSL sockets raise the same errors as their
+  bundled counterparts if they are read or written after being closed.
 - :meth:`ThreadPool.apply <gevent.threadpool.ThreadPool.apply>` can
   now be used recursively.
 - The various pool objects (:class:`~gevent.pool.Group`,

gevent/subprocess.py

@@ -331,6 +331,15 @@ _PLATFORM_DEFAULT_CLOSE_FDS = object()
 
 
 class Popen(object):
+    """
+    The underlying process creation and management in this module is
+    handled by the Popen class. It offers a lot of flexibility so that
+    developers are able to handle the less common cases not covered by
+    the convenience functions.
+
+    .. seealso:: :class:`subprocess.Popen`
+       This class should have the same interface as the standard library class.
+    """
 
     def __init__(self, args, bufsize=None, executable=None,
                  stdin=None, stdout=None, stderr=None,