Commit graph

10925 commits

Author SHA1 Message Date
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
Miss Islington (bot)
7aa58f5425
[doc] Reword sentinel object summary in dataclasses (GH-27792)
This sentinel value (`MISSING`) is also used as default value for the `kw_only` parameter introduced in Python 3.10. It's cleaner to simply omit the usage here.

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

Co-authored-by: Ville Korhonen <ville@xd.fi>
2021-09-02 09:37:55 -07:00
Łukasz Langa
2184bc7fe1
[3.10] [doc] Link to deprecation policy PEP from the DeprecationWarning documentation (GH-28123) (#28126)
(cherry picked from commit a7ef15aae8)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-09-02 18:18:47 +02:00
Miss Islington (bot)
559af74346
bpo-40360: [doc] Rephrase deprecation note about lib2to3 (GH-28122)
(cherry picked from commit f0b63d5b56)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-09-02 08:37:14 -07:00
Miss Islington (bot)
8711b3d0ac
bpo-44135: [docs] Fix inline markup (GH-28095)
(cherry picked from commit 9a7ec2fcde)

Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2021-08-31 09:25:08 -07:00
Miss Islington (bot)
ab8fed88fc
bpo-44135: Refine explanation of how passing tuples to issubclass() behaves (GH-26193)
Co-authored-by: Zachary Kneupper <zachary.kneupper@gmail.com>
(cherry picked from commit 08767c73b5)

Co-authored-by: Zack Kneupper <zachary.kneupper@gmail.com>
2021-08-31 07:23:22 -07:00
Miss Islington (bot)
1d0c559614
bpo-44925: [docs] Fix confusing deprecation notice for typing.IO (GH-28004)
(cherry picked from commit edae42f99f)

Co-authored-by: DonnaDia <37962843+DonnaDia@users.noreply.github.com>
2021-08-31 03:07:49 -07:00
Miss Islington (bot)
270678564c
bpo-44394: Update libexpat copy to 2.4.1 (GH-26945)
Update the vendored copy of libexpat to 2.4.1 (from 2.2.8) to get the
fix for the CVE-2013-0340 "Billion Laughs" vulnerability. This copy
is most used on Windows and macOS.

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

Co-authored-by: Victor Stinner <vstinner@python.org>
2021-08-29 07:32:50 -07:00
Miss Islington (bot)
719af92e10
bpo-40635: Fix getfqdn() docstring and docs (GH-27971)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit fdcb675eed)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>
2021-08-26 12:54:52 -07:00
Miss Islington (bot)
ec5a03168f
bpo-39452: Rewrite and expand __main__.rst (GH-26883)
Broadened scope of the document to explicitly discuss and differentiate between ``__main__.py`` in packages versus the ``__name__ == '__main__'`` expression (and the idioms that surround it), as well as ``import __main__``.

Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 7cba23164c)

Co-authored-by: Jack DeVries <58614260+jdevries3133@users.noreply.github.com>
2021-08-24 13:54:08 -07:00
Miss Islington (bot)
4673dc26f8
Update susp-ignored.csv line numbers 2021-08-23 15:52:02 -07:00
Miss Islington (bot)
e479510302
bpo-42560: simplify/merge architecture info in Tkinter docs (GH-27839)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: E-Paine <63801254+E-Paine@users.noreply.github.com>
(cherry picked from commit e41912c634)

Co-authored-by: Mark Roseman <mark@markroseman.com>
2021-08-23 13:08:19 -07:00