[Python-checkins] cpython (3.4): asyncio doc: document the new ResourceWarning warnings

[victor.stinner]

https://hg.python.org/cpython/rev/3c3f08e68c20
changeset:   94391:3c3f08e68c20
branch:      3.4
parent:      94389:c1d92f7221a5
user:        Victor Stinner <victor.stinner at gmail.com>
date:        Fri Jan 30 01:35:14 2015 +0100
summary:
  asyncio doc: document the new ResourceWarning warnings

files:
  Doc/library/asyncio-dev.rst |  11 +++++++++++
  1 files changed, 11 insertions(+), 0 deletions(-)


diff --git a/Doc/library/asyncio-dev.rst b/Doc/library/asyncio-dev.rst
--- a/Doc/library/asyncio-dev.rst
+++ b/Doc/library/asyncio-dev.rst
@@ -372,3 +372,14 @@
 
    :ref:`Detect coroutine objects never scheduled <asyncio-coroutine-not-scheduled>`.
 
+
+Close transports
+----------------
+
+When a transport is no more needed, call its ``close()`` method to release
+resources.
+
+If a transport (or an event loop) is not closed explicitly, a
+:exc:`ResourceWarning` warning will be emitted in its destructor. The
+:exc:`ResourceWarning` warnings are hidden by default: use the ``-Wd`` command
+line option of Python to show them.

-- 
Repository URL: https://hg.python.org/cpython