8000 Many references to unsupported Python versions in the stdlib docs · Issue #92417 · python/cpython · GitHub
[go: up one dir, main page]
Skip to content

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

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.

Sign up for GitHub

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

Jump to bottom
Closed
AlexWaygood opened this issue May 7, 2022 · 5 comments
Closed

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

AlexWaygood opened this issue May 7, 2022 · 5 comments
Assignees
@AlexWaygood
Labels
docs Documentation in the Doc dir

Comments

@AlexWaygood
Copy link
Member
AlexWaygood commented May 7, 2022 •
edited
Loading

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:
@AlexWaygood AlexWaygood added the docs Documentation in the Doc dir label May 7, 2022
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: typing docs: from __future__ import annotations c…
31cec87 
…an be used in all supported Python versions
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: asyncio docs: asyncio.run() is available on all s…
0074e2c 
…upported Python versions

python#92417
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: doctest docs: remove references to Python <3.6
155532d 
python#92417
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: fractions docs: remove references to Python <3.2
453bc8c 
python#92417
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: json docs: dict is ordered on all supported Pytho…
f663ba4 
…n versions
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: stdtypes docs: shorten discussion of Python 2 diffe…
8b7c912 
…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
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: importlib docs: remove references to unsupported Py…
a92c820 
…thon versions
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
AlexWaygood added a commit to AlexWaygood/cpython that referenced this issue May 7, 2022
@AlexWaygood
pythongh-92417: logging docs: Remove warning that only applies to P…
f12b95a 
…ython <3.2

python#92417
@AlexWaygood AlexWaygood mentioned this issue May 7, 2022
Merged
@rhettinger rhettinger assigned rhettinger and unassigned rhettinger May 8, 2022
serhiy-storchaka pushed a commit that referenced this issue May 8, 2022
@AlexWaygood
gh-92417: typing docs: from __future__ import annotations can be …
e5b4bd4 
…used in all supported Python versions (GH-92418)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 8, 2022
@AlexWaygood @miss-islington
pythongh-92417: typing docs: from __future__ import annotations c…
ef48d5a 
…an be used in all supported Python versions (pythonGH-92418)

(cherry picked from commit e5b4bd4)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
serhiy-storchaka pushed a commit that referenced this issue May 8, 2022
@AlexWaygood
gh-92417: asyncio docs: asyncio.run() is available on all support…
f4e317b 
…ed Python versions (GH-92419)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 8, 2022
@AlexWaygood @miss-islington
pythongh-92417: asyncio docs: asyncio.run() is available on all s…
68adb91 
…upported Python versions (pythonGH-92419)

(cherry picked from commit f4e317b)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 8, 2022
@AlexWaygood @miss-islington
pythongh-92417: asyncio docs: asyncio.run() is available on all s…
5573ddf 
…upported Python versions (pythonGH-92419)

(cherry picked from commit f4e317b)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
serhiy-storchaka pushed a commit that referenced this issue May 8, 2022
@AlexWaygood
gh-92417: json docs: dict is ordered on all supported Python vers…
bc098cf 
…ions (GH-92422)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 8, 2022
@AlexWaygood @miss-islington
pythongh-92417: json docs: dict is ordered on all supported Pytho…
8f0b0c1 
…n versions (pythonGH-92422)

(cherry picked from commit bc098cf)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 8, 2022
@AlexWaygood @miss-islington
pythongh-92417: json docs: dict is ordered on all supported Pytho…
c39a8fd 
…n versions (pythonGH-92422)

(cherry picked from commit bc098cf)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 8, 2022
@AlexWaygood @miss-islington
pythongh-92417: json docs: dict is ordered on all supported Pytho…
4190e01 
…n versions (pythonGH-92422)

(cherry picked from commit bc098cf)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
serhiy-storchaka pushed a commit that referenced this issue May 8, 2022
@AlexWaygood
gh-92417: doctest docs: remove references to Python <3.6 (GH-92420)
5639ea1
ambv pushed a commit that referenced this issue May 19, 2022
@miss-islington
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
@miss-islington
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
@AlexWaygood @miss-islington
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
@AlexWaygood @miss-islington
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
@AlexWaygood
gh-92417: socket docs: remove references to Python <3.3 (GH-92544)
639b62c
ambv pushed a commit that referenced this issue May 19, 2022
@AlexWaygood @ezio-melotti
gh-92417: fractions, decimal: Improve docs for alternative constr…
090df84 
…uctor methods (GH-92421)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022
@AlexWaygood @miss-islington
pythongh-92417: fractions, decimal: Improve docs for alternative …
d7c2aab 
…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>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022
@AlexWaygood @miss-islington
pythongh-92417: fractions, decimal: Improve docs for alternative …
52cdb22 
…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>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022
@AlexWaygood @miss-islington
pythongh-92417: subprocess docs: remove note on compatibility with …
8f42268 
…Python <3.5 (pythonGH-92538)

(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
@AlexWaygood
gh-92417: subprocess docs: remove note on compatibility with Python…
84b8600 
… <3.5 (GH-92538)
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022
@AlexWaygood @miss-islington
pythongh-92417: subprocess docs: remove note on compatibility with …
ecbed9a 
…Python <3.5 (pythonGH-92538)

(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
@miss-islington @AlexWaygood
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
@miss-islington @AlexWaygood
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
@miss-islington @AlexWaygood
gh-92417: fractions, decimal: Improve docs for alternative constr…
02fe225 
…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>
ambv pushed a commit that referenced this issue May 19, 2022
@miss-islington @AlexWaygood
gh-92417: fractions, decimal: Improve docs for alternative constr…
93ebac7 
…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>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue May 19, 2022
@AlexWaygood @miss-islington
pythongh-92417: importlib docs: remove references to unsupported Py…
4eedb3a 
…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>
ambv pushed a commit that referenced this issue May 19, 2022
@AlexWaygood @CAM-Gerlach
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
@miss-islington @AlexWaygood
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
Copy link
Contributor
ambv commented May 19, 2022

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

@AlexWaygood
Copy link
Member Author

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.)

ambv pushed a commit that referenced this issue May 19, 2022
@miss-islington @AlexWaygood
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>
ambv pushed a commit that referenced this issue May 19, 2022
@miss-islington @AlexWaygood
gh-92417: importlib docs: remove references to unsupported Python v…
37d60c0 
…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>
@AlexWaygood AlexWaygood self-assigned this May 20, 2022
hello-adam pushed a commit to hello-adam/cpython that referenced this issue Jun 2, 2022
@miss-islington @AlexWaygood @hello-adam
pythongh-92417: typing docs: from __future__ import annotations c…
7bb91b9 
…an be used in all supported Python versions (pythonGH-92418)

(cherry picked from commit e5b4bd4)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
hello-adam pushed a commit to hello-adam/cpython that referenced this issue Jun 2, 2022
@miss-islington @hello-adam
[3.9] pythongh-92417: stdtypes docs: delete discussion of Python 2 …
f3731db 
…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
hello-adam pushed a commit to hello-adam/cpython that referenced this issue Jun 2, 2022
@miss-islington @hello-adam
[3.9] pythongh-92417: json docs: dict is ordered on all supported…
9f39307 
… 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
hello-adam pushed a commit to hello-adam/cpython that referenced this issue Jun 2, 2022
@miss-islington @AlexWaygood @hello-adam
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>
hello-adam pushed a commit to hello-adam/cpython that referenced this issue Jun 2, 2022
@miss-islington @AlexWaygood @hello-adam
pythongh-92417: asyncio docs: asyncio.run() is available on all s…
488a238 
…upported Python versions (pythonGH-92419)

(cherry picked from commit f4e317b)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
@AlexWaygood
Copy link
Member Author

This is basically done at this point, and I ran out of energy to finish the remaining bits that are left to do.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@AlexWaygood AlexWaygood

Labels
docs Documentation in the Doc dir
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
4 participants
@ambv @rhettinger @CAM-Gerlach @AlexWaygood
0