Python 3.8.0a4v3.8.0a4

1 files changed, 53 insertions, 40 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index 3e11f54fd7..875d6e8903 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 Mar 25 20:32:23 2019
+# Autogenerated by Sphinx on Mon May  6 20:27:55 2019
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
            '\n'
@@ -162,20 +162,21 @@ topics = {'assert': 'The "assert" statement\n'
                '\n'
                '  Note: If the object is a class instance and the attribute '
                'reference\n'
-               '  occurs on both sides of the assignment operator, the RHS '
-               'expression,\n'
-               '  "a.x" can access either an instance attribute or (if no '
-               'instance\n'
-               '  attribute exists) a class attribute.  The LHS target "a.x" '
-               'is always\n'
-               '  set as an instance attribute, creating it if necessary.  '
-               'Thus, the\n'
-               '  two occurrences of "a.x" do not necessarily refer to the '
-               'same\n'
-               '  attribute: if the RHS expression refers to a class '
-               'attribute, the\n'
-               '  LHS creates a new instance attribute as the target of the\n'
-               '  assignment:\n'
+               '  occurs on both sides of the assignment operator, the '
+               'right-hand side\n'
+               '  expression, "a.x" can access either an instance attribute or '
+               '(if no\n'
+               '  instance attribute exists) a class attribute.  The left-hand '
+               'side\n'
+               '  target "a.x" is always set as an instance attribute, '
+               'creating it if\n'
+               '  necessary.  Thus, the two occurrences of "a.x" do not '
+               'necessarily\n'
+               '  refer to the same attribute: if the right-hand side '
+               'expression\n'
+               '  refers to a class attribute, the left-hand side creates a '
+               'new\n'
+               '  instance attribute as the target of the assignment:\n'
                '\n'
                '     class Cls:\n'
                '         x = 3             # class variable\n'
@@ -3302,11 +3303,11 @@ topics = {'assert': 'The "assert" statement\n'
                   '"str.format()"\n'
                   '   method, to produce a “formatted” string representation '
                   'of an\n'
-                  '   object. The "format_spec" argument is a string that '
+                  '   object. The *format_spec* argument is a string that '
                   'contains a\n'
                   '   description of the formatting options desired. The '
                   'interpretation\n'
-                  '   of the "format_spec" argument is up to the type '
+                  '   of the *format_spec* argument is up to the type '
                   'implementing\n'
                   '   "__format__()", however most classes will either '
                   'delegate\n'
@@ -6189,8 +6190,8 @@ topics = {'assert': 'The "assert" statement\n'
            'end up importing "pkg.mod". If you execute "from ..subpkg2 import '
            'mod"\n'
            'from within "pkg.subpkg1" you will import "pkg.subpkg2.mod". The\n'
-           'specification for relative imports is contained within **PEP '
-           '328**.\n'
+           'specification for relative imports is contained in the Package\n'
+           'Relative Imports section.\n'
            '\n'
            '"importlib.import_module()" is provided to support applications '
            'that\n'
@@ -8002,11 +8003,11 @@ topics = {'assert': 'The "assert" statement\n'
                  '"str.format()"\n'
                  '   method, to produce a “formatted” string representation of '
                  'an\n'
-                 '   object. The "format_spec" argument is a string that '
+                 '   object. The *format_spec* argument is a string that '
                  'contains a\n'
                  '   description of the formatting options desired. The '
                  'interpretation\n'
-                 '   of the "format_spec" argument is up to the type '
+                 '   of the *format_spec* argument is up to the type '
                  'implementing\n'
                  '   "__format__()", however most classes will either '
                  'delegate\n'
@@ -8768,15 +8769,15 @@ topics = {'assert': 'The "assert" statement\n'
                  'When a class definition is executed, the following steps '
                  'occur:\n'
                  '\n'
-                 '* MRO entries are resolved\n'
+                 '* MRO entries are resolved;\n'
                  '\n'
-                 '* the appropriate metaclass is determined\n'
+                 '* the appropriate metaclass is determined;\n'
                  '\n'
-                 '* the class namespace is prepared\n'
+                 '* the class namespace is prepared;\n'
                  '\n'
-                 '* the class body is executed\n'
+                 '* the class body is executed;\n'
                  '\n'
-                 '* the class object is created\n'
+                 '* the class object is created.\n'
                  '\n'
                  '\n'
                  'Resolving MRO entries\n'
@@ -8806,16 +8807,16 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  '* if no bases and no explicit metaclass are given, then '
                  '"type()" is\n'
-                 '  used\n'
+                 '  used;\n'
                  '\n'
                  '* if an explicit metaclass is given and it is *not* an '
                  'instance of\n'
-                 '  "type()", then it is used directly as the metaclass\n'
+                 '  "type()", then it is used directly as the metaclass;\n'
                  '\n'
                  '* if an instance of "type()" is given as the explicit '
                  'metaclass, or\n'
                  '  bases are defined, then the most derived metaclass is '
-                 'used\n'
+                 'used.\n'
                  '\n'
                  'The most derived metaclass is selected from the explicitly '
                  'specified\n'
@@ -8931,7 +8932,7 @@ topics = {'assert': 'The "assert" statement\n'
                  'with the\n'
                  '  class being defined and the assigned name of that '
                  'particular\n'
-                 '  descriptor; and\n'
+                 '  descriptor;\n'
                  '\n'
                  '* finally, the "__init_subclass__()" hook is called on the '
                  'immediate\n'
@@ -9030,7 +9031,7 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  'One can implement the generic class syntax as specified by '
                  '**PEP 484**\n'
-                 '(for example "List[int]") by defining a special method\n'
+                 '(for example "List[int]") by defining a special method:\n'
                  '\n'
                  'classmethod object.__class_getitem__(cls, key)\n'
                  '\n'
@@ -9672,6 +9673,14 @@ topics = {'assert': 'The "assert" statement\n'
                    'capitalized\n'
                    '   and the rest lowercased.\n'
                    '\n'
+                   '   Changed in version 3.8: The first character is now put '
+                   'into\n'
+                   '   titlecase rather than uppercase. This means that '
+                   'characters like\n'
+                   '   digraphs will only have their first letter capitalized, '
+                   'instead of\n'
+                   '   the full character.\n'
+                   '\n'
                    'str.casefold()\n'
                    '\n'
                    '   Return a casefolded copy of the string. Casefolded '
@@ -10416,9 +10425,7 @@ topics = {'assert': 'The "assert" statement\n'
                    '      >>> def titlecase(s):\n'
                    '      ...     return re.sub(r"[A-Za-z]+(\'[A-Za-z]+)?",\n'
                    '      ...                   lambda mo: '
-                   'mo.group(0)[0].upper() +\n'
-                   '      ...                              '
-                   'mo.group(0)[1:].lower(),\n'
+                   'mo.group(0).capitalize(),\n'
                    '      ...                   s)\n'
                    '      ...\n'
                    '      >>> titlecase("they\'re bill\'s friends.")\n'
@@ -11286,17 +11293,17 @@ topics = {'assert': 'The "assert" statement\n'
           '|             |\n'
           '      |                           | unavailable; not inherited by   '
           '|             |\n'
-          '      |                           | subclasses                      '
+          '      |                           | subclasses.                     '
           '|             |\n'
           '      '
           '+---------------------------+---------------------------------+-------------+\n'
-          '      | "__name__"                | The function’s name             '
+          '      | "__name__"                | The function’s name.            '
           '| Writable    |\n'
           '      '
           '+---------------------------+---------------------------------+-------------+\n'
-          '      | "__qualname__"            | The function’s *qualified name* '
+          '      | "__qualname__"            | The function’s *qualified       '
           '| Writable    |\n'
-          '      |                           | New in version 3.3.             '
+          '      |                           | name*.  New in version 3.3.     '
           '|             |\n'
           '      '
           '+---------------------------+---------------------------------+-------------+\n'
@@ -11316,7 +11323,7 @@ topics = {'assert': 'The "assert" statement\n'
           '|             |\n'
           '      |                           | or "None" if no arguments have  '
           '|             |\n'
-          '      |                           | a default value                 '
+          '      |                           | a default value.                '
           '|             |\n'
           '      '
           '+---------------------------+---------------------------------+-------------+\n'
@@ -12172,7 +12179,13 @@ topics = {'assert': 'The "assert" statement\n'
                  '\n'
                  '      "fromkeys()" is a class method that returns a new '
                  'dictionary.\n'
-                 '      *value* defaults to "None".\n'
+                 '      *value* defaults to "None".  All of the values refer '
+                 'to just a\n'
+                 '      single instance, so it generally doesn’t make sense '
+                 'for *value*\n'
+                 '      to be a mutable object such as an empty list.  To get '
+                 'distinct\n'
+                 '      values, use a dict comprehension instead.\n'
                  '\n'
                  '   get(key[, default])\n'
                  '\n'