Commit graph

28703 commits

Author SHA1 Message Date
Miss Islington (bot)
a00f5a84fd
[3.13] gh-129143: Fix incorrect documentation for logging.Handler.close(). (GH-129950) (GH-129951)
(cherry picked from commit 7c156a63d3)
2025-02-10 11:26:50 +00:00
Miss Islington (bot)
f7d885a8ff
[3.13] gh-129873: IDLE: Improve help.py's method of parsing HTML (GH-129859) (#129884)
gh-129873: IDLE: Improve help.py's method of parsing HTML (GH-129859)

In `help.copy_strip`, only copy the text `<section>`.  In `help.HelpParser.handle_starttag` and elsewhere, remove code to skip the no longer present html.  Add a reminder at the top of idle.rst to run copy_strip after changes.
---------

(cherry picked from commit 6fbf15f98e)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2025-02-09 04:19:36 -05:00
Miss Islington (bot)
3cf859056a
[3.13] gh-129699: Add description to IDLE doc title (GH-129727) (#129864)
gh-129699: Add description to IDLE doc title (GH-129727)

Also extend the 'idlelib' section header. These additions affect both the displayed idle.html file and the contents.html file displayed by clicking the Complete table of contents link on the main docs.python.org page. (The module index entries are generated from the module name and synopsis within module files.)
---------

(cherry picked from commit 33a7094aa6)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2025-02-08 20:14:47 +00:00
Miss Islington (bot)
9497e9d77d
[3.13] gh-64414: mention AF_INET6 and IPv6 in socketserver docs. (GH-129866) (#129868)
gh-64414: mention AF_INET6 and IPv6 in socketserver docs. (GH-129866)

mention AF_INET6 and IPv6 in socketserver docs.
(cherry picked from commit 5ce70ad129)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-02-08 20:12:22 +00:00
Miss Islington (bot)
aae0a1f904
[3.13] Add multinomial to the itertools recipes docs (gh-129760) (gh-129762) 2025-02-06 18:45:15 -06:00
Miss Islington (bot)
de84531a3e
[3.13] gh-112020: Rework socketserver examples to be correct (GH-129741) (#129743)
gh-112020: Rework socketserver examples to be correct.

Outdated code updated, the BaseRequestHandler example is now much more
illustrative instead of the bad idea of a single recv() call for TCP.

tested, they now work.
(cherry picked from commit 78377c788e)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-02-06 17:49:19 +00:00
Miss Islington (bot)
0f7e6d78ea
[3.13] Remove an inaccurate note from socket.recv (GH-129733) (#129734)
Remove an inaccurate note from `socket.recv` (GH-129733)

Remove an inaccurate note from socket.recv.
(cherry picked from commit ded54c3baa)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2025-02-06 09:45:28 -08:00
Adam Turner
aaf0581d2a
[3.13] GH-121970: Extract `implementation_detail` into a new extension (GH-129663) (#129739)
(cherry picked from commit 4d56c40440)
2025-02-06 17:30:03 +00:00
Miss Islington (bot)
fc78ed9e6f
[3.13] gh-118915: Fix bad link in documentation (GH-129691) (GH-129723)
gh-118915: Fix bad link in documentation (GH-129691)
(cherry picked from commit 779d06945c)

Co-authored-by: Miro Hrončok <miro@hroncok.cz>
2025-02-06 13:47:07 +01:00
Serhiy Storchaka
4cf3e80eee
[3.13] Use roles :data: and :const: for referencing module variables (GH-129507) (GH-129649)
(cherry picked from commit 078ab828b9)
2025-02-04 14:25:18 +00:00
Miss Islington (bot)
646bd7958e
[3.13] gh-128696: Add arm64 to the get_platform return val description (GH-128701) (#128774)
gh-128696: Add arm64 to the get_platform return val description (GH-128701)
(cherry picked from commit 553cdc6d68)

Co-authored-by: RUANG (James Roy) <longjinyii@outlook.com>
2025-02-03 23:56:23 +00:00
Miss Islington (bot)
186165e509
[3.13] gh-101944: Clarify PyModule_AddObjectRef() documentation (GH-129433) (#129612)
gh-101944: Clarify PyModule_AddObjectRef() documentation (GH-129433)
(cherry picked from commit 04264a286e)

Co-authored-by: Victor Stinner <vstinner@python.org>
2025-02-03 12:02:00 +00:00
Miss Islington (bot)
85e162087f
[3.13] gh-129407: Clarify that a SystemError isn't always CPython's fault (GH-129410) (#129610)
gh-129407: Clarify that a `SystemError` isn't always CPython's fault (GH-129410)
(cherry picked from commit 39b754a359)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2025-02-03 11:52:29 +00:00
Miss Islington (bot)
9862800a71
[3.13] gh-126609: Allow translating the `availability` directive (GH-129549) (#129584)
gh-126609: Allow translating the ``availability`` directive (GH-129549)
(cherry picked from commit 0612a89ffc)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-02-03 08:28:11 +00:00
Adam Turner
63cae73797
[3.13] GH-121970: Extract `misc_news` into a new extension (GH-129577) (#129586)
(cherry picked from commit ae4788809d)
2025-02-02 16:24:48 +00:00
Miss Islington (bot)
2d60dcfda9
[3.13] gh-126022: Replace TeX quotation marks with `"` in Doc/license.rst (GH-129535) (#129551)
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-02-01 16:57:58 +00:00
Miss Islington (bot)
fcb265671c
[3.13] gh-129438: Update `--enable-experimental-jit` section with install requirements (GH-129450) (#129472)
gh-129438: Update ``--enable-experimental-jit`` section with install requirements (GH-129450)

Add a note to the `JIT` docs that building CPython with `JIT` requires Python 3.11 or newer.

(cherry picked from commit 652f66ac38)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
2025-01-30 10:22:05 +00:00
Miss Islington (bot)
332426b4af
[3.13] gh-85046: Document errno constants (GH-126420) (#129383)
(cherry picked from commit 1c3bb200da)

Co-authored-by: RUANG (James Roy) <longjinyii@outlook.com>
2025-01-28 00:19:06 +00:00
Miss Islington (bot)
d7d4edfa75
[3.13] gh-109975: Add list of 3.13 removed library replacements (GH-127816) (#129242)
Co-authored-by: Jeong, YunWon <69878+youknowone@users.noreply.github.com>
2025-01-27 18:27:11 +02:00
Miss Islington (bot)
53b7b0f782
[3.13] gh-126022: Remove zope.org from the permitted linkcheck redirects (GH-129308) (#129317)
Co-authored-by: partev <petrosyan@gmail.com>
2025-01-26 14:51:49 +00:00
Miss Islington (bot)
bcececd785
[3.13] GH-121970: Remove pyspecific `PyDecoratorMixin` patches (GH-129306) (#129309)
GH-121970: Remove pyspecific ``PyDecoratorMixin`` patches (GH-129306)
(cherry picked from commit 0ef8d470b7)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-26 03:49:23 +00:00
Hugo van Kemenade
b2ae234672
[3.13] gh-126022: make license.rst consistent with LICENSE (GH-128516) (#129290)
Co-authored-by: partev <petrosyan@gmail.com>
2025-01-25 15:37:14 +02:00
Miss Islington (bot)
104bcff983
[3.13] GH-125722: Remove Sphinx patches (GH-129277) (#129278)
GH-125722: Remove Sphinx patches (GH-129277)
(cherry picked from commit d40692db06)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-25 03:55:36 +00:00
Miss Islington (bot)
eed7865cee
[3.13] gh-97850: Remove the mention of removal from ResourceReader docs (GH-128602) (#128654)
gh-97850: Remove the mention of removal from `ResourceReader` docs (GH-128602)

Remove the mention of removal from ResourceReader docs
(cherry picked from commit a1284e9797)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>
2025-01-23 22:17:32 +01:00
Miss Islington (bot)
6a261a02a7
[3.13] gh-126172: Fix a misleading statement in PYTHON_BASIC_REPL documentation (GH-127203) (#129152)
gh-126172: Fix a misleading statement in PYTHON_BASIC_REPL documentation (GH-127203)

Fix a misleading statement in PYTHON_BASIC_REPL documentation.
(cherry picked from commit f18b226492)

Co-authored-by: Michael Kashirin <88917554+mkashirin@users.noreply.github.com>
2025-01-23 22:17:11 +01:00
Miss Islington (bot)
508ace6705
[3.13] gh-122845: fix parameter_list_starargs in function definition pseudo-grammar (GH-122847) (#129150)
gh-122845: fix parameter_list_starargs in function definition pseudo-grammar (GH-122847)

Thanks to Artur Chakhvadze for bugfix.
(cherry picked from commit 6105846390)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2025-01-21 20:12:43 +00:00
Miss Islington (bot)
972d95313c
[3.13] gh-118915: C API: Document compiler flag macros (GH-129028) (GH-129086)
(cherry picked from commit 6e02096e2f)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2025-01-21 11:47:55 +01:00
Miss Islington (bot)
8ab29d95a2
[3.13] Docs: fix typo in Doc/howto/mro.rst (GH-129095) (GH-129122)
(cherry picked from commit da310d209a)

Co-authored-by: smelnikov <13030121+smelnikov@users.noreply.github.com>
2025-01-21 10:40:31 +01:00
Miss Islington (bot)
f10f2a2e77
[3.13] GH-121970: Extract `changes` into a new extension (GH-129105) (#129109)
GH-121970: Extract ``changes`` into a new extension (GH-129105)
(cherry picked from commit e54ac3b69e)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-20 23:58:41 +00:00
Miss Islington (bot)
2077082463
[3.13] doc: fix venv creating for the local Python using uv (GH-129094) (#129096)
Co-authored-by: Filipe Laíns 🇵🇸 <lains@riseup.net>
2025-01-20 21:13:12 +02:00
Miss Islington (bot)
22e9faf08a
[3.13] Docs C API: Clarify what happens when null bytes are passed to PyUnicode_AsUTF8 (GH-127458) (#129080)
Docs C API: Clarify what happens when null bytes are passed to `PyUnicode_AsUTF8` (GH-127458)
(cherry picked from commit e792f4bc2e)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Stan U. <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Tomas R. <tomas.roun8@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2025-01-20 16:04:53 +00:00
Miss Islington (bot)
2f8eefe97a
[3.13] gh-129044: Update glossary entry for 'loader' to reflect current import system (GH-129073) (#129077)
gh-129044: Update glossary entry for 'loader' to reflect current import system (GH-129073)
(cherry picked from commit e1fa2fcc7c)

Co-authored-by: nikalinov <92603661+nikalinov@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-20 15:51:52 +00:00
Miss Islington (bot)
59b919b082
[3.13] GH-125722: Use long options for Sphinx (GH-129039) (#129041)
GH-125722: Use long options for Sphinx (GH-129039)
(cherry picked from commit 4967fa6a9c)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-20 09:17:29 +02:00
Miss Islington (bot)
5fe7650552
[3.13] GH-125722: Increase minimum supported Sphinx to 8.1.3 (GH-128922) (#129037)
(cherry picked from commit d46b577ec0)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-20 00:52:00 +00:00
Miss Islington (bot)
080d17e945
[3.13] gh-129020: Remove ambiguous sentence from tokenize.untokenize docs (GH-129021) (#129035)
gh-129020: Remove ambiguous sentence from `tokenize.untokenize` docs (GH-129021)
(cherry picked from commit bca35f0e78)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>
2025-01-20 00:11:27 +00:00
Miss Islington (bot)
03ee311e5a
[3.13] gh-128998: Fix indentation of numbered list and literal block (GH-128999) (#129000)
gh-128998: Fix indentation of numbered list and literal block (GH-128999)
(cherry picked from commit e8092e5cdc)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-18 20:58:20 +00:00
Miss Islington (bot)
b7ddcc3efb
[3.13] gh-121542: Document trailing newline behavior in set_content() (GH-121543) (#128995)
gh-121542: Document trailing newline behavior in `set_content()` (GH-121543)
(cherry picked from commit fba475ae6f)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Yizheng Meng <dev@rapidcow.org>
2025-01-18 18:40:30 +00:00
Miss Islington (bot)
fff334e538
[3.13] gh-125997: suggest efficient alternatives for time.sleep(0) (GH-128752) (#128984)
gh-125997: suggest efficient alternatives for `time.sleep(0)` (GH-128752)
(cherry picked from commit f4afaa6f11)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-01-18 11:08:42 +00:00
Miss Islington (bot)
77e29c75da
[3.13] Fix definition of a generator iterator in glossary.rst (GH-128952) (#128967)
Fix definition of a `generator iterator` in `glossary.rst` (GH-128952)

Fix possible typo/grammar in glossary.rst

As discussed in https://discuss.python.org/t/typo-in-glossary-entry-for-generator-iterator/77163
(cherry picked from commit 8174770d31)

Co-authored-by: Daniel F Moisset <dfmoisset@gmail.com>
2025-01-18 00:52:10 +00:00
Miss Islington (bot)
9974e7185d
[3.13] gh-128017: Make a note that sys variables are read-only (GH-128887) (#128908)
Co-authored-by: Srinivas Reddy Thatiparthy (తాటిపర్తి శ్రీనివాస్  రెడ్డి) <thatiparthysreenivas@gmail.com>
2025-01-17 18:04:00 +02:00
Miss Islington (bot)
714b85136b
[3.13] gh-97850: Suggest TraversableResources as the alternative for ResourceLoader (GH-128601) (GH-128895)
gh-97850: Suggest `TraversableResources` as the alternative for `ResourceLoader` (GH-128601)

Suggest TraversableResources as the alternative for ResourceLoader.

Previously, ResourceReader was the suggested alternative, but it
is itself deprecated in favour of TraversableResources.
(cherry picked from commit 256d6d2131)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>
2025-01-15 20:53:17 +00:00
Miss Islington (bot)
639e0f36af
[3.13] gh-67206: Document that string.printable is not printable in the POSIX sense (GH-128820) (#128868)
gh-67206: Document that `string.printable` is not printable in the POSIX sense (GH-128820)
(cherry picked from commit d906bde250)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-01-15 14:27:27 +00:00
Miss Islington (bot)
d2a8d57123
[3.13] gh-106320: Document replacement for removed C API (GH-128787) (#128837)
gh-106320: Document replacement for removed C API (GH-128787)
(cherry picked from commit 43ef9587ae)

Co-authored-by: Victor Stinner <vstinner@python.org>
2025-01-14 15:42:30 +00:00
Miss Islington (bot)
0998eb6275
[3.13] Fix a "doctest" block in Doc/library/turtle.rst (GH-128831) (#128835)
Fix a "doctest" block in `Doc/library/turtle.rst` (GH-128831)
(cherry picked from commit 1598e18a65)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2025-01-14 15:28:01 +00:00
Miss Islington (bot)
05bd6cbe61
[3.13] gh-123345: improve fnmatch docs (GH-123346) (#128776)
gh-123345: improve `fnmatch` docs (GH-123346)
(cherry picked from commit 29fe8072cf)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2025-01-13 10:35:26 +00:00
Tian Gao
33c0ba0ead
[3.13] gh-128409: Document that pdb.post_mortem() accepts exceptions … (#128767)
* [3.13] gh-128409: Document that pdb.post_mortem() accepts exceptions (GH-128410)
(cherry picked from commit 1b39b502d3)

Co-authored-by: Adam Johnson <me@adamj.eu>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
2025-01-13 00:12:11 -05:00
Miss Islington (bot)
65da5db28a
[3.13] gh-118915: Document PyUnstable_InterpreterState_GetMainModule (GH-128483) (GH-128677)
(cherry picked from commit ea39c8b08d)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
2025-01-10 08:41:14 +01:00
Miss Islington (bot)
c57ef49337
[3.13] gh-124433: fix docs for asyncio.Queue.task_done (GH-128669) (#128671)
gh-124433: fix docs for `asyncio.Queue.task_done` (GH-128669)
(cherry picked from commit 4322a318ea)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-01-09 18:00:55 +05:30
Miss Islington (bot)
1d2d62c15e
[3.13] gh-126137: improve docs for loop.add_reader and loop.add_writer (GH-128666) (#128667)
gh-126137: improve docs for `loop.add_reader` and `loop.add_writer` (GH-128666)
(cherry picked from commit b2adf55674)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2025-01-09 10:16:59 +00:00
Miss Islington (bot)
4f01a120f7
[3.13] gh-79149: document reentrant safety of loop.call_soon_threadsafe (GH-128662) (#128664)
gh-79149: document reentrant safety of `loop.call_soon_threadsafe` (GH-128662)
(cherry picked from commit 4685401845)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Thomas Grainger <tagrain@gmail.com>
2025-01-09 09:25:18 +00:00