From: Victor Stinner Date: Mon, 25 Aug 2014 15:04:12 +0000 (+0200) Subject: asyncio: update the doc X-Git-Tag: v3.4.2rc1~85 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d71dcbb043578c0abe770a2f37fac36e1a402821;p=python asyncio: update the doc * dev: mention that the logging must be configured at DEBUG level * streams: drain() has no more a strange return value, it's just a standard coroutine --- diff --git a/Doc/library/asyncio-dev.rst b/Doc/library/asyncio-dev.rst index bf6812118b..b797d6a78d 100644 --- a/Doc/library/asyncio-dev.rst +++ b/Doc/library/asyncio-dev.rst @@ -15,7 +15,15 @@ Debug mode of asyncio --------------------- To enable the debug mode globally, set the environment variable -:envvar:`PYTHONASYNCIODEBUG` to ``1``. Examples of effects of the debug mode: +:envvar:`PYTHONASYNCIODEBUG` to ``1``. To see debug traces, set the log level +of the :ref:`asyncio logger ` to :py:data:`logging.DEBUG`. The +simplest configuration is:: + + import logging + # ... + logging.basicConfig(level=logging.DEBUG) + +Examples of effects of the debug mode: * Log :ref:`coroutines defined but never "yielded from" ` diff --git a/Doc/library/asyncio-stream.rst b/Doc/library/asyncio-stream.rst index 11d13c85c1..a4a997e609 100644 --- a/Doc/library/asyncio-stream.rst +++ b/Doc/library/asyncio-stream.rst @@ -172,17 +172,16 @@ StreamWriter Wait until the write buffer of the underlying transport is flushed. - This method has an unusual return value. The intended use is to write:: + The intended use is to write:: w.write(data) yield from w.drain() - When there's nothing to wait for, :meth:`drain()` returns ``()``, and the - yield-from continues immediately. When the transport buffer is full (the - protocol is paused), :meth:`drain` creates and returns a - :class:`Future` and the yield-from will block until - that Future is completed, which will happen when the buffer is - (partially) drained and the protocol is resumed. + When the transport buffer is full (the protocol is paused), block until + the buffer is (partially) drained and the protocol is resumed. When there + is nothing to wait for, the yield-from continues immediately. + + This method is a :ref:`coroutine `. .. method:: get_extra_info(name, default=None)