Skip to content

Commit b5bf2d7

Browse files
committed
gh-101267: clarify the NEWS entry and use reST roles
Describe the actual failure (re-raising one shared exception appends a traceback to it on each Future.result()) and cross-reference the API names.
1 parent dd89a41 commit b5bf2d7

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,7 @@
1-
When a worker process terminates unexpectedly, ``concurrent.futures.ProcessPoolExecutor`` no longer shares one ``BrokenProcessPool`` exception instance among all failed futures. This was unsafe because exceptions are mutable. Malformed (repeated) tracebacks were the most common symptom of this bug.
1+
When a worker process terminates unexpectedly,
2+
:class:`concurrent.futures.ProcessPoolExecutor` now sets a separate
3+
:exc:`~concurrent.futures.process.BrokenProcessPool` exception on each pending
4+
future instead of sharing a single instance among them all. Sharing one
5+
exception produced malformed tracebacks: each
6+
:meth:`Future.result() <concurrent.futures.Future.result>` call re-raised the
7+
same object, appending another copy of the traceback to it.

0 commit comments

Comments
 (0)