Commit graph

27760 commits

Author SHA1 Message Date
Miss Islington (bot)
92bc714033
[3.12] GH-103484: Fix permanently redirects reported by linkcheck (GH-124144) (GH-124152)
Fix redirects reported by linkcheck, update docs conf.py checks.
(cherry picked from commit 0a32c6959c)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-16 20:53:46 -07:00
Miss Islington (bot)
1151dd6c73
[3.12] GH-103484: Tell linkcheck to ignore debian manpage redirects (GH-123019) (#124136)
GH-103484: Tell linkcheck to ignore debian manpage redirects (GH-123019)
(cherry picked from commit 1054a755a3)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-16 18:49:14 +00:00
Miss Islington (bot)
f3c1f3d5ff
[3.12] Docs: Drop letter PDF (GH-123912) (#123999)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-16 16:08:02 +03:00
Miss Islington (bot)
c5e11bec91
[3.12] Normalize cdecl formatting as found elsewhere on ctypes.rst (GH-121379) (#124057)
Co-authored-by: utkonos <utkonos@users.noreply.github.com>
2024-09-13 15:33:31 +00:00
Miss Islington (bot)
5c15b1a05a
[3.12] gh-118577: Clarify that inspect.BoundArguments prefers to put values in args (GH-119936) (GH-124004)
(cherry picked from commit 8e99495701)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>
2024-09-12 14:14:42 +02:00
Miss Islington (bot)
c6ae90a63c
[3.12] gh-123905: Update TOML description to include version number (GH-123906) (#123907) 2024-09-10 23:28:36 -07:00
Miss Islington (bot)
9e38723a15
[3.12] Mention curl in contextvars docs (GH-123838) (#123869)
Mention `curl` in `contextvars` docs (GH-123838)
(cherry picked from commit b950831c94)

Co-authored-by: sobolevn <mail@sobolevn.me>
2024-09-09 14:05:44 +00:00
Miss Islington (bot)
77bb146221
[3.12] gh-123789: secrets.randbits returns only non-negative int (GH-123801) (#123831)
gh-123789: `secrets.randbits` returns only non-negative int (GH-123801)
(cherry picked from commit beee91cdcc)

Co-authored-by: Wulian <1055917385@qq.com>
2024-09-08 04:24:08 +00:00
Miss Islington (bot)
ca3ac30d6b
[3.12] Remove excessive backticks in logging doc (GH-123813) (#123817)
Remove excessive backticks in logging doc (GH-123813)
(cherry picked from commit 93050e4614)

Co-authored-by: Wei-Hsiang (Matt) Wang <mattwang44@gmail.com>
2024-09-07 18:19:23 +00:00
Alex Waygood
7e51091481
[3.12] gh-123523: Rework typing documentation for generators and coroutines, and link to it from collections.abc docs (#123544) (#123792)
Co-authored-by: Stanislav Terliakov <50529348+sterliakov@users.noreply.github.com>
2024-09-06 17:06:36 +00:00
Petr Viktorin
74feab2bae
[3.12] gh-120426: Add the glossary term "immortal" (GH-123191) (GH-123491) (#123636)
Add the glossary term "immortal", mark it as an implementation detail

(cherry picked from commit 6754566a51)
(cherry picked from commit 1af74fa652)

(Unlike the original commits, this adds the entire entry.)
2024-09-06 15:46:05 +02:00
Miss Islington (bot)
407505da8e
[3.12] gh-123207: Clarify the documentation for the mro lookup for super() (GH-123417) (#123733)
(cherry picked from commit 327463aef1)

Co-authored-by: Pieter Eendebak <pieter.eendebak@gmail.com>
2024-09-06 15:44:54 +02:00
Miss Islington (bot)
8eef5a80a4
[3.12] gh-123463: Include logging_flow diagram in non-HTML docs (GH-123464) (#123667)
(cherry picked from commit 7d2c2f24da)

Co-authored-by: Alexander Bessman <bessman@users.noreply.github.com>
2024-09-06 15:43:49 +02:00
Petr Viktorin
bc207e85f7
[3.12] gh-102988: Adjust version numbers in versionadded directives (GH-123771) 2024-09-06 11:08:54 +00:00
Petr Viktorin
15068242bd
[3.12] [CVE-2023-27043] gh-102988: Reject malformed addresses in email.parseaddr() (GH-111116) (#123766)
Detect email address parsing errors and return empty tuple to
indicate the parsing error (old API). Add an optional 'strict'
parameter to getaddresses() and parseaddr() functions. Patch by
Thomas Dwyer.

Co-Authored-By: Thomas Dwyer <github@tomd.tel>
(cherry picked from commit 4a153a1d3b)

Co-authored-by: Victor Stinner <vstinner@python.org>
2024-09-06 12:46:16 +02:00
Miss Islington (bot)
747abc00d0
[3.12] gh-123213: Fixed xml.etree.ElementTree.Element.extend and assignment to no longer hide exceptions (GH-123214) (#123258)
Co-authored-by: Bar Harel <bharel@barharel.com>
2024-09-06 11:51:18 +03:00
Miss Islington (bot)
17249f3a8f
[3.12] gh-103066: Add links and help in site.py constants (GH-103777) (#123763)
Co-authored-by: David Caron <dcaron05@gmail.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-06 11:08:32 +03:00
Miss Islington (bot)
b01063dbca
[3.12] Swap the and from in sentence in init_config.rst (GH-120086) (#123743)
Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-05 20:11:25 +00:00
Miss Islington (bot)
6caab08d58
[3.12] gh-85453: Improve instance attributes mark up on datetime.rst (GH-123655) (#123741)
Co-authored-by: edson duarte <eduarte.uatach@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-05 18:05:50 +00:00
Miss Islington (bot)
c3a866c915
[3.12] gh-123392: Clarify wording regarding parameters that are functions to be called (GH-123394) (GH-123665)
(cherry picked from commit c08ede2714)

Co-authored-by: ryan-duve <ryan-duve@users.noreply.github.com>
2024-09-05 12:50:00 +02:00
Miss Islington (bot)
a0c9f51561
[3.12] gh-118508: Clarify which characters are matched by \s (GH-119155) (#123671)
gh-118508: Clarify which characters are matched by `\s` (GH-119155)

Clarify re syntax
(cherry picked from commit 22fdb8cf89)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>
2024-09-04 15:36:39 -07:00
Miss Islington (bot)
c6ee0b3e7b
[3.12] gh-123580: Fix signed_number token in documentation (GH-123582) (GH-123624)
gh-123580: Fix `signed_number` token in documentation (GH-123582)

(cherry picked from commit 9e079c220b)

Co-authored-by: CBerJun <121291537+CBerJun@users.noreply.github.com>
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-09-04 11:19:29 +02:00
Miss Islington (bot)
252ed6da4d
[3.12] gh-123621: Fix datamodel.rst with proper dict notation (GH-123648) (#123654)
gh-123621: Fix `datamodel.rst` with proper `dict` notation (GH-123648)
(cherry picked from commit cfbc841ef3)

Co-authored-by: Lipták Attila (Flash) <113017309+AttilaLiptak@users.noreply.github.com>
2024-09-03 20:00:53 +00:00
Miss Islington (bot)
acb19be799
[3.12] gh-123579: Document exclamation token (GH-123612) (#123638)
(cherry picked from commit 68fe5758bf)

Co-authored-by: Shaygan Hooshyari <sh.hooshyari@gmail.com>
2024-09-03 14:56:19 +00:00
Wei-Hsiang (Matt) Wang
d47d7e1124
[3.12] gh-123517: Remove unnecessary :meth: parentheses (gh-123518) (GH-123576) 2024-09-02 16:02:39 +02:00
Miss Islington (bot)
ae17f9b0d0
[3.12] gh-123570: Add link to weakref.ref from weakref_slot docs in dataclasses (GH-123571) (#123595)
gh-123570: Add link to `weakref.ref` from `weakref_slot` docs in `dataclasses` (GH-123571)
(cherry picked from commit c3ed775899)

Co-authored-by: sobolevn <mail@sobolevn.me>
2024-09-02 07:05:18 +00:00
Miss Islington (bot)
12db938d43
[3.12] gh-91126: Docs and tests for slotted dataclasses with __init_subclass__ (GH-123342) (#123569)
gh-91126: Docs and tests for slotted dataclasses with `__init_subclass__` (GH-123342)
(cherry picked from commit 75e72822a3)

Co-authored-by: sobolevn <mail@sobolevn.me>
2024-09-01 10:44:15 +00:00
Miss Islington (bot)
e3d8ccc89d
[3.12] gh-123550: Fix code snippet of BUILD_TUPLE in dis docs (GH-123551) (#123556) 2024-09-01 08:38:38 +01:00
Miss Islington (bot)
c41c787686
[3.12] gh-123494: Improve documentation for `webbrowser` return types (GH-123495) (#123549)
gh-123494: Improve documentation for ``webbrowser`` return types (GH-123495)

Document the return value for ``webbrowser.open*()``.
(cherry picked from commit 0b6acfee04)

Co-authored-by: Aarni Koskela <akx@iki.fi>
2024-09-01 05:36:18 +00:00
Miss Islington (bot)
5b3fcc04e3
[3.12] gh-123407: Enable translating literal and code blocks (GH-123408) (#123531)
gh-123407: Enable translating literal and code blocks (GH-123408)
(cherry picked from commit 5332d989af)

Co-authored-by: Maciej Olko <maciej.olko@affirm.com>
2024-08-31 06:38:11 +00:00
Wei-Hsiang (Matt) Wang
d5abd02f36
[3.12] gh-123492: Remove unnecessary :func: parentheses (gh-123493) (#123512) 2024-08-30 20:09:55 +03:00
Miss Islington (bot)
248af25fb4
[3.12] gh-123254: Improve tuple C API docs with more info about errors (GH-123255) (#123415)
gh-123254: Improve `tuple` C API docs with more info about errors (GH-123255)
(cherry picked from commit 6f563e364d)

Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2024-08-28 07:37:06 +00:00
Miss Islington (bot)
ffa282cc35
[3.12] gh-82378: Document the difference between sys.tracebacklimit and the limit arguments (GH-123286) (#123326)
gh-82378: Document the difference between sys.tracebacklimit and the limit arguments (GH-123286)
(cherry picked from commit 70bfef52b5)

Co-authored-by: CF Bolz-Tereick <cfbolz@gmx.de>
2024-08-25 22:57:16 +00:00
Miss Islington (bot)
93d4a191ff
[3.12] gh-122982: Extend the deprecation period for bool inversion by two years (GH-123306) (#123317)
gh-122982: Extend the deprecation period for bool inversion by two years (GH-123306)
(cherry picked from commit 249b083ed8)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
2024-08-25 19:40:11 +00:00
Miss Islington (bot)
53a5576ec5
[3.12] Docs: Fix Makefile syntax (GH-123287) (#123289)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-24 18:29:21 +03:00
Miss Islington (bot)
8edfa0b0b4
[3.12] gh-123110: correct note about _Bool in the struct module docs (GH-123111) (#123127)
gh-123110: correct note about _Bool in the struct module docs (GH-123111)
(cherry picked from commit b0f462d4c8)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-08-19 13:01:12 +05:30
Miss Islington (bot)
e9d1bf353c
[3.12] Docs: Run `latexmk` in parallel when creating PDFs (GH-123113) (#123116)
Docs: Run ``latexmk`` in parallel when creating PDFs (GH-123113)
(cherry picked from commit 79c542b5cc)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-17 21:04:34 +00:00
Miss Islington (bot)
b9667e8243
[3.12] fix typo in dis.rst (GH-121612) (#123096)
fix typo in dis.rst (GH-121612)
(cherry picked from commit e9287ea426)

Co-authored-by: mathysEthical <110499907+mathysEthical@users.noreply.github.com>
2024-08-17 14:33:04 +05:30
Miss Islington (bot)
28f37700bc
[3.12] gh-122519: Adding socket module shutdown() constants description (GH-122543) (#123094)
gh-122519: Adding socket module shutdown() constants description (GH-122543)
(cherry picked from commit 8a59deca59)

Co-authored-by: Damien <81557462+Damien-Chen@users.noreply.github.com>
2024-08-17 08:35:50 +00:00
Miss Islington (bot)
9f153a2acf
[3.12] gh-123005: Add version added in enum.Flag.__len__ (GH-123007) (#123025)
gh-123005: Add version added in enum.Flag.__len__ (GH-123007)
(cherry picked from commit 8e2dc7f380)

Co-authored-by: Damien <81557462+Damien-Chen@users.noreply.github.com>
2024-08-14 22:30:44 +01:00
Miss Islington (bot)
cd69085366
[3.12] gh-122944: Fix incorrect prompt strings in the Python Tutorial (GH-122949) (#122955)
gh-122944: Fix incorrect prompt strings in the Python Tutorial (GH-122949)

In the REPL, top level comments are followed by a primary, not secondary prompt.
Fix the places in the in the tutorial that use the latter.
(cherry picked from commit be90648fb2)

Co-authored-by: Damien <81557462+Damien-Chen@users.noreply.github.com>
2024-08-12 18:43:53 +00:00
Miss Islington (bot)
92ad3be09b
[3.12] gh-122701: Fix wording of raw strings/bytes in lexical_analysis.rst (GH-122702) (#122915)
gh-122701: Fix wording of raw strings/bytes in `lexical_analysis.rst` (GH-122702)
(cherry picked from commit ea70439bd2)

Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-11 21:09:13 +00:00
Miss Islington (bot)
18d48052c2
[3.12] Docs: Standardise versionchanged text in weakref.rst (GH-122898) (#122912)
Docs: Standardise versionchanged text in weakref.rst (GH-122898)
(cherry picked from commit db8b83c2b0)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-08-11 20:46:05 +00:00
Miss Islington (bot)
f5009b69e0
[3.12] GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887) (#122896)
GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887)

In the documentation of `PosixPath` and `WindowsPath`, and their `Pure*`
equivalents, use example paths with multiple non-anchor parts.

(cherry picked from commit 363374cf69)

Co-authored-by: Barney Gale <barney.gale@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-10 22:31:59 +01:00
Miss Islington (bot)
d70c39905d
[3.12] gh-122868: Add more lower bounds for sphinxcontrib dependencies (GH-122891) (#122894)
gh-122868: Add more lower bounds for sphinxcontrib dependencies (GH-122891)
(cherry picked from commit 0959142e4d)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-10 20:58:38 +00:00
Miss Islington (bot)
d9444844d7
[3.12] gh-122868: Add lower bounds for sphinxcontrib dependencies (GH-122870) (#122872)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-10 01:33:38 +03:00
Miss Islington (bot)
2e8235302b
[3.12] Docs: Change remove to removes for consistency (GH-121072) (#122791)
Docs: Change `remove` to `removes` for consistency (GH-121072)
(cherry picked from commit 967a4f1d18)

Co-authored-by: smij720 <122238526+smij720@users.noreply.github.com>
2024-08-07 16:06:54 +00:00
Miss Islington (bot)
88f8385741
[3.12] Doc: cmdline.rst: Include -P and -R in usage (GH-122590) (#122784)
Doc: cmdline.rst: Include -P and -R in usage (GH-122590)

* ``-P``: safe path (https://docs.python.org/3/using/cmdline.htmlGH-cmdoption-P)
* ``-R``: hash randomization (https://docs.python.org/3/using/cmdline.htmlGH-cmdoption-R)
(cherry picked from commit c25898d51e)

Co-authored-by: Wim Jeantine-Glenn <hey@wimglenn.com>
2024-08-07 15:11:12 +00:00
Miss Islington (bot)
13c263c444
[3.12] gh-122511: Improve documentation for object identity of mutable/immutable types (GH-122512) (#122779)
gh-122511: Improve documentation for object identity of mutable/immutable types (GH-122512)
(cherry picked from commit 76bdeebef6)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-07 14:56:40 +01:00
Gregory P. Smith
b31764104e
[3.12] gh-119577: Adjust DeprecationWarning when testing element truth values in Element tree (GH-119762) (#120190)
gh-119577: Adjust DeprecationWarning when testing element truth values in ElementTree (GH-119762)

Adjust DeprecationWarning when testing element truth values in
ElementTree, we're planning to go with the more natural True return
rather than a disruptive harder to code around exception raise, and are
deferring the behavior change for a few more releases.

Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
2024-08-06 17:20:06 +00:00