The signal.set_wakeup_fd() function is used to write signal numbers as bytes into a pipe, to be able to handle signals using a "regular" file descriptors instead of special signal handlers. https://docs.python.org/dev/library/signal.html Problem: it's not documented how to unregister the FD. I just saw "signal.set_wakeup_fd(-1)" in a Pull Request and realized that we forgot to document it: https://github.com/python/cpython/pull/2139/ This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-) Doc/library/signal.rst should be modified. I read that it's even possible to create a PR using an online editor? I never tried: https://github.com/python/cpython/blob/master/Doc/library/signal.rst
> This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-) Too late, sorry!
> This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-) Oh wait, it seems like the core developer Antoine Pitrou fixed the issue before I created it! => commit d79c1d4a9406384f10a37f26a7515ce79f9fdd78 He already created 3 PR to backport the doc enhancement to 2.7, 3.5 and 3.6 branches. Sorry!