Feb 12, 2024 · Feb 12, 2024
diff --git a/Doc/library/asyncio-protocol.rst b/Doc/library/asyncio-protocol.rst

   Stop the subprocess.

   On POSIX systems, this method sends SIGTERM to the subprocess.
   On Windows, the Windows API function TerminateProcess() is called to
   On POSIX systems, this method sends:py:const:`~signal.SIGTERM` to the subprocess.
   On Windows, the Windows API function:c:func:`!TerminateProcess` is called to
   stop the subprocess.

   See also :meth:`subprocess.Popen.terminate`.
diff --git a/Doc/library/asyncio-subprocess.rst b/Doc/library/asyncio-subprocess.rst

      .. note::

         On Windows, :py:data:`SIGTERM` is an alias for :meth:`terminate`.
         On Windows, :py:const:`~signal.SIGTERM` is an alias for :meth:`terminate`.
         ``CTRL_C_EVENT`` and ``CTRL_BREAK_EVENT`` can be sent to processes
         started with a *creationflags* parameter which includes
         ``CREATE_NEW_PROCESS_GROUP``.

      Stop the child process.

      On POSIX systems this method sends :py:const:`signal.SIGTERM` to the
      On POSIX systems this method sends :py:const:`~signal.SIGTERM` to the
      child process.

      On Windows the Win32 API function :c:func:`TerminateProcess` is
      On Windows the Win32 API function :c:func:`!TerminateProcess` is
      called to stop the child process.

   .. method:: kill()
diff --git a/Doc/library/msvcrt.rst b/Doc/library/msvcrt.rst
 .. function:: heapmin()

   Force the :c:func:`malloc` heap to clean itself up and return unused blocks to
   the operating system.  On failure, this raises :exc:`OSError`.
   the operating system. On failure, this raises :exc:`OSError`.


 .. data:: CRT_ASSEMBLY_VERSION

   The CRT Assembly version, from the :file:`crtassem.h` header file.


 .. data:: VC_ASSEMBLY_PUBLICKEYTOKEN

   The VC Assembly public key token, from the :file:`crtassem.h` header file.


 .. data:: LIBRARIES_ASSEMBLY_NAME_PREFIX

   The Libraries Assembly name prefix, from the :file:`crtassem.h` header file.
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst

   .. method:: terminate()

      Terminate the process.  OnUnix this is done using the``SIGTERM`` signal;
      on Windows :c:func:`TerminateProcess` is used.  Note that exit handlers and
      Terminate the process.  OnPOSIX this is done using the:py:const:`~signal.SIGTERM` signal;
      on Windows :c:func:`!TerminateProcess` is used.  Note that exit handlers and
      finally clauses, etc., will not be executed.

      Note that descendant processes of the process will *not* be terminated --
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst

 .. method:: Popen.terminate()

   Stop the child. On POSIX OSs the method sends SIGTERM to the
   child. On Windows the Win32 API function :c:func:`TerminateProcess` is called
   Stop the child. On POSIX OSs the method sends:py:const:`~signal.SIGTERM` to the
   child. On Windows the Win32 API function :c:func:`!TerminateProcess` is called
   to stop the child.


diff --git a/Doc/whatsnew/2.6.rst b/Doc/whatsnew/2.6.rst
  using the format character ``'?'``.
  (Contributed by David Remahl.)

 * The :class:`Popen` objects provided by the :mod:`subprocess` module
  now have :meth:`terminate`, :meth:`kill`, and :meth:`send_signal` methods.
  On Windows, :meth:`send_signal` only supports the :const:`SIGTERM`
 * The :class:`~subprocess.Popen` objects provided by the :mod:`subprocess` module
  now have :meth:`~subprocess.Popen.terminate`, :meth:`~subprocess.Popen.kill`, and :meth:`~subprocess.Popen.send_signal` methods.
  On Windows, :meth:`!send_signal` only supports the :py:const:`~signal.SIGTERM`
  signal, and all these methods are aliases for the Win32 API function
  :c:func:`TerminateProcess`.
  :c:func:`!TerminateProcess`.
  (Contributed by Christian Heimes.)

 * A new variable in the :mod:`sys` module, :attr:`float_info`, is an
diff --git a/Doc/whatsnew/2.7.rst b/Doc/whatsnew/2.7.rst
diff --git a/Doc/whatsnew/3.1.rst b/Doc/whatsnew/3.1.rst
    ...         if '<critical>' in line:
    ...             outfile.write(line)

  With the new syntax, the :func:`contextlib.nested` function is no longer
  With the new syntax, the :func:`!contextlib.nested` function is no longer
  needed and is now deprecated.

  (Contributed by Georg Brandl and Mattias Brändström;
diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst

 Two methods have been deprecated:

 * :meth:`xml.etree.ElementTree.getchildren` use ``list(elem)`` instead.
 * :meth:`xml.etree.ElementTree.getiterator` use ``Element.iter`` instead.
 * :meth:`!xml.etree.ElementTree.getchildren` use ``list(elem)`` instead.
 * :meth:`!xml.etree.ElementTree.getiterator` use ``Element.iter`` instead.

 For details of the update, see `Introducing ElementTree
 <https://web.archive.org/web/20200703234532/http://effbot.org/zone/elementtree-13-intro.htm>`_

  (Contributed by Georg Brandl; :issue:`5675`.)

 * The previously deprecated :func:`contextlib.nested` function has been removed
 * The previously deprecated :func:`!contextlib.nested` function has been removed
  in favor of a plain :keyword:`with` statement which can accept multiple
  context managers.  The latter technique is faster (because it is built-in),
  and it does a better job finalizing multiple context managers when one of them
Original file line number	Diff line number	Diff line change
Expand Up		@@ -417,8 +417,8 @@ Subprocess Transports

		Stop the subprocess.

		On POSIX systems, this method sends SIGTERM to the subprocess.
		On Windows, the Windows API function TerminateProcess() is called to
		On POSIX systems, this method sends:py:const:`~signal.SIGTERM` to the subprocess.
		On Windows, the Windows API function:c:func:`!TerminateProcess` is called to
		stop the subprocess.

		See also :meth:`subprocess.Popen.terminate`.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -235,7 +235,7 @@ their completion.

		.. note::

		On Windows, :py:data:`SIGTERM` is an alias for :meth:`terminate`.
		On Windows, :py:const:`~signal.SIGTERM` is an alias for :meth:`terminate`.
		``CTRL_C_EVENT`` and ``CTRL_BREAK_EVENT`` can be sent to processes
		started with a creationflags parameter which includes
		``CREATE_NEW_PROCESS_GROUP``.
Expand All		@@ -244,10 +244,10 @@ their completion.

		Stop the child process.

		On POSIX systems this method sends :py:const:`signal.SIGTERM` to the
		On POSIX systems this method sends :py:const:`~signal.SIGTERM` to the
		child process.

		On Windows the Win32 API function :c:func:`TerminateProcess` is
		On Windows the Win32 API function :c:func:`!TerminateProcess` is
		called to stop the child process.

		.. method:: kill()
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -157,4 +157,19 @@ Other Functions
		.. function:: heapmin()

		Force the :c:func:`malloc` heap to clean itself up and return unused blocks to
		the operating system. On failure, this raises :exc:`OSError`.
		the operating system. On failure, this raises :exc:`OSError`.


		.. data:: CRT_ASSEMBLY_VERSION

		The CRT Assembly version, from the :file:`crtassem.h` header file.


		.. data:: VC_ASSEMBLY_PUBLICKEYTOKEN

		The VC Assembly public key token, from the :file:`crtassem.h` header file.


		.. data:: LIBRARIES_ASSEMBLY_NAME_PREFIX

		The Libraries Assembly name prefix, from the :file:`crtassem.h` header file.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -636,8 +636,8 @@ The :mod:`multiprocessing` package mostly replicates the API of the

		.. method:: terminate()

		Terminate the process. OnUnix this is done using the``SIGTERM`` signal;
		on Windows :c:func:`TerminateProcess` is used. Note that exit handlers and
		Terminate the process. OnPOSIX this is done using the:py:const:`~signal.SIGTERM` signal;
		on Windows :c:func:`!TerminateProcess` is used. Note that exit handlers and
		finally clauses, etc., will not be executed.

		Note that descendant processes of the process will not be terminated --
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -859,8 +859,8 @@ Instances of the :class:`Popen` class have the following methods:

		.. method:: Popen.terminate()

		Stop the child. On POSIX OSs the method sends SIGTERM to the
		child. On Windows the Win32 API function :c:func:`TerminateProcess` is called
		Stop the child. On POSIX OSs the method sends:py:const:`~signal.SIGTERM` to the
		child. On Windows the Win32 API function :c:func:`!TerminateProcess` is called
		to stop the child.


Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2388,11 +2388,11 @@ changes, or look through the Subversion logs for all the details.
		using the format character ``'?'``.
		(Contributed by David Remahl.)

		* The :class:`Popen` objects provided by the :mod:`subprocess` module
		now have :meth:`terminate`, :meth:`kill`, and :meth:`send_signal` methods.
		On Windows, :meth:`send_signal` only supports the :const:`SIGTERM`
		* The :class:`~subprocess.Popen` objects provided by the :mod:`subprocess` module
		now have :meth:`~subprocess.Popen.terminate`, :meth:`~subprocess.Popen.kill`, and :meth:`~subprocess.Popen.send_signal` methods.
		On Windows, :meth:`!send_signal` only supports the :py:const:`~signal.SIGTERM`
		signal, and all these methods are aliases for the Win32 API function
		:c:func:`TerminateProcess`.
		:c:func:`!TerminateProcess`.
		(Contributed by Christian Heimes.)

		* A new variable in the :mod:`sys` module, :attr:`float_info`, is an
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -169,7 +169,7 @@ Some smaller changes made to the core Python language are:
		... if '<critical>' in line:
		... outfile.write(line)

		With the new syntax, the :func:`contextlib.nested` function is no longer
		With the new syntax, the :func:`!contextlib.nested` function is no longer
		needed and is now deprecated.

		(Contributed by Georg Brandl and Mattias Brändström;
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -741,8 +741,8 @@ Several new and useful functions and methods have been added:

		Two methods have been deprecated:

		* :meth:`xml.etree.ElementTree.getchildren` use ``list(elem)`` instead.
		* :meth:`xml.etree.ElementTree.getiterator` use ``Element.iter`` instead.
		* :meth:`!xml.etree.ElementTree.getchildren` use ``list(elem)`` instead.
		* :meth:`!xml.etree.ElementTree.getiterator` use ``Element.iter`` instead.

		For details of the update, see `Introducing ElementTree
		<https://web.archive.org/web/20200703234532/http://effbot.org/zone/elementtree-13-intro.htm>`_
Expand DownExpand Up		@@ -2680,7 +2680,7 @@ require changes to your code:

		(Contributed by Georg Brandl; :issue:`5675`.)

		* The previously deprecated :func:`contextlib.nested` function has been removed
		* The previously deprecated :func:`!contextlib.nested` function has been removed
		in favor of a plain :keyword:`with` statement which can accept multiple
		context managers. The latter technique is faster (because it is built-in),
		and it does a better job finalizing multiple context managers when one of them
Expand Down