Re: [patch/rfc][rfa:doc][rfa;testsuite] Add ``internal-warning''

[Andrew Cagney <ac131313@ges.redhat.com>]

> Date: Thu, 15 Aug 2002 17:32:54 -0400
> From: Andrew Cagney <ac131313@ges.redhat.com>
> 
> This patch adds an internal_warning() function to GDB.  It's behavour is identical to internal_error() (quit? dump core?) only, at the end, it doesn't throw an error, instead returning to the caller.
> 
> 
>> I'd like gdb.texinfo to tell more about what GDB will print when this
>> command is invoked.  Perhaps just give an example.  ``behave as though
>> an internal error or warning is being reported'' doesn't sound
>> descriptive enough (it's not like every user is born with a built-in
>> knowledge of that behavior... ;-).

> 
> Makes sense, I'll do both.

How is this ...

<<<<

@kindex maint internal-error
@kindex maint internal-warning
@item maint internal-error
@itemx maint internal-warning
Cause @value{GDBN} to call the internal function @code{internal_error}
or @code{internal_warning} and hence behave as though an internal error
or internal warning has been detected.  In addition to reporting the
internal problem, these functions give the user the opportunity to 
either quit @value{GDBN} or create a core file of the current
@value{GDBN} session.

@smallexample
(gdb) @kbd{maint internal-error testing, 1, 2}
@dots{}/maint.c:121: internal-error: testing, 1, 2
A problem internal to GDB has been detected.  Further
debugging may prove unreliable.
Quit this debugging session? (y or n) @kbd{n}
Create a core file? (y or n) @kbd{n}
(gdb)
@end smallexample

Takes an optional parameter that is used as the text of the error or
warning message.

 >>>>

Andrew