Commit graph

27778 commits

Author SHA1 Message Date
Miss Islington (bot)
13565f1580
[3.12] gh-108951: Document how to terminate an asyncio.TaskGroup (GH-123837) (#123957)
gh-108951: Document how to terminate an asyncio.TaskGroup (GH-123837)

We don't want to add another API, since the recipe is straightforward and rarely needed.

The advantage is that we could backport this to the earliest Python version that has taskgroups (3.11, alas in security mode already, so we'll just do 3.12 and 3.13).
(cherry picked from commit ef05801ba0)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-09-25 20:40:05 +05:30
Miss Islington (bot)
cf06f5905f
[3.12] gh-123445: calendar: Improve descriptions for day and month attributes (GH-123483) (#124501)
gh-123445: calendar: Improve descriptions for day and month attributes (GH-123483)
(cherry picked from commit 8447c933da)

Co-authored-by: Mat S <mscull@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Eric V. Smith <ericvsmith@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-25 09:31:17 +00:00
Miss Islington (bot)
10cf0b8caf
[3.12] GH-87358: Add clarification about nargs and default argparse behaviour (GH-124094) (#124441)
Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>
2024-09-24 20:15:21 +03:00
Miss Islington (bot)
0c36c37841
[3.12] gh-124120: Document Annotated.__origin__ (GH-124125) (#124417)
gh-124120: Document `Annotated.__origin__` (GH-124125)
(cherry picked from commit faef3fa653)

Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-24 13:52:27 +00:00
Miss Islington (bot)
ed44377220
[3.12] gh-65169: Clarify prog default in argparse (GH-31602) (GH-124431)
(cherry picked from commit e69ff34e81)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2024-09-24 14:19:53 +03:00
Miss Islington (bot)
d26d0a10b1
[3.12] Docs: Update two FAQs for Python 3 (GH-124247) (GH-124256)
(cherry picked from commit 5f01111594)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-09-24 09:42:00 +03:00
Alex Waygood
4b221bf878
[3.12] Bump Ruff to 0.6.7 (#124384) (#124391) 2024-09-23 23:09:27 +00:00
Miss Islington (bot)
db48e8f84d
[3.12] Doc: Add `make dist-no-html` (GH-124383) (#124388) 2024-09-23 23:19:18 +01:00
Adam Turner
62dcb8e013
[3.12] GH-109975: Copyedit 3.13 What's New: Copyedit C API deprecations pending removal (GH-124336) (#124365)
(cherry picked from commit e7d465a607)
2024-09-23 19:31:28 +00:00
Savannah Ostrowski
b3709562ad
[3.12] GH-79714: Add mention of stderr for clarity to ArgumentParser.exit() (GH-123932) (GH-124356)
(cherry picked from commit 5f5c0b9c23)
2024-09-23 19:04:36 +00:00
Miss Islington (bot)
dd2066f274
[3.12] Replace the term Immutable with a Hashable in the sequence entry of the Glossary (GH-124350) (#124353)
Replace the term `Immutable` with a `Hashable` in the `sequence` entry of the Glossary (GH-124350)

The term `Immutable` in the `sequence` entry of the glossary is used incorrectly, in fact dicts accepts hashable keys, which is not the same as immutable.
(cherry picked from commit 6203ef35dd)

Co-authored-by: decorator-factory <42166884+decorator-factory@users.noreply.github.com>
2024-09-23 16:41:01 +00:00
Miss Islington (bot)
533b06c118
[3.12] Fix doctrees directory for the gettext builder (GH-122997) (#124339)
Fix doctrees directory for the gettext builder (GH-122997)
(cherry picked from commit 315a933a5b)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-23 14:37:10 +00:00
Miss Islington (bot)
d5aafe7713
[3.12] gh-124130: Notes on empty string corner case of category \B (GH-124133) (#124329)
gh-124130: Notes on empty string corner case of category `\B` (GH-124133)
(cherry picked from commit d3e79d75d1)

Signed-off-by: y5c4l3 <y5c4l3@proton.me>
Co-authored-by: Y5 <124019959+y5c4l3@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-09-23 07:05:24 +00:00
Miss Islington (bot)
8606a2e91c
[3.12] Fix typo in XMLParser doc (GH-124129) (#124281)
Fix typo in XMLParser doc (GH-124129)
(cherry picked from commit 622368d99c)

Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
2024-09-20 10:51:12 +00:00
Miss Islington (bot)
2216c52828
[3.12] Fix make htmllive target (GH-124222)
Allow `make -C Doc htmllive` to work without manual venv activation

Set PATH to ensure that `sphinx-autobuild` can find `sphinx-build`.

(cherry picked from commit 9a6e2336e4)

Authored-by: Zachary Ware <zach@python.org>
2024-09-18 16:12:17 -05:00
Miss Islington (bot)
5827be86fe
[3.12] gh-124194: Fix wrong issue number in What's New in Python 3.8 (GH-124195) (#124198)
gh-124194: Fix wrong issue number in What's New in Python 3.8 (GH-124195)
(cherry picked from commit d8c0fe1944)

Co-authored-by: Bradley Reynolds <bradley.reynolds@darbia.dev>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-09-18 00:58:10 +00:00
Miss Islington (bot)
6840b611de
[3.12] GH-103484: Fix broken links reported by linkcheck (GH-124169) (#124180)
GH-103484: Fix broken links reported by linkcheck (GH-124169)
(cherry picked from commit ab80c6b402)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-17 15:19:07 +00:00
Miss Islington (bot)
a032a96a92
[3.12] Use pep role instead of url (GH-121611) (#124173)
Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-17 13:08:38 +00:00
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