Miss Islington (bot)
3c19c88fa9
[3.14] Hide "object" prefix on dunders in contextlib docs & selectivly link some more (GH-145436) ( #145443 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2026-03-02 21:18:12 +00:00
Miss Islington (bot)
4152bbb773
[3.14] gh-145269: simplify bisect.bisect doc example (GH-145270) ( #145367 )
...
gh-145269: simplify bisect.bisect doc example (GH-145270)
---------
(cherry picked from commit fdb4b3527f )
Co-authored-by: Nathan Goldbaum <nathan.goldbaum@gmail.com>
Co-authored-by: Pieter Eendebak <pieter.eendebak@gmail.com>
2026-02-28 19:28:14 +00:00
Miss Islington (bot)
1e4b4a6ddc
[3.14] gh-144693: Clarify that PyFrame_GetBack does not raise exceptions (GH-144824) (GH-145318)
...
gh-144693: Clarify that `PyFrame_GetBack` does not raise exceptions (GH-144824)
(cherry picked from commit 8775f90017 )
Co-authored-by: Taegyun Kim <k.taegyun@gmail.com>
Co-authored-by: Sergey Miryanov <sergey.miryanov@gmail.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2026-02-27 15:31:19 +00:00
Miss Islington (bot)
bded835b72
[3.14] gh-141004: Document missing type flags (GH-145127) (GH-145316)
...
gh-141004: Document missing type flags (GH-145127)
(cherry picked from commit dc1b56aa03 )
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2026-02-27 15:17:35 +00:00
Miss Islington (bot)
856fdc6f6b
[3.14] gh-144190: Clarify get_type_hints() instance behavior in docs (GH-144831) ( #145258 )
...
Co-authored-by: Rajhans Jadhao <rajhans.jadhao@gmail.com>
2026-02-26 13:53:16 +00:00
Miss Islington (bot)
ea628136c0
[3.14] gh-106318: Add examples for str.rjust() method (GH-143890) ( #145257 )
...
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-02-26 13:48:04 +00:00
Miss Islington (bot)
ff365ebe98
[3.14] GH-145000: Add a tool to record/check removed HTML IDs (GH-145001) (GH-145212)
...
(cherry picked from commit 9b22261a86 )
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-02-26 13:16:50 +01:00
Miss Islington (bot)
310455ca51
[3.14] gh-142518: Move thread safety sections into a new page (GH-144716) ( #145223 )
...
- Create a new page for thread safety notes for built-in types
- Move thread safety notes for `list` into the new page
- Move thread safety notes for `dict` into the new page
---------
(cherry picked from commit 017ccd3bf4 )
Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-25 16:57:32 +01:00
Miss Islington (bot)
6dc03efb82
[3.14] Update Python install manager docs (GH-145160)
...
These updates align with v26.0 that was just released.
(cherry picked from commit da39c68c2f )
Co-authored-by: Steve Dower <steve.dower@python.org>
2026-02-24 15:32:35 +00:00
Savannah Ostrowski
8b34bcc6a7
[3.14] Update argparse suggest_on_error code snippet in docs (GH-144985) ( #145151 )
...
Update argparse `suggest_on_error` code snippet in docs (#144985 )
(cherry picked from commit 6194a552f2 )
2026-02-23 17:35:04 +00:00
Peter Bierma
7fba3cf13d
[3.14] gh-141811: Split up init.rst into multiple pages (GH-144844) (GH-145061)
...
(cherry picked from commit 60f3c396fe )
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Benedikt Johannes <benedikt.johannes.hofer@gmail.com>
2026-02-23 10:38:43 -05:00
Peter Bierma
8e29215e04
[3.14] gh-141004: Document PyModuleDef_Type (GH-145043) (GH-145146)
...
(cherry picked from commit 24cc998c16 )
2026-02-23 15:24:29 +00:00
Miss Islington (bot)
fece40f7bc
[3.14] gh-144694: Fix re.Match.group() doc claiming [1..99] range limit (GH-144696) ( #145065 )
...
gh-144694: Fix re.Match.group() doc claiming [1..99] range limit (GH-144696)
The documentation incorrectly stated that numeric group arguments
must be in the range [1..99]. This limit was removed in Python 3.5
(bpo-22437). Replace with "a positive integer" since the next
sentence already documents the IndexError for out-of-range values.
(cherry picked from commit 85021bc247 )
Co-authored-by: Mohsin Mehmood <55545648+mohsinm-dev@users.noreply.github.com>
2026-02-21 05:42:08 +00:00
Miss Islington (bot)
9ebab55aa2
[3.14] gh-144748: Document 3.12 and 3.14 changes to PyErr_CheckSignals (GH-144982) (GH-145062)
...
gh-144748: Document 3.12 and 3.14 changes to `PyErr_CheckSignals` (GH-144982)
(cherry picked from commit 06292614ff )
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-02-21 00:31:51 +00:00
Miss Islington (bot)
e69501969b
[3.14] Simplify summary tables in the itertools docs (gh-145050) (gh-145051)
2026-02-20 12:52:26 -06:00
Miss Islington (bot)
24b53097d9
[3.14] Remove unused :platform: in module's docs (GH-144988) (GH-144994)
...
Remove unused :platform: in module's docs (GH-144988)
It has not been outputted since Sphinx 1.1.
(cherry picked from commit 20caf1c084 )
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-19 11:51:18 +00:00
Miss Islington (bot)
2ae7c2fadf
[3.14] gh-141984: Reword and reorganize the first part of Atoms docs (GH-144117) (GH-144959)
...
(cherry picked from commit 112d8ac972 )
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-18 17:59:17 +01:00
Stan Ulbrych
8fa0f91e6f
[3.14] Datetime: Tidy up docs (GH-144720) (GH-144956)
...
(cherry picked from commit c6a142f947 )
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2026-02-18 15:14:44 +01:00
Miss Islington (bot)
dafd35fea7
[3.14] gh-144386: Update equivalent code for "with", "async with" and "async for" (GH-144472) (GH-144945)
...
They use special method lookup for special methods.
(cherry picked from commit 9e8fa2d4d1 )
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-02-18 11:19:02 +00:00
Ned Batchelder
a81554f587
[3.14] Docs: an "improve this page" feature (GH-144939) ( #144943 )
...
---------
(cherry picked from commit 7a7521bcfa )
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-18 05:27:09 -05:00
Stan Ulbrych
b1accd51d8
[3.14] Fix typos and grammar errors across documentation (GH-144709) ( #144801 )
...
(cherry picked from commit 3718f4be60 )
Co-authored-by: Ronald Eddy Jr <ronald_eddy@yahoo.com>
2026-02-17 12:53:42 +00:00
Miss Islington (bot)
fdbdd9fb5c
[3.14] gh-144706: Warn against using synchronization primitives within signal handlers (GH-144736) (GH-144767)
...
gh-144706: Warn against using synchronization primitives within signal handlers (GH-144736)
(cherry picked from commit 945bf8ce1b )
Co-authored-by: Robsdedude <dev@rouvenbauer.de>
2026-02-12 23:21:17 +00:00
Miss Islington (bot)
7f5a3acded
[3.14] gh-57095: Add note about input splitting in datetime.*.strptime (GH-131049) (GH-144735)
...
(cherry picked from commit 2e3e76e5cd )
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-12 11:44:32 +01:00
Miss Islington (bot)
3aef49417e
[3.14] gh-142518: Document thread-safety guarantees of dict operations (GH-144184) ( #144708 )
...
* Address feedback; move thread safety section below see-also
* Address feedback - don't mention equality comparison only
* Change admonition to rubric; cross-reference glossary
---------
(cherry picked from commit 35dc547ab5 )
Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2026-02-11 14:39:40 +01:00
Miss Islington (bot)
8c4ce4be26
[3.14] gh-142518: Define lock-free and per-object lock (GH-144548) ( #144704 )
...
gh-142518: Define lock-free and per-object lock (GH-144548)
- Add definitions of lock-free and per-object lock to the glossary
- Cross-reference these from list thread safety notes
- Change admonition to rubric
(cherry picked from commit 12dbae4c02 )
Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
2026-02-11 14:16:55 +01:00
Ned Batchelder
78fa4705d8
[3.14] Docs: remove links of modules to themselves (GH-144695) ( #144705 )
2026-02-11 08:09:56 -05:00
Miss Islington (bot)
a77dde441e
[3.14] gh-106318: Improve str.rstrip() method doc (GH-143893) ( #144699 )
...
gh-106318: Improve str.rstrip() method doc (GH-143893)
(cherry picked from commit 936d60dbe1 )
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-11 08:48:22 +00:00
Miss Islington (bot)
bcbeff52be
[3.14] Clarify the docs for args in asyncio callbacks (GH-143873) ( #144663 )
...
Clarify the docs for `args` in asyncio callbacks (GH-143873)
(cherry picked from commit 40a82abe93 )
Co-authored-by: Aarni Koskela <akx@iki.fi>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2026-02-10 13:16:26 +00:00
Miss Islington (bot)
c9646df644
[3.14] gh-119740: Remove obsoleted removal announce for trunc delegation (GH-144622) (GH-144624)
...
This was done in GH-119743 (3.14).
(cherry picked from commit aa6ed802f2 )
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2026-02-09 16:04:52 +02:00
Miss Islington (bot)
27baa1cd5d
[3.14] gh-106318: Add examples for str.partition() method (GH-142823) ( #144611 )
...
gh-106318: Add examples for str.partition() method (GH-142823)
(cherry picked from commit 432ddd99e2 )
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-02-08 22:17:46 +00:00
Miss Islington (bot)
2494a90fbc
[3.14] gh-106318: Add example for str.isalnum() (GH-137550) ( #144609 )
...
gh-106318: Add example for str.isalnum() (GH-137550)
(cherry picked from commit 3dd7a3c65a )
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2026-02-08 22:14:19 +00:00
Miss Islington (bot)
0cc73ad642
[3.14] For enum.bin, update versionadded directive from 3.10 to 3.11 (GH-144574) ( #144588 )
...
For `enum.bin`, update versionadded directive from 3.10 to 3.11 (GH-144574)
(cherry picked from commit d73634935c )
Co-authored-by: Guo Ci <zguoci@gmail.com>
2026-02-08 07:41:33 +00:00
Miss Islington (bot)
626a6bcb31
[3.14] gh-143700: document secrets.DEFAULT_ENTROPY as an opaque value (GH-144568) ( #144579 )
...
gh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value (GH-144568)
(cherry picked from commit 934997218e )
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2026-02-07 22:42:16 +00:00
Miss Islington (bot)
6b9c21cbea
[3.14] gh-142044: Add note to prefer asyncio.timeout[_at] over asyncio.Timeout (GH-144449) ( #144565 )
...
gh-142044: Add note to prefer `asyncio.timeout[_at]` over `asyncio.Timeout` (GH-144449)
(cherry picked from commit 0e7c06a858 )
Co-authored-by: kovan <xaum.io@gmail.com>
2026-02-07 13:31:29 +01:00
Miss Islington (bot)
470e8f27ee
[3.14] gh-140490: Document changes for PurePath.stem in Python 3.14 (GH-144450) ( #144564 )
...
gh-140490: Document changes for `PurePath.stem` in Python 3.14 (GH-144450)
(cherry picked from commit 16efaa225c )
Co-authored-by: kovan <xaum.io@gmail.com>
2026-02-07 12:25:09 +00:00
Ned Batchelder
bdba86ea31
[3.14] Docs: module pages should not link to themselves (GH-144505) ( #144542 )
...
Docs: module pages should not link to themselves
A re-application of the same changes as #144505 .
2026-02-06 14:06:50 -05:00
Miss Islington (bot)
3fe97357ce
[3.14] gh-141004: Reorganize and reword the 'Useful macros' section (GH-144471) (GH-144541)
...
- Group the macros
- Roughly order them to put the most important ones first
- Add expansions where it makes sense; especially if there's
an equivalent in modern C or a common compiler
(cherry picked from commit f85e1170d2 )
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2026-02-06 12:50:06 +01:00
Miss Islington (bot)
6614a3c30c
[3.14] gh-74955: Document that __all__ must contain strings in normalization form NFKC (GH-144504) (GH-144519)
...
(cherry picked from commit c81e1843d4 )
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2026-02-05 18:12:28 +00:00
Miss Islington (bot)
3e1197e50d
[3.14] gh-144484: Warn users not to use wsgiref in production ( #144511 )
...
gh-144484: Warn users not to use wsgiref in production
(cherry picked from commit 7e777c587f )
Co-authored-by: Seth Michael Larson <seth@python.org>
2026-02-05 18:21:31 +02:00
Serhiy Storchaka
2fb9cde118
[3.14] gh-144148: Update the urllib.parse documentation (GH-144497) (GH-144507)
...
Document urlsplit() as the main parsing function and urlparse() as
an obsolete variant.
(cherry picked from commit 67ddba9aa9 )
2026-02-05 17:24:24 +02:00
Miss Islington (bot)
f27896c319
[3.14] gh-141984: Reword and reorganize Subscription (and Slicing) docs (GH-141985) (GH-144476)
...
(cherry picked from commit e423e0c2cc )
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-05 10:41:32 +01:00
Miss Islington (bot)
48015091a9
[3.14] Itertools recipes: Replace the tabulate() example with running_mean() (gh-144483) (gh-144485)
2026-02-04 20:27:41 +00:00
Miss Islington (bot)
9f5191f8e7
[3.14] gh-106318: Add examples for str.startswith() method (GH-144369) ( #144481 )
...
gh-106318: Add examples for `str.startswith()` method (GH-144369)
(cherry picked from commit 1b6d737ee0 )
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2026-02-04 17:23:55 +00:00
Miss Islington (bot)
e3d05d2dd6
[3.14] gh-141004: Document remaining pyport.h utility macros (GH-144279) (GH-144477)
...
gh-141004: Document remaining `pyport.h` utility macros (GH-144279)
(cherry picked from commit 914fbec214 )
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-02-04 16:49:41 +00:00
Miss Islington (bot)
fddd858810
[3.14] gh-141444: Replace dead URL in urllib.robotparser example (GH-144443) ( #144464 )
...
Co-authored-by: kovan <217326+kovan@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 11:36:34 +00:00
Miss Islington (bot)
07d080a608
[3.14] gh-127313: Use getLogger() without argument to get root logger in logging cookbook (GH-143683) (GH-144431)
...
gh-127313: Use getLogger() without argument to get root logger in logging cookbook (GH-143683)
Use getLogger() to get root logger in logging cookbook
(cherry picked from commit 53fecbe6e1 )
Co-authored-by: AN Long <aisk@users.noreply.github.com>
2026-02-03 14:55:07 +00:00
Miss Islington (bot)
eb0790f2d7
[3.14] gh-74453: Add stronger security warning to os.path.commonprefix
...
gh-74453: Add stronger security warning to os.path.commonprefix (GH-144401)
(cherry picked from commit 4e15b8d95d )
Co-authored-by: Seth Michael Larson <seth@python.org>
2026-02-03 14:28:39 +00:00
Miss Islington (bot)
cc8fd6ac43
[3.14] gh-106318: Add examples for str.rindex() method (GH-143887) ( #144421 )
...
gh-106318: Add examples for str.rindex() method (GH-143887)
(cherry picked from commit 45d00a0791 )
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2026-02-03 14:36:27 +01:00
Peter Bierma
c766dda80d
[3.14] gh-144277: Fix usage of free-threaded terminology in the documentation (GH-144333) (GH-144385)
...
(cherry picked from commit 3a0e183556 )
2026-02-01 21:01:43 -05:00
Miss Islington (bot)
b82b12bc80
[3.14] gh-142119: Clarify that one contextvars.Token can only reset once in a lifetime (GH-143693) (GH-144266)
...
(cherry picked from commit 487bd2dea5 )
Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
2026-01-27 11:39:13 +01:00