Apply suggestions from code review

encukou · bitdancer · web-flow · commit 49403ae43c9d · 2026-02-11T13:46:59.000+01:00
Co-authored-by: R. David Murray &lt;rdmurray@bitdance.com&gt;
diff --git a/Doc/library/mailbox.rst b/Doc/library/mailbox.rst
@@ -79,9 +79,9 @@ Supported mailbox formats are Maildir, mbox, MH, Babyl, and MMDF.
       corrupting the entire mailbox.
 
    The :class:`Mailbox` class supports the :keyword:`with` statement.  When used
-   like this, the Mailbox acquires a lock when the :keyword:`with` statement
-   enters and releases it and :meth:`close` when the :keyword:`with` statement
-   exits.
+	as a context manager, :class:`!Mailbox` calls :meth:`lock` when the context is entered,
+	returns the mailbox object as the context object, and at context end calls :meth:`close`,
+	thereby releasing the lock.
 
    .. versionchanged:: next
       Support for the :keyword:`with` statement was added.
diff --git a/Misc/NEWS.d/next/Library/2017-12-15-09-32-57.bpo-32234.XaOkhR.rst b/Misc/NEWS.d/next/Library/2017-12-15-09-32-57.bpo-32234.XaOkhR.rst
@@ -1,2 +1 @@
-Mailbox instances can be used as a context manager. The Mailbox is locked
-at enter and unlocked and closed at exit.
+:mod:`Mailbox` instances can now be used as a context manager. The Mailbox is locked on context entry and unlocked and closed at context exit.

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1 @@`
`1`		`-Mailbox instances can be used as a context manager. The Mailbox is locked`
`2`		`-at enter and unlocked and closed at exit.`
	`1`	+:mod:`Mailbox` instances can now be used as a context manager. The Mailbox is locked on context entry and unlocked and closed at context exit.