Commit graph

29120 commits

Author SHA1 Message Date
Spider84pr
e5bbcb1605
[3.13] gh-138556: Fix old link in gc docs (#138596) 2025-09-07 10:53:56 +03:00
Adam Turner
e7bb98a173
[3.13] GH-138465: Improve documentation for common sequence methods (GH-138474) (#138567)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-09-05 21:39:32 +00:00
Miss Islington (bot)
bb64bc357f
[3.13] gh-137985: Correct description of Formatter's datefmt param in logging documentation (GH-138530) (GH-138566)
(cherry picked from commit 8368895049)
Co-authored-by: W. H. Wang <mattwang44@gmail.com>
2025-09-05 22:32:49 +01:00
Miss Islington (bot)
4e25f012e7
[3.13] gh-138307: Update the Ellipsis documentation (GH-138306) (#138439)
(cherry picked from commit 88665de120)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2025-09-05 13:47:19 -07:00
Miss Islington (bot)
08e9794517
[3.13] Docs: Fix typo in os.fwalk() example (GH-138486) (GH-138501)
Docs: Fix typo in `os.fwalk()` example (GH-138486)
(cherry picked from commit 849a80ec41)

Co-authored-by: William Andrea <22385371+wjandrea@users.noreply.github.com>
2025-09-04 12:39:58 +00:00
Miss Islington (bot)
0dcff3d9ce
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.10.rst (GH-138408) (#138481)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-03 21:05:16 +00:00
Miss Islington (bot)
b8f9b6bc23
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.5.rst (GH-138412) (#138460)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 20:58:54 +00:00
Miss Islington (bot)
a62b59a96e
[3.13] Fix Windows path in venv docs (GH-138478)
(cherry picked from commit f8d9cb1407)
2025-09-03 20:22:05 +00:00
Adam Turner
23bc77b4e2
[3.13] GH-101100: Resolve reference warnings in using/windows.rst (#138416) (#138463)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-03 17:12:51 +00:00
Miss Islington (bot)
1ca2a4d54d
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.4.rst (GH-138413) (#138444)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 15:47:22 +00:00
Miss Islington (bot)
4ee0ef9b59
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.6.rst (GH-138411) (#138456)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 15:28:22 +00:00
Miss Islington (bot)
50048aaddb
[3.13] GH-101100: Resolve reference warnings in extending/extending.rst (GH-138417) (#138447)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-03 16:15:33 +03:00
Miss Islington (bot)
1943877c66
[3.13] GH-101100: Resolve reference warnings in whatsnew/2.7.rst (GH-138415) (#138442)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 11:42:23 +00:00
Miss Islington (bot)
45e5ee46a1
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.8.rst (GH-138409) (#138438)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-09-03 11:32:17 +00:00
Miss Islington (bot)
005c43a249
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.3.rst (GH-138414) (#138436)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-03 11:28:33 +00:00
Miss Islington (bot)
154ec76def
[3.13] GH-101100: Resolve reference warnings in whatsnew/3.7.rst (GH-138410) (#138424)
GH-101100: Resolve reference warnings in whatsnew/3.7.rst (GH-138410)

Resolve reference warnings in whatsnew/3.7.rst
(cherry picked from commit dd86fb4ba5)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-03 06:27:17 +00:00
Miss Islington (bot)
01d95d4b0f
[3.13] gh-101100: Resolve reference warnings in library/xml.sax.handler.rst (GH-136612) (#138422)
Co-authored-by: Weilin Du <108666168+LamentXU123@users.noreply.github.com>
2025-09-03 00:43:18 +00:00
Miss Islington (bot)
3a2e436dc5
[3.13] Doc: Track file downloads via plausible (GH-138393) (#138397)
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-09-02 23:00:17 +03:00
Miss Islington (bot)
f88bf2ce0d
[3.13] gh-138297 Point link in docs for finally to try/else, instead of if/else (GH-138298) (#138382)
Co-authored-by: James Parrott <80779630+JamesParrott@users.noreply.github.com>
Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-09-02 15:10:30 +00:00
Miss Islington (bot)
406a81fc32
[3.13] gh-89905: Correct -R option doc (GH-137608) (#138354)
gh-89905: Correct `-R` option doc (GH-137608)
(cherry picked from commit b3ff3165d2)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-09-01 18:05:26 +00:00
Miss Islington (bot)
76aa2abdef
[3.13] gh-54874: Expand unicodedata module documentation (GH-138301) (#138345)
* gh-54874: Expand unicodedata module documentation (GH-138301)

Closes GH-54874
(cherry picked from commit 0d383f86ee)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>

* Changes links to UCD 15.0.0

---------

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
2025-09-01 18:18:57 +02:00
Miss Islington (bot)
aebf072a52
[3.13] gh-138295: Fix a grammar issue in the descriptor HOWTO (GH-138296) (GH-138300)
gh-138295: Fix a grammar issue in the descriptor HOWTO (GH-138296)

"an str" -> "a str"
(cherry picked from commit 552cf86b83)

Co-authored-by: Fangyi Zhou <me@fangyi.io>
2025-08-31 15:59:22 +00:00
Miss Islington (bot)
6d2958583e
[3.13] gh-133829: Remove some specifics from the `zipimport` example (GH-133835) (#138273)
Co-authored-by: R Chintan Meher <meherrihaan@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-08-31 00:59:47 +00:00
Miss Islington (bot)
e93cacb8cf
[3.13] gh-123858: Improve Doc: SyntaxWarning is emitted during bytecode generation (gh-138243)
---------
(cherry picked from commit 5f7906715a)

Co-authored-by: Hang <bebound@gmail.com>
Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
2025-08-30 00:35:17 +10:00
Miss Islington (bot)
d6a346055b
[3.13] Docs: Fix typo in shutil.make_archive example (GH-138188) (GH-138196)
Docs: Fix typo in `shutil.make_archive` example (GH-138188)
(cherry picked from commit f733e428f8)

Co-authored-by: Andreas Pelme <andreas@pelme.se>
2025-08-27 16:03:28 +00:00
Miss Islington (bot)
d6f7c615c0
[3.13] gh-106318: Add example for str.find() (GH-134529) (#138175)
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-08-27 06:49:19 +00:00
Miss Islington (bot)
238a1ca713
[3.13] gh-137740: Clarify __del__ invocation mechanism in reference counting (GH-137741) (#138112)
gh-137740: Clarify `__del__` invocation mechanism in reference counting (GH-137741)
(cherry picked from commit 90b932e650)

Co-authored-by: Robin Narsingh Ranabhat <robinnarsingha123@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-08-26 23:43:42 +05:30
Miss Islington (bot)
0a72696f45
[3.13] enhance docs for critical sections (GH-137334) (#138168)
enhance docs for critical sections (GH-137334)
(cherry picked from commit 5ae8b97f6b)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-08-26 17:26:09 +00:00
Miss Islington (bot)
31eb3ef569
[3.13] gh-138148: Fix grammatical error in the asynchronous generator iterator term (GH-138155) (GH-138160)
gh-138148: Fix grammatical error in the `asynchronous generator iterator` term (GH-138155)
(cherry picked from commit 43b113d23d)

Co-authored-by: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>
2025-08-26 11:20:32 +00:00
Serhiy Storchaka
bad7bc49f1
[3.13] gh-137609: Update signatures of builtins in the documentation (GH-137610) (GH-138138)
Show signatures that match the actual signatures or future multisignatures
for all functions, classes and methods in the "builtins" module.
(cherry picked from commit 65fb4d11a0)
2025-08-25 12:40:09 +00:00
🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко)
f75fc9a780
[3.13] Lint: Create a project-wide `.ruff.toml` settings file (GH-133124) (#137670)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-08-25 14:38:16 +03:00
Serhiy Storchaka
59068dfcf4
[3.13] gh-137986: Fix and improve the csv functions docstrings (GH-137987) (GH-138108)
The csv.register_dialect() docstring no longer imply that it returns a
dialect.
All functions have now signatures.
(cherry picked from commit aa1dbd4dde)

Co-authored-by: maurycy <5383+maurycy@users.noreply.github.com>
2025-08-24 08:37:41 +00:00
Bénédikt Tran
3afc263c41
[3.13] gh-136134: imaplib: fix CRAM-MD5 on FIPS-only environments (GH-136615) (#138055)
(cherry picked from commit 4519b8acb5)
2025-08-23 13:01:36 +02:00
Miss Islington (bot)
57b5baf3f9
[3.13] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) (#138076)
gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082)

Specifically, clarify that ZipInfo.date_time pulls the datetime information from the central directory, and that times are interpreted as local time.
(cherry picked from commit 282e88506b)

Co-authored-by: Kentaro Jay Takahashi <64148935+KentaroJay@users.noreply.github.com>
Co-authored-by: Emma Smith <emma@emmatyping.dev>
2025-08-22 17:01:37 -07:00
Miss Islington (bot)
2aeae241ca
[3.13] gh-91116: Add hyperlink from sys.settrace to frame objects (GH-138062) (GH-138069)
gh-91116: Add hyperlink from `sys.settrace` to frame objects (GH-138062)
(cherry picked from commit f278afcabf)

Co-authored-by: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>
2025-08-22 14:25:55 -04:00
Miss Islington (bot)
a73515e747
[3.13] gh-137973: Add a non-parallel test plan to the iOS testbed project (GH-138018) (#138039)
Modifies the iOS testbed project to add a test plan. This simplifies the iOS
test runner, as we can now use the built-in log streaming to see test results.
It also allows for some other affordances, like providing a default LLDB config,
and using a standardized mechanism for specifying test arguments.
(cherry picked from commit 2ba2287b85)

Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
2025-08-22 14:30:58 +08:00
Miss Islington (bot)
6587786270
[3.13] gh-138011: Clarify tutorial method object example code (GH-138014) (#138026)
x must be a MyClass instance for examples to work.

---------

(cherry picked from commit 339f5da639)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2025-08-21 12:40:15 -04:00
Miss Islington (bot)
47b1c5d74e
[3.13] gh-137900: Improve dataclasses frozen parameter documentation (GH-137937) (#137991)
gh-137900: Improve dataclasses frozen parameter documentation (GH-137937)
(cherry picked from commit 7685b8ada8)

Co-authored-by: Tangyuan <47830915@qq.com>
2025-08-20 13:15:39 +00:00
Miss Islington (bot)
422a317657
[3.13] Fix typo in logging docs (GH-137981) (GH-137984)
Fix typo in `logging` docs (GH-137981)
(cherry picked from commit 9b5235b62e)

Co-authored-by: Maximilian Linhoff <maximilian.linhoff@cta-observatory.org>
2025-08-20 11:13:53 +00:00
Serhiy Storchaka
511b37a602
[3.13] Update the dbm documentation (GH-137919) (GH-137963)
Unify documentation for all backends, enumerate all not implemented mapping
methods, document particularities of implemented mapping methods.
(cherry picked from commit 8700404f86)
2025-08-19 20:39:08 +03:00
Miss Islington (bot)
8aabea7a0e
[3.13] [docs] fix grammar in ssl.SSLContect.sslsocket_class docs (GH-137935) (#137951)
[docs] fix grammar in ssl.SSLContect.sslsocket_class docs (GH-137935)

---------
(cherry picked from commit 379161dd51)

Co-authored-by: PrinceNaroliya <naroliyaprince@gmail.com>
Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>
2025-08-19 14:22:42 +02:00
Miss Islington (bot)
8ce1698ebf
[3.13] gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio (GH-137859) (#137907)
Co-authored-by: Bar Harel <bzvi7919@gmail.com>
2025-08-19 14:27:30 +03:00
Miss Islington (bot)
d1882577a3
[3.13] gh-44538: Mention nested classes/functions in doctest docs (GH-137870) (GH-137917)
gh-44538: Mention nested classes/functions in doctest docs (GH-137870)
(cherry picked from commit 138ed6db9f)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
2025-08-18 15:05:12 +00:00
Miss Islington (bot)
1a10c47fae
[3.13] gh-135862: add C contiguous one-dimensional buffer requirement to asyncio.StreamWriter docs (GH-137910) (#137913)
gh-135862: add C contiguous one-dimensional buffer requirement to `asyncio.StreamWriter` docs (GH-137910)
(cherry picked from commit 1c3950abc1)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-08-18 13:13:19 +00:00
Adam Turner
135e8343a4
[3.13] gh-131885: Use positional-only markers for the `decimal` module (GH-131990) (#137904)
Co-authored-by: Semyon Moroz <donbarbos@proton.me>
2025-08-18 11:59:24 +00:00
Gregory P. Smith
9face218e7
[3.13] gh-87135: Hang non-main threads that attempt to acquire the GIL during finalization (GH-105805) (GH-137827)
* [3.13] gh-87135: Hang non-main threads that attempt to acquire the GIL during finalization (GH-105805)

Instead of surprise crashes and memory corruption, we now hang threads that attempt to re-enter the Python interpreter after Python runtime finalization has started. These are typically daemon threads (our long standing mis-feature) but could also be threads spawned by extension modules that then try to call into Python. This marks the `PyThread_exit_thread` public C API as deprecated as there is no plausible safe way to accomplish that on any supported platform in the face of things like C++ code with finalizers anywhere on a thread's stack. Doing this was the least bad option.

(cherry picked from commit 8cc5aa47ee)

Co-authored-by: Jeremy Maitin-Shepard <jeremy@jeremyms.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

* state "3.13.7 and earlier"
* backport: do not add the deprecated marker
* fix Py_IsFinalizing doc ref

---------

Co-authored-by: Jeremy Maitin-Shepard <jeremy@jeremyms.com>
2025-08-17 09:08:14 -07:00
Miss Islington (bot)
133f7bd22b
[3.13] gh-137846: Add missing 'be' to profile doc. (GH-137856) (#137858)
gh-137846: Add missing 'be' to profile doc. (GH-137856)

Insert 'be' into 'will interpreted'.
(cherry picked from commit 3663b2ad54)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2025-08-16 10:56:21 -04:00
Miss Islington (bot)
33a3f5e458
[3.13] gh-90483: fix docs of SubprocessTransport.get_pipe_transport (GH-137852) (#137854)
gh-90483: fix docs of `SubprocessTransport.get_pipe_transport ` (GH-137852)
(cherry picked from commit 038a6e3b95)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-08-16 11:17:55 +00:00
Miss Islington (bot)
7f18b0e45d
[3.13] gh-101359: clarify docs for asyncio.Event.clear (GH-137849) (#137851)
gh-101359: clarify docs for `asyncio.Event.clear` (GH-137849)
(cherry picked from commit 4b2dbe8e0a)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-08-16 16:29:26 +05:30
Miss Islington (bot)
83e4b43626
[3.13] gh-137777: Disband the 'Program Frameworks' chapter (GH-137796) (#137831)
Co-authored-by: rimchoi <hyerimc858@gmail.com>
2025-08-15 17:50:47 +00:00