Commit graph

26779 commits

Author SHA1 Message Date
Miss Islington (bot)
95a82dcbe7
[3.12] gh-107091: Fix the use of some C domain roles (GH-107092) (GH-107113)
(cherry picked from commit 08a228da05)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2023-07-23 14:50:21 +03:00
Moritz Neeb
074fcf15fa
[3.12] gh-106969: Indicate no modules were added in 3.10 & 3.12 (GH-106988) (#107094)
The "New Modules" section was left in place to ensure that the anchor
link for new modules will still exist:

/whatsnew/3.12.htmlGH-new-modules
/whatsnew/3.10.htmlGH-new-modules

This means that existing links to this section don't break.
(cherry picked from commit 6dbffaed17)

Co-authored-by: Sebastiaan Zeeff <33516116+SebastiaanZ@users.noreply.github.com>
2023-07-23 12:26:05 +02:00
Daniele Procida
f7e13002ff
[3.12] gh-106996: Add the basics of a turtle graphics tutorial (GH-107072) (#107109) 2023-07-23 04:22:05 -06:00
Miss Islington (bot)
332db37835
[3.12] gh-101100: Fix some broken sphinx references (GH-107095) (#107103)
(cherry picked from commit f5147c0cfb)

Co-authored-by: wulmer <wulmer@users.noreply.github.com>
2023-07-23 12:00:31 +02:00
Miss Islington (bot)
a73d5c5e2e
[3.12] gh-106976: alphabetise bullets by module name task2-3 (GH-107005) (#107106)
Co-authored-by: littlebutt's workshop <luogan199686@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-07-23 09:44:39 +00:00
Miss Islington (bot)
63ae7edd35
[3.12] gh-54738: Add argparse i18n howto (GH-104562) (#107102)
(cherry picked from commit dcd7acb04a)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>
2023-07-23 11:36:10 +02:00
Sviatoslav Sydorenko
1703262c0a
[3.12] Convert doc.yml workflow to be reusable (GH-103914 + GH-105151) (#107042)
Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

(cherry picked from commit 88d14da76f)
(cherry picked from commit eaa6702280)
2023-07-23 11:35:17 +02:00
Serhiy Storchaka
456cf8b097
[3.12] gh-106948: Add standard external names to nitpick_ignore (GH-106949) (#107060)
* [3.12] gh-106948: Add standard external names to nitpick_ignore (GH-106949)

It includes standard C types, macros and variables like "size_t",
"LONG_MAX" and "errno", and standard environment variables like "PATH".

(cherry picked from commit f8b7fe2f26)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

* Delete 2023-05-31-18-37-57.gh-issue-105156.R4El5V.rst
2023-07-23 11:24:51 +02:00
Miss Islington (bot)
98626c3c71
[3.12] gh-107017: removed mention that C does it the same way (GH-107020) (#107097)
Co-authored-by: Jakub Červinka <cervinka.jakub.1989@gmail.com>
2023-07-23 03:11:26 -06:00
Miss Islington (bot)
a80721b83d
[3.12] gh-71261: Add paragraph on shadowing submodules with star imports (GH-107004) (#107100)
Co-authored-by: wulmer <wulmer@users.noreply.github.com>
2023-07-23 09:01:24 +00:00
Miss Islington (bot)
52804b3801
[3.12] gh-102111: Add link to string escape sequences in re module (GH-106995) (#107096)
Co-authored-by: wulmer <wulmer@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-07-23 02:59:16 -06:00
Miss Islington (bot)
bd907dcc50
gh-106847: Add -X warn_default_encoding in sys.flags Doc (GH-106854)
gh-106847: Add -X warn_default_encoding in sys.flags Doc (GH-106854)
(cherry picked from commit fd84ac0ee0)

Co-authored-by: qqwqqw689 <114795525+qqwqqw689@users.noreply.github.com>
Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-07-23 06:15:19 +09:00
Miss Islington (bot)
dd431d791f
[3.12] gh-107028: tiny textual changes in logging docs and docstrings (GH-107029) (GH-107065)
(cherry picked from commit 5e5a34ac3a)
2023-07-22 22:11:29 +01:00
Miss Islington (bot)
0fff068181
[3.12] gh-83006: Document behavior of shutil.disk_usage for non-mounted filesystems on Unix (GH-107031) (#107047)
(cherry picked from commit 6e5f2235f3)

Co-authored-by: Matthieu Caneill <matthieucan@users.noreply.github.com>
2023-07-22 20:25:03 +02:00
Miss Islington (bot)
3889d39471
[3.12] gh-107008: Document the curses module variables LINES and COLS (GH-107011) (GH-107057)
LINES and COLS referred in curses.update_lines_cols() documentations are
the module variables, not the environment variables.
(cherry picked from commit 26e08dfdd7)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2023-07-22 21:12:58 +03:00
Miss Islington (bot)
844bdce712
[3.12] Fix Sphinx warnings in re module docs (GH-107044) (#107046)
Fix Sphinx warnings in `re` module docs (GH-107044)
(cherry picked from commit 149748ea4f)

Co-authored-by: wulmer <wulmer@users.noreply.github.com>
2023-07-22 16:54:02 +01:00
Miss Islington (bot)
c8a0296901
[3.12] gh-105090: Replace incorrect TLSv1.2 with TLSv1.3 (GH-105404) (#107040)
Co-authored-by: Jocelyn Castellano <admin@malwarefight.gq>
2023-07-22 14:30:28 +00:00
Miss Islington (bot)
e7757ab9e1
[3.12] Reformat code block to make it easier to read (GH-106965) (#107010)
(cherry picked from commit ed491d9f78)

Co-authored-by: Joe Kaufeld <opensource@joekaufeld.com>
2023-07-22 14:54:13 +02:00
Miss Islington (bot)
9cbde7c6ce
[3.12] gh-106973: Change non-integral to non-integer in "3.12 What's New" (GH-106984) (#106986)
Co-authored-by: Sebastiaan Zeeff <33516116+SebastiaanZ@users.noreply.github.com>
2023-07-22 02:40:37 -06:00
Serhiy Storchaka
ffc7678f46
[3.12] gh-106892: Use roles :data: and :const: for referencing module variables (GH-106894) (GH-106954)
(cherry picked from commit d036db728e)
2023-07-21 14:51:00 +03:00
Serhiy Storchaka
84e52171b5
[3.12] gh-106909: Use role :const: for referencing module constants (GH-106910) (GH-106956)
(cherry picked from commit 4b9948617f)
2023-07-21 14:49:39 +03:00
Serhiy Storchaka
ac9aa8a369
[3.12] gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920) (GH-106951)
(cherry picked from commit fcc816dbff)
2023-07-21 14:48:15 +03:00
Miss Islington (bot)
1a3766bb3e
[3.12] Docs: Argument Clinic: Add Background and Tutorial top-level sections (GH-106904) (#106945)
Docs: Argument Clinic: Add Background and Tutorial top-level sections (GH-106904)

Add Background as a toplevel section with the following subsections:

- Background
  - The goals of Argument Clinic
  - Basic concepts and usage

Rename "Converting your first function" to Tutorial.

Add anchors for Background, Tutorial, and How-to Guides:

- :ref:`clinic-background`
- :ref:`clinic-tutorial`
- :ref:`clinic-howtos`

Link to these from within the Abstract.

Break the compatibility paragraph out of Abstract and make it a note.
(cherry picked from commit 81861fd90b)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2023-07-21 08:18:18 +02:00
Gregory P. Smith
656f62454b
[3.12] gh-106669: Revert "gh-102988: Detect email address parsing errors ... (GH-105127)" (GH-106733) (#106941)
This reverts commit 18dfbd0357.
Adds a regression test from the issue.

See https://github.com/python/cpython/issues/106669..
(cherry picked from commit a31dea1feb)
2023-07-21 04:05:46 +00:00
Miss Islington (bot)
c1fd76e138
[3.12] Fix typo in tkinter docs (GH-106936) (#106937)
Fix typo in tkinter docs (GH-106936)
(cherry picked from commit 60e83968d5)

Signed-off-by: Makonede <61922615+Makonede@users.noreply.github.com>
Co-authored-by: Makonede <61922615+Makonede@users.noreply.github.com>
2023-07-21 00:11:52 +01:00
Miss Islington (bot)
c16cf9b6e5
[3.12] gh-106882: Note that asyncio.Server is only publicly exposed on 3.11+ (GH-106901) (#106902)
gh-106882: Note that `asyncio.Server` is only publicly exposed on 3.11+ (GH-106901)

And later versions of 3.10, 3.9
(cherry picked from commit 1e1f4e91a9)

Co-authored-by: Jack Nelson <jack@jacknelson.xyz>
2023-07-19 21:03:56 +01:00
Miss Islington (bot)
0c106a91e8
[3.12] Docs: Argument Clinic: Group guides about default values (GH-106872) (#106874)
Docs: Argument Clinic: Group guides about default values (GH-106872)

Previous ToC layout (excerpt):

    - How to use symbolic default values
    ...
    - How to assign default values to parameter
      - How to use the ``NULL`` default value
      - How to use expressions as default values

New layout:

    - How to assign default values to parameter
      - The ``NULL`` default value
      - Symbolic default values
      - Expressions as default values

(cherry picked from commit 505eede38d)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
2023-07-19 01:16:19 +02:00
Miss Islington (bot)
b79f3b36c3
[3.12] Docs: Normalise Argument Clinic advanced topics headings (GH-106842) (#106853)
(cherry picked from commit 4cb0b9c0a9)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2023-07-18 12:24:44 +02:00
Miss Islington (bot)
11b3d38310
[3.12] gh-106780: Add __match_args__ to tutorial example (GH-106784) (#106819)
Add Point definition with this attribute before example
that needs it.
(cherry picked from commit 7aa89e505d)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-07-17 04:15:35 -04:00
Miss Islington (bot)
9c00dc02cf
[3.12] Add more recipe tests. Make the factor recipe a bit faster and clearer. (GH-106817) (GH-106818) 2023-07-16 21:47:58 -05:00
Inada Naoki
0afd530505
Doc: fix section levels of devmode doc (GH-106801)
(cherry picked from commit e58960160f)
2023-07-16 21:25:35 +09:00
Miss Islington (bot)
30c8915a19
[3.12] Docs search: Replace jQuery with vanilla JavaScript (GH-106743) (#106802)
Docs search: Replace jQuery with vanilla JavaScript (GH-106743)

* Replace jQuery with vanilla JavaScript
* Switch 'var' to 'const' or 'let'
(cherry picked from commit c02ee45031)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-07-16 11:38:08 +03:00
Miss Islington (bot)
e4658bf44e
Doc: devmode: add -Xdev option to example (GH-106253)
Doc: devmode: add -Xdev option to example (GH-106253)
(cherry picked from commit 83bd568d2b)

Co-authored-by: Simone Rubino <daemo00@gmail.com>
2023-07-16 16:32:26 +09:00
Miss Islington (bot)
30c127fcec
[3.12] Docs: Normalize Argument Clinic How-To section capitalization (GH-106788) (#106791)
(cherry picked from commit 8c17729489)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
2023-07-15 22:43:46 +00:00
Miss Islington (bot)
18d98bacb6
[3.12] Add more examples to the recipe docs (GH-106782) (GH-106783) 2023-07-15 15:09:20 -05:00
Alex Waygood
e99b69c5ae
[3.12] gh-106745: typing docs: Clarify that removal of PEP-585 aliases is not currently planned (#106748) (#106772) 2023-07-15 11:31:12 +01:00
Miss Islington (bot)
00eb4355e3
[3.12] gh-106446: Fix failed doctest in stdtypes (GH-106447) (#106741)
(cherry picked from commit 89867d2491)

Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-07-14 04:01:35 -04:00
Miss Islington (bot)
e68b280671
[3.12] gh-105626: Change the default return value of HTTPConnection.get_proxy_response_headers (GH-105628) (#106738)
gh-105626: Change the default return value of `HTTPConnection.get_proxy_response_headers` (GH-105628)
(cherry picked from commit 490295d651)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2023-07-14 07:21:02 +00:00
Yonatan Bitton
ec7b05a0be
[3.12] gh-96747: Mention the PyPI passlib package in the crypt deprecation doc (GH-106660) (#106660)
* Added mention to passlib package as alternative to the deprecated crypt module.
2023-07-12 14:58:51 -07:00
Miss Islington (bot)
ae31599143
[3.12] Add Plausible for docs metrics (GH-106644) (#106661)
Add Plausible for docs metrics (GH-106644)
(cherry picked from commit e8ab0096a5)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-07-12 05:46:12 +03:00
Miss Islington (bot)
e248ba7b72
[3.12] gh-96165: Clarify passing ":memory:" in sqlite3.connect() (GH-106451) (#106647)
(cherry picked from commit f520804b03)

Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2023-07-11 22:31:48 +02:00
Miss Islington (bot)
bf7e92583d
[3.12] gh-96165: Clarify omitting the FROM clause in SQLite queries (GH-106513) (#106645)
(cherry picked from commit fc7ff1af45)

Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2023-07-11 22:31:16 +02:00
Miss Islington (bot)
139e7ac7c2
[3.12] gh-106625 : Add missing code to tutorial 4.6 example (GH-106623) (#106636)
(cherry picked from commit d0b7e18262)

Co-authored-by: RustyNail <takonoyawarakaage@yahoo.co.jp>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-07-11 13:40:59 -04:00
Miss Islington (bot)
2eb9fe92b4
[3.12] gh-103968: What's New: Add porting hints for PyType_From with metaclasses (GH-105698) (GH-106619)
gh-103968: What's New: Add porting hints for PyType_From with metaclasses (GH-105698)
(cherry picked from commit af5cf1e751)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2023-07-11 13:53:40 +02:00
Miss Islington (bot)
30870c834c
[3.12] gh-102988: Detect email address parsing errors and return empty tuple to indicate the parsing error (old API) (GH-105127) (#106612)
gh-102988: Detect email address parsing errors and return empty tuple to indicate the parsing error (old API) (GH-105127)

Detect email address parsing errors and return empty tuple to indicate the parsing error (old API). This fixes or at least ameliorates CVE-2023-27043.

---------

(cherry picked from commit 18dfbd0357)

Co-authored-by: Thomas Dwyer <github@tomd.tel>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
2023-07-10 23:38:42 +00:00
Miss Islington (bot)
41057b2ffe
[3.12] gh-105227: Add PyType_GetDict() (GH-105747) (#106600)
gh-105227: Add PyType_GetDict() (GH-105747)

This compensates for static builtin types having `tp_dict` set to `NULL`.

(cherry picked from commit a840806d33)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2023-07-10 17:12:15 +00:00
Miss Islington (bot)
0481b805d6
[3.12] Clarify how topics.py gets created. (GH-106121) (#106579)
Clarify how topics.py gets created. (GH-106121)

When changing docs, it was easy to find text in topics.py, and I
wondered whether I was supposed to edit it.  Thankfully, the top of the
file says it's auto-generated, so I knew I didn't have to edit it. But I
didn't know what started the auto-generation process.

It's part of the release process, so I'll leave a note here for future
editors.
(cherry picked from commit dac1e36490)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2023-07-09 20:42:22 -07:00
Miss Islington (bot)
128a962482
[3.12] gh-106461: typing: Consolidate docs on Callable (GH-106462) (#106574)
gh-106461: typing: Consolidate docs on `Callable` (GH-106462)
(cherry picked from commit ca8b55c7f5)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-07-09 22:21:54 +01:00
Miss Islington (bot)
48f58e0243
[3.12] gh-101880: add link to object.__hash__() in hash() builtin documentation (GH-101883) (#106546)
gh-101880: add link to object.__hash__() in hash() builtin documentation (GH-101883)
(cherry picked from commit ec7180bd1b)

Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
2023-07-08 14:22:50 +05:30
Miss Islington (bot)
e229225fba
[3.12] Clarify state of CancelledError in doc (GH-106453) (#106454)
Clarify state of CancelledError in doc (GH-106453)

This change makes it explicit that asyncio.CancelledError is not a subclass of Exception.
(cherry picked from commit 12a9813808)

Co-authored-by: Kristján Valur Jónsson <sweskman@gmail.com>
2023-07-06 16:34:43 +05:30