diff options
| author | Gregory P. Smith <greg@krypto.org> | 2022-11-13 20:21:19 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-11-13 20:21:19 (GMT) |
| commit | 51c68cf466ea7886fce05706a5870aac94b971b3 (patch) | |
| tree | 3ea98d0c5af6d1baa280e8f29f550e6413cc6e92 /Modules/signalmodule.c | |
| parent | bf76d9bd4dd7ef2a3467f637cfdff0215d922553 (diff) | |
| download | cpython-51c68cf466ea7886fce05706a5870aac94b971b3.zip cpython-51c68cf466ea7886fce05706a5870aac94b971b3.tar.gz cpython-51c68cf466ea7886fce05706a5870aac94b971b3.tar.bz2 | |
[3.11] gh-98930: improve the docstring of signal.strsignal (GH-99290) (#99449)
Improves the docstring on signal.strsignal to make it explain when it returns a message, None, or when it raises ValueError.
Closes GH-98930
Co-authored-by: Gregory P. Smith <greg@krypto.org>.
(cherry picked from commit 88385b856490a5ce3c99160bde6050638f81f72e)
Co-authored-by: ram vikram singh <ramvikrams243@gmail.com>
Diffstat (limited to 'Modules/signalmodule.c')
| -rw-r--r-- | Modules/signalmodule.c | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/Modules/signalmodule.c b/Modules/signalmodule.c index 0f30b4d..60a8067 100644 --- a/Modules/signalmodule.c +++ b/Modules/signalmodule.c @@ -627,13 +627,14 @@ signal.strsignal Return the system description of the given signal. -The return values can be such as "Interrupt", "Segmentation fault", etc. -Returns None if the signal is not recognized. +Returns the description of signal *signalnum*, such as "Interrupt" +for :const:`SIGINT`. Returns :const:`None` if *signalnum* has no +description. Raises :exc:`ValueError` if *signalnum* is invalid. [clinic start generated code]*/ static PyObject * signal_strsignal_impl(PyObject *module, int signalnum) -/*[clinic end generated code: output=44e12e1e3b666261 input=b77914b03f856c74]*/ +/*[clinic end generated code: output=44e12e1e3b666261 input=238b335847778bc0]*/ { const char *res; |