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.

Author meersuri
Recipients AlexWaygood, Dutcho, JelleZijlstra, docs@python, eric.araujo, ethan.furman, mdk, meersuri, python-dev, zach.ware
Date 2022-02-14.15:49:15
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1644853755.41.0.843148674876.issue46586@roundup.psfhosted.org>
In-reply-to
Content
https://docs.python.org/3.11/library/io.html?highlight=io#text-i-o -

The easiest way to create a text stream is with open(), optionally specifying an encoding:

https://docs.python.org/3.11/library/io.html?highlight=io#binary-i-o - 

The easiest way to create a binary stream is with open() with 'b' in the mode string:

For both of these cases, the markup for the open() is :meth:`open()` but it links to the builtins open(), which I see is an alias of io.open() so maybe it doesn't matter?
Another question is why do only these two instances use :meth: while the other instances in the file use :func: (some refer directly to builtins open() so its understandable, but not all instances)
I'm wondering if the above two should be left alone or changed to :meth:`~io.open` or even :func:`open`
History
Date User Action Args
2022-02-14 15:49:15meersurisetrecipients: + meersuri, eric.araujo, docs@python, ethan.furman, python-dev, zach.ware, JelleZijlstra, mdk, Dutcho, AlexWaygood
2022-02-14 15:49:15meersurisetmessageid: <1644853755.41.0.843148674876.issue46586@roundup.psfhosted.org>
2022-02-14 15:49:15meersurilinkissue46586 messages
2022-02-14 15:49:15meersuricreate