]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.6] Doc: Delete "how do I emulate os.kill" section in Windows FAQ (GH-10487) (GH...
authorJulien Palard <julien@palard.fr>
Wed, 28 Nov 2018 16:09:18 +0000 (17:09 +0100)
committerGitHub <noreply@github.com>
Wed, 28 Nov 2018 16:09:18 +0000 (17:09 +0100)
That section is a tip on how to kill process on Windows for Python prior to 2.7 and 3.2.
3.1 end of support was April 2012 and 2.6 was October 2013, so that hasn't been need for supported versions of Python for more than 5 years. Beside not being needed anymore for a long time, when I read it with the eyes of a Python profane, it makes Python looks bad, like a language from the parts with warts you need to circumvent.
Let's delete that :).
(cherry picked from commit a1c40014085d5cc6c12064577e8c10e7182ee9f9)

Co-authored-by: Mathieu Dupuy <deronnax@users.noreply.github.com>
Doc/faq/windows.rst

index 772b8c2012c302774655340cc19c009c0c5e8d00..2b44f65692b85c41e3d975b321bb80ec8b1a534a 100644 (file)
@@ -280,24 +280,3 @@ How do I check for a keypress without blocking?
 Use the msvcrt module.  This is a standard Windows-specific extension module.
 It defines a function ``kbhit()`` which checks whether a keyboard hit is
 present, and ``getch()`` which gets one character without echoing it.
-
-
-How do I emulate os.kill() in Windows?
---------------------------------------
-
-Prior to Python 2.7 and 3.2, to terminate a process, you can use :mod:`ctypes`:
-
-.. code-block:: python
-
-   import ctypes
-
-   def kill(pid):
-       """kill function for Win32"""
-       kernel32 = ctypes.windll.kernel32
-       handle = kernel32.OpenProcess(1, 0, pid)
-       return (0 != kernel32.TerminateProcess(handle, 0))
-
-In 2.7 and 3.2, :func:`os.kill` is implemented similar to the above function,
-with the additional feature of being able to send :kbd:`Ctrl+C` and :kbd:`Ctrl+Break`
-to console subprocesses which are designed to handle those signals. See
-:func:`os.kill` for further details.