Commit graph

24411 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)
855d6247ad
[3.10]bpo-45463: Clarify that global statements allows multiple names (GH-28851) (GH-28989)
The global statement allows specifying a list of identifiers
(https://docs.python.org/3/reference/simple_stmts.htmlGH-the-global-statement).

The "Execution model" chapter described the global statement as if it
only allowed one single name. Pluralize "name" in the appropriate places.
(cherry picked from commit 4ecd119b00)

Co-authored-by: Luca Chiodini <luca@chiodini.org>

Co-authored-by: Luca Chiodini <luca@chiodini.org>
2021-10-16 10:01:54 -04:00
Serhiy Storchaka
4641afef66
[3.10] bpo-45467: Fix IncrementalDecoder and StreamReader in the "raw-unicode-escape" codec (GH-28944) (GH-28952)
They support now splitting escape sequences between input chunks.

Add the third parameter "final" in codecs.raw_unicode_escape_decode().
It is True by default to match the former behavior.
(cherry picked from commit 39aa98346d)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-10-14 21:23:39 +03:00
Miss Islington (bot)
0bff4ccbfd
[3.10] bpo-45461: Fix IncrementalDecoder and StreamReader in the "unicode-escape" codec (GH-28939) (GH-28943)
They support now splitting escape sequences between input chunks.

Add the third parameter "final" in codecs.unicode_escape_decode().
It is True by default to match the former behavior.
(cherry picked from commit c96d1546b1)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-10-14 20:02:20 +03:00
Miss Islington (bot)
5abb2dec2c
[docs] lexical_analysis: Expand the text on `_` (GH-28903) (GH-28933)
Also:
* Expand the discussion into its own entry. (Even before this,
  text on ``_`` was longet than the text on ``_*``.)

* Briefly note the other common convention for `_`: naming unused
  variables.

Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 3dee0cb621)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
2021-10-13 18:58:06 +02:00
Miss Islington (bot)
47673c47db
bpo-20692: Add Programming FAQ entry for 1.__class__ error. (GH-28918)
To avoid error, add either space or parentheses.
(cherry picked from commit 380c440875)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-10-12 22:37:51 -07: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)
3c27013077
Fix class pattern docs to refer to class patterns (GH-28849)
(cherry picked from commit 0bcc5ade9b)

Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>
2021-10-10 07:35:23 -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)
e086bfee03
Fix dataclassses spelling (GH-28837) (GH-28841)
(cherry picked from commit 5b4a7675bc)

Co-authored-by: Landon Yarrington <33426811+jly36963@users.noreply.github.com>

Co-authored-by: Landon Yarrington <33426811+jly36963@users.noreply.github.com>
2021-10-09 15:50:45 -04:00
Miss Islington (bot)
86bf45e69e
[3.10] Remove draft notice on the 3.10 What's new document (GH-28806) (GH-28807)
Automerge-Triggered-By: GH:pablogsal
(cherry picked from commit 32485cecab)


Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2021-10-07 11:25:26 -07:00
Miss Islington (bot)
ee92205bb2
[3.10] Fix typo in whatsnew 3.10.rst (GH-26854) (GH-28782)
Thanks for the fix @wiggin15 .
(cherry picked from commit 599c07006a)


Co-authored-by: Arnon Yaari <wiggin15@yahoo.com>

Automerge-Triggered-By: GH:JulienPalard
2021-10-07 02:26:12 -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
Miss Islington (bot)
dcdeb96495
bpo-34804: [doc] Rephrase section on side effects in functional.rst for clarity (GH-27989) (GH-28762)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 7af95a1e80)

Co-authored-by: DonnaDia <37962843+DonnaDia@users.noreply.github.com>
2021-10-06 17:15:42 +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)
e040adc806
bpo-45341: Replace 'Packaging' with 'Package' in "Python P... Index" (GH-28687)
pypi.org "  The Python Package Index (PyPI) ...
(cherry picked from commit 0be338199f)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-10-01 23:27:23 -07: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
Miss Islington (bot)
02fdd73a19
bpo-45291: Explicitly set --libdir=lib when configure OpenSSL (GH-28566) (GH-28616)
(cherry picked from commit bc4cde4033)

Co-authored-by: zhanpon <pon.zhan@gmail.com>
2021-09-29 13:41:27 +02: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
Łukasz Langa
c523022ba8
[3.10] bpo-43914: What's New 3.10: add new SyntaxError attributes (GH-28558) (GH-28562)
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
(cherry picked from commit 71f8ff45c6)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-09-25 11:32:26 +02: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)
87f97fe5e6
bpo-38623: Add note about site module (site-packages) (GH-16974) (GH-28536)
(cherry picked from commit 55b45bf707)

Co-authored-by: Peter Bittner <django@bittner.it>
2021-09-24 00:48:06 +02: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)
55576893b3
bpo-43760: Document PyThreadState.use_tracing removal (GH-28527) (GH-28529)
(cherry picked from commit f4ccb79d52)

Co-authored-by: Victor Stinner <vstinner@python.org>
2021-09-23 22:40:15 +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)
7ab114bf1f
bpo-45198: __set_name__ documentation not clear about its usage with non-descriptor classes (GH-28439)
(cherry picked from commit 94b462686b)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2021-09-18 00:10:00 -07:00
Miss Islington (bot)
5683902e06
[3.10] Fix minor typo in Doc/c-api/type.rst (GH-28432) (GH-28440)
retreived-> retrieved
(cherry picked from commit af08f1ba40)


Co-authored-by: Konstantin Popov <konst.hardy@gmail.com>

Automerge-Triggered-By: GH:Fidget-Spinner
2021-09-17 19:11:51 -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)
e2856859f6
docs: correct references to __isub__ etc (GH-28297)
(cherry picked from commit 800bd01b6d)

Co-authored-by: David Hewitt <1939362+davidhewitt@users.noreply.github.com>
2021-09-16 03:10:10 -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)
dda5ff2d09
bpo-4356: Mention the new key arguments for the bisect module APIs in the 3.10 What's new (GH-28339) (GH-28340)
(cherry picked from commit 1aaa859497)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2021-09-14 21:02:18 +01: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