1b40618247
gh-103099: Link mypy docs from typing.rst (GH-103100)
...
(cherry picked from commit fda95aa194
2023-03-30 01:39:49 -07:00
d189e2db0b
[3.11] gh-102582: Fix invalid JSON in Doc/howto/logging-cookbook.rst (GH-102635) (GH-103106)
...
(cherry picked from commit d835b3f05d
2023-03-29 10:04:53 +01: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
f79cfb6625
[doc] Fix error in tutorial example: type(exc) is the type rather than the instance (GH-102751)
...
(cherry picked from commit 8709697292
2023-03-22 11:51:48 -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
4c1b4eccba
gh-95913: Consolidate build requirements changes in 3.11 WhatsNew (GH-98781)
...
Apply suggestion to combine build requirements changes in 3.11 WhatsNew
(cherry picked from commit 4a3ea1fdd8
2023-03-22 06:53:22 -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
a7a373e1c5
[3.11] gh-102595: Document `PyObject_Format` c-api function (GH-102596) (GH-102879)
...
(cherry picked from commit 910a64e3015ffdaf748d/Include/abstract.hGH-L389
2023-03-22 02:32:02 -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
a166cb4131
gh-102703: Fix typo in modules tutorial documentation (GH-102707)
...
**Before**
This prevents directories with a common name, such as ``string``, unintentionally hiding ...
**After**
This prevents directories with a common name, such as ``string``, from unintentionally hiding ...
(cherry picked from commit 0a539b5db3
2023-03-14 17:11:56 -07: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
1f7eb8fe6c
gh-100315: clarification to `__slots__` docs. (GH-102621)
...
refer to tp_itemsize in discussion on "variable-length" built-in types
(cherry picked from commit 88c262c086
2023-03-14 02:32:09 -07: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
df3ed54e34
[3.11] gh-95913: Edit Faster CPython section in 3.11 WhatsNew (GH-98429) (GH-102490)
...
gh-95913: Edit Faster CPython section in 3.11 WhatsNew (GH-98429)
(cherry picked from commit 80b19a30c0
2023-03-07 11:08:14 +08:00
280b975c3f
Add gettext support to tools/extensions/c_annotations.py (GH-101989)
...
(cherry picked from commit d959bcd4a0
2023-03-06 13:53:47 -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
00791f23b7
gh-102383: [docs] Arguments of `PyObject_CopyData` are `PyObject *` (GH-102390)
...
(cherry picked from commit 7b9132057d
2023-03-03 09:27:20 -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
90ec292ab8
Doc: Fix minor error in ePub (GH-100614)
...
Fix issue reported https://mail.python.org/archives/list/docs@python.org/message/KE7OIAO53P4XRC4ZOWPDHA63ZQJCHEC3/
(cherry picked from commit 7d1d663418
2023-03-01 10:19:16 +09: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
2c4fc87ac1
[3.11] [doc] Improve grammar/fix missing word (GH-102060) (GH-102277)
...
[doc] Improve grammar/fix missing word (GH-102060)
(cherry picked from commit 6daf42b28e
2023-02-26 18:58:55 +05:30
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
61e0bbdb0c
Fix typo in `Py_GetPythonHome` signature (GH-102168)
...
(cherry picked from commit 9bba8035bd
2023-02-23 05:38:08 -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
559d0e8073
gh-101973: Fix parameter reference for PyModule_FromDefAndSpec (GH-101976)
...
(cherry picked from commit a3bb7fbe7e
2023-02-17 00:50:46 -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
1b736838e6
gh-101845: pyspecific: Fix i18n for availability directive (GH-101846)
...
pyspecific: Fix i18n for availability directive
If the directive has content, the previous code would nest paragraph
nodes from that content inside a general paragraph node, which confuses
Sphinx and leads it to drop the content when translating. Instead, use a
container node for the body.
Also use set_source_info so that any warnings have location info.
(cherry picked from commit 6ef6915d35
2023-02-12 09:28:20 -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
c993ffa477
GH-101616: Mention the Docs Discourse forum in the "reporting docs issues" (GH-101617)
...
Fixes https://github.com/python/cpython/issues/101616
(cherry picked from commit 949c58f945
2023-02-06 14:07:00 -08: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
4c763463fc
Add missing `versionadded` directive for `PyCode_Addr2Location` (GH-101347)
...
(cherry picked from commit f11a3d1ebe
2023-02-03 19:40:51 -08:00
4392bf648f
docs: replace PyPI description with link (GH-101506)
...
(cherry picked from commit 45d014e03b
2023-02-02 23:31:43 -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
e98fa7121d
gh-101467: Correct py.exe handling of prefix matches and cases when only one runtime is installed (GH-101468)
...
(cherry picked from commit eda60916bc
2023-02-01 13:31:21 -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
5e498072dc
[3.11] gh-101440: fix json snippet error in logging-cookbook.rst (GH-101439) (GH-101463)
...
(cherry picked from commit 20c11f2e60
2023-01-31 07:51:48 -08:00
9e4ba5c4bf
gh-99276 - Updated Doc/faq/general.rst (GH-101396)
...
(cherry picked from commit df0068ce48
2023-01-31 07:27:55 -08:00
43af2dbb54
Add JOBS parameter to docs Makefile (GH-101395)
...
(cherry picked from commit 1a62ae84c6
2023-01-31 05:39:06 -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
34679913fe
Fix trivial typo in shebang example (GH-101385)
...
The example was showing the current version, but should be pinned to 3.7 to match the example command.
(cherry picked from commit 666c0840dc
2023-01-29 13:14:23 -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
bab79942c4
[docs] Mention how to get/set a bigint PyLong via the C API (GH-101270)
...
We don't need direct C APIs to get at a bigint representation of PyLong but we
do want the few people who need to understand how.
Additional Author: CAM-Gerlach
(cherry picked from commit e244401ce5
2023-01-23 21:31:06 -08: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
5e1c4ac85e
[3.11] Provided better example for logging cookbook (GH-101164) (GH-101184)
...
Co-authored-by: Vladimir Malinovskii <galqiwi@galqiwi.ru>
Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2023-01-20 17:43:08 +00: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
a3510c3a4e
gh-100247: Improve documentation for custom shebang commands in py.exe launcher (GH-101083)
...
(cherry picked from commit 30753c37c6
2023-01-16 09:13:47 -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
6492492ce7
gh-100247: Fix py.exe launcher not using entire shebang command for finding custom commands (GH-100944)
...
(cherry picked from commit 468c3bf798
2023-01-13 04:52:28 -08: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
a7f9afdd46
[3.11] gh-100916: Convert argument to appropriate type (GH-100917) (GH-100918)
...
Co-authored-by: Yao-Ching Huang <tom4996131207@gmail.com>
2023-01-10 10:38:57 +00: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
07d1f99e8f
[3.11] Update copyright years to 2023. (gh-100848) (GH-100849)
...
(cherry picked from commit 11f99323c2
2023-01-08 17:57:17 -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
eba6b00953
[3.11] gh-81611: Improve `range` paragraph in 8.3 of language reference (GH-98353) ( #100704 )
...
gh-81611: Improve `range` paragraph in 8.3 of language reference (GH-98353)
(cherry picked from commit 8b1f125121
2023-01-04 15:57:24 -05:00
c915f00eca
docs: fix `ssizeobjargproc` parameters (GH-100736)
...
(cherry picked from commit 5fb1c08e15
2023-01-04 07:40:06 -08:00
b93bd153d5
[3.11] Docs: Fix the Show Source link (GH-100733)
...
See also python/release-tools#10
2023-01-03 16:51:36 -06: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
f49006e6a2
gh-100700: Remove Date and Release fields in past whatsnews (GH-100729)
2023-01-03 16:10:57 -06:00
b99ac1dbc0
fix `grammer` -> `grammar` typo in expressions.rst (GH-100683)
...
(cherry picked from commit 7feb6d2f85
2023-01-02 03:57:51 -08:00
1bc0705e64
Fix deprecation doc for `PyEval_InitThreads` (GH-100667)
...
(cherry picked from commit 254ab42240
2023-01-02 03:21:20 -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
18ccb84697
gh-100201: Document behavior with a bare `yield` statement (GH-100416)
...
(cherry picked from commit 1aab269d4a
2023-01-01 07:44:27 -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
f80ba44f7d
gh-100633 Tutorial: Fix dataclasses import (GH-100638)
...
import dataclass not dataclasses from dataclasses
(cherry picked from commit 98308dbeb1
2022-12-31 04:28:59 -08:00
f9ddbc0de5
GH-85979: Clarify specification of `object.__await__` (GH-22320)
...
(cherry picked from commit f59c7f8edd
2022-12-30 22:34:12 -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
de621281ce
gh-55688: Add note about ending backslashes for raw strings (GH-94768)
...
(cherry picked from commit b95b1b3b25
2022-12-27 21:45:45 -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
a7eee898ab
gh-99908: Tutorial: Modernize the 'data-record class' example (GH-100499)
...
(cherry picked from commit 00afa5066b
2022-12-24 07:32:00 -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
4b3b6423c3
gh-98712: Clarify "readonly bytes-like object" semantics in C arg-parsing docs (GH-98710)
...
(cherry picked from commit 49f6ff719c
2022-12-23 07:08:11 -08:00
1fa4c6bd1f
gh-48496: Added example and link to faq for UnboundLocalError in reference (GH-93068)
...
(cherry picked from commit f3db68e6e6
2022-12-22 15:30:12 -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
23fa1667b3
gh-99991: improve docs on str.encode and bytes.decode (GH-100198)
...
(cherry picked from commit a2bb3b7f9d
2022-12-20 18:12:53 -08:00
1332fdabba
Clarify that every thread has its own default context in contextvars (GH-99246)
...
(cherry picked from commit cb60b6131b
2022-12-20 03:44:55 -08:00
cfa78ecc12
gh-69929: re docs: Add more specific definition of \w (GH-92015)
...
(cherry picked from commit 36a0b1d0dd
2022-12-19 19:14:52 -08:00
09186676cf
[3.11] GH-98363: Update batched() recipe in docs to match 3.12 ( #100323 )
2022-12-17 19:10:03 -06:00
bf0a334c4e
Docs: Use `PY_VERSION_HEX` for version comparison (GH-100179)
...
(cherry picked from commit 0264f634f7
2022-12-16 23:49:49 -08:00
370498b12e
gh-97909: Fix markup for `PyMethodDef` members (GH-100089)
...
(cherry picked from commit 8edcb30c3f
2022-12-16 23:19:45 -08:00
e3d85783e5
Document that zipfile's pwd parameter is a `bytes` object (GH-100209)
...
(cherry picked from commit 5ee7eb9deb
2022-12-16 22:54:33 -08:00
4c810f92ba
gh-99830: asyncio: Document returns of remove_{reader,writer} (GH-100302)
...
(cherry picked from commit 5234e1cbea
2022-12-16 11:14:28 -08:00
138c2e6f3f
[3.11] "Compound statement" docs: Fix with-statement step indexing (GH-100286) (GH-100300)
...
Back in commit 226e6e7d43f23236a92d
2022-12-16 11:01:24 -08:00
9d2dcbbccd
[3.11] Remove uninformative itertools recipe (GH-100253) (GH-100275)
2022-12-15 12:47:58 -06:00
cb1001ce23
gh-100248: Add missing `ssl_shutdown_timeout` parameter in `asyncio` docs (GH-100249)
...
(cherry picked from commit 9663853800
2022-12-14 09:07:36 -08:00
cd4166fec2
GH-100206: use versionadded for the addition of sysconfig.get_default_scheme (GH-100207)
...
(cherry picked from commit d3ea82aaf9
2022-12-13 03:02:41 -08:00
60383a3cd8
Fix: typo (Indention) (GH-99904)
...
Example needed to be indented. Was trying to call a context manger `pr` (from ` with cProfile.Profile() as pr:`) wot perform ` pr.print_stats()` once it had already exited.
(cherry picked from commit 8711b59f7a
2022-12-12 04:38:39 -08:00
17bc55e043
clarify the 4300-digit limit on int-str conversion (GH-100175)
...
(cherry picked from commit 935ef59321
2022-12-12 04:06:48 -08:00
71b032635d
gh-70393: Clarify mention of "middle" scope (GH-98839)
...
(cherry picked from commit 70be5e42f6
2022-12-11 20:25:06 -08:00
593c5a0247
gh-100174: [Enum] Correct PowersOfThree example. (GH-100178)
...
Changed from multiples of 3 to powers of 3 to match the class name.
(cherry picked from commit 868bab0fdc
2022-12-11 15:30:25 -08:00
606adb4b89
gh-99728: correct typo in `datetime` format codes documentation (GH-99750)
...
(cherry picked from commit d5f8a2b6ad
2022-12-10 02:29:04 -08:00
9aca00341a
gh-100049: fix `repr` for `mappingproxy` in dictionary view example doc (GH-100052)
...
(cherry picked from commit 7c0fb71fbf
2022-12-10 01:23:24 -08:00
ecb16d5d63
gh-96250: Improve sqlite3 injection attack example (GH-99270)
...
(cherry picked from commit 41d4ac9da3
2022-12-08 12:45:40 -08:00
0274a3bc3b
Use sphinxext-opengraph to generate OpenGraph metadata (GH-99931)
...
(cherry picked from commit f49c735e52
2022-12-08 09:34:52 -08:00
3fae04b10e
[3.11] gh-93453: Only emit deprecation warning in asyncio.get_event_loop when a new event loop is created ( #99949 )
...
It no longer emits a deprecation warning if the current event loop was set.
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-12-06 16:15:44 +01:00
235f5fd2ca
[3.11] gh-100001: Remove doc typo, add versionadded (GH-100042) ( #100043 )
...
(cherry picked from commit bed15f87ea
2022-12-06 11:34:20 +01:00
05031ee1f5
[Enum] Fix typos in the documentation (GH-99960)
...
(cherry picked from commit 2ae894b6d1
2022-12-05 21:46:48 -08:00
a726f747e6
gh-100001: Omit control characters in http.server stderr logs. (GH-100002)
...
Replace control characters in http.server.BaseHTTPRequestHandler.log_message with an escaped \xHH sequence to avoid causing problems for the terminal the output is printed to.
(cherry picked from commit d8ab0a4dfa
2022-12-05 13:39:22 -08:00
f3a58cece6
[3.11] dataclasses.rst: Prevent horizontal scrolling (gh-100025) (gh-100028)
...
dataclasses.rst: Prevent horizontal scrolling (gh-100025)
(cherry picked from commit 51ee0a29e9
2022-12-05 13:59:34 -05:00
7f2bcc7aaa
gh-93464: [Enum] Add versionchanged tag (GH-99997)
...
(cherry picked from commit e3a3863cb9
2022-12-05 02:45:37 -08:00
27218d0799
gh-85747: "Preface" section of asyncio-eventloop.rst: Switch to active voice and suggest other edits (GH-99784)
...
(cherry picked from commit bf26bdf6ac
2022-12-03 16:59:06 -08:00
Miss Islington (bot)