Commit graph

27306 commits

Author SHA1 Message Date
Miss Islington (bot)
55b73a5c78
[3.12] gh-114231: Fix indentation in enum.rst (GH-114232) (#114234)
Co-authored-by: Miyashita Yosuke <44266492+miyashiiii@users.noreply.github.com>
2024-01-18 09:29:34 +00:00
Miss Islington (bot)
87198f6c23
[3.12] gh-114211: Update EmailMessage doc about ordered keys (GH-114224) (#114225)
Ordered keys are no longer unlike 'real dict's.
(cherry picked from commit 8cda72037b)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2024-01-17 21:55:40 -05:00
Miss Islington (bot)
01344cfe9e
[3.12] Fix typo in tkinter.ttk.rst (GH-106157) (GH-114200)
(cherry picked from commit 7573c44c32)

Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>
2024-01-17 21:23:50 +02:00
Miss Islington (bot)
74a6b7f639
[3.12] gh-114070: fix token reference warnings in expressions.rst (GH-114169) (#114192)
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-01-17 16:46:02 +00:00
Miss Islington (bot)
27941b14ab
[3.12] gh-102468: Document PyCFunction_New* and PyCMethod_New (GH-112557) (GH-114119)
gh-102468: Document `PyCFunction_New*` and `PyCMethod_New` (GH-112557)
(cherry picked from commit a482bc67ee)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2024-01-17 10:21:08 +01:00
Miss Islington (bot)
5af161ffe6
[3.12] gh-72284: Revise lists in IDLE doc (GH-114174) (#114175)
Tkinter is a fact, not necessarily a feature.

Reorganize editor key bindings in a logical order
and remove those that do not work, at least on Windows.

Improve shell bindings list.
(cherry picked from commit 4a32275389)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2024-01-17 03:35:19 -05:00
Miss Islington (bot)
5b08b24f89
[3.12] gh-112043: Align concurrent.futures.Executor.map docs with implementation (GH-114153) (#114164)
The first parameter is named 'fn', not 'func'.
(cherry picked from commit 8d26db45df)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
2024-01-17 01:37:30 +00:00
Miss Islington (bot)
12c6424205
[3.12] gh-88531 Fix dataclass __post_init__/__init__ interplay documentation (gh-107404) (#114162)
* Simplify __post_init__ example usage. It applies to all base classes, not just dataclasses.
(cherry picked from commit 05008c27b7)

Co-authored-by: Steffen Zeile <48187781+Kaniee@users.noreply.github.com>
2024-01-17 01:33:02 +00:00
Miss Islington (bot)
50bb9c69e1
[3.12] gh-94220: Align fnmatch docs with the implementation and amend markup (GH-114152) (#114155)
- Align the argument spec for fnmatch functions with the actual
  implementation.
- Update Sphinx markup to recent recommandations.
- Add link to 'iterable' glossary entry.

(cherry picked from commit 6e84f3b56f)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-01-16 23:42:29 +01:00
Barney Gale
0ee681a665
[3.12] GH-78988: Document pathlib.Path.glob() exception propagation. (GH-114036) (#114154)
We propagate the `OSError` from the `is_dir()` call on the top-level
directory, and suppress all others.

(cherry picked from commit 7092b3f131)
2024-01-16 22:39:09 +00:00
Erlend E. Aasland
91739149f0
[3.12] Docs: Improve multiprocessing.SharedMemory reference (#114093) (#114137)
(cherry picked from b1db6278cf)

Align the multiprocessing shared memory docs with Diatáxis's
recommendations for references.

- use a parameter list for the SharedMemory.__init__() argument spec
- use the imperative mode
- use versionadded, not versionchanged, for added parameters
- reflow touched lines according to SemBr
2024-01-16 17:17:29 +00:00
Miss Islington (bot)
3eeab87feb
[3.12] gh-114069: Revise Tutorial Methods paragraph (GH-114127) (#114131)
gh-114069: Revise Tutorial Methods paragraph (GH-114127)

Remove excess words in the first and third sentences.
(cherry picked from commit 31a2543c80)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2024-01-16 16:43:20 +00:00
Erlend E. Aasland
4888db15fe
[3.12] Docs: Align multiprocessing.shared_memory docs with Sphinx recommendations (#114103) (#114112)
(cherry picked from commit af85274086)

- add :class: and :mod: markups where needed
- fix incorrect escaping of a star in ShareableList arg spec
- mark up parameters with stars: *val*
- mark up list of built-in types using list markup
- remove unneeded parentheses from :meth: markups
2024-01-16 12:56:07 +00:00
Raymond Hettinger
2b025793e1
[3.12] Update KDE recipe to match the standard use of the h parameter (gh-113958) (#114098) 2024-01-15 22:46:01 -06:00
Miss Islington (bot)
f6315edca1
[3.12] gh-114070: correct the specification of `digit` in the float() docs (GH-114080) (#114094)
gh-114070: correct the specification of ``digit`` in the float() docs (GH-114080)
(cherry picked from commit 4f24b92aa0)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-01-15 22:25:51 +00:00
Hugo van Kemenade
cc11c76da7
[3.12] gh-101100: Fix Sphinx warnings in howto/urllib2.rst and library/http.client.rst (GH-114060) (#114063)
(cherry picked from commit c2808431b3)
2024-01-14 21:14:08 +00:00
Alois Klink
fa7d8e97c2
[3.12] gh-95649: Document that asyncio contains uvloop code (GH-107536) (#114046)
Some of the asyncio SSL changes in GH-31275 [1] were taken from
v0.16.0 of the uvloop project [2]. In order to comply with the MIT
license, we need to just need to document the copyright information.

[1]: https://github.com/python/cpython/pull/31275
[2]: https://github.com/MagicStack/uvloop/tree/v0.16.0

(cherry picked from commit dce30c9cbc)
2024-01-14 02:15:06 +00:00
Ronald Oussoren
94b1d1fa38
[3.12] gh-114021: Pin various sphinxcontrib extensions to older versions (#114022) 2024-01-13 17:39:02 +00:00
Miss Islington (bot)
1ea6658342
[3.12] gh-89159: Document missing TarInfo members (GH-91564) (#114006)
gh-89159: Document missing TarInfo members (GH-91564)
(cherry picked from commit 3aa4b839e4)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2024-01-12 23:26:08 +00:00
Miss Islington (bot)
d577225104
[3.12] datamodel: Fix a typo in `object.__init_subclass__` (GH-111599) (#114004)
datamodel: Fix a typo in ``object.__init_subclass__`` (GH-111599)
(cherry picked from commit a47353d587)

Co-authored-by: InSync <122007197+InSyncWithFoo@users.noreply.github.com>
2024-01-12 23:05:48 +00:00
Miss Islington (bot)
b9e15bef82
[3.12] Link to the glossary for "magic methods" in `MagicMock` (GH-111292) (#114002)
Link to the glossary for "magic methods" in ``MagicMock`` (GH-111292)

The MagicMock documentation mentions magic methods several times without
actually pointing to the term in the glossary. This can be helpful for
people to fully understand what those magic methods are.
(cherry picked from commit e97da8677f)

Co-authored-by: Pierre Equoy <pierre.equoy@canonical.com>
2024-01-12 23:00:50 +00:00
Miss Islington (bot)
68d1e30c94
[3.12] Tutorial: Clarify 'nonzero exit status' in the appendix (GH-112039) (#113999)
Tutorial: Clarify 'nonzero exit status' in the appendix (GH-112039)
(cherry picked from commit 32f3684b8f)

Co-authored-by: Andrew Zipperer <47086307+zipperer@users.noreply.github.com>
2024-01-12 22:48:59 +00:00
Miss Islington (bot)
eb22afb004
[3.12] Docs: Amend codeobject.co_lines docs; end number is exclusive (GH-113970) (#113987)
The end number should be exclusive, not inclusive.
(cherry picked from commit e68806c712)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2024-01-12 15:10:43 +00:00
Miss Islington (bot)
d50d074cd9
[3.12] Improve kde graph with better caption and number formatting (gh-113967) (gh-113968) 2024-01-11 18:49:10 -06:00
Miss Islington (bot)
bd9ea91e5f
[3.12] GH-107678: Improve Unicode handling clarity in `library/re.rst` (GH-107679) (#113965)
GH-107678: Improve Unicode handling clarity in ``library/re.rst`` (GH-107679)
(cherry picked from commit c9b8a22f34)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-01-12 00:02:28 +00:00
Miss Islington (bot)
b902671d36
gh-81489: Use Unicode APIs for mmap tagname on Windows (GH-14133)
(cherry picked from commit b4d4aa9e8d)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2024-01-11 23:13:02 +00:00
Miss Islington (bot)
5c238225f6
[3.12] gh-112419: Document removal of sys.meta_path's 'find_module' fallback (GH-112421) (#113934)
(cherry picked from commit ec23e90082)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2024-01-11 09:49:21 +00:00
Miss Islington (bot)
3fc45e6c4e
[3.12] gh-113625: Align object addresses in the Descriptor HowTo Guide (GH-113894) (#113922)
gh-113625: Align object addresses in the Descriptor HowTo Guide (GH-113894)
(cherry picked from commit 901a971e16)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2024-01-10 18:32:54 +01:00
Miss Islington (bot)
082998c3af
[3.12] gh-113664: Improve style of Big O notation (GH-113695) (GH-113909)
Use cursive to make it looking like mathematic formulas.
(cherry picked from commit a8629816c6)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-01-10 13:08:08 +00:00
Miss Islington (bot)
159e3db1f7
[3.12] GH-113661: unittest runner: Don't exit 5 if tests were skipped (GH-113856) (#113875)
GH-113661: unittest runner: Don't exit 5 if tests were skipped (GH-113856)

The intention of exiting 5 was to detect issues where the test suite
wasn't discovered at all. If we skipped tests, it was correctly
discovered.
(cherry picked from commit 3a9096c337)

Co-authored-by: Stefano Rivera <stefano@rivera.za.net>
2024-01-09 13:34:38 -08:00
Miss Islington (bot)
9a6b99ee8b
[3.12] Simplify binomial approximation example with random.binomialvariate() (gh-113871) (gh-113872) 2024-01-09 13:24:55 -06:00
Hugo van Kemenade
7e894a4baf
[3.12] gh-101100: Fix Sphinx warnings for 2.6 port-specific deprecations (GH-113752) (#113846) 2024-01-09 11:58:55 +02:00
Miss Islington (bot)
cd87737a1d
[3.12] Docs: Link tokens in the format string grammars (GH-108184) (#113839)
Docs: Link tokens in the format string grammars (GH-108184)
(cherry picked from commit f3d5d4aa8f)

Co-authored-by: William Andrea <william.j.andrea@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2024-01-09 02:54:07 +00:00
Miss Islington (bot)
0b31a50ecd
[3.12] Minor algebraic simplification for the totient() recipe (gh-113822) (gh-113823) 2024-01-08 19:22:42 +00:00
Miss Islington (bot)
d43f2ad6d9
[3.12] gh-113360: Fix the documentation of module's attribute __test__ (GH-113393) (GH-113760)
It can only be a dict since Python 2.4.
(cherry picked from commit d99d871225)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-01-05 22:29:31 +00:00
Miss Islington (bot)
05a2546e85
[3.12] gh-101100: Fix Sphinx warnings in library/pyclbr.rst (GH-113739) (#113748)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-01-05 21:36:31 +02:00
Miss Islington (bot)
1dc25ae0da
[3.12] gh-101100: Fix Sphinx warnings for 2.6 deprecations and removals (GH-113725) (#113734)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-01-05 16:01:58 +02:00
Miss Islington (bot)
6f90399c23
[3.12] gh-113696: Docs: Annotate PyObject_CallOneArg and PyObject_CallNoArgs as returning a strong reference (GH-113697) (#113698)
(cherry picked from commit 1ae7ceba29)

Co-authored-by: Jamie Phan <jamie@ordinarylab.dev>
2024-01-05 01:17:15 +01:00
Alex Waygood
d3f2051eec
[3.12] Document the co_lines method on code objects (#113682) (#113686)
(cherry-picked from commit f1f8392432)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-01-03 20:09:15 +00:00
Hugo van Kemenade
d2cdc6717a
[3.12] gh-101100: Fix Sphinx warnings for removed dead batteries (GH-113669) (#113681)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>.
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-01-03 15:50:10 +02:00
Miss Islington (bot)
5f3fe8448c
[3.12] gh-113637: Let c_annotations.py to handle the spacing of Limited/Unstable API & Stable ABI translation strings (GH-113638) (#113676)
Co-authored-by: Ege Akman <egeakmanegeakman@hotmail.com>
2024-01-03 14:57:32 +02:00
Miss Islington (bot)
c267901289
[3.12] functools.partial docs: Use the more common spelling for "referenceable" (GH-113675) (#113677)
`functools.partial` docs: Use the more common spelling for "referenceable" (GH-113675)
(cherry picked from commit 4de468cce1)

Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2024-01-03 12:57:05 +00:00
Hugo van Kemenade
7643545905
[3.12] gh-101100: Fix Sphinx warnings from removed ~! references (GH-113629) (#113641)
(cherry picked from commit 7595380347)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-01-02 12:59:42 +00:00
Miss Islington (bot)
3b5c2da079
[3.12] gh-81094: Refer to PEP 318 in compound_statements.rst (GH-113588) (#113643)
Co-authored-by: John D. McDonald <43117960+Rasputin2@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-01-02 08:46:01 +00:00
Miss Islington (bot)
c7a1431c43
[3.12] GH- gh-111700: Fix syntax highlighting for C code in the "What's New In Python 3.12" documentation (GH-113609) (#113610)
GH- gh-111700: Fix syntax highlighting for C code in the "What's New In Python 3.12" documentation (GH-113609)

Fix PEP 684 syntax highlighting in what's new Python 3.12
(cherry picked from commit 9ce6c01e38)

Co-authored-by: Parth Doshi <doshi.parth9@gmail.com>
2024-01-01 08:14:31 +00:00
Miss Islington (bot)
f3d3663a47
[3.12] gh-101578: [doc] mention that PyErr_GetRaisedException returns NULL when the error indicator is not set (GH-113369) (#113606)
gh-101578: [doc] mention that PyErr_GetRaisedException returns NULL when the error indicator is not set (GH-113369)
(cherry picked from commit 2849cbb53a)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2023-12-31 23:22:55 +00:00
Hugo van Kemenade
a8011d5eb0
[3.12] gh-101100: Fix Sphinx warnings in library/configparser.rst (GH-113598) (#113599)
(cherry picked from commit 30a6d79fb8)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-31 18:17:33 +00:00
Miss Islington (bot)
9a2dadf689
[3.12] Update ConfigParser docs defining valid section name (GH-110506) (#113589)
Co-authored-by: Delgan <4193924+Delgan@users.noreply.github.com>
2023-12-30 23:24:32 +00:00
Miss Islington (bot)
c4eaae1864
[3.12] gh-89414: Document that SIGCLD is not available on macOS (GH-113580) (#113585)
gh-89414: Document that SIGCLD is not available on macOS (GH-113580)

Document that SIGCLD is not available on macOS
(cherry picked from commit f48a1bcb29)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>
2023-12-30 18:09:50 +01:00
Miss Islington (bot)
f982ab5d72
[3.12] Doc/library/os.rst: os.waitid absent on MacOS (GH-104558) (#113553)
Doc/library/os.rst: `os.waitid` absent on MacOS (GH-104558)

* Doc/library/os.rst: `os.waitid` absent on MacOS

(cherry picked from commit db1c882239)

Co-authored-by: John Hawkinson <jhawk@alum.mit.edu>
Co-authored-by: AN Long <aisk@users.noreply.github.com>
2023-12-29 09:27:04 +01:00