Python 3.12.4v3.12.4

1 files changed, 80 insertions, 73 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index 570e019..e9e6337 100644
--- a/Lib/pydoc_data/topics.py
+++ b/Lib/pydoc_data/topics.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Tue Apr  9 09:17:41 2024
+# Autogenerated by Sphinx on Thu Jun  6 20:20:21 2024
 # as part of the release process.
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
@@ -419,7 +419,7 @@ topics = {'assert': 'The "assert" statement\n'
  'async': 'Coroutines\n'
           '**********\n'
           '\n'
-          'New in version 3.5.\n'
+          'Added in version 3.5.\n'
           '\n'
           '\n'
           'Coroutine function definition\n'
@@ -792,7 +792,7 @@ topics = {'assert': 'The "assert" statement\n'
                      'Changed in version 3.5: "__class__" module attribute is '
                      'now writable.\n'
                      '\n'
-                     'New in version 3.7: "__getattr__" and "__dir__" module '
+                     'Added in version 3.7: "__getattr__" and "__dir__" module '
                      'attributes.\n'
                      '\n'
                      'See also:\n'
@@ -1206,7 +1206,7 @@ topics = {'assert': 'The "assert" statement\n'
           '\n'
           '   await_expr ::= "await" primary\n'
           '\n'
-          'New in version 3.5.\n',
+          'Added in version 3.5.\n',
  'binary': 'Binary arithmetic operations\n'
            '****************************\n'
            '\n'
@@ -1239,7 +1239,7 @@ topics = {'assert': 'The "assert" statement\n'
            'The "@" (at) operator is intended to be used for matrix\n'
            'multiplication.  No builtin Python types implement this operator.\n'
            '\n'
-           'New in version 3.5.\n'
+           'Added in version 3.5.\n'
            '\n'
            'The "/" (division) and "//" (floor division) operators yield the\n'
            'quotient of their arguments.  The numeric arguments are first\n'
@@ -2765,7 +2765,7 @@ topics = {'assert': 'The "assert" statement\n'
              'The "match" statement\n'
              '=====================\n'
              '\n'
-             'New in version 3.10.\n'
+             'Added in version 3.10.\n'
              '\n'
              'The match statement is used for pattern matching.  Syntax:\n'
              '\n'
@@ -3849,7 +3849,7 @@ topics = {'assert': 'The "assert" statement\n'
              'Coroutines\n'
              '==========\n'
              '\n'
-             'New in version 3.5.\n'
+             'Added in version 3.5.\n'
              '\n'
              '\n'
              'Coroutine function definition\n'
@@ -3976,7 +3976,7 @@ topics = {'assert': 'The "assert" statement\n'
              'Type parameter lists\n'
              '====================\n'
              '\n'
-             'New in version 3.12.\n'
+             'Added in version 3.12.\n'
              '\n'
              '   type_params  ::= "[" type_param ("," type_param)* "]"\n'
              '   type_param   ::= typevar | typevartuple | paramspec\n'
@@ -5211,7 +5211,8 @@ topics = {'assert': 'The "assert" statement\n'
              '* "$_exception": the exception if the frame is raising an '
              'exception\n'
              '\n'
-             'New in version 3.12.\n'
+             'Added in version 3.12: Added the *convenience variable* '
+             'feature.\n'
              '\n'
              'If a file ".pdbrc" exists in the user’s home directory or in '
              'the\n'
@@ -5475,7 +5476,7 @@ topics = {'assert': 'The "assert" statement\n'
              '   List all source code for the current function or frame.\n'
              '   Interesting lines are marked as for "list".\n'
              '\n'
-             '   New in version 3.2.\n'
+             '   Added in version 3.2.\n'
              '\n'
              'a(rgs)\n'
              '\n'
@@ -5508,7 +5509,7 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              '   Try to get source code of *expression* and display it.\n'
              '\n'
-             '   New in version 3.2.\n'
+             '   Added in version 3.2.\n'
              '\n'
              'display [expression]\n'
              '\n'
@@ -5567,7 +5568,7 @@ topics = {'assert': 'The "assert" statement\n'
              '      display lst[:]: [1]  [old: []]\n'
              '      (Pdb)\n'
              '\n'
-             '   New in version 3.2.\n'
+             '   Added in version 3.2.\n'
              '\n'
              'undisplay [expression]\n'
              '\n'
@@ -5576,7 +5577,7 @@ topics = {'assert': 'The "assert" statement\n'
              '   *expression*, clear all display expressions for the current '
              'frame.\n'
              '\n'
-             '   New in version 3.2.\n'
+             '   Added in version 3.2.\n'
              '\n'
              'interact\n'
              '\n'
@@ -5586,7 +5587,7 @@ topics = {'assert': 'The "assert" statement\n'
              'found in\n'
              '   the current scope.\n'
              '\n'
-             '   New in version 3.2.\n'
+             '   Added in version 3.2.\n'
              '\n'
              'alias [name [command]]\n'
              '\n'
@@ -5737,7 +5738,8 @@ topics = {'assert': 'The "assert" statement\n'
          'dict\n'
          'items and earlier dictionary unpackings.\n'
          '\n'
-         'New in version 3.5: Unpacking into dictionary displays, originally\n'
+         'Added in version 3.5: Unpacking into dictionary displays, '
+         'originally\n'
          'proposed by **PEP 448**.\n'
          '\n'
          'A dict comprehension, in contrast to list and set comprehensions,\n'
@@ -6045,9 +6047,12 @@ topics = {'assert': 'The "assert" statement\n'
               'of the module "builtins".  The global namespace is searched '
               'first.  If\n'
               'the names are not found there, the builtins namespace is '
-              'searched.\n'
-              'The "global" statement must precede all uses of the listed '
-              'names.\n'
+              'searched\n'
+              'next. If the names are also not found in the builtins '
+              'namespace, new\n'
+              'variables are created in the global namespace. The global '
+              'statement\n'
+              'must precede all uses of the listed names.\n'
               '\n'
               'The "global" statement has the same scope as a name binding '
               'operation\n'
@@ -6179,9 +6184,9 @@ topics = {'assert': 'The "assert" statement\n'
               'object were\n'
               '  defined in the enclosing scope.\n'
               '\n'
-              'New in version 3.12: Annotation scopes were introduced in '
-              'Python 3.12\n'
-              'as part of **PEP 695**.\n'
+              'Added in version 3.12: Annotation scopes were introduced in '
+              'Python\n'
+              '3.12 as part of **PEP 695**.\n'
               '\n'
               '\n'
               'Lazy evaluation\n'
@@ -6241,7 +6246,7 @@ topics = {'assert': 'The "assert" statement\n'
               'looked up\n'
               'as if they were used in the immediately enclosing scope.\n'
               '\n'
-              'New in version 3.12.\n'
+              'Added in version 3.12.\n'
               '\n'
               '\n'
               'Builtins and restricted execution\n'
@@ -6396,9 +6401,8 @@ topics = {'assert': 'The "assert" statement\n'
               'the\n'
               'unpacking.\n'
               '\n'
-              'New in version 3.5: Iterable unpacking in expression lists, '
-              'originally\n'
-              'proposed by **PEP 448**.\n'
+              'Added in version 3.5: Iterable unpacking in expression lists,\n'
+              'originally proposed by **PEP 448**.\n'
               '\n'
               'A trailing comma is required only to create a one-item tuple, '
               'such as\n'
@@ -7693,7 +7697,7 @@ topics = {'assert': 'The "assert" statement\n'
                 'Soft Keywords\n'
                 '=============\n'
                 '\n'
-                'New in version 3.10.\n'
+                'Added in version 3.10.\n'
                 '\n'
                 'Some identifiers are only reserved under specific contexts. '
                 'These are\n'
@@ -8321,9 +8325,12 @@ topics = {'assert': 'The "assert" statement\n'
            'namespace\n'
            'of the module "builtins".  The global namespace is searched '
            'first.  If\n'
-           'the names are not found there, the builtins namespace is '
-           'searched.\n'
-           'The "global" statement must precede all uses of the listed names.\n'
+           'the names are not found there, the builtins namespace is searched\n'
+           'next. If the names are also not found in the builtins namespace, '
+           'new\n'
+           'variables are created in the global namespace. The global '
+           'statement\n'
+           'must precede all uses of the listed names.\n'
            '\n'
            'The "global" statement has the same scope as a name binding '
            'operation\n'
@@ -8447,9 +8454,9 @@ topics = {'assert': 'The "assert" statement\n'
            'were\n'
            '  defined in the enclosing scope.\n'
            '\n'
-           'New in version 3.12: Annotation scopes were introduced in Python '
-           '3.12\n'
-           'as part of **PEP 695**.\n'
+           'Added in version 3.12: Annotation scopes were introduced in '
+           'Python\n'
+           '3.12 as part of **PEP 695**.\n'
            '\n'
            '\n'
            'Lazy evaluation\n'
@@ -8508,7 +8515,7 @@ topics = {'assert': 'The "assert" statement\n'
            'looked up\n'
            'as if they were used in the immediately enclosing scope.\n'
            '\n'
-           'New in version 3.12.\n'
+           'Added in version 3.12.\n'
            '\n'
            '\n'
            'Builtins and restricted execution\n'
@@ -9427,7 +9434,7 @@ topics = {'assert': 'The "assert" statement\n'
                    'for\n'
                    '   correctness.\n'
                    '\n'
-                   '   New in version 3.4.\n'
+                   '   Added in version 3.4.\n'
                    '\n'
                    'Note:\n'
                    '\n'
@@ -9678,7 +9685,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'descriptor, or\n'
                  '   generator instance.\n'
                  '\n'
-                 '   New in version 3.3.\n'
+                 '   Added in version 3.3.\n'
                  '\n'
                  'definition.__type_params__\n'
                  '\n'
@@ -9686,7 +9693,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'type\n'
                  '   aliases.\n'
                  '\n'
-                 '   New in version 3.12.\n'
+                 '   Added in version 3.12.\n'
                  '\n'
                  'class.__mro__\n'
                  '\n'
@@ -10395,7 +10402,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'Changed in version 3.5: "__class__" module attribute is now '
                  'writable.\n'
                  '\n'
-                 'New in version 3.7: "__getattr__" and "__dir__" module '
+                 'Added in version 3.7: "__getattr__" and "__dir__" module '
                  'attributes.\n'
                  '\n'
                  'See also:\n'
@@ -10764,7 +10771,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'explicit\n'
                  '     hint) can be accessed as "type(cls)".\n'
                  '\n'
-                 '   New in version 3.6.\n'
+                 '   Added in version 3.6.\n'
                  '\n'
                  'When a class is created, "type.__new__()" scans the class '
                  'variables\n'
@@ -10796,7 +10803,7 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  '   See Creating the class object for more details.\n'
                  '\n'
-                 '   New in version 3.6.\n'
+                 '   Added in version 3.6.\n'
                  '\n'
                  '\n'
                  'Metaclasses\n'
@@ -11398,7 +11405,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'for\n'
                  '   correctness.\n'
                  '\n'
-                 '   New in version 3.4.\n'
+                 '   Added in version 3.4.\n'
                  '\n'
                  'Note:\n'
                  '\n'
@@ -11847,7 +11854,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'will\n'
                  'raise a "TypeError".\n'
                  '\n'
-                 'New in version 3.10.\n'
+                 'Added in version 3.10.\n'
                  '\n'
                  'See also:\n'
                  '\n'
@@ -11896,7 +11903,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'to\n'
                  '   implement this method.\n'
                  '\n'
-                 'New in version 3.12.\n'
+                 'Added in version 3.12.\n'
                  '\n'
                  'See also:\n'
                  '\n'
@@ -12060,7 +12067,7 @@ topics = {'assert': 'The "assert" statement\n'
                    '‘Default\n'
                    '   Case Folding’ of the Unicode Standard.\n'
                    '\n'
-                   '   New in version 3.3.\n'
+                   '   Added in version 3.3.\n'
                    '\n'
                    'str.center(width[, fillchar])\n'
                    '\n'
@@ -12244,7 +12251,7 @@ topics = {'assert': 'The "assert" statement\n'
                    "{country}'.format_map(Default(name='Guido'))\n"
                    "   'Guido was born in country'\n"
                    '\n'
-                   '   New in version 3.2.\n'
+                   '   Added in version 3.2.\n'
                    '\n'
                    'str.index(sub[, start[, end]])\n'
                    '\n'
@@ -12288,7 +12295,7 @@ topics = {'assert': 'The "assert" statement\n'
                    'have code\n'
                    '   points in the range U+0000-U+007F.\n'
                    '\n'
-                   '   New in version 3.7.\n'
+                   '   Added in version 3.7.\n'
                    '\n'
                    'str.isdecimal()\n'
                    '\n'
@@ -12528,7 +12535,7 @@ topics = {'assert': 'The "assert" statement\n'
                    "      >>> 'BaseTestCase'.removeprefix('Test')\n"
                    "      'BaseTestCase'\n"
                    '\n'
-                   '   New in version 3.9.\n'
+                   '   Added in version 3.9.\n'
                    '\n'
                    'str.removesuffix(suffix, /)\n'
                    '\n'
@@ -12543,7 +12550,7 @@ topics = {'assert': 'The "assert" statement\n'
                    "      >>> 'TmpDirMixin'.removesuffix('Tests')\n"
                    "      'TmpDirMixin'\n"
                    '\n'
-                   '   New in version 3.9.\n'
+                   '   Added in version 3.9.\n'
                    '\n'
                    'str.replace(old, new[, count])\n'
                    '\n'
@@ -13016,8 +13023,8 @@ topics = {'assert': 'The "assert" statement\n'
             'than\n'
             'Python 3.x’s the "\'ur\'" syntax is not supported.\n'
             '\n'
-            'New in version 3.3: The "\'rb\'" prefix of raw bytes literals has '
-            'been\n'
+            'Added in version 3.3: The "\'rb\'" prefix of raw bytes literals '
+            'has been\n'
             'added as a synonym of "\'br\'".Support for the unicode legacy '
             'literal\n'
             '("u\'value\'") was reintroduced to simplify the maintenance of '
@@ -13989,7 +13996,7 @@ topics = {'assert': 'The "assert" statement\n'
           '| function.__qualname__                              | The '
           'function’s *qualified name*. See also:         |\n'
           '|                                                    | '
-          '"__qualname__ attributes".  New in version 3.3.    |\n'
+          '"__qualname__ attributes".  Added in version 3.3.  |\n'
           '+----------------------------------------------------+----------------------------------------------------+\n'
           '| function.__module__                                | The name of '
           'the module the function was defined    |\n'
@@ -14032,7 +14039,7 @@ topics = {'assert': 'The "assert" statement\n'
           '| function.__type_params__                           | A "tuple" '
           'containing the type parameters of a      |\n'
           '|                                                    | generic '
-          'function.  New in version 3.12.            |\n'
+          'function.  Added in version 3.12.          |\n'
           '+----------------------------------------------------+----------------------------------------------------+\n'
           '\n'
           'Function objects also support getting and setting arbitrary\n'
@@ -14339,8 +14346,7 @@ topics = {'assert': 'The "assert" statement\n'
           'to\n'
           'a common ancestor. Additional details on the C3 MRO used by Python '
           'can\n'
-          'be found in the documentation accompanying the 2.3 release at\n'
-          'https://docs.python.org/3/howto/mro.html.\n'
+          'be found at The Python 2.3 Method Resolution Order.\n'
           '\n'
           'When a class attribute reference (for class "C", say) would yield '
           'a\n'
@@ -14484,9 +14490,9 @@ topics = {'assert': 'The "assert" statement\n'
           'name                                  |\n'
           '+----------------------------------------------------+----------------------------------------------------+\n'
           '| codeobject.co_qualname                             | The fully '
-          'qualified function name  New in version  |\n'
-          '|                                                    | '
-          '3.11.                                              |\n'
+          'qualified function name  Added in        |\n'
+          '|                                                    | version '
+          '3.11.                                      |\n'
           '+----------------------------------------------------+----------------------------------------------------+\n'
           '| codeobject.co_argcount                             | The total '
           'number of positional *parameters*        |\n'
@@ -14618,10 +14624,10 @@ topics = {'assert': 'The "assert" statement\n'
           '   The iterator returns "tuple"s containing the "(start_line,\n'
           '   end_line, start_column, end_column)". The *i-th* tuple '
           'corresponds\n'
-          '   to the position of the source code that compiled to the *i-th*\n'
-          '   instruction. Column information is 0-indexed utf-8 byte offsets '
-          'on\n'
-          '   the given source line.\n'
+          '   to the position of the source code that compiled to the *i-th* '
+          'code\n'
+          '   unit. Column information is 0-indexed utf-8 byte offsets on the\n'
+          '   given source line.\n'
           '\n'
           '   This positional information can be missing. A non-exhaustive '
           'lists\n'
@@ -14640,7 +14646,7 @@ topics = {'assert': 'The "assert" statement\n'
           '   When this occurs, some or all of the tuple elements can be '
           '"None".\n'
           '\n'
-          '   New in version 3.11.\n'
+          '   Added in version 3.11.\n'
           '\n'
           '   Note:\n'
           '\n'
@@ -14698,7 +14704,7 @@ topics = {'assert': 'The "assert" statement\n'
           'but\n'
           '   have been eliminated by the *bytecode* compiler.\n'
           '\n'
-          '   New in version 3.10.\n'
+          '   Added in version 3.10.\n'
           '\n'
           '   See also:\n'
           '\n'
@@ -14712,7 +14718,7 @@ topics = {'assert': 'The "assert" statement\n'
           'specified\n'
           '   fields.\n'
           '\n'
-          '   New in version 3.8.\n'
+          '   Added in version 3.8.\n'
           '\n'
           '\n'
           'Frame objects\n'
@@ -14827,7 +14833,7 @@ topics = {'assert': 'The "assert" statement\n'
           '\n'
           '   "RuntimeError" is raised if the frame is currently executing.\n'
           '\n'
-          '   New in version 3.4.\n'
+          '   Added in version 3.4.\n'
           '\n'
           '\n'
           'Traceback objects\n'
@@ -15149,7 +15155,7 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  '      Return a shallow copy of the dictionary.\n'
                  '\n'
-                 '   classmethod fromkeys(iterable[, value])\n'
+                 '   classmethod fromkeys(iterable, value=None)\n'
                  '\n'
                  '      Create a new dictionary with keys from *iterable* and '
                  'values set\n'
@@ -15165,7 +15171,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'distinct\n'
                  '      values, use a dict comprehension instead.\n'
                  '\n'
-                 '   get(key[, default])\n'
+                 '   get(key, default=None)\n'
                  '\n'
                  '      Return the value for *key* if *key* is in the '
                  'dictionary, else\n'
@@ -15215,9 +15221,9 @@ topics = {'assert': 'The "assert" statement\n'
                  'dictionary. This\n'
                  '      is a shortcut for "reversed(d.keys())".\n'
                  '\n'
-                 '      New in version 3.8.\n'
+                 '      Added in version 3.8.\n'
                  '\n'
-                 '   setdefault(key[, default])\n'
+                 '   setdefault(key, default=None)\n'
                  '\n'
                  '      If *key* is in the dictionary, return its value.  If '
                  'not, insert\n'
@@ -15266,7 +15272,7 @@ topics = {'assert': 'The "assert" statement\n'
                  '      *other* take priority when *d* and *other* share '
                  'keys.\n'
                  '\n'
-                 '      New in version 3.9.\n'
+                 '      Added in version 3.9.\n'
                  '\n'
                  '   d |= other\n'
                  '\n'
@@ -15278,7 +15284,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'and *other*\n'
                  '      share keys.\n'
                  '\n'
-                 '      New in version 3.9.\n'
+                 '      Added in version 3.9.\n'
                  '\n'
                  '   Dictionaries compare equal if and only if they have the '
                  'same "(key,\n'
@@ -15400,7 +15406,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'original\n'
                  '   dictionary to which the view refers.\n'
                  '\n'
-                 '   New in version 3.10.\n'
+                 '   Added in version 3.10.\n'
                  '\n'
                  'Keys views are set-like since their entries are unique and '
                  '*hashable*.\n'
@@ -15940,7 +15946,7 @@ topics = {'assert': 'The "assert" statement\n'
              'mutable\n'
              '   sequence classes provide it.\n'
              '\n'
-             '   New in version 3.3: "clear()" and "copy()" methods.\n'
+             '   Added in version 3.3: "clear()" and "copy()" methods.\n'
              '\n'
              '6. The value *n* is an integer, or an object implementing\n'
              '   "__index__()".  Zero and negative values of *n* clear the '
@@ -16408,7 +16414,8 @@ topics = {'assert': 'The "assert" statement\n'
                      'concrete mutable\n'
                      '   sequence classes provide it.\n'
                      '\n'
-                     '   New in version 3.3: "clear()" and "copy()" methods.\n'
+                     '   Added in version 3.3: "clear()" and "copy()" '
+                     'methods.\n'
                      '\n'
                      '6. The value *n* is an integer, or an object '
                      'implementing\n'