[Python-Dev] [Python-checkins] cpython: Mention OSError instead of IOError in the docs. (original) (raw)

Nick Coghlan ncoghlan at gmail.com
Wed Dec 19 08:24:43 CET 2012

On Wed, Dec 19, 2012 at 7:16 AM, andrew.svetlov <python-checkins at python.org>wrote:

http://hg.python.org/cpython/rev/a6ea6f803017 changeset: 80934:a6ea6f803017 user: Andrew Svetlov <andrew.svetlov at gmail.com> date: Tue Dec 18 23:16:44 2012 +0200 summary: Mention OSError instead of IOError in the docs.

files: Doc/faq/library.rst | 4 ++-- 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Doc/faq/library.rst b/Doc/faq/library.rst --- a/Doc/faq/library.rst +++ b/Doc/faq/library.rst @@ -209,7 +209,7 @@ try: c = sys.stdin.read(1) print("Got character", repr(c)) - except IOError: + except OSError: pass finally: termios.tcsetattr(fd, termios.TCSAFLUSH, oldterm) @@ -222,7 +222,7 @@ :func:termios.tcsetattr turns off stdin's echoing and disables canonical mode. :func:fcntl.fnctl is used to obtain stdin's file descriptor flags and modify them for non-blocking mode. Since reading stdin when it is empty - results in an :exc:IOError, this error is caught and ignored. + results in an :exc:OSError, this error is caught and ignored.

With any of these changes in the docs, please don't forget to include appropriate "versionchanged" directives. Many people using the Python 3 docs at "docs.python.org/3/" will still be on Python 3.2, and thus relying on the presence of such directives to let them know that while the various OS-related exception names are now just aliases for OSError in 3.3+, the distinctions still matter in 3.2.

Cheers, Nick.

-- Nick Coghlan | ncoghlan at gmail.com | Brisbane, Australia -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.python.org/pipermail/python-dev/attachments/20121219/7220731a/attachment.html>

More information about the Python-Dev mailing list