simplify docstring

gevent/timeout.py

@@ -149,39 +149,12 @@ class Timeout(BaseException):
 def with_timeout(seconds, func, *args, **kwds):
     """Wrap a call to some (yielding) function with a timeout; if the called
     function fails to return before the timeout, cancel it and return a flag
-    value.
+    value, provided by 'timeout_value' keyword argument.
 
-    seconds
-      (int or float) seconds before timeout occurs
-    func
-      the callable to execute with a timeout; must be one of the functions
-      that implicitly or explicitly yields
-    \*args, \*\*kwds
-      (positional, keyword) arguments to pass to *func*
-    timeout_value=
-      value to return if timeout occurs (default raise ``Timeout``)
+    If timeout expires but 'timeout_value' is not provided, raise Timeout.
 
-    **Returns**:
-
-    Value returned by *func* if *func* returns before *seconds*, else
-    *timeout_value* if provided, else raise ``Timeout``
-
-    **Raises**:
-
-    Any exception raised by *func*, and ``Timeout`` if *func* times out
-    and no ``timeout_value`` has been provided.
-
-    **Example**::
-
-      data = with_timeout(30, httpc.get, 'http://www.google.com/', timeout_value="")
-
-    Here *data* is either the result of the ``get()`` call, or the empty string if
-    it took too long to return. Any exception raised by the ``get()`` call is
-    passed through to the caller.
+    Keyword argument 'timeout_value', is not passed to func.
     """
-    # Recognize a specific keyword argument, while also allowing pass-through
-    # of any other keyword arguments accepted by func. Use pop() so we don't
-    # pass timeout_value through to func().
     timeout_value = kwds.pop("timeout_value", _NONE)
     timeout = Timeout.start_new(seconds)
     try: