[binutils-gdb] Update Python signal-handling documentation
Tom Tromey
tromey@sourceware.org
Mon Sep 11 16:48:18 GMT 2023
https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=14432bde076fdee66e6163993eadf592742935da
commit 14432bde076fdee66e6163993eadf592742935da
Author: Tom Tromey <tromey@adacore.com>
Date: Mon Sep 11 09:21:26 2023 -0600
Update Python signal-handling documentation
I noticed a typo in the "Basic Python" node, and when fixing it
realized that the paragraph could use a link to the block_signals
function. This patch is the result.
Approved-By: Eli Zaretskii <eliz@gnu.org>
Diff:
---
gdb/doc/python.texi | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index e9936991c49..5b13958aeaf 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -247,12 +247,14 @@ Some care must be taken when writing Python code to run in
@itemize @bullet
@item
-@value{GDBN} install handlers for @code{SIGCHLD} and @code{SIGINT}.
+@value{GDBN} installs handlers for @code{SIGCHLD} and @code{SIGINT}.
Python code must not override these, or even change the options using
@code{sigaction}. If your program changes the handling of these
signals, @value{GDBN} will most likely stop working correctly. Note
that it is unfortunately common for GUI toolkits to install a
-@code{SIGCHLD} handler.
+@code{SIGCHLD} handler. When creating a new Python thread, you can
+use @code{gdb.block_signals} or @code{gdb.Thread} to handle this
+correctly; see @ref{Threading in GDB}.
@item
@value{GDBN} takes care to mark its internal file descriptors as
More information about the Gdb-cvs
mailing list