Commit graph

12680 commits

Author SHA1 Message Date
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
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)
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)
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)
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
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
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
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
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
Miss Islington (bot)
5a122ad7e7
[3.12] gh-101100: Fix Sphinx warnings in library/random.rst (GH-112981) (#113551)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-28 12:40:21 -07:00
Miss Islington (bot)
72410a3ecf
[3.12] gh-67641: Clarify documentation on bytes vs text with non-seeking tarfile stream (GH-31610) (GH-113519)
(cherry picked from commit 0651936ae2)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2023-12-27 17:32:10 +00:00
Hugo van Kemenade
6177a852c4
[3.12] gh-101100: Fix Sphinx warnings in library/cmd.rst (GH-113502) (#113511)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-27 10:27:13 +00:00
Hugo van Kemenade
11fd024286
[3.12] gh-101100: Fix Sphinx warnings in library/calendar.rst (GH-113500) (#113509) 2023-12-27 09:45:32 +00:00
Miss Islington (bot)
356f59677e
[3.12] gh-101100: Fix Sphinx warnings in library/bisect.rst (GH-113496) (#113504)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-12-26 14:54:02 -07:00
Miss Islington (bot)
8a95500367
[3.12] Misc minor improvements to the itertools recipes (gh-113477) (gh-113478) 2023-12-25 22:32:05 +00:00
Miss Islington (bot)
c0e58168e2
[3.12] [doc] Make subprocess.wait documentation more precise (GH-98700) (GH-112153)
An active loop is only used when the `timeout` parameter is used on
POSIX.

When no timeout is used, the code calls `os.waitpid` internally (which puts
the process on a sleep status). On Windows, the internal Windows API
call accepts a timeout parameter, so that is delegated to the OS.
(cherry picked from commit 81ab0e8a4a)

Co-authored-by: Luis Pedro Coelho <luis@luispedro.org>
2023-12-25 20:27:06 +02:00
Miss Islington (bot)
4882d508be
[3.12] gh-74573: document that ndbm can silently corrupt databases on macOS (GH-113354) (#113431)
gh-74573: document that ndbm can silently corrupt databases on macOS (GH-113354)

* gh-74573: document that ndbm can silently corrupt databases on macOS

The system ndbm implementation on macOS has an undocumented limitation
on the size of values and can silently corrupt database files when those
are exceeded.

(cherry picked from commit 593b4d81d2)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2023-12-23 13:49:33 +01:00
Miss Islington (bot)
fee2bc15f9
[3.12] gh-112925: Fix error in example of datetime.time.fromisoformat and add doctest marker (GH-112931) (GH-113427)
(cherry picked from commit bdc8d667ab)

Co-authored-by: F-park <52167622+F-park@users.noreply.github.com>
2023-12-23 10:50:00 +00:00
Miss Islington (bot)
8836c2d91a
[3.12] Docs: OpenSSL wording ambiguity (GH-113296) (#113348)
Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
2023-12-21 07:56:06 +00:00
Miss Islington (bot)
b01caf1d9d
[3.12] gh-113255: Clarify docs for typing.reveal_type (GH-113286) (#113323)
gh-113255: Clarify docs for `typing.reveal_type` (GH-113286)
(cherry picked from commit 11ee912327)

Co-authored-by: Kir <note351@hotmail.com>
Co-authored-by: AlexWaygood <alex.waygood@gmail.com>
2023-12-20 17:36:45 +00:00
Miss Islington (bot)
68743e4473
[3.12] Fix typo in collections.abc docs example (GH-113310) (#113311)
Fix typo in collections.abc docs example (GH-113310)

Calling the instance reference arg for the __next__ method, "next", seems misleading as it would normally just be "self"
(cherry picked from commit 22b8945d76)

Co-authored-by: David Greaves <david@dgreaves.com>
2023-12-20 09:57:48 +00:00
Hugo van Kemenade
72bbd88876
[3.12] gh-101100: Fix Sphinx warnings in library/ast.rst (GH-113289) (#113290) 2023-12-19 18:12:30 +02:00
Miss Islington (bot)
077cb7cae6
[3.12] gh-113234: tomllib docs: reorder conversion table & add remaining types (GH-113236) (GH-113283)
gh-113234: tomllib docs: reorder conversion table & add remaining types (GH-113236)
(cherry picked from commit 76d757b38b)

Co-authored-by: ryan-duve <ryan-duve@users.noreply.github.com>
2023-12-19 10:35:40 +00:00
Hugo van Kemenade
e23657f0f2
[3.12] gh-101100: Fix Sphinx warnings in library/tarfile.rst (GH-113237) (#113244) 2023-12-18 07:11:35 +00:00
Miss Islington (bot)
48e1558c23
[3.12] gh-112890: unittest Test Discovery page updated "unittest dropped the namspace packages support" (GH-113195) (GH-113228)
(cherry picked from commit 21d52995ea)

Co-authored-by: Taylor Packard <3.t.packard@gmail.com>
2023-12-17 11:20:46 +00:00
Miss Islington (bot)
3bfe2b6c2a
[3.12] gh-105912: document gotcha with using os.fork on macOS (GH-112871) (#113133)
gh-105912: document gotcha with using os.fork on macOS (GH-112871)

* gh-105912: document gotcha with using os.fork on macOS

Using ``fork(2)`` on macOS when also using higher-level
system APIs in the parent proces can crash on macOS because
those system APIs are not written to handle this usage
pattern.

There's nothing we can do about this other than documenting
the problem.

(cherry picked from commit 22511f77c2)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
2023-12-16 10:12:10 +01:00
Miss Islington (bot)
37712aced6
[3.12] gh-113046: Revise csv.reader doc (GH-113207) (#113210)
Clarify nature of csvfile.
(cherry picked from commit 84df3172ef)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-12-16 08:19:01 +00:00
Miss Islington (bot)
d77d62ab79
[3.12] Add reshape() recipe to demonstrate a use case for batched() and chained.from_iterable() (gh-113198) (gh-113201) 2023-12-16 00:09:49 +00:00
Miss Islington (bot)
b9c5ffe6e7
[3.12] Use match/case in grouper() recipe (gh-113059) (gh-113197) 2023-12-15 22:39:11 +00:00
Miss Islington (bot)
85ee49c434
[3.12] Minor stylistic edit to the grouper recipe (gh-112759) (gh-113196) 2023-12-15 16:32:32 -06:00
Miss Islington (bot)
9c32d0267f
[3.12] gh-110746: Improve markup in `tkinter.ttk.rst` (GH-111236) (#113193)
gh-110746: Improve markup in ``tkinter.ttk.rst`` (GH-111236)

* gh-110746: Improve markup in tkinter.ttk.rst

* gh-110746: Improve markup in tkinter.ttk.rst

* 📜🤖 Added by blurb_it.

---------

(cherry picked from commit 00d2b6d1fc)

Co-authored-by: Akshat Khandelwal <35228810+akshatgokul@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2023-12-15 22:03:51 +01:00
Miss Islington (bot)
00324a77da
[3.12] gh-101100: Fix various Sphinx warnings for dunder references in the library/ directory (GH-113163) (#113183)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-15 17:22:07 +00:00
Hugo van Kemenade
e3396b2995
[3.12] gh-101100: Fix Sphinx nitpicks in library/numbers.rst (GH-113162) (#113182)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-15 17:21:09 +00:00
Miss Islington (bot)
6259dfa945
[3.12] gh-101100: Fix Sphinx nitpicks in library/rlcompleter.rst (GH-113125) (#113158)
gh-101100: Fix Sphinx nitpicks in `library/rlcompleter.rst` (GH-113125)
(cherry picked from commit 7bb00f053e)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-15 09:04:31 +00:00
Miss Islington (bot)
614691a7e7
[3.12] Optimize unique_justseen() recipe for a common case. (gh-113147) (gh-113150) 2023-12-14 23:34:00 +00:00
Hugo van Kemenade
eda168f99e
[3.12] gh-101100: Cleanup mailbox docs (GH-113124) (#113144)
(cherry picked from commit 25061f5c98)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-14 21:26:26 +00:00
Miss Islington (bot)
b4eeb97f1b
[3.12] Remove itertool recipe with low pedagogical value (gh-113138) (gh-113140) 2023-12-14 20:42:36 +00:00
Miss Islington (bot)
15114517dd
[3.12] gh-101100: Fix Sphinx nitpicks in library/collections.abc.rst (GH-113116) (#113136)
gh-101100: Fix Sphinx nitpicks in `library/collections.abc.rst` (GH-113116)
(cherry picked from commit 006355b2a9)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-14 19:32:30 +00:00