New submission from Sworddragon:

Currently the documentation does sometimes say about specific exceptions but 
most times not. As I'm often catching exceptions to ensure a high stability 
this gets a little difficult. For example print() can trigger a BrokenPipeError 
and the most file functions like flush() can trigger other related IOError's.

So I would like to see something like a listing on every function which 
contains all exceptions that may appear. Also there are some special cases like 
close(). For example it can trigger an IOError too if there are pending write 
operations due to an implicit call of flush(). But if the file object is opened 
in read-only mode or there are no write operations this can't happen. Maybe 
such additional information can be added too.

----------
assignee: docs@python
components: Documentation
messages: 203535
nosy: Sworddragon, docs@python
priority: normal
severity: normal
status: open
title: Listing of all exceptions for every function
type: enhancement
versions: Python 2.7, Python 3.3

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue19672>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to