Re: [RFA][patch 1/9] Yet another respin of the patch with initial Python support

[Eli Zaretskii <eliz@gnu.org>]

> Date: Sat, 26 Jul 2008 13:35:08 -0400
> From: Daniel Jacobowitz <drow@false.org>
> Cc: Eli Zaretskii <eliz@gnu.org>,
> 	Thiago Jung Bauermann <bauerman@br.ibm.com>,
> 	gdb-patches@sourceware.org
> 
> On Sat, Jul 26, 2008 at 11:04:24AM -0600, Tom Tromey wrote:
> > >> +In particular, a @value{GDBN} @code{QUIT} exception is translated to a
> > >> +Python @code{KeyboardInterrupt} exception, and other @value{GDBN}
> > >> +exceptions are translated to Python @code{RuntimeError}s.
> > 
> > Eli> I think this is nowhere nearly as clear as it should be.  Even to a C
> > Eli> hacker, "QUIT exception" is not sufficiently self-explanatory.  Do you
> > Eli> mean SIGQUIT? then please say so.
> > 
> > Daniel or some other gdb maintainer will have to suggest something.
> > I don't know what else to call this.  exceptions.h refers to "QUIT
> > event", but also the enum value is "RETURN_QUIT"... maybe the latter?
> 
> For clarification, Tom's talking about "QUIT;" in the GDB sources.

Yes, I know.  But we cannot mention symbols from GDB sources in the
user manual.  The readers of the manual are not supposed to search the
sources to understand what these symbols mean.