This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH 7/7] Allow setting a parameter to raise gdb.GdbError
> Cc: gdb-patches@sourceware.org
> From: Simon Marchi <simark@simark.ca>
> Date: Sun, 23 Sep 2018 22:39:03 -0400
>
> >> +If this method raises @code{gdb.GdbError} (@pxref{Exception
> >
> > "raises the 'gdb.GdbError' exception", I presume?
>
> I think that was intentional, I often see it written this way. Here's
> an example from the Python doc:
>
> https://docs.python.org/2/library/string.html#string.index
I understand, but this text could be confusing, especially to
non-native English speakers, and is more confusing as the length of
the exception's name becomes longer and includes stuff other than just
"error".
So I think we should not use this paradigm here, to keep the confusion
level down.