Skip to content

[3.12] gh-110497: Add note about OSError being an alias to IOError in docs (GH-110498) #110546

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 9, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions Doc/library/ctypes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1403,7 +1403,8 @@ way is to instantiate one of the following classes:
failure, an :class:`OSError` is automatically raised.

.. versionchanged:: 3.3
:exc:`WindowsError` used to be raised.
:exc:`WindowsError` used to be raised,
which is now an alias of :exc:`OSError`.

.. versionchanged:: 3.12

Expand Down Expand Up @@ -2088,13 +2089,14 @@ Utility functions
.. function:: WinError(code=None, descr=None)

Windows only: this function is probably the worst-named thing in ctypes. It
creates an instance of OSError. If *code* is not specified,
creates an instance of :exc:`OSError`. If *code* is not specified,
``GetLastError`` is called to determine the error code. If *descr* is not
specified, :func:`FormatError` is called to get a textual description of the
error.

.. versionchanged:: 3.3
An instance of :exc:`WindowsError` used to be created.
An instance of :exc:`WindowsError` used to be created, which is now an
alias of :exc:`OSError`.


.. function:: wstring_at(address, size=-1)
Expand Down
2 changes: 1 addition & 1 deletion Doc/library/gettext.rst
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ install themselves in the built-in namespace as the function :func:`!_`.
:class:`NullTranslations` instance if *fallback* is true.

.. versionchanged:: 3.3
:exc:`IOError` used to be raised instead of :exc:`OSError`.
:exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`.

.. versionchanged:: 3.11
*codeset* parameter is removed.
Expand Down
4 changes: 2 additions & 2 deletions Doc/library/http.cookiejar.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,8 @@ The module defines the following exception:
cookies from a file. :exc:`LoadError` is a subclass of :exc:`OSError`.

.. versionchanged:: 3.3
LoadError was made a subclass of :exc:`OSError` instead of
:exc:`IOError`.
:exc:`LoadError` used to be a subtype of :exc:`IOError`, which is now an
alias of :exc:`OSError`.


The following classes are provided:
Expand Down
4 changes: 2 additions & 2 deletions Doc/library/urllib.error.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,8 @@ The following exceptions are raised by :mod:`urllib.error` as appropriate:
exception instance.

.. versionchanged:: 3.3
:exc:`URLError` has been made a subclass of :exc:`OSError` instead
of :exc:`IOError`.
:exc:`URLError` used to be a subtype of :exc:`IOError`, which is now an
alias of :exc:`OSError`.


.. exception:: HTTPError(url, code, msg, hdrs, fp)
Expand Down
2 changes: 1 addition & 1 deletion Doc/library/zipimport.rst
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ zipimporter Objects
file wasn't found.

.. versionchanged:: 3.3
:exc:`IOError` used to be raised instead of :exc:`OSError`.
:exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`.


.. method:: get_filename(fullname)
Expand Down