Many references to unsupported Python versions in the stdlib docs #92417

AlexWaygood · 2022-05-07T11:43:34Z

Documentation

There are currently many places in the stdlib docs where there are needless comments about how to maintain compatibility with Python versions that are now end-of-life. Many of these can now be removed, to improve brevity and clarity in the documentation.

I plan to submit a number of PRs to fix these.

PRs:

Backports:

…an be used in all supported Python versions

…upported Python versions python#92417

python#92417

…n versions

…rences Given that 2.7 has now been end-of-life for two and a half years, I don't think we need such a detailed explanation here anymore of the differences between Python 2 and Python 3. python#92417

…thon versions

…ython <3.2 python#92417

…used in all supported Python versions (GH-92418)

…an be used in all supported Python versions (pythonGH-92418) (cherry picked from commit e5b4bd4) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…ed Python versions (GH-92419)

…upported Python versions (pythonGH-92419) (cherry picked from commit f4e317b) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…ions (GH-92422)

…n versions (pythonGH-92422) (cherry picked from commit bc098cf) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…DETAIL for Py>=3 (pythonGH-92502) (cherry picked from commit 97b9c10) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>

… for Py>=3 (GH-92502) (GH-92962) (cherry picked from commit 97b9c10)

… for Py>=3 (GH-92502) (GH-92963) (cherry picked from commit 97b9c10)

… for Py>=3 (GH-92502) (GH-92964) (cherry picked from commit 97b9c10)

…onGH-92544) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…uctor methods (GH-92421) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

…constructor methods (pythonGH-92421) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 090df84) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…Python <3.5 (pythonGH-92538) (cherry picked from commit 84b8600) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

… <3.5 (GH-92538)

…Python <3.5 (pythonGH-92538) (cherry picked from commit 84b8600) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…H-92968) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…H-92969) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…uctor methods (GH-92421) (GH-92970) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 090df84) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…uctor methods (GH-92421) (GH-92971) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> (cherry picked from commit 090df84) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…thon versions (pythonGH-92424) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM> (cherry picked from commit 70aa1b9) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…ersions (GH-92424) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>

… <3.5 (GH-92538) (GH-92973) (cherry picked from commit 84b8600) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

ambv · 2022-05-19T15:50:21Z

I merged everything that was linked here. If all's done, this can be closed.

AlexWaygood · 2022-05-19T15:55:32Z

I merged everything that was linked here. If all's done, this can be closed.

Thank you for the reviews! This is now mostly done, but I think there's a few others left to do, so I'd rather keep it open for now. (I've been busy with other stuff lately.)

… <3.5 (GH-92538) (GH-92972) (cherry picked from commit 84b8600) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…ersions (GH-92424) (GH-92979) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM> (cherry picked from commit 70aa1b9) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…an be used in all supported Python versions (pythonGH-92418) (cherry picked from commit e5b4bd4) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…differences (pythonGH-92423) (pythonGH-92474) Given that 2.7 has now been end-of-life for two and a half years, I don't think we need such a detailed explanation here anymore of the differences between Python 2 and Python 3. (cherry picked from commit 8efda1e) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka

… Python versions (pythonGH-92422) (pythonGH-92466) (cherry picked from commit bc098cf) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Automerge-Triggered-By: GH:serhiy-storchaka

…ython <3.2 (pythonGH-92425) (cherry picked from commit 318c4e9) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

…upported Python versions (pythonGH-92419) (cherry picked from commit f4e317b) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

AlexWaygood added the docs label May 7, 2022

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: typing docs: from __future__ import annotations c…

31cec87

…an be used in all supported Python versions

AlexWaygood mentioned this issue May 7, 2022

gh-92417: typing docs: from __future__ import annotations can be used in all supported Python versions #92418

Merged

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: asyncio docs: asyncio.run() is available on all s…

0074e2c

…upported Python versions python#92417

AlexWaygood mentioned this issue May 7, 2022

gh-92417: asyncio docs: asyncio.run() is available on all supported Python versions #92419

Merged

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: doctest docs: remove references to Python <3.6

155532d

python#92417

AlexWaygood mentioned this issue May 7, 2022

gh-92417: doctest docs: remove references to Python <3.6 #92420

Merged

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: fractions docs: remove references to Python <3.2

453bc8c

python#92417

AlexWaygood mentioned this issue May 7, 2022

gh-92417: fractions, decimal: Improve docs for alternative constructor methods #92421

Merged

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: json docs: dict is ordered on all supported Pytho…

f663ba4

…n versions

AlexWaygood mentioned this issue May 7, 2022

gh-92417: json docs: dict is ordered on all supported Python versions #92422

Merged

AlexWaygood mentioned this issue May 7, 2022

gh-92417: stdtypes docs: delete discussion of Python 2 differences #92423

Merged

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: importlib docs: remove references to unsupported Py…

a92c820

…thon versions

AlexWaygood mentioned this issue May 7, 2022

gh-92417: importlib docs: remove references to unsupported Python versions #92424

Merged

AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022

pythongh-92417: logging docs: Remove warning that only applies to P…

f12b95a

…ython <3.2 python#92417

AlexWaygood mentioned this issue May 7, 2022

gh-92417: logging docs: Remove warning that only applies to Python <3.2 #92425

Merged

rhettinger assigned rhettinger and unassigned rhettinger May 8, 2022

serhiy-storchaka pushed a commit that referenced this issue May 8, 2022

gh-92417: typing docs: from __future__ import annotations can be …

e5b4bd4

…used in all supported Python versions (GH-92418)

serhiy-storchaka pushed a commit that referenced this issue May 8, 2022

gh-92417: asyncio docs: asyncio.run() is available on all support…

f4e317b

…ed Python versions (GH-92419)

serhiy-storchaka pushed a commit that referenced this issue May 8, 2022

gh-92417: json docs: dict is ordered on all supported Python vers…

bc098cf

…ions (GH-92422)

serhiy-storchaka pushed a commit that referenced this issue May 8, 2022

gh-92417: doctest docs: remove references to Python <3.6 (GH-92420)

5639ea1

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL…

54653b5

… for Py>=3 (GH-92502) (GH-92962) (cherry picked from commit 97b9c10)

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL…

4e289e2

… for Py>=3 (GH-92502) (GH-92963) (cherry picked from commit 97b9c10)

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL…

3bc3c89

… for Py>=3 (GH-92502) (GH-92964) (cherry picked from commit 97b9c10)

miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022

pythongh-92417: socket docs: remove references to Python <3.3 (pyth…

32cec36

…onGH-92544) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022

pythongh-92417: socket docs: remove references to Python <3.3 (pyth…

05432d1

…onGH-92544) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: socket docs: remove references to Python <3.3 (GH-92544)

639b62c

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: fractions, decimal: Improve docs for alternative constr…

090df84

…uctor methods (GH-92421) Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: subprocess docs: remove note on compatibility with Python…

84b8600

… <3.5 (GH-92538)

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: socket docs: remove references to Python <3.3 (GH-92544) (G…

a2d6e6c

…H-92968) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: socket docs: remove references to Python <3.3 (GH-92544) (G…

ebf3f12

…H-92969) (cherry picked from commit 639b62c) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: importlib docs: remove references to unsupported Python v…

70aa1b9

…ersions (GH-92424) Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: subprocess docs: remove note on compatibility with Python…

3d47035

… <3.5 (GH-92538) (GH-92973) (cherry picked from commit 84b8600) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

ambv pushed a commit that referenced this issue May 19, 2022

gh-92417: subprocess docs: remove note on compatibility with Python…

de97d82

… <3.5 (GH-92538) (GH-92972) (cherry picked from commit 84b8600) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

AlexWaygood self-assigned this May 20, 2022

hello-adam pushed a commit to hello-adam/cpython that referenced this issue Jun 2, 2022

pythongh-92417: logging docs: Remove warning that only applies to P…

500c718

…ython <3.2 (pythonGH-92425) (cherry picked from commit 318c4e9) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Many references to unsupported Python versions in the stdlib docs #92417

Many references to unsupported Python versions in the stdlib docs #92417

AlexWaygood commented May 7, 2022 •

edited

ambv commented May 19, 2022

AlexWaygood commented May 19, 2022

Many references to unsupported Python versions in the stdlib docs #92417

Many references to unsupported Python versions in the stdlib docs #92417

Comments

AlexWaygood commented May 7, 2022 • edited

ambv commented May 19, 2022

AlexWaygood commented May 19, 2022

AlexWaygood commented May 7, 2022 •

edited