Commit graph

25355 commits

Author SHA1 Message Date
Miss Islington (bot)
e8404f46b3
asyncio.Barrier docs: Fix typo (GH-93371)
taks -> tasks
(cherry picked from commit 8584981a58)

Co-authored-by: Omer Katz <omer.katz@omerkatz.com>
2022-06-06 07:54:44 -07:00
Miss Islington (bot)
fae93ab163
[3.11] gh-68966: Make mailcap refuse to match unsafe filenames/types/params (GH-91993) (GH-93458)
(cherry picked from commit b9509ba7a9)


Co-authored-by: Petr Viktorin <encukou@gmail.com>

Automerge-Triggered-By: GH:encukou
2022-06-03 08:25:58 -07:00
Ken Jin
74b91b1763
[3.11] gh-93433: Fix dis doc example output (GH-93434) (GH-93460)
(cherry picked from commit debf4c1ec5)
2022-06-03 21:26:43 +08:00
Miss Islington (bot)
d779e5d16e
Remove the execution bit to some socket-related files. (GH-93368)
(cherry picked from commit 5247389369)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-06-01 00:35:15 -07:00
Miss Islington (bot)
00f8fe9564
[3.11] gh-91162: Fix substitution of unpacked tuples in generic aliases (GH-92335) (#92484)
* gh-91162: Fix substitution of unpacked tuples in generic aliases (GH-92335)
(cherry picked from commit 9d25db9db1)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

* Regenerate ABI file

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Pablo Galindo <pablogsal@gmail.com>
2022-06-01 03:13:27 +01:00
Miss Islington (bot)
3a62701452
Remove VOC reference (93333)
VOC has been archived by the BeeWare project, and they are instead
embedding CPython, rather than transpiling to Java bytecode.
(cherry picked from commit bb900712a5)

Co-authored-by: Carl Bordum Hansen <carl@bordum.dk>
2022-05-31 10:46:37 -07:00
Miss Islington (bot)
cc31cfc25e
bpo-42272: fix misleading warning filter message/module docs (GH-23172)
* bpo-42272: improve message/module warning filter docs

"The Warnings Filter" section of the warnings module documentation
describes the message and module filters as "a string containing a
regular expression".  While that is true when they are arguments to the
filterwarnings function, it is not true when they appear in -W or
$PYTHONWARNINGS where they are matched literally (after stripping any
starting/ending whitespace).  Update the documentation to note when they
are matched literally.  Also clarify that module matches the
"fully-qualified module name", rather than "module name" which is
ambiguous.

skip news (since this is a doc fix)

Signed-off-by: Kevin Locke <kevin@kevinlocke.name>

* bpo-42272: remove bad submodule warning filter doc

The `error:::mymodule[.*]` example in the "Describing Warning Filters"
section of the warnings module documentation does not behave as the
comment describes.  Since the module portion of the filter string is
interpreted literally, it would match a module with a fully-qualified
name that is literally `mymodule[.*]`.

Unfortunately, there is not a way to match '"module" and any subpackages
of "mymodule"' as documented, since the module part of a filter string
is matched literally.  Instead, update the filter and comment to match
only "mymodule".

skip news (since this is a doc fix)

Signed-off-by: Kevin Locke <kevin@kevinlocke.name>

* bpo-42272: add warning filter doc changes to NEWS

Signed-off-by: Kevin Locke <kevin@kevinlocke.name>
(cherry picked from commit 8136606769)

Co-authored-by: Kevin Locke <kevin@kevinlocke.name>
2022-05-29 19:04:21 -07:00
Miss Islington (bot)
624fc61c83
gh-92240 : Include release dates for "What's New In Python 3.X" (GH-92937)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
(cherry picked from commit 877ad7b3b2)

Co-authored-by: georgically <40323509+georgically@users.noreply.github.com>
2022-05-28 20:38:48 -07:00
Miss Islington (bot)
48647d00bf
gh-92727: Add example of named group in doc for re.Match.__getitem__ (GH-92730)
(cherry picked from commit 642d1fa81f)

Co-authored-by: Baptiste Mispelon <bmispelon@gmail.com>
2022-05-28 11:28:52 -07:00
Eric Snow
36374251aa
[3.11] bpo-40514: Drop EXPERIMENTAL_ISOLATED_SUBINTERPRETERS (gh-93185) (GH-93306)
(cherry picked from commit caa279d6fd)

This was added for bpo-40514 (gh-84694) to test out a per-interpreter GIL.  However, it has since proven unnecessary to keep the experiment in the repo.  (It can be done as a branch in a fork like normal.)  So here we are removing:

* the configure option
* the macro
* the code enabled by the macro

Automerge-Triggered-By: GH:ericsnowcurrently
2022-05-27 17:56:30 -07:00
Miss Islington (bot)
3f7abff97b
gh-91243: Document Required and NotRequired (GH-93173)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit 711eda7dec)

Co-authored-by: David Foster <david@dafoster.net>
2022-05-27 15:25:50 -07:00
Miss Islington (bot)
34bd36c99f
gh-77024: test.support: Improve documentation (GH-92513)
This is a rework of GH-5774 on current main. I was a bit more
conservative in making changes than the original PR.

See @csabella's comments on issue GH-77024 and the discussion
on GH-5774 for explanations of several of the changes.

Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit 8995177030)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-27 07:31:35 -07:00
Miss Islington (bot)
83940c0766
gh-90817: Deprecate explicitly locale.resetlocale() (GH-93196)
The function was already deprecated in Python 3.11 since it calls
locale.getdefaultlocale() which was deprecated in Python 3.11.
(cherry picked from commit bf58cd01b3)

Co-authored-by: Victor Stinner <vstinner@python.org>
2022-05-25 13:29:58 -07:00
Miss Islington (bot)
74b205b3eb
gh-92728: Restore re.template, but deprecate it (GH-93161)
Revert "bpo-47211: Remove function re.template() and flag re.TEMPLATE (GH-32300)"

This reverts commit b09184bf05.
(cherry picked from commit 16a7e4a0b7)

Co-authored-by: Miro Hrončok <miro@hroncok.cz>
2022-05-24 23:32:20 -07:00
Miss Islington (bot)
fd35be511a
Doc: No need to use rst syntax in code comments. (GH-93102)
And it raises `make suspicious` false positives.
(cherry picked from commit e739ff1416)

Co-authored-by: Julien Palard <julien@palard.fr>
2022-05-23 15:00:34 -07:00
Miss Islington (bot)
cea65730a7
gh-92859: Doc: add info about logging.debug() calling basicConfig() (GH-93063) (GH-93151)
(cherry picked from commit 2176898308)
2022-05-23 20:45:03 +01:00
Miss Islington (bot)
fc31e2de3c
gh-92913: Fix typos in documentation (GH-93129)
(cherry picked from commit 6a6f823ea7)

Co-authored-by: Steve Dower <steve.dower@python.org>
2022-05-23 09:54:36 -07:00
Miss Islington (bot)
9a2fe42b11
gh-89158: Add some REPL secondary prompt markers (GH-93073)
This fixes an issue on tutorial/classes.rst section 9.4 where the example "class Warehouse"
was truncated when pressing the >>> button to hide the prompts and output.
(cherry picked from commit 88f0d0c1e8)

Co-authored-by: Nicolas Haller <nicolas@haller.im>
2022-05-22 22:18:09 -07:00
Miss Islington (bot)
83aa0d1822
gh-73137: Added sub-subsection headers for flags in re (GH-93000)
Fixes GH-73137
(cherry picked from commit b7a6610bc8)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2022-05-22 19:14:11 -07:00
Miss Islington (bot)
247e059de3
gh-92994: Clarify importlib "check" example (GH-92995)
Fixes GH-92994
(cherry picked from commit e39cd76561)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-05-22 19:10:57 -07:00
Miss Islington (bot)
25334ca082
binascii docs: strict_mode parameter is keyword-only (GH-93055)
See 35b98e38b6

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
(cherry picked from commit ac718d357a)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-22 19:05:09 -07:00
Miss Islington (bot)
a86ad12399
termios docs: fix indentation (GH-93080)
(cherry picked from commit ea5918e932)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-22 16:11:36 -07:00
Miss Islington (bot)
09c3dff3ba
gh-91362: reword pickle docs to account for nested classes (GH-92429)
Fixes GH-91362
(cherry picked from commit f9d6c59917)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-05-21 08:08:59 -07:00
Miss Islington (bot)
f2aeb3f6f7
gh-71223: Improve rendering of some references in the docs (GH-93041)
For example, instead of "eval()uated" (link from "eval()")
show "evaluated" (link from the whole word).
(cherry picked from commit 7f835923c1)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-05-21 00:49:36 -07:00
Miss Islington (bot)
b97e28f1c2
gh-93019: Fix markup in zipfile.rst (GH-93025)
Fixes GH-93019
(cherry picked from commit 2fadde7e66)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-05-20 21:52:32 -07:00
Miss Islington (bot)
b52e44d933
Take advantage of math.comb() in the nth_combination() recipe (GH-93027) (#93032) 2022-05-20 18:34:30 -05:00
Miss Islington (bot)
61dfe37429
[3.11] gh-72073: Add Windows case in pathlib.rename (GH-93002) (GH-93028)
GH-72073

https://docs.python.org/3.12/library/pathlib.htmlGH-pathlib.Path.rename
(cherry picked from commit f51ed04c66)


Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>

Automerge-Triggered-By: GH:brettcannon
2022-05-20 15:42:28 -07:00
Miss Islington (bot)
24223ec82a
gh-92611: Clarify planned removal version in PEP 594-deprecated modules (GH-92793) (GH-93026)
As discussed in GH-92611 and GH-92564 and as a followup to PR GH-92612 , this 3.11+ only PR uses the proper `deprecated-removed` role for the modules deprecated by PEP 593 (PEP-594) to clearly indicate to users that a removal version is planned and what it is, so they can prepare accordingly or voice any unanticipated impacts.

Related to GH-92792 ; if we decide to backport that PR, the upgrade to using `deprecated-removed` on those functions can be moved to this one.
(cherry picked from commit 31fa41ed68)

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-05-20 15:33:12 -07:00
Miss Islington (bot)
6a3a6ba7a2
gh-91860: documentation for typing.dataclass_transform (GH-92768)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit f20a6a54fb)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-05-20 08:01:44 -07:00
Miss Islington (bot)
6814ab7907
Doc: add missing manpage and title references in tkinter docs (GH-29008)
- add bind(3tk) manpage markup
- add Tcl/Tk book reference markup
(cherry picked from commit 0e12781ad9)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
2022-05-20 01:34:21 -07:00
Miss Islington (bot)
4eb2f40756
gh-92913: Clarify changes to PyInitConfig.module_search_paths[_set] fields (GH-92980)
(cherry picked from commit 403d16fa28)

Co-authored-by: Steve Dower <steve.dower@python.org>
2022-05-19 13:13:15 -07:00
Miss Islington (bot)
37d60c0255
gh-92417: importlib docs: remove references to unsupported Python versions (GH-92424) (GH-92979)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
(cherry picked from commit 70aa1b9b91)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-05-19 18:11:25 +02:00
Miss Islington (bot)
27302ae2df
bpo-46879: Fix incorrect sphinx object names in doc (GH-31615) (GH-92974)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 2cdd57f119)

Co-authored-by: Martin Fischer <martin@push-f.com>
2022-05-19 17:56:59 +02:00
Miss Islington (bot)
de97d8229c
gh-92417: subprocess docs: remove note on compatibility with Python <3.5 (GH-92538) (GH-92972)
(cherry picked from commit 84b86000e2)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-05-19 17:56:04 +02:00
Miss Islington (bot)
02fe22576e
gh-92417: fractions, decimal: Improve docs for alternative constructor methods (GH-92421) (GH-92970)
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 090df844ea)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-05-19 17:45:12 +02:00
Miss Islington (bot)
a2d6e6c206
gh-92417: socket docs: remove references to Python <3.3 (GH-92544) (GH-92968)
(cherry picked from commit 639b62c9c4)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-05-19 17:42:07 +02:00
Miss Islington (bot)
4d1e243fca
bpo-45393: help() on operator precedence has misleading entries (GH-31246) (GH-92965)
(cherry picked from commit fb082c2fc5)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2022-05-19 17:40:49 +02:00
Miss Islington (bot)
54653b5005
gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL for Py>=3 (GH-92502) (GH-92962)
(cherry picked from commit 97b9c1096f)
2022-05-19 17:19:34 +02:00
Miss Islington (bot)
611d43c2a4
gh-91491: Complete Whats New in 3.11 for typing (GH-92708)
Fixes GH-91491

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit 6b51773afd)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-19 07:25:50 -07:00
Miss Islington (bot)
17a62d1e59
Doc: amend ssl.PROTOCOL_SSLv2 and ssl.PROTOCOL_SSLv3 wording (GH-92634)
(cherry picked from commit 41638967a0)

Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
2022-05-19 02:37:57 -07:00
Miss Islington (bot)
482e334daf
Include `asyncio.Barrier` in 3.11 Whats New (GH-92927)
(cherry picked from commit 60ee61571a)

Co-authored-by: Duprat <yduprat@gmail.com>
2022-05-19 01:59:49 -07:00
Miss Islington (bot)
aa55985aa8
gh-87901: Remove the encoding argument from os.popen (GH-92836)
(cherry picked from commit 96f65835f8)

Co-authored-by: Inada Naoki <songofacandy@gmail.com>
2022-05-18 20:12:47 -07:00
Miss Islington (bot)
849963598f
gh-92812: Align ArgumentParser.add_subparsers() docs with argument spec (GH-92814)
(cherry picked from commit f2d994da10)

Co-authored-by: 180909 <734461790@qq.com>
2022-05-18 14:25:25 -07:00
Miss Islington (bot)
65ebd923b3
gh-92780: Improve sqlite3.Connection.create_collation docs (GH-92790)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit 7ee19e2715)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-05-18 04:58:57 -07:00
Miss Islington (bot)
fad72d0e36
gh-91755: Document Py_IncRef and Py_DecRef as C functions (GH-91805)
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 58a3d28039)

Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com>
2022-05-18 02:00:22 -07:00
Miss Islington (bot)
9a61afec20
bpo-40838: document getdoc, getmodule, getsourcefile in inspect returns None (GH-30575)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b86d783a4e)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2022-05-17 18:41:55 -07:00
Miss Islington (bot)
76b81be413
gh-81548: Clarify the deprecation of octal sequences affect byte strings (GH-92643)
Automerge-Triggered-By: GH:pablogsal
(cherry picked from commit 0d8500c739)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2022-05-17 09:44:23 -07:00
Miss Islington (bot)
da2f0c755d
re docs: fix source code link (GH-92819)
(cherry picked from commit bd30461298)

Co-authored-by: 谭九鼎 <109224573@qq.com>
2022-05-16 17:21:50 -07:00
Miss Islington (bot)
2ef6a986ee
Speedup: build docs in parallel (GH-92733)
(cherry picked from commit a487623c6b)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-05-16 05:17:20 -07:00
Miss Islington (bot)
fdfc7eb410
gh-87670: Add web.archive redirects from effbot (GH-92816)
(cherry picked from commit 3ed1cae9ed)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
2022-05-15 23:26:31 -07:00