summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* [3.12] gh-119577: Adjust DeprecationWarning when testing element truth ↵Gregory P. Smith2024-08-061-3/+4
| | | | | | | | | | | | | values in Element tree (GH-119762) (#120190) gh-119577: Adjust DeprecationWarning when testing element truth values in ElementTree (GH-119762) Adjust DeprecationWarning when testing element truth values in ElementTree, we're planning to go with the more natural True return rather than a disruptive harder to code around exception raise, and are deferring the behavior change for a few more releases. Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
* [3.12] gh-117270: Add missed change to COMPARE_OP from 3.12 to dis ↵Christopher Chianelli2024-08-061-1/+4
| | | | documentation (GH-117272) (#117274)
* [3.12] gh-121650: Encode newlines in headers, and verify headers are sound ↵Petr Viktorin2024-08-063-0/+42
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | (GH-122233) (#122599) * gh-121650: Encode newlines in headers, and verify headers are sound (GH-122233) - Encode header parts that contain newlines Per RFC 2047: > [...] these encoding schemes allow the > encoding of arbitrary octet values, mail readers that implement this > decoding should also ensure that display of the decoded data on the > recipient's terminal will not cause unwanted side-effects It seems that the "quoted-word" scheme is a valid way to include a newline character in a header value, just like we already allow undecodable bytes or control characters. They do need to be properly quoted when serialized to text, though. - Verify that email headers are well-formed This should fail for custom fold() implementations that aren't careful about newlines. Co-authored-by: Bas Bloemsaat <bas@bloemsaat.org> Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> (cherry picked from commit 097633981879b3c9de9a1dd120d3aa585ecc2384) * Document changes as made in 3.12.5
* [3.12] gh-122613: Document PyLong_GetInfo() (part of Limited API) ↵Sergey B Kirpichev2024-08-051-0/+11
| | | | | | (GH-122280) (#122644) [3.12] gh-122613: Document PyLong_GetInfo() (part of Limited API) (GH-GH-122280) (cherry picked from commit d91ac525ef166edc0083acf5a96f81b87324fe7f)
* [3.12] gh-121367: [doc] BUILD_TUPLE arg can be 0 (GH-122663) (#122684)Miss Islington (bot)2024-08-051-4/+8
| | | | | | gh-121367: [doc] BUILD_TUPLE arg can be 0 (GH-122663) (cherry picked from commit 1422500d020bd199b26357fc387f8b79b82226cd) Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
* [3.12] gh-122661: Remove GNU make-specific directive from Doc/Makefile ↵Miss Islington (bot)2024-08-041-16/+20
| | | | | | (GH-122662) (#122669) Co-authored-by: Libor Martínek <libas@acco.cz>
* [3.12] gh-122623: Improve `c-api/bytearray.rst` with error handling info ↵Miss Islington (bot)2024-08-031-2/+7
| | | | | | | | (GH-122624) (#122659) gh-122623: Improve `c-api/bytearray.rst` with error handling info (GH-122624) (cherry picked from commit 151934a324789c58cca9c7bbd6753d735454df5a) Co-authored-by: sobolevn <mail@sobolevn.me>
* [3.12] GH-121970: Fix ``gettext`` for audit events (GH-122651) (#122654)Miss Islington (bot)2024-08-031-0/+2
| | | | | | GH-121970: Fix ``gettext`` for audit events (GH-122651) (cherry picked from commit 95f5c89b545beaafad73f05a695742da3e90bc41) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] Doc: Grammar fix in ``library/ssl.rst``, 'Verifying certificates' ↵Miss Islington (bot)2024-08-031-1/+1
| | | | | | | | (GH-122646) (#122650) Doc: Grammar fix in ``library/ssl.rst``, 'Verifying certificates' (GH-122646) (cherry picked from commit 06eb9701a182b4720dfa8766cb41cc5a3728a8b9) Co-authored-by: scottwoodall <scott.woodall@gmail.com>
* [3.12] Doc: Improve wording of ``os.path.commonpath()`` (GH-122627) (#122642)Miss Islington (bot)2024-08-031-1/+1
| | | | | | | Doc: Improve wording of ``os.path.commonpath()`` (GH-122627) (cherry picked from commit 7a5c4103b094aaf1b65af6de65795d172cfe8fe0) Co-authored-by: Matth-M <93771840+Matth-M@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] Fix typos in docs (#122502) (#122605)Alex Waygood2024-08-022-2/+2
| | | | | Co-authored-by: jianghuyiyuan <shuangcui@live.com> Fix typos in docs, error messages and comments (#122502)
* [3.12] gh-121723: Relax constraints on queue objects for ↵Miss Islington (bot)2024-08-021-3/+6
| | | | | `logging.handlers.QueueHandler`. (GH-122154) (GH-122604) (cherry picked from commit fb864c76cd5e450e789a7b4095832e118cc49a39)
* [3.12] gh-122384: Mark strings from Download page for translation ↵Miss Islington (bot)2024-08-011-32/+42
| | | | | | | (GH-122385) (#122554) Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] Docs: bump Sphinx to 8.0 and update constraints (GH-122496) (#122500)Hugo van Kemenade2024-07-312-8/+8
| | | | Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] Remove outdated note about instance methods from datamodel.rst ↵Miss Islington (bot)2024-07-301-8/+1
| | | | | | | | (GH-122471) (#122480) Remove outdated note about instance methods from datamodel.rst (GH-122471) (cherry picked from commit c68cb8e0c9bd75ded25578c2fba6469e55a06e93) Co-authored-by: Thomas Grainger <tagrain@gmail.com>
* [3.12] GH-121970: Extract ``audit_events`` into a new extension (GH-122325) ↵Miss Islington (bot)2024-07-303-207/+263
| | | | (#122435)
* [3.12] GH-122085: Use include files for C API deprecations (GH-109843) (#122423)Adam Turner2024-07-305-83/+110
| | | (cherry picked from commit 76bdfa4cd02532519fb43ae91244e2b4b3650d78)
* [3.12] gh-122085: Create dedicated page for deprecations (GH-122352) (#122375)Miss Islington (bot)2024-07-283-0/+15
| | | | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-122300: Preserve AST nodes for format specifiers with single ↵Pablo Galindo Salgado2024-07-271-1/+3
| | | | | elements (GH-122308) (#122363) (cherry picked from commit db2d8b6db1b56c2bd3802b86f9b76da33e8898d7)
* [3.12] GH-121462: pathlib docs: improve table of corresponding os/os.path ↵Barney Gale2024-07-271-45/+48
| | | | | | | | | | | | | | | | | | | | | functions (GH-121465) (#122360) Re-order table of corresponding functions with the following priorities: 1. Pure functionality is at the top 2. `os.path` functions are shown before `os` functions 3. Similar functionality is kept together 4. Functionality follows docs order where possible Add a few missed correspondences: - `os.path.isjunction` and `Path.is_junction` - `os.path.ismount` and `Path.is_mount` - `os.lstat()` and `Path.lstat()` - `os.lchmod()` and `Path.lchmod()` Also add footnotes describing a few differences. (cherry picked from commit cbac8a3888411587beb026e246889154fbdd49a3)
* [3.12] gh-122085: Use include files for `whatsnew/3.14.rst` deprecations ↵Hugo van Kemenade2024-07-272-1/+10
| | | | (GH-122242) (#122351)
* [3.12] Document ``mimetypes.MimeTypes.add_type()`` (GH-122301) (#122329)Miss Islington (bot)2024-07-261-0/+10
| | | | | | | Document ``mimetypes.MimeTypes.add_type()`` (GH-122301) (cherry picked from commit d52726ccd456833ea9f09cabb4b8aef09755e472) Co-authored-by: Subrahmanya Gaonkar <148525245+negativenagesh@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-122085: Use include files for `whatsnew/3.12.rst` deprecations ↵Hugo van Kemenade2024-07-246-142/+386
| | | | | | (GH-122093) (#122224) Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] Docs: Use cross-reference to `os.uname` in `sysconfig.get_platform` ↵Miss Islington (bot)2024-07-231-1/+1
| | | | | | | | (GH-122083) (#122172) Docs: Use cross-reference to `os.uname` in `sysconfig.get_platform` (GH-122083) (cherry picked from commit 498cb6dff10f97fa3d348a4c0ad9374d14af3312) Co-authored-by: Ville Skyttä <ville.skytta@iki.fi>
* [3.12] GH-121970: Remove ``escape4chm`` (GH-122065) (#122168)Miss Islington (bot)2024-07-233-60/+0
| | | | | | GH-121970: Remove ``escape4chm`` (GH-122065) (cherry picked from commit 53e9e7de6359845f118431c05e2f14a96e03b757) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-121957: Emit audit events for python -i and python -m asyncio ↵Łukasz Langa2024-07-222-1/+13
| | | | (GH-122117)
* [3.12] Docs: spelling and grammar fixes (GH-122084) (#122107)Russell Keith-Magee2024-07-2219-27/+27
| | | | | | (cherry picked from commit bc264eac3ad14dab748e33b3d714c2674872791f) Co-authored-by: Ville Skyttä <ville.skytta@iki.fi> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* [3.12] Delete stale note about mp.Lock.acquire/SIGINT (GH-120929) (GH-122079)Miss Islington (bot)2024-07-211-11/+0
| | | | | | Delete stale note about mp.Lock.acquire/SIGINT (GH-120929) (cherry picked from commit 0dcbc8385322ff51f7fc3e586027d880275df4fa) Co-authored-by: Andrey Mishchenko <mishchea@gmail.com>
* [3.12] gh-121977: Add tips for handling unhashable data (GH-122075) (#122077)Miss Islington (bot)2024-07-211-0/+6
| | | | | | gh-121977: Add tips for handling unhashable data (GH-122075) (cherry picked from commit ebc18abbf34ff248764bda1a02db7f1c783b71e3) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* [3.12] Docs: Fix duplicate object description warnings (GH-122068) (#122070)Miss Islington (bot)2024-07-203-1/+7
| | | | | | Docs: Fix duplicate object description warnings (GH-122068) (cherry picked from commit 8db5f480072421bb065d346c3bbc5e88fc368587) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-121130: Fix f-string format specifiers with debug expressions ↵Pablo Galindo Salgado2024-07-201-3/+1
| | | | (GH-121150) (#122063)
* [3.12] GH-121970: Modernise the patchlevel extension (GH-121995) (#122061)Miss Islington (bot)2024-07-203-54/+62
| | | | | | GH-121970: Modernise the patchlevel extension (GH-121995) (cherry picked from commit b7ad711fcb37dd001e6bf8466c9503eef6d20331) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-59022: Added tests for `pkgutil.extend_path` (GH-121673) (GH-121950)Miss Islington (bot)2024-07-191-3/+3
| | | | | | | This adds tests for the documented behaviour of `pkgutil.extend_path` regarding different argument types as well as for `*.pkg` files. (cherry picked from commit 8f2532168b4630e413a42ccb5e458708808702ea) Co-authored-by: Andreas Stocker <andreas@stocker.co.it>
* [3.12] gh-121160: Note that readline libraries using different history ↵Petr Viktorin2024-07-191-0/+4
| | | | | | | formats. (GH-121327) (GH-122031) This is not something we can do too much about, without help from the underlying libraries. (cherry picked from commit 709db44255eb5d73fc22a1341dd0253e71ddfda9)
* [3.12] GH-121970: Rewrite the C-API annotations extension (GH-121985) (#122025)Adam Turner2024-07-195-1041/+1123
| | | | | (cherry picked from commit 22c9d9c1fcc3bb6186524330b169eda6df450f1b) Co-authored-by: Petr Viktorin <encukou@gmail.com>
* [3.12] GH-121970: Use Ruff to check and format the docs tools (GH-122018) ↵Adam Turner2024-07-195-49/+146
| | | | | | | (#122024) (cherry picked from commit 40855f3ab80ced9950c725b710f507c0e903b70a) Co-authored-by: Alex Waygood <Alex.Waygood@gmail.com>
* [3.12] GH-121970: Combine custom Pygments lexers into a package (GH-121976) ↵Miss Islington (bot)2024-07-194-26/+22
| | | | | | | | | (#122022) GH-121970: Combine custom Pygments lexers into a package (GH-121976) (cherry picked from commit 7431c3799efbd06ed03ee70b64420f45e83b3667) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] GH-121970: Make ``DeprecatedRemoved`` a subclass of ``VersionChange`` ↵Miss Islington (bot)2024-07-191-44/+24
| | | | | | | | (GH-121971) (#122020) GH-121970: Make ``DeprecatedRemoved`` a subclass of ``VersionChange`` (GH-121971) (cherry picked from commit 898e90c3bef77174f22193b114483b9cd196921a) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] GH-121970: Improve the glossary preview in HTML search (GH-121991) ↵Miss Islington (bot)2024-07-193-93/+91
| | | | | | | | (#122016) GH-121970: Improve the glossary preview in HTML search (GH-121991) (cherry picked from commit adf0b94d1cdd74340c8bc031f7464d0a33200f08) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-121905: Consistently use "floating-point" instead of "floating ↵Serhiy Storchaka2024-07-1950-153/+153
| | | | | point" (GH-121907) (GH-122013) (cherry picked from commit 1a0c7b9ba48a2dffb70bb0c7327abae1d3e87356)
* [3.12] Docs: Upgrade Sphinx to 7.4 (GH-121987) (#122011)Miss Islington (bot)2024-07-191-3/+3
| | | | | | Docs: Upgrade Sphinx to 7.4 (GH-121987) (cherry picked from commit 420d94312824825a18fa1fd9a36773626a54d97a) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] gh-65453: Docs - clarify AttributeError behaviour on PropertyMock ↵Miss Islington (bot)2024-07-191-0/+14
| | | | | | | | (GH-121666) (GH-121969) Fixed at EuroPython 24 sprints. (cherry picked from commit 94e6644584d9cb08a4edcd1027e288386184816b) Co-authored-by: Vlastimil Zíma <ziima@users.noreply.github.com>
* [3.12] GH-117928: Bump the minimum Sphinx version to 6.2.1 (GH-121986) (#121993)Miss Islington (bot)2024-07-191-1/+1
| | | | | | GH-117928: Bump the minimum Sphinx version to 6.2.1 (GH-121986) (cherry picked from commit 7dd52b63cef3ff60868dea510ef7a9adcc6611cc) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] GH-121970: Use ``SphinxDirective`` instead of ``Directive`` ↵Miss Islington (bot)2024-07-191-20/+16
| | | | | | | | (GH-121972) (#122009) GH-121970: Use ``SphinxDirective`` instead of ``Directive`` (GH-121972) (cherry picked from commit ac39151a09fc9857e64d7b8f7eff926ec0ba6c0b) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* [3.12] Docs: Fix typo in description of ``INTRINSIC_ASYNC_GEN_WRAP`` ↵Miss Islington (bot)2024-07-191-1/+1
| | | | | | | | (GH-122004) (#122007) Docs: Fix typo in description of ``INTRINSIC_ASYNC_GEN_WRAP`` (GH-122004) (cherry picked from commit 98e5bdef0ef59695371ec8a8486bb55ccf2b0638) Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
* [3.12] gh-64308: Remove TestProgram from the unittest docs (GH-121675) ↵Miss Islington (bot)2024-07-181-2/+2
| | | | | | | | (GH-121743) gh-64308: Remove TestProgram from the unittest docs (GH-121675) (cherry picked from commit f6f4022a357f70f1c40945403065e81b6c2e4854) Co-authored-by: Jan Musílek <jan.musilek@nic.cz>
* [3.12] gh-121874: Define audit-event open parameters consistently ↵Miss Islington (bot)2024-07-181-1/+1
| | | | | | | | | (GH-121883) (GH-121955) Use same names for parameters to avoid triggering a race-condition in Sphinx that causes non-deterministic output. (cherry picked from commit 24cf867bed6035f33cd3b38d89d303b7522f12a6) Co-authored-by: Bernhard M. Wiedemann <bwiedemann@suse.de>
* [3.12] gh-121834: Improve `complex` C-API docs (GH-121835) (#121897)sobolevn2024-07-171-6/+18
| | | | | | | | * [3.12] gh-121834: Improve `complex` C-API docs (GH-121835) (cherry picked from commit 72dccd60735b597e99c007a7b69210763a746877) Co-authored-by: sobolevn <mail@sobolevn.me> Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com> Co-authored-by: Petr Viktorin <encukou@gmail.com>
* [3.12] gh-121453: Update the `Doc/templates/download.html` download files ↵Miss Islington (bot)2024-07-171-10/+14
| | | | | | | size estimates and support download `.texi` format. (GH-121454) (#121891) Co-authored-by: Wulian233 <1055917385@qq.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* [3.12] gh-121871: Allow overriding docs build date with SOURCE_DATE_EPOCH ↵Miss Islington (bot)2024-07-171-1/+2
| | | | | | (GH-121872) (#121887) Co-authored-by: Bernhard M. Wiedemann <bwiedemann@suse.de>