[docs] [issue37225] Signatures of Exceptions not documented

Hong Xu report at bugs.python.org
Tue Jun 11 03:11:42 EDT 2019


New submission from Hong Xu <hong at topbug.net>:

The "Builtin Exceptions" page does not document the constructors of the listed exception classes. All it says is

> The tuple of arguments given to the exception constructor. Some built-in exceptions (like OSError) expect a certain number of arguments and assign a special meaning to the elements of this tuple, while others are usually called only with a single string giving an error message.

This is quite vague and does not really guide users for individual exception classes.

----------
assignee: docs at python
components: Documentation
messages: 345195
nosy: Hong Xu, docs at python
priority: normal
severity: normal
status: open
title: Signatures of Exceptions not documented
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue37225>
_______________________________________


More information about the docs mailing list