5a81a24c8b
gh-103582: Remove last references to `argparse.REMAINDER` from docs (GH-103586)
...
(cherry picked from commit f4d087964e
2023-04-18 22:14:53 -07:00
804a973d8e
gh-103365: [Enum] STRICT boundary corrections (GH-103494)
...
STRICT boundary:
- fix bitwise operations
- make default for Flag
(cherry picked from commit 2194071540
2023-04-13 08:55:53 -07:00
e643412ef4
gh-103417: use time.monotonic in the example for sched.scheduler (GH-103418)
...
(cherry picked from commit f2b7ecb778
2023-04-12 02:09:08 -07:00
b5fe28dace
gh-103237: Polish pdb docs (GH-103238)
...
(cherry picked from commit 449bf2a76b
2023-04-11 23:26:33 -07:00
e715da6db1
gh-87864: Use correct function definition syntax in the docs (GH-103312)
...
(cherry picked from commit 50b4b15984
2023-04-11 07:19:33 -07:00
07a2851edb
gh-103373: `__mro_entries__` docs: improve cross references (GH-103398)
...
(cherry picked from commit e071f00aae
2023-04-11 03:34:46 -07:00
4a05392adb
Doc: Avoid error lexing multiprocessing docs code block on Pygments 2.15.0 (GH-103421)
...
(cherry picked from commit 75b6ab80da
2023-04-10 21:07:21 -07:00
b80e4c89d8
[3.11] gh-103059: Clarify gc.freeze documentation (GH-103058) ( #103416 )
...
gh-103059: Clarify gc.freeze documentation (GH-103058)
(cherry picked from commit 8b1b17134e
2023-04-10 11:17:48 -06:00
7b03d0f7c5
gh-100574: add examples/links to the `strptime`/`strftime` docs (GH-100575)
...
(cherry picked from commit 3310b94d3d
2023-04-08 01:56:31 -07:00
bbe04d9d1c
gh-103266: Fix a typo in example code for bisect() function (GH-103267)
...
(cherry picked from commit f0424ba4b6
2023-04-06 17:45:07 -07:00
09fb27fa51
gh-102899: Fix doc link for getting filesystem error handler (GH-102901)
...
(cherry picked from commit fdd0fff277
2023-04-05 08:03:47 -07:00
9357fc9b89
gh-81762: Clarify and simplify description of print's flush param (GH-103264)
...
(cherry picked from commit c396b6ddf3
2023-04-05 04:49:08 -07:00
6258c3cd53
Improve some grammar in the socket docs (GH-103254)
...
(cherry picked from commit bceb9e00ad
2023-04-04 15:54:37 -07:00
cf72cc25f6
gh-98298, gh-74730: [Enum] update docs (GH-103163)
...
fix FlagBoundary statements
add warning about reloading modules and enum identity
(cherry picked from commit 5ffc1e5a21
2023-04-03 15:27:33 -07:00
823622212e
gh-102994: Profile docs has typo in example (GH-103074)
...
(cherry picked from commit 55decb72c4
2023-04-02 15:52:11 -07:00
0854bdf15f
gh-103109: Document ignore_warnings() test support helper (GH-103110)
...
(cherry picked from commit 32937d6aa4
2023-04-02 15:42:43 -07:00
4664a7cf68
Quote literal tokens in standard format specifier grammar (GH-102902)
...
Reported by Damian Dureck: https://mail.python.org/archives/list/docs@python.org/thread/UZTWBJIXC3MBKTHXVTIBPGDPKBNWZ5LN/
(cherry picked from commit f6405a4662
2023-03-31 05:52:52 -07:00
41e3ea1396
Minor docs improvements fix for `codeop` (GH-103123)
...
(cherry picked from commit c1e71ce56f
2023-03-30 15:58:54 -07:00
1b40618247
gh-103099: Link mypy docs from typing.rst (GH-103100)
...
(cherry picked from commit fda95aa194
2023-03-30 01:39:49 -07:00
e1094c6e6a
Update pdb docs for arguments (GH-102965)
...
(cherry picked from commit 027223db96
2023-03-25 14:42:28 -07:00
aae91fa63c
[3.11] gh-103025: fix a ctypes doc typo (GH-103026) ( #103029 )
...
* gh-103025: fix two ctypes doc issues (GH-103026)
(cherry picked from commit 0708437ad0
2023-03-25 10:00:44 +00:00
85c686a1a5
[3.11] gh-101100: Document PyObject_ClearWeakRefs, gzip's name, and asyncio.iscoroutine ( #103001 )
2023-03-25 09:43:52 +02:00
c834a4c713
gh-102873: logging.LogRecord docs: improve description of `msg` parameter (GH-102875)
...
(cherry picked from commit f2e5a6ee62
2023-03-24 08:08:48 -07:00
e075631f67
[3.11] gh-96931: Fix incorrect results in ssl.SSLSocket.shared_ciphers (GH-96932) ( #102918 )
...
gh-96931: Fix incorrect results in ssl.SSLSocket.shared_ciphers (GH-96932)
(cherry picked from commit af9c34f6ef
2023-03-24 13:33:24 +01:00
60b2b58f87
[3.11] Minor readability improvement to the factor() recipe (GH-102971) (GH-102972)
2023-03-23 14:56:35 -05:00
202e16ea05
gh-98239: Document that `inspect.getsource()` can raise `TypeError` (GH-101689)
...
(cherry picked from commit b6132085ca
2023-03-23 12:42:54 -07:00
e2924c0ee5
gh-102936: typing: document performance pitfalls of protocols decorated with `@runtime_checkable` (GH-102937)
...
(cherry picked from commit 58d2b30c01
2023-03-23 11:27:28 -07:00
84ae50c914
gh-102810 Improve the sphinx docs for `asyncio.Timeout` (GH-102934)
...
(cherry picked from commit f13fdacadf
2023-03-23 09:52:43 -07:00
a9ece4a839
gh-102780: Fix uncancel() call in asyncio timeouts (GH-102815)
...
Also use `raise TimeOut from <CancelledError instance>` so that the CancelledError is set
in the `__cause__` field rather than in the `__context__` field.
(cherry picked from commit 04adf2df39
2023-03-22 11:23:47 -07:00
f1b96737a4
gh-102921: [doc] Clarify `exc` argument name in `BaseExceptionGroup` is plural (GH-102922)
...
(cherry picked from commit 9b19d3936d
2023-03-22 11:21:59 -07:00
592c34469b
Docs: improve accuracy of sqlite3.Connection.interrupt() (GH-102904)
...
(cherry picked from commit 7b2d53dacc
2023-03-22 05:00:25 -07:00
9a1453b651
Docs: improve the accuracy of the sqlite3.connect() timeout param (GH-102900)
...
(cherry picked from commit c24f1f1e87
2023-03-22 04:49:46 -07:00
44782d3d34
Docs: improve accuracy of pdb alias example (GH-102892)
...
(cherry picked from commit e0c63b7267
2023-03-22 04:44:21 -07:00
1eb9b24929
Add link to `sys.exit` function documentation (GH-102805)
...
* Add link to `sys.exit` function documentation
* Update Doc/library/os.rst
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* Update Doc/library/os.rst
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
---------
(cherry picked from commit 41ef502d74
2023-03-21 15:06:10 -07:00
e6e3b1b27d
[3.11] Backport itertool recipe updates (GH-102881)
2023-03-21 13:44:32 -05:00
df399a35d5
[3.11] Fix outdated note about 'int' rounding or truncating (GH-102736) ( #102766 )
...
Fix outdated note about 'int' rounding or truncating (GH-102736)
(cherry picked from commit 405739f916
2023-03-16 20:42:54 +00:00
4a7faac557
GH-102653: Make recipe docstring show the correct distribution (GH-102742)
...
(cherry picked from commit b0ec6253c9
2023-03-16 07:42:23 -07:00
3ddf397217
gh-101100: Documenting --prefix and --exec-prefix. (GH-102695)
...
(cherry picked from commit 61b9ff35cb
2023-03-15 15:13:48 -07:00
6b6c2f53ec
[3.11] Remove misformatted exclamation marks in docs (GH-102694) ( #102716 )
...
Remove the exclamation mark from :program:`!foo` in .rst files because
it inadvertently shows up in the rendered HTML.
(Sphinx's cross-referencing roles use a '!' prefix to suppress
hyperlinking[1], but :program: is not a cross-referencing role so the
'!' is displayed verbatim.)
The exclamation marks in venv.rst were introduced in #98350 . See
comments [2] and [3] for additional discussion.
[1]: https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-syntax
[2]: https://github.com/python/cpython/pull/98350#issuecomment-1285965759
[3]: https://github.com/python/cpython/pull/98350#issuecomment-1286394047
Reported-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Co-authored-by: Tom Levy <tomlevy93@gmail.com>
2023-03-15 09:25:55 +02:00
738dde303b
[3.11] gh-102354: change python3 to python in docs examples (GH-102696) ( #102697 )
...
gh-102354: change python3 to python in docs examples (GH-102696)
(cherry picked from commit 80abd62647
2023-03-14 12:52:33 -06:00
0f46d42eb9
doc: Remove a duplicate 'versionchanged' in library/asyncio-task (gh-102677)
...
(cherry picked from commit 7bdb331b67
2023-03-13 19:26:11 -07:00
43f8082b1c
gh-102627: Replace address pointing toward malicious web page (GH-102630)
...
* Replace known bad address pointing toward a malicious web page.
(cherry picked from commit 61479d4684
2023-03-13 15:43:16 -07:00
a4fcd06c50
[3.11] Fix duplicated words in the docs ( #102644 )
...
(cherry-picked from commit f6ca71a422
2023-03-13 14:31:50 +00:00
c39a1d0ba9
gh-101100: Fix Sphinx warnings in `turtle` module (GH-102340)
...
(cherry picked from commit 78e4e6c3d7
2023-03-13 04:33:38 -07:00
6829b1256a
[3.11] Fixes duplicated word (GH-102623) ( #102624 )
...
Fixes duplicated word (GH-102623)
In line 1627, the end of the sentence reads "only that that it may be." but it should read "only that it may be" (or alternatively "only that that may be").
(cherry picked from commit e6210621be
2023-03-12 10:00:04 -07:00
495cd2de77
gh-86509: Add link to Lib/_threading_local.py in threading docs (GH-101824)
...
(cherry picked from commit 53dceb53ad
2023-03-10 04:30:24 -08:00
ffb41eaaf4
gh-101100: Fix sphinx warnings in `zipapp` and `zipfile` modules (GH-102526)
...
(cherry picked from commit 1f557f94c2
2023-03-08 00:30:44 -08:00
8bf8e3d9a0
Fix style in argparse.rst (GH-101733)
...
(cherry picked from commit 061325e0d2
2023-03-07 23:33:52 -08:00
caff048cb3
[3.11] Move around example in to_bytes() to avoid confusion (GH-101595) ( #102434 )
...
Move around example in to_bytes() to avoid confusion (GH-101595)
Moves an example to be closer to the sentence that refers to it.
(cherry picked from commit 5da379ca7d
2023-03-05 09:42:36 +00:00
cda1d52ab8
[3.11] Clarify re docs for byte pattern group names (GH-99308) ( #101001 )
...
Fix wording of the deprecation notice in re for 3.11
2023-03-04 13:36:42 -08:00
32a738e5b3
gh-101754: Document that Windows converts keys in `os.environ` to uppercase (GH-101840)
...
(cherry picked from commit 4e7c0cbf59
2023-03-03 03:00:06 -08:00
3b1201daf6
[3.11] Fix typos in documentation and comments (GH-102374) ( #102376 )
...
[3.11] Fix typos in documentation and comments (GH-102374)
Found some duplicate `to`s in the documentation and some code comments and fixed them.
[Misc/NEWS.d/3.12.0a1.rst](ed55c69ebd/Misc/NEWS.d/3.12.0a1.rst
2023-03-02 16:00:06 +00:00
9a5f2e8562
[3.11] gh-90744: Fix erroneous doc links in the sys module (GH-101319) ( #102321 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Brad Wolfe <brad.wolfe@gmail.com>
Co-authored-by: Furkan Onder <furkanonder@protonmail.com>
Fix erroneous doc links in the sys module (#101319 )
2023-03-02 07:43:44 +02:00
3effccee48
[3.11] gh-102088 Optimize iter_index itertools recipe (GH-102360) (GH-102363)
2023-03-01 21:52:37 -06:00
1ef6e45f96
gh-102296 Document that inspect.Parameter kinds support ordering (GH-102297)
...
(cherry picked from commit 0db6f44259
2023-02-27 07:21:27 -08:00
bd4a709038
gh-101100: Fix sphinx warnings in `types` module (GH-102274)
...
(cherry picked from commit 101a12c576
2023-02-26 23:33:05 -08:00
626f471d88
[3.11] gh-85417: Clarify behaviour on branch cuts in cmath module (GH-102046) ( #102276 )
...
gh-85417: Clarify behaviour on branch cuts in cmath module (GH-102046)
This PR updates the cmath module documentation to reflect the reality that Python is almost always (and as far as I can tell, that "almost" can be omitted) running on a machine whose C double supports signed zeros.
* Removes misleading references to functions being continuous from above / below / the left / the right at branch cuts
* Expands the note on branch cuts at the top of the module documentation to explain the double-sided sign-of-zero-based behaviour
(cherry picked from commit b513c46d99
2023-02-26 11:55:25 +00:00
7a0dc8a802
gh-102259: Fix re doc issue regarding right square brackets (GH-102264)
...
(cherry picked from commit bcadcde712
2023-02-25 18:32:42 -08:00
735ff5ae27
[3.11] GH-99818: improve the documentation for zipfile.Path and Traversable (GH-101589) ( #102266 )
...
Automerge-Triggered-By: GH:FFY00
(cherry picked from commit 84181c1404
2023-02-25 23:42:30 +00:00
c2f42f1778
gh-101100: Fix sphinx warnings in `typing` module docs (GH-102260)
...
(cherry picked from commit a498de4c0e
2023-02-25 13:55:49 -08:00
5775863e9d
asyncio docs: Fix dangling hyphen (GH-102227)
...
Currently this gets rendered with a dangling hyphen.
(cherry picked from commit 207e1c5cae
2023-02-25 05:29:35 -08:00
a109ce00de
gh-101100: Fix Sphinx warnings in `decimal` module (GH-102125)
...
(cherry picked from commit b7c1126447
2023-02-25 01:58:52 -08:00
3b4f8fc83d
gh-102105 Fix wording in filterfalse/quantify/filter (GH-102189)
...
(cherry picked from commit 81bf10e4f2
2023-02-24 08:21:40 -08:00
42d0ca92ed
[3.11] gh-100226: Clarify StreamReader.read behavior (GH-101807) ( #102001 )
...
gh-100226: Clarify StreamReader.read behavior (GH-101807)
(cherry picked from commit 77d95c8373
2023-02-23 19:05:59 +05:30
bf0a8362cd
Fix syntax error in struct doc example (GH-102160)
...
Missing closing ) reported on Discuss by Chukwudi Nwachukwu.
(cherry picked from commit 8f647477f0
2023-02-22 16:02:31 -08:00
8b5498e367
GH-101777: `queue.rst`: use 2 spaces after a period to be consistent. (GH-102143)
...
(cherry picked from commit 96bf24380e
2023-02-22 13:39:05 -08:00
528e91c067
[3.11] gh-102135: Update turtle docs to rename wikipedia demo to rosette (GH-102137) (GH-102138)
...
(cherry picked from commit 8d46c7ed5e
2023-02-22 02:25:17 -08:00
78eee76185
gh-102011: use sys.exception() instead of sys.exc_info() in docs where possible (GH-102012)
...
(cherry picked from commit 4d3bc89a3f
2023-02-21 03:06:20 -08:00
a94f3ad10b
gh-100556: Improve clarity of `or` docs (GH-100589)
...
(cherry picked from commit b40dd71241
2023-02-21 02:45:49 -08:00
f94ffcf618
gh-101777: Make `PriorityQueue` docs slightly clearer (GH-102026)
...
Adjust wording slightly, and use min(entries) instead of
sorted(list(entries))[0] as an example.
(cherry picked from commit 350ba7c07f
2023-02-21 02:32:58 -08:00
4969903f7e
gh-99735: Use required=True in argparse subparsers example (GH-100927)
...
(cherry picked from commit 6aab56f3c2
2023-02-19 11:11:40 -08:00
62db23c944
Fix incorrectly documented attribute in csv docs (GH-101250)
...
(cherry picked from commit 36b670908b
2023-02-18 17:04:01 -08:00
5220c2df9e
[3.11] gh-85747: Active voice & suggested edits, 'running/stopping loop' & 'callbacks' subsections of asyncio-eventloop.rst (GH-100270) ( #102006 )
...
Note: the `timeout` parameter was not added until 3.12.
(cherry picked from commit c4de6b1d52
2023-02-18 15:57:06 -08:00
b7a49eb5ff
gh-101739: [Enum] update docs - default boundary for Flag is CONFORM (GH-101746)
...
(cherry picked from commit 7f1c721756
2023-02-17 13:44:45 -08:00
be69ac3c96
gh-101992: update plistlib examples to be runnable (GH-101994)
...
* gh-101992: update plistlib examples to be runnable
* Update Doc/library/plistlib.rst
---------
(cherry picked from commit a1723caabf
2023-02-17 11:39:14 -08:00
aedf38391a
gh-93573: Replace wrong example domains in configparser doc (GH-93574)
...
* Replace bitbucket.org domain by forge.example
* Update example to python.org
* Use explicitly invalid domain
topsecret.server.com domain is not controled by PSF. It's replaced by invalid topsecret.server.example domain. It follows RFC 2606, which advise .example as TLD for documentation.
(cherry picked from commit 924a3bfa28
2023-02-16 07:25:31 -08:00
4aeae28671
GH-101898: Fix missing term references for hashable definition (GH-101899)
...
Fix missing term references for hashable definition
(cherry picked from commit 3690688149
2023-02-14 02:45:42 -08:00
01b21c320b
Correct trivial grammar in reset_mock docs (GH-101861)
...
(cherry picked from commit a1f08f5f19
2023-02-13 01:20:18 -08:00
91fb7c36a3
[3.11] gh-101390: Fix docs for `imporlib.util.LazyLoader.factory` to properly call it a class method (GH-101391) (#GH-101813)
...
gh-101390: Fix docs for `imporlib.util.LazyLoader.factory` to properly call it a class method (GH-101391)
(cherry picked from commit 17143e2c30
2023-02-10 16:24:28 -08:00
c485f0e39e
[3.11] Docs: Fix getstatus() -> getcode() typos (GH-101296) ( #101805 )
2023-02-11 00:26:41 +02:00
18313ecb09
Docs: use parameter list for sqlite3.Cursor.execute* (GH-101782)
...
(cherry picked from commit 2037ebf81b
2023-02-10 10:01:38 -08:00
4a9dff0e5a
gh-101283: Version was just released, so should be changed in 3.11.3 (GH-101719)
...
(cherry picked from commit 0e0c5d8baa
2023-02-08 16:11:36 -08:00
51b079a2d6
Update Lib/subprocess.py
2023-02-08 15:44:06 -08:00
7240ba7f94
[3.11] gh-47937: Note that Popen attributes are read-only (GH-93070) ( #101684 )
...
* Note that Popen attributes aren't meant to be set by users by rewording the text about the attributes.
* Also update some universal_newlines references to mention the modern text parameter name while in the area.
(cherry picked from commit 027adf42cd
2023-02-08 11:03:56 +01:00
fa90671480
[3.11] gh-97725: Fix documentation for the default file of `asyncio.Task.print_stack` ( #101652 ) ( #101653 )
...
(cherry picked from commit f87f6e2396
2023-02-08 11:02:37 +01:00
7cbcfbe2ff
GH-56426: Add cross-reference to the documentation for faulthandler, traceback, and pdb. (GH-101157)
...
(cherry picked from commit cef9de62b8
2023-02-03 19:56:57 -08:00
2366c1a4fe
gh-100920: Update documentation for `asyncio.StreamWriter.wait_closed` (GH-101514)
...
(cherry picked from commit 5c39daf50b
2023-02-02 23:26:37 -08:00
bfac5d9850
gh-100925: Move array methods under class in array doc (GH-101485)
...
* Move array methods under class in array doc
* Fix a few internal references related to the touched lines
(cherry picked from commit 1b6045668d
2023-02-02 16:12:09 -08:00
08f5c77359
docs: Fix enum reassign `str` documentation (GH-101507)
...
(cherry picked from commit 24cbc7a2a0
2023-02-02 12:40:30 -08:00
c2c970fc26
Docs: improve accuracy of sqlite3 `check_same_thread` parameter (GH-101351)
...
(cherry picked from commit ee21110086
2023-02-01 16:00:27 -08:00
89442e18e1
gh-101498 : Fix asyncio.Timeout example in docs (GH-101499)
...
Doc/library/asyncio-task.rstGH-timeout
(cherry picked from commit 95fb0e0258
2023-02-01 10:19:11 -08:00
c796d34b2a
[3.11] gh-101454: fix documentation for END_ASYNC_FOR ( #101455 ) ( #101493 )
...
gh-101454: fix documentation for END_ASYNC_FOR (#101455 )
(cherry picked from commit 62251c3da0
2023-02-01 14:30:48 +00:00
85cc5d0e5d
gh-98657: [docs] `array.typecodes` is a module-level attribute (GH-98729)
...
* gh-98657: [docs] `array.typecodes` is a module-level attribute
* Update array.rst
(cherry picked from commit c144e57b31
2023-01-31 21:48:19 -08:00
a79dd88973
gh-77607: Improve accuracy of os.path.join docs (GH-101406)
...
This is a follow-up to GH-100811.
One of the changes in that PR isn't accurate in that
`os.path.join('', '')` will not end in a separator.
This reverts that change to the previous wording that used "only", but
explicitly calls out the case where the last part ends in a separator,
which is what caused confusin in GH-77607 and motivated the change
in GH-100811.
(cherry picked from commit 909a674693
2023-01-30 21:46:48 -08:00
6a94f4c973
Fixes typo in asyncio.TaskGroup context manager code example (GH-101449)
...
(cherry picked from commit ef09bf63d2
2023-01-30 21:46:35 -08:00
6ec9f2d5b8
gh-101422: (docs) TarFile default errorlevel argument is 1, not 0 (GH-101424)
...
(cherry picked from commit ea232716d3
2023-01-30 10:10:26 -08:00
3bcb630e07
gh-98240: Updated Path.rename docs, when it is atomic (GH-98245)
...
(cherry picked from commit 0023f51deb
2023-01-29 17:52:29 -08:00
88a1e6db0f
[3.11] [doc] Add a section on logging handler configuration order. (GH-101380) (GH-101382)
...
Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2023-01-27 19:12:18 +00:00
1016909a6d
[3.11] [doc] Add some notices to logging configuration documentation. (GH-101373) (GH-101376)
...
Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2023-01-27 17:45:59 +00:00
4cf4169350
Added asyncio REPL example to docs. (GH-101243)
...
(cherry picked from commit 5d868efde9
2023-01-23 03:39:01 -08:00
69d12d868e
[3.11] GH-101097: Switch from standard interval notation to greater or less than signs for random.random()'s documentation (GH-101119) (GH-101246)
...
(cherry picked from commit 8bcd4a6ec7
2023-01-22 13:45:55 -08:00
db0eeb381e
[3.11] gh-86610: Use attribute directive in docs for pathlib.PurePath (GH-101114) ( #101205 )
...
(cherry picked from commit 01093b8203
2023-01-20 23:28:21 +01:00
efc89f3454
[3.11] GH-101111: Disambigaute origin of const for store_const and append_const (GH-101121) ( #101203 )
...
(cherry picked from commit 9a155138c5
2023-01-20 23:22:04 +01:00
1798df2b40
[3.11] Fix minor typos in SSL documentation (GH-101158) ( #101201 )
...
(cherry picked from commit 73497690b5
2023-01-20 23:18:25 +01:00
0dc35e4bbb
gh-91485: Avoid unnecessary use of non-Python syntax in io docs (GH-101177)
...
(cherry picked from commit 783d1bc51b
2023-01-20 14:12:26 -08:00
e039d53dae
[3.11] gh-101100: [Enum] Fix sphinx warnings in docs (GH-101122) ( #101173 )
...
(cherry picked from commit 9e025d305f
2023-01-20 23:07:23 +01:00
efe3a389ca
[3.11] gh-101144: Allow zipfile.Path .open & .read_text encoding to be positional ( #101179 )
...
The zipfile.Path open() and read_text() encoding parameter can be supplied as a positional argument without causing a TypeError again. 3.10.0b1 included a regression that made it keyword only.
Documentation update included as users writing code to be compatible with a wide range of versions will need to consider this for some time..
(cherry picked from commit 5927013e47
2023-01-20 00:06:18 -08:00
1998ea69c7
gh-101041: Fix a misspelled name of `utctimetuple` in a doc warning (GH-101042)
...
(cherry picked from commit 8e9d08b062
2023-01-19 21:06:47 -08:00
db65a326a4
Docs: improve sqlite3 placeholders example (GH-101092)
...
(cherry picked from commit b84be8d9c0
2023-01-18 01:43:44 -08:00
5e52778b1a
Fix typo in `ReprEnum` documentation (GH-101079)
...
(cherry picked from commit c5660ae96f
2023-01-17 02:59:35 -08:00
6d98282ed4
[3.11] Sync-up parameter name in equivalent code snippet of `enumerate` (GH-101029) ( #101030 )
...
Sync-up parameter name in equivalent code snippet of `enumerate` (GH-101029)
(cherry picked from commit ef633e5000
2023-01-15 12:16:06 +05:30
c7aa39286b
gh-100668: Clarify how sqlite3 maps parameters onto placeholders (GH-100960)
...
(cherry picked from commit 206f05a46b
2023-01-14 15:04:53 -08:00
39c1f68fff
gh-101021: Document binary parameters as bytes (GH-101024)
...
(cherry picked from commit 49cae39ef0
2023-01-14 12:22:08 -08:00
ba88628808
[3.11] Add recipes to showcase tee(), zip*, batched, starmap, and product. (GH-101028)
2023-01-13 22:32:32 -06:00
2834fdc689
[3.11] gh-100160: Tweak the documentation for the default asyncio policy (GH-100969)
2023-01-13 10:15:23 +02:00
75717645bc
Fix typo in `enum` module documentation (GH-100992)
...
(cherry picked from commit 2161bbf243
2023-01-12 07:51:11 -08:00
e8097d49f6
GH-100894: Updated the doc for `sys.winver` to clarify its usual contents (GH-100913)
...
(cherry picked from commit d9dff4c8b5
2023-01-11 16:21:07 -08:00
1b2459dc64
[3.11] gh-100160: Remove any deprecation warnings in asyncio.get_event_loop() ( #100412 )
...
Some deprecation warnings will reappear (in a slightly different form) in 3.12.
Co-authored-by: Guido van Rossum <guido@python.org>
2023-01-10 12:20:09 -08:00
1e74a12bde
[3.11] Fix typos in Doc folder (GH-100880). ( #100914 )
...
Co-authored-by: Semen Zhydenko <semen.zhydenko@gmail.com>
2023-01-10 11:42:03 +02:00
4e096ec647
bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
...
(cherry picked from commit e098137cd3
2023-01-09 13:52:43 -08:00
87076d880c
gh-100783: fix os.path.join documentation (GH-100811)
...
- Use "drive", not "drive letter", because of UNC paths
- Previous components are not thrown away from relative drive letters
- Use "segment" instead of "component" for consistency with pathlib
- Other miscellaneous improvements
(cherry picked from commit 53455a319f
2023-01-08 01:22:44 -08:00
caed845fb5
gh-100824: Fix typo in the documentation of unittest.TestLoader.testNamePatterns (GH-100825)
...
(cherry picked from commit 6d3bc4a795
2023-01-08 00:16:49 -08:00
4b4e6da7b5
[3.11] Future-proof recipe by renaming dotproduct() to sumprod() (GH-100828)
2023-01-07 15:16:38 -06:00
a3e2407f5c
gh-100673: Removed erroneous note in the get_type_hints docs (GH-100701)
...
Removed erroneous note in the get_type_hints docs
typing.get_type_hints still includes base class type hints.
(cherry picked from commit deaf090699
2023-01-07 09:38:32 -08:00
72263f2a20
gh-99026 update dataclasses docs for when annotations are inspected (gh-100798)
...
update dataclasses docs for when annotations are inspected
(cherry picked from commit 659c2607f5
2023-01-06 06:34:30 -08:00
d6b8413e94
gh-87691: clarify use of anchor in pathlib docs (GH-100782)
...
This is feedback from https://github.com/python/cpython/pull/100737GH-discussion_r1062968696
This matches the wording from the `os.path.join` docs better:
https://docs.python.org/3/library/os.path.htmlGH-os.path.join
In particular, the previous use of "anchor" was incorrect given the
pathlib definition of "anchor".
(cherry picked from commit 2f2fa03ff3
2023-01-05 17:59:27 -08:00
75861006d8
gh-87691: add an absolute path pathlib example in / operator docs (GH-100737)
...
The behaviour is fully explained a couple paragraphs above, but it may be useful to have a brief example to cover the behaviour.
(cherry picked from commit 1ae619c911
2023-01-05 15:04:39 -08:00
a34f0bdcf6
GH-100766: Note that locale.LC_MESSAGES is not universal (GH-100767)
...
Co-authored-by: Tzu-ping Chung <uranusjr@gmail.com>
2023-01-05 03:46:13 +00:00
7e9b2b0aa7
[Enum] docs: replace 'last value' by 'highest value' for Flag auto (GH-100709)
...
(cherry picked from commit 64ed609c53
2023-01-03 14:27:38 -08:00
af136e9877
gh-100428: Make int documentation more accurate (GH-100436)
...
- Remove first link to lexical definition of integer literal, since it
doesn't apply (differs in handling of leading zeros, base needs to be
explicitly specified, unicode digits are allowed)
- Better describe handling of leading zeros, unicode digits, underscores
- Base 0 does not work exactly as like a code literal, since it allows
Unicode digits. Link code literal to lexical definition of integer
literal.
(cherry picked from commit edfbf56f4c
2023-01-01 19:21:58 -08:00
e7a2659b4c
gh-99953: Purge mention of numeric param style from sqlite3 docs (GH-100630)
...
The PEP-249 numeric style has never been supported by sqlite3.
(cherry picked from commit b7a68ab824
2023-01-01 14:35:39 -08:00
c7dcfdaef6
gh-96773 Fix documentation of socket backlog (GH-96778)
...
(cherry picked from commit 1d1480fefc
2023-01-01 07:13:50 -08:00
7ed7127876
gh-100546: Remove incorrect positional-only marker from eval (GH-100547)
...
All the arguments are positional-only.
The current status after GH-99476 seems to be to not use positional-only
markers in documentation, hence I've simply removed it.
(cherry picked from commit 71159a8e07
2022-12-31 17:06:31 -08:00
18006309ea
[3.11] Improve comments in itertools uniquification recipes (GH-100631) (GH-100632)
2022-12-30 22:23:39 -06:00
297465a4db
gh-100616: Document 'attr' parameter for window.vline() in curses module (GH-24961)
...
(cherry picked from commit f4fcfdf8c5
2022-12-30 09:05:49 -08:00
e180dff4c7
gh-100583: Improve the `pydoc` documentation (GH-100590)
...
(cherry picked from commit 7223d50b97
2022-12-29 07:24:11 -08:00
ac31120de7
GH-100101: Clarify documentation of zip's strict option (GH-100103)
...
(cherry picked from commit cf1c098180
2022-12-28 13:32:19 -08:00
9120450b25
Restore early-out to factor(). Strengthen tests. (GH-100591)
...
(cherry picked from commit c4c5790120
2022-12-28 12:37:58 -08:00
95fa61cbce
Improve factor() recipe and fix its tests (GH-100576)
...
(cherry picked from commit 2d52406835
2022-12-28 03:22:11 -08:00
2cb4b13af6
[3.11] gh-92446: Improve argparse choices docs (GH-94627) ( #100528 )
...
Based on the definition of the collections.abc classes, it is more accurate to use "sequence" instead of "container" when describing argparse choices.
(cherry picked from commit ad3c99e521
2022-12-26 01:09:06 -06:00
44b664e057
gh-99535: Add test for inheritance of annotations and update documentation (GH-99990)
...
(cherry picked from commit f5b7b19bf1
2022-12-24 12:31:10 -08:00
f801fa8ee5
gh-100472: Fix docs claim that compileall parameters could be bytes (GH-100473)
...
(cherry picked from commit 046cbc2080
2022-12-24 12:29:50 -08:00
80013d78e0
[Minor PR] Quotes in documentation changed into code blocks (GH-99536)
...
Minor formatting fix in documentation
(cherry picked from commit efccd04b9e
2022-12-24 12:26:11 -08:00
3b70487459
GH-93179: Document the thread safety of functools.lru_cache (GH-95970)
...
(cherry picked from commit ba4bb7e464
2022-12-24 12:25:34 -08:00
bf0f306bcd
gh-100428: Make float documentation more accurate (GH-100437)
...
Previously, the grammar did not accept `float("10")`.
Also implement mdickinson's suggestion of removing the indirection.
(cherry picked from commit 2e1a9ce989
2022-12-24 12:18:40 -08:00
ba87dae453
Misc Itertools recipe tweaks (GH-100493)
...
(cherry picked from commit 0769f95751
2022-12-24 00:31:36 -08:00
b914054d9d
gh-77771: Add enterabs example in sched (GH-92716)
...
(cherry picked from commit 0f6420640c
2022-12-23 21:31:18 -08:00
a852c5f8ee
[3.11] Correct CVE-2020-10735 documentation (GH-100306). ( #100476 )
...
(cherry picked from commit 1cf3d78c92
2022-12-23 18:07:50 -08:00
9477594374
Add "strict" to dotproduct(). Add docstring. Factor-out common code. (GH-100480)
...
(cherry picked from commit f89de679ff
2022-12-23 16:00:21 -08:00
fe828ec709
gh-91081: Add note on WeakKeyDictionary behavior when deleting a replaced entry (GH-91499)
...
(cherry picked from commit c615286e85
2022-12-20 19:34:17 -08:00
Miss Islington (bot)