13c36dc9ae
gh-93057: Deprecate positional use of optional sqlite3.connect() params ( #107948 )
2023-08-15 08:09:56 +00:00
a482e5bf00
gh-76913: Add "merge extras" feature to LoggerAdapter (GH-107292)
2023-08-15 08:23:54 +01:00
cc2cf85d03
gh-107877: Update logging levels reference table with usage criteria. ( #107894 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com >
2023-08-13 14:19:41 +01:00
2b6dc2accc
Add another example to the statistics docs (GH-107904)
2023-08-13 08:01:23 -05:00
23a6db98f2
gh-107421: Clarify OrderedDict Examples and Recipes ( #107613 )
2023-08-10 23:43:13 -05:00
a9caf9cf90
GH-105848: Simplify the arrangement of CALL's stack (GH-107788)
2023-08-09 18:19:39 +00:00
aab6f7173a
GH-100425: Note improved commutativity in sum(). (GH-107785)
2023-08-08 18:30:33 +01:00
5dc825d504
gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107552)
...
PEP 683 (immortal objects) revealed some ways in which the Python documentation has been unnecessarily coupled to the implementation details of reference counts. In the end users should focus on reference ownership, including taking references and releasing them, rather than on how many reference counts an object has.
This change updates the documentation to reflect that perspective. It also updates the docs relative to immortal objects in a handful of places.
2023-08-07 15:40:59 -06:00
8c9af6b9a0
Docs: Fix more Sphinx annotations in ctypes.rst ( #107708 )
2023-08-07 15:11:05 +02:00
6925c578a0
gh-107442: Document all valid types for ctypes _as_parameter_ ( #107443 )
2023-08-07 12:41:39 +02:00
4e242d1ffb
Improve cross-references in runpy docs ( #107673 )
...
- Add links to `__main__` and `sys.path` where appropriate
- Ensure each paragraph never has more than one link to the same thing, to avoid visual clutter from too many links
2023-08-06 21:11:16 +00:00
71a7c96ffe
Docs: Fix Sphinx annotations in Doc/library/ctypes.rst ( #107672 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com >
2023-08-06 10:23:50 +02:00
9ebc6ecbc3
gh-107662: Switch 'any' and 'anext' in functions.rst ( #107663 )
...
Order was reversed in index at top, not in body.
2023-08-05 14:38:20 +00:00
ec0a0d2bd9
GH-70303: Emit FutureWarning when pathlib glob pattern ends with ** (GH-105413)
...
In a future Python release, patterns with this ending will match both files
and directories. Users may add a trailing slash to remove the warning.
2023-08-04 23:12:12 +00:00
09a8cc7984
gh-107600: Docs: Update ctypes.ArgumentError error message ( #107601 )
2023-08-04 16:34:04 +02:00
c8872f4285
Clarify Self interaction with subclasses ( #107511 )
2023-08-01 13:20:25 -07:00
a22ff8e11c
gh-105578: Document that AnyStr is deprecated in py313 ( #107116 )
...
It will not be removed until Python 3.18.
2023-07-31 15:43:53 +00:00
f877b32b87
gh-105578: Add more usage examples to typing.AnyStr docs ( #107045 )
...
``typing.AnyStr`` has different semantics to ``str | bytes``, which often leads to user confusion
2023-07-31 16:23:08 +01:00
a24e25d74b
gh-107427: Update the description of UNPACK_SEQUENCE (gh-107429)
2023-07-31 00:40:37 +09:00
89fd4f4a3f
gh-107422: Remove outdated TypedDict example from typing docs ( #107436 )
2023-07-29 17:04:46 +00:00
f2d07d3289
gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386)
2023-07-29 08:48:10 +03:00
cf63df88d3
gh-107307: Update the importlib Docs for PEP 684 (gh-107400)
2023-07-28 16:00:03 -06:00
0aa58fa7a6
gh-107091: Fix some uses of :const: role (GH-107379)
...
It is for references, not for literals.
2023-07-28 13:26:28 +03:00
ccd4253752
gh-106996: Rewrite turtle explanation ( #107244 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com >
2023-07-27 11:02:19 +03:00
6d5b6e71c8
gh-107091: Fix some uses of :c:type: role (GH-107138)
2023-07-26 22:29:23 +03:00
737d1da074
Document that os.link() is not available on Emscripten (GH-104822)
2023-07-26 11:38:59 -07:00
da8f87b7ea
gh-107015: Remove async_hacks from the tokenizer ( #107018 )
2023-07-26 16:34:15 +01:00
70dc009469
gh-106939: document ShareableList nul-strip quirk. ( #107266 )
...
* gh-106939: document ShareableList nul-strip quirk.
* Mention the `int` size constraint.
2023-07-25 14:09:25 -07:00
2425346fee
gh-106996: Add a how-to section to the turtle documentation ( #107153 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com >
2023-07-25 15:03:57 +03:00
b447e19e72
gh-106948: Docs: Disable links for C standard library functions, OS utility functions and system calls ( #107062 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com >
2023-07-23 22:56:56 +02:00
0ae4870d09
gh-107122: Add clear method to dbm.ndbm module (gh-107126)
2023-07-23 14:26:23 +00:00
b273837fea
gh-107122: Add clear method to dbm.gdbm.module (gh-107127)
2023-07-23 13:51:12 +00:00
a2a0e51400
gh-106996: Add the basics of a turtle graphics tutorial ( #107072 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com >
2023-07-23 03:43:27 -06:00
f5147c0cfb
gh-101100: Fix some broken sphinx references ( #107095 )
2023-07-23 03:23:44 -06:00
dcd7acb04a
gh-54738: Add argparse i18n howto ( #104562 )
2023-07-23 11:10:38 +02:00
0af247da09
gh-102111: Add link to string escape sequences in re module ( #106995 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com >
2023-07-23 02:50:38 -06:00
5e5a34ac3a
gh-107028: tiny textual changes in logging docs and docstrings (GH-107029)
2023-07-22 21:43:18 +01:00
f8b7fe2f26
gh-106948: Add standard external names to nitpick_ignore (GH-106949)
...
It includes standard C types, macros and variables like "size_t",
"LONG_MAX" and "errno", and standard environment variables like "PATH".
2023-07-22 21:35:22 +03:00
26e08dfdd7
gh-107008: Document the curses module variables LINES and COLS (GH-107011)
...
LINES and COLS referred in curses.update_lines_cols() documentations are
the module variables, not the environment variables.
2023-07-22 19:54:50 +03:00
6e5f2235f3
gh-83006: Document behavior of shutil.disk_usage for non-mounted filesystems on Unix ( #107031 )
2023-07-22 17:58:06 +02:00
149748ea4f
Fix Sphinx warnings in re module docs ( #107044 )
2023-07-22 16:44:44 +01:00
e5252c6127
gh-105090: Replace incorrect TLSv1.2 with TLSv1.3 ( #105404 )
2023-07-22 14:29:08 +00:00
f8f16d0cfc
gh-106996: Amend the introduction to the turtle graphics documentation ( #106997 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com >
2023-07-22 04:31:44 -06:00
fd84ac0ee0
gh-106847: Add -X warn_default_encoding in sys.flags Doc ( #106854 )
...
Co-authored-by: Nikita Sobolev <mail@sobolevn.me >
2023-07-21 15:47:58 +05:30
4b9948617f
gh-106909: Use role :const: for referencing module constants (GH-106910)
2023-07-21 12:40:37 +03:00
d036db728e
gh-106892: Use roles :data: and :const: for referencing module variables (GH-106894)
2023-07-21 12:34:30 +03:00
fcc816dbff
gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920)
2023-07-21 10:52:07 +03:00
a31dea1feb
gh-106669: Revert "gh-102988: Detect email address parsing errors ... ( #105127 )" ( #106733 )
...
This reverts commit 18dfbd0357https://github.com/python/cpython/issues/106669 .
2023-07-20 20:30:52 -07:00
60e83968d5
Fix typo in tkinter docs ( #106936 )
...
Signed-off-by: Makonede <61922615+Makonede@users.noreply.github.com >
2023-07-21 00:07:06 +01:00
1e1f4e91a9
gh-106882: Note that asyncio.Server is only publicly exposed on 3.11+ ( #106901 )
...
And later versions of 3.10, 3.9
2023-07-19 20:56:26 +01:00
Erlend E. Aasland