Commit graph

10936 commits

Author SHA1 Message Date
Alex Waygood
2c8a0027e5
[3.10] bo-45655: Add "relevant PEPs" section to typing documentation (GH-29302)
The list of PEPs at the top of the documentation for the ``typing`` module has
become too long to be readable. This PR proposes presenting this
information in a more structured and readable way by adding a new "relevant
PEPs" section to the ``typing`` docs.

(cherry picked from commit 03db1bbfd2)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-29 18:03:48 +08:00
Miss Islington (bot)
fb80aede6a
bpo-45604: add level argument to multiprocessing.log_to_stderr func (GH-29226) (GH-29283)
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
(cherry picked from commit 1fb968c07a)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2021-10-28 21:58:24 +02:00
Miss Islington (bot)
1d88b2b0a1
bpo-45608: Document missing sqlite3 DB-API attributes and methods (GH-29219) (GH-29281)
(cherry picked from commit 88d8a1a340)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2021-10-28 21:57:14 +02:00
Miss Islington (bot)
99495b8aff
Fix typo in Counter documentation (GH-29223)
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
(cherry picked from commit 0a68b3603f)

Co-authored-by: Justinas Petuchovas <justinas.petuchovas@gmail.com>
2021-10-28 04:06:04 -07:00
Miss Islington (bot)
9b3cda5687
bpo-44344: Document that pow can return a complex number for non-complex inputs. (GH-27853) (GH-29135)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 887a55705b)

Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
2021-10-22 00:08:20 +02:00
Miss Islington (bot)
8fd7e8965d
bpo-41983: add availability info to socket docs (GH-27519) (GH-29136)
* add availability info to AF_PACKET section
* add availability for AF_QIPCRTR as well

(cherry picked from commit 51375388be)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
2021-10-22 00:07:07 +02:00
Ethan Furman
828722aca4
[3.10] bpo-44174: [Enum] add reference to name mangling (GH-29117) 2021-10-21 09:50:29 -07:00
Ethan Furman
2a9ab75af3
bpo-44559: [Enum] restore fixes lost in 3.9 reversion (GH-29114)
- fix exception leaks
- re-add deprecation warnings
2021-10-20 19:48:37 -07:00
Miss Islington (bot)
b2a989995e
bpo-45464: [doc] Explain that subclassing multiple exceptions is fragile (GH-29094) (GH-29104)
Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
(cherry picked from commit dff0b71343)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-20 20:50:09 +02:00
Miss Islington (bot)
0d0312e1ac
Add PEPs 593 & 647 to list of PEPs at top of typing docs (GH-29097)
(cherry picked from commit d9e1dae35a)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2021-10-20 08:36:34 -07:00
Miss Islington (bot)
092ec4b9d1
bpo-45449: add note about PEP 585 in collections.abc's documentation (GH-29047) (GH-29067)
Signed-off-by: Filipe Laíns <lains@riseup.net>

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 7bafa0cf58)
2021-10-19 20:41:33 +02:00
Miss Islington (bot)
8cef526a87
bpo-45515: Add zoneinfo to the datetime documentation (GH-29038) (GH-29065)
We should have done this way back when 3.9 was released, but it fell off
the radar.

Co-authored-by: Paul Ganssle <git@m.ganssle.io>
(cherry picked from commit 8e40ca127f)
2021-10-19 20:35:34 +02:00
Miss Islington (bot)
7082abf53d
Improve multiserver queue recipe (GH-29012) (GH-29013) 2021-10-17 18:43:10 -05:00
Miss Islington (bot)
035ad8cf98
Slight correct grammar (GH-28860)
(cherry picked from commit 1b11582f0e)

Co-authored-by: nobodyatandnothing <91722596+nobodyatandnothing@users.noreply.github.com>
2021-10-12 10:01:11 -07:00
Miss Islington (bot)
32866dd471
bpo-45441: Update some moved URLs in documentation (GH-28861)
(cherry picked from commit b37dc9b3bc)

Co-authored-by: 180909 <wjh180909@gmail.com>
2021-10-12 07:20:43 -07:00
Miss Islington (bot)
3d7009e88e
bpo-42253: Update xml.dom.minidom.rst (GH-23126) (GH-28874)
Document that the "standalone" parameter was added in Python 3.9.
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
(cherry picked from commit c7e81fcf95)

Co-authored-by: Jens Diemer <github.com@jensdiemer.de>
2021-10-12 10:17:53 +03:00
Miss Islington (bot)
bb4f885892
bpo-45351, asyncio: Enhance echo server example, print all addresses (GH-28828)
(cherry picked from commit 659812b451)

Co-authored-by: Olaf van der Spek <olafvdspek@gmail.com>
2021-10-11 12:34:47 -07:00
Miss Islington (bot)
aff69c34b0
Fix the "Finding all Adverbs" example (GH-21420) (#28839)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
(cherry picked from commit dbd62e74da)

Co-authored-by: Rim Chatti <chattiriim@gmail.com>
2021-10-10 14:43:38 -07:00
Miss Islington (bot)
459a4db5ea
bpo-45353: Remind sys.modules users to copy when iterating. (GH-28842)
This is true of all dictionaries in Python, but this one tends to
catch people off guard as they don't realize when sys.modules might
change out from underneath them as a hidden side effect of their
code.  Copying it first avoids the RuntimeError.  An example when
this happens in single threaded code are codecs being loaded which
are an implicit time of use import that most need not think about.
(cherry picked from commit 3d1ca867ed)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
2021-10-09 12:54:20 -07:00
Miss Islington (bot)
ce121fd875
[doc] Mention __slots__ behavior in weakref.rst (GH-21061) (GH-28772)
It took me longer than I expected to figure out why a random class
I dealt with didn't support weak references. I believe this addition
will make the __slots__/weakref interaction more discoverable to people
having troubles with this. (Before this patch __slots__ was not
mentioned in weakref documentation even once).

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit b24b47e643)

Co-authored-by: Jakub Stasiak <jakub@stasiak.at>
2021-10-06 20:52:22 +02:00
Christian Clauss
d15f47d179
[3.10] [doc] Fix typos found using codespell (GH-28744) (GH-28758) 2021-10-06 15:56:57 +02:00
Miss Islington (bot)
258c5fbbfd
sqlite3: Modernize documentation around unicode and bytes. (GH-28652) (GH-28694)
(cherry picked from commit 1dac95c814)

Co-authored-by: Julien Palard <julien@palard.fr>
2021-10-05 23:04:27 +02:00
Miss Islington (bot)
eb59e2fc11
[doc] Fix gethostbyname_ex description (GH-28700) (GH-28742)
It seems part of `gethostbyname_ex` doc was copied from `gethostbyaddr`. The latter has an `ip_address` parameter whereas the former doesn't.
(cherry picked from commit 4103280b83)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2021-10-05 19:21:25 +02:00
Miss Islington (bot)
72089f33c0
bpo-45346: Keep docs consistent regarding true and false values (GH-28697) (GH-28698) 2021-10-02 14:32:56 -05:00
Miss Islington (bot)
fc3511f18e
bpo-45125: Improves pickling docs and tests for shared_memory (GH-28294)
(cherry picked from commit 746d648d47)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2021-10-01 06:09:15 -07:00
Łukasz Langa
8f9d398b46
[3.10] [docs] Improve the markup of powers (GH-28598) (GH-28607)
(cherry picked from commit 4f05f15d7b)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-09-28 23:09:58 +02:00
Miss Islington (bot)
6d60449456
[doc] fix minor typo for argparse (GH-28451)
"A JSONDecodeError" instead of "An JSONDecodeError".
(cherry picked from commit db0133f98d)

Co-authored-by: Louis Sautier <sautier.louis@gmail.com>
2021-09-28 07:07:13 -07:00
Miss Islington (bot)
371ca3b54d
bpo-45277: Fix typo in codecs doc (GH-28555)
encoding => encode
(cherry picked from commit 4c0fc65cd8)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-09-24 19:16:48 -07:00
Miss Islington (bot)
809d298f60
[docs] Update documentation for multiprocessing.get_start_method (GH-18170) (GH-28533)
(cherry picked from commit af90b5498b)

Co-authored-by: Sam Sneddon <me@gsnedders.com>
2021-09-23 23:38:44 +02:00
Miss Islington (bot)
2df68270d9
Fix legacy logging module URL (GH-28528)
The URL listed in the `logging` docs for the original `logging` module leads to a 404. I managed to find the new location for the page and updated the URL.

Automerge-Triggered-By: GH:vsajip
(cherry picked from commit 8492b729ae)

Co-authored-by: Sean Leavey <SeanDS@users.noreply.github.com>
2021-09-23 08:07:40 -07:00
Miss Islington (bot)
1493e1a40d
bpo-41203: Replace Mac OS X and OS X with macOS (GH-28515) (GH-28523)
Replace old names when they refer to actual versions of macOS.
Keep historical names in references to older versions.

Co-authored-by: Patrick Reader <_@pxeger.com>
(cherry picked from commit 36122e1814)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-09-23 13:25:31 +03:00
Łukasz Langa
8c1e1da565
[3.10] [codemod] Fix non-matching bracket pairs (GH-28473) (GH-28511)
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 8f943ca257)

Co-authored-by: Mohamad Mansour <66031317+mohamadmansourX@users.noreply.github.com>
2021-09-22 01:33:59 +02:00
Łukasz Langa
0d41bf1570
[3.10] bpo-45246: Document that sorted() only uses "<" comparisons (GH-28494) (GH-28502)
(cherry picked from commit 9a0dcc5b2e)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-21 22:32:09 +02:00
Miss Islington (bot)
697b6650ed
Docs: Clarify the before_and_after() example (GH-28458) (#28464)
(cherry picked from commit fcbf9b176b)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-19 20:53:37 -05:00
Miss Islington (bot)
f17c979d90
bpo-30637: Improve the docs of ast.parse regarding differences with compile() (GH-28459)
(cherry picked from commit e6d05a4092)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2021-09-19 16:07:16 -07:00
Miss Islington (bot)
397dad4001
[doc] Clarify exception in multiprocessing.cpu_count (GH-23660) (GH-28433)
Previous wording didn't explain the slightly unintuitive behavior.

Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com>
(cherry picked from commit 24dbe30f8d)

Co-authored-by: Emmanuel Arias <eamanu@yaerobi.com>
2021-09-18 01:19:00 +02:00
Miss Islington (bot)
bba2332303
bpo-42038: fix description of returned list of lines (GH-27529) (GH-28428)
(cherry picked from commit aca0e08c5d)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
2021-09-18 00:55:57 +02:00
Miss Islington (bot)
c4be7ca087
[doc] Add a missing apostrophe in a code example in venv.rst (GH-28391) (GH-28425)
(cherry picked from commit d22a700091)

Co-authored-by: Arkaprabha Chakraborty <chakrabortyarkaprabha998@gmail.com>
2021-09-18 00:18:03 +02:00
Miss Islington (bot)
a10726d314
bpo-45217: adds note that allow_no_value in configparser is optional (GH-28396) (GH-28418)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit cb07838ab7)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
2021-09-17 15:10:28 +02:00
Miss Islington (bot)
ed28b92e92
Fix typo and add a module prefix (GH-28401)
(cherry picked from commit 80d9ff1648)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-16 22:12:37 -07:00
Miss Islington (bot)
87f0ac8c1d
bpo-45089: Improve sqlite3 trace callback docs (GH-28238) (GH-28371)
- Add link to str object and sqlite3 transaction control
- Mention that exceptions are not propagated
(cherry picked from commit 51056b40e7)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
2021-09-15 21:00:02 +02:00
Miss Islington (bot)
897e5aae74
bpo-9811: [doc] strftime handling of unsupported format specifiers is platform dependent (GH-28264) (GH-28277)
(cherry picked from commit e86bcfa580)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
2021-09-10 21:53:11 +02:00
Miss Islington (bot)
89edd18779
bpo-45024 and bpo-23864: Document how interface testing works with the collections ABCs (GH-28218) (GH-28266) 2021-09-09 22:58:47 -05:00
Miss Islington (bot)
c081866971
Fix small mistake in fileinput documentation (GH-28241)
(cherry picked from commit 5afb570d2e)

Co-authored-by: Jean-Abou-Samra <37271310+Jean-Abou-Samra@users.noreply.github.com>
2021-09-09 01:24:51 -07:00
Miss Islington (bot)
31be544721
bpo-24888: Clarify subprocess.check_call propagates exceptions if unable to start process (GH-28018)
(cherry picked from commit 19a304ba99)

Co-authored-by: DonnaDia <37962843+DonnaDia@users.noreply.github.com>
2021-09-07 11:44:16 -07:00
Miss Islington (bot)
be33e58699
Add more itertool recipes (GH-28165)
(cherry picked from commit 750368cbcd)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-07 10:52:26 -07:00
Miss Islington (bot)
d5feb2b1f1
More useful OrderedDict LRU recipes (GH-28164)
(cherry picked from commit c860d30fa0)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-05 10:57:32 -07:00
Miss Islington (bot)
656b0bdfaa
bpo-44571: Add itertool recipe for a variant of takewhile() (GH-28167)
(cherry picked from commit 91be41ad93)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-04 22:30:37 -07:00
Serhiy Storchaka
e2b2930413
[3.10] bpo-45060: Get rid of few uses of the equality operators with None (GH-28087). (GH-28092)
(cherry picked from commit 3c65457156)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-09-03 21:13:00 -04:00
Dong-hee Na
2a8956c268
bpo-42255: Update webbrowser doc for macOS (GH-28144) 2021-09-03 19:22:22 +02:00