]>
git.ipfire.org Git - thirdparty/Python/cpython.git/log
Miss Islington (bot) [Wed, 14 Sep 2022 19:56:14 +0000 (12:56 -0700)]
gh-96702: Order methods before attrs in sqlite3.Connection docs (GH-96703) (#96788)
(cherry picked from commit
49cceeb5c998a51bb12b7dbde17b53647bb52113 )
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Miss Islington (bot) [Thu, 15 Sep 2022 21:21:08 +0000 (14:21 -0700)]
gh-96810: Clarify for which statements sqlite3 implicitly opens transactions (GH-96832)
(cherry picked from commit
16c33a9676e2f3ef330d09f2ab515c56636fa09f )
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Miss Islington (bot) [Sun, 18 Sep 2022 03:01:12 +0000 (20:01 -0700)]
Clarify that the expression is regular math notation, not Python. (GH-96903) (GH-96908)
Miss Islington (bot) [Sun, 18 Sep 2022 03:11:29 +0000 (20:11 -0700)]
Simplify sieve() recipe. Add edge case tests. (GH-96892)
(cherry picked from commit
78359b1d45608439f8e03b8e86174fe7b04d3e08 )
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Miss Islington (bot) [Sun, 18 Sep 2022 22:53:31 +0000 (15:53 -0700)]
GH-96851: Add link to FAQ entry for caching method calls. (GH-96902)
(cherry picked from commit
bbc24b2bd569108b957ed24c5a95ffeaf8cde0db )
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Miss Islington (bot) [Mon, 19 Sep 2022 13:45:35 +0000 (06:45 -0700)]
gh-95913: Fix and copyedit New Features section of 3.11 What's New (GH-95915)
(cherry picked from commit
8ee27e33182e6d9040e79f6ccc9219afa049d40e )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Mon, 19 Sep 2022 13:51:08 +0000 (06:51 -0700)]
gh-95913: Copyedit, link & format Typing Features section in 3.11 What's New (GH-96097)
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit
558768ff22e47582ae95ad7c3f8955407934916e )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Mon, 19 Sep 2022 19:19:18 +0000 (12:19 -0700)]
gh-96917: link to typing.readthedocs.io from typing.rst (GH-96921)
See the discussion at https://github.com/python/cpython/issues/91533
(cherry picked from commit
5b3a2569f4b4dfb58a8f90a241f9dac1a7ea4bf6 )
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Miss Islington (bot) [Tue, 20 Sep 2022 08:52:09 +0000 (01:52 -0700)]
[3.11] gh-96727: Document restrictions on Handler.emit() with respect to locking. (GH-96948) (GH-96950)
(cherry picked from commit
6ad47b41a650a13b4a9214309c10239726331eb8 )
Miss Islington (bot) [Wed, 21 Sep 2022 13:11:48 +0000 (06:11 -0700)]
gh-81039: Add small example of f-string's "=}" to tutorial (gh-92291) (gh-96989)
(cherry picked from commit
4b81139aac3fa11779f6eedb6e621bde29e64b30 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Thu, 22 Sep 2022 18:18:02 +0000 (11:18 -0700)]
gh-96397: Document that keywords in calls need not be identifiers (GH-96393)
This represents the official SC stance, see
https://github.com/python/steering-council/issues/142GH-issuecomment-
1252172695
(cherry picked from commit
9d432b4a181cd42017699de4354e7b36c5b87d88 )
Co-authored-by: Jeff Allen <ja.py@farowl.co.uk>
Miss Islington (bot) [Fri, 23 Sep 2022 10:54:53 +0000 (03:54 -0700)]
gh-75608: Add Windows FAQ entry for missing UCRT (GH-92765)
(cherry picked from commit
80bc7d7c0a3f777da244ec79429baf382523b8da )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Steve Dower [Fri, 23 Sep 2022 12:55:06 +0000 (13:55 +0100)]
gh-77171: Document that wave only supports simple PCM files (GH-97510)
Miss Islington (bot) [Mon, 26 Sep 2022 04:15:52 +0000 (21:15 -0700)]
gh-82530: Create blank function instead of invalid import for email example (GH-97529)
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
(cherry picked from commit
2b428a1faed88f148ede131e3b86ab6227c6c3f0 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Mon, 26 Sep 2022 22:45:58 +0000 (15:45 -0700)]
GH-65046: Fix docs about logging in `asyncio` (GH-97559)
Explain that logging should not use network I/O.
(cherry picked from commit
d68c37c0d08542a346a13b150a204208bb0408f5 )
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Miss Islington (bot) [Tue, 27 Sep 2022 11:16:37 +0000 (04:16 -0700)]
gh-96959: Update more HTTP links (GH-97536)
Use HTTPS for documents which are available by both HTTP and HTTPS
links, but there is no redirection from HTTP to HTTPS or vice versa.
(cherry picked from commit
dd53b79de0ea98af6a11481217a961daef4e9774 )
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Miss Islington (bot) [Wed, 28 Sep 2022 00:33:32 +0000 (17:33 -0700)]
gh-96377: Update asyncio policy doc intro paras to be clear and accurate (GH-97603)
Also fix up some cross-references in the asyncio docs.
(cherry picked from commit
cc0f3a10f0ee507d9044ef9036cf3e711c5338a9 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Wed, 28 Sep 2022 04:32:01 +0000 (21:32 -0700)]
[3.11] gh-65046: Add note about logging from async code. (GH-97602) (GH-97608)
Miss Islington (bot) [Wed, 28 Sep 2022 13:45:48 +0000 (06:45 -0700)]
Fix docs on conditional expression grouping (GH-96447) (GH-97606)
Miss Islington (bot) [Wed, 28 Sep 2022 17:42:28 +0000 (10:42 -0700)]
fixup policy docs (GH-97618)
(cherry picked from commit
9a404b173e57ce171a867cfc3776cdf88d6c553f )
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Miss Islington (bot) [Thu, 29 Sep 2022 13:51:39 +0000 (06:51 -0700)]
gh-52597: Add position-only markers for os functions (GH-94735)
(cherry picked from commit
c759944f16ed9887a77d5ebd738f17f3892c2476 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Thu, 29 Sep 2022 23:00:33 +0000 (16:00 -0700)]
closes gh-97650: correct sphinx executable (gh-97651)
(cherry picked from commit
0179a82caa05a322d1dbab05155be6f919c281ff )
Co-authored-by: NoSuck <NoSuck@users.noreply.github.com>
Miss Islington (bot) [Thu, 29 Sep 2022 23:25:10 +0000 (16:25 -0700)]
gh-96397: Document that attributes need not be identifiers (GH-96454)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit
9a11ed8e50492d327e4de0a8f3a473e788b14a6f )
Co-authored-by: Jeff Allen <ja.py@farowl.co.uk>
Miss Islington (bot) [Fri, 30 Sep 2022 09:12:22 +0000 (02:12 -0700)]
[3.11] Use SyntaxError invalid range in tutorial introduction example (GH-93031) (GH-97666)
Use SyntaxError invalid range in tutorial introduction example (GH-93031)
Use output from a 3.10+ REPL, showing invalid range, for the
SyntaxError examples in the tutorial introduction page.
Co-authored-by: Eddie Hebert <eddie@eddiehebert.com>
Miss Islington (bot) [Fri, 30 Sep 2022 17:54:12 +0000 (10:54 -0700)]
gh-87597: Document TimeoutExpired.stdout & .stderr types (GH-97685)
This documents the behavior that has always been the case since timeout
support was introduced in Python 3.3.
(cherry picked from commit
b05dd796492160c37c9e15e3882f699f411b3461 )
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Miss Islington (bot) [Sat, 1 Oct 2022 23:51:34 +0000 (16:51 -0700)]
Fix capitalization of Unix in documentation (GH-96913)
(cherry picked from commit
bd7d0e875e6955dd69cde18a034e59a75b8b4d00 )
Co-authored-by: Will Hawkins <8715530+hawkinsw@users.noreply.github.com>
Miss Islington (bot) [Sun, 2 Oct 2022 05:20:43 +0000 (22:20 -0700)]
gh-95975: Move except/*/finally ref labels to more precise locations (GH-95976)
* gh-95975: Move except/*/finally ref labels to more precise locations
* Add section headers to fix :keyword: role and aid navigation
* Move see also to the introduction rather than a particular subsection
* Fix other minor Sphinx syntax issues with except
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* Suppress redundant link to same section for except too
* Don't link try/except/else/finally keywords if in the same section
* Format try/except/finally as keywords in modified sections
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
dcc82331c8f05a6a149ac15c519d4fbae72692b2 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Sun, 2 Oct 2022 05:28:54 +0000 (22:28 -0700)]
gh-97607: Fix content parsing in the impl-detail reST directive (GH-97652)
* Don't parse content as arg in the impl-detail directive
This does not change the (untranslated) output,
but ensures that the doctree node metadata is correct.
which fixes gh-97607 with the text not being translated.
It also simplifies the code and logic
and makes it consistant with the docutils built-in directives.
* Remove unused branch from impl-detail directive handling no-content case
This is not used anywhere in the docs and lacks a clear use case,
and is more likely a mistake which is now flagged at build time.
This simplifies the logic from two code paths to one,
and makes the behavior consistant with similar built-in directives
(e.g. the various admonition types).
* Further simplify impl-detail reST directive code
(cherry picked from commit
e8165d47b852e933c176209ddc0b5836a9b0d5f4 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Sun, 2 Oct 2022 16:44:42 +0000 (09:44 -0700)]
[3.11] [docs] Update logging cookbook with recipe for using a logger like an output… (GH-97730) (GH-97735)
Miss Islington (bot) [Sun, 2 Oct 2022 22:27:17 +0000 (15:27 -0700)]
GH-85447: Clarify docs about awaiting future multiple times (GH-97738)
(cherry picked from commit
9151bbefea3fb932eb6aa6ddb22d64b83f8149c7 )
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Miss Islington (bot) [Mon, 3 Oct 2022 04:02:46 +0000 (21:02 -0700)]
gh-97740: Fix bang in Sphinx C domain ref target syntax (GH-97741)
* gh-97740: Fix bang in Sphinx C domain ref target syntax
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Add NEWS entry for C domain bang fix
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
(cherry picked from commit
9148c0d893c7807331fd7be0997261e289074bc5 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Mon, 3 Oct 2022 04:11:05 +0000 (21:11 -0700)]
gh-95913: Copyedit/improve New Modules What's New section (GH-97721)
* Link TOML & WSGI in New Modules section, refine text & add ref label
* Further reformat new modules & add PEP link to tomllib
(cherry picked from commit
bd00112a99af44c6ef82ee45b4072ec3bbc82fef )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Mon, 3 Oct 2022 04:21:46 +0000 (21:21 -0700)]
gh-95913: Fix PEP number in PEP 678 What's New ref label (GH-97739)
What's New: Fix PEP number in PEP 678 ref target label
(cherry picked from commit
e738b5190bfa63086b5e8169189e9b05302873c8 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Mon, 3 Oct 2022 13:43:31 +0000 (06:43 -0700)]
Fix typo in unittest docs (GH-97742)
(cherry picked from commit
e6f9ec5c031bd996fcd5f463c407beef0b743b49 )
Co-authored-by: annonm <annonm@gmail.com>
Miss Islington (bot) [Mon, 3 Oct 2022 22:48:00 +0000 (15:48 -0700)]
multiprocessing docs: Remove extra option ELLIPSIS from section with code (GH-96625)
(cherry picked from commit
d78aa4e11a80653588229cc97119afae693d1c06 )
Co-authored-by: Ivan Kapeykin <5349983@gmail.com>
Miss Islington (bot) [Mon, 3 Oct 2022 23:30:07 +0000 (16:30 -0700)]
Minor grammar changes to http.client docs (GH-96221)
Minor grammar changes
(cherry picked from commit
d053c47bfde1b3d8779546b980849708662f2660 )
Co-authored-by: Rohan Shah <57906961+rshah713@users.noreply.github.com>
Miss Islington (bot) [Mon, 3 Oct 2022 23:35:10 +0000 (16:35 -0700)]
Update http.client.rst (GH-24803)
* Update http.client.rst
* Apply suggestions from code review
Co-authored-by: Éric <merwok@netwok.org>
* Update http.client.rst
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Senthil Kumaran <senthil@python.org>
(cherry picked from commit
0c91a125116b21e91d0d1cca457da830348f0806 )
Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
Miss Islington (bot) [Tue, 4 Oct 2022 01:55:04 +0000 (18:55 -0700)]
gh-93738: Documentation C syntax (:c:data:`0` -> ``0``) (GH-97771)
:c:data:`0` -> ``0``
(cherry picked from commit
5e997cff3e1dea24241726338457611beb8882ec )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 05:43:00 +0000 (22:43 -0700)]
gh-97709: Included newline separator in Mandelbrot set (GH-97737)
Included newline separator in Mandelbrot set
Now the Mandelbrot set one-liner example on separates the lines with a '\n' character.
(cherry picked from commit
49802605f8e47c5c7ddc8a6cecdf4afe44765586 )
Co-authored-by: matheusja <matheusjahnke@hotmail.com>
Miss Islington (bot) [Tue, 4 Oct 2022 13:15:46 +0000 (06:15 -0700)]
Adjust stable ABI internal documentation (GH-96896)
I was perusing this file, and noticed that this part of the documentation is slightly out of date: the `struct` items in this TOML file currently contain `struct_abi_kind` members, which distinguish between the different types of ABI compatibility described in the comment.
I've updated the comment to reflect this.
(cherry picked from commit
6e533088290b909df324615df24286489603989f )
Co-authored-by: William Woodruff <william@yossarian.net>
Miss Islington (bot) [Tue, 4 Oct 2022 16:13:37 +0000 (09:13 -0700)]
gh-97754: Update doc for default location of per-user installs on Windows (GH-97756)
(cherry picked from commit
a120b9f25d037a1c794df731f8cc6a2898a9165e )
Co-authored-by: Ben Faulhaber <111227622+faulhaberben@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 16:52:28 +0000 (09:52 -0700)]
GH-82604: fix docs about configuring selector (GH-97755)
(cherry picked from commit
53503ff60e9a4727af0d9a1096418675e72a0fae )
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 18:45:02 +0000 (11:45 -0700)]
GH-95913: Update what's new in 3.11 for asyncio (GH-97806)
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit
9fbfa42ece3e0256657ce2594c7c3eb8b3ac8ff3 )
Co-authored-by: Guido van Rossum <guido@python.org>
Miss Islington (bot) [Tue, 4 Oct 2022 22:14:52 +0000 (15:14 -0700)]
gh-90301: Doc: Add references to PEP 686 (GH-96816)
Doc: Add references to PEP 686.
(cherry picked from commit
87679a6e607eec1134d77222a3a92d0d11f768ad )
Co-authored-by: Inada Naoki <songofacandy@gmail.com>
Miss Islington (bot) [Tue, 4 Oct 2022 22:21:28 +0000 (15:21 -0700)]
[3.11] gh-96448: fix documentation for _thread.lock.acquire (GH-96449) (#97851)
gh-96448: fix documentation for _thread.lock.acquire (GH-96449)
* fix documentation for _thread.lock.acquire
* update formatting of _thread.lock.acquire() doc
(cherry picked from commit
7acb93f0d44c6fb971fdb09b86f68896e3b1e2f8 )
Co-authored-by: Daniel Giger <danielg3432@gmail.com>
Co-authored-by: Daniel Giger <danielg3432@gmail.com>
Miss Islington (bot) [Tue, 4 Oct 2022 22:55:34 +0000 (15:55 -0700)]
[3.11] gh-88355: Fix backslashes in AF_PIPE (GH-96543) (#97854)
gh-88355: Fix backslashes in AF_PIPE (GH-96543)
Fix backslashes in AF_PIPE (GH-88355)
The correct syntax for AF_PIPE addresses is `\\.\pipe\blahblah`, not `\.\pipe{blahblah}`, but the syntax markup messed up the backslashes.
(cherry picked from commit
ff28d8926de92d809e3b7f71d3e44672178ed11e )
Co-authored-by: cousteau <cousteaulecommandant@users.noreply.github.com>
Co-authored-by: cousteau <cousteaulecommandant@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 22:58:59 +0000 (15:58 -0700)]
gh-95913: Move py.exe to appropriate What's New section & refine text (GH-97718)
* Move Windows py.exe improvements from Typing section to New Features
* Add ref target label and use literal for py.exe
* Be clearer/explict about what legacy version arg components reprisent
* Apply other minor clarity and textual fixes to py.exe launcher text
* Refine phrasing of legacy sentence of py.exe desc
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
985958187d578cfa311e404588950b29fda95db7 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Tue, 4 Oct 2022 23:24:50 +0000 (16:24 -0700)]
gh-95913: Copyedit/improve Other Language Changes What's New section (GH-97719)
* Add/refine cross references to items in other lang changes section
* Unify context manager exception changes into single non-repetitive item
* More clearly describe the intent and consequences of the -P option
* Apply minor clarifications & copyedits to rest of section
* Tweak the formatting of module references
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
a77d9dedcd0d52c2663e9de4417dec9d1c5199f4 )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Tue, 4 Oct 2022 23:38:24 +0000 (16:38 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`Py_UNICODE*` -> :c:expr:`Py_UNICODE*`) (GH-97784) (#97857)
:c:type:`Py_UNICODE*` -> :c:expr:`Py_UNICODE*`
(cherry picked from commit
a081cae2a2cd1248ad067c3f7dc218ea7e3d203a )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 23:38:58 +0000 (16:38 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`PyUnicodeObject*` -> :c:expr:`PyUnicodeObject*`) (GH-97783) (#97859)
:c:type:`PyUnicodeObject*` -> :c:expr:`PyUnicodeObject*`
(cherry picked from commit
898834e27b82bd1f3532b6448a862a7a9cdeff66 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 23:40:47 +0000 (16:40 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`PyBytesObject*` -> :c:expr:`PyBytesObject*`) (GH-97782) (#97861)
:c:type:`PyBytesObject*` -> :c:expr:`PyBytesObject*`
(cherry picked from commit
9ebc50866b58a0ee2985c6540a67fee8a4a49e4d )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Tue, 4 Oct 2022 23:46:13 +0000 (16:46 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`PyTupleObject*` -> :c:expr:`PyTupleObject*`) (GH-97780) (#97863)
:c:type:`PyTupleObject*` -> :c:expr:`PyTupleObject*`
(cherry picked from commit
510baa429affb832d7b4ed68182e59daa2815d2e )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 00:47:02 +0000 (17:47 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`FILE` -> :c:expr:`FILE`) (GH-97769) (#97871)
:c:type:`FILE` -> :c:expr:`FILE`
(cherry picked from commit
192d401ba53224020f5f9ca6e1ff2c9f89511ac4 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 00:48:24 +0000 (17:48 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`TYPE` -> :c:expr:`TYPE`) (GH-97770) (#97874)
:c:type:`TYPE` -> :c:expr:`TYPE`
(cherry picked from commit
8b211b4cdbcddecfcc4d1682864795b5f1438c59 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 00:53:48 +0000 (17:53 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`PyInterpreterState *` -> :c:expr:`PyInterpreterState *`) (GH-97777) (#97865)
:c:type:`PyInterpreterState *` -> :c:expr:`PyInterpreterState *`
(cherry picked from commit
4ebb0250314b57637d213cd5bc5f5ce5dd911d94 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 00:55:17 +0000 (17:55 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:data:`view->obj` -> :c:expr:`view->obj`) (GH-97773) (#97867)
:c:data:`view->obj` -> :c:expr:`view->obj`
(cherry picked from commit
fa59bda8d30ea0b6c19007205b57c800c944304c )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 01:08:59 +0000 (18:08 -0700)]
gh-95913: Copyedit/improve Implementation Changes What's New section (GH-97720)
* Add and refine reST/Sphinx syntax for implementation changes section
* Clarify and refine wording in the Implementation Changes section
* Elide unnecessary comma
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
4e731814d781dae3419e981c0acc3ef833e26e8a )
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Miss Islington (bot) [Wed, 5 Oct 2022 01:29:54 +0000 (18:29 -0700)]
Add re.VERBOSE flag documentation example (GH-97678)
The current re.VERBOSE documentation example leaves space for ambiguous
interpretation. One may read that spaces within the `(?:` token are
spaces inside the non-capturing group (such as `(?: )`). This patch
removes the ambiguity by including examples after the statement.
(cherry picked from commit
0ceafa7fa408b64377ea31dd5386152da19ef38a )
Co-authored-by: Athos Ribeiro <athoscribeiro@gmail.com>
Miss Islington (bot) [Wed, 5 Oct 2022 08:57:30 +0000 (01:57 -0700)]
gh-97661: Improve accuracy of sqlite3.Cursor.fetchone docs (GH-97662)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit
4b83cd0b22428fbfccf1f0e85c0fc36be6ab7edf )
Co-authored-by: Jia Junjie <62194633+jiajunjie@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 15:18:27 +0000 (08:18 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`PyObject` -> :c:expr:`PyObject`) (GH-97776) (#97889)
:c:type:`PyObject` -> :c:expr:`PyObject`
(cherry picked from commit
0bf6a617ed1832bc4803e532c8d6b3427cf48b13 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 15:18:55 +0000 (08:18 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type: to :c:expr:, misc. cases) (GH-97775) (#97873)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 15:20:03 +0000 (08:20 -0700)]
[3.11] gh-93738: Documentation C syntax (Use `c:struct`) (GH-97772) (#97869)
Use `c:struct`
(cherry picked from commit
a0f5599aac2037da715d09733e0a83a9cba7c37a )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 15:21:32 +0000 (08:21 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:`PyTypeObject*` -> :c:expr:`PyTypeObject*`) (GH-97778) (#97892)
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
c70c8b69762f720377adaf22f2e5ec6496a7be53 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 18:00:29 +0000 (11:00 -0700)]
[3.11] gh-93738: Documentation C syntax (Function glob patterns -> literal markup) (GH-97774) (#97910)
(cherry picked from commit
0e72606dd4cf3023a4f8c2fe3c58082592b253f7 )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Miss Islington (bot) [Wed, 5 Oct 2022 18:01:17 +0000 (11:01 -0700)]
GH-95172 Make the same version `versionadded` oneline (GH-95172)
* Make the same version versionadded oneline
* Format versionadded for enum.rst
* Format versionadded
A single line versionadded was reading better.
Co-authored-by: Senthil Kumaran <senthil@python.org>
(cherry picked from commit
d6062d1170199c4f02acf6de8fcbf5d748a03db2 )
Co-authored-by: 180909 <734461790@qq.com>
Miss Islington (bot) [Wed, 5 Oct 2022 20:16:12 +0000 (13:16 -0700)]
docs(typing): add "see PEP 675" to LiteralString (GH-97926)
(cherry picked from commit
2016bc54a22b83d0ca9174b64257cc7bb67a0916 )
Co-authored-by: Simon Legner <Simon.Legner@gmail.com>
Łukasz Langa [Wed, 5 Oct 2022 21:11:12 +0000 (14:11 -0700)]
[3.11] gh-93738: Documentation C syntax (:c:type:<C type> -> :c:expr:<C type>) (GH-97768) (#97924)
:c:type:`<C type>` -> :c:expr:`<C type>`
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit
0031e62973801d34a9e19ab7bb199e9668e32d7b )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Miss Islington (bot) [Wed, 5 Oct 2022 21:50:46 +0000 (14:50 -0700)]
[3.11] gh-97654: Add auto exception chaining example to tutorial (GH-97703) (#97885)
gh-97654: Add auto exception chaining example to tutorial (GH-97703)
Add auto exception chaining example to tutorial
(cherry picked from commit
395b66a0ae5237eec195ca97daaaf8563706ed34 )
Co-authored-by: Shahriar Heidrich <smheidrich@weltenfunktion.de>
Miss Islington (bot) [Wed, 5 Oct 2022 22:03:18 +0000 (15:03 -0700)]
[3.11] gh-96197: Fix expression when :func:`sys.breakpointhook is missing (gh-96293) (#96294)
(cherry picked from commit
47d406ffc4946b023e38322c5235bec25f068481 )
Co-authored-by: Dong-hee Na <donghee.na@python.org>
Miss Islington (bot) [Wed, 5 Oct 2022 23:54:21 +0000 (16:54 -0700)]
GH-88968: Add notes about socket ownership transfers (GH-97936)
(cherry picked from commit
74ea204634f8eb4745afd5cb75c3fe7749cf38b5 )
Co-authored-by: Guido van Rossum <guido@python.org>
Miss Islington (bot) [Thu, 6 Oct 2022 00:21:55 +0000 (17:21 -0700)]
[3.11] gh-95691: Doc BufferedWriter and BufferedReader (GH-95703) (#97947)
gh-95691: Doc BufferedWriter and BufferedReader (GH-95703)
(cherry picked from commit
0d68879104dfb392d31e52e25dcb0661801a0249 )
Co-authored-by: 180909 <734461790@qq.com>
Co-authored-by: 180909 <734461790@qq.com>
Miss Islington (bot) [Thu, 6 Oct 2022 17:49:29 +0000 (10:49 -0700)]
[3.11] gh-93738: Disallow pre-v3 syntax in the C domain (GH-97962) (#97976)
Also, disable using invalid sphinx-lint 0.6.2.
(cherry picked from commit
f612565bd32d4ab0945798da775eea070f08b6fe )
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Miss Islington (bot) [Thu, 6 Oct 2022 19:32:39 +0000 (12:32 -0700)]
gh-86482: Document assignment expression need for ()s (GH-23291)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit
2b5f1360ead9aa72ae00de59edfd6c229d13933f )
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Barry Warsaw [Thu, 6 Oct 2022 20:47:33 +0000 (13:47 -0700)]
[3.11] Backport
effc25f 3.11 (#97991)
* Add Pynche's move to the What's new in 3.11 (#97974)
* Add Pynche's move to the What's new in 3.11
* Update Doc/whatsnew/3.11.rst
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
effc25f7f25ae1ac053415addc584b050c022dcb )
* [3.11] Add Pynche's move to the What's new in 3.11 (GH-97974)
* Add Pynche's move to the What's new in 3.11
* Update Doc/whatsnew/3.11.rst
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>.
(cherry picked from commit
effc25f7f25ae1ac053415addc584b050c022dcb )
Co-authored-by: Barry Warsaw <barry@python.org>
Miss Islington (bot) [Thu, 6 Oct 2022 21:01:27 +0000 (14:01 -0700)]
[3.11] Docs: pin sphinx-lint (GH-97992) (GH-97993)
Miss Islington (bot) [Thu, 6 Oct 2022 21:10:06 +0000 (14:10 -0700)]
[3.11] gh-97850: Remove the open issues section from the import reference (GH-97935) (GH-97994)
Remove the open issues section from the import reference
Tracking in https://github.com/python/cpython/issues/97850 instead.
(cherry picked from commit
f8edc6ff531bb98858185857513371f14519ed1d )
Co-authored-by: Brett Cannon <brett@python.org>
Automerge-Triggered-By: GH:brettcannon
Miss Islington (bot) [Fri, 7 Oct 2022 00:56:24 +0000 (17:56 -0700)]
[3.11] Remove extra spaces in custom openSSL documentation. (GH-93568) (#98007)
Remove extra spaces in custom openSSL documentation. (GH-93568)
(cherry picked from commit
4875433682ffec2694647ac43f1b21f5ad73fd25 )
Co-authored-by: Xiao Chen <chenxiao_7@163.com>
Co-authored-by: Xiao Chen <chenxiao_7@163.com>
Miss Islington (bot) [Fri, 7 Oct 2022 08:46:31 +0000 (01:46 -0700)]
Misc updates to the itertools recipes and tests (GH-98018)
(cherry picked from commit
e500cc04517bd65668f2e203c1e37b0cc5b1cf1b )
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Miss Islington (bot) [Fri, 7 Oct 2022 14:10:46 +0000 (07:10 -0700)]
gh-71316: Update dis documentation to include changes to jump arguments (GH-95798)
(cherry picked from commit
6592a62ec2939323b895c85780da7fd73a640da3 )
Co-authored-by: Christopher Chianelli <cchianel@redhat.com>
Miss Islington (bot) [Fri, 7 Oct 2022 18:21:01 +0000 (11:21 -0700)]
gh-64921: Clarify wording for open()'s newline arg (GH-96171)
(cherry picked from commit
4a74e6ab3885e7906cc5e0b15addc7779bc76249 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Fri, 7 Oct 2022 19:02:51 +0000 (12:02 -0700)]
[3.11] gh-96959: Update HTTP links which are redirected to HTTPS (GH-98039) (#98049)
(cherry picked from commit
c81c64ca58822156beba79dfd3035bf2a5b7354e )
Co-authored-by: 180909 <734461790@qq.com>
Miss Islington (bot) [Fri, 7 Oct 2022 20:53:15 +0000 (13:53 -0700)]
[3.11] gh-91708: Revert params note in urllib.parse.urlparse table (GH-96699) (#98052)
Revert params note in urllib.parse.urlparse table
(cherry picked from commit
eed80458e8e776d15fa862da71dcce58c47e2ca7 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Fri, 7 Oct 2022 23:05:52 +0000 (16:05 -0700)]
gh-61105: Add default param, note on using cookiejar subclass (GH-95427)
(cherry picked from commit
5eaf4d610147a3b9adc91a55790096d05bbe01d4 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Sat, 8 Oct 2022 05:07:06 +0000 (22:07 -0700)]
gh-97822: Fix http.server documentation reference to test() function (GH-98027)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit
6b485629d2e3e232460db7da3f8b18b67d4f4da8 )
Co-authored-by: JasonYZ <yurenzhang2017@gmail.com>
Miss Islington (bot) [Sat, 8 Oct 2022 07:01:27 +0000 (00:01 -0700)]
gh-97913 Docs: Add walrus operator to the index (GH-97921)
* Add walrus operator to the index
* Add named expression to the index
Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
* Fix indentation and add missing newline
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit
296313002fde56f52d6c81f17d7ba5c2eb57d098 )
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Miss Islington (bot) [Sun, 9 Oct 2022 02:03:25 +0000 (19:03 -0700)]
Minor edits to the Descriptor HowTo Guide (GH-24901)
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
(cherry picked from commit
2d2e01aa4cb72db8dabcd04e87f1e60b3597267e )
Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
Miss Islington (bot) [Mon, 10 Oct 2022 01:02:00 +0000 (18:02 -0700)]
gh-56133: copyreg docs: Clarify function/constructor parameter (GH-95497)
(cherry picked from commit
281a3f18cc2afac0fa92c75e807775971e531711 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Mon, 10 Oct 2022 01:03:53 +0000 (18:03 -0700)]
Fix types in buffer/memoryview docs (GH-98118)
The definition of obj in the `Py_buffer` struct is as a PyObject*
https://github.com/python/cpython/blob/
ec091bd47e2f968b0d1631b9a8104283a7beeb1b /Include/pybuffer.hGH-L22
PyMemoryView_GET_BASE returns `.obj` - thus its return type
should be a PyObject* (or at least a void*). It definitely
doesn't return `Py_buffer`
(cherry picked from commit
c459fedf7cfd5dadf72e088d789c7375b3a6e093 )
Co-authored-by: da-woods <dw-git@d-woods.co.uk>
Miss Islington (bot) [Mon, 10 Oct 2022 08:50:26 +0000 (01:50 -0700)]
doc: remove a misleading statement. (GH-98093)
(cherry picked from commit
571e23d99157ed7ad67ca2334a396fc9ddbe07ec )
Co-authored-by: Julien Palard <julien@palard.fr>
Miss Islington (bot) [Mon, 10 Oct 2022 14:01:05 +0000 (07:01 -0700)]
gh-83940: os docs: Improve wording for getenv/getenvb (GH-98113)
(cherry picked from commit
187e853690908ca2af19a0701ca7529b43d05df9 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Mon, 10 Oct 2022 20:10:04 +0000 (13:10 -0700)]
[3.11] gh-88452: Add a warning about non-portability of environments. (GH-98155) (GH-98157)
Miss Islington (bot) [Tue, 11 Oct 2022 16:22:04 +0000 (09:22 -0700)]
gh-98172: Fix formatting in `except*` docs (GH-98173)
(cherry picked from commit
5ecf961640192a2192383aa20e1e93dcdf23c9b6 )
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Miss Islington (bot) [Wed, 12 Oct 2022 02:45:44 +0000 (19:45 -0700)]
gh-96130: Rephrase use of "typecheck" verb for clarity (GH-98144)
I'm sympathetic to the issue report, especially in case this helps
clarify to new users that Python itself does not do type checking at runtime
(cherry picked from commit
ed6344eed043eaaa41d11c1176c25aa79de64ef4 )
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Miss Islington (bot) [Wed, 12 Oct 2022 02:50:25 +0000 (19:50 -0700)]
gh-95276: Add callable entry to the glossary (GH-95738)
(cherry picked from commit
e3bf125c81d5da0734429c1cb6ae75e6086e35ae )
Co-authored-by: MonadChains <monadchains@gmail.com>
Miss Islington (bot) [Wed, 12 Oct 2022 04:05:12 +0000 (21:05 -0700)]
Formatting fixes in contextlib docs (GH-98111)
(cherry picked from commit
3b33c2010aa00ef5877bc35b02ae658e3c9f27af )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Wed, 12 Oct 2022 04:51:13 +0000 (21:51 -0700)]
gh-65046: Link to logging cookbook from asyncio docs (GH-98207)
(cherry picked from commit
c39a0c335486fa8eac0f3030930f9e8769118a4f )
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Miss Islington (bot) [Wed, 12 Oct 2022 16:08:56 +0000 (09:08 -0700)]
tutorial: remove "with single quotes" (GH-98204)
Closes GH-91856.
On Windows double quotes are sometimes better, on Unix usually
single quotes. It's not our place to explain that, so just don't.
(cherry picked from commit
5f8ca1b7969f34ee09adb7b28337ebd920e6215a )
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Miss Islington (bot) [Wed, 12 Oct 2022 16:13:24 +0000 (09:13 -0700)]
gh-96265: Formatting changes for faq/general (GH-98129)
* Some formatting changes for general faq
* Use list for Python versioning
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* New line for list, list for a/b/rc
* Line wrap for 80 chars
* More line wrap
* Remove PythonWin mention.
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit
e9569ec43e2376aa77240cd630db4be07e8720f3 )
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Miss Islington (bot) [Sat, 15 Oct 2022 14:32:37 +0000 (07:32 -0700)]
gh-91485: Doc: Using Python syntax to document builtin Python functions. (GH-96579)
(cherry picked from commit
3c4cbd177f36777a04e78eb07ce20367560a66d3 )
Co-authored-by: Julien Palard <julien@palard.fr>
Miss Islington (bot) [Sat, 15 Oct 2022 16:12:18 +0000 (09:12 -0700)]
gh-98227: executionmodel.rst: except* can also bind names (GH-98256)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit
146f168fbf5b239158922f4defd494088c381525 )
Co-authored-by: BiscuitCandy <70342294+BiscuitCandy@users.noreply.github.com>