Issue 6288: Update contextlib.nested() docstring to reflect new documentation

This commit is contained in:
Nick Coghlan 2009-06-23 10:19:30 +00:00
parent 94819cf47c
commit 0d8b4e33e7
1 changed files with 8 additions and 10 deletions

View File

@ -87,19 +87,17 @@ def contextmanager(func):
@contextmanager @contextmanager
def nested(*managers): def nested(*managers):
"""Support multiple context managers in a single with-statement. """Combine multiple context managers into a single nested context manager.
Code like this: This function has been deprecated in favour of the multiple manager form
of the :keyword:`with` statement.
with nested(A, B, C) as (X, Y, Z): The one advantage of this function over the multiple manager form of the
<body> :keyword:`with` statement is that argument unpacking allows it to be
used with a variable number of context managers as follows:
is equivalent to this: with nested(*managers):
do_something()
with A as X:
with B as Y:
with C as Z:
<body>
""" """
warn("With-statements now directly support multiple context managers", warn("With-statements now directly support multiple context managers",