[issue37225] Signatures of Exceptions not documented

2019-06-11 Thread Hong Xu
Hong Xu added the comment: Thanks for your answer, but I believe this is a real document bug. OSError does have its signature documented, but the majority of other exception classes do not do so, neither does BaseException explains a default behavior clearly (see my quote above). As an exam

[issue37225] Signatures of Exceptions not documented

2019-06-11 Thread Brett Cannon
Brett Cannon added the comment: OSError does have its constructor documented at https://docs.python.org/3/library/exceptions.html#OSError (farther down the page I think you're reading; you didn't provide the URL you're referring to so I'm somewhat guessing). It is specifically vague because

[issue37225] Signatures of Exceptions not documented

2019-06-11 Thread Hong Xu
New submission from Hong Xu : 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