Python 3.11.0a1v3.11.0a1

1 files changed, 564 insertions, 303 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index 40f7a50128..eb523370c5 100644
--- a/Lib/pydoc_data/topics.py
+++ b/Lib/pydoc_data/topics.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Mon Apr  5 17:39:41 2021
+# Autogenerated by Sphinx on Tue Oct  5 13:43:52 2021
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
            '\n'
@@ -551,13 +551,65 @@ topics = {'assert': 'The "assert" statement\n'
           'exception.\n'
           '    That new exception causes the old one to be lost.\n'
           '\n'
-          '[2] A string literal appearing as the first statement in the '
+          '[2] In pattern matching, a sequence is defined as one of the\n'
+          '    following:\n'
+          '\n'
+          '       * a class that inherits from "collections.abc.Sequence"\n'
+          '\n'
+          '       * a Python class that has been registered as\n'
+          '         "collections.abc.Sequence"\n'
+          '\n'
+          '       * a builtin class that has its (CPython) '
+          '"Py_TPFLAGS_SEQUENCE"\n'
+          '         bit set\n'
+          '\n'
+          '       * a class that inherits from any of the above\n'
+          '\n'
+          '    The following standard library classes are sequences:\n'
+          '\n'
+          '       * "array.array"\n'
+          '\n'
+          '       * "collections.deque"\n'
+          '\n'
+          '       * "list"\n'
+          '\n'
+          '       * "memoryview"\n'
+          '\n'
+          '       * "range"\n'
+          '\n'
+          '       * "tuple"\n'
+          '\n'
+          '    Note:\n'
+          '\n'
+          '      Subject values of type "str", "bytes", and "bytearray" do '
+          'not\n'
+          '      match sequence patterns.\n'
+          '\n'
+          '[3] In pattern matching, a mapping is defined as one of the '
+          'following:\n'
+          '\n'
+          '       * a class that inherits from "collections.abc.Mapping"\n'
+          '\n'
+          '       * a Python class that has been registered as\n'
+          '         "collections.abc.Mapping"\n'
+          '\n'
+          '       * a builtin class that has its (CPython) '
+          '"Py_TPFLAGS_MAPPING"\n'
+          '         bit set\n'
+          '\n'
+          '       * a class that inherits from any of the above\n'
+          '\n'
+          '    The standard library classes "dict" and '
+          '"types.MappingProxyType"\n'
+          '    are mappings.\n'
+          '\n'
+          '[4] A string literal appearing as the first statement in the '
           'function\n'
           '    body is transformed into the function’s "__doc__" attribute '
           'and\n'
           '    therefore the function’s *docstring*.\n'
           '\n'
-          '[3] A string literal appearing as the first statement in the class\n'
+          '[5] A string literal appearing as the first statement in the class\n'
           '    body is transformed into the namespace’s "__doc__" item and\n'
           '    therefore the class’s *docstring*.\n',
  'atom-identifiers': 'Identifiers (Names)\n'
@@ -884,32 +936,6 @@ topics = {'assert': 'The "assert" statement\n'
                      '*instance* of the\n'
                      '   owner class.\n'
                      '\n'
-                     'object.__set_name__(self, owner, name)\n'
-                     '\n'
-                     '   Called at the time the owning class *owner* is '
-                     'created. The\n'
-                     '   descriptor has been assigned to *name*.\n'
-                     '\n'
-                     '   Note:\n'
-                     '\n'
-                     '     "__set_name__()" is only called implicitly as part '
-                     'of the "type"\n'
-                     '     constructor, so it will need to be called '
-                     'explicitly with the\n'
-                     '     appropriate parameters when a descriptor is added '
-                     'to a class\n'
-                     '     after initial creation:\n'
-                     '\n'
-                     '        class A:\n'
-                     '           pass\n'
-                     '        descr = custom_descriptor()\n'
-                     '        A.attr = descr\n'
-                     "        descr.__set_name__(A, 'attr')\n"
-                     '\n'
-                     '     See Creating the class object for more details.\n'
-                     '\n'
-                     '   New in version 3.6.\n'
-                     '\n'
                      'The attribute "__objclass__" is interpreted by the '
                      '"inspect" module as\n'
                      'specifying the class where this object was defined '
@@ -988,9 +1014,9 @@ topics = {'assert': 'The "assert" statement\n'
                      '\n'
                      'For instance bindings, the precedence of descriptor '
                      'invocation depends\n'
-                     'on the which descriptor methods are defined.  A '
-                     'descriptor can define\n'
-                     'any combination of "__get__()", "__set__()" and '
+                     'on which descriptor methods are defined.  A descriptor '
+                     'can define any\n'
+                     'combination of "__get__()", "__set__()" and '
                      '"__delete__()".  If it\n'
                      'does not define "__get__()", then accessing the '
                      'attribute will return\n'
@@ -1261,6 +1287,10 @@ topics = {'assert': 'The "assert" statement\n'
            'In the latter case, sequence repetition is performed; a negative\n'
            'repetition factor yields an empty sequence.\n'
            '\n'
+           'This operation can be customized using the special "__mul__()" '
+           'and\n'
+           '"__rmul__()" methods.\n'
+           '\n'
            'The "@" (at) operator is intended to be used for matrix\n'
            'multiplication.  No builtin Python types implement this operator.\n'
            '\n'
@@ -1276,6 +1306,10 @@ topics = {'assert': 'The "assert" statement\n'
            'result.  Division by zero raises the "ZeroDivisionError" '
            'exception.\n'
            '\n'
+           'This operation can be customized using the special "__truediv__()" '
+           'and\n'
+           '"__floordiv__()" methods.\n'
+           '\n'
            'The "%" (modulo) operator yields the remainder from the division '
            'of\n'
            'the first argument by the second.  The numeric arguments are '
@@ -1307,6 +1341,10 @@ topics = {'assert': 'The "assert" statement\n'
            'string formatting is described in the Python Library Reference,\n'
            'section printf-style String Formatting.\n'
            '\n'
+           'The *modulo* operation can be customized using the special '
+           '"__mod__()"\n'
+           'method.\n'
+           '\n'
            'The floor division operator, the modulo operator, and the '
            '"divmod()"\n'
            'function are not defined for complex numbers.  Instead, convert to '
@@ -1321,9 +1359,16 @@ topics = {'assert': 'The "assert" statement\n'
            'and then added together. In the latter case, the sequences are\n'
            'concatenated.\n'
            '\n'
+           'This operation can be customized using the special "__add__()" '
+           'and\n'
+           '"__radd__()" methods.\n'
+           '\n'
            'The "-" (subtraction) operator yields the difference of its '
            'arguments.\n'
-           'The numeric arguments are first converted to a common type.\n',
+           'The numeric arguments are first converted to a common type.\n'
+           '\n'
+           'This operation can be customized using the special "__sub__()" '
+           'method.\n',
  'bitwise': 'Binary bitwise operations\n'
             '*************************\n'
             '\n'
@@ -1336,14 +1381,18 @@ topics = {'assert': 'The "assert" statement\n'
             '\n'
             'The "&" operator yields the bitwise AND of its arguments, which '
             'must\n'
-            'be integers.\n'
+            'be integers or one of them must be a custom object overriding\n'
+            '"__and__()" or "__rand__()" special methods.\n'
             '\n'
             'The "^" operator yields the bitwise XOR (exclusive OR) of its\n'
-            'arguments, which must be integers.\n'
+            'arguments, which must be integers or one of them must be a '
+            'custom\n'
+            'object overriding "__xor__()" or "__rxor__()" special methods.\n'
             '\n'
             'The "|" operator yields the bitwise (inclusive) OR of its '
             'arguments,\n'
-            'which must be integers.\n',
+            'which must be integers or one of them must be a custom object\n'
+            'overriding "__or__()" or "__ror__()" special methods.\n',
  'bltin-code-objects': 'Code Objects\n'
                        '************\n'
                        '\n'
@@ -1360,6 +1409,10 @@ topics = {'assert': 'The "assert" statement\n'
                        'through their "__code__" attribute. See also the '
                        '"code" module.\n'
                        '\n'
+                       'Accessing "__code__" raises an auditing event '
+                       '"object.__getattr__"\n'
+                       'with arguments "obj" and ""__code__"".\n'
+                       '\n'
                        'A code object can be executed or evaluated by passing '
                        'it (instead of a\n'
                        'source string) to the "exec()" or "eval()"  built-in '
@@ -1704,7 +1757,7 @@ topics = {'assert': 'The "assert" statement\n'
           'original global namespace. (Usually, the suite contains mostly\n'
           'function definitions.)  When the class’s suite finishes execution, '
           'its\n'
-          'execution frame is discarded but its local namespace is saved. [3] '
+          'execution frame is discarded but its local namespace is saved. [5] '
           'A\n'
           'class object is then created using the inheritance list for the '
           'base\n'
@@ -1785,7 +1838,11 @@ topics = {'assert': 'The "assert" statement\n'
                 '   comp_operator ::= "<" | ">" | "==" | ">=" | "<=" | "!="\n'
                 '                     | "is" ["not"] | ["not"] "in"\n'
                 '\n'
-                'Comparisons yield boolean values: "True" or "False".\n'
+                'Comparisons yield boolean values: "True" or "False". Custom '
+                '*rich\n'
+                'comparison methods* may return non-boolean values. In this '
+                'case Python\n'
+                'will call "bool()" on such value in boolean contexts.\n'
                 '\n'
                 'Comparisons can be chained arbitrarily, e.g., "x < y <= z" '
                 'is\n'
@@ -2381,11 +2438,11 @@ topics = {'assert': 'The "assert" statement\n'
              'resulting\n'
              'object is “compatible” with the exception.  An object is '
              'compatible\n'
-             'with an exception if it is the class or a base class of the '
-             'exception\n'
-             'object, or a tuple containing an item that is the class or a '
-             'base\n'
-             'class of the exception object.\n'
+             'with an exception if the object is the class or a base class of '
+             'the\n'
+             'exception object, or a tuple containing an item that is the '
+             'class or a\n'
+             'base class of the exception object.\n'
              '\n'
              'If no except clause matches the exception, the search for an '
              'exception\n'
@@ -2694,7 +2751,7 @@ topics = {'assert': 'The "assert" statement\n'
              '   subject_expr ::= star_named_expression "," '
              'star_named_expressions?\n'
              '                    | named_expression\n'
-             "   case_block   ::= 'case' patterns [guard] ':' block\n"
+             '   case_block   ::= \'case\' patterns [guard] ":" block\n'
              '\n'
              'Note:\n'
              '\n'
@@ -2764,7 +2821,7 @@ topics = {'assert': 'The "assert" statement\n'
              'have\n'
              '   happened.\n'
              '\n'
-             '   * If the guard evaluates as truthy or missing, the "block" '
+             '   * If the guard evaluates as true or is missing, the "block" '
              'inside\n'
              '     "case_block" is executed.\n'
              '\n'
@@ -2825,12 +2882,12 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              '2. If the pattern succeeded, evaluate the "guard".\n'
              '\n'
-             '   * If the "guard" condition evaluates to “truthy”, the case '
-             'block is\n'
+             '   * If the "guard" condition evaluates as true, the case block '
+             'is\n'
              '     selected.\n'
              '\n'
-             '   * If the "guard" condition evaluates to “falsy”, the case '
-             'block is\n'
+             '   * If the "guard" condition evaluates as false, the case block '
+             'is\n'
              '     not selected.\n'
              '\n'
              '   * If the "guard" raises an exception during evaluation, the\n'
@@ -3001,7 +3058,7 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'A single underscore "_" is not a capture pattern (this is what '
              '"!\'_\'"\n'
-             'expresses). And is instead treated as a "wildcard_pattern".\n'
+             'expresses). It is instead treated as a "wildcard_pattern".\n'
              '\n'
              'In a given pattern, a given name can only be bound once.  E.g. '
              '"case\n'
@@ -3029,7 +3086,10 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              "   wildcard_pattern ::= '_'\n"
              '\n'
-             '"_" is a soft keyword.\n'
+             '"_" is a soft keyword within any pattern, but only within '
+             'patterns.\n'
+             'It is an identifier, as usual, even within "match" subject\n'
+             'expressions, "guard"s, and "case" blocks.\n'
              '\n'
              'In simple terms, "_" will always succeed.\n'
              '\n'
@@ -3073,7 +3133,7 @@ topics = {'assert': 'The "assert" statement\n'
              'additional\n'
              'syntax. Syntax:\n'
              '\n'
-             "   group_pattern ::= '(' pattern ')'\n"
+             '   group_pattern ::= "(" pattern ")"\n'
              '\n'
              'In simple terms "(P)" has the same effect as "P".\n'
              '\n'
@@ -3120,8 +3180,9 @@ topics = {'assert': 'The "assert" statement\n'
              'pattern\n'
              'against a subject value:\n'
              '\n'
-             '1. If the subject value is not an instance of a\n'
-             '   "collections.abc.Sequence" the sequence pattern fails.\n'
+             '1. If the subject value is not a sequence [2], the sequence '
+             'pattern\n'
+             '   fails.\n'
              '\n'
              '2. If the subject value is an instance of "str", "bytes" or\n'
              '   "bytearray" the sequence pattern fails.\n'
@@ -3176,7 +3237,7 @@ topics = {'assert': 'The "assert" statement\n'
              'the\n'
              'following happens:\n'
              '\n'
-             '* "isinstance(<subject>, collections.abc.Sequence)"\n'
+             '* check "<subject>" is a sequence\n'
              '\n'
              '* "len(subject) == <N>"\n'
              '\n'
@@ -3210,18 +3271,19 @@ topics = {'assert': 'The "assert" statement\n'
              'double star pattern must be the last subpattern in the mapping\n'
              'pattern.\n'
              '\n'
-             'Duplicate key values in mapping patterns are disallowed. (If all '
-             'key\n'
-             'patterns are literal patterns this is considered a syntax '
-             'error;\n'
-             'otherwise this is a runtime error and will raise "ValueError".)\n'
+             'Duplicate keys in mapping patterns are disallowed. Duplicate '
+             'literal\n'
+             'keys will raise a "SyntaxError". Two keys that otherwise have '
+             'the same\n'
+             'value will raise a "ValueError" at runtime.\n'
              '\n'
              'The following is the logical flow for matching a mapping '
              'pattern\n'
              'against a subject value:\n'
              '\n'
-             '1. If the subject value is not an instance of\n'
-             '   "collections.abc.Mapping", the mapping pattern fails.\n'
+             '1. If the subject value is not a mapping [3],the mapping '
+             'pattern\n'
+             '   fails.\n'
              '\n'
              '2. If every key given in the mapping pattern is present in the '
              'subject\n'
@@ -3231,7 +3293,10 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              '3. If duplicate keys are detected in the mapping pattern, the '
              'pattern\n'
-             '   is considered invalid and "ValueError" is raised.\n'
+             '   is considered invalid. A "SyntaxError" is raised for '
+             'duplicate\n'
+             '   literal values; or a "ValueError" for named keys of the same '
+             'value.\n'
              '\n'
              'Note:\n'
              '\n'
@@ -3247,7 +3312,7 @@ topics = {'assert': 'The "assert" statement\n'
              'the\n'
              'following happens:\n'
              '\n'
-             '* "isinstance(<subject>, collections.abc.Mapping)"\n'
+             '* check "<subject>" is a mapping\n'
              '\n'
              '* "KEY1 in <subject>"\n'
              '\n'
@@ -3293,7 +3358,9 @@ topics = {'assert': 'The "assert" statement\n'
              '   For a number of built-in types (specified below), a single\n'
              '   positional subpattern is accepted which will match the '
              'entire\n'
-             '   subject; for these types no keyword patterns are accepted.\n'
+             '   subject; for these types keyword patterns also work as for '
+             'other\n'
+             '   types.\n'
              '\n'
              '   If only keyword patterns are present, they are processed as\n'
              '   follows, one by one:\n'
@@ -3324,15 +3391,14 @@ topics = {'assert': 'The "assert" statement\n'
              'class\n'
              '   "name_or_attr" before matching:\n'
              '\n'
-             '   I. The equivalent of "getattr(cls, "__match_args__", ())" '
-             'is\n'
+             '   I. The equivalent of "getattr(cls, "__match_args__", ())" is\n'
              '   called.\n'
              '\n'
              '      * If this raises an exception, the exception bubbles up.\n'
              '\n'
-             '      * If the returned value is not a list or tuple, the '
-             'conversion\n'
-             '        fails and "TypeError" is raised.\n'
+             '      * If the returned value is not a tuple, the conversion '
+             'fails and\n'
+             '        "TypeError" is raised.\n'
              '\n'
              '      * If there are more positional patterns than\n'
              '        "len(cls.__match_args__)", "TypeError" is raised.\n'
@@ -3426,7 +3492,6 @@ topics = {'assert': 'The "assert" statement\n'
              '   decorators                ::= decorator+\n'
              '   decorator                 ::= "@" assignment_expression '
              'NEWLINE\n'
-             '   dotted_name               ::= identifier ("." identifier)*\n'
              '   parameter_list            ::= defparameter ("," '
              'defparameter)* "," "/" ["," [parameter_list_no_posonly]]\n'
              '                        | parameter_list_no_posonly\n'
@@ -3451,7 +3516,7 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'The function definition does not execute the function body; this '
              'gets\n'
-             'executed only when the function is called. [2]\n'
+             'executed only when the function is called. [4]\n'
              '\n'
              'A function definition may be wrapped by one or more *decorator*\n'
              'expressions. Decorator expressions are evaluated when the '
@@ -3526,7 +3591,7 @@ topics = {'assert': 'The "assert" statement\n'
              'Calls.\n'
              'A function call always assigns values to all parameters '
              'mentioned in\n'
-             'the parameter list, either from position arguments, from '
+             'the parameter list, either from positional arguments, from '
              'keyword\n'
              'arguments, or from default values.  If the form “"*identifier"” '
              'is\n'
@@ -3538,8 +3603,14 @@ topics = {'assert': 'The "assert" statement\n'
              'new\n'
              'empty mapping of the same type.  Parameters after “"*"” or\n'
              '“"*identifier"” are keyword-only parameters and may only be '
-             'passed\n'
-             'used keyword arguments.\n'
+             'passed by\n'
+             'keyword arguments.  Parameters before “"/"” are positional-only\n'
+             'parameters and may only be passed by positional arguments.\n'
+             '\n'
+             'Changed in version 3.8: The "/" function parameter syntax may be '
+             'used\n'
+             'to indicate positional-only parameters. See **PEP 570** for '
+             'details.\n'
              '\n'
              'Parameters may have an *annotation* of the form “": '
              'expression"”\n'
@@ -3552,11 +3623,20 @@ topics = {'assert': 'The "assert" statement\n'
              'parameter list.  These annotations can be any valid Python '
              'expression.\n'
              'The presence of annotations does not change the semantics of a\n'
-             'function.  The annotation values are available as string values '
-             'in a\n'
+             'function.  The annotation values are available as values of a\n'
              'dictionary keyed by the parameters’ names in the '
              '"__annotations__"\n'
-             'attribute of the function object.\n'
+             'attribute of the function object.  If the "annotations" import '
+             'from\n'
+             '"__future__" is used, annotations are preserved as strings at '
+             'runtime\n'
+             'which enables postponed evaluation.  Otherwise, they are '
+             'evaluated\n'
+             'when the function definition is executed.  In this case '
+             'annotations\n'
+             'may be evaluated in a different order than they appear in the '
+             'source\n'
+             'code.\n'
              '\n'
              'It is also possible to create anonymous functions (functions not '
              'bound\n'
@@ -3641,7 +3721,7 @@ topics = {'assert': 'The "assert" statement\n'
              'function definitions.)  When the class’s suite finishes '
              'execution, its\n'
              'execution frame is discarded but its local namespace is saved. '
-             '[3] A\n'
+             '[5] A\n'
              'class object is then created using the inheritance list for the '
              'base\n'
              'classes and the saved local namespace for the attribute '
@@ -3845,13 +3925,65 @@ topics = {'assert': 'The "assert" statement\n'
              'exception.\n'
              '    That new exception causes the old one to be lost.\n'
              '\n'
-             '[2] A string literal appearing as the first statement in the '
+             '[2] In pattern matching, a sequence is defined as one of the\n'
+             '    following:\n'
+             '\n'
+             '       * a class that inherits from "collections.abc.Sequence"\n'
+             '\n'
+             '       * a Python class that has been registered as\n'
+             '         "collections.abc.Sequence"\n'
+             '\n'
+             '       * a builtin class that has its (CPython) '
+             '"Py_TPFLAGS_SEQUENCE"\n'
+             '         bit set\n'
+             '\n'
+             '       * a class that inherits from any of the above\n'
+             '\n'
+             '    The following standard library classes are sequences:\n'
+             '\n'
+             '       * "array.array"\n'
+             '\n'
+             '       * "collections.deque"\n'
+             '\n'
+             '       * "list"\n'
+             '\n'
+             '       * "memoryview"\n'
+             '\n'
+             '       * "range"\n'
+             '\n'
+             '       * "tuple"\n'
+             '\n'
+             '    Note:\n'
+             '\n'
+             '      Subject values of type "str", "bytes", and "bytearray" do '
+             'not\n'
+             '      match sequence patterns.\n'
+             '\n'
+             '[3] In pattern matching, a mapping is defined as one of the '
+             'following:\n'
+             '\n'
+             '       * a class that inherits from "collections.abc.Mapping"\n'
+             '\n'
+             '       * a Python class that has been registered as\n'
+             '         "collections.abc.Mapping"\n'
+             '\n'
+             '       * a builtin class that has its (CPython) '
+             '"Py_TPFLAGS_MAPPING"\n'
+             '         bit set\n'
+             '\n'
+             '       * a class that inherits from any of the above\n'
+             '\n'
+             '    The standard library classes "dict" and '
+             '"types.MappingProxyType"\n'
+             '    are mappings.\n'
+             '\n'
+             '[4] A string literal appearing as the first statement in the '
              'function\n'
              '    body is transformed into the function’s "__doc__" attribute '
              'and\n'
              '    therefore the function’s *docstring*.\n'
              '\n'
-             '[3] A string literal appearing as the first statement in the '
+             '[5] A string literal appearing as the first statement in the '
              'class\n'
              '    body is transformed into the namespace’s "__doc__" item and\n'
              '    therefore the class’s *docstring*.\n',
@@ -3989,13 +4121,13 @@ topics = {'assert': 'The "assert" statement\n'
                   '\n'
                   '   If "__new__()" is invoked during object construction and '
                   'it returns\n'
-                  '   an instance or subclass of *cls*, then the new '
-                  'instance’s\n'
-                  '   "__init__()" method will be invoked like '
-                  '"__init__(self[, ...])",\n'
-                  '   where *self* is the new instance and the remaining '
-                  'arguments are\n'
-                  '   the same as were passed to the object constructor.\n'
+                  '   an instance of *cls*, then the new instance’s '
+                  '"__init__()" method\n'
+                  '   will be invoked like "__init__(self[, ...])", where '
+                  '*self* is the\n'
+                  '   new instance and the remaining arguments are the same as '
+                  'were\n'
+                  '   passed to the object constructor.\n'
                   '\n'
                   '   If "__new__()" does not return an instance of *cls*, '
                   'then the new\n'
@@ -4703,13 +4835,18 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'If a file ".pdbrc" exists in the user’s home directory or in '
              'the\n'
-             'current directory, it is read in and executed as if it had been '
-             'typed\n'
-             'at the debugger prompt.  This is particularly useful for '
-             'aliases.  If\n'
-             'both files exist, the one in the home directory is read first '
-             'and\n'
-             'aliases defined there can be overridden by the local file.\n'
+             'current directory, it is read with "\'utf-8\'" encoding and '
+             'executed as\n'
+             'if it had been typed at the debugger prompt.  This is '
+             'particularly\n'
+             'useful for aliases.  If both files exist, the one in the home\n'
+             'directory is read first and aliases defined there can be '
+             'overridden by\n'
+             'the local file.\n'
+             '\n'
+             'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" '
+             'encoding.\n'
+             'Previously, it was read with the system locale encoding.\n'
              '\n'
              'Changed in version 3.2: ".pdbrc" can now contain commands that\n'
              'continue debugging, such as "continue" or "next".  Previously, '
@@ -6075,19 +6212,19 @@ topics = {'assert': 'The "assert" statement\n'
                   'complex\n'
                   'types. For integers, when binary, octal, or hexadecimal '
                   'output is\n'
-                  'used, this option adds the prefix respective "\'0b\'", '
-                  '"\'0o\'", or "\'0x\'"\n'
-                  'to the output value. For float and complex the alternate '
-                  'form causes\n'
-                  'the result of the conversion to always contain a '
-                  'decimal-point\n'
-                  'character, even if no digits follow it. Normally, a '
-                  'decimal-point\n'
-                  'character appears in the result of these conversions only '
-                  'if a digit\n'
-                  'follows it. In addition, for "\'g\'" and "\'G\'" '
-                  'conversions, trailing\n'
-                  'zeros are not removed from the result.\n'
+                  'used, this option adds the respective prefix "\'0b\'", '
+                  '"\'0o\'", "\'0x\'",\n'
+                  'or "\'0X\'" to the output value. For float and complex the '
+                  'alternate\n'
+                  'form causes the result of the conversion to always contain '
+                  'a decimal-\n'
+                  'point character, even if no digits follow it. Normally, a '
+                  'decimal-\n'
+                  'point character appears in the result of these conversions '
+                  'only if a\n'
+                  'digit follows it. In addition, for "\'g\'" and "\'G\'" '
+                  'conversions,\n'
+                  'trailing zeros are not removed from the result.\n'
                   '\n'
                   'The "\',\'" option signals the use of a comma for a '
                   'thousands separator.\n'
@@ -6204,8 +6341,12 @@ topics = {'assert': 'The "assert" statement\n'
                   '+-----------+------------------------------------------------------------+\n'
                   '   | "\'X\'"     | Hex format. Outputs the number in base '
                   '16, using upper-    |\n'
-                  '   |           | case letters for the digits above '
-                  '9.                       |\n'
+                  '   |           | case letters for the digits above 9. In '
+                  'case "\'#\'" is      |\n'
+                  '   |           | specified, the prefix "\'0x\'" will be '
+                  'upper-cased to "\'0X\'" |\n'
+                  '   |           | as '
+                  'well.                                                   |\n'
                   '   '
                   '+-----------+------------------------------------------------------------+\n'
                   '   | "\'n\'"     | Number. This is the same as "\'d\'", '
@@ -6562,7 +6703,6 @@ topics = {'assert': 'The "assert" statement\n'
              '   decorators                ::= decorator+\n'
              '   decorator                 ::= "@" assignment_expression '
              'NEWLINE\n'
-             '   dotted_name               ::= identifier ("." identifier)*\n'
              '   parameter_list            ::= defparameter ("," '
              'defparameter)* "," "/" ["," [parameter_list_no_posonly]]\n'
              '                        | parameter_list_no_posonly\n'
@@ -6587,7 +6727,7 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'The function definition does not execute the function body; this '
              'gets\n'
-             'executed only when the function is called. [2]\n'
+             'executed only when the function is called. [4]\n'
              '\n'
              'A function definition may be wrapped by one or more *decorator*\n'
              'expressions. Decorator expressions are evaluated when the '
@@ -6662,7 +6802,7 @@ topics = {'assert': 'The "assert" statement\n'
              'Calls.\n'
              'A function call always assigns values to all parameters '
              'mentioned in\n'
-             'the parameter list, either from position arguments, from '
+             'the parameter list, either from positional arguments, from '
              'keyword\n'
              'arguments, or from default values.  If the form “"*identifier"” '
              'is\n'
@@ -6674,8 +6814,14 @@ topics = {'assert': 'The "assert" statement\n'
              'new\n'
              'empty mapping of the same type.  Parameters after “"*"” or\n'
              '“"*identifier"” are keyword-only parameters and may only be '
-             'passed\n'
-             'used keyword arguments.\n'
+             'passed by\n'
+             'keyword arguments.  Parameters before “"/"” are positional-only\n'
+             'parameters and may only be passed by positional arguments.\n'
+             '\n'
+             'Changed in version 3.8: The "/" function parameter syntax may be '
+             'used\n'
+             'to indicate positional-only parameters. See **PEP 570** for '
+             'details.\n'
              '\n'
              'Parameters may have an *annotation* of the form “": '
              'expression"”\n'
@@ -6688,11 +6834,20 @@ topics = {'assert': 'The "assert" statement\n'
              'parameter list.  These annotations can be any valid Python '
              'expression.\n'
              'The presence of annotations does not change the semantics of a\n'
-             'function.  The annotation values are available as string values '
-             'in a\n'
+             'function.  The annotation values are available as values of a\n'
              'dictionary keyed by the parameters’ names in the '
              '"__annotations__"\n'
-             'attribute of the function object.\n'
+             'attribute of the function object.  If the "annotations" import '
+             'from\n'
+             '"__future__" is used, annotations are preserved as strings at '
+             'runtime\n'
+             'which enables postponed evaluation.  Otherwise, they are '
+             'evaluated\n'
+             'when the function definition is executed.  In this case '
+             'annotations\n'
+             'may be evaluated in a different order than they appear in the '
+             'source\n'
+             'code.\n'
              '\n'
              'It is also possible to create anonymous functions (functions not '
              'bound\n'
@@ -6909,8 +7064,8 @@ topics = {'assert': 'The "assert" statement\n'
                 '\n'
                 'A non-normative HTML file listing all valid identifier '
                 'characters for\n'
-                'Unicode 4.1 can be found at\n'
-                'https://www.unicode.org/Public/13.0.0/ucd/DerivedCoreProperties.txt\n'
+                'Unicode 14.0.0 can be found at\n'
+                'https://www.unicode.org/Public/14.0.0/ucd/DerivedCoreProperties.txt\n'
                 '\n'
                 '\n'
                 'Keywords\n'
@@ -7051,7 +7206,7 @@ topics = {'assert': 'The "assert" statement\n'
            '                   | "from" relative_module "import" "(" '
            'identifier ["as" identifier]\n'
            '                   ("," identifier ["as" identifier])* [","] ")"\n'
-           '                   | "from" module "import" "*"\n'
+           '                   | "from" relative_module "import" "*"\n'
            '   module          ::= (identifier ".")* identifier\n'
            '   relative_module ::= "."* module | "."+\n'
            '\n'
@@ -7395,10 +7550,7 @@ topics = {'assert': 'The "assert" statement\n'
  'lambda': 'Lambdas\n'
            '*******\n'
            '\n'
-           '   lambda_expr        ::= "lambda" [parameter_list] ":" '
-           'expression\n'
-           '   lambda_expr_nocond ::= "lambda" [parameter_list] ":" '
-           'expression_nocond\n'
+           '   lambda_expr ::= "lambda" [parameter_list] ":" expression\n'
            '\n'
            'Lambda expressions (sometimes called lambda forms) are used to '
            'create\n'
@@ -7715,11 +7867,11 @@ topics = {'assert': 'The "assert" statement\n'
                   'instance, to\n'
                   '   evaluate the expression "x + y", where *x* is an '
                   'instance of a\n'
-                  '   class that has an "__add__()" method, "x.__add__(y)" is '
-                  'called.\n'
-                  '   The "__divmod__()" method should be the equivalent to '
-                  'using\n'
-                  '   "__floordiv__()" and "__mod__()"; it should not be '
+                  '   class that has an "__add__()" method, '
+                  '"type(x).__add__(x, y)" is\n'
+                  '   called.  The "__divmod__()" method should be the '
+                  'equivalent to\n'
+                  '   using "__floordiv__()" and "__mod__()"; it should not be '
                   'related to\n'
                   '   "__truediv__()".  Note that "__pow__()" should be '
                   'defined to accept\n'
@@ -7760,9 +7912,9 @@ topics = {'assert': 'The "assert" statement\n'
                   'expression "x -\n'
                   '   y", where *y* is an instance of a class that has an '
                   '"__rsub__()"\n'
-                  '   method, "y.__rsub__(x)" is called if "x.__sub__(y)" '
-                  'returns\n'
-                  '   *NotImplemented*.\n'
+                  '   method, "type(y).__rsub__(y, x)" is called if '
+                  '"type(x).__sub__(x,\n'
+                  '   y)" returns *NotImplemented*.\n'
                   '\n'
                   '   Note that ternary "pow()" will not try calling '
                   '"__rpow__()" (the\n'
@@ -8009,8 +8161,8 @@ topics = {'assert': 'The "assert" statement\n'
                      '\n'
                      'The following table summarizes the operator precedence '
                      'in Python, from\n'
-                     'lowest precedence (least binding) to highest precedence '
-                     '(most\n'
+                     'highest precedence (most binding) to lowest precedence '
+                     '(least\n'
                      'binding).  Operators in the same box have the same '
                      'precedence.  Unless\n'
                      'the syntax is explicitly given, operators are binary.  '
@@ -8029,71 +8181,71 @@ topics = {'assert': 'The "assert" statement\n'
                      '| Operator                                        | '
                      'Description                           |\n'
                      '|=================================================|=======================================|\n'
-                     '| ":="                                            | '
-                     'Assignment expression                 |\n'
-                     '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "lambda"                                        | '
-                     'Lambda expression                     |\n'
+                     '| "(expressions...)",  "[expressions...]", "{key: | '
+                     'Binding or parenthesized expression,  |\n'
+                     '| value...}", "{expressions...}"                  | list '
+                     'display, dictionary display, set |\n'
+                     '|                                                 | '
+                     'display                               |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "if" – "else"                                   | '
-                     'Conditional expression                |\n'
+                     '| "x[index]", "x[index:index]",                   | '
+                     'Subscription, slicing, call,          |\n'
+                     '| "x(arguments...)", "x.attribute"                | '
+                     'attribute reference                   |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "or"                                            | '
-                     'Boolean OR                            |\n'
+                     '| "await" "x"                                     | '
+                     'Await expression                      |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "and"                                           | '
-                     'Boolean AND                           |\n'
+                     '| "**"                                            | '
+                     'Exponentiation [5]                    |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "not" "x"                                       | '
-                     'Boolean NOT                           |\n'
+                     '| "+x", "-x", "~x"                                | '
+                     'Positive, negative, bitwise NOT       |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "in", "not in", "is", "is not", "<", "<=", ">", | '
-                     'Comparisons, including membership     |\n'
-                     '| ">=", "!=", "=="                                | '
-                     'tests and identity tests              |\n'
+                     '| "*", "@", "/", "//", "%"                        | '
+                     'Multiplication, matrix                |\n'
+                     '|                                                 | '
+                     'multiplication, division, floor       |\n'
+                     '|                                                 | '
+                     'division, remainder [6]               |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "|"                                             | '
-                     'Bitwise OR                            |\n'
+                     '| "+", "-"                                        | '
+                     'Addition and subtraction              |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "^"                                             | '
-                     'Bitwise XOR                           |\n'
+                     '| "<<", ">>"                                      | '
+                     'Shifts                                |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
                      '| "&"                                             | '
                      'Bitwise AND                           |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "<<", ">>"                                      | '
-                     'Shifts                                |\n'
+                     '| "^"                                             | '
+                     'Bitwise XOR                           |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "+", "-"                                        | '
-                     'Addition and subtraction              |\n'
+                     '| "|"                                             | '
+                     'Bitwise OR                            |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "*", "@", "/", "//", "%"                        | '
-                     'Multiplication, matrix                |\n'
-                     '|                                                 | '
-                     'multiplication, division, floor       |\n'
-                     '|                                                 | '
-                     'division, remainder [5]               |\n'
+                     '| "in", "not in", "is", "is not", "<", "<=", ">", | '
+                     'Comparisons, including membership     |\n'
+                     '| ">=", "!=", "=="                                | '
+                     'tests and identity tests              |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "+x", "-x", "~x"                                | '
-                     'Positive, negative, bitwise NOT       |\n'
+                     '| "not" "x"                                       | '
+                     'Boolean NOT                           |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "**"                                            | '
-                     'Exponentiation [6]                    |\n'
+                     '| "and"                                           | '
+                     'Boolean AND                           |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "await" "x"                                     | '
-                     'Await expression                      |\n'
+                     '| "or"                                            | '
+                     'Boolean OR                            |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "x[index]", "x[index:index]",                   | '
-                     'Subscription, slicing, call,          |\n'
-                     '| "x(arguments...)", "x.attribute"                | '
-                     'attribute reference                   |\n'
+                     '| "if" – "else"                                   | '
+                     'Conditional expression                |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
-                     '| "(expressions...)",  "[expressions...]", "{key: | '
-                     'Binding or parenthesized expression,  |\n'
-                     '| value...}", "{expressions...}"                  | list '
-                     'display, dictionary display, set |\n'
-                     '|                                                 | '
-                     'display                               |\n'
+                     '| "lambda"                                        | '
+                     'Lambda expression                     |\n'
+                     '+-------------------------------------------------+---------------------------------------+\n'
+                     '| ":="                                            | '
+                     'Assignment expression                 |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
                      '\n'
                      '-[ Footnotes ]-\n'
@@ -8174,14 +8326,14 @@ topics = {'assert': 'The "assert" statement\n'
                      'Check their\n'
                      '    documentation for more info.\n'
                      '\n'
-                     '[5] The "%" operator is also used for string formatting; '
-                     'the same\n'
-                     '    precedence applies.\n'
-                     '\n'
-                     '[6] The power operator "**" binds less tightly than an '
+                     '[5] The power operator "**" binds less tightly than an '
                      'arithmetic or\n'
                      '    bitwise unary operator on its right, that is, '
-                     '"2**-1" is "0.5".\n',
+                     '"2**-1" is "0.5".\n'
+                     '\n'
+                     '[6] The "%" operator is also used for string formatting; '
+                     'the same\n'
+                     '    precedence applies.\n',
  'pass': 'The "pass" statement\n'
          '********************\n'
          '\n'
@@ -8229,7 +8381,10 @@ topics = {'assert': 'The "assert" statement\n'
           '"ZeroDivisionError".\n'
           'Raising a negative number to a fractional power results in a '
           '"complex"\n'
-          'number. (In earlier versions it raised a "ValueError".)\n',
+          'number. (In earlier versions it raised a "ValueError".)\n'
+          '\n'
+          'This operation can be customized using the special "__pow__()" '
+          'method.\n',
  'raise': 'The "raise" statement\n'
           '*********************\n'
           '\n'
@@ -8266,12 +8421,18 @@ topics = {'assert': 'The "assert" statement\n'
           '\n'
           'The "from" clause is used for exception chaining: if given, the '
           'second\n'
-          '*expression* must be another exception class or instance, which '
-          'will\n'
-          'then be attached to the raised exception as the "__cause__" '
-          'attribute\n'
-          '(which is writable).  If the raised exception is not handled, both\n'
-          'exceptions will be printed:\n'
+          '*expression* must be another exception class or instance. If the\n'
+          'second expression is an exception instance, it will be attached to '
+          'the\n'
+          'raised exception as the "__cause__" attribute (which is writable). '
+          'If\n'
+          'the expression is an exception class, the class will be '
+          'instantiated\n'
+          'and the resulting exception instance will be attached to the '
+          'raised\n'
+          'exception as the "__cause__" attribute. If the raised exception is '
+          'not\n'
+          'handled, both exceptions will be printed:\n'
           '\n'
           '   >>> try:\n'
           '   ...     print(1 / 0)\n'
@@ -8623,6 +8784,10 @@ topics = {'assert': 'The "assert" statement\n'
              'the\n'
              'second argument.\n'
              '\n'
+             'This operation can be customized using the special '
+             '"__lshift__()" and\n'
+             '"__rshift__()" methods.\n'
+             '\n'
              'A right shift by *n* bits is defined as floor division by '
              '"pow(2,n)".\n'
              'A left shift by *n* bits is defined as multiplication with '
@@ -8837,13 +9002,13 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  '   If "__new__()" is invoked during object construction and '
                  'it returns\n'
-                 '   an instance or subclass of *cls*, then the new '
-                 'instance’s\n'
-                 '   "__init__()" method will be invoked like "__init__(self[, '
-                 '...])",\n'
-                 '   where *self* is the new instance and the remaining '
-                 'arguments are\n'
-                 '   the same as were passed to the object constructor.\n'
+                 '   an instance of *cls*, then the new instance’s '
+                 '"__init__()" method\n'
+                 '   will be invoked like "__init__(self[, ...])", where '
+                 '*self* is the\n'
+                 '   new instance and the remaining arguments are the same as '
+                 'were\n'
+                 '   passed to the object constructor.\n'
                  '\n'
                  '   If "__new__()" does not return an instance of *cls*, then '
                  'the new\n'
@@ -9511,32 +9676,6 @@ topics = {'assert': 'The "assert" statement\n'
                  'of the\n'
                  '   owner class.\n'
                  '\n'
-                 'object.__set_name__(self, owner, name)\n'
-                 '\n'
-                 '   Called at the time the owning class *owner* is created. '
-                 'The\n'
-                 '   descriptor has been assigned to *name*.\n'
-                 '\n'
-                 '   Note:\n'
-                 '\n'
-                 '     "__set_name__()" is only called implicitly as part of '
-                 'the "type"\n'
-                 '     constructor, so it will need to be called explicitly '
-                 'with the\n'
-                 '     appropriate parameters when a descriptor is added to a '
-                 'class\n'
-                 '     after initial creation:\n'
-                 '\n'
-                 '        class A:\n'
-                 '           pass\n'
-                 '        descr = custom_descriptor()\n'
-                 '        A.attr = descr\n'
-                 "        descr.__set_name__(A, 'attr')\n"
-                 '\n'
-                 '     See Creating the class object for more details.\n'
-                 '\n'
-                 '   New in version 3.6.\n'
-                 '\n'
                  'The attribute "__objclass__" is interpreted by the "inspect" '
                  'module as\n'
                  'specifying the class where this object was defined (setting '
@@ -9613,10 +9752,10 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  'For instance bindings, the precedence of descriptor '
                  'invocation depends\n'
-                 'on the which descriptor methods are defined.  A descriptor '
-                 'can define\n'
-                 'any combination of "__get__()", "__set__()" and '
-                 '"__delete__()".  If it\n'
+                 'on which descriptor methods are defined.  A descriptor can '
+                 'define any\n'
+                 'combination of "__get__()", "__set__()" and "__delete__()".  '
+                 'If it\n'
                  'does not define "__get__()", then accessing the attribute '
                  'will return\n'
                  'the descriptor object itself unless there is a value in the '
@@ -9826,6 +9965,38 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  '   New in version 3.6.\n'
                  '\n'
+                 'When a class is created, "type.__new__()" scans the class '
+                 'variables\n'
+                 'and makes callbacks to those with a "__set_name__()" hook.\n'
+                 '\n'
+                 'object.__set_name__(self, owner, name)\n'
+                 '\n'
+                 '   Automatically called at the time the owning class *owner* '
+                 'is\n'
+                 '   created. The object has been assigned to *name* in that '
+                 'class:\n'
+                 '\n'
+                 '      class A:\n'
+                 '          x = C()  # Automatically calls: x.__set_name__(A, '
+                 "'x')\n"
+                 '\n'
+                 '   If the class variable is assigned after the class is '
+                 'created,\n'
+                 '   "__set_name__()" will not be called automatically. If '
+                 'needed,\n'
+                 '   "__set_name__()" can be called directly:\n'
+                 '\n'
+                 '      class A:\n'
+                 '         pass\n'
+                 '\n'
+                 '      c = C()\n'
+                 '      A.x = c                  # The hook is not called\n'
+                 "      c.__set_name__(A, 'x')   # Manually invoke the hook\n"
+                 '\n'
+                 '   See Creating the class object for more details.\n'
+                 '\n'
+                 '   New in version 3.6.\n'
+                 '\n'
                  '\n'
                  'Metaclasses\n'
                  '-----------\n'
@@ -10021,22 +10192,21 @@ topics = {'assert': 'The "assert" statement\n'
                  'When using the default metaclass "type", or any metaclass '
                  'that\n'
                  'ultimately calls "type.__new__", the following additional\n'
-                 'customisation steps are invoked after creating the class '
+                 'customization steps are invoked after creating the class '
                  'object:\n'
                  '\n'
-                 '* first, "type.__new__" collects all of the descriptors in '
-                 'the class\n'
-                 '  namespace that define a "__set_name__()" method;\n'
+                 '1. The "type.__new__" method collects all of the attributes '
+                 'in the\n'
+                 '   class namespace that define a "__set_name__()" method;\n'
                  '\n'
-                 '* second, all of these "__set_name__" methods are called '
-                 'with the\n'
-                 '  class being defined and the assigned name of that '
-                 'particular\n'
-                 '  descriptor;\n'
+                 '2. Those "__set_name__" methods are called with the class '
+                 'being\n'
+                 '   defined and the assigned name of that particular '
+                 'attribute;\n'
                  '\n'
-                 '* finally, the "__init_subclass__()" hook is called on the '
-                 'immediate\n'
-                 '  parent of the new class in its method resolution order.\n'
+                 '3. The "__init_subclass__()" hook is called on the immediate '
+                 'parent of\n'
+                 '   the new class in its method resolution order.\n'
                  '\n'
                  'After the class object is created, it is passed to the '
                  'class\n'
@@ -10437,11 +10607,11 @@ topics = {'assert': 'The "assert" statement\n'
                  'to\n'
                  '   evaluate the expression "x + y", where *x* is an instance '
                  'of a\n'
-                 '   class that has an "__add__()" method, "x.__add__(y)" is '
-                 'called.\n'
-                 '   The "__divmod__()" method should be the equivalent to '
-                 'using\n'
-                 '   "__floordiv__()" and "__mod__()"; it should not be '
+                 '   class that has an "__add__()" method, "type(x).__add__(x, '
+                 'y)" is\n'
+                 '   called.  The "__divmod__()" method should be the '
+                 'equivalent to\n'
+                 '   using "__floordiv__()" and "__mod__()"; it should not be '
                  'related to\n'
                  '   "__truediv__()".  Note that "__pow__()" should be defined '
                  'to accept\n'
@@ -10482,9 +10652,9 @@ topics = {'assert': 'The "assert" statement\n'
                  'expression "x -\n'
                  '   y", where *y* is an instance of a class that has an '
                  '"__rsub__()"\n'
-                 '   method, "y.__rsub__(x)" is called if "x.__sub__(y)" '
-                 'returns\n'
-                 '   *NotImplemented*.\n'
+                 '   method, "type(y).__rsub__(y, x)" is called if '
+                 '"type(x).__sub__(x,\n'
+                 '   y)" returns *NotImplemented*.\n'
                  '\n'
                  '   Note that ternary "pow()" will not try calling '
                  '"__rpow__()" (the\n'
@@ -10677,17 +10847,16 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  'object.__match_args__\n'
                  '\n'
-                 '   This class variable can be assigned a tuple or list of '
-                 'strings.\n'
-                 '   When this class is used in a class pattern with '
-                 'positional\n'
-                 '   arguments, each positional argument will be converted '
-                 'into a\n'
-                 '   keyword argument, using the corresponding value in '
-                 '*__match_args__*\n'
-                 '   as the keyword. The absence of this attribute is '
-                 'equivalent to\n'
-                 '   setting it to "()".\n'
+                 '   This class variable can be assigned a tuple of strings. '
+                 'When this\n'
+                 '   class is used in a class pattern with positional '
+                 'arguments, each\n'
+                 '   positional argument will be converted into a keyword '
+                 'argument,\n'
+                 '   using the corresponding value in *__match_args__* as the '
+                 'keyword.\n'
+                 '   The absence of this attribute is equivalent to setting it '
+                 'to "()".\n'
                  '\n'
                  'For example, if "MyClass.__match_args__" is "("left", '
                  '"center",\n'
@@ -12078,10 +12247,10 @@ topics = {'assert': 'The "assert" statement\n'
         'exception.  For an except clause with an expression, that expression\n'
         'is evaluated, and the clause matches the exception if the resulting\n'
         'object is “compatible” with the exception.  An object is compatible\n'
-        'with an exception if it is the class or a base class of the '
-        'exception\n'
-        'object, or a tuple containing an item that is the class or a base\n'
-        'class of the exception object.\n'
+        'with an exception if the object is the class or a base class of the\n'
+        'exception object, or a tuple containing an item that is the class or '
+        'a\n'
+        'base class of the exception object.\n'
         '\n'
         'If no except clause matches the exception, the search for an '
         'exception\n'
@@ -12680,7 +12849,13 @@ topics = {'assert': 'The "assert" statement\n'
           '|             |\n'
           '      |                           | and "\'return\'" for the '
           'return   |             |\n'
-          '      |                           | annotation, if provided.        '
+          '      |                           | annotation, if provided.  For   '
+          '|             |\n'
+          '      |                           | more information on working     '
+          '|             |\n'
+          '      |                           | with this attribute, see        '
+          '|             |\n'
+          '      |                           | Annotations Best Practices.     '
           '|             |\n'
           '      '
           '+---------------------------+---------------------------------+-------------+\n'
@@ -12905,20 +13080,34 @@ topics = {'assert': 'The "assert" statement\n'
           '   Attribute assignment updates the module’s namespace dictionary,\n'
           '   e.g., "m.x = 1" is equivalent to "m.__dict__["x"] = 1".\n'
           '\n'
-          '   Predefined (writable) attributes: "__name__" is the module’s '
-          'name;\n'
-          '   "__doc__" is the module’s documentation string, or "None" if\n'
-          '   unavailable; "__annotations__" (optional) is a dictionary\n'
-          '   containing *variable annotations* collected during module body\n'
-          '   execution; "__file__" is the pathname of the file from which '
+          '   Predefined (writable) attributes:\n'
+          '\n'
+          '      "__name__"\n'
+          '         The module’s name.\n'
+          '\n'
+          '      "__doc__"\n'
+          '         The module’s documentation string, or "None" if '
+          'unavailable.\n'
+          '\n'
+          '      "__file__"\n'
+          '         The pathname of the file from which the module was loaded, '
+          'if\n'
+          '         it was loaded from a file. The "__file__" attribute may '
+          'be\n'
+          '         missing for certain types of modules, such as C modules '
+          'that\n'
+          '         are statically linked into the interpreter.  For '
+          'extension\n'
+          '         modules loaded dynamically from a shared library, it’s '
           'the\n'
-          '   module was loaded, if it was loaded from a file. The "__file__"\n'
-          '   attribute may be missing for certain types of modules, such as '
-          'C\n'
-          '   modules that are statically linked into the interpreter; for\n'
-          '   extension modules loaded dynamically from a shared library, it '
-          'is\n'
-          '   the pathname of the shared library file.\n'
+          '         pathname of the shared library file.\n'
+          '\n'
+          '      "__annotations__"\n'
+          '         A dictionary containing *variable annotations* collected\n'
+          '         during module body execution.  For best practices on '
+          'working\n'
+          '         with "__annotations__", please see Annotations Best\n'
+          '         Practices.\n'
           '\n'
           '   Special read-only attribute: "__dict__" is the module’s '
           'namespace\n'
@@ -12976,20 +13165,31 @@ topics = {'assert': 'The "assert" statement\n'
           'instance\n'
           '   (see below).\n'
           '\n'
-          '   Special attributes: "__name__" is the class name; "__module__" '
-          'is\n'
-          '   the module name in which the class was defined; "__dict__" is '
-          'the\n'
-          '   dictionary containing the class’s namespace; "__bases__" is a '
-          'tuple\n'
-          '   containing the base classes, in the order of their occurrence '
-          'in\n'
-          '   the base class list; "__doc__" is the class’s documentation '
-          'string,\n'
-          '   or "None" if undefined; "__annotations__" (optional) is a\n'
-          '   dictionary containing *variable annotations* collected during '
-          'class\n'
-          '   body execution.\n'
+          '   Special attributes:\n'
+          '\n'
+          '      "__name__"\n'
+          '         The class name.\n'
+          '\n'
+          '      "__module__"\n'
+          '         The name of the module in which the class was defined.\n'
+          '\n'
+          '      "__dict__"\n'
+          '         The dictionary containing the class’s namespace.\n'
+          '\n'
+          '      "__bases__"\n'
+          '         A tuple containing the base classes, in the order of '
+          'their\n'
+          '         occurrence in the base class list.\n'
+          '\n'
+          '      "__doc__"\n'
+          '         The class’s documentation string, or "None" if undefined.\n'
+          '\n'
+          '      "__annotations__"\n'
+          '         A dictionary containing *variable annotations* collected\n'
+          '         during class body execution.  For best practices on '
+          'working\n'
+          '         with "__annotations__", please see Annotations Best\n'
+          '         Practices.\n'
           '\n'
           'Class instances\n'
           '   A class instance is created by calling a class object (see '
@@ -13072,6 +13272,7 @@ topics = {'assert': 'The "assert" statement\n'
           '\n'
           '      Special read-only attributes: "co_name" gives the function '
           'name;\n'
+          '      "co_qualname" gives the fully qualified function name;\n'
           '      "co_argcount" is the total number of positional arguments\n'
           '      (including positional-only arguments and arguments with '
           'default\n'
@@ -13132,6 +13333,54 @@ topics = {'assert': 'The "assert" statement\n'
           '      "co_consts" is the documentation string of the function, or\n'
           '      "None" if undefined.\n'
           '\n'
+          '      codeobject.co_positions()\n'
+          '\n'
+          '         Returns an iterable over the source code positions of '
+          'each\n'
+          '         bytecode instruction in the code object.\n'
+          '\n'
+          '         The iterator returns tuples containing the "(start_line,\n'
+          '         end_line, start_column, end_column)". The *i-th* tuple\n'
+          '         corresponds to the position of the source code that '
+          'compiled\n'
+          '         to the *i-th* instruction. Column information is '
+          '0-indexed\n'
+          '         utf-8 byte offsets on the given source line.\n'
+          '\n'
+          '         This positional information can be missing. A '
+          'non-exhaustive\n'
+          '         lists of cases where this may happen:\n'
+          '\n'
+          '         * Running the interpreter with "-X" "no_debug_ranges".\n'
+          '\n'
+          '         * Loading a pyc file compiled while using "-X"\n'
+          '           "no_debug_ranges".\n'
+          '\n'
+          '         * Position tuples corresponding to artificial '
+          'instructions.\n'
+          '\n'
+          '         * Line and column numbers that can’t be represented due '
+          'to\n'
+          '           implementation specific limitations.\n'
+          '\n'
+          '         When this occurs, some or all of the tuple elements can '
+          'be\n'
+          '         "None".\n'
+          '\n'
+          '         New in version 3.11.\n'
+          '\n'
+          '         Note:\n'
+          '\n'
+          '           This feature requires storing column positions in code\n'
+          '           objects which may result in a small increase of disk '
+          'usage\n'
+          '           of compiled Python files or interpreter memory usage. '
+          'To\n'
+          '           avoid storing the extra information and/or deactivate\n'
+          '           printing the extra traceback information, the "-X"\n'
+          '           "no_debug_ranges" command line flag or the\n'
+          '           "PYTHONNODEBUGRANGES" environment variable can be used.\n'
+          '\n'
           '   Frame objects\n'
           '      Frame objects represent execution frames.  They may occur in\n'
           '      traceback objects (see below), and are also passed to '
@@ -13150,6 +13399,10 @@ topics = {'assert': 'The "assert" statement\n'
           '      gives the precise instruction (this is an index into the\n'
           '      bytecode string of the code object).\n'
           '\n'
+          '      Accessing "f_code" raises an auditing event '
+          '"object.__getattr__"\n'
+          '      with arguments "obj" and ""f_code"".\n'
+          '\n'
           '      Special writable attributes: "f_trace", if not "None", is a\n'
           '      function called for various events during code execution '
           '(this\n'
@@ -13233,6 +13486,9 @@ topics = {'assert': 'The "assert" statement\n'
           '      the exception occurred in a "try" statement with no matching\n'
           '      except clause or with a finally clause.\n'
           '\n'
+          '      Accessing "tb_frame" raises an auditing event\n'
+          '      "object.__getattr__" with arguments "obj" and ""tb_frame"".\n'
+          '\n'
           '      Special writable attribute: "tb_next" is the next level in '
           'the\n'
           '      stack trace (towards the frame where the exception occurred), '
@@ -13283,9 +13539,8 @@ topics = {'assert': 'The "assert" statement\n'
           '      object actually returned is the wrapped object, which is not\n'
           '      subject to any further transformation. Static method objects '
           'are\n'
-          '      not themselves callable, although the objects they wrap '
-          'usually\n'
-          '      are. Static method objects are created by the built-in\n'
+          '      also callable. Static method objects are created by the '
+          'built-in\n'
           '      "staticmethod()" constructor.\n'
           '\n'
           '   Class method objects\n'
@@ -14237,7 +14492,7 @@ topics = {'assert': 'The "assert" statement\n'
              '|                                | "s[i:i] = '
              '[x]")                  |                       |\n'
              '+--------------------------------+----------------------------------+-----------------------+\n'
-             '| "s.pop([i])"                   | retrieves the item at *i* '
+             '| "s.pop()" or "s.pop(i)"        | retrieves the item at *i* '
              'and    | (2)                   |\n'
              '|                                | also removes it from '
              '*s*         |                       |\n'
@@ -14700,7 +14955,7 @@ topics = {'assert': 'The "assert" statement\n'
                      '|                                | "s[i:i] = '
                      '[x]")                  |                       |\n'
                      '+--------------------------------+----------------------------------+-----------------------+\n'
-                     '| "s.pop([i])"                   | retrieves the item at '
+                     '| "s.pop()" or "s.pop(i)"        | retrieves the item at '
                      '*i* and    | (2)                   |\n'
                      '|                                | also removes it from '
                      '*s*         |                       |\n'
@@ -14765,15 +15020,21 @@ topics = {'assert': 'The "assert" statement\n'
           '   u_expr ::= power | "-" u_expr | "+" u_expr | "~" u_expr\n'
           '\n'
           'The unary "-" (minus) operator yields the negation of its numeric\n'
-          'argument.\n'
+          'argument; the operation can be overridden with the "__neg__()" '
+          'special\n'
+          'method.\n'
           '\n'
           'The unary "+" (plus) operator yields its numeric argument '
-          'unchanged.\n'
+          'unchanged;\n'
+          'the operation can be overridden with the "__pos__()" special '
+          'method.\n'
           '\n'
           'The unary "~" (invert) operator yields the bitwise inversion of '
           'its\n'
           'integer argument.  The bitwise inversion of "x" is defined as\n'
-          '"-(x+1)".  It only applies to integral numbers.\n'
+          '"-(x+1)".  It only applies to integral numbers or to custom '
+          'objects\n'
+          'that override the "__invert__()" special method.\n'
           '\n'
           'In all three cases, if the argument does not have the proper type, '
           'a\n'