From 07171242d5ea3bc56a05a548ffa2deb9e0e5420d Mon Sep 17 00:00:00 2001
From: Victor Stinner <victor.stinner@gmail.com>
Date: Mon, 24 Feb 2014 13:18:47 +0100
Subject: [PATCH] subprocess.Popen.wait doc: mention asyncio to avoid busy loop
---
Doc/library/subprocess.rst | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 1a9dd9d390..f03c322942 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -629,6 +629,12 @@ Instances of the :class:`Popen` class have the following methods:
:exc:`TimeoutExpired` exception. It is safe to catch this exception and
retry the wait.
+ .. note::
+
+ The function is implemented using a busy loop (non-blocking call and
+ short sleeps). Use the :mod:`asyncio` module for an asynchronous wait:
+ see :class:`asyncio.create_subprocess_exec`.
+
.. warning::
This will deadlock when using ``stdout=PIPE`` and/or
--
2.49.0