Re: [rfa] gdbserver 2/n - signals

[Daniel Jacobowitz <dmj+@andrew.cmu.edu>]

On Fri, Jul 20, 2001 at 10:31:08AM +0300, Eli Zaretskii wrote:
> > Date: Thu, 19 Jul 2001 14:52:37 -0700
> > From: Daniel Jacobowitz <dmj+@andrew.cmu.edu>
> > 
> > 2001-07-19  Daniel Jacobowitz  <drow@mvista.com>
> > 
> > 	* gdb.texinfo (Protocol): Mention that signal numbers
> > 	are defined by the target_signal enum.
> > 
> > Index: gdb.texinfo
> > ===================================================================
> > RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
> > retrieving revision 1.44
> > diff -u -r1.44 gdb.texinfo
> > --- gdb.texinfo	2001/07/06 04:07:29	1.44
> > +++ gdb.texinfo	2001/07/19 18:56:55
> > @@ -10211,8 +10211,8 @@
> >  receive any of the below as a reply.  In the case of the @samp{C},
> >  @samp{c}, @samp{S} and @samp{s} packets, that reply is only returned
> >  when the target halts.  In the below the exact meaning of @samp{signal
> > -number} is poorly defined.  In general one of the UNIX signal numbering
> > -conventions is used.
> > +number} is defined by the type @code{enum target_signal}.  For the most
> > +common signals this corresponds to the UNIX signal numbering conventions.
> 
> I don't really understand the rationale for this change.  This is a
> user's manual; why should it matter to a user to know the name of the
> enum which defines signal numbers?  I don't see how it makes the issue
> better defined (since you removed the ``poorly defined'' phrase).
> 
> If we do want to leave the `enum target_signal' info in the manual, at
> the very least please say what source file is that defined on.

Well, the way I see it is that the signal numbering convention is part
of the remote protocol, and so should be documented in the manual; at
the same time I didn't really want to duplicate the hundred and
something signals inline in the texinfo documentation.

I don't really understand why the remote protocol is documented in the
user's manual, either :)


-- 
Daniel Jacobowitz                           Carnegie Mellon University
MontaVista Software                         Debian GNU/Linux Developer