Update Python signal-handling documentation
authorTom Tromey <tromey@adacore.com>
Mon, 11 Sep 2023 15:21:26 +0000 (09:21 -0600)
committerTom Tromey <tromey@adacore.com>
Mon, 11 Sep 2023 16:41:19 +0000 (10:41 -0600)
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>
gdb/doc/python.texi

index e9936991c495bd7ebb100565a030d84256c73e55..5b13958aeaf4aa345cde867195992173d0b1a4e7 100644 (file)
@@ -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