bpo-14879: [doc] clarify how to check for errors from subprocess.Pope… · python/cpython@50ffbe3 (original) (raw)

Original file line number Diff line number Diff line change
@@ -689,7 +689,10 @@ execute, will be re-raised in the parent.
689 689
690 690 The most common exception raised is :exc:`OSError`. This occurs, for example,
691 691 when trying to execute a non-existent file. Applications should prepare for
692 -:exc:`OSError` exceptions.
692 +:exc:`OSError` exceptions. Note that, when ``"shell=True"``, :exc:`OSError`
693 +will be raised by the child only if the selected shell itself was not found.
694 +To determine if the shell failed to find the requested application, it is
695 +necessary to check the return code or output from the subprocess.
693 696
694 697 A :exc:`ValueError` will be raised if :class:`Popen` is called with invalid
695 698 arguments.