Commit graph

111254 commits

Author SHA1 Message Date
Miss Islington (bot)
97151e1e3a
crypt docs: Fix references to methods attr (GH-26806)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit cae0f5d3da)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
2022-04-04 20:09:45 -07:00
Miss Islington (bot)
d95e072c41
bpo-32658: Regex docs: Fix metacharacter reference (GH-32230)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 43571a3eea)

Co-authored-by: Mike cm <mikecmcleod@gmail.com>
2022-04-04 20:08:17 -07:00
Miss Islington (bot)
f4e711bb49
bpo-45790: List macros in same order in which fields are described (GH-29529)
Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b275267aa7)

Co-authored-by: rtobar <rtobar@icrar.org>
2022-04-04 19:57:22 -07:00
Miss Islington (bot)
f502dadb33
bpo-47007: [doc] str special method lookup (GH-31863)
Clarify the `str()` docs to point out that `object.__str__()`
follows special method lookup.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit bb86d1d9fb)

Co-authored-by: Vanshaj Singhania <8797467+itsvs@users.noreply.github.com>
2022-04-04 19:56:29 -07:00
Miss Islington (bot)
3fa800d7a7
bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)
Co-authored-by: Andrew Kuchling <amk@amk.ca>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit a74892cb21)

Co-authored-by: yyyyyyyan <24644216+yyyyyyyan@users.noreply.github.com>
2022-04-04 19:30:06 -07:00
Miss Islington (bot)
6b4b892e09
bpo-46484:Add test for Calendar.iterweekdays (GH-30825)
(cherry picked from commit 48269ea9fd)

Co-authored-by: 180909 <734461790@qq.com>
2022-04-04 10:43:38 -07:00
Miss Islington (bot)
29ffac2d39
Demonstrate py --list in the quickstart section of the Windows doc page (GH-29383)
(cherry picked from commit 1ecfe3d5ae)

Co-authored-by: Christian Clauss <cclauss@me.com>
2022-04-04 08:58:44 -07:00
Miss Islington (bot)
a331d0f627
Follow PEP-8 guidelines in tutorial for standard library (GH-26127)
(cherry picked from commit 6db2db91b9)

Co-authored-by: Bob Kline <bkline@users.noreply.github.com>
2022-04-03 15:49:52 -07:00
Miss Islington (bot)
470dfe20cb
bpo-47205: Skip error check of sched_get/setaffinity on FreeBSD (GH-32285)
(cherry picked from commit b82cdd1dac)

Co-authored-by: Christian Heimes <christian@python.org>
2022-04-03 12:27:32 -07:00
Miss Islington (bot)
a5c90784be
Language reference: Remove duplicated text about iterable unpacking (GH-25212)
(cherry picked from commit 4f5d56f8f3)

Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>
2022-04-02 20:05:11 -07:00
Miss Islington (bot)
ce6af314ca
bpo-24563: Link encoding names to encoding declarations (GH-32274)
(cherry picked from commit 01be5d6446)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2022-04-02 17:40:55 -07:00
Jelle Zijlstra
11f5fd1135
[3.10] More minor fixes to C API docs (GH-31525) (GH-32258)
* wording fixes in type.rst

* grammar and punctuation in sys.rst

* set: grammar fixes

* structures: capitalization fix

* grammar fixes for sequence

* objects: point to Py_TYPE instead of direct object access

* numbers: add more explicit Python equivalences

* method: add missing period

* memory: grammar fix

* mapping: grammar fixes

* long: grammar fix

* iter: fix grammar for PyAIter_Check

* init: grammar fix.
(cherry picked from commit 897bc6f928)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-02 16:00:51 -07:00
Jelle Zijlstra
a930062d25
[3.10] Document func parameter of locale.atof (GH-18183) (GH-32262)
The second parameter (named `func`) has been present since the `locale`
module was introduced in eef1d4e8b1, but has never been documented.

This commit updates the documentation for `locale.atof` to clarify the
behavior of the function and how the `func` parameter is used.

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

Co-authored-by: Kevin Locke <kevin@kevinlocke.name>
2022-04-02 15:59:41 -07:00
Miss Islington (bot)
3031b86753
bpo-45584: Clarify math.trunc documentation (GH-29183)
While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit ebbdbbff5d)

Co-authored-by: Arthur Milchior <arthur@milchior.fr>
2022-04-02 15:30:59 -07:00
Miss Islington (bot)
8d9a75b206
os docs: fix typo (GH-28996)
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
(cherry picked from commit 1f80dcd244)

Co-authored-by: Vitor Buxbaum Orlandi <vitorbuxbaum@gmail.com>
2022-04-02 15:00:12 -07:00
Miss Islington (bot)
2d936a42ac
codecs docs: fix grammar mistake (GH-29462)
(cherry picked from commit ea56845744)

Co-authored-by: 180909 <wjh180909@gmail.com>
2022-04-02 14:33:52 -07:00
Miss Islington (bot)
23c0200c43
bpo-45114: Use lstat() instead of stat() in stat docs example (GH-29845)
(cherry picked from commit c93a0ac697)

Co-authored-by: 180909 <wjh180909@gmail.com>
2022-04-02 14:19:48 -07:00
Miss Islington (bot)
319a70cf99
bpo-47031: Improve documentation for math.nan (GH-32170)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 182e93c3f5)

Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com>
2022-04-02 13:19:20 -07:00
Miss Islington (bot)
5830a288ab
More minor fixes to C API docs (GH-31714)
* init_config: wording fixes

* bytearray: remove XXX, there is a good link to the buffer docs

* bytes, call, exceptions: minor wording fixes
(cherry picked from commit 677a879466)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-02 12:54:04 -07:00
Miss Islington (bot)
16a809ffb7
bpo-47194: Update zlib to v1.2.12 on Windows to resolve CVE-2018-25032 (GH-32241)
(cherry picked from commit 6066739ff7)

Co-authored-by: Zachary Ware <zach@python.org>
2022-04-02 06:39:03 -07:00
Miss Islington (bot)
1069d52959
bpo-47089: Avoid test_compileall failures on Windows (GH-32037)
(cherry picked from commit 76b8a075b8)

Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>
2022-04-01 13:38:35 -07:00
Christian Heimes
55d5c96c57
[3.10] bpo-47182: Fix crash by named unicode characters after interpreter reinitialization (GH-32212) (GH-32216)
Co-authored-by: Christian Heimes <christian@python.org>
2022-04-01 10:44:56 +02:00
Miss Islington (bot)
9ed179b07d
bpo-47151: Fallback to fork when vfork fails in subprocess. (GH-32186)
bpo-47151: Fallback to fork when vfork fails in subprocess. An OS kernel can specifically decide to disallow vfork() in a process. No need for that to prevent us from launching subprocesses.
(cherry picked from commit 4a08c4c469)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2022-03-31 14:09:50 -07:00
Miss Islington (bot)
625f6704c0
bpo-14911: Corrected generator.throw() documentation (GH-32207)
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
(cherry picked from commit 8be7c2bc5a)

Co-authored-by: Dave Goncalves <davegoncalves@gmail.com>
2022-03-31 07:23:04 -07:00
Miss Islington (bot)
1f2ec4cef1
bpo-46775: OSError should call winerror_to_errno unconditionally on Windows (GH-32179)
(cherry picked from commit d0c67ea064)

Co-authored-by: Dong-hee Na <donghee.na@python.org>
2022-03-30 18:48:31 -07:00
Miss Islington (bot)
66cde7c51a
bpo-42340: Document issues around KeyboardInterrupt (GH-23255)
Update documentation to note that in some circumstances,
KeyboardInterrupt may cause code to enter an inconsistent state. Also
document sample workaround to avoid KeyboardInterrupt, if needed.
(cherry picked from commit d0906c90fc)

Co-authored-by: benfogle <benfogle@gmail.com>
2022-03-29 14:45:47 -07:00
Miss Islington (bot)
370900d7d8
Fix typo in the sqlite3 docs (GH-31915) (GH-32157)
Co-authored-by: Jonathan <89750679+AHypnotoad@users.noreply.github.com>
(cherry picked from commit 66584c890d)

Co-authored-by: Jonathan <jonathan.joyner94@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-03-28 21:21:27 -07:00
Miss Islington (bot)
11408ff47e
ctypes docs: Fix array-length reference to "non-negative" from "positive" (GH-32097) (GH-32142)
(cherry picked from commit 76f14b0463)

Co-authored-by: Yonatan Goldschmidt <yon.goldschmidt@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-03-28 19:47:57 -07:00
Jelle Zijlstra
604d003ab4
[3.10] bpo-28516: document contextlib.ExitStack.__enter__ behavior (GH-31636) (GH-32171)
The enter_context is updated with following information: 'The :meth:`__enter__` method
      returns the ExitStack instance, and performs no additional operations.'

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 86384cf83f)

Co-authored-by: vidhya <96202776+Vidhyavinu@users.noreply.github.com>
2022-03-28 19:39:55 -07:00
Steve Dower
0dfabf9b4a
bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161) 2022-03-29 00:46:18 +01:00
Miss Islington (bot)
2bcbc3113d
bpo-27929: resolve names only for AF_INET/AF_INET6 with asyncio (GH-32131)
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
(cherry picked from commit 5c30388f3c)

Co-authored-by: Vincent Bernat <vincent@bernat.ch>
2022-03-28 15:15:05 -07:00
Miss Islington (bot)
5944807b09
[3.10] bpo-44493: Add missing terminated NUL in sockaddr_un's length (GH-26866) (GH-32140)
Add missing terminated NUL in sockaddr_un's length

- Linux: https://man7.org/linux/man-pages/man7/unix.7.html
- *BSD: SUN_LEN
(cherry picked from commit f6b3a07b7d)


Co-authored-by: ty <zonyitoo@users.noreply.github.com>

Automerge-Triggered-By: GH:gpshead
2022-03-28 11:26:49 -07:00
Hugo van Kemenade
9194a7b899
bpo-47138: Fix documentation build by pinning Jinja version to 3.0.3 (GH-32154)
Co-authored-by: Maciej Olko <maciej.olko@gmail.com>
2022-03-28 13:06:16 -04:00
Pablo Galindo Salgado
27ee431834
[3.10] bpo-47117: Don't crash if we fail to decode characters when the tokenizer buffers are uninitialized (GH-32129) (GH-32130)
Automerge-Triggered-By: GH:pablogsal.
(cherry picked from commit 26cca8067b)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2022-03-26 18:26:05 +00:00
Miss Islington (bot)
48b3ae9e29
bpo-47105: Cite grp.h instead of pwd.h in grp docs (GH-32091) (GH-32120)
(cherry picked from commit ee912ad6f6)

Co-authored-by: Alex Hedges <aphedges@users.noreply.github.com>
2022-03-25 20:21:50 -04:00
Pablo Galindo
9006b4471c
Merge remote-tracking branch 'upstream/3.10' into 3.10 2022-03-24 10:30:54 +00:00
Pablo Galindo
4d37dc69bd
Post 3.10.4 2022-03-24 10:30:34 +00:00
Miss Islington (bot)
9e1bfd8ce7
bpo-47104: Rewrite asyncio.to_thread tests to use IsolatedAsyncioTestCase (GH-32086)
(cherry picked from commit ff619c7dfe)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
2022-03-23 14:43:32 -07:00
Christian Heimes
1b6acaad9a
[3.10] bpo-47101: list only activated algorithms in hashlib.algorithms_available (GH-32076) (GH-32085)
Co-authored-by: Christian Heimes <christian@python.org>
2022-03-23 22:15:25 +01:00
Pablo Galindo
9d38120e33
Python 3.10.4 2022-03-23 20:12:04 +00:00
Miss Islington (bot)
4298114e1d
Correctly document class instead of function (GH-32016)
(cherry picked from commit 624e3986fb)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
2022-03-23 09:17:53 -07:00
Miss Islington (bot)
832be8f1d4
[doc] configparser: avoid inline comments. (GH-31247)
People are testing those blocs with the default
inline_comment_prefixes of None, leading to a:

configparser.InterpolationSyntaxError: '$' must be followed by '$' or '{', found: '$ sign ($ is the only character that needs to be escaped)'
(cherry picked from commit 3ac4e783e0)

Co-authored-by: Julien Palard <julien@palard.fr>
2022-03-23 01:58:49 -07:00
Miss Islington (bot)
ca6acb8b31
Fix typo in Path.iterdir docs (GH-31822)
(cherry picked from commit 795b365e8a)

Co-authored-by: Matt Williams <matt@milliams.com>
2022-03-22 20:14:30 -07:00
Alex Waygood
d5ed8a8258
[3.10] bpo-46769: Improve documentation for typing.TypeVar (GH-31712) (GH-31941)
* [3.10] bpo-46769: Improve documentation for `typing.TypeVar` (GH-31712)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 81b425d4dc)

* Remove references to `reveal_type`, add new section on `self` types
2022-03-22 19:52:40 -07:00
Miss Islington (bot)
f163ad22d3
bpo-2604: Make doctest.DocTestCase reset globs in teardown (GH-31932)
Co-authored-by: Piet Delport
Co-authored-by: Hugo Lopes Tavares
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 7ba7eae508)

Co-authored-by: Daniël van Noord <13665637+DanielNoord@users.noreply.github.com>
2022-03-22 14:31:44 -07:00
Jeremy Kloth
8146e6b636
bpo-44336: Prevent tests hanging on child process handles on Windows (GH-26578)
Replace the child process `typeperf.exe` with a daemon thread that reads the performance counters directly.  This prevents the issues that arise from inherited handles in grandchild processes (see issue37531 for discussion).

We only use the load tracker when running tests in multiprocess mode. This prevents inadvertent interactions with tests expecting a single threaded environment.  Displaying load is really only helpful for buildbots running in multiprocess mode anyway.

Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>
2022-03-22 17:21:24 +00:00
Miss Islington (bot)
9d59381a5d
[3.10] bpo-45997: Fix asyncio.Semaphore re-acquiring order (GH-31910) (#32047)
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
(cherry picked from commit 32e77154dd)
Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
2022-03-22 17:15:24 +02:00
Miss Islington (bot)
c3538355f4
[3.10] bpo-47061: document module deprecations due to PEP 594 (GH-31984) (GH-32039)
Also removed asynchat, asyncore, and smtpd from their respective toctree entries so they are only  in the superceded subtree.
(cherry picked from commit 9ac2de922a)


Co-authored-by: Brett Cannon <brett@python.org>

Automerge-Triggered-By: GH:brettcannon
2022-03-21 17:30:21 -07:00
Irit Katriel
7fc12540e3
bpo-12029: [doc] clarify that except does not match virtual subclasses of the specified exception type (GH-32027) (GH-32034)
(cherry picked from commit 45833b50f0)
2022-03-21 21:22:39 +00:00
Miss Islington (bot)
1b21b55ee0
bpo-23691: Protect the re.finditer() iterator from re-entering (GH-32012)
(cherry picked from commit 08eb754d84)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-03-21 04:30:58 -07:00