From 2781d523681d833655c18eb7d2755c6da9316ad5 Mon Sep 17 00:00:00 2001 From: Weilin Du <108666168+LamentXU123@users.noreply.github.com> Date: Sat, 11 Oct 2025 08:46:23 +0800 Subject: [PATCH 1/5] Update signal.rst --- Doc/library/signal.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst index ccdf5027ff9841..1a4a93e32e23ce 100644 --- a/Doc/library/signal.rst +++ b/Doc/library/signal.rst @@ -205,12 +205,6 @@ The variables defined in the :mod:`signal` module are: .. availability:: Unix. -.. data:: SIGPROF - - Profiling timer expired. - - .. availability:: Unix. - .. data:: SIGQUIT Terminal quit signal. @@ -253,6 +247,12 @@ The variables defined in the :mod:`signal` module are: .. availability:: Unix. +.. data:: SIGPROF + + Profiling timer expired. + + .. availability:: Unix. + .. data:: SIGVTALRM Virtual timer expired. @@ -270,7 +270,7 @@ The variables defined in the :mod:`signal` module are: All the signal numbers are defined symbolically. For example, the hangup signal is defined as :const:`signal.SIGHUP`; the variable names are identical to the names used in C programs, as found in ````. The Unix man page for - ':c:func:`signal`' lists the existing signals (on some systems this is + ':c:func:`!signal`' lists the existing signals (on some systems this is :manpage:`signal(2)`, on others the list is in :manpage:`signal(7)`). Note that not all systems define the same set of signal names; only those names defined by the system are defined by this module. @@ -666,9 +666,9 @@ The :mod:`signal` module defines the following functions: *sigset*. The return value is an object representing the data contained in the - :c:type:`siginfo_t` structure, namely: :attr:`si_signo`, :attr:`si_code`, - :attr:`si_errno`, :attr:`si_pid`, :attr:`si_uid`, :attr:`si_status`, - :attr:`si_band`. + :c:type:`siginfo_t` structure, namely: :attr:`!si_signo`, :attr:`!si_code`, + :attr:`!si_errno`, :attr:`!si_pid`, :attr:`!si_uid`, :attr:`!si_status`, + :attr:`!si_band`. .. availability:: Unix. From 4f0b563750a6ce1b2c47738582d4aef3e88b6a54 Mon Sep 17 00:00:00 2001 From: Weilin Du <108666168+LamentXU123@users.noreply.github.com> Date: Sat, 11 Oct 2025 08:54:34 +0800 Subject: [PATCH 2/5] Update signal.rst --- Doc/library/signal.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst index 1a4a93e32e23ce..c5b8fed9d887e8 100644 --- a/Doc/library/signal.rst +++ b/Doc/library/signal.rst @@ -205,6 +205,12 @@ The variables defined in the :mod:`signal` module are: .. availability:: Unix. +.. data:: SIGPROF + + Profiling timer expired. + + .. availability:: Unix. + .. data:: SIGQUIT Terminal quit signal. @@ -247,12 +253,6 @@ The variables defined in the :mod:`signal` module are: .. availability:: Unix. -.. data:: SIGPROF - - Profiling timer expired. - - .. availability:: Unix. - .. data:: SIGVTALRM Virtual timer expired. From fe87221b3dfbfa1dc54d7c4bc727bb203be80d27 Mon Sep 17 00:00:00 2001 From: Weilin Du <108666168+LamentXU123@users.noreply.github.com> Date: Sat, 11 Oct 2025 09:02:48 +0800 Subject: [PATCH 3/5] Update .nitignore --- Doc/tools/.nitignore | 1 - 1 file changed, 1 deletion(-) diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index 657d720e766179..60a80fe2c72a72 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -29,7 +29,6 @@ Doc/library/profile.rst Doc/library/pyexpat.rst Doc/library/resource.rst Doc/library/select.rst -Doc/library/signal.rst Doc/library/smtplib.rst Doc/library/socket.rst Doc/library/ssl.rst From 211b1d8cbe9b34e5f49891858b9930df240c836c Mon Sep 17 00:00:00 2001 From: Weilin Du <108666168+LamentXU123@users.noreply.github.com> Date: Sat, 11 Oct 2025 22:03:57 +0800 Subject: [PATCH 4/5] change to inline codeblocks --- Doc/library/signal.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst index c5b8fed9d887e8..7f07d24c25a554 100644 --- a/Doc/library/signal.rst +++ b/Doc/library/signal.rst @@ -666,9 +666,8 @@ The :mod:`signal` module defines the following functions: *sigset*. The return value is an object representing the data contained in the - :c:type:`siginfo_t` structure, namely: :attr:`!si_signo`, :attr:`!si_code`, - :attr:`!si_errno`, :attr:`!si_pid`, :attr:`!si_uid`, :attr:`!si_status`, - :attr:`!si_band`. + :c:type:`siginfo_t` structure, namely: ``si_signo``, ``si_code``, + ``si_errno``, ``si_pid``, ``si_uid``, ``si_status``, ``si_band``. .. availability:: Unix. From 3aae489c84b7ac79c29baea3bfd856a7d4a24491 Mon Sep 17 00:00:00 2001 From: Weilin Du <108666168+LamentXU123@users.noreply.github.com> Date: Sun, 12 Oct 2025 00:15:05 +0800 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> --- Doc/library/signal.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst index 7f07d24c25a554..47f824488f5bf1 100644 --- a/Doc/library/signal.rst +++ b/Doc/library/signal.rst @@ -270,7 +270,7 @@ The variables defined in the :mod:`signal` module are: All the signal numbers are defined symbolically. For example, the hangup signal is defined as :const:`signal.SIGHUP`; the variable names are identical to the names used in C programs, as found in ````. The Unix man page for - ':c:func:`!signal`' lists the existing signals (on some systems this is + '``signal``' lists the existing signals (on some systems this is :manpage:`signal(2)`, on others the list is in :manpage:`signal(7)`). Note that not all systems define the same set of signal names; only those names defined by the system are defined by this module. @@ -666,7 +666,7 @@ The :mod:`signal` module defines the following functions: *sigset*. The return value is an object representing the data contained in the - :c:type:`siginfo_t` structure, namely: ``si_signo``, ``si_code``, + ``siginfo_t`` structure, namely: ``si_signo``, ``si_code``, ``si_errno``, ``si_pid``, ``si_uid``, ``si_status``, ``si_band``. .. availability:: Unix.