Re: [PATCH] Clarify documentation of signal numbers

[Eli Zaretskii <eliz@gnu.org>]

> From: Tom Tromey <tromey@adacore.com>
> Cc: Tom Tromey <tromey@adacore.com>
> Date: Fri, 20 Dec 2024 13:19:40 -0700
> 
> A user was confused by the meaning of signal numbers in the gdb CLI.
> For instance, when using "signal 3", exactly which signal is
> delivered?  Is it always 3, or is it always SIGQUIT?
> 
> This patch attempts to clarify the documentation here.
> 
> Let me know what you think.  I'm not sure this is phrased in the
> clearest way possible.

It's clear enough, IMO.  But I wonder whether we should simply have a
table of POSIX signal numbers 1-15 and the corresponding names, as GDB
converts them.  Then the examples you show (which describe just some
of those conversions) will be unnecessary, and we only need to say
that signals 1-15 are interpreted as POSIX says and as shown in the
table.  A table is IMO better because if someone uses GDB on a
non-POSIX platform, they don't necessarily have easy access to header
files on a POSIX platform to find out which signal is, say, signal 11.
So the only way for them to know is to type

  (gdb) handle 11 stop

and see what GDB shows in response, which is not always
possible/convenient.

Thanks.