Commit graph

13367 commits

Author SHA1 Message Date
Miss Islington (bot)
b4b182a84d
[3.13] GH-87358: Add clarification about nargs and default argparse behaviour (GH-124094) (#124440)
GH-87358: Add clarification about nargs and default argparse behaviour (GH-124094)
(cherry picked from commit 20ccda000b)

Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>
2024-09-24 11:08:02 -07:00
Miss Islington (bot)
e9b00cc788
[3.13] gh-121607: Edited source file import recipe to make it more clear (GH-121519) (#124080)
gh-121607: Edited source file import recipe to make it more clear (GH-121519)
(cherry picked from commit 38809171b8)

Co-authored-by: Chris Barker <Chris.Barker@noaa.gov>
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2024-09-24 01:52:45 +00:00
Miss Islington (bot)
6867604781
[3.13] GH-103484: Fix permanently redirects reported by linkcheck (GH-124144) (#124151)
GH-103484: Fix permanently redirects reported by linkcheck (GH-124144)

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-24 00:43:04 +00:00
Miss Islington (bot)
5fa7f5a734
[3.13] gh-118577: Clarify that inspect.BoundArguments prefers to put values in args (GH-119936) (#124005)
gh-118577: Clarify that inspect.BoundArguments prefers to put values in args (GH-119936)
(cherry picked from commit 8e99495701)

Co-authored-by: Nice Zombies <nineteendo19d0@gmail.com>
2024-09-23 17:35:29 -07:00
Miss Islington (bot)
9a60a9ddaf
[3.13] gh-116622: Complete Android documentation (GH-124259) (#124395)
gh-116622: Complete Android documentation (GH-124259)
(cherry picked from commit e80dd3035f)

Co-authored-by: Malcolm Smith <smith@chaquo.com>
Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
Co-authored-by: T. Wouters <thomas@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-09-24 00:13:45 +00:00
Miss Islington (bot)
74edb7d9bc
[3.13] GH-103484: Fix broken links reported by linkcheck (GH-124169) (#124179)
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-23 16:34:48 -07:00
Miss Islington (bot)
848a21007b
[3.13] Fix typo in XMLParser doc (GH-124129) (#124280)
Fix typo in XMLParser doc (GH-124129)
(cherry picked from commit 622368d99c)

Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
2024-09-23 15:53:10 -07:00
Miss Islington (bot)
5760330c7a
[3.13] gh-124130: Notes on empty string corner case of category \B (GH-124133) (#124328)
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 15:50:54 -07:00
Miss Islington (bot)
a052faf58e
[3.13] GH-79714: Add mention of stderr for clarity to ArgumentParser.exit() (GH-123932) (#124331)
GH-79714: Add mention of stderr for clarity to ArgumentParser.exit() (GH-123932)
(cherry picked from commit 5f5c0b9c23)

Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>
2024-09-23 15:50:24 -07:00
Miss Islington (bot)
8d5911ef6b
[3.13] Use pep role instead of url (GH-121611) (#124172)
Use pep role instead of url (GH-121611)
(cherry picked from commit 33eeccf6d4)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2024-09-23 11:39:16 -07:00
Miss Islington (bot)
bbec2ea88f
[3.13] Fix "The Matrix" movie release year in typing.rst (GH-123965) (#123966)
Fix "The Matrix" movie release year in `typing.rst` (GH-123965)
(cherry picked from commit 3bd942f106)

Co-authored-by: sobolevn <mail@sobolevn.me>
2024-09-23 11:34:44 -07:00
Adam Turner
86f30dd539
[3.13] GH-109975: Copyedit 3.13 What's New: C API (GH-124313) (#124334)
* [3.13] GH-109975: Copyedit 3.13 What's New: C API (GH-124313)
(cherry picked from commit 9d0a75269c)

* gh-118915: Add/fix docs entries for some new 3.13 C API (GH-124134)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-09-23 11:14:13 -07:00
Miss Islington (bot)
6d482ff296
[3.13] Normalize cdecl formatting as found elsewhere on ctypes.rst (GH-121379) (#124056)
Normalize cdecl formatting as found elsewhere on ctypes.rst (GH-121379)
(cherry picked from commit bbb36c0934)

Co-authored-by: utkonos <utkonos@users.noreply.github.com>
2024-09-23 10:53:07 -07:00
Miss Islington (bot)
e62cb77c25
[3.13] gh-123523: Rework typing documentation for generators and coroutines, and link to it from collections.abc docs (GH-123544) (#123790)
gh-123523: Rework typing documentation for generators and coroutines, and link to it from `collections.abc` docs (GH-123544)
(cherry picked from commit 56e4a417ce)

Co-authored-by: Stanislav Terliakov <50529348+sterliakov@users.noreply.github.com>
2024-09-06 22:56:37 +02:00
Miss Islington (bot)
c46ad20d41
[3.13] gh-123207: Clarify the documentation for the mro lookup for super() (GH-123417) (#123732)
(cherry picked from commit 327463aef1)

Co-authored-by: Pieter Eendebak <pieter.eendebak@gmail.com>
2024-09-06 15:45:22 +02:00
Miss Islington (bot)
37e1f8d2a0
[3.13] gh-103066: Add links and help in site.py constants (GH-103777) (#123762)
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:29 +03:00
Miss Islington (bot)
ff9ece98e2
[3.13] gh-85453: Improve instance attributes mark up on datetime.rst (GH-123655) (#123740)
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:16:48 +00:00
Miss Islington (bot)
3765181359
[3.13] gh-123392: Clarify wording regarding parameters that are functions to be called (GH-123394) (GH-123664)
(cherry picked from commit c08ede2714)

Co-authored-by: ryan-duve <ryan-duve@users.noreply.github.com>
2024-09-05 12:49:51 +02:00
Miss Islington (bot)
3b37658646
[3.13] gh-118508: Clarify which characters are matched by \s (GH-119155) (#123670)
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:14 -07:00
Wei-Hsiang (Matt) Wang
05dcc81601
[3.13] gh-123517: Remove unnecessary :meth: parentheses (gh-123518) (GH-123577) 2024-09-02 16:00:04 +02:00
Miss Islington (bot)
ec92c8a018
[3.13] gh-123570: Add link to weakref.ref from weakref_slot docs in dataclasses (GH-123571) (#123594)
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 13:20:35 +02:00
Wulian
5c408e333d
[3.13] Fix typos in docs and what's new (#123451) 2024-09-02 13:15:02 +02:00
Miss Islington (bot)
aca65112fe
[3.13] GH-117759: Document incremental GC (GH-123266) (#123395)
GH-117759: Document incremental GC (GH-123266)

* Update what's new

* Update gc module docs and fix inconsistency in gc.get_objects
(cherry picked from commit f49a91648a)

Co-authored-by: Mark Shannon <mark@hotpy.org>
2024-09-02 13:12:16 +02:00
Miss Islington (bot)
d9e4c4b61c
[3.13] gh-123213: Fixed xml.etree.ElementTree.Element.extend and assignment to no longer hide exceptions (GH-123214) (#123257)
gh-123213: Fixed xml.etree.ElementTree.Element.extend and assignment to no longer hide exceptions (GH-123214)
(cherry picked from commit 90b6d0e0f8)

Co-authored-by: Bar Harel <bharel@barharel.com>
2024-09-02 13:10:09 +02:00
Alex Waygood
3455d8560a
[3.13] Fix typos in docs, error messages and comments (#122502) (#122606)
Fix typos in docs, error messages and comments (#122502)

(cherry-picked from commit 46f5a4f9e1)

Signed-off-by: jianghuyiyuan <shuangcui@live.com>
Co-authored-by: jianghuyiyuan <shuangcui@live.com>
2024-09-02 12:44:42 +02:00
Miss Islington (bot)
cfdf376e2a
[3.13] gh-91126: Docs and tests for slotted dataclasses with __init_subclass__ (GH-123342) (#123568)
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 18:19:56 +03:00
Miss Islington (bot)
b0a50a69cf
[3.13] gh-123550: Fix code snippet of BUILD_TUPLE in dis docs (GH-123551) (#123555) 2024-09-01 08:38:20 +01:00
Miss Islington (bot)
dc06b3d01e
[3.13] gh-123494: Improve documentation for `webbrowser` return types (GH-123495) (#123548)
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:41:10 +00:00
Wei-Hsiang (Matt) Wang
9f5f2b7128
[3.13] gh-123492: Remove unnecessary :func: parentheses (gh-123493) (#123513) 2024-08-30 20:14:48 +03:00
Miss Islington (bot)
eec25e5d47
[3.13] gh-101860: document property.__name__ (GH-123399) (#123428)
(cherry picked from commit 40fff90ae3)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-08-29 09:55:56 -07:00
Miss Islington (bot)
4817365581
[3.13] gh-82378: Document the difference between sys.tracebacklimit and the limit arguments (GH-123286) (#123325)
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 23:08:51 +00:00
Miss Islington (bot)
abaaaff328
[3.13] gh-122982: Extend the deprecation period for bool inversion by two years (GH-123306) (#123316)
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:48:34 +00:00
Adam Turner
6587900f22
[3.13] GH-109975: Copyedit 3.13 What's New: Improved Modules (GH-123132) (#123292)
(cherry picked from commit 127660bcdb)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-08-24 19:31:31 +00:00
Miss Islington (bot)
cf444d8515
[3.13] gh-123110: correct note about _Bool in the struct module docs (GH-123111) (#123126)
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:00:54 +05:30
Miss Islington (bot)
8d95102447
[3.13] fix typo in dis.rst (GH-121612) (#123095)
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 09:11:33 +00:00
Miss Islington (bot)
2620c1543b
[3.13] gh-122519: Adding socket module shutdown() constants description (GH-122543) (#123093)
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:45:25 +00:00
Miss Islington (bot)
79452b135c
[3.13] gh-123005: Add version added in enum.Flag.__len__ (GH-123007) (#123026)
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 21:31:19 +00:00
Miss Islington (bot)
ee9818bdbb
[3.13] Docs: Standardise versionchanged text in weakref.rst (GH-122898) (#122911)
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:57:19 +00:00
Miss Islington (bot)
7ca389cb54
[3.13] GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887) (#122895)
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 21:41:14 +00:00
Miss Islington (bot)
bcce4cc466
[3.13] gh-105376: Restore deprecated logging warn() method (GH-122775) (#122856)
gh-105376: Restore deprecated logging warn() method (GH-122775)

This reverts commit dcc028d924 and
commit 6c54e5d721.

Keep the deprecated logging warn() method in Python 3.13.

(cherry picked from commit d3239976a8)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-09 17:15:30 +02:00
Miss Islington (bot)
406f924dda
[3.13] gh-121874: Define audit-event open parameters consistently (GH-121883) (#121956)
Co-authored-by: Bernhard M. Wiedemann <bwiedemann@suse.de>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-09 14:35:49 +00:00
Miss Islington (bot)
bc8368e9d0
[3.13] Docs: Change remove to removes for consistency (GH-121072) (#122790)
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:18:08 +00:00
Miss Islington (bot)
24d15f0cb0
[3.13] gh-121103: Update site module docs for free-threaded installs (GH-122737) (#122750)
gh-121103: Update site module docs for free-threaded installs (GH-122737)
(cherry picked from commit 1429651a06)

Co-authored-by: Sam Gross <colesbury@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-08-06 18:57:02 +00:00
Miss Islington (bot)
4aaa4259b5
[3.13] gh-121650: Encode newlines in headers, and verify headers are sound (GH-122233) (#122484)
gh-121650: Encode newlines in headers, and verify headers are sound (GH-122233)

GH-GH- Encode header parts that contain newlines

Per RFC 2047:

> [...] these encoding schemes allow the
> encoding of arbitrary octet values, mail readers that implement this
> decoding should also ensure that display of the decoded data on the
> recipient's terminal will not cause unwanted side-effects

It seems that the "quoted-word" scheme is a valid way to include
a newline character in a header value, just like we already allow
undecodable bytes or control characters.
They do need to be properly quoted when serialized to text, though.

GH-GH- Verify that email headers are well-formed

This should fail for custom fold() implementations that aren't careful
about newlines.

(cherry picked from commit 0976339818)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Bas Bloemsaat <bas@bloemsaat.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-08-06 19:06:41 +02:00
Miss Islington (bot)
725a9cd10b
[3.13] gh-121367: [doc] BUILD_TUPLE arg can be 0 (GH-122663) (#122683)
gh-121367: [doc] BUILD_TUPLE arg can be 0 (GH-122663)
(cherry picked from commit 1422500d02)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2024-08-05 09:37:16 +00:00
Miss Islington (bot)
b1e95d6863
[3.13] Doc: Grammar fix in `library/ssl.rst`, 'Verifying certificates' (GH-122646) (#122649)
Doc: Grammar fix in ``library/ssl.rst``, 'Verifying certificates' (GH-122646)
(cherry picked from commit 06eb9701a1)

Co-authored-by: scottwoodall <scott.woodall@gmail.com>
2024-08-03 13:41:49 +00:00
Miss Islington (bot)
4dfae05f88
[3.13] Doc: Improve wording of `os.path.commonpath()` (GH-122627) (#122641)
Doc: Improve wording of ``os.path.commonpath()`` (GH-122627)
(cherry picked from commit 7a5c4103b0)

Co-authored-by: Matth-M <93771840+Matth-M@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-08-03 14:25:26 +01:00
Miss Islington (bot)
56435a88c4
[3.13] gh-121723: Relax constraints on queue objects for logging.handlers.QueueHandler. (GH-122154) (GH-122603)
(cherry picked from commit fb864c76cd)
2024-08-02 13:07:27 +01:00
Miss Islington (bot)
a4c7eb54bd
[3.13] gh-105733: Soft-deprecate ctypes.ARRAY, rather than hard-deprecating it. (GH-122281) (GH-122440)
gh-105733: Soft-deprecate ctypes.ARRAY, rather than hard-deprecating it. (GH-122281)

Soft-deprecate ctypes.ARRAY, rather than hard-deprecating it.

Partially reverts 2211454fe2
(cherry picked from commit 3833d27f98)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-07-30 08:05:09 +00:00
Pablo Galindo Salgado
c8f3c1daa4
[3.13] gh-122300: Preserve AST nodes for format specifiers with single elements (GH-122308) (#122364)
(cherry picked from commit db2d8b6db1)
2024-07-27 19:27:01 +00:00