14086 commits

Author	SHA1	Message	Date
Weilin Du	0b62523959	gh-101100: Fix Sphinx warnings in library/email.compat32-message.rst (#136323)	2025-07-07 19:28:44 +03:00
Anthony Sottile	11f074b243	gh-86682: Add versionadded for sys._getframemodulename (#136325) ... add versionadded for sys._getframemodulename	2025-07-07 16:52:04 +05:30
sobolevn	0a33221594	gh-101100: Fix sphinx warnings in whatsnew/3.9 (#136163)	2025-07-07 13:41:11 +03:00
Petr Viktorin	2468aafe98	gh-135755: Document __future__.* and CO_* as proper Sphinx objects (GH-135980) ... * Turn the __future__ table to list-table. This'll make it easier to add entries that need longer markup * Semantic markup for __future__ feature descriptions. * Document CO_* C macros.	2025-07-07 12:31:13 +02:00
Victor Stinner	cb99d99277	gh-127502: Remove XML vulnerability table (GH-135294) ... * Remove the table * Replace warnings with notes Latest releases of Python 3.9-3.15 include expat 2.7.1 which is not vulnerable. expat 2.6.0 was released in February 2024.	2025-07-07 11:03:07 +02:00
AN Long	77a8bd29da	gh-109070: Document that get_context in multiprocessing have side effect (#136341) ... Document that get_context in multiprocessing have side effect	2025-07-06 11:26:26 -07:00
W. H. Wang	1953713d0d	gh-136032: Fix argparse.BooleanOptionalAction doc (#136133)	2025-07-05 15:54:26 -07:00
Weilin Du	f0c7344a8f	gh-101100: Fix references in http.cookiejar docs (GH-136238)	2025-07-05 09:29:02 -04:00
Rafael Fontenelle	ade1988094	Docs: Move "or" outside monospace syntax in tarfile.rst (GH-136263)	2025-07-04 10:40:32 -04:00
Cody Maloney	48cb9b6112	gh-133982: Test _pyio.BytesIO in free-threaded tests (gh-136218)	2025-07-04 11:27:21 +09:00
Brett Cannon	b4991056f4	Clarify some details regarding sys.monitoring (#133981)	2025-07-03 14:04:01 -07:00
Emma Smith	938a5d7e62	gh-135252: Document Zstandard integration across zipfile, shutil, and tarfile (#135311) ... Document Zstandard integration across zipfile, shutil, and tarfile	2025-07-03 20:28:25 +00:00
Garry Cairns	51ab66b3d5	gh-134567: Add the formatter parameter in unittest.TestCase.assertLogs (GH-134570)	2025-07-02 09:51:19 +00:00
Vladyslav Lazoryk	9c0cb5beb8	gh-136169: Update parameter name in fractions.from_float method (#136172) ... Update parameter name in fractions.from_float method	2025-07-01 16:23:48 +03:00
Petr Viktorin	fe119a0817	gh-87135: threading.Lock: Raise rather than hang on Python finalization (GH-135991) ... After Python finalization gets to the point where no other thread can attach thread state, attempting to acquire a Python lock must hang. Raise PythonFinalizationError instead of hanging.	2025-07-01 10:57:42 +02:00
Eric Snow	fc82cb91ba	gh-134939: Fill Out the concurrent.interpreters Docs (gh-135902)	2025-06-30 10:54:53 -06:00
Stan Ulbrych	486587da42	gh-63207: Update time.time documentation after #116822 (#136068)	2025-06-30 18:10:24 +02:00
sedram	a87f3e0282	gh-136122: Fix video link for math.tau documentation (#136129)	2025-06-30 17:43:39 +03:00
Stan Ulbrych	2bdd50309f	gh-48181: Document codecs.charmap_build (#135997)	2025-06-30 15:42:08 +02:00
Adam Dangoor	75f40595e5	gh-131885: Update documented signatures for csv.{writer,reader} (GH-136085)	2025-06-30 09:32:51 -04:00
Serhiy Storchaka	536a5ff153	gh-132813: Fix the csv documentation for quoting and escaping (#133209)	2025-06-30 10:42:00 +03:00
Kanishk Pachauri	fb9f933b8e	gh-130160: use .. program:: directive for documenting venv CLI (GH-130699) ... Co-authored-by: Semyon Moroz <donbarbos@proton.me> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>	2025-06-30 06:41:57 +01:00
Peter Bierma	3947847914	gh-127604: Docs: Include a C stack in the faulthandler example (GH-136081)	2025-06-29 10:58:26 -04:00
Bénédikt Tran	42ccac2d7f	gh-135853: add math.signbit (#135877)	2025-06-28 14:46:07 +02:00
Brian Schubert	34ce1920ca	Docs: Fix duplicate word typos (GH-135958)	2025-06-26 20:00:19 -04:00
Duane Griffin	a4625d597f	gh-91555: add warning to docs about possibility of deadlock/infinite recursion (GH-135954) ... * gh-91555: add warning to docs about possibility of deadlock/infinite recursion Attempt to clarify in the documentation that care must be taken when using multiprocessing classes to implement logging since they have builtin internal logging, and hence may cause deadlock/infinite recursion. * Update Doc/library/logging.handlers.rst Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk> * Change whitespace. --------- Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>	2025-06-26 15:18:32 +01:00
Rob Reynolds	6227662ff3	Docs: Fix indentation in slice class of functions.rst (GH-134393) ... Paragraph should not be under `slice.step`. It applies to the whole class. --------- Co-authored-by: Rob Reynolds <13379223+reynoldsnlp@users.noreply.github.com>	2025-06-25 13:40:00 -04:00
Russell Keith-Magee	34393cbdd4	gh-135648: Document that shutil.copyfileobj doesn't flush (#135737) ... Adds a note about flush/close on copyfileobj, and updates the Emscripten build script to follow documented advice.	2025-06-24 08:55:50 +08:00
Yongzi Li	caad163b69	Docs: Use arguments to replace args in argparse.rst (GH-135510)	2025-06-23 18:53:33 -04:00
Bénédikt Tran	b57b619e34	gh-135815: skip netrc security checks if os.getuid is missing (#135816)	2025-06-22 19:48:06 +00:00
sobolevn	8ca1e4d846	gh-135645: Added supports_isolated_interpreters to sys.implementation (#135667) ... Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>	2025-06-21 10:56:14 +03:00
Marcell Perger	4ddf505d99	gh-135756: Fix nonexistent parameter in tkinter docs (#135770) ... Remove nonexistent color parameter from tkinter.commondialog.Dialog.show() method documentation.	2025-06-20 18:45:36 -04:00
Weilin Du	b881e3db1e	gh-89083: add links to RFC 9562 sections in UUID docs (#135684) ... We also sync the docs for UUIDv1 and UUIDv6 concerning the node address and clock sequence. --------- Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>	2025-06-20 11:03:41 +00:00
Nadeshiko Manju	1ddfe59320	gh-135543: Emit sys.remote_exec audit event when sys.remote_exec is called (GH-135544)	2025-06-19 21:23:38 +01:00
Andrii Hrimov	7cc8949692	gh-135273: Unify ZoneInfo.from_file signatures (#135274) ... Align `ZoneInfo.from_file` pure-Python signature with Argument Clinic signature.	2025-06-19 16:47:35 +02:00
Rafael Fontenelle	ff639af8ee	Docs: Emphasize parameter name in pkgutil.iter_importers (GH-135597)	2025-06-19 08:56:43 -04:00
Eric Snow	725da50520	gh-133485: Use interpreters.Interpreter in InterpreterPoolExecutor (gh-133957) ... Most importantly, this resolves the issues with functions and types defined in __main__. It also expands the number of supported objects and simplifies the implementation.	2025-06-18 17:57:14 -06:00
alexey semenyuk	e9b647dd30	gh-134538: Add link to shutil.rmtree example in function docs (GH-135540)	2025-06-18 22:10:20 +01:00
Yuki Kobayashi	46c60e0d0b	Docs: Fix markups for emphasis (GH-135598) ... The word emphasis character `_` is not supported as sphinx markup, so changed to `*`.	2025-06-18 13:32:43 -04:00
Stan Ulbrych	5f6ab92465	gh-133390: Document SQLITE_KEYWORDS (GH-135659)	2025-06-18 12:56:49 +02:00
Vladyslav Lazoryk	7117002591	gh-135627: Remove documentation for LOAD_CONST_IMMORTAL opcode (GH-135632) ... Remove documentation for LOAD_CONST_IMMORTAL opcode	2025-06-18 10:39:41 +08:00
Donghee Na	f079979599	gh-119132: Remove "experimental" tag from the CPython free-threading. (gh-135550) ... * gh-119132: Remove "experimental" tag from the CPython free-threading build * Address code review Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> * Add NEWS.d * Regen configure.ac * Update doc * Update * Update * Update * Update Doc/howto/free-threading-python.rst Co-authored-by: Peter Bierma <zintensitydev@gmail.com> * Update ctypes.rst * Update * Update Doc/howto/free-threading-python.rst Co-authored-by: T. Wouters <thomas@python.org> * Apply suggestions from code review Co-authored-by: T. Wouters <thomas@python.org> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --------- Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Peter Bierma <zintensitydev@gmail.com> Co-authored-by: T. Wouters <thomas@python.org>	2025-06-16 23:32:52 +09:00
Dan Lenski	60181f4ed0	gh-67022: Document bytes/str inconsistency in email.header.decode_header() and suggest email.headerregistry.HeaderRegistry as a sane alternative (#92900) ... * gh-67022: Document bytes/str inconsistency in email.header.decode_header() This function's possible return types have been surprising and error-prone for the entirety of its Python 3.x history. It can return either: 1. `typing.List[typing.Tuple[bytes, typing.Optional[str]]]` of length >1 2. or `typing.List[typing.Tuple[str, None]]`, of length exactly 1 This means that any user of this function must be prepared to accept either `bytes` or `str` for the first member of the 2-tuples it returns, which is a very surprising behavior in Python 3.x, particularly given that the second member of the tuple is supposed to represent the charset/encoding of the first member. This patch documents the behavior of this function, and adds test cases to demonstrate it. As discussed in bpo-22833, this cannot be changed in a backwards-compatible way, and some users of this function depend precisely on the existing behavior. Add warnings about obsolescence of 'email.header.decode_header' and 'email.header.make_header' functions. Recommend use of `email.headerregistry.HeaderRegistry` instead, as suggested in https://github.com/python/cpython/pull/92900#discussion_r1112472177	2025-06-15 15:29:38 -04:00
Nadeshiko Manju	076f87468a	gh-135361: update documentation for remote_debugger_script audit event (#135362)	2025-06-15 20:49:49 +02:00
Blaise Pabon	14c1d093d5	gh-106318: Add example for str.expandtabs() (#134525)	2025-06-13 18:44:21 +03:00
LamentXU	394d7985da	gh-135244: improve wording of uuid8 docs about CSPRNG (#135433)	2025-06-13 16:06:11 +02:00
Blaise Pabon	eed827ed09	gh-106318: Add example for str.endswith() (#134523) ... Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>	2025-06-13 11:54:16 +00:00
Blaise Pabon	273459562e	gh-106318: Add example for str.encode() (#134520) ... Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>	2025-06-13 11:32:07 +00:00
Sergey B Kirpichev	747d390045	gh-135308: clarify math.issubnormal() description (GH-135324)	2025-06-13 08:30:44 +02:00
Eric Hanchrow	f273fd77d7	doc: Remove what was essentially duplicate wording. (GH-135431)	2025-06-12 18:47:12 +01:00