This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Remove IOError references from the tutorial
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.11, Python 3.10, Python 3.9
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, hugetim, miss-islington, terry.reedy
Priority: normal Keywords: patch

Created on 2021-04-23 21:51 by hugetim, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 26289 merged terry.reedy, 2021-05-21 17:13
PR 26293 merged miss-islington, 2021-05-21 17:54
PR 26294 merged miss-islington, 2021-05-21 17:54
Messages (4)
msg391743 - (view) Author: Tim Huegerich (hugetim) Date: 2021-04-23 21:51
Although IOError has been merged into OSError since version 3.3, Section 8.5 of the Tutorial still uses it in examples. 

The Python 9.4 version of the tutorial features an example raising an IOError, which is then output as OSError, raising potential confusion unnecessarily.

The Python 3.10 documentation has partially resolved this issue but still retains a third instance of IOError. In this case, the IOError Exception is not actually raised, so the potentially confusing output is not present. Still, it seems preferable to remove it entirely.
msg394129 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2021-05-21 17:16
IOError is a back-compatibility synonym for OSError.  I will eliminate the last use from all 3 versions.  The change to the previous example was done by 2 people who did not backport to 3.9 and I will not bother with that.  Future versions are already fixed.
msg394137 - (view) Author: miss-islington (miss-islington) Date: 2021-05-21 18:15
New changeset 150bc1f4aa67226fb05fb29032375c203252a538 by Miss Islington (bot) in branch '3.10':
bpo-43927: Change 'IOError' to 'OSError' (GH-26289)
https://github.com/python/cpython/commit/150bc1f4aa67226fb05fb29032375c203252a538
msg394138 - (view) Author: miss-islington (miss-islington) Date: 2021-05-21 18:17
New changeset e10bd76d47dbb4ac296017b963c308d287a9d2f2 by Miss Islington (bot) in branch '3.9':
bpo-43927: Change 'IOError' to 'OSError' (GH-26289)
https://github.com/python/cpython/commit/e10bd76d47dbb4ac296017b963c308d287a9d2f2
History
Date User Action Args
2022-04-11 14:59:44adminsetgithub: 88093
2021-05-21 19:18:42terry.reedysetstatus: open -> closed
resolution: fixed
stage: patch review -> resolved
2021-05-21 18:17:17miss-islingtonsetmessages: + msg394138
2021-05-21 18:15:43miss-islingtonsetmessages: + msg394137
2021-05-21 17:54:15miss-islingtonsetpull_requests: + pull_request24898
2021-05-21 17:54:10miss-islingtonsetnosy: + miss-islington

pull_requests: + pull_request24897
stage: patch review
2021-05-21 17:16:22terry.reedysetnosy: terry.reedy, docs@python, hugetim
versions: + Python 3.11
messages: + msg394129
stage: patch review -> (no value)
2021-05-21 17:13:44terry.reedysetkeywords: + patch
nosy: + terry.reedy

pull_requests: + pull_request24893
stage: patch review
2021-04-23 21:51:05hugetimcreate