summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorAntoine Pitrou <solipsis@pitrou.net>2010-12-12 20:09:18 (GMT)
committerAntoine Pitrou <solipsis@pitrou.net>2010-12-12 20:09:18 (GMT)
commita6540908402d3d0a83fc5355f526371682216969 (patch)
tree7fa312fd67f2b7c3870e14f2cb8e088130640663 /Doc/library
parent5260a9bbdcc665a3e77316552f020a2c7ef28594 (diff)
downloadcpython-a6540908402d3d0a83fc5355f526371682216969.zip
cpython-a6540908402d3d0a83fc5355f526371682216969.tar.gz
cpython-a6540908402d3d0a83fc5355f526371682216969.tar.bz2
Remove redundant sentence, and fix markup
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/stdtypes.rst11
1 files changed, 4 insertions, 7 deletions
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index e981214..0bac956 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2433,12 +2433,9 @@ Context Manager Types
single: protocol; context management
Python's :keyword:`with` statement supports the concept of a runtime context
-defined by a context manager. This is implemented using two separate methods
+defined by a context manager. This is implemented using a pair of methods
that allow user-defined classes to define a runtime context that is entered
-before the statement body is executed and exited when the statement ends.
-
-The :dfn:`context management protocol` consists of a pair of methods that need
-to be provided for a context manager object to define a runtime context:
+before the statement body is executed and exited when the statement ends:
.. method:: contextmanager.__enter__()
@@ -2486,9 +2483,9 @@ decimal arithmetic context. The specific types are not treated specially beyond
their implementation of the context management protocol. See the
:mod:`contextlib` module for some examples.
-Python's :term:`generator`\s and the ``contextlib.contextmanager`` :term:`decorator`
+Python's :term:`generator`\s and the :class:`contextlib.contextmanager` decorator
provide a convenient way to implement these protocols. If a generator function is
-decorated with the ``contextlib.contextmanager`` decorator, it will return a
+decorated with the :class:`contextlib.contextmanager` decorator, it will return a
context manager implementing the necessary :meth:`__enter__` and
:meth:`__exit__` methods, rather than the iterator produced by an undecorated
generator function.