Issue #15501: Document exception classes in subprocess module.

Initial patch by Anton Barkovsky.

diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index a8d65b2fab6eb2150a0ad90f5ea5cfa10bf8c1fe..a67bf646e9cafce0fcd2adb1a382ecb12406bbf4 100644 (file)
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -208,6 +208,54 @@ use cases, the underlying :class:`Popen` interface can be used directly.
    output.
 
 
+.. exception:: SubprocessError
+
+    Base class for all other exceptions from this module.
+
+    .. versionadded:: 3.3
+
+
+.. exception:: TimeoutExpired
+
+    Subclass of :exc:`SubprocessError`, raised when a timeout expires
+    while waiting for a child process.
+
+    .. attribute:: cmd
+
+        Command that was used to spawn the child process.
+
+    .. attribute:: timeout
+
+        Timeout in seconds.
+
+    .. attribute:: output
+
+        Output of the child process if this exception is raised by
+        :func:`check_output`.  Otherwise, ``None``.
+
+    .. versionadded:: 3.3
+
+
+.. exception:: CalledProcessError
+
+    Subclass of :exc:`SubprocessError`, raised when a process run by
+    :func:`check_call` or :func:`check_output` returns a non-zero exit status.
+
+    .. attribute:: returncode
+
+        Exit status of the child process.
+
+    .. attribute:: cmd
+
+        Command that was used to spawn the child process.
+
+    .. attribute:: output
+
+        Output of the child process if this exception is raised by
+        :func:`check_output`.  Otherwise, ``None``.
+
+
+
 .. _frequently-used-arguments:
 
 Frequently Used Arguments

diff --git a/Misc/ACKS b/Misc/ACKS
index b255ed2ba2cadd772daf522e78ec07efde3cfdd9..4dce609a0466884645847cfa6ef6c245b33593be 100644 (file)
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -56,6 +56,7 @@ Matt Bandy
 Michael J. Barber
 Nicolas Bareil
 Chris Barker
+Anton Barkovsky
 Nick Barnes
 Quentin Barnes
 David Barnett