python
diff --git a/‎Doc/library/asyncio-runner.rst
Lines changed: 3 additions & 1 deletion b/‎Doc/library/asyncio-runner.rst
Lines changed: 3 additions & 1 deletion
diff --git a/‎Doc/library/grp.rst
Lines changed: 2 additions & 3 deletions b/‎Doc/library/grp.rst
Lines changed: 2 additions & 3 deletions
diff --git a/‎Doc/library/typing.rst
Lines changed: 5 additions & 0 deletions b/‎Doc/library/typing.rst
Lines changed: 5 additions & 0 deletions
diff --git a/‎Doc/whatsnew/3.11.rst
Lines changed: 59 additions & 7 deletions b/‎Doc/whatsnew/3.11.rst
Lines changed: 59 additions & 7 deletions
diff --git a/‎Grammar/python.gram
Lines changed: 4 additions & 4 deletions b/‎Grammar/python.gram
Lines changed: 4 additions & 4 deletions
diff --git a/‎Include/internal/pycore_atomic.h
Lines changed: 1 addition & 1 deletion b/‎Include/internal/pycore_atomic.h
Lines changed: 1 addition & 1 deletion
diff --git a/‎Lib/dis.py
Lines changed: 8 additions & 8 deletions b/‎Lib/dis.py
Lines changed: 8 additions & 8 deletions
diff --git a/‎Lib/pathlib.py
Lines changed: 8 additions & 33 deletions b/‎Lib/pathlib.py
Lines changed: 8 additions & 33 deletions
@@ -75,7 +75,9 @@ Runner context manager
    :ref:`asyncio-debug-mode` settings.
 
    *loop_factory* could be used for overriding the loop creation.
-   :func:`asyncio.new_event_loop` is used if ``None``.
+   It is the responsibility of the *loop_factory* to set the created loop as the
+   current one. By default :func:`asyncio.new_event_loop` is used and set as
+   current event loop with :func:`asyncio.set_event_loop` if *loop_factory* is ``None``.
 
    Basically, :func:`asyncio.run()` example can be rewritten with the runner usage::
 
 
@@ -45,9 +45,8 @@ It defines the following items:
    Return the group database entry for the given numeric group ID. :exc:`KeyError`
    is raised if the entry asked for cannot be found.
 
-   .. deprecated:: 3.6
-      Since Python 3.6 the support of non-integer arguments like floats or
-      strings in :func:`getgrgid` is deprecated.
+   .. versionchanged:: 3.10
+      :exc:`TypeError` is raised for non-integer arguments like floats or strings.
 
 .. function:: getgrnam(name)
 
 
@@ -1825,6 +1825,9 @@ These are not used in annotations. They are building blocks for declaring types.
          True
 
    .. attribute:: __required_keys__
+
+      .. versionadded:: 3.9
+
    .. attribute:: __optional_keys__
 
       ``Point2D.__required_keys__`` and ``Point2D.__optional_keys__`` return
@@ -1852,6 +1855,8 @@ These are not used in annotations. They are building blocks for declaring types.
          >>> Point3D.__optional_keys__ == frozenset({'x', 'y'})
          True
 
+      .. versionadded:: 3.9
+
    See :pep:`589` for more examples and detailed rules of using ``TypedDict``.
 
    .. versionadded:: 3.8
 
@@ -49,13 +49,14 @@ This article explains the new features in Python 3.11, compared to 3.10.
 
 For full details, see the :ref:`changelog <changelog>`.
 
+
 Summary -- Release highlights
 =============================
 
 .. This section singles out the most important changes in Python 3.11.
    Brevity is key.
 
-- Python 3.11 is up to 10-60% faster than Python 3.10. On average, we measured a
+- Python 3.11 is between 10-60% faster than Python 3.10. On average, we measured a
   1.25x speedup on the standard benchmark suite. See `Faster CPython`_ for details.
 
 .. PEP-sized items next.
@@ -65,18 +66,35 @@ New syntax features:
 * :pep:`654`: Exception Groups and ``except*``.
   (Contributed by Irit Katriel in :issue:`45292`.)
 
+New built-in features:
+
+* :pep:`678`: Enriching Exceptions with Notes.
+
+New standard library modules:
+
+* :pep:`680`: ``tomllib`` — Support for Parsing TOML in the Standard Library.
+
+Interpreter improvements:
+
+* :pep:`657`: Include Fine Grained Error Locations in Tracebacks.
+* New :option:`-P` command line option and :envvar:`PYTHONSAFEPATH` environment
+  variable to disable automatically prepending a potentially unsafe path
+  (the working dir or script directory, depending on invocation)
+  to :data:`sys.path`.
+
 New typing features:
 
 * :pep:`646`: Variadic generics.
 * :pep:`655`: Marking individual TypedDict items as required or potentially missing.
 * :pep:`673`: ``Self`` type.
 * :pep:`675`: Arbitrary literal string type.
+* :pep:`681`: Data Class Transforms.
 
-Security improvements:
+Important deprecations, removals or restrictions:
 
-* New :option:`-P` command line option and :envvar:`PYTHONSAFEPATH` environment
-  variable to not prepend a potentially unsafe path to :data:`sys.path` such as
-  the current directory, the script's directory or an empty string.
+* :pep:`594`: Removing dead batteries from the standard library.
+* :pep:`624`: Remove ``Py_UNICODE`` encoder APIs.
+* :pep:`670`: Convert macros to functions in the Python C API.
 
 
 New Features
@@ -158,8 +176,25 @@ The :option:`-X` ``no_debug_ranges`` option and the environment variable
 See :pep:`657` for more details. (Contributed by Pablo Galindo, Batuhan Taskaya
 and Ammar Askar in :issue:`43950`.)
 
-Exceptions can be enriched with notes (PEP 678)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PEP 654: Exception Groups and ``except*``
+-----------------------------------------
+
+:pep:`654` introduces language features that enable a program
+to raise and handle multiple unrelated exceptions simultaneously.
+The builtin types :exc:`ExceptionGroup` and :exc:`BaseExceptionGroup`
+make it possible to group exceptions and raise them together,
+and the new :keyword:`except* <except_star>` syntax generalizes
+:keyword:`except` to match subgroups of exception groups.
+
+See :pep:`654` for more details.
+
+(Contributed by Irit Katriel in :issue:`45292`. PEP written by
+Irit Katriel, Yury Selivanov and Guido van Rossum.)
+
+
+PEP 678: Exceptions can be enriched with notes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The :meth:`add_note` method was added to :exc:`BaseException`. It can be
 used to enrich exceptions with context information which is not available
@@ -417,6 +452,12 @@ Other CPython Implementation Changes
   :data:`sys.path`. Otherwise, initialization will recalculate the path and replace
   any values added to ``module_search_paths``.
 
+* The output of the :option:`--help` option is changed to fit inside 50 lines and 80
+  columns.  Information about :ref:`Python environment variables <using-on-envvars>`
+  and :option:`-X options <-X>` is available with the new :option:`--help-env` or
+  :option:`--help-xoptions` flags, and with :option:`--help-all`.
+  (Contributed by Éric Araujo in :issue:`46142`.)
+
 
 New Modules
 ===========
@@ -454,6 +495,13 @@ asyncio
   holding a group of tasks that will wait for all of them upon exit.
   (Contributed by Yury Seliganov and others.)
 
+contextlib
+----------
+
+Added non parallel-safe :func:`~contextlib.chdir` context manager to change
+the current working directory and then restore it on exit. Simple wrapper
+around :func:`~os.chdir`. (Contributed by Filipe Laíns in :issue:`25625`)
+
 datetime
 --------
 
@@ -561,6 +609,10 @@ hashlib
   OpenSSL support.
   (Contributed by Christian Heimes in :issue:`47098`.)
 
+* Add :func:`hashlib.file_digest`, a helper function for efficient hashing
+  of files or file-like objects.
+  (Contributed by Christian Heimes in :gh:`89313`.)
+
 IDLE and idlelib
 ----------------
 
 
@@ -287,9 +287,9 @@ params[arguments_ty]:
 
 parameters[arguments_ty]:
     | a=slash_no_default b[asdl_arg_seq*]=param_no_default* c=param_with_default* d=[star_etc] {
-        _PyPegen_make_arguments(p, a, NULL, b, c, d) }
+        CHECK_VERSION(arguments_ty, 8, "Positional-only parameters are", _PyPegen_make_arguments(p, a, NULL, b, c, d)) }
     | a=slash_with_default b=param_with_default* c=[star_etc] {
-        _PyPegen_make_arguments(p, NULL, a, NULL, b, c) }
+        CHECK_VERSION(arguments_ty, 8, "Positional-only parameters are", _PyPegen_make_arguments(p, NULL, a, NULL, b, c)) }
     | a[asdl_arg_seq*]=param_no_default+ b=param_with_default* c=[star_etc] {
         _PyPegen_make_arguments(p, NULL, NULL, a, b, c) }
     | a=param_with_default+ b=[star_etc] { _PyPegen_make_arguments(p, NULL, NULL, NULL, a, b)}
@@ -830,9 +830,9 @@ lambda_params[arguments_ty]:
 #
 lambda_parameters[arguments_ty]:
     | a=lambda_slash_no_default b[asdl_arg_seq*]=lambda_param_no_default* c=lambda_param_with_default* d=[lambda_star_etc] {
-        _PyPegen_make_arguments(p, a, NULL, b, c, d) }
+        CHECK_VERSION(arguments_ty, 8, "Positional-only parameters are", _PyPegen_make_arguments(p, a, NULL, b, c, d)) }
     | a=lambda_slash_with_default b=lambda_param_with_default* c=[lambda_star_etc] {
-        _PyPegen_make_arguments(p, NULL, a, NULL, b, c) }
+        CHECK_VERSION(arguments_ty, 8, "Positional-only parameters are", _PyPegen_make_arguments(p, NULL, a, NULL, b, c)) }
     | a[asdl_arg_seq*]=lambda_param_no_default+ b=lambda_param_with_default* c=[lambda_star_etc] {
         _PyPegen_make_arguments(p, NULL, NULL, a, b, c) }
     | a=lambda_param_with_default+ b=[lambda_star_etc] { _PyPegen_make_arguments(p, NULL, NULL, NULL, a, b)}
 
@@ -236,7 +236,7 @@ _Py_ANNOTATE_MEMORY_ORDER(const volatile void *address, _Py_memory_order order)
     in hardware they will fall back to a full memory barrier as well.
 
     This might affect performance but likely only in some very specific and
-    hard to meassure scenario.
+    hard to measure scenario.
 */
 #if defined(_M_IX86) || defined(_M_X64)
 typedef enum _Py_memory_order {
 
@@ -394,7 +394,7 @@ def _get_name_info(name_index, get_name, **extrainfo):
     else:
         return UNKNOWN, ''
 
-def parse_varint(iterator):
+def _parse_varint(iterator):
     b = next(iterator)
     val = b & 63
     while b&64:
@@ -403,16 +403,16 @@ def parse_varint(iterator):
         val |= b&63
     return val
 
-def parse_exception_table(code):
+def _parse_exception_table(code):
     iterator = iter(code.co_exceptiontable)
     entries = []
     try:
         while True:
-            start = parse_varint(iterator)*2
-            length = parse_varint(iterator)*2
+            start = _parse_varint(iterator)*2
+            length = _parse_varint(iterator)*2
             end = start + length
-            target = parse_varint(iterator)*2
-            dl = parse_varint(iterator)
+            target 
538E
= _parse_varint(iterator)*2
+            dl = _parse_varint(iterator)
             depth = dl >> 1
             lasti = bool(dl&1)
             entries.append(_ExceptionTableEntry(start, end, target, depth, lasti))
@@ -527,7 +527,7 @@ def _get_instructions_bytes(code, varname_from_oparg=None,
 def disassemble(co, lasti=-1, *, file=None, show_caches=False, adaptive=False):
     """Disassemble a code object."""
     linestarts = dict(findlinestarts(co))
-    exception_entries = parse_exception_table(co)
+    exception_entries = _parse_exception_table(co)
     _disassemble_bytes(_get_code_array(co, adaptive),
                        lasti, co._varname_from_oparg,
                        co.co_names, co.co_consts, linestarts, file=file,
@@ -717,7 +717,7 @@ def __init__(self, x, *, first_line=None, current_offset=None, show_caches=False
         self._linestarts = dict(findlinestarts(co))
         self._original_object = x
         self.current_offset = current_offset
-        self.exception_entries = parse_exception_table(co)
+        self.exception_entries = _parse_exception_table(co)
         self.show_caches = show_caches
         self.adaptive = adaptive
 
 
@@ -61,41 +61,16 @@ def __init__(self):
         self.join = self.sep.join
 
     def parse_parts(self, parts):
-        parsed = []
+        if not parts:
+            return '', '', []
         sep = self.sep
         altsep = self.altsep
-        drv = root = ''
-        it = reversed(parts)
-        for part in it:
-            if not part:
-                continue
-            if altsep:
-                part = part.replace(altsep, sep)
-            drv, root, rel = self.splitroot(part)
-            if sep in rel:
-                for x in reversed(rel.split(sep)):
-                    if x and x != '.':
-                        parsed.append(sys.intern(x))
-            else:
-                if rel and rel != '.':
-                    parsed.append(sys.intern(rel))
-            if drv or root:
-                if not drv:
-                    # If no drive is present, try to find one in the previous
-                    # parts. This makes the result of parsing e.g.
-                    # ("C:", "/", "a") reasonably intuitive.
-                    for part in it:
-                        if not part:
-                            continue
-                        if altsep:
-                            part = part.replace(altsep, sep)
-                        drv = self.splitroot(part)[0]
-                        if drv:
-                            break
-                break
-        if drv or root:
-            parsed.append(drv + root)
-        parsed.reverse()
+        path = self.pathmod.join(*parts)
+        if altsep:
+            path = path.replace(altsep, sep)
+        drv, root, rel = self.splitroot(path)
+        unfiltered_parsed = [drv + root] + rel.split(sep)
+        parsed = [sys.intern(x) for x in unfiltered_parsed if x and x != '.']
         return drv, root, parsed
 
     def join_parsed_parts(self, drv, root, parts, drv2, root2, parts2):