Merge branch 'main' into inlinecomp2

* main: (82 commits)
  pythongh-101670: typo fix in PyImport_ExtendInittab() (python#101723)
  pythonGH-99293: Document that `Py_TPFLAGS_VALID_VERSION_TAG` shouldn't be used. (#pythonGH-101736)
  no-issue: Add Dong-hee Na as the cjkcodecs codeowner (pythongh-101731)
  pythongh-101678: Merge math_1_to_whatever() and math_1() (python#101730)
  pythongh-101678: refactor the math module to use special functions from c11 (pythonGH-101679)
  pythongh-85984: Remove legacy Lib/pty.py code. (python#92365)
  pythongh-98831: Use opcode metadata for stack_effect() (python#101704)
  pythongh-101283: Version was just released, so should be changed in 3.11.3 (pythonGH-101719)
  pythongh-101283: Fix use of unbound variable (pythonGH-101712)
  pythongh-101283: Improved fallback logic for subprocess with shell=True on Windows (pythonGH-101286)
  pythongh-101277: Port more itertools static types to heap types (python#101304)
  pythongh-98831: Modernize CALL and family (python#101508)
  pythonGH-101696: invalidate type version tag in `_PyStaticType_Dealloc` (python#101697)
  pythongh-100221: Fix creating dirs in `make sharedinstall` (pythonGH-100329)
  pythongh-101670: typo fix in PyImport_AppendInittab() (pythonGH-101672)
  pythongh-101196: Make isdir/isfile/exists faster on Windows (pythonGH-101324)
  pythongh-101614: Don't treat python3_d.dll as a Python DLL when checking extension modules for incompatibility (pythonGH-101615)
  pythongh-100933: Improve `check_element` helper in `test_xml_etree` (python#100934)
  pythonGH-101578: Normalize the current exception (pythonGH-101607)
  pythongh-47937: Note that Popen attributes are read-only (python#93070)
  ...

.github/CODEOWNERS

@@ -151,6 +151,8 @@ Lib/ast.py @isidentical
 
 **/*sysconfig* @FFY00
 
+**/*cjkcodecs* @corona10
+
 # macOS
 /Mac/ @python/macos-team
 **/*osx_support* @python/macos-team

Doc/bugs.rst

@@ -19,6 +19,9 @@ If you find a bug in this documentation or would like to propose an improvement,
 please submit a bug report on the :ref:`tracker <using-the-tracker>`. If you
 have a suggestion on how to fix it, include that as well.
 
+You can also open a discussion item on our
+`Documentation Discourse forum <https://discuss.python.org/c/documentation/26>`_.
+
 If you're short on time, you can also email documentation bug reports to
 docs@python.org (behavioral bugs can be sent to python-list@python.org).
 'docs@' is a mailing list run by volunteers; your request will be noticed,

Doc/c-api/code.rst

@@ -77,6 +77,8 @@ bound into a function.
 
  Returns ``1`` if the function succeeds and 0 otherwise.
 
+ .. versionadded:: 3.11
+
 .. c:function:: PyObject* PyCode_GetCode(PyCodeObject *co)
 
  Equivalent to the Python code ``getattr(co, 'co_code')``.

Doc/c-api/exceptions.rst

@@ -400,8 +400,61 @@ Querying the error indicator
  recursively in subtuples) are searched for a match.
 
 
+.. c:function:: PyObject *PyErr_GetRaisedException(void)
+
+ Returns the exception currently being raised, clearing the exception at
+ the same time. Do not confuse this with the exception currently being
+ handled which can be accessed with :c:func:`PyErr_GetHandledException`.
+
+ .. note::
+
+ This function is normally only used by code that needs to catch exceptions or
+ by code that needs to save and restore the error indicator temporarily, e.g.::
+
+ {
+ PyObject *exc = PyErr_GetRaisedException();
+
+ /* ... code that might produce other errors ... */
+
+ PyErr_SetRaisedException(exc);
+ }
+
+ .. versionadded:: 3.12
+
+
+.. c:function:: void PyErr_SetRaisedException(PyObject *exc)
+
+ Sets the exception currently being raised ``exc``.
+ If the exception is already set, it is cleared first.
+
+ ``exc`` must be a valid exception.
+ (Violating this rules will cause subtle problems later.)
+ This call consumes a reference to the ``exc`` object: you must own a
+ reference to that object before the call and after the call you no longer own
+ that reference.
+ (If you don't understand this, don't use this function. I warned you.)
+
+ .. note::
+
+ This function is normally only used by code that needs to save and restore the
+ error indicator temporarily. Use :c:func:`PyErr_GetRaisedException` to save
+ the current exception, e.g.::
+
+ {
+ PyObject *exc = PyErr_GetRaisedException();
+
+ /* ... code that might produce other errors ... */
+
+ PyErr_SetRaisedException(exc);
+ }
+
+ .. versionadded:: 3.12
+
+
 .. c:function:: void PyErr_Fetch(PyObject **ptype, PyObject **pvalue, PyObject **ptraceback)
 
+ As of 3.12, this function is deprecated. Use :c:func:`PyErr_GetRaisedException` instead.
+
  Retrieve the error indicator into three variables whose addresses are passed.
  If the error indicator is not set, set all three variables to ``NULL``. If it is
  set, it will be cleared and you own a reference to each object retrieved. The
@@ -421,10 +474,14 @@ Querying the error indicator
  PyErr_Restore(type, value, traceback);
  }
 
+ .. deprecated:: 3.12
+
 
 .. c:function:: void PyErr_Restore(PyObject *type, PyObject *value, PyObject *traceback)
 
- Set the error indicator from the three objects. If the error indicator is
+ As of 3.12, this function is deprecated. Use :c:func:`PyErr_SetRaisedException` instead.
+
+ Set the error indicator from the three objects. If the error indicator is
  already set, it is cleared first. If the objects are ``NULL``, the error
  indicator is cleared. Do not pass a ``NULL`` type and non-``NULL`` value or
  traceback. The exception type should be a class. Do not pass an invalid
@@ -440,9 +497,15 @@ Querying the error indicator
  error indicator temporarily. Use :c:func:`PyErr_Fetch` to save the current
  error indicator.
 
+ .. deprecated:: 3.12
+
 
 .. c:function:: void PyErr_NormalizeException(PyObject **exc, PyObject **val, PyObject **tb)
 
+ As of 3.12, this function is deprecated.
+ Use :c:func:`PyErr_GetRaisedException` instead of :c:func:`PyErr_Fetch` to avoid
+ any possible de-normalization.
+
  Under certain circumstances, the values returned by :c:func:`PyErr_Fetch` below
  can be "unnormalized", meaning that ``*exc`` is a class object but ``*val`` is
  not an instance of the same class. This function can be used to instantiate
@@ -459,6 +522,8 @@ Querying the error indicator
  PyException_SetTraceback(val, tb);
  }
 
+ .. deprecated:: 3.12
+
 
 .. c:function:: PyObject* PyErr_GetHandledException(void)
 
@@ -704,6 +769,18 @@ Exception Objects
  :attr:`__suppress_context__` is implicitly set to ``True`` by this function.
 
 
+.. c:function:: PyObject* PyException_GetArgs(PyObject *ex)
+
+ Return args of the given exception as a new reference,
+ as accessible from Python through :attr:`args`.
+
+
+.. c:function:: void PyException_SetArgs(PyObject *ex, PyObject *args)
+
+ Set the args of the given exception,
+ as accessible from Python through :attr:`args`.
+
+
 .. _unicodeexceptions:
 
 Unicode Exception Objects

Doc/c-api/typeobj.rst

@@ -1313,6 +1313,16 @@ and :c:type:`PyType_Type` effectively act as defaults.)
  .. versionadded:: 3.10
 
 
+ .. data:: Py_TPFLAGS_VALID_VERSION_TAG
+
+ Internal. Do not set or unset this flag.
+ To indicate that a class has changed call :c:func:`PyType_Modified`
+
+ .. warning::
+ This flag is present in header files, but is an internal feature and should
+ not be used. It will be removed in a future version of CPython
+
+
 .. c:member:: const char* PyTypeObject.tp_doc
 
  An optional pointer to a NUL-terminated C string giving the docstring for this

Doc/library/argparse.rst

@@ -31,7 +31,7 @@ Core Functionality
 
 The :mod:`argparse` module's support for command-line interfaces is built
 around an instance of :class:`argparse.ArgumentParser`. It is a container for
-argument specifications and has options that apply the parser as whole::
+argument specifications and has options that apply to the parser as whole::
 
  parser = argparse.ArgumentParser(
  prog = 'ProgramName',