Python 3.8.0b1v3.8.0b1

1 files changed, 84 insertions, 70 deletions

diff --git a/Lib/pydoc_data/topics.py b/Lib/pydoc_data/topics.py
index 3361c6b..1fb19f2 100644
--- a/Lib/pydoc_data/topics.py
+++ b/Lib/pydoc_data/topics.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Wed May 29 01:18:52 2019
+# Autogenerated by Sphinx on Tue Jun  4 19:40:37 2019
 topics = {'assert': 'The "assert" statement\n'
            '**********************\n'
            '\n'
@@ -357,12 +357,13 @@ topics = {'assert': 'The "assert" statement\n'
                'a variable or attribute annotation and an optional assignment\n'
                'statement:\n'
                '\n'
-               '   annotated_assignment_stmt ::= augtarget ":" expression ["=" '
-               'expression]\n'
+               '   annotated_assignment_stmt ::= augtarget ":" expression\n'
+               '                                 ["=" (starred_expression | '
+               'yield_expression)]\n'
                '\n'
                'The difference from normal Assignment statements is that only '
                'single\n'
-               'target and only single right hand side value is allowed.\n'
+               'target is allowed.\n'
                '\n'
                'For simple names as assignment targets, if in class or module '
                'scope,\n'
@@ -409,7 +410,14 @@ topics = {'assert': 'The "assert" statement\n'
                'standard\n'
                '     syntax for type annotations that can be used in static '
                'analysis\n'
-               '     tools and IDEs.\n',
+               '     tools and IDEs.\n'
+               '\n'
+               'Changed in version 3.8: Now annotated assignments allow same\n'
+               'expressions in the right hand side as the regular '
+               'assignments.\n'
+               'Previously, some expressions (like un-parenthesized tuple '
+               'expressions)\n'
+               'caused a syntax error.\n',
  'async': 'Coroutines\n'
           '**********\n'
           '\n'
@@ -2026,21 +2034,22 @@ topics = {'assert': 'The "assert" statement\n'
                 '\n'
                 'For user-defined classes which do not define "__contains__()" '
                 'but do\n'
-                'define "__iter__()", "x in y" is "True" if some value "z" '
-                'with "x ==\n'
-                'z" is produced while iterating over "y".  If an exception is '
-                'raised\n'
-                'during the iteration, it is as if "in" raised that '
-                'exception.\n'
+                'define "__iter__()", "x in y" is "True" if some value "z", '
+                'for which\n'
+                'the expression "x is z or x == z" is true, is produced while '
+                'iterating\n'
+                'over "y". If an exception is raised during the iteration, it '
+                'is as if\n'
+                '"in" raised that exception.\n'
                 '\n'
                 'Lastly, the old-style iteration protocol is tried: if a class '
                 'defines\n'
                 '"__getitem__()", "x in y" is "True" if and only if there is a '
                 'non-\n'
-                'negative integer index *i* such that "x == y[i]", and all '
-                'lower\n'
-                'integer indices do not raise "IndexError" exception.  (If any '
-                'other\n'
+                'negative integer index *i* such that "x is y[i] or x == '
+                'y[i]", and no\n'
+                'lower integer index raises the "IndexError" exception.  (If '
+                'any other\n'
                 'exception is raised, it is as if "in" raised that '
                 'exception).\n'
                 '\n'
@@ -5081,7 +5090,7 @@ topics = {'assert': 'The "assert" statement\n'
                   'Meaning                                                    '
                   '|\n'
                   '   '
-                  '|===========|============================================================|\n'
+                  '+===========+============================================================+\n'
                   '   | "\'<\'"     | Forces the field to be left-aligned '
                   'within the available   |\n'
                   '   |           | space (this is the default for most '
@@ -5130,7 +5139,7 @@ topics = {'assert': 'The "assert" statement\n'
                   'Meaning                                                    '
                   '|\n'
                   '   '
-                  '|===========|============================================================|\n'
+                  '+===========+============================================================+\n'
                   '   | "\'+\'"     | indicates that a sign should be used for '
                   'both positive as  |\n'
                   '   |           | well as negative '
@@ -5234,7 +5243,7 @@ topics = {'assert': 'The "assert" statement\n'
                   'Meaning                                                    '
                   '|\n'
                   '   '
-                  '|===========|============================================================|\n'
+                  '+===========+============================================================+\n'
                   '   | "\'s\'"     | String format. This is the default type '
                   'for strings and    |\n'
                   '   |           | may be '
@@ -5254,7 +5263,7 @@ topics = {'assert': 'The "assert" statement\n'
                   'Meaning                                                    '
                   '|\n'
                   '   '
-                  '|===========|============================================================|\n'
+                  '+===========+============================================================+\n'
                   '   | "\'b\'"     | Binary format. Outputs the number in '
                   'base 2.               |\n'
                   '   '
@@ -5316,7 +5325,7 @@ topics = {'assert': 'The "assert" statement\n'
                   'Meaning                                                    '
                   '|\n'
                   '   '
-                  '|===========|============================================================|\n'
+                  '+===========+============================================================+\n'
                   '   | "\'e\'"     | Exponent notation. Prints the number in '
                   'scientific         |\n'
                   '   |           | notation using the letter ‘e’ to indicate '
@@ -6334,14 +6343,16 @@ topics = {'assert': 'The "assert" statement\n'
        '"False" otherwise.\n'
        '\n'
        'For user-defined classes which do not define "__contains__()" but do\n'
-       'define "__iter__()", "x in y" is "True" if some value "z" with "x ==\n'
-       'z" is produced while iterating over "y".  If an exception is raised\n'
-       'during the iteration, it is as if "in" raised that exception.\n'
+       'define "__iter__()", "x in y" is "True" if some value "z", for which\n'
+       'the expression "x is z or x == z" is true, is produced while '
+       'iterating\n'
+       'over "y". If an exception is raised during the iteration, it is as if\n'
+       '"in" raised that exception.\n'
        '\n'
        'Lastly, the old-style iteration protocol is tried: if a class defines\n'
        '"__getitem__()", "x in y" is "True" if and only if there is a non-\n'
-       'negative integer index *i* such that "x == y[i]", and all lower\n'
-       'integer indices do not raise "IndexError" exception.  (If any other\n'
+       'negative integer index *i* such that "x is y[i] or x == y[i]", and no\n'
+       'lower integer index raises the "IndexError" exception.  (If any other\n'
        'exception is raised, it is as if "in" raised that exception).\n'
        '\n'
        'The operator "not in" is defined to have the inverse truth value of\n'
@@ -6850,11 +6861,11 @@ topics = {'assert': 'The "assert" statement\n'
                   'numeric\n'
                   '   object is an integer type.  Must return an integer.\n'
                   '\n'
-                  '   Note: In order to have a coherent integer type class, '
-                  'when\n'
-                  '     "__index__()" is defined "__int__()" should also be '
-                  'defined, and\n'
-                  '     both should return the same value.\n'
+                  '   If "__int__()", "__float__()" and "__complex__()" are '
+                  'not defined\n'
+                  '   then corresponding built-in functions "int()", "float()" '
+                  'and\n'
+                  '   "complex()" fall back to "__index__()".\n'
                   '\n'
                   'object.__round__(self[, ndigits])\n'
                   'object.__trunc__(self)\n'
@@ -7025,7 +7036,7 @@ topics = {'assert': 'The "assert" statement\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
                      '| Operator                                        | '
                      'Description                           |\n'
-                     '|=================================================|=======================================|\n'
+                     '+=================================================+=======================================+\n'
                      '| "lambda"                                        | '
                      'Lambda expression                     |\n'
                      '+-------------------------------------------------+---------------------------------------+\n'
@@ -8716,7 +8727,7 @@ topics = {'assert': 'The "assert" statement\n'
                  '   in:\n'
                  '\n'
                  '      class Philosopher:\n'
-                 '          def __init_subclass__(cls, default_name, '
+                 '          def __init_subclass__(cls, /, default_name, '
                  '**kwargs):\n'
                  '              super().__init_subclass__(**kwargs)\n'
                  '              cls.default_name = default_name\n'
@@ -9469,11 +9480,11 @@ topics = {'assert': 'The "assert" statement\n'
                  'numeric\n'
                  '   object is an integer type.  Must return an integer.\n'
                  '\n'
-                 '   Note: In order to have a coherent integer type class, '
-                 'when\n'
-                 '     "__index__()" is defined "__int__()" should also be '
-                 'defined, and\n'
-                 '     both should return the same value.\n'
+                 '   If "__int__()", "__float__()" and "__complex__()" are not '
+                 'defined\n'
+                 '   then corresponding built-in functions "int()", "float()" '
+                 'and\n'
+                 '   "complex()" fall back to "__index__()".\n'
                  '\n'
                  'object.__round__(self[, ndigits])\n'
                  'object.__trunc__(self)\n'
@@ -10269,7 +10280,7 @@ topics = {'assert': 'The "assert" statement\n'
                    '   | Representation          | '
                    'Description                   |\n'
                    '   '
-                   '|=========================|===============================|\n'
+                   '+=========================+===============================+\n'
                    '   | "\\n"                    | Line '
                    'Feed                     |\n'
                    '   '
@@ -10608,7 +10619,7 @@ topics = {'assert': 'The "assert" statement\n'
             '+-------------------+-----------------------------------+---------+\n'
             '| Escape Sequence   | Meaning                           | Notes   '
             '|\n'
-            '|===================|===================================|=========|\n'
+            '+===================+===================================+=========+\n'
             '| "\\newline"        | Backslash and newline ignored     '
             '|         |\n'
             '+-------------------+-----------------------------------+---------+\n'
@@ -10654,7 +10665,7 @@ topics = {'assert': 'The "assert" statement\n'
             '+-------------------+-----------------------------------+---------+\n'
             '| Escape Sequence   | Meaning                           | Notes   '
             '|\n'
-            '|===================|===================================|=========|\n'
+            '+===================+===================================+=========+\n'
             '| "\\N{name}"        | Character named *name* in the     | '
             '(4)     |\n'
             '|                   | Unicode database                  |         '
@@ -11292,7 +11303,7 @@ topics = {'assert': 'The "assert" statement\n'
           '      | Attribute                 | Meaning                         '
           '|             |\n'
           '      '
-          '|===========================|=================================|=============|\n'
+          '+===========================+=================================+=============+\n'
           '      | "__doc__"                 | The function’s documentation    '
           '| Writable    |\n'
           '      |                           | string, or "None" if            '
@@ -11769,33 +11780,36 @@ topics = {'assert': 'The "assert" statement\n'
           '\n'
           '      Special read-only attributes: "co_name" gives the function '
           'name;\n'
-          '      "co_argcount" is the number of positional arguments '
-          '(including\n'
-          '      arguments with default values); "co_nlocals" is the number '
-          'of\n'
-          '      local variables used by the function (including arguments);\n'
-          '      "co_varnames" is a tuple containing the names of the local\n'
-          '      variables (starting with the argument names); "co_cellvars" '
-          'is a\n'
-          '      tuple containing the names of local variables that are\n'
-          '      referenced by nested functions; "co_freevars" is a tuple\n'
-          '      containing the names of free variables; "co_code" is a '
-          'string\n'
-          '      representing the sequence of bytecode instructions; '
-          '"co_consts"\n'
-          '      is a tuple containing the literals used by the bytecode;\n'
-          '      "co_names" is a tuple containing the names used by the '
-          'bytecode;\n'
-          '      "co_filename" is the filename from which the code was '
-          'compiled;\n'
-          '      "co_firstlineno" is the first line number of the function;\n'
-          '      "co_lnotab" is a string encoding the mapping from bytecode\n'
-          '      offsets to line numbers (for details see the source code of '
+          '      "co_argcount" is the total number of positional arguments\n'
+          '      (including positional-only arguments and arguments with '
+          'default\n'
+          '      values); "co_posonlyargcount" is the number of '
+          'positional-only\n'
+          '      arguments (including arguments with default values);\n'
+          '      "co_kwonlyargcount" is the number of keyword-only arguments\n'
+          '      (including arguments with default values); "co_nlocals" is '
+          'the\n'
+          '      number of local variables used by the function (including\n'
+          '      arguments); "co_varnames" is a tuple containing the names of '
+          'the\n'
+          '      local variables (starting with the argument names);\n'
+          '      "co_cellvars" is a tuple containing the names of local '
+          'variables\n'
+          '      that are referenced by nested functions; "co_freevars" is a\n'
+          '      tuple containing the names of free variables; "co_code" is a\n'
+          '      string representing the sequence of bytecode instructions;\n'
+          '      "co_consts" is a tuple containing the literals used by the\n'
+          '      bytecode; "co_names" is a tuple containing the names used by '
           'the\n'
-          '      interpreter); "co_stacksize" is the required stack size\n'
-          '      (including local variables); "co_flags" is an integer '
-          'encoding a\n'
-          '      number of flags for the interpreter.\n'
+          '      bytecode; "co_filename" is the filename from which the code '
+          'was\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 (including local variables); "co_flags" is an integer\n'
+          '      encoding a number of flags for the interpreter.\n'
           '\n'
           '      The following flag bits are defined for "co_flags": bit '
           '"0x04"\n'
@@ -12563,7 +12577,7 @@ topics = {'assert': 'The "assert" statement\n'
              '+----------------------------+----------------------------------+------------+\n'
              '| Operation                  | Result                           '
              '| Notes      |\n'
-             '|============================|==================================|============|\n'
+             '+============================+==================================+============+\n'
              '| "x in s"                   | "True" if an item of *s* is      '
              '| (1)        |\n'
              '|                            | equal to *x*, else "False"       '
@@ -12792,7 +12806,7 @@ topics = {'assert': 'The "assert" statement\n'
              '+--------------------------------+----------------------------------+-----------------------+\n'
              '| Operation                      | '
              'Result                           | Notes                 |\n'
-             '|================================|==================================|=======================|\n'
+             '+================================+==================================+=======================+\n'
              '| "s[i] = x"                     | item *i* of *s* is replaced '
              'by   |                       |\n'
              '|                                | '
@@ -13254,7 +13268,7 @@ topics = {'assert': 'The "assert" statement\n'
                      '| Operation                      | '
                      'Result                           | Notes                 '
                      '|\n'
-                     '|================================|==================================|=======================|\n'
+                     '+================================+==================================+=======================+\n'
                      '| "s[i] = x"                     | item *i* of *s* is '
                      'replaced by   |                       |\n'
                      '|                                | '