summaryrefslogtreecommitdiffstats
path: root/Lib/pydoc_data/topics.py
diff options
context:
space:
mode:
Diffstat (limited to 'Lib/pydoc_data/topics.py')
-rw-r--r--Lib/pydoc_data/topics.py77
1 files changed, 44 insertions, 33 deletions
diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index 8093041..1b1251b 100644
--- a/Lib/pydoc_data/topics.py
+++ b/Lib/pydoc_data/topics.py
@@ -1,5 +1,6 @@
# -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Tue Jun 6 23:00:07 2023
+# Autogenerated by Sphinx on Thu Aug 24 13:07:17 2023
+# as part of the release process.
topics = {'assert': 'The "assert" statement\n'
'**********************\n'
'\n'
@@ -208,7 +209,7 @@ topics = {'assert': 'The "assert" statement\n'
'the\n'
' subscript must have a type compatible with the mapping’s key '
'type,\n'
- ' and the mapping is then asked to create a key/datum pair '
+ ' and the mapping is then asked to create a key/value pair '
'which maps\n'
' the subscript to the assigned object. This can either '
'replace an\n'
@@ -5429,30 +5430,31 @@ topics = {'assert': 'The "assert" statement\n'
'dict': 'Dictionary displays\n'
'*******************\n'
'\n'
- 'A dictionary display is a possibly empty series of key/datum pairs\n'
- 'enclosed in curly braces:\n'
+ 'A dictionary display is a possibly empty series of dict items\n'
+ '(key/value pairs) enclosed in curly braces:\n'
'\n'
- ' dict_display ::= "{" [key_datum_list | dict_comprehension] '
+ ' dict_display ::= "{" [dict_item_list | dict_comprehension] '
'"}"\n'
- ' key_datum_list ::= key_datum ("," key_datum)* [","]\n'
- ' key_datum ::= expression ":" expression | "**" or_expr\n'
+ ' dict_item_list ::= dict_item ("," dict_item)* [","]\n'
+ ' dict_item ::= expression ":" expression | "**" or_expr\n'
' dict_comprehension ::= expression ":" expression comp_for\n'
'\n'
'A dictionary display yields a new dictionary object.\n'
'\n'
- 'If a comma-separated sequence of key/datum pairs is given, they are\n'
+ 'If a comma-separated sequence of dict items is given, they are\n'
'evaluated from left to right to define the entries of the '
'dictionary:\n'
'each key object is used as a key into the dictionary to store the\n'
- 'corresponding datum. This means that you can specify the same key\n'
- 'multiple times in the key/datum list, and the final dictionary’s '
+ 'corresponding value. This means that you can specify the same key\n'
+ 'multiple times in the dict item list, and the final dictionary’s '
'value\n'
'for that key will be the last one given.\n'
'\n'
'A double asterisk "**" denotes *dictionary unpacking*. Its operand\n'
'must be a *mapping*. Each mapping item is added to the new\n'
- 'dictionary. Later values replace values already set by earlier\n'
- 'key/datum pairs and earlier dictionary unpackings.\n'
+ 'dictionary. Later values replace values already set by earlier '
+ 'dict\n'
+ 'items and earlier dictionary unpackings.\n'
'\n'
'New in version 3.5: Unpacking into dictionary displays, originally\n'
'proposed by **PEP 448**.\n'
@@ -5468,7 +5470,7 @@ topics = {'assert': 'The "assert" statement\n'
'Restrictions on the types of the key values are listed earlier in\n'
'section The standard type hierarchy. (To summarize, the key type\n'
'should be *hashable*, which excludes all mutable objects.) Clashes\n'
- 'between duplicate keys are not detected; the last datum (textually\n'
+ 'between duplicate keys are not detected; the last value (textually\n'
'rightmost in the display) stored for a given key value prevails.\n'
'\n'
'Changed in version 3.8: Prior to Python 3.8, in dict '
@@ -6113,22 +6115,26 @@ topics = {'assert': 'The "assert" statement\n'
'positional\n'
'argument, and if it’s a keyword, it refers to a named '
'keyword\n'
- 'argument. If the numerical arg_names in a format string '
- 'are 0, 1, 2,\n'
- '… in sequence, they can all be omitted (not just some) and '
- 'the numbers\n'
- '0, 1, 2, … will be automatically inserted in that order. '
- 'Because\n'
- '*arg_name* is not quote-delimited, it is not possible to '
- 'specify\n'
- 'arbitrary dictionary keys (e.g., the strings "\'10\'" or '
- '"\':-]\'") within\n'
- 'a format string. The *arg_name* can be followed by any '
- 'number of index\n'
- 'or attribute expressions. An expression of the form '
- '"\'.name\'" selects\n'
- 'the named attribute using "getattr()", while an expression '
- 'of the form\n'
+ 'argument. An *arg_name* is treated as a number if a call '
+ 'to\n'
+ '"str.isdecimal()" on the string would return true. If the '
+ 'numerical\n'
+ 'arg_names in a format string are 0, 1, 2, … in sequence, '
+ 'they can all\n'
+ 'be omitted (not just some) and the numbers 0, 1, 2, … will '
+ 'be\n'
+ 'automatically inserted in that order. Because *arg_name* is '
+ 'not quote-\n'
+ 'delimited, it is not possible to specify arbitrary '
+ 'dictionary keys\n'
+ '(e.g., the strings "\'10\'" or "\':-]\'") within a format '
+ 'string. The\n'
+ '*arg_name* can be followed by any number of index or '
+ 'attribute\n'
+ 'expressions. An expression of the form "\'.name\'" selects '
+ 'the named\n'
+ 'attribute using "getattr()", while an expression of the '
+ 'form\n'
'"\'[index]\'" does an index lookup using "__getitem__()".\n'
'\n'
'Changed in version 3.1: The positional argument specifiers '
@@ -9105,7 +9111,8 @@ topics = {'assert': 'The "assert" statement\n'
' still alive. The list is in definition order. Example:\n'
'\n'
' >>> int.__subclasses__()\n'
- " [<class 'bool'>]\n",
+ " [<class 'bool'>, <enum 'IntEnum'>, <flag 'IntFlag'>, "
+ "<class 're._constants._NamedIntConstant'>]\n",
'specialnames': 'Special method names\n'
'********************\n'
'\n'
@@ -12604,7 +12611,7 @@ topics = {'assert': 'The "assert" statement\n'
'are\n'
'most of the built-in objects considered false:\n'
'\n'
- '* constants defined to be false: "None" and "False".\n'
+ '* constants defined to be false: "None" and "False"\n'
'\n'
'* zero of any numeric type: "0", "0.0", "0j", "Decimal(0)",\n'
' "Fraction(0, 1)"\n'
@@ -14517,8 +14524,12 @@ topics = {'assert': 'The "assert" statement\n'
' >>> # set operations\n'
" >>> keys & {'eggs', 'bacon', 'salad'}\n"
" {'bacon'}\n"
- " >>> keys ^ {'sausage', 'juice'}\n"
- " {'juice', 'sausage', 'bacon', 'spam'}\n"
+ " >>> keys ^ {'sausage', 'juice'} == {'juice', 'sausage', "
+ "'bacon', 'spam'}\n"
+ ' True\n'
+ " >>> keys | ['juice', 'juice', 'juice'] == {'bacon', "
+ "'spam', 'juice'}\n"
+ ' True\n'
'\n'
' >>> # get back a read-only proxy for the original '
'dictionary\n'