@@ -102,6 +102,7 @@ Modules/_testinternalcapi/test_cases.c.h            generated
 Modules/_testinternalcapi/test_targets.h            generated
 PC/python3dll.c                                     generated
 Parser/parser.c                                     generated
+Parser/parser_invalid.c                             generated
 Parser/token.c                                      generated
 Programs/test_frozenmain.h                          generated
 Python/Python-ast.c                                 generated
 
@@ -302,6 +302,7 @@ Python/optimizer_symbols.c    @markshannon @tomasr8 @Fidget-Spinner
 
 # Parser, Lexer, and Grammar
 Grammar/python.gram           @pablogsal @lysnikolaou
+Grammar/invalid.gram          @pablogsal @lysnikolaou
 Lib/test/test_peg_generator/  @pablogsal @lysnikolaou
 Lib/test/test_tokenize.py     @pablogsal @lysnikolaou
 Lib/tokenize.py               @pablogsal @lysnikolaou
 
@@ -51,8 +51,6 @@ body:
         - "3.15"
         - "3.16"
         - "CPython main branch"
-    validations:
-      required: true
   - type: textarea
     id: patch
     attributes:
 
@@ -64,6 +64,8 @@ jobs:
     - name: Verify excluded tests still need exclusion
       run: |
         set -euo pipefail
+        # Failures are expected here, don't report them to the job summary
+        unset GITHUB_STEP_SUMMARY
         unexpected_passes=()
         while IFS= read -r test_name; do
           [ -n "$test_name" ] || continue
 
@@ -72,16 +72,19 @@ Lib/test/data/*
 /_bootstrap_python
 /Makefile
 /Makefile.pre
-/iOSTestbed.*
-Apple/iOS/Frameworks/
-Apple/iOS/Resources/Info.plist
-Apple/testbed/build
+/AppleTestbed.*
+Platforms/Apple/iOS/Frameworks/*
+Platforms/Apple/iOS/Resources/Info.plist
 Platforms/Apple/testbed/Python*.xcframework/*/bin
 Platforms/Apple/testbed/Python*.xcframework/*/include
 Platforms/Apple/testbed/Python*.xcframework/*/lib
 Platforms/Apple/testbed/Python*.xcframework/*/Python*.framework
-Apple/testbed/*Testbed.xcodeproj/project.xcworkspace
-Apple/testbed/*Testbed.xcodeproj/xcuserdata
+Platforms/Apple/tvOS/Frameworks/*
+Platforms/Apple/tvOS/Resources/Info.plist
+Platforms/Apple/visionOS/Frameworks/*
+Platforms/Apple/visionOS/Resources/Info.plist
+Platforms/Apple/watchOS/Frameworks/*
+Platforms/Apple/watchOS/Resources/Info.plist
 Mac/Makefile
 Mac/PythonLauncher/Info.plist
 Mac/PythonLauncher/Makefile
 
@@ -354,6 +354,10 @@ are always available.  They are listed here in alphabetical order.
    consists of a single expression, or ``'single'`` if it consists of a single
    interactive statement (in the latter case, expression statements that
    evaluate to something other than ``None`` will be printed).
+   It can also be ``'func_type'`` if *source* consists of a
+   function type signature, for example ``(int) -> str``; see
+   :func:`ast.parse` for more information. This mode requires passing
+   :data:`ast.PyCF_ONLY_AST` in *flags*.
 
    The optional arguments *flags* and *dont_inherit* control which
    :ref:`compiler options <ast-compiler-flags>` should be activated
@@ -427,6 +431,9 @@ are always available.  They are listed here in alphabetical order.
       ``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` can now be passed in flags to enable
       support for top-level ``await``, ``async for``, and ``async with``.
 
+   .. versionchanged:: 3.8
+      Added support for ``mode='func_type'``.
+
    .. versionchanged:: 3.12
       :exc:`SyntaxError` is raised instead of :exc:`ValueError` when null bytes
       are encountered in *source*.
 
@@ -94,11 +94,12 @@ bound into a function.
 
 .. c:function:: int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)
 
-    Return the line number of the instruction that occurs on or before ``byte_offset`` and ends after it.
-    If you just need the line number of a frame, use :c:func:`PyFrame_GetLineNumber` instead.
+    Return the line number of the instruction that occurs on or before
+    ``byte_offset`` and ends after it.  This may be ``O(N)`` in the number of
+    instructions in the code object, so it is not performant for iterating over
+    all the line numbers in a code object.
 
-    For efficiently iterating over the line numbers in a code object, use :pep:`the API described in PEP 626
-    <0626#out-of-process-debuggers-and-profilers>`.
+    If you just need the line number of a frame, use :c:func:`PyFrame_GetLineNumber` instead.
 
 .. c:function:: int PyCode_Addr2Location(PyObject *co, int byte_offset, int *start_line, int *start_column, int *end_line, int *end_column)
 
 
@@ -935,7 +935,7 @@ use them.
              PY_SSIZE_T_MIN
 
    The limit values (largest positive one and smallest negative one,
-   respecitvely) of type :c:type:`Py_ssize_t`.
+   respectively) of type :c:type:`Py_ssize_t`.
 
 
 .. c:macro:: PY_DWORD_MAX
 
@@ -6,7 +6,27 @@ Expat C API
 The :mod:`xml.parsers.expat` module exposes selected Expat functions
 through its ``expat_CAPI`` capsule. This allows extension modules to use the
 same Expat library as Python. The interface is declared in :file:`pyexpat.h`,
-which must be included after Expat's :file:`expat.h` header.
+which is not included by :file:`Python.h` and must be included after Expat's
+:file:`expat.h` header.
+
+To use the C API, add the following code to the extension module
+initialization function and store the pointer to the C API in the module
+state:
+
+.. code-block::
+
+   struct PyExpat_CAPI *capi = NULL;
+   capi = (struct PyExpat_CAPI *)PyCapsule_Import(PyExpat_CAPSULE_NAME, 0);
+   if (capi == NULL) {
+       goto error;
+   }
+   if (!(
+        strcmp(capi->magic, PyExpat_CAPI_MAGIC) == 0
+        && (size_t)capi->size >= sizeof(struct PyExpat_CAPI)
+   )) {
+       PyErr_SetString(PyExc_ImportError, "pyexpat version is incompatible");
+       goto error;
+   }
 
 .. c:macro:: PyExpat_CAPSULE_NAME
 
@@ -20,7 +40,7 @@ which must be included after Expat's :file:`expat.h` header.
    The string identifying the layout of :c:struct:`PyExpat_CAPI`.
    Before using the function pointers in the structure, check that
    its ``magic`` member compares equal to this string using ``strcmp()``
-   and  its ``size`` member is at least :c:expr:`sizeof(struct PyExpat_CAPI)`.
+   and its ``size`` member is at least :c:expr:`sizeof(struct PyExpat_CAPI)`.
 
 
 .. c:struct:: PyExpat_CAPI
@@ -46,7 +66,8 @@ which must be included after Expat's :file:`expat.h` header.
                  int MICRO_VERSION
 
       Major, minor, and micro version numbers of the Expat library used by
-      :mod:`xml.parsers.expat`.
+      :mod:`xml.parsers.expat`, set to ``XML_MAJOR_VERSION``,
+      ``XML_MINOR_VERSION``, and ``XML_MICRO_VERSION`` respectively.
 
    .. c:member:: void (*SetUnknownEncodingHandler)(XML_Parser parser, XML_UnknownEncodingHandler handler, void *encodingHandlerData)
 
@@ -63,14 +84,15 @@ which must be included after Expat's :file:`expat.h` header.
       The *encodingHandlerData* argument is unused.
       Calling this handler requires an :term:`attached thread state`.
 
+      .. versionadded:: 3.3
+
    Pointers to the corresponding Expat functions, or ``NULL`` if not
    available in the Expat version used by :mod:`xml.parsers.expat`, are
    listed below.
 
    Member names omit the ``XML_`` prefix; for example, ``SetHashSalt``
    exposes Expat's ``XML_SetHashSalt`` function. See the `Expat API reference
-   <https://libexpat.github.io/doc/api/latest/>`_ for their behavior
-   and the minimum Expat version they appear in.
+   <https://libexpat.github.io/doc/api/latest/>`_ for their behavior.
 
    .. c:member:: const XML_LChar *(*ErrorString)(enum XML_Error code)
                  enum XML_Error (*GetErrorCode)(XML_Parser parser)
@@ -86,14 +108,53 @@ which must be included after Expat's :file:`expat.h` header.
                  void (*SetNamespaceDeclHandler)(XML_Parser parser, XML_StartNamespaceDeclHandler start, XML_EndNamespaceDeclHandler end)
                  void (*SetProcessingInstructionHandler)(XML_Parser parser, XML_ProcessingInstructionHandler handler)
                  void (*SetUserData)(XML_Parser parser, void *userData)
-                 void (*SetStartDoctypeDeclHandler)(XML_Parser parser, XML_StartDoctypeDeclHandler start)
-                 enum XML_Status (*SetEncoding)(XML_Parser parser, const XML_Char *encoding)
-                 int (*SetHashSalt)(XML_Parser parser, unsigned long hash_salt)
-                 XML_Bool (*SetReparseDeferralEnabled)(XML_Parser parser, XML_Bool enabled)
-                 XML_Bool (*SetAllocTrackerActivationThreshold)(XML_Parser parser, unsigned long long activationThresholdBytes)
-                 XML_Bool (*SetAllocTrackerMaximumAmplification)(XML_Parser parser, float maxAmplificationFactor)
-                 XML_Bool (*SetBillionLaughsAttackProtectionActivationThreshold)(XML_Parser parser, unsigned long long activationThresholdBytes)
-                 XML_Bool (*SetBillionLaughsAttackProtectionMaximumAmplification)(XML_Parser parser, float maxAmplificationFactor)
-                 XML_Bool (*SetHashSalt16Bytes)(XML_Parser parser, const uint8_t entropy[16])
-
-               See the `Expat API reference <https://libexpat.github.io/doc/api/latest/>`_.
+
+   .. c:member:: void (*SetStartDoctypeDeclHandler)(XML_Parser parser, XML_StartDoctypeDeclHandler start)
+
+      .. versionadded:: 3.2
+
+   .. c:member:: enum XML_Status (*SetEncoding)(XML_Parser parser, const XML_Char *encoding)
+
+      .. versionadded:: 3.3
+
+   .. c:member:: int (*SetHashSalt)(XML_Parser parser, unsigned long hash_salt)
+
+      Might be ``NULL`` for Expat versions prior to 2.1.0.
+
+      .. versionadded:: 3.4
+
+   .. c:member:: XML_Bool (*SetReparseDeferralEnabled)(XML_Parser parser, XML_Bool enabled)
+
+      Might be ``NULL`` for Expat versions prior to 2.6.0.
+
+      .. versionadded:: 3.8
+
+   .. c:member:: XML_Bool (*SetAllocTrackerActivationThreshold)(XML_Parser parser, unsigned long long activationThresholdBytes)
+
+      Might be ``NULL`` for Expat versions prior to 2.7.2.
+
+      .. versionadded:: 3.10
+
+   .. c:member:: XML_Bool (*SetAllocTrackerMaximumAmplification)(XML_Parser parser, float maxAmplificationFactor)
+
+      Might be ``NULL`` for Expat versions prior to 2.7.2.
+
+      .. versionadded:: 3.10
+
+   .. c:member:: XML_Bool (*SetBillionLaughsAttackProtectionActivationThreshold)(XML_Parser parser, unsigned long long activationThresholdBytes)
+
+      Might be ``NULL`` for Expat versions prior to 2.4.0.
+
+      .. versionadded:: 3.10
+
+   .. c:member:: XML_Bool (*SetBillionLaughsAttackProtectionMaximumAmplification)(XML_Parser parser, float maxAmplificationFactor)
+
+      Might be ``NULL`` for Expat versions prior to 2.4.0.
+
+      .. versionadded:: 3.10
+
+   .. c:member:: XML_Bool (*SetHashSalt16Bytes)(XML_Parser parser, const uint8_t entropy[16])
+
+      Might be ``NULL`` for Expat versions prior to 2.8.0.
+
+      .. versionadded:: 3.16
@@ -86,6 +86,13 @@
 .. |python_x_dot_y_literal| replace:: ``python{version}``
 .. |python_x_dot_y_t_literal| replace:: ``python{version}t``
 .. |python_x_dot_y_t_literal_config| replace:: ``python{version}t-config``
+.. |python_x_dot_y_exe_literal| replace:: ``python{version}.exe``
+.. |python_x_dot_y_t_exe_literal| replace:: ``python{version}t.exe``
+.. |python_xy_dll_literal| replace:: ``python{v.major}{v.minor}.dll``
+.. |py_v_x_dot_y_literal| replace:: ``py -V:{version}``
+.. |py_v_x_dot_y_t_literal| replace:: ``py -V:{version}t``
+.. |x_dot_y_literal| replace:: ``{version}``
+.. |x_dot_y_64_literal| replace:: ``{version}-64``
 .. |x_dot_y_b2_literal| replace:: ``{version}.0b2``
 .. |applications_python_version_literal| replace:: ``/Applications/Python {version}/``
 .. |usr_local_bin_python_x_dot_y_literal| replace:: ``/usr/local/bin/python{version}``