Python 3.11.5v3.11.5

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'