summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* [3.10] gh-107845: Fix symlink handling for tarfile.data_filter (GH-107846) ↵Miss Islington (bot)2023-08-221-0/+5
| | | | (#108210)
* [3.10] gh-98154: Clarify Usage of "Reference Count" In the Docs (#107754)Eric Snow2023-08-1114-79/+120
|
* [3.10] gh-105090: Replace incorrect TLSv1.2 with TLSv1.3 (GH-105404) (#107039)Miss Islington (bot)2023-07-221-1/+1
| | | | Co-authored-by: Jocelyn Castellano <admin@malwarefight.gq>
* [3.10] gh-105993: Add possible `None` return type to ↵Miss Islington (bot)2023-07-051-0/+3
| | | | | | | `asyncio.EventLoop.start_tls` docs (GH-105995) (#106190) (cherry picked from commit 6b52a581c151914e59c8c367a03bc7309713a73b) Co-authored-by: Sam Bull <git@sambull.org>
* [3.10] [3.11] Add single value `agen.athrow(value)` signature to the 3.11 ↵Miss Islington (bot)2023-07-051-1/+2
| | | | | | | docs gh-105269 (GH-105468) (#105480) (cherry picked from commit acf3916e84158308660ed07c474a564e045d6884) Co-authored-by: Federico Caselli <CaselIT@users.noreply.github.com>
* [3.10] Clarify the supported cases in the tokenize module (GH-105569) (#105575)Miss Islington (bot)2023-06-091-0/+9
| | | | Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
* [3.10] gh-89412: Add missing attributes (added in 3.10) to traceback module ↵Miss Islington (bot)2023-06-051-0/+14
| | | | | | | docs (GH-105046) (#105329) (cherry picked from commit a4f72fa39a9d391c7b931ba1906d81da4ae01949) Co-authored-by: Jakub Kuczys <me@jacken.men>
* [3.10] gh-105184: document that marshal functions can fail and need to be ↵Miss Islington (bot)2023-06-051-0/+4
| | | | | | | checked with PyErr_Occurred (GH-105185) (#105220) (cherry picked from commit ee26ca13a129da8cf549409d0a1b2e892ff2b4ec) Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
* [3.10] [3.11] gh-102153: Start stripping C0 control and space chars in ↵Miss Islington (bot)2023-05-171-2/+36
| | | | | | | | | | | | | | | | | | | | | | `urlsplit` (GH-102508) (GH-104575) (#104592) gh-102153: Start stripping C0 control and space chars in `urlsplit` (GH-102508) `urllib.parse.urlsplit` has already been respecting the WHATWG spec a bit GH-25595. This adds more sanitizing to respect the "Remove any leading C0 control or space from input" [rule](https://url.spec.whatwg.org/GH-url-parsing:~:text=Remove%20any%20leading%20and%20trailing%20C0%20control%20or%20space%20from%20input.) in response to [CVE-2023-24329](https://nvd.nist.gov/vuln/detail/CVE-2023-24329). I simplified the docs by eliding the state of the world explanatory paragraph in this security release only backport. (people will see that in the mainline /3/ docs) --------- (cherry picked from commit 2f630e1ce18ad2e07428296532a68b11dc66ad10) (cherry picked from commit 610cc0ab1b760b2abaac92bd256b96191c46b941) Co-authored-by: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Co-authored-by: Illia Volochii <illia.volochii@gmail.com> Co-authored-by: Gregory P. Smith [Google] <greg@krypto.org>
* [3.10] gh-102950: Implement PEP 706 – Filter for tarfile.extractall ↵Matěj Cepl2023-05-103-19/+482
| | | | | | | | | | | (GH-102953) (GH-104128) - Backport b52ad18a766700be14382ba222033b2d75a33521 - Backport c8c3956d905e019101038b018129a4c90c9c9b8f - Remove the DeprecationWarning - Adjust docs - Remove new `__all__` entries Co-authored-by: Petr Viktorin <encukou@gmail.com>
* gh-102899: Fix doc link for getting filesystem error handler (GH-102901)Miss Islington (bot)2023-04-051-1/+1
| | | | | (cherry picked from commit fdd0fff277a55c010a4da0a7af0e986e38560545) Co-authored-by: Olivier Gayot <olivier.gayot@sigexec.com>
* gh-81762: Clarify and simplify description of print's flush param (GH-103264)Miss Islington (bot)2023-04-051-2/+3
| | | | | (cherry picked from commit c396b6ddf3da784349bac9ebf7f28c55bde016ea) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* Improve some grammar in the socket docs (GH-103254)Miss Islington (bot)2023-04-041-4/+4
| | | | | (cherry picked from commit bceb9e00ad2998e5193ad5b477e92a114dd31024) Co-authored-by: Tim Burke <tim.burke@gmail.com>
* gh-103109: Document ignore_warnings() test support helper (GH-103110)Miss Islington (bot)2023-04-021-0/+15
| | | | | | (cherry picked from commit 32937d6aa414ec7db5c63ef277f21db1880b3af4) Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* Minor docs improvements fix for `codeop` (GH-103123)Miss Islington (bot)2023-03-301-7/+7
| | | | | (cherry picked from commit c1e71ce56fdb3eab62ad3190d09130f800e54610) Co-authored-by: gaogaotiantian <gaogaotiantian@hotmail.com>
* gh-103099: Link mypy docs from typing.rst (GH-103100)Miss Islington (bot)2023-03-301-0/+8
| | | | | (cherry picked from commit fda95aa19447fe444ac2670afbf98ec42aca0c6f) Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
* [3.10] gh-102582: Fix invalid JSON in Doc/howto/logging-cookbook.rst ↵Miss Islington (bot)2023-03-291-10/+14
| | | | | | (GH-102635) (GH-103107) (cherry picked from commit d835b3f05de7e2d800138e5969eeb9656b0ed860) Co-authored-by: Matěj Cepl <mcepl@cepl.eu>
* Update pdb docs for arguments (GH-102965)Miss Islington (bot)2023-03-251-21/+21
| | | | | (cherry picked from commit 027223db96b0464c49a74513f82a1bf25aa510bd) Co-authored-by: gaogaotiantian <gaogaotiantian@hotmail.com>
* [3.10] gh-103025: fix a ctypes doc typo (GH-103026) (#103030)Miss Islington (bot)2023-03-251-2/+2
| | | | * gh-103025: fix two ctypes doc issues (GH-103026) (cherry picked from commit 0708437ad043657f992cb985fd5c37e1ac052f93)
* [3.10] gh-101100: Document PyObject_ClearWeakRefs and gzip's name (#103002)Hugo van Kemenade2023-03-252-0/+16
|
* gh-102873: logging.LogRecord docs: improve description of `msg` parameter ↵Miss Islington (bot)2023-03-241-2/+3
| | | | | | | | (GH-102875) (cherry picked from commit f2e5a6ee628502d307a97f587788d7022a200229) Co-authored-by: Amin Alaee <mohammadamin.alaee@gmail.com> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.10] gh-96931: Fix incorrect results in ssl.SSLSocket.shared_ciphers ↵Miss Islington (bot)2023-03-241-1/+1
| | | | | | | | (GH-96932) (#102919) gh-96931: Fix incorrect results in ssl.SSLSocket.shared_ciphers (GH-96932) (cherry picked from commit af9c34f6ef8dceb21871206eb3e4d350f6e3d3dc) Co-authored-by: Benjamin Fogle <benfogle@gmail.com>
* gh-98239: Document that `inspect.getsource()` can raise `TypeError` (GH-101689)Miss Islington (bot)2023-03-231-0/+4
| | | | | (cherry picked from commit b6132085ca5418f714eff6e31d1d03369d3fd1d9) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* gh-102936: typing: document performance pitfalls of protocols decorated with ↵Miss Islington (bot)2023-03-231-2/+18
| | | | | | | `@runtime_checkable` (GH-102937) (cherry picked from commit 58d2b30c012c3a9fe5ab747ae47c96af09e0fd15) Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Docs: improve accuracy of sqlite3.Connection.interrupt() (GH-102904)Miss Islington (bot)2023-03-221-1/+1
| | | | | | (cherry picked from commit 7b2d53daccf5a6479e179535068fd9a841db44fc) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* Docs: improve the accuracy of the sqlite3.connect() timeout param (GH-102900)Miss Islington (bot)2023-03-221-3/+3
| | | | | | (cherry picked from commit c24f1f1e874c283bb11d8b9fbd661536ade19fe9) Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* Docs: improve accuracy of pdb alias example (GH-102892)Miss Islington (bot)2023-03-221-1/+1
| | | | | (cherry picked from commit e0c63b72671bf816d3073f1a6a9107f6c171cae7) Co-authored-by: gaogaotiantian <gaogaotiantian@hotmail.com>
* gh-102595: Document `PyObject_Format` c-api function (GH-102596)Miss Islington (bot)2023-03-221-0/+9
| | | | | | (cherry picked from commit 910a64e3013bce821bfac75377cbe88bedf265de) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> Def: https://github.com/python/cpython/blame/5ffdaf748d98da6065158534720f1996a45a0072/Include/abstract.hGH-L389
* Add link to `sys.exit` function documentation (GH-102805)Miss Islington (bot)2023-03-211-1/+1
| | | | | | | | | | | | | | | | | | | * Add link to `sys.exit` function documentation * Update Doc/library/os.rst Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> * Update Doc/library/os.rst Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> --------- (cherry picked from commit 41ef502d740b96ca6333a2d0202df7cce4a84e7d) Co-authored-by: David Poirier <1152277+david-poirier@users.noreply.github.com> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* [3.10] Fix outdated note about 'int' rounding or truncating (GH-102736) ↵Miss Islington (bot)2023-03-161-4/+3
| | | | | | | | (#102767) Fix outdated note about 'int' rounding or truncating (GH-102736) (cherry picked from commit 405739f9166592104a5b0b945de92e28415ae972) Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
* gh-101100: Documenting --prefix and --exec-prefix. (GH-102695)Miss Islington (bot)2023-03-155-8/+24
| | | | | | (cherry picked from commit 61b9ff35cbda0cc59816951a17de073968fc25c6) Co-authored-by: Julien Palard <julien@palard.fr> Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
* [3.10] Remove misformatted exclamation marks in docs (GH-102694) (#102717)Hugo van Kemenade2023-03-151-2/+2
| | | | | | | | | | | | | | | | | | | Remove the exclamation mark from :program:`!foo` in .rst files because it inadvertently shows up in the rendered HTML. (Sphinx's cross-referencing roles use a '!' prefix to suppress hyperlinking[1], but :program: is not a cross-referencing role so the '!' is displayed verbatim.) The exclamation marks in venv.rst were introduced in #98350. See comments [2] and [3] for additional discussion. [1]: https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-syntax [2]: https://github.com/python/cpython/pull/98350#issuecomment-1285965759 [3]: https://github.com/python/cpython/pull/98350#issuecomment-1286394047 Reported-by: Vinay Sajip <vinay_sajip@yahoo.co.uk> Co-authored-by: Tom Levy <tomlevy93@gmail.com>
* gh-102703: Fix typo in modules tutorial documentation (GH-102707)Miss Islington (bot)2023-03-151-1/+1
| | | | | | | | | **Before** This prevents directories with a common name, such as ``string``, unintentionally hiding ... **After** This prevents directories with a common name, such as ``string``, from unintentionally hiding ... (cherry picked from commit 0a539b5db312d126ff45dd4aa6a53d40a292c512) Co-authored-by: Robert Prater (B. Eng) <robcprater@gmail.com>
* [3.10] gh-102354: change python3 to python in docs examples (GH-102696) ↵Miss Islington (bot)2023-03-145-6/+6
| | | | | | | | (#102698) gh-102354: change python3 to python in docs examples (GH-102696) (cherry picked from commit 80abd62647b2a36947a11a6a8e395061be6f0c61) Co-authored-by: Paul Watson <paul.hermeneutic@gmail.com>
* gh-100315: clarification to `__slots__` docs. (GH-102621)Miss Islington (bot)2023-03-141-2/+4
| | | | | | refer to tp_itemsize in discussion on "variable-length" built-in types (cherry picked from commit 88c262c086077377b40dfae5e46f597e28ffe3c9) Co-authored-by: T <tnie@tuta.io>
* doc: Remove a duplicate 'versionchanged' in library/asyncio-task (gh-102677)Miss Islington (bot)2023-03-141-3/+0
| | | | | (cherry picked from commit 7bdb331b67c4aee513e01794ba7dd2c3be43d3ca) Co-authored-by: Joongi Kim <me@daybreaker.info>
* gh-102627: Replace address pointing toward malicious web page (GH-102630)Miss Islington (bot)2023-03-131-1/+1
| | | | | | | | | * Replace known bad address pointing toward a malicious web page. (cherry picked from commit 61479d46848bc7a7f9b571b0b09c4a4b4436d839) Co-authored-by: Blind4Basics <32236948+Blind4Basics@users.noreply.github.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.10] Fix duplicated words in the docs (#102645)Alex Waygood2023-03-132-2/+2
| | | | | | | (cherry-picked from commit f6ca71a) With grep utility found some duplicated words Co-authored-by: Виталий Дмитриев <vitaldmit@bk.ru>
* gh-101100: Fix Sphinx warnings in `turtle` module (GH-102340)Miss Islington (bot)2023-03-131-27/+31
| | | | | | (cherry picked from commit 78e4e6c3d71980d4e6687f07afa6ddfc83e29b04) Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* gh-101100: Fix sphinx warnings in `zipapp` and `zipfile` modules (GH-102526)Miss Islington (bot)2023-03-082-2/+2
| | | | | (cherry picked from commit 1f557f94c2ee98c2a43bd090a7bf3f39a22ed874) Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* Add gettext support to tools/extensions/c_annotations.py (GH-101989)Miss Islington (bot)2023-03-062-3/+9
| | | | | (cherry picked from commit d959bcd4a0393a120fa12c034de4041037d171c3) Co-authored-by: Rémi Lapeyre <remi.lapeyre@lenstra.fr>
* gh-101754: Document that Windows converts keys in `os.environ` to uppercase ↵Miss Islington (bot)2023-03-031-0/+5
| | | | | | | (GH-101840) (cherry picked from commit 4e7c0cbf59595714848cf9827f6e5b40c3985924) Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
* [3.10] Fix typos in documentation and comments (GH-102374) (#102377)Alex Waygood2023-03-021-1/+1
| | | | | | | | | | | Fix typos in documentation and comments (GH-102374) Found some duplicate `to`s in the documentation and some code comments and fixed them. [Misc/NEWS.d/3.12.0a1.rst](https://github.com/python/cpython/blob/ed55c69ebd74178115cd8b080f7f8e7588cd5fda/Misc/NEWS.d/3.12.0a1.rst) also contains two duplicate `to`s, but I wasn't sure if it's ok to touch that file. Looks auto generated. I'm happy to amend the PR if requested. :) Automerge-Triggered-By: GH:AlexWaygood Co-authored-by: Michael K <michael-k@users.noreply.github.com>
* [3.10] gh-90744: Fix erroneous doc links in the sys module (GH-101319) (#102322)Hugo van Kemenade2023-03-021-43/+49
| | | | | | | Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: Brad Wolfe <brad.wolfe@gmail.com> Co-authored-by: Furkan Onder <furkanonder@protonmail.com> Fix erroneous doc links in the sys module (#101319)
* gh-102296 Document that inspect.Parameter kinds support ordering (GH-102297)Miss Islington (bot)2023-02-271-2/+3
| | | | | | (cherry picked from commit 0db6f442598a1994c37f24e704892a2bb71a0a1b) Co-authored-by: Gouvernathor <44340603+Gouvernathor@users.noreply.github.com> Automerge-Triggered-By: GH:AlexWaygood
* gh-101100: Fix sphinx warnings in `types` module (GH-102274)Miss Islington (bot)2023-02-271-1/+1
| | | | | | (cherry picked from commit 101a12c5767a8c6ca6e32b8e24a462d2606d24ca) Co-authored-by: Nikita Sobolev <mail@sobolevn.me> Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* [3.10] [doc] Improve grammar/fix missing word (GH-102060) (GH-102278)Miss Islington (bot)2023-02-262-2/+2
| | | | | | [doc] Improve grammar/fix missing word (GH-102060) (cherry picked from commit 6daf42b28e1c6d5f0c1a6350cfcc382789e11293) Co-authored-by: VMan <vayidm@users.noreply.github.com>
* [3.10] gh-85417: Clarify behaviour on branch cuts in cmath module ↵Miss Islington (bot)2023-02-261-28/+38
| | | | | | | | | | | | | (GH-102046) (#102275) gh-85417: Clarify behaviour on branch cuts in cmath module (GH-102046) This PR updates the cmath module documentation to reflect the reality that Python is almost always (and as far as I can tell, that "almost" can be omitted) running on a machine whose C double supports signed zeros. * Removes misleading references to functions being continuous from above / below / the left / the right at branch cuts * Expands the note on branch cuts at the top of the module documentation to explain the double-sided sign-of-zero-based behaviour (cherry picked from commit b513c46d998344dc07eb6d510782c2e23d2b859e) Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
* gh-102259: Fix re doc issue regarding right square brackets (GH-102264)Miss Islington (bot)2023-02-261-1/+2
| | | | | | (cherry picked from commit bcadcde7122f6d3d08b35671d67e105149371a2f) Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* [3.10] GH-99818: improve the documentation for zipfile.Path and Traversable ↵Shantanu2023-02-252-3/+7
| | | | (GH-101589) (#102267)
generated by cgit v0.12 at 2024-11-27 04:15:17 (GMT)