Simplify AsyncResult now that its keeping the exc_info around. Docs.

doc/conf.py

@@ -255,4 +255,4 @@ class MyClassDocumenter(ClassDocumenter):
         members.sort(key=key)
         return members_check_module, members
 
-#autodoc.ClassDocumenter = MyClassDocumenter
+autodoc.ClassDocumenter = MyClassDocumenter

doc/generate_rst.py

@@ -42,6 +42,12 @@ def generate_rst_for_module(module, do=True):
     m = getattr(m, module)
     title = getattr(m, '__doc__', None)
     if title:
+        lines = title.strip().splitlines()
+        for line in lines:
+            # skip leading blanks. Support both styles of docstrings.
+            if line:
+                title = line
+                break
         title = title.strip().split('\n')[0]
         title = title.strip(' .')
     prefix = ':mod:`gevent.%s`' % module

doc/gevent.event.rst

@@ -8,6 +8,7 @@
 
     .. method:: is_set()
                 isSet()
+                ready()
 
        Return true if and only if the internal flag is true.
 
@@ -15,8 +16,3 @@
 .. autoclass:: gevent.event.AsyncResult
     :members:
     :undoc-members:
-
-    .. attribute:: value
-
-       Holds the value passed to :meth:`set` if :meth:`set` was called. Otherwise ``None``.
-

gevent/select.py

 # Copyright (c) 2009-2011 Denis Bilenko. See LICENSE for details.
+"""
+Waiting for I/O completion.
+"""
 from __future__ import absolute_import
 from gevent.event import Event
 from gevent.hub import get_hub

gevent/socket.py

@@ -4,11 +4,11 @@
 
 This module provides socket operations and some related functions.
 The API of the functions and classes matches the API of the corresponding
-items in standard :mod:`socket` module exactly, but the synchronous functions
+items in the standard :mod:`socket` module exactly, but the synchronous functions
 in this module only block the current greenlet and let the others run.
 
 For convenience, exceptions (like :class:`error <socket.error>` and :class:`timeout <socket.timeout>`)
-as well as the constants from :mod:`socket` module are imported into this module.
+as well as the constants from the :mod:`socket` module are imported into this module.
 """
 
 import sys
@@ -43,7 +43,7 @@ def create_connection(address, timeout=_GLOBAL_DEFAULT_TIMEOUT, source_address=N
     global default timeout setting returned by :func:`getdefaulttimeout`
     is used. If *source_address* is set it must be a tuple of (host, port)
     for the socket to bind as a source address before making the connection.
-    An host of '' or port 0 tells the OS to use the default.
+    A host of '' or port 0 tells the OS to use the default.
     """
 
     host, port = address

gevent/ssl.py

+"""
+Secure Sockets Layer (SSL/TLS) module.
+"""
 from gevent.hub import PY3
 from gevent.hub import PYGTE279