Get rid of a couple more context object references, fix some markup and clarify what...

diff --git a/Doc/lib/libcontextlib.tex b/Doc/lib/libcontextlib.tex
index f28bdd098edad5c28fc2a4fcb3c106eb5f78c0a1..72bf53716aa6c27c9a5bff0698526149656fc61f 100644 (file)
--- a/Doc/lib/libcontextlib.tex
+++ b/Doc/lib/libcontextlib.tex
@@ -13,7 +13,7 @@ Functions provided:
 
 \begin{funcdesc}{contextmanager}{func}
 This function is a decorator that can be used to define a factory
-function for \keyword{with} statement context objects, without
+function for \keyword{with} statement context managers, without
 needing to create a class or separate \method{__enter__()} and
 \method{__exit__()} methods.
 
@@ -52,9 +52,10 @@ occurred.  Thus, you can use a
 the error (if any), or ensure that some cleanup takes place. If an
 exception is trapped merely in order to log it or to perform some
 action (rather than to suppress it entirely), the generator must
-reraise that exception. Otherwise the \keyword{with} statement will
-treat the exception as having been handled, and resume execution with
-the statement immediately following the \keyword{with} statement.
+reraise that exception. Otherwise the generator context manager will
+indicate to the \keyword{with} statement that the exception has been
+handled, and execution will resume with the statement immediately
+following the \keyword{with} statement.
 \end{funcdesc}
 
 \begin{funcdesc}{nested}{mgr1\optional{, mgr2\optional{, ...}}}
@@ -81,9 +82,9 @@ with A as X:
 Note that if the \method{__exit__()} method of one of the nested
 context managers indicates an exception should be suppressed, no
 exception information will be passed to any remaining outer context
-objects. Similarly, if the \method{__exit__()} method of one of the
-nested context managers raises an exception, any previous exception
-state will be lost; the new exception will be passed to the
+managers. Similarly, if the \method{__exit__()} method of one of the
+nested managers raises an exception, any previous exception state will
+be lost; the new exception will be passed to the
 \method{__exit__()} methods of any remaining outer context managers.
 In general, \method{__exit__()} methods should avoid raising
 exceptions, and in particular they should not re-raise a

diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index d05b075ba13ee9d1b6a1f700dec4b6fba9b7f16f..83a1eedb2d944cbcb4b52d5f41a82b264b13e2a7 100644 (file)
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -1778,8 +1778,8 @@ define a runtime context:
 
   An example of a context manager that returns itself is a file object.
   File objects return themselves from __enter__() to allow
-  \function{open()} to be used as the context expression in a with
-  statement.
+  \function{open()} to be used as the context expression in a
+  \keyword{with} statement.
 
   An example of a context manager that returns a related
   object is the one returned by \code{decimal.Context.get_manager()}.