[issue44925] [docs] Confusing deprecation notice for typing.IO

[Jesse Rittner]

Jesse Rittner  added the comment:

@kj I'm not sure if I'll have the time, but for reference, is this what the PR 
would be raised against? 
https://raw.githubusercontent.com/python/cpython/main/Doc/library/typing.rst

--

___
Python tracker 
<https://bugs.python.org/issue44925>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue44925] Confusing deprecation notice for typing.IO

[Jesse Rittner]

New submission from Jesse Rittner :

The docs for typing.IO, typing.TextIO, and typing.BinaryIO include a confusing 
deprecation notice. https://docs.python.org/3/library/typing.html#typing.IO

> Deprecated since version 3.8, will be removed in version 3.12: These types 
> are also in the typing.io namespace, which was never supported by type 
> checkers and will be removed.

As per the discussion on https://github.com/python/typing/issues/834, this 
deprecation notice only refers to the typing.io package, which is confusing. It 
would be helpful to rephrase it for clarity.

--
components: Library (Lib)
messages: 399655
nosy: rittneje
priority: normal
severity: normal
status: open
title: Confusing deprecation notice for typing.IO
type: enhancement
versions: Python 3.10, Python 3.11, Python 3.8, Python 3.9

___
Python tracker 
<https://bugs.python.org/issue44925>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com