Python 3.12.0a4v3.12.0a4

1 files changed, 37 insertions, 38 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index 4ba680c..11b7503 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 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 @@ topics = {'assert': 'The "assert" statement\n'
              '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 @@ topics = {'assert': 'The "assert" statement\n'
              '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 @@ topics = {'assert': 'The "assert" statement\n'
               '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 @@ topics = {'assert': 'The "assert" statement\n'
         '\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 @@ topics = {'assert': 'The "assert" statement\n'
            '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 @@ topics = {'assert': 'The "assert" statement\n'
                    '\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 @@ topics = {'assert': 'The "assert" statement\n'
                  '         >>> 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 @@ topics = {'assert': 'The "assert" statement\n'
                  '   >>> n = 0\n'
                  '   >>> for val in values:\n'
                  '   ...     n += val\n'
+                 '   ...\n'
                  '   >>> print(n)\n'
                  '   504\n'
                  '\n'
@@ -14452,8 +14452,7 @@ topics = {'assert': 'The "assert" statement\n'
                  '   >>> # 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 @@ topics = {'assert': 'The "assert" statement\n'
          '     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'