Commit graph

13879 commits

Author SHA1 Message Date
Miss Islington (bot)
26d831327d
[3.13] Correct class name from PullDom to PullDOM (GH-141207) (#141742)
Co-authored-by: Guo Ci <zguoci@gmail.com>
2025-11-19 13:07:07 +02:00
Miss Islington (bot)
8f7188847f
[3.13] gh-140873: Fix the singledispatchmethod documentation (GH-141523) (GH-141710)
It does not support non-descriptor callables yet.
(cherry picked from commit d89eb2f984)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-11-18 11:38:38 +00:00
Miss Islington (bot)
b41963a4aa
[3.13] Add missing backticks in os and decimal docs (GH-141699) (#141706)
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2025-11-18 10:38:16 +00:00
Semyon Moroz
a63ceb7f10
[3.13] gh-130160: Add anchors to CLI Usage section for cmdline (GH-133182) (#141667)
Co-authored-by: Semyon Moroz <donbarbos@proton.me>
2025-11-17 19:55:54 +02:00
Miss Islington (bot)
8d4e94ec6c
[3.13] gh-141650: Fix typo in xml.sax.saxutils.unescape documentation (GH-141652) (#141653)
Co-authored-by: Tamzin Hadasa Kelly <tk.infinity@gmail.com>
2025-11-17 13:02:01 +00:00
Miss Islington (bot)
aec6b72297
[3.13] gh-137952: update csv.Sniffer().has_header() docs to describe the actual off-by-onish behavior (GH-137953) (#141435)
gh-137952: update `csv.Sniffer().has_header()` docs to describe the actual off-by-onish behavior (GH-137953)

* checks 21, not 20
* Say "header" instead of "first row" to disambiguate per review.

---------
(cherry picked from commit 0d7b48a8f5)

Co-authored-by: Maurycy Pawłowski-Wieroński <maurycy@maurycy.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-11-11 16:13:19 -08:00
Miss Islington (bot)
305e9c5fc4
[3.13] gh-139533: fix refs to code without proper markups on turtledemo doc (GH-139534) (#141422)
gh-139533: fix refs to code without proper markups on turtledemo doc (GH-139534)
(cherry picked from commit c903d76832)


gh-139533: fix refs to code without proper markups on turtledemo documentation

Co-authored-by: Marco Barbosa <aureliobarbosa@gmail.com>
2025-11-11 19:42:01 +00:00
Miss Islington (bot)
a9c00827dd
[3.13] gh-140578: Doc: Remove sencence implying that concurrent.futures.ThreadPoolExecutor does not exist (GH-140689) (#141383)
gh-140578: Doc: Remove sencence implying that concurrent.futures.ThreadPoolExecutor does not exist (GH-140689)

* Doc: Remove sencence implying that concurrent.futures.ThreadPoolExecutor does not exist

Closes GH-140578

* Add NEWS.d entry for gh-140578

---------
(cherry picked from commit 46b58e1bb9)

Co-authored-by: Louis <paternal@users.noreply.github.com>
Co-authored-by: Louis Paternault <spalax@gresille.org>
2025-11-11 04:58:30 +00:00
Miss Islington (bot)
1f9f8e5f68
[3.13] gh-139707: Specify winreg, msvcrt and winsound module availability in docs (GH-140429) (GH-141350)
(cherry picked from commit 13fa313beb)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-11-10 17:40:53 +01:00
Miss Islington (bot)
0facabc2d8
[3.13] gh-141343: Fix swapped words in sorted doc (GH-141356)
(cherry picked from commit 59b793b0dd)

Co-authored-by: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com>
2025-11-10 15:02:45 +00:00
Miss Islington (bot)
9cbbb2eb21
[3.13] gh-141004: Document pyctype.h macros (GH-141272) (GH-141339)
gh-141004: Document `pyctype.h` macros (GH-141272)
(cherry picked from commit df19261621)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-11-10 10:11:39 +00:00
Miss Islington (bot)
379d8146d0
[3.13] gh-62480: De-personalize "Partial mocking" section in unittest.mock examples (GH-141321) (#141327)
gh-62480: De-personalize "Partial mocking" section in `unittest.mock` examples (GH-141321)

* Refine some wording in unittest partial mock doc

Some of the descriptions were addressed in first person,
but have now been changed to address the user reading the documentation instead.
(cherry picked from commit b618731781)

Co-authored-by: KarnbirKhera <166065758+KarnbirKhera@users.noreply.github.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2025-11-09 18:08:09 -06:00
Miss Islington (bot)
b9d4cefe76
[3.13] gh-62480: De-personalize "Mocking Unbound Methods" section in unittest.mock examples (GH-141322) (#141325)
gh-62480: De-personalize "Mocking Unbound Methods" section in `unittest.mock` examples (GH-141322)

* Rewrite Mocking Unbound Methods paragraph to second person
(cherry picked from commit ec85d3cbfe)

Co-authored-by: Elena O <31424287+oklena@users.noreply.github.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-11-09 18:07:25 -06:00
Miss Islington (bot)
052a53982a
[3.13] gh-141127: Clarify os.symlink() documentation for argument order (GH-141144) (#141277)
gh-141127: Clarify os.symlink() documentation for argument order (GH-141144)
(cherry picked from commit 7ae440f262)

Co-authored-by: Chilla Kalyan <127284726+chillakalyan@users.noreply.github.com>
2025-11-09 11:19:35 +01:00
Miss Islington (bot)
82a274e700
[3.13] gh-141246: Link to correct Windows docs in time.sleep() doc (GH-141248) (#141252)
gh-141246: Link to correct Windows docs in `time.sleep()` doc (GH-141248)
(cherry picked from commit 6545a4e8f8)

Co-authored-by: 莯凛 <1348292515@qq.com>
2025-11-08 15:03:07 +00:00
Miss Islington (bot)
f8147a0316
[3.13] gh-141004: correctly document Py_HASH_* and PyHASH_* as hash_info attributes (GH-141233) (#141235)
gh-141004: correctly document `Py_HASH_*` and `PyHASH_*` as `hash_info` attributes (GH-141233)
(cherry picked from commit 87942d911b)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-11-08 12:29:55 +00:00
Miss Islington (bot)
be33104f88
[3.13] gh-140793: Improve documentatation and tests for the ensure_ascii option in the json module (GH-140906) (GH-141228)
* Document that ensure_ascii=True forces escaping not only non-ASCII, but also
  non-printable characters (the only affected ASCII character is U+007F).
* Ensure that the help output for the json module does not exceed 80
  columns (except one long line in an example and generated lines).
* Add more tests.
(cherry picked from commit 7e90bac3cc)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-11-08 10:30:15 +00:00
Rodrigo Girão Serrão
e753887bd2
[3.13] Minor documentation improvements (GH-140626) (#141161) 2025-11-06 17:37:31 +00:00
Miss Islington (bot)
89cb8aa3ba
[3.13] Minor fixes to idle.rst and regenerate help.html (GH-140037) (#141122)
Minor fixes to `idle.rst` and regenerate `help.html` (GH-140037)
(cherry picked from commit 4e6e208be9)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-11-06 12:11:50 +00:00
Miss Islington (bot)
a29f5218e5
[3.13] gh-140569: recommend the new REPL in the asyncio REPL docs (GH-140570) (#141116)
gh-140569: recommend the new REPL in the asyncio REPL docs (GH-140570)
(cherry picked from commit 8822166200)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-11-06 05:45:18 +00:00
Miss Islington (bot)
8641c471a7
[3.13] gh-118516: clarify that subprocess are automatically killed if transport gets garbage collected (GH-140997) (#141111)
gh-118516: clarify that subprocess are automatically killed if transport gets garbage collected (GH-140997)
(cherry picked from commit 101c9c0a21)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-11-06 10:35:01 +05:30
Miss Islington (bot)
f671739fdc
[3.13] GH-108009: Add clarification of parser and argument defaults in argparse docs (GH-124154) (#141085)
GH-108009: Add clarification of parser and argument defaults in argparse docs (GH-124154)
(cherry picked from commit 95f6e1275b)

Co-authored-by: Savannah Ostrowski <savannah@python.org>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2025-11-05 22:52:43 +00:00
Miss Islington (bot)
d29fe3f32c
[3.13] gh-76007: remove curses.__version__ doc (GH-141052) (#141077)
Co-authored-by: Zenith <me@arielle.codes>
2025-11-05 22:07:32 +00:00
Miss Islington (bot)
91b85c5346
[3.13] gh-139313: Improve docs on XML security (GH-139460) (GH-141066)
Clarify that:
- it takes parsing for an attack
- that some doors are closed by default
- only Expat version 2.7.2 has all the fixes
- use of the bundle depends on configuration
(cherry picked from commit baa9f33897)

Co-authored-by: Sebastian Pipping <sebastian@pipping.org>
2025-11-05 19:06:37 +00:00
Miss Islington (bot)
2dd0a6ad9c
[3.13] Docs: Fix cached calls count in factorial example (gh-140882) (gh-141032)
Co-authored-by: Clifford Gama <cliffygamy@gmail.com>
2025-11-05 12:15:05 -06:00
Filip Łajszczak
d76e411891
[3.13] gh-139434: Update selected RFC 2822 references to RFC 5322 (GH-139435) (#141024)
Update selected RFC 2822 references to RFC 5322

RFC 2822 was obsoleted by RFC 5322 in 2008. This updates references
to use the current standard in documentation, docstrings, and comments.

It preserves RFC 2822 references in legacy API components to maintain their
historical context.

RFC 822 → RFC 2822 → RFC 5322 progression is explained where relevant.

In some places specific sections of RFC are referenced where it seems helpful.

Scout rule was applied in some places and RFC mentions format was
normalized in doc strings and comments.
(cherry picked from commit ce1bb85d28)
2025-11-04 16:22:31 -05:00
Miss Islington (bot)
426daef412
[3.13] Docs: Fix typo in email.headerregistry.rst (GH-140965) (#141021)
Docs: Fix typo in `email.headerregistry.rst` (GH-140965)

Fix missing 'Header' suffix on header class name in `email.headerregistry.rst`
(cherry picked from commit 97d8dda980)

Co-authored-by: Guo Ci <zguoci@gmail.com>
2025-11-04 19:35:14 +00:00
Miss Islington (bot)
fbfa3e3fe8
[3.13] gh-134817: Restore accidentally deleted line in documentation. (GH-141013) (GH-141017)
(cherry picked from commit 66c86c6)
2025-11-04 18:57:32 +00:00
Miss Islington (bot)
aa4dd4ece8
[3.13] Document that returning sys.monitoring.DISABLE in response to a global event raises ValueError (GH-140726) (GH-141015)
Document that returning `sys.monitoring.DISABLE` in response to a global event raises `ValueError` (GH-140726)
(cherry picked from commit 8a7dbb7a68)

Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-11-04 18:36:40 +00:00
Miss Islington (bot)
ac0ecb0f5d
[3.13] gh-140826 Remove the wrong documents about comparison behavior on winreg.HKEYType (GH-140999) (GH-141003)
(cherry picked from commit c3f9702f04)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
2025-11-04 16:36:46 +00:00
Miss Islington (bot)
551d68d8cf
[3.13] Fix minor typo: 'web site' -> 'website' (GH-140561) (GH-140977)
(cherry picked from commit 08115d241a)

Co-authored-by: commitWithTisha <tishaa1010@gmail.com>
2025-11-04 14:11:15 +01:00
Miss Islington (bot)
e7507967f8
[3.13] Docs: Fix a typo in idle.rst (Chitespace -> Whitespace) (GH-140946) (#140954)
Co-authored-by: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com>
2025-11-04 10:02:17 +02:00
Sebastian Pipping
bc36bd1786
[3.13] gh-90949: add Expat API to prevent XML deadly allocations (CVE-2025-59375) (GH-139234) (#139367)
* gh-90949: add Expat API to prevent XML deadly allocations (CVE-2025-59375) (#139234)

Expose the XML Expat 2.7.2 mitigation APIs to disallow use of
disproportional amounts of dynamic memory from within an Expat
parser (see CVE-2025-59375 for instance).

The exposed APIs are available on Expat parsers, that is,
parsers created by `xml.parsers.expat.ParserCreate()`, as:

- `parser.SetAllocTrackerActivationThreshold(threshold)`, and
- `parser.SetAllocTrackerMaximumAmplification(max_factor)`.

(cherry picked from commit f04bea44c3)
(cherry picked from commit 68a1778b77)
2025-11-02 12:39:11 +00:00
Serhiy Storchaka
c6c57f1a0b
[3.13] Fix the versionchanged directive for gh-137836 (GH-140859) 2025-10-31 16:55:54 +00:00
Miss Islington (bot)
0329bd11c7
[3.13] gh-137836: Support more RAWTEXT and PLAINTEXT elements in HTMLParser (GH-137837) (GH-140842)
* the "plaintext" element
* the RAWTEXT elements "xmp", "iframe", "noembed" and "noframes"
* optionally RAWTEXT (if scripting=True) element "noscript"
(cherry picked from commit a17c57eee5)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-10-31 16:08:42 +00:00
Miss Islington (bot)
32c3dcc7a4
[3.13] gh-138162: Fix logging.LoggerAdapter with merge_extra=True and without the extra argument (GH-140511) (GH-140785)
(cherry picked from commit 327dbbedff)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2025-10-30 11:31:54 +00:00
Miss Islington (bot)
887ee39462
[3.13] gh-140463: Fix typo in xmlrpc.client documentation (GH-140552) (#140567)
gh-140463: Fix typo in xmlrpc.client documentation (GH-140552)

Fix typo in xmlrpc.client documentation
(cherry picked from commit 44b6eead21)

Co-authored-by: Miša Jakovljević <misajakovljevic3@gmail.com>
2025-10-24 20:53:38 +00:00
Emma Smith
df35beb6de
[3.13] zlib.rst: Link to constants and deduplicate text (GH-140115) (GH-140350)
* Link to compression setting constants from compression functions
* De-duplicate descriptions of the constants
(cherry picked from commit 091e8513bb)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2025-10-21 14:45:02 -07:00
Miss Islington (bot)
9084371107
[3.13] [Docs] Add missing note about Required/NotRequired/ReadOnly in get_type_hints() (GH-139565) (#140387)
[Docs] Add missing note about Required/NotRequired/ReadOnly in get_type_hints() (GH-139565)
(cherry picked from commit a752f58d6b)

Co-authored-by: Sam Bull <git@sambull.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2025-10-20 13:23:28 -07:00
Miss Islington (bot)
e5ebcabc6b
[3.13] gh-101100: Fix sphinx warnings in library/resource.rst (GH-140023) (#140353)
Co-authored-by: Weilin Du <108666168+LamentXU123@users.noreply.github.com>
2025-10-20 07:23:27 +00:00
Miss Islington (bot)
152e7d14dc
[3.13] docs: be clearer that glob results are unordered (GH-140184) (#140340)
(cherry picked from commit ed672f7a8a)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2025-10-20 07:32:05 +03:00
Miss Islington (bot)
26ea18146d
[3.13] gh-138997: Remove false justify fill option from Tkinter docs (GH-139023) (#140320)
gh-138997: Remove false justify `fill` option from Tkinter docs (GH-139023)
(cherry picked from commit 115a04b802)

Co-authored-by: Marat Khagazheev <marathagazeev@gmail.com>
Co-authored-by: marat <khagazheev@artlebedev.ru>
2025-10-19 03:53:44 +00:00
Miss Islington (bot)
7b6fb716a1
[3.13] gh-128571: Document UTF-16/32 native byte order (GH-139974) (#140308)
Closes GH-128571
(cherry picked from commit 920de7ccdc)

Co-authored-by: Parham MohammadAlizadeh <prhmma@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-10-18 19:03:38 +00:00
Miss Islington (bot)
762fbdbf8c
[3.13] gh-140241: Fix documentation for the registry parameter of warnings.warn_explicit() (GH-140242) (GH-140293)
(cherry picked from commit 78e1d65a4d)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2025-10-18 11:03:03 +00:00
Tan Long
134b4f2fd1
[3.13] Remove duplicate words in the documentation (GH-140221) (GH-140226)
(cherry picked from commit 2ebd0cdb16)
2025-10-16 20:10:31 +02:00
Miss Islington (bot)
426fa77a19
[3.13] gh-140078: fix typo in tkinter docs (GH-140081) (#140218)
gh-140078: fix typo in tkinter docs (GH-140081)

Remove extraneous word.
(cherry picked from commit 5f357f3b0d)

Co-authored-by: wangxiaolei <fatelei@gmail.com>
2025-10-16 15:09:14 +00:00
Miss Islington (bot)
2f27098b42
[3.13] gh-106318: Add examples for str.istitle() (GH-140046) (#140114)
Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2025-10-14 14:25:57 +00:00
Miss Islington (bot)
215068442c
[3.13] gh-82575: Adjust time.get_clock_info *adjustable* attribute doc (GH-135920) (#140098)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-10-14 08:37:07 +00:00
Miss Islington (bot)
08c9a147a6
[3.13] gh-137871: Clarify cmath.nan documentation by linking to math module (GH-137876) (#140096)
Co-authored-by: Aziz <azizbenothman76@gmail.com>
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2025-10-14 08:32:41 +00:00
Miss Islington (bot)
5bead87f83
[3.13] gh-102247: Improve documentation of http.HTTPStatus members update (GH-133190) (#140090)
Co-authored-by: Loïc Simon <loic.simon@napta.io>
2025-10-14 08:24:31 +00:00