Python 3.12.0a4

Author: Yhg1s

Include/patchlevel.h

@@ -20,10 +20,10 @@
 #define PY_MINOR_VERSION        12
 #define PY_MICRO_VERSION        0
 #define PY_RELEASE_LEVEL        PY_RELEASE_LEVEL_ALPHA
-#define PY_RELEASE_SERIAL       3
+#define PY_RELEASE_SERIAL       4
 
 /* Version as a string */
-#define PY_VERSION              "3.12.0a3+"
+#define PY_VERSION              "3.12.0a4"
 /*--end constants--*/
 
 /* Version as a single 4-byte hex number, e.g. 0x010502B2 == 1.5.2b2.

Lib/pydoc_data/topics.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Tue Dec  6 19:31:49 2022
+# Autogenerated by Sphinx on Tue Jan 10 13:08:32 2023
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
            '\n'
@@ -2382,12 +2382,10 @@
              'finished,\n'
              'but if the sequence is empty, they will not have been assigned '
              'to at\n'
-             'all by the loop.  Hint: the built-in function "range()" returns '
-             'an\n'
-             'iterator of integers suitable to emulate the effect of Pascal’s '
-             '"for i\n'
-             ':= a to b do"; e.g., "list(range(3))" returns the list "[0, 1, '
-             '2]".\n'
+             'all by the loop.  Hint: the built-in type "range()" represents\n'
+             'immutable arithmetic sequences of integers. For instance, '
+             'iterating\n'
+             '"range(3)" successively yields 0, 1, and then 2.\n'
              '\n'
              'Changed in version 3.11: Starred elements are now allowed in '
              'the\n'
@@ -2726,7 +2724,7 @@
              'the\n'
              '     target list, it will be treated the same as an error '
              'occurring\n'
-             '     within the suite would be. See step 6 below.\n'
+             '     within the suite would be. See step 7 below.\n'
              '\n'
              '6. The suite is executed.\n'
              '\n'
@@ -5668,7 +5666,8 @@
               'be\n'
               'determined by scanning the entire text of the block for name '
               'binding\n'
-              'operations.\n'
+              'operations. See the FAQ entry on UnboundLocalError for '
+              'examples.\n'
               '\n'
               'If the "global" statement occurs within a block, all uses of '
               'the names\n'
@@ -5970,10 +5969,9 @@
         '\n'
         'Names in the target list are not deleted when the loop is finished,\n'
         'but if the sequence is empty, they will not have been assigned to at\n'
-        'all by the loop.  Hint: the built-in function "range()" returns an\n'
-        'iterator of integers suitable to emulate the effect of Pascal’s "for '
-        'i\n'
-        ':= a to b do"; e.g., "list(range(3))" returns the list "[0, 1, 2]".\n'
+        'all by the loop.  Hint: the built-in type "range()" represents\n'
+        'immutable arithmetic sequences of integers. For instance, iterating\n'
+        '"range(3)" successively yields 0, 1, and then 2.\n'
         '\n'
         'Changed in version 3.11: Starred elements are now allowed in the\n'
         'expression list.\n',
@@ -7781,7 +7779,7 @@
            'within a code block.  The local variables of a code block can be\n'
            'determined by scanning the entire text of the block for name '
            'binding\n'
-           'operations.\n'
+           'operations. See the FAQ entry on UnboundLocalError for examples.\n'
            '\n'
            'If the "global" statement occurs within a block, all uses of the '
            'names\n'
@@ -11322,35 +11320,35 @@
                    '\n'
                    "str.encode(encoding='utf-8', errors='strict')\n"
                    '\n'
-                   '   Return an encoded version of the string as a bytes '
-                   'object. Default\n'
-                   '   encoding is "\'utf-8\'". *errors* may be given to set a '
-                   'different\n'
-                   '   error handling scheme. The default for *errors* is '
-                   '"\'strict\'",\n'
-                   '   meaning that encoding errors raise a "UnicodeError". '
+                   '   Return the string encoded to "bytes".\n'
+                   '\n'
+                   '   *encoding* defaults to "\'utf-8\'"; see Standard '
+                   'Encodings for\n'
+                   '   possible values.\n'
+                   '\n'
+                   '   *errors* controls how encoding errors are handled. If '
+                   '"\'strict\'"\n'
+                   '   (the default), a "UnicodeError" exception is raised. '
                    'Other possible\n'
                    '   values are "\'ignore\'", "\'replace\'", '
                    '"\'xmlcharrefreplace\'",\n'
                    '   "\'backslashreplace\'" and any other name registered '
                    'via\n'
-                   '   "codecs.register_error()", see section Error Handlers. '
-                   'For a list\n'
-                   '   of possible encodings, see section Standard Encodings.\n'
+                   '   "codecs.register_error()". See Error Handlers for '
+                   'details.\n'
                    '\n'
-                   '   By default, the *errors* argument is not checked for '
-                   'best\n'
-                   '   performances, but only used at the first encoding '
-                   'error. Enable the\n'
-                   '   Python Development Mode, or use a debug build to check '
-                   '*errors*.\n'
+                   '   For performance reasons, the value of *errors* is not '
+                   'checked for\n'
+                   '   validity unless an encoding error actually occurs, '
+                   'Python\n'
+                   '   Development Mode is enabled or a debug build is used.\n'
                    '\n'
-                   '   Changed in version 3.1: Support for keyword arguments '
-                   'added.\n'
+                   '   Changed in version 3.1: Added support for keyword '
+                   'arguments.\n'
                    '\n'
-                   '   Changed in version 3.9: The *errors* is now checked in '
-                   'development\n'
-                   '   mode and in debug mode.\n'
+                   '   Changed in version 3.9: The value of the *errors* '
+                   'argument is now\n'
+                   '   checked in Python Development Mode and in debug mode.\n'
                    '\n'
                    'str.endswith(suffix[, start[, end]])\n'
                    '\n'
@@ -14099,6 +14097,7 @@
                  '         >>> class Counter(dict):\n'
                  '         ...     def __missing__(self, key):\n'
                  '         ...         return 0\n'
+                 '         ...\n'
                  '         >>> c = Counter()\n'
                  "         >>> c['red']\n"
                  '         0\n'
@@ -14425,6 +14424,7 @@
                  '   >>> n = 0\n'
                  '   >>> for val in values:\n'
                  '   ...     n += val\n'
+                 '   ...\n'
                  '   >>> print(n)\n'
                  '   504\n'
                  '\n'
@@ -14452,8 +14452,7 @@
                  '   >>> # get back a read-only proxy for the original '
                  'dictionary\n'
                  '   >>> values.mapping\n'
-                 "   mappingproxy({'eggs': 2, 'sausage': 1, 'bacon': 1, "
-                 "'spam': 500})\n"
+                 "   mappingproxy({'bacon': 1, 'spam': 500})\n"
                  "   >>> values.mapping['spam']\n"
                  '   500\n',
  'typesmethods': 'Methods\n'
@@ -15499,7 +15498,7 @@
          '     returns without an error, then "__exit__()" will always be\n'
          '     called. Thus, if an error occurs during the assignment to the\n'
          '     target list, it will be treated the same as an error occurring\n'
-         '     within the suite would be. See step 6 below.\n'
+         '     within the suite would be. See step 7 below.\n'
          '\n'
          '6. The suite is executed.\n'
          '\n'