From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1726) id 617453858D1E; Mon, 6 Feb 2023 14:57:27 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 617453858D1E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1675695447; bh=F2VVfMsBCnNc6RJU7pxpHt5Vr3Rsn5unx/st1umbH/A=; h=From:To:Subject:Date:From; b=SY9EOX70A4ZpI54fP/a6BgtBEOcLbJF09y+hH6URvbiMPcwBSVGdNdFGjE5k/Ly5y NSSBxdNmMK+3eueUzrlggB40YB3SmMq3jUoPAxCci4Ia5vLltvV38CGWxe1KtqInit 75w3r/L6lPTTw8rkQW4BPg6Yq6IEGcrkaFngkYts= Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Andrew Burgess To: gdb-cvs@sourceware.org Subject: [binutils-gdb] gdb/doc: extend the documentation for the 'handle' command X-Act-Checkin: binutils-gdb X-Git-Author: Andrew Burgess X-Git-Refname: refs/heads/master X-Git-Oldrev: 84789002905d6db444ee76431705c86cbcde5616 X-Git-Newrev: 85df9457b72e4a198b4edfc908017612fca59509 Message-Id: <20230206145727.617453858D1E@sourceware.org> Date: Mon, 6 Feb 2023 14:57:27 +0000 (GMT) List-Id: https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3D85df9457b72e= 4a198b4edfc908017612fca59509 commit 85df9457b72e4a198b4edfc908017612fca59509 Author: Andrew Burgess Date: Thu Feb 2 11:45:41 2023 +0000 gdb/doc: extend the documentation for the 'handle' command =20 The documentation for the 'handle' command does not cover all of the features of the command, and in one case, is just wrong. =20 The user can specify 'all' as signal name, the documentation implies that this will change the behaviour of all signals, in reality, this changes all signals except SIGINT and SIGTRAP (the signals used by GDB). I've updated the docs to list this limitation. =20 The 'handle' command also allows the user to specify multiple signals for a single command, e.g. 'handle SIGFPE SIGILL nostop pass print', however the documentation doesn't describe this, so I've updated the docs to describe this feature. Diff: --- gdb/doc/gdb.texinfo | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index c90874a1214..eebb6dd422a 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -6760,13 +6760,14 @@ Set a catchpoint for the indicated signals. @xref{= Set Catchpoints}, for details about this command. =20 @kindex handle -@item handle @var{signal} @r{[}@var{keywords}@dots{}@r{]} -Change the way @value{GDBN} handles signal @var{signal}. The @var{signal} -can be the number of a signal or its name (with or without the -@samp{SIG} at the beginning); a list of signal numbers of the form -@samp{@var{low}-@var{high}}; or the word @samp{all}, meaning all the -known signals. Optional arguments @var{keywords}, described below, -say what change to make. +@item handle @var{signal} @r{[} @var{signal} @dots{} @r{]} @r{[}@var{keywo= rds}@dots{}@r{]} +Change the way @value{GDBN} handles each @var{signal}. Each +@var{signal} can be the number of a signal or its name (with or +without the @samp{SIG} at the beginning); a list of signal numbers of +the form @samp{@var{low}-@var{high}}; or the word @samp{all}, meaning +all the known signals, except @code{SIGINT} and @code{SIGTRAP}, which +are used by @value{GDBN}. Optional argument @var{keywords}, described +below, say what changes to make to all of the specified signals. @end table =20 @c @group