This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]