Merged revisions 73518-73519 via svnmerge from

svn+ssh://pythondev@svn.python.org/python/trunk

........
  r73518 | nick.coghlan | 2009-06-23 20:19:30 +1000 (Tue, 23 Jun 2009) | 1 line

  Issue 6288: Update contextlib.nested() docstring to reflect new documentation
........
  r73519 | nick.coghlan | 2009-06-23 20:51:02 +1000 (Tue, 23 Jun 2009) | 1 line

  Remove markup from docstring
........
This commit is contained in:
Nick Coghlan 2009-06-23 10:55:52 +00:00
parent 5250401bd0
commit b7706b58fa

View File

@ -87,19 +87,17 @@ def contextmanager(func):
@contextmanager
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 with statement.
with nested(A, B, C) as (X, Y, Z):
<body>
The one advantage of this function over the multiple manager form of the
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 A as X:
with B as Y:
with C as Z:
<body>
with nested(*managers):
do_something()
"""
warn("With-statements now directly support multiple context managers",