[docs] [issue15501] Document exception classes in subprocess module

Andrew Svetlov report at bugs.python.org
Wed Aug 8 20:34:51 CEST 2012


Andrew Svetlov added the comment:

Please update your patches:
1. use attribute:: 
2. point base class for exception if it is not Exception
3. enumerate all attributes (`cmd` for CalledProcessError)

Example:

.. exception:: HTTPError

   Though being an exception (a subclass of :exc:`URLError`), an :exc:`HTTPError`
   can also function as a non-exceptional file-like return value (the same thing
   that :func:`urlopen` returns).  This is useful when handling exotic HTTP
   errors, such as requests for authentication.

   .. attribute:: code

      An HTTP status code as defined in `RFC 2616 <http://www.faqs.org/rfcs/rfc2616.html>`_.
      This numeric value corresponds to a value found in the dictionary of
      codes as found in :attr:`BaseHTTPServer.BaseHTTPRequestHandler.responses`.


Also please fill Contributor Agreement: http://www.python.org/psf/contrib/

----------
nosy: +asvetlov

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue15501>
_______________________________________


More information about the docs mailing list