Commit graph

26671 commits

Author SHA1 Message Date
Miss Islington (bot)
cd8fd2292e
[3.11] datamodel: Fix a typo in `object.__init_subclass__` (GH-111599) (#114005)
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:06:14 +00:00
Miss Islington (bot)
2d184b26df
[3.11] Link to the glossary for "magic methods" in `MagicMock` (GH-111292) (#114003)
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:01:09 +00:00
Miss Islington (bot)
e276743682
[3.11] Tutorial: Clarify 'nonzero exit status' in the appendix (GH-112039) (#114000)
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:32 +00:00
Miss Islington (bot)
f8dd29030d
[3.11] Docs: Amend codeobject.co_lines docs; end number is exclusive (GH-113970) (#113988)
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:33 +00:00
Miss Islington (bot)
535b1dedb3
[3.11] GH-107678: Improve Unicode handling clarity in `library/re.rst` (GH-107679) (#113966)
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:35 +00:00
Adam Turner
71288ed8b0
[3.11] GH-92584: Move installation schemes overview to sysconfig docs (GH-108018) (#110214)
* 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)
2024-01-11 23:48:10 +00:00
Steve Dower
186c021688
gh-81489: Use Unicode APIs for mmap tagname on Windows (GH-14133)
Co-authored-by: Zackery Spytz <zspytz@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2024-01-11 23:04:36 +00:00
Miss Islington (bot)
6e21c590f6
[3.11] gh-113625: Align object addresses in the Descriptor HowTo Guide (GH-113894) (#113923)
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:52 +01:00
Serhiy Storchaka
c92a473a71
[3.11] gh-113664: Improve style of Big O notation (GH-113695) (GH-113910)
Use cursive to make it looking like mathematic formulas.
(cherry picked from commit a8629816c6)
2024-01-10 13:13:27 +00:00
Hugo van Kemenade
f20c69299e
[3.11] gh-101100: Fix Sphinx warnings for 2.6 port-specific deprecations (GH-113752) (#113847) 2024-01-09 11:58:59 +02:00
Miss Islington (bot)
3958c7d712
[3.11] Docs: Link tokens in the format string grammars (GH-108184) (#113840)
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:53:59 +00:00
Miss Islington (bot)
6aa86bdcb2
[3.11] gh-113360: Fix the documentation of module's attribute __test__ (GH-113393) (GH-113761)
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:14 +00:00
Miss Islington (bot)
9dd73ccbb0
[3.11] gh-101100: Fix Sphinx warnings in library/pyclbr.rst (GH-113739) (#113749)
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:58 +02:00
Miss Islington (bot)
2a4a724cdf
[3.11] gh-101100: Fix Sphinx warnings for 2.6 deprecations and removals (GH-113725) (#113735)
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:02:07 +02:00
Miss Islington (bot)
99b4f1c3d5
[3.11] gh-113696: Docs: Annotate PyObject_CallOneArg and PyObject_CallNoArgs as returning a strong reference (GH-113697) (#113699)
(cherry picked from commit 1ae7ceba29)

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

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2024-01-03 19:59:10 +00:00
Miss Islington (bot)
3a9bf03ac9
[3.11] functools.partial docs: Use the more common spelling for "referenceable" (GH-113675) (#113678)
`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 13:19:49 +00:00
Ege Akman
d4a28ec89c
[3.11] gh-113637: Let c_annotations.py to handle the spacing of Limited/Unstable API & Stable ABI translation strings (#113638) (#113679) 2024-01-03 15:05:54 +02:00
Hugo van Kemenade
035b6eb987
[3.11] gh-101100: Fix Sphinx warnings from removed ~! references (GH-113629) (#113642)
(cherry picked from commit 7595380347)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-01-02 13:00:06 +00:00
Miss Islington (bot)
f8b61c739b
[3.11] gh-81094: Refer to PEP 318 in compound_statements.rst (GH-113588) (#113644)
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:45:51 +00:00
Hugo van Kemenade
5169113379
[3.11] gh-101100: Fix Sphinx warnings in library/configparser.rst (GH-113598) (#113600)
(cherry picked from commit 30a6d79fb8)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-31 18:18:49 +00:00
Miss Islington (bot)
02912125b4
[3.11] Update ConfigParser docs defining valid section name (GH-110506) (#113590)
Co-authored-by: Delgan <4193924+Delgan@users.noreply.github.com>
2023-12-30 23:24:39 +00:00
Miss Islington (bot)
206dc9a82e
[3.11] gh-89414: Document that SIGCLD is not available on macOS (GH-113580) (#113586)
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:10:11 +01:00
Miss Islington (bot)
2025d9fba2
[3.11] Doc/library/os.rst: os.waitid absent on MacOS (GH-104558) (#113554)
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:19 +01:00
Miss Islington (bot)
4d0b50ac9a
[3.11] gh-101100: Fix Sphinx warnings in library/random.rst (GH-112981) (#113552)
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:46 -07:00
Miss Islington (bot)
f9d25b56e1
[3.11] gh-67641: Clarify documentation on bytes vs text with non-seeking tarfile stream (GH-31610) (GH-113520)
(cherry picked from commit 0651936ae2)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2023-12-27 17:33:00 +00:00
Miss Islington (bot)
050d50a28d
[3.11] gh-101100: Fix Sphinx warnings in library/cmd.rst (GH-113502) (#113510)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-27 10:24:18 +00:00
Miss Islington (bot)
e095f374bb
[3.11] gh-101100: Fix Sphinx warnings in library/calendar.rst (GH-113500) (#113508)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-12-27 09:42:57 +00:00
Hugo van Kemenade
5b5d774679
[3.11] gh-101100: Fix Sphinx warnings in library/bisect.rst (GH-113496) (#113505) 2023-12-26 14:54:07 -07:00
Miss Islington (bot)
86424e06b7
[3.11] gh-101100: Fix Sphinx warnings in howto/isolating-extensions.rst (GH-113493) (#113498)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-12-26 19:47:16 +00:00
Miss Islington (bot)
a3a461648e
[3.11] Docs: make htmllive: open browser when ready (GH-113288) (#113485)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-12-26 12:08:02 +00:00
Miss Islington (bot)
bc6528ee6b
[3.11] docs: specify that PyBytes_AsStringAndSize returns 0 on success (GH-110888) (GH-111691)
(cherry picked from commit 9f33ede127)

Co-authored-by: lefp <70862148+lefp@users.noreply.github.com>
2023-12-25 20:24:44 +02:00
Miss Islington (bot)
478da38e74
[3.11] gh-74573: document that ndbm can silently corrupt databases on macOS (GH-113354) (#113432)
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:58 +01:00
Miss Islington (bot)
0bd134d15f
[3.11] gh-112925: Fix error in example of datetime.time.fromisoformat and add doctest marker (GH-112931) (GH-113428)
(cherry picked from commit bdc8d667ab)

Co-authored-by: F-park <52167622+F-park@users.noreply.github.com>
2023-12-23 10:50:19 +00:00
Miss Islington (bot)
beb1c6506c
[3.11] gh-113313: Note that slice support is not required for all sequences. (gh-113377) (gh-113383) 2023-12-21 22:01:25 +00:00
Miss Islington (bot)
4baa4b519a
[3.11] Docs: OpenSSL wording ambiguity (GH-113296) (#113349)
Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
2023-12-21 07:56:34 +00:00
Alex Waygood
d65dfc8238
[3.11] gh-113255: Clarify docs for typing.reveal_type (#113286) (#113326)
(cherry-picked from commit 11ee912327)

Co-authored-by: Kir <note351@hotmail.com>
2023-12-20 18:35:13 +00:00
Miss Islington (bot)
899f1c082c
[3.11] Fix typo in datamodel docs (GH-113314) (#113315)
Fix typo in datamodel docs (GH-113314)
(cherry picked from commit 5a7cc667f8)

Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-12-20 12:04:59 +00:00
Miss Islington (bot)
f1c27bebb2
[3.11] Fix typo in collections.abc docs example (GH-113310) (#113312)
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:25 +00:00
Hugo van Kemenade
182676beba
[3.11] gh-101100: Fix Sphinx warnings in library/ast.rst (GH-113289) (#113291) 2023-12-19 18:12:33 +02:00
Miss Islington (bot)
208c95bffe
[3.11] gh-113234: tomllib docs: reorder conversion table & add remaining types (GH-113236) (GH-113284)
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:36:01 +00:00
Miss Islington (bot)
d6830c7cbf
[3.11] gh-113208: Mention namespace packages don't require __init__.py (GH-113209) (#113277)
Co-authored-by: Unique-Usman <86585626+Unique-Usman@users.noreply.github.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-12-19 08:46:08 +00:00
Hugo van Kemenade
bd8aa9d8bd
[3.11] gh-101100: Fix Sphinx warnings in library/tarfile.rst (GH-113237) (#113245) 2023-12-18 07:12:52 +00:00
Miss Islington (bot)
559951304f
[3.11] Docs: Add label to grammar spec for linking from PEPs (GH-113235) (#113240)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-12-17 19:29:23 +00:00
Miss Islington (bot)
b0b7fee7cb
[3.11] gh-112890: unittest Test Discovery page updated "unittest dropped the namspace packages support" (GH-113195) (GH-113229)
(cherry picked from commit 21d52995ea)

Co-authored-by: Taylor Packard <3.t.packard@gmail.com>
2023-12-17 11:20:28 +00:00
Ronald Oussoren
11401e2c79
[3.11] gh-105912: document gotcha with using os.fork on macOS (GH-112871) (#113135)
* 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: Carol Willing <carolcode@willingconsulting.com>
2023-12-16 10:13:01 +01:00
Miss Islington (bot)
2be7a7296f
[3.11] gh-113046: Revise csv.reader doc (GH-113207) (#113211)
Clarify nature of csvfile.
(cherry picked from commit 84df3172ef)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2023-12-16 08:18:45 +00:00
Miss Islington (bot)
a7a176de07
[3.11] gh-110746: Improve markup in `tkinter.ttk.rst` (GH-111236) (#113194)
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:56:36 +01:00
Miss Islington (bot)
bbc70451e0
[3.11] gh-101100: Fix various Sphinx warnings for dunder references in the library/ directory (GH-113163) (#113184)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-15 17:21:59 +00:00
Miss Islington (bot)
740d5da5d9
[3.11] gh-101100: Fix Sphinx nitpicks in library/numbers.rst (GH-113162) (#113181)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-12-15 19:17:14 +02:00