@@ -270,7 +270,8 @@ to a :class:`ProcessPoolExecutor` will result in deadlock.
270
270
271
271
..versionchanged ::3.3
272
272
When one of the worker processes terminates abruptly, a
273
- :exc: `BrokenProcessPool ` error is now raised. Previously, behaviour
273
+ :exc: `~concurrent.futures.process.BrokenProcessPool ` error is now raised.
274
+ Previously, behaviour
274
275
was undefined but operations on the executor or its futures would often
275
276
freeze or deadlock.
276
277
@@ -469,23 +470,22 @@ Module Functions
469
470
*return_when * indicates when this function should return. It must be one of
470
471
the following constants:
471
472
472
- ..tabularcolumns ::|l|L|
473
-
474
- +-----------------------------+----------------------------------------+
475
- | Constant| Description|
476
- +=============================+========================================+
477
- | :const: `FIRST_COMPLETED `| The function will return when any|
478
- | | future finishes or is cancelled.|
479
- +-----------------------------+----------------------------------------+
480
- | :const: `FIRST_EXCEPTION `| The function will return when any|
481
- | | future finishes by raising an|
482
- | | exception. If no future raises an|
483
- | | exception then it is equivalent to|
484
- | | :const: `ALL_COMPLETED `.|
485
- +-----------------------------+----------------------------------------+
486
- | :const: `ALL_COMPLETED `| The function will return when all|
487
- | | futures finish or are cancelled.|
488
- +-----------------------------+----------------------------------------+
473
+ ..list-table ::
474
+ :header-rows: 1
475
+
476
+ * - Constant
477
+ - Description
478
+
479
+ * - .. data:: FIRST_COMPLETED
480
+ - The function will return when any future finishes or is cancelled.
481
+
482
+ * - .. data:: FIRST_EXCEPTION
483
+ - The function will return when any future finishes by raising an
484
+ exception. If no future raises an exception
485
+ then it is equivalent to:const: `ALL_COMPLETED `.
486
+
487
+ * - .. data:: ALL_COMPLETED
488
+ - The function will return when all futures finish or are cancelled.
489
489
490
490
..function ::as_completed(fs, timeout=None)
491
491
@@ -546,7 +546,8 @@ Exception classes
546
546
..exception ::BrokenThreadPool
547
547
548
548
Derived from:exc: `~concurrent.futures.BrokenExecutor `, this exception
549
- class is raised when one of the workers of a:class: `ThreadPoolExecutor `
549
+ class is raised when one of the workers
550
+ of a:class: `~concurrent.futures.ThreadPoolExecutor `
550
551
has failed initializing.
551
552
552
553
..versionadded ::3.7
@@ -557,7 +558,8 @@ Exception classes
557
558
558
559
Derived from:exc: `~concurrent.futures.BrokenExecutor ` (formerly
559
560
:exc: `RuntimeError `), this exception class is raised when one of the
560
- workers of a:class: `ProcessPoolExecutor ` has terminated in a non-clean
561
+ workers of a:class: `~concurrent.futures.ProcessPoolExecutor `
562
+ has terminated in a non-clean
561
563
fashion (for example, if it was killed from the outside).
562
564
563
565
..versionadded ::3.3