Update comments

Author: giampaolo

Lib/subprocess.py

@@ -2067,8 +2067,7 @@ def _wait_pidfd(self, timeout):
                 pidfd = os.pidfd_open(self.pid, 0)
             except OSError:
                 # May be:
-                # - ESRCH: no such process; waitpid() should still be
-                #   able to return the status code.
+                # - ESRCH: no such process
                 # - EMFILE, ENFILE: too many open files (usually 1024)
                 # - ENODEV: anonymous inode filesystem not supported
                 # - EPERM, EACCES, ENOSYS: undocumented; may happen if

Lib/test/test_subprocess.py

@@ -4097,7 +4097,7 @@ class FastWaitTestCase(BaseTestCase):
 
     def assert_fast_waitpid_error(self, patch_point):
         # Emulate a case where pidfd_open() (Linux) or kqueue()
-        # (BSD/macOS) fails. _busy_wait() should be used as fallback.
+        # (BSD/macOS) fails. Busy-poll wait should be used as fallback.
         exc = OSError(errno.EMFILE, os.strerror(errno.EMFILE))
         with mock.patch(patch_point, side_effect=exc) as m:
             p = subprocess.Popen([sys.executable,
@@ -4117,7 +4117,7 @@ def test_wait_kqueue_error(self):
 
     @unittest.skipIf(not CAN_USE_KQUEUE, reason="macOS / BSD only")
     def test_kqueue_control_error(self):
-        # Emulate a case where kqueue.control() fails. _busy_wait()
+        # Emulate a case where kqueue.control() fails. Busy-poll wait
         # should be used as fallback.
         p = subprocess.Popen([sys.executable,
                               "-c", "import time; time.sleep(0.3)"])