Commit graph

27041 commits

Author SHA1 Message Date
Miss Islington (bot)
8134811089
[3.12] Regen Doc/requirements-oldest-sphinx.txt (GH-111012) (#111022)
Regen Doc/requirements-oldest-sphinx.txt (GH-111012)

Fix https://github.com/python/cpython/security/dependabot/4: use
urllib3 version 2.0.7.
(cherry picked from commit e7ae43ad7d)

Co-authored-by: Victor Stinner <vstinner@python.org>
2023-10-18 04:30:14 +00:00
Miss Islington (bot)
ae838afe35
[3.12] gh-107457: update dis documentation with changes in 3.12 (GH-108900) (#110985)
gh-107457: update dis documentation with changes in 3.12 (GH-108900)
(cherry picked from commit 198aa67d4c)

Co-authored-by: Matthieu Dartiailh <m.dartiailh@gmail.com>
2023-10-18 00:38:42 +02:00
Miss Islington (bot)
94525a7a4d
[3.12] C-API docs: Clarify the size of arenas (GH-110895) (#110946)
C-API docs: Clarify the size of arenas (GH-110895)

Clarify the size of arenas

From 3.10.0 alpha 7, the pymalloc allocator uses arenas with a fixed size of 1
MiB on 64-bit platforms instead of 256 KiB on 32-bit platforms.
(cherry picked from commit f07ca27709)

Co-authored-by: Mienxiu <82512658+mienxiu@users.noreply.github.com>
2023-10-16 19:03:18 +00:00
Miss Islington (bot)
b4ed73042e
[3.12] gh-110527: Improve PySet_Clear docs (GH-110528) (#110928)
gh-110527: Improve `PySet_Clear` docs (GH-110528)
(cherry picked from commit bfc1cd8145)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-10-16 13:14:52 +00:00
Miss Islington (bot)
97f4b667e7
[3.12] gh-110886 Doc: add a link to BNF Wikipedia article (GH-110887) (#110900)
Co-authored-by: partev <petrosyan@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-10-15 17:00:44 +00:00
Miss Islington (bot)
744f752f04
[3.12] gh-101100: Fix sphinx warnings in library/time.rst (GH-110862) (#110877)
gh-101100: Fix sphinx warnings in `library/time.rst` (GH-110862)
(cherry picked from commit 12deda7633)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-10-14 14:28:58 +00:00
Miss Islington (bot)
12b9cb80be
[3.12] gh-101100: Fix sphinx warnings in usage/cmdline.rst (GH-110841) (#110855)
Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-10-14 00:28:34 -06:00
Miss Islington (bot)
1a7afa7ef4
[3.12] gh-110703: Add asyncio.wait_for() change notes for 3.11 (GH-110818) (#110826)
gh-110703: Add asyncio.wait_for() change notes for 3.11 (GH-110818)

* Remove redundant versionchanged

* Add missing versionchanged

* Update Doc/library/asyncio-task.rst



---------

(cherry picked from commit f81e36f700)

Co-authored-by: paskozdilar <53006174+paskozdilar@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
2023-10-13 13:24:28 +00:00
Miss Islington (bot)
f2e353b9d8
[3.12] gh-110803: Reorganize docs for what PyType_Slot doesn't cover (GH-110813) (#110823)
gh-110803: Reorganize docs for what PyType_Slot doesn't cover (GH-110813)

* gh-110803: Reorganize docs for what PyType_Slot doesn't cover

- Cover the offset fields first
- Mention the old alternative for MANAGED flags, which is needed
  to support older Pythons
- De-emphasize the internal flags: use an inline list.
- Add a note to PyMemberDef saying what to do with it

* Remove an older draft...
(cherry picked from commit 2ab34f0e42)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2023-10-13 12:59:55 +00:00
Erlend E. Aasland
e8d04190c6
[3.12] GH-107518: Remove the Argument Clinic How-To (#109900) (#110760)
(cherry picked from commit d1f7fae424)

* Remove the content of the Argument Clinic HOWTO
* Update cross-references to the Argument Clinic
* Add a note directing readers to the devguide

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-10-12 09:37:37 +00:00
Miss Islington (bot)
dbbe0eebf0
[3.12] gh-110631: Fix reST indentation in Doc/reference (GH-110708) (#110740)
gh-110631: Fix reST indentation in `Doc/reference` (GH-110708)

Fix wrong indentation in the Doc/reference dir.
(cherry picked from commit 41d8ec5a1b)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2023-10-11 23:13:21 +02:00
Ezio Melotti
7d5a982609
[3.12] gh-110631: Fix reST indentation (GH-110724) (#110738)
* Fix wrong indentation in the other dirs.

* Fix more wrong indentation..
(cherry picked from commit 718391f475)
2023-10-11 23:12:36 +02:00
Miss Islington (bot)
cae968ba17
[3.12] gh-110631: Fix reST indentation in Doc/library (GH-110685) (#110736)
gh-110631: Fix reST indentation in `Doc/library` (GH-110685)

Fix wrong indentation in the Doc/library dir.
(cherry picked from commit bb7923f556)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2023-10-11 23:11:28 +02:00
Hugo van Kemenade
e6c53dd085
[3.12] gh-108826: Document dis module CLI and rename _test function to main (#108827) (#110681)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Radislav Chugunov <52372310+chgnrdv@users.noreply.github.com>
2023-10-11 14:47:38 -06:00
Ezio Melotti
1ea4cb1a66
[3.12] gh-110631: fix wrong indentation in the Doc/whatsnew dir (GH-110632) (#110690)
fix wrong indentation in the `Doc/whatsnew` dir (#110632)
2023-10-11 03:53:17 -06:00
Miss Islington (bot)
80e4abe0ce
[3.12] gh-101100: Fix sphinx warnings in library/socketserver.rst (GH-110207) (GH-110623)
(cherry picked from commit 756062b296)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-10-10 14:10:22 +02:00
Miss Islington (bot)
c8bffd1667
[3.12] Remove unused SPHINXLINT var from Doc/Makefile. (GH-110570) (#110585)
Remove unused `SPHINXLINT` var from `Doc/Makefile`. (GH-110570)

Remove unused `SPHINXLINT` var.
(cherry picked from commit bdbe43c7d0)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2023-10-10 03:14:00 +02:00
Miss Islington (bot)
a7fe709fef
[3.12] gh-110497: Add note about OSError being an alias to IOError in docs (GH-110498) (#110546)
gh-110497: Add note about `OSError` being an alias to `IOError` in docs (GH-110498)
(cherry picked from commit 5e7edac771)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-10-09 11:42:17 +02:00
Miss Islington (bot)
fb8c0415a2
[3.12] gh-110534 fix a URL redirect to wikipedia article on Fibonacci numbers (GH-110535) (#110536)
gh-110534 fix a URL redirect to wikipedia article on Fibonacci numbers (GH-110535)
(cherry picked from commit 892ee72b36)

Co-authored-by: partev <petrosyan@gmail.com>
2023-10-09 04:52:36 +00:00
Miss Islington (bot)
96e42d2f8d
[3.12] Update floatingpoint.rst (GH-110509) (#110513)
Update floatingpoint.rst (GH-110509)

This commit removes a ':'. I believe the extra colon causes a display error.

What I believe to be an error:
Above this expression
`round(math.pi, ndigits=2) == round(22 / 7, ndigits=2)`
the page displays `.. doctest::`.

What I observed:
After I remove the extra colon, the page does not display `.. doctest::`
(cherry picked from commit 8e56d551ce)

Co-authored-by: zipperer <47086307+zipperer@users.noreply.github.com>
2023-10-08 00:18:39 +00:00
Miss Islington (bot)
b77f5eea70
[3.12] Fix typo in Doc/library/textwrap.rst (GH-110328) (#110473)
Co-authored-by: InSync <122007197+InSyncWithFoo@users.noreply.github.com>
2023-10-06 14:33:16 +00:00
Miss Islington (bot)
93279cc8b8
[3.12] gh-110383: Swap 'the all' -> 'all the' in socket docs (GH-110434) (#110435)
Co-authored-by: Bradley Reynolds <bradley.reynolds@darbia.dev>
2023-10-05 14:14:22 -06:00
Miss Islington (bot)
5b66fe8304
[3.12] gh-110383 TimeIt Docs Spelling Fix (GH-110407) (#110409)
gh-110383 TimeIt Docs Spelling Fix (GH-110407)

Make 0.2 second plural
(cherry picked from commit a973bf0f97)

Co-authored-by: Towster15 <105541074+Towster15@users.noreply.github.com>
2023-10-05 17:42:52 +00:00
Miss Islington (bot)
5635913125
[3.12] Fix env var typo in perf profiling docs (GH-110404) (#110414)
Fix env var typo in perf profiling docs (GH-110404)

Fix typo in docs
(cherry picked from commit a13620685f)

Co-authored-by: Harmen Stoppels <harmenstoppels@gmail.com>
2023-10-05 20:40:19 +03:00
Miss Islington (bot)
4da8c1b61e
[3.12] Remove duplicate word. (GH-110376) (GH-110377)
Remove duplicate word. (GH-110376)
(cherry picked from commit 313aa861ce)

Co-authored-by: Benjamin Peterson <benjamin@python.org>
2023-10-05 04:26:44 +00:00
Miss Islington (bot)
36a7d6becd
[3.12] Add back bltin-boolean-values ref tag (GH-110371) (#110372)
Add back bltin-boolean-values ref tag (GH-110371)

To avoid breaking downstream intersphinx via numpydoc
(cherry picked from commit f7860295b1)

Co-authored-by: P. L. Lim <2090236+pllim@users.noreply.github.com>
2023-10-04 20:05:21 +00:00
Miss Islington (bot)
7ec34874e3
[3.12] gh-85984: Document change in return type of tty functions (GH-110028) (#110324)
gh-85984: Document change in return type of tty functions (GH-110028)
(cherry picked from commit f02f26e293)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2023-10-04 13:57:14 +02:00
Miss Islington (bot)
ee2f2bdb30
[3.12] Enhance TypedDict docs around required/optional keys (GH-109547) (#109982)
Enhance TypedDict docs around required/optional keys (GH-109547)

As discussed in comments to GH-109544, the semantics of this attribute
are somewhat confusing. Add a note explaining its limitations and
steering users towards __required_keys__ and __optional_keys__ instead.
(cherry picked from commit f49958c886)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2023-10-04 13:56:58 +02:00
Adam Turner
4c0f42bbc6
[3.12] Docs: Avoid the deprecated `.. cmdoption::` directive (GH-110292) (#110302)
[3.12] Docs: Avoid the deprecated ``.. cmdoption::`` directive (GH-110292).
(cherry picked from commit 77e9aae383)
2023-10-03 20:55:29 +03:00
Miss Islington (bot)
90dea557bb
[3.12] gh-109234: Hint to contextlib.closing in sqlite3 context manager docs (GH-109322) (#110294)
(cherry picked from commit 4227bfa8b2)

Co-authored-by: Lincoln <71312724+Lincoln-developer@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2023-10-03 16:02:44 +00:00
Miss Islington (bot)
bd56c51f1c
[3.12] Bump various dependencies in Doc/requirements-oldest-sphinx.txt (GH-110278) (#110280)
Bump various dependencies in `Doc/requirements-oldest-sphinx.txt` (GH-110278)

This resolves a Dependabot security alert on the repository for urllib3==2.0.4.
(cherry picked from commit f1663a492e)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-10-03 13:18:09 +00:00
Miss Islington (bot)
64afbf6f28
[3.12] Fix typo in py312 whatsnew: add missing closing paren (GH-110255) (#110257)
Fix typo in py312 whatsnew: add missing closing paren (GH-110255)
(cherry picked from commit 8c071373f1)

Co-authored-by: Lele Gaifax <lele@metapensiero.it>
2023-10-03 06:20:20 +00:00
Raymond Hettinger
221c8d64e6
[3.12] Sync factor() recipe with main branch (gh-110231) 2023-10-02 14:19:46 -05:00
Alex Waygood
25bf0564c4
[3.12] Fix typos in docs and comments (#109619) (#109621)
Fix typos in docs and comments (#109619)

Co-authored-by: Heinz-Alexander Fuetterer <35225576+afuetterer@users.noreply.github.com>
2023-10-02 17:34:49 +00:00
Miss Islington (bot)
8296b53027
[3.12] 3.12 What's New: Remove duplicate "up to" (GH-110219) (#110220)
3.12 What's New: Remove duplicate "up to" (GH-110219)
(cherry picked from commit 8d92b6eff3)

Co-authored-by: numbermaniac <5206120+numbermaniac@users.noreply.github.com>
2023-10-02 17:48:57 +02:00
Miss Islington (bot)
b61a4da459
[3.12] gh-109590: Update shutil.which on Windows to prefer a PATHEXT extension on executable files (GH-109995) (#110202)
gh-109590: Update shutil.which on Windows to prefer a PATHEXT extension on executable files (GH-109995)

The default arguments for shutil.which() request an executable file, but extensionless files are not executable on Windows and should be ignored.
(cherry picked from commit 29b875bb93)

Co-authored-by: Charles Machalow <csm10495@gmail.com>
2023-10-02 17:48:30 +02:00
Victor Stinner
5245b97e13
[3.12] gh-109649: Enhance os.cpu_count() documentation (#110169)
* gh-109649: Enhance os.cpu_count() documentation

* Doc: Specify that os.cpu_count() counts *logicial* CPUs.
* Doc: Specify that os.sched_getaffinity(0) is related to the calling
  thread.
* Fix test_posix.test_sched_getaffinity(): restore the old CPU mask
  when the test completes!

* Restore removed text
2023-10-02 17:47:57 +02:00
Miss Islington (bot)
b8a30a4365
[3.12] Add example for linear_regression() with proportional=True. (gh-110133) (#110134)
Add example for linear_regression() with proportional=True. (gh-110133)
(cherry picked from commit 613c0d4e86)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2023-10-02 17:47:28 +02:00
Miss Islington (bot)
5ba9d2b98f
[3.12] gh-108973: Fix asyncio test_subprocess_consistent_callbacks() (GH-109431) (#109609)
gh-108973: Fix asyncio test_subprocess_consistent_callbacks() (GH-109431)

SubprocessProtocol process_exited() method can be called before
pipe_data_received() and pipe_connection_lost() methods. Document it
and adapt the test for that.

Revert commit 282edd7b2a.
_child_watcher_callback() calls immediately _process_exited(): don't
add an additional delay with call_soon(). The reverted change didn't
make _process_exited() more determistic: it can still be called
before pipe_connection_lost() for example.

(cherry picked from commit ced6924630)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Davide Rizzo <sorcio@gmail.com>
2023-10-02 17:03:51 +02:00
Miss Islington (bot)
f4f919e3d8
[3.12] GH-109190: Announce final release in What's New in Python 3.12 (GH-110117) (#110215)
GH-109190: Announce final release in What's New in Python 3.12 (GH-110117)

Prepare What's New in Python 3.12 for final release
(cherry picked from commit 6139bf5e0c)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-10-02 13:26:30 +02:00
Miss Islington (bot)
8811f3d7f9
[3.12] Docs: bump Pygments to fix contrast ratios to meet WCAG AA guidelines (GH-110208) (#110210)
Docs: bump Pygments to fix contrast ratios to meet WCAG AA guidelines (GH-110208)
(cherry picked from commit 9cb8927bfc)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-10-02 12:50:52 +02:00
Miss Islington (bot)
48afd1cf17
[3.12] GH-92584: Move installation schemes overview to sysconfig docs (GH-108018) (#110213)
GH-92584: Move installation schemes overview to sysconfig docs (GH-108018)

* Add new installation path functions subsection

* Add content from install/index to sysconfig

* Fix table

* Update note about installers

* Clean up the list of schemes, remove references to Distutils
(cherry picked from commit f16e81f368)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-10-02 10:50:28 +00:00
Miss Islington (bot)
6f6ca1daa4
[3.12] GH-101100: Fix reference warnings for `namedtuple` (GH-110113) (#110135)
GH-101100: Fix reference warnings for ``namedtuple`` (GH-110113)
(cherry picked from commit cbdacc738a)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-10-02 12:07:58 +02:00
Miss Islington (bot)
b0a8cb2901
[3.12] gh-110138: Improve grammar in idiomatic usage of `__main__.py` (GH-110142) (#110188)
gh-110138: Improve grammar in idiomatic usage of ``__main__.py`` (GH-110142)
(cherry picked from commit adf0f15a06)

Co-authored-by: Quentin Agren <quentin.agren@gmail.com>
2023-10-02 12:03:12 +02:00
Hugo van Kemenade
96110e9429
[3.12] gh-101100: Fix sphinx warnings in library/site.rst (GH-110144) (#110187)
(cherry picked from commit 31097df611)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-10-02 12:02:29 +02:00
Miss Islington (bot)
54ffee0e51
[3.12] GH-101100: Fix reference warnings for `gettext` (GH-110115) (#110140)
GH-101100: Fix reference warnings for ``gettext`` (GH-110115)
(cherry picked from commit 0449fe999d)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-10-02 12:01:26 +02:00
Miss Islington (bot)
8882b30dab
[3.12] gh-109634: Fix :samp: syntax (GH-110073) (#110095)
gh-109634: Fix `:samp:` syntax (GH-110073)
(cherry picked from commit e27adc68cc)

Co-authored-by: Jacob Coffee <jacob@z7x.org>
2023-09-29 15:31:10 +02:00
Miss Islington (bot)
d2a31319a5
[3.12] gh-101100: Fix references to `URLError and HTTPError in howto/urllib2.rst` (GH-107966) (#110086)
gh-101100: Fix references to ``URLError`` and ``HTTPError`` in ``howto/urllib2.rst`` (GH-107966)
(cherry picked from commit bfd94ab9e9)

Co-authored-by: Yuki K <drsuaimqjgar@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-09-29 15:30:44 +02:00
Miss Islington (bot)
c89844aaec
[3.12] gh-101100: Fix Sphinx warnings in tutorial/controlflow.rst (GH-109424) (#110084)
gh-101100: Fix Sphinx warnings in `tutorial/controlflow.rst` (GH-109424)
(cherry picked from commit 8898a8683b)

Co-authored-by: Maciej Olko <maciej.olko@affirm.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-09-29 15:29:39 +02:00
Miss Islington (bot)
297104cce5
[3.12] gh-101100: Fix sphinx warnings in library/difflib.rst (GH-110074) (#110081)
gh-101100: Fix sphinx warnings in `library/difflib.rst` (GH-110074)
(cherry picked from commit d102d39bbe)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-09-29 15:29:14 +02:00