Python 3.12.0a7v3.12.0a7

1 files changed, 74 insertions, 72 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index ad1b6ac..1babb5c 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 Mar  7 22:42:28 2023
+# Autogenerated by Sphinx on Tue Apr  4 17:52:21 2023
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
            '\n'
@@ -1134,10 +1134,11 @@ topics = {'assert': 'The "assert" statement\n'
                      'future, a\n'
                      '  check may be added to prevent this.\n'
                      '\n'
-                     '* Nonempty *__slots__* does not work for classes derived '
-                     'from\n'
-                     '  “variable-length” built-in types such as "int", '
-                     '"bytes" and "tuple".\n'
+                     '* "TypeError" will be raised if nonempty *__slots__* are '
+                     'defined for a\n'
+                     '  class derived from a ""variable-length" built-in type" '
+                     'such as\n'
+                     '  "int", "bytes", and "tuple".\n'
                      '\n'
                      '* Any non-string *iterable* may be assigned to '
                      '*__slots__*.\n'
@@ -3072,7 +3073,7 @@ topics = {'assert': 'The "assert" statement\n'
              'AS\n'
              'pattern binds the subject to the name on the right of the as '
              'keyword\n'
-             'and succeeds. "capture_pattern" cannot be a a "_".\n'
+             'and succeeds. "capture_pattern" cannot be a "_".\n'
              '\n'
              'In simple terms "P as NAME" will match with "P", and on success '
              'it\n'
@@ -4675,7 +4676,7 @@ topics = {'assert': 'The "assert" statement\n'
              'scripts.  For\n'
              'example:\n'
              '\n'
-             '   python3 -m pdb myscript.py\n'
+             '   python -m pdb myscript.py\n'
              '\n'
              'When invoked as a script, pdb will automatically enter '
              'post-mortem\n'
@@ -4695,7 +4696,7 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'New in version 3.7: "pdb.py" now accepts a "-m" option that '
              'execute\n'
-             'modules similar to the way "python3 -m" does. As with a script, '
+             'modules similar to the way "python -m" does. As with a script, '
              'the\n'
              'debugger will pause execution just before the first line of the\n'
              'module.\n'
@@ -4759,8 +4760,8 @@ topics = {'assert': 'The "assert" statement\n'
              'object)\n'
              '   under debugger control.  When "runeval()" returns, it returns '
              'the\n'
-             '   value of the expression.  Otherwise this function is similar '
-             'to\n'
+             '   value of the *expression*.  Otherwise this function is '
+             'similar to\n'
              '   "run()".\n'
              '\n'
              'pdb.runcall(function, *args, **kwds)\n'
@@ -4799,7 +4800,7 @@ topics = {'assert': 'The "assert" statement\n'
              'pdb.pm()\n'
              '\n'
              '   Enter post-mortem debugging of the traceback found in\n'
-             '   "sys.last_exc".\n'
+             '   "sys.last_traceback".\n'
              '\n'
              'The "run*" functions and "set_trace()" are aliases for '
              'instantiating\n'
@@ -5022,14 +5023,15 @@ topics = {'assert': 'The "assert" statement\n'
              'ignore bpnumber [count]\n'
              '\n'
              '   Set the ignore count for the given breakpoint number.  If '
-             'count is\n'
-             '   omitted, the ignore count is set to 0.  A breakpoint becomes '
-             'active\n'
-             '   when the ignore count is zero.  When non-zero, the count is\n'
-             '   decremented each time the breakpoint is reached and the '
-             'breakpoint\n'
-             '   is not disabled and any associated condition evaluates to '
-             'true.\n'
+             '*count*\n'
+             '   is omitted, the ignore count is set to 0.  A breakpoint '
+             'becomes\n'
+             '   active when the ignore count is zero.  When non-zero, the '
+             '*count*\n'
+             '   is decremented each time the breakpoint is reached and the\n'
+             '   breakpoint is not disabled and any associated condition '
+             'evaluates\n'
+             '   to true.\n'
              '\n'
              'condition bpnumber [condition]\n'
              '\n'
@@ -5079,7 +5081,7 @@ topics = {'assert': 'The "assert" statement\n'
              '   breakpoint—which could have its own command list, leading to\n'
              '   ambiguities about which list to execute.\n'
              '\n'
-             '   If you use the ‘silent’ command in the command list, the '
+             '   If you use the "silent" command in the command list, the '
              'usual\n'
              '   message about stopping at a breakpoint is not printed.  This '
              'may be\n'
@@ -5114,11 +5116,10 @@ topics = {'assert': 'The "assert" statement\n'
              'number\n'
              '   greater than the current one is reached.\n'
              '\n'
-             '   With a line number, continue execution until a line with a '
-             'number\n'
-             '   greater or equal to that is reached.  In both cases, also '
-             'stop when\n'
-             '   the current frame returns.\n'
+             '   With *lineno*, continue execution until a line with a number\n'
+             '   greater or equal to *lineno* is reached.  In both cases, also '
+             'stop\n'
+             '   when the current frame returns.\n'
              '\n'
              '   Changed in version 3.2: Allow giving an explicit line '
              'number.\n'
@@ -5182,9 +5183,8 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'p expression\n'
              '\n'
-             '   Evaluate the *expression* in the current context and print '
-             'its\n'
-             '   value.\n'
+             '   Evaluate *expression* in the current context and print its '
+             'value.\n'
              '\n'
              '   Note:\n'
              '\n'
@@ -5194,26 +5194,26 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'pp expression\n'
              '\n'
-             '   Like the "p" command, except the value of the expression is '
+             '   Like the "p" command, except the value of *expression* is '
              'pretty-\n'
              '   printed using the "pprint" module.\n'
              '\n'
              'whatis expression\n'
              '\n'
-             '   Print the type of the *expression*.\n'
+             '   Print the type of *expression*.\n'
              '\n'
              'source expression\n'
              '\n'
-             '   Try to get source code for the given object and display it.\n'
+             '   Try to get source code of *expression* and display it.\n'
              '\n'
              '   New in version 3.2.\n'
              '\n'
              'display [expression]\n'
              '\n'
-             '   Display the value of the expression if it changed, each time\n'
+             '   Display the value of *expression* if it changed, each time\n'
              '   execution stops in the current frame.\n'
              '\n'
-             '   Without expression, list all display expressions for the '
+             '   Without *expression*, list all display expressions for the '
              'current\n'
              '   frame.\n'
              '\n'
@@ -5221,10 +5221,10 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'undisplay [expression]\n'
              '\n'
-             '   Do not display the expression any more in the current frame.\n'
-             '   Without expression, clear all display expressions for the '
-             'current\n'
-             '   frame.\n'
+             '   Do not display *expression* anymore in the current frame.  '
+             'Without\n'
+             '   *expression*, clear all display expressions for the current '
+             'frame.\n'
              '\n'
              '   New in version 3.2.\n'
              '\n'
@@ -5240,16 +5240,16 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'alias [name [command]]\n'
              '\n'
-             '   Create an alias called *name* that executes *command*.  The '
-             'command\n'
-             '   must *not* be enclosed in quotes.  Replaceable parameters can '
-             'be\n'
-             '   indicated by "%1", "%2", and so on, while "%*" is replaced by '
-             'all\n'
-             '   the parameters. If no command is given, the current alias '
-             'for\n'
-             '   *name* is shown. If no arguments are given, all aliases are '
-             'listed.\n'
+             '   Create an alias called *name* that executes *command*.  The\n'
+             '   *command* must *not* be enclosed in quotes.  Replaceable '
+             'parameters\n'
+             '   can be indicated by "%1", "%2", and so on, while "%*" is '
+             'replaced\n'
+             '   by all the parameters. If *command* is omitted, the current '
+             'alias\n'
+             '   for *name* is shown. If no arguments are given, all aliases '
+             'are\n'
+             '   listed.\n'
              '\n'
              '   Aliases may be nested and can contain anything that can be '
              'legally\n'
@@ -5268,14 +5268,14 @@ topics = {'assert': 'The "assert" statement\n'
              '   in the ".pdbrc" file):\n'
              '\n'
              '      # Print instance variables (usage "pi classInst")\n'
-             '      alias pi for k in %1.__dict__.keys(): '
-             'print("%1.",k,"=",%1.__dict__[k])\n'
+             '      alias pi for k in %1.__dict__.keys(): print(f"%1.{k} = '
+             '{%1.__dict__[k]}")\n'
              '      # Print instance variables in self\n'
              '      alias ps pi self\n'
              '\n'
              'unalias name\n'
              '\n'
-             '   Delete the specified alias.\n'
+             '   Delete the specified alias *name*.\n'
              '\n'
              '! statement\n'
              '\n'
@@ -5295,12 +5295,13 @@ topics = {'assert': 'The "assert" statement\n'
              'run [args ...]\n'
              'restart [args ...]\n'
              '\n'
-             '   Restart the debugged Python program.  If an argument is '
-             'supplied,\n'
-             '   it is split with "shlex" and the result is used as the new\n'
-             '   "sys.argv". History, breakpoints, actions and debugger '
-             'options are\n'
-             '   preserved. "restart" is an alias for "run".\n'
+             '   Restart the debugged Python program.  If *args* is supplied, '
+             'it is\n'
+             '   split with "shlex" and the result is used as the new '
+             '"sys.argv".\n'
+             '   History, breakpoints, actions and debugger options are '
+             'preserved.\n'
+             '   "restart" is an alias for "run".\n'
              '\n'
              'q(uit)\n'
              '\n'
@@ -5309,11 +5310,11 @@ topics = {'assert': 'The "assert" statement\n'
              '\n'
              'debug code\n'
              '\n'
-             '   Enter a recursive debugger that steps through the code '
-             'argument\n'
-             '   (which is an arbitrary expression or statement to be executed '
-             'in\n'
-             '   the current environment).\n'
+             '   Enter a recursive debugger that steps through *code* (which '
+             'is an\n'
+             '   arbitrary expression or statement to be executed in the '
+             'current\n'
+             '   environment).\n'
              '\n'
              'retval\n'
              '\n'
@@ -6170,7 +6171,8 @@ topics = {'assert': 'The "assert" statement\n'
                   'The general form of a *standard format specifier* is:\n'
                   '\n'
                   '   format_spec     ::= '
-                  '[[fill]align][sign][z][#][0][width][grouping_option][.precision][type]\n'
+                  '[[fill]align][sign]["z"]["#"]["0"][width][grouping_option]["." '
+                  'precision][type]\n'
                   '   fill            ::= <any character>\n'
                   '   align           ::= "<" | ">" | "=" | "^"\n'
                   '   sign            ::= "+" | "-" | " "\n'
@@ -9981,10 +9983,11 @@ topics = {'assert': 'The "assert" statement\n'
                  'future, a\n'
                  '  check may be added to prevent this.\n'
                  '\n'
-                 '* Nonempty *__slots__* does not work for classes derived '
-                 'from\n'
-                 '  “variable-length” built-in types such as "int", "bytes" '
-                 'and "tuple".\n'
+                 '* "TypeError" will be raised if nonempty *__slots__* are '
+                 'defined for a\n'
+                 '  class derived from a ""variable-length" built-in type" '
+                 'such as\n'
+                 '  "int", "bytes", and "tuple".\n'
                  '\n'
                  '* Any non-string *iterable* may be assigned to *__slots__*.\n'
                  '\n'
@@ -13691,11 +13694,10 @@ topics = {'assert': 'The "assert" statement\n'
           '      compiled; "co_firstlineno" is the first line number of the\n'
           '      function; "co_lnotab" is a string encoding the mapping from\n'
           '      bytecode offsets to line numbers (for details see the source\n'
-          '      code of the interpreter); "co_stacksize" is the required '
-          'stack\n'
-          '      size; "co_flags" is an integer encoding a number of flags '
-          'for\n'
-          '      the interpreter.\n'
+          '      code of the interpreter, is deprecated since 3.12 and may be\n'
+          '      removed in 3.14); "co_stacksize" is the required stack size;\n'
+          '      "co_flags" is an integer encoding a number of flags for the\n'
+          '      interpreter.\n'
           '\n'
           '      The following flag bits are defined for "co_flags": bit '
           '"0x04"\n'
@@ -13858,7 +13860,7 @@ topics = {'assert': 'The "assert" statement\n'
           'if\n'
           '      the interpreter is interactive, it is also made available to '
           'the\n'
-          '      user as "sys.last_exc".\n'
+          '      user as "sys.last_traceback".\n'
           '\n'
           '      For explicitly created tracebacks, it is up to the creator '
           'of\n'