summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* [3.12] GH-92584: Move installation schemes overview to sysconfig docs ↵Miss Islington (bot)2023-10-022-17/+166
| | | | | | | | | | | | | | | | | | (GH-108018) (#110213) GH-92584: Move installation schemes overview to sysconfig docs (GH-108018) * 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 f16e81f368d08891e28dc1f038c1826ea80d7801) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-110138: Improve grammar in idiomatic usage of ``__main__.py`` ↵Miss Islington (bot)2023-10-021-3/+3
| | | | | | | | (GH-110142) (#110188) gh-110138: Improve grammar in idiomatic usage of ``__main__.py`` (GH-110142) (cherry picked from commit adf0f15a06c6e8ddd1a6d59b28efcbb26289f080) Co-authored-by: Quentin Agren <quentin.agren@gmail.com>
* [3.12] gh-101100: Fix sphinx warnings in `library/site.rst` (GH-110144) ↵Hugo van Kemenade2023-10-022-11/+25
| | | | | | | | (#110187) (cherry picked from commit 31097df611bb5c8084190202e095ae47e8b81c0f) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] GH-101100: Fix reference warnings for ``gettext`` (GH-110115) (#110140)Miss Islington (bot)2023-10-021-29/+26
| | | | | | GH-101100: Fix reference warnings for ``gettext`` (GH-110115) (cherry picked from commit 0449fe999d56ba795a852d83380fe06514139935) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-109634: Fix `:samp:` syntax (GH-110073) (#110095)Miss Islington (bot)2023-09-291-1/+1
| | | | | | gh-109634: Fix `:samp:` syntax (GH-110073) (cherry picked from commit e27adc68ccee8345e05b7516e6b46f6c7ff53371) Co-authored-by: Jacob Coffee <jacob@z7x.org>
* [3.12] gh-101100: Fix sphinx warnings in `library/difflib.rst` (GH-110074) ↵Miss Islington (bot)2023-09-291-9/+9
| | | | | | | | (#110081) gh-101100: Fix sphinx warnings in `library/difflib.rst` (GH-110074) (cherry picked from commit d102d39bbe175f179f28e4d4bea99dc122da5f8e) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* [3.12] gh-110045: Update symtable module for PEP 695 (GH-110066) (#110070)Miss Islington (bot)2023-09-291-1/+11
| | | | | | gh-110045: Update symtable module for PEP 695 (GH-110066) (cherry picked from commit 7dc2c5093ef027aab57bca953ac2d6477a4a440b) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* [3.12] gh-101100: Fix sphinx warnings in `library/devmode.rst` (GH-109963) ↵Miss Islington (bot)2023-09-271-2/+3
| | | | | | | | | (#109966) gh-101100: Fix sphinx warnings in `library/devmode.rst` (GH-109963) (cherry picked from commit d9809e84fbf22ed8d90b212a9322260f7074bc9c) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-101100: Fix Sphinx warnings in `Doc/library/weakref.rst` ↵Hugo van Kemenade2023-09-261-10/+9
| | | | | | | | (GH-109881) (#109884) [3.12] gh-101100: Fix Sphinx warnings in `Doc/library/weakref.rst` (GH-109881). (cherry picked from commit 7c61a361fc2e93375e22849fffbc20b60e94dbde) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* [3.12] gh-101100: Fix sphinx warnings in ↵Miss Islington (bot)2023-09-241-1/+6
| | | | | | | | | | | `Doc/library/xml.etree.elementtree.rst` (GH-109799) (#109800) gh-101100: Fix sphinx warnings in `Doc/library/xml.etree.elementtree.rst` (GH-109799) (cherry picked from commit 649768fb6781ba810df44017fee1975a11d65e2f) gh-101100: Fix shpinx warnings in `Doc/library/xml.etree.elementtree.rst` Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* [3.12] gh-109634: Use :samp: role (GH-109635) (#109776)Miss Islington (bot)2023-09-2410-24/+28
| | | | | | gh-109634: Use :samp: role (GH-109635) (cherry picked from commit 92af0cc580051fd1129c7a86af2cbadeb2aa36dc) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.12] gh-100228: Document the os.fork threads DeprecationWarning. ↵Miss Islington (bot)2023-09-243-4/+46
| | | | | | | | | | | | | | | | | | | | | | | | | | | (GH-109767) (#109773) * gh-100228: Document the os.fork threads DeprecationWarning. (GH-109767) Document the `os.fork` posix threads detected `DeprecationWarning` in 3.12 What's New, os, multiprocessing, and concurrent.futures docs. Many reviews and doc cleanup edits by Adam & Hugo. 🥳 (cherry picked from commit 5e7ea95d9d5c3b80a67ffbeebd76ce4fc327dd8e) Co-authored-by: Gregory P. Smith <greg@krypto.org> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> * link to the discussion thread from whatsnew Include the link to the discussion in the what's new text per @malemberg's comment on. https://github.com/python/cpython/pull/109767 (i'll follow up with a PR to main to include this edit there as well) --------- Co-authored-by: Gregory P. Smith <greg@krypto.org> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] Misc itertool recipe improvements, mostly docstrings and comments ↵Miss Islington (bot)2023-09-221-37/+44
| | | | | | | | (gh-109555) (#109572) (cherry picked from commit f2636d2c45aae0a04960dcfbc7d9a2a8a36ba3bc) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* [3.12] Fix extraneous backslashes in hashlib docs (GH-109468) (#109530)Miss Islington (bot)2023-09-181-12/+12
| | | | | | Fix extraneous backslashes in hashlib docs (GH-109468) (cherry picked from commit ce5b3e19e6fb940fa72db1b98a8df80f6e464265) Co-authored-by: Anthony Sottile <asottile@umich.edu>
* [3.12] gh-109451: Fix wrong format specifier in logging documentation ↵Miss Islington (bot)2023-09-171-1/+1
| | | | | | | | (GH-109465) (#109483) gh-109451: Fix wrong format specifier in logging documentation (GH-109465) (cherry picked from commit 929cc4e4a0999b777e1aa94f9c007db720e67f43) Co-authored-by: AlberLC <37489786+AlberLC@users.noreply.github.com>
* [3.12] gh-109414: Add some basic information about venvs in the ↵Miss Islington (bot)2023-09-171-0/+19
| | | | | | | | | introduction. (GH-109440) (#109481) gh-109414: Add some basic information about venvs in the introduction. (GH-109440) (cherry picked from commit a6846d45ff3c836bc859c40e7684b57df991dc05) Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk> Co-authored-by: Victor Stinner <vstinner@python.org>
* [3.12] Docs: Superseded modules: list only module names (GH-109439) (#109445)Miss Islington (bot)2023-09-151-0/+1
| | | | | | Docs: Superseded modules: list only module names (GH-109439) (cherry picked from commit b434dd7e3625d442392b4adf952685c8adf769f7) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-101100: Fix sphinx warnings in `turtle.rst` (GH-109394) (#109416)Miss Islington (bot)2023-09-141-4/+4
| | | | | | gh-101100: Fix sphinx warnings in `turtle.rst` (GH-109394) (cherry picked from commit 21e80f4c1925aaafae199840f8737b5c39a82c70) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* [3.12] Fix variable name in dis documentation example (GH-109343) (#109364)Miss Islington (bot)2023-09-131-1/+1
| | | | | | | | Fix variable name in dis documentation example (GH-109343) BINARY_SUBSCR example erroneously uses two different names `key` and `index` to refer to the same variable. STORE_SUBSCR and DELETE_SUBSCR use only `key` in the same context. Changing `index` to `key` for consistency. (cherry picked from commit a0c06a4f933faccd7f8201701b2491d38464212c) Co-authored-by: Oleksandr Kravets <73752159+olekskrav@users.noreply.github.com>
* [3.12] gh-105189: fix importlib.resources.abc deprecation docs (GH-105232) ↵Miss Islington (bot)2023-09-132-12/+154
| | | | | | | | | | (#109363) gh-105189: fix importlib.resources.abc deprecation docs (GH-105232) (cherry picked from commit 6c0ddca409c1ed27b11c70386cd6c88be5d00115) Co-authored-by: Thomas Grainger <tagrain@gmail.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-109184: update traceback module doc w.r.t notes (message is no ↵Irit Katriel2023-09-131-19/+21
| | | | | | | longer always at the end) (#109201) (#109334) gh-109184: update traceback module doc w.r.t notes (message is no longer always at the end) (#109201) (cherry picked from commit 0e76cc359ba5d5e29d7c75355d7c1bc7e817eecf)
* [3.12] Fix iter_index() to work with lists which do not support stop=None. ↵Miss Islington (bot)2023-09-121-0/+11
| | | | | | | | (gh-109306) (#109310) Fix iter_index() to work with lists which do not support stop=None. (gh-109306) (cherry picked from commit f2a55fecd063244a5fd09a38f673f0781f8802d1) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* [3.12] gh-107322: zipapp: Remove the suggestion to remove .dist-info ↵Miss Islington (bot)2023-09-121-6/+1
| | | | | | | | | | directories (GH-107296) (#109281) gh-107322: zipapp: Remove the suggestion to remove .dist-info directories (GH-107296) Removed zipapp suggestion to rm .dist-info subdirectories. This totally breaks importlib.metadata (cherry picked from commit 1ee50e2a78f644d81d341a08562073ad169d8cc7) Co-authored-by: wim glenn <hey@wimglenn.com>
* [3.12] Improve the sieve() recipe in the itertools docs (gh-109199) (#109203)Miss Islington (bot)2023-09-121-4/+7
| | | | | | | | Improve the sieve() recipe in the itertools docs (gh-109199) Lazier sieve (cherry picked from commit d3ed9921cdd8ac291fbfe3adf42f7730d3a14dbc) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* [3.12] Add version directives to ast docs (GH-108788) (#109106)Miss Islington (bot)2023-09-081-4/+42
| | | | | | Add version directives to ast docs (GH-108788) (cherry picked from commit 74fc96bc60f5c02bde50ff2f3516add99483e402) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* [3.12] gh-107924: re-order os.sendfile() flag documentation (GH-107926) ↵Miss Islington (bot)2023-09-081-19/+20
| | | | | | | | | (#109099) gh-107924: re-order os.sendfile() flag documentation (GH-107926) (cherry picked from commit 403ab1306a6e9860197bce57eadcb83418966f21) Co-authored-by: Christoph Anton Mitterer <mail@christoph.anton.mitterer.name> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-102823: Document return type of floor division on floats ↵Miss Islington (bot)2023-09-081-3/+5
| | | | | | | | | (GH-102824) (#109092) gh-102823: Document return type of floor division on floats (GH-102824) (cherry picked from commit b72251de930c8ec6893f1b3f6fdf1640cc17dfed) Co-authored-by: Mark Dickinson <dickinsm@gmail.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] socket documentation fix - rename triple to 3-tuple (GH-24722) (#109073)Miss Islington (bot)2023-09-081-2/+2
| | | | | | | socket documentation fix - rename triple to 3-tuple (GH-24722) (cherry picked from commit 6b15ff52351787644115a4dd9d5d6717d66b9806) Co-authored-by: Ori Hoch <ori@uumpa.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-71770: Add more details on behavior of configparser's ↵Miss Islington (bot)2023-09-081-2/+4
| | | | | | | | | default_section (GH-31562) (#109088) gh-71770: Add more details on behavior of configparser's default_section (GH-31562) (cherry picked from commit 891236f48263e2d4c650b7a127fc9bffb8327807) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] GH-90915: Document that SystemExit doesn't trigger sys.excepthook ↵Miss Islington (bot)2023-09-081-1/+1
| | | | | | | | | | (GH-31357) (#109082) GH-90915: Document that SystemExit doesn't trigger sys.excepthook (GH-31357) (cherry picked from commit 1294fcede09af6c781553b7a3a6ff612c7dfa431) Co-authored-by: Colin Watson <cjwatson@debian.org> Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] bpo-38157: Add example about per file output for mock_open. ↵Miss Islington (bot)2023-09-081-0/+24
| | | | | | | | | | | (GH-16090) (#109071) bpo-38157: Add example about per file output for mock_open. (GH-16090) (cherry picked from commit e183a71eef1ec3ac86bb4d81a158c21d6f1a783b) Co-authored-by: Karthikeyan Singaravelan <tir.karthi@gmail.com> Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-107755: Document the correct default value of slice step ↵Miss Islington (bot)2023-09-081-1/+1
| | | | | | | | | | (GH-107756) (#108955) gh-107755: Document the correct default value of slice step (GH-107756) Document the correct default value of slice step. (cherry picked from commit 9bf350b0662fcf1a8b43b9293e6c8ecf3c711561) Co-authored-by: wim glenn <hey@wimglenn.com>
* [3.12] gh-107732: Mention dir support in importlib.resources docs ↵Hugo van Kemenade2023-09-081-5/+8
| | | | | | | | | | | (GH-107734) (#109058) gh-107732: Mention dir support in importlib.resources docs (#107734) 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 9f0c0a46f00d687e921990ee83894b2f4ce8a6e7) Co-authored-by: Shahriar Heidrich <smheidrich@weltenfunktion.de>
* [3.12] GH-108202: Document ``calendar``'s command-line interface (GH-109020) ↵Miss Islington (bot)2023-09-081-0/+143
| | | | | | | | | (#109030) GH-108202: Document ``calendar``'s command-line interface (GH-109020) (cherry picked from commit f0f96a9f40762499811681d405b6f922b6ed7a55) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] gh-108857: improve markup in inspect.Signature.replace() docs ↵Miss Islington (bot)2023-09-061-1/+1
| | | | | | | | (GH-108862) (#108971) gh-108857: improve markup in inspect.Signature.replace() docs (GH-108862) (cherry picked from commit 6f8411cfd68134ccae01b0b4cb332578008a69e3) Co-authored-by: nabin2004 <107109731+nabin2004@users.noreply.github.com>
* [3.12] GH-103082: Document PEP-669: Low Impact Monitoring for CPython ↵Miss Islington (bot)2023-09-053-0/+308
| | | | | | | | (GH-107772) (#108909) GH-103082: Document PEP-669: Low Impact Monitoring for CPython (GH-107772) (cherry picked from commit 8b515f60ee1dec65cb3d64f1cc1d4b32aa2f4184) Co-authored-by: Mark Shannon <mark@hotpy.org>
* [3.12] gh-107208: Fix iter_index() recipe to not swallow exceptions ↵Miss Islington (bot)2023-09-041-12/+23
| | | | | | | | | | | (gh-108835) (#108837) gh-107208: Fix iter_index() recipe to not swallow exceptions (gh-108835) (cherry picked from commit f373c6b9483e12d7f6e03a631601149ed60ab883) gh-107208: iter_index now supports "stop" and no longer swallows ValueError Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* [3.12] gh-101100: Fix sphinx warnings in `unittest.mock-examples.rst` ↵Nikita Sobolev2023-09-021-6/+7
| | | | | | | | | | | | | | (GH-108810) (#108813) * [3.12] gh-101100: Fix sphinx warnings in `unittest.mock-examples.rst` (GH-108810). (cherry picked from commit 5141b1ebe07ad54279e0770b4704eaf76f24951d) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> * Make the requested changes --------- Co-authored-by: AlexWaygood <alex.waygood@gmail.com>
* [3.12] gh-101100: Fix sphinx warnings in `uuid.rst` (GH-108805) (#108807)Miss Islington (bot)2023-09-021-21/+30
| | | | | | | | | | | | | | | | | | | | * gh-101100: Fix sphinx warnings in `uuid.rst` (GH-108805) * gh-101100: Fix sphinx warnings in `uuid.rst` * Use anchors (cherry picked from commit 21da4980f5916e8fd648f04367a9e60d141af366) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> * Fix typo * another typo --------- Co-authored-by: Nikita Sobolev <mail@sobolevn.me> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.12] gh-105563: reference DateType in datetime's documentation (GH-105946) ↵Miss Islington (bot)2023-09-021-0/+4
| | | | | | | | (#108789) gh-105563: reference DateType in datetime's documentation (GH-105946) (cherry picked from commit 8f9ea43ee805f98391f857397daac9df7ffa71cd) Co-authored-by: TATHAGATA ROY <royzen9495@gmail.com>
* [3.12] `ast` docs: Fix incorrect link on `keyword` (GH-108728) (#108737)Miss Islington (bot)2023-09-011-2/+2
| | | | | | | | `ast` docs: Fix incorrect link on `keyword` (GH-108728) In two places, Sphinx was erroneously adding links to the `keyword` module instead of the `ast.keyword` class (cherry picked from commit c1e2f3b2f70b8a72ea7e1bf792addf62a94ae65d) Co-authored-by: Alex Povel <git@alexpovel.de>
* [3.12] gh-101100: Fix sphinx warnings in `threading.rst` (GH-108684) (#108707)Miss Islington (bot)2023-08-311-8/+8
| | | | | | | gh-101100: Fix sphinx warnings in `threading.rst` (GH-108684) (cherry picked from commit 991e4e76b54b69f227242e73c2ec9d62f903da53) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] Fix typo in multiprocessing docs (GH-108666) (#108677)Miss Islington (bot)2023-08-301-1/+1
| | | | | | Fix typo in multiprocessing docs (GH-108666) (cherry picked from commit 38ab0dba801884b0963ef0daa95e94e120a2b524) Co-authored-by: kato8966 <66937409+kato8966@users.noreply.github.com>
* [3.12] gh-108669: unittest: Fix documentation for ↵Miss Islington (bot)2023-08-301-1/+1
| | | | | | | | TestResult.collectedDurations (GH-108670) (#108672) gh-108669: unittest: Fix documentation for TestResult.collectedDurations (GH-108670) (cherry picked from commit 6c484c39beeb66d40ef0a73cc4f1e900ea498cfa) Co-authored-by: Sebastian Rittau <srittau@rittau.biz>
* [3.12] Mention Ellipsis pickling in the docs (GH-103660) (#108661)Miss Islington (bot)2023-08-301-1/+2
| | | | | | Mention Ellipsis pickling in the docs (GH-103660) (cherry picked from commit 14ec0bb7c363def917f768b76f334146a3cddd84) Co-authored-by: sterliakov <50529348+sterliakov@users.noreply.github.com>
* [3.12] gh-107801: Improve the accuracy of io.IOBase.seek docs (#108268) ↵Erlend E. Aasland2023-08-291-12/+14
| | | | | | | | | | | (#108655) (cherry picked from commit 8178a88bd81edae87d6974483e4de9b32e808797) - Add param docstrings - Link to os.SEEK_* constants - Mention the return value in the initial paragraph Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] Fix misc doc typos (GH-108592) (#108594)Miss Islington (bot)2023-08-295-5/+5
| | | | | | Fix misc doc typos (GH-108592) (cherry picked from commit 88f1c5b454c34efc167a94b5e2d67ec042834e5b) Co-authored-by: xzmeng <aumo@foxmail.com>
* [3.12] GH-108202: Combine documentation of ``calendar`` constants ↵Adam Turner2023-08-281-60/+49
| | | | | | (GH-108492) (#108579) [3.12] GH-108202: Combine documentation of ``calendar`` constants (GH-108492). (cherry picked from commit 5d936b64796261373429c86cdf90b1d8d8acefba)
* [3.12] Fix typo in typing docs: Remove redundant backtick (GH-108559) (#108560)Miss Islington (bot)2023-08-281-1/+1
| | | | | | Fix typo in typing docs: Remove redundant backtick (GH-108559) (cherry picked from commit 72b615ab015ccff8a92e22c5b5f97fa8aca3ba1f) Co-authored-by: nikkie <takuyafjp+develop@gmail.com>
* [3.12] gh-107801: Document io.TextIOWrapper.tell (#108265) (#108547)Erlend E. Aasland2023-08-271-1/+9
| | | (cherry picked from commit 38afa4af9bfc8297a5ee270c37f3f120a04297ea)