This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
[rfa:doco] Document ``maint internal-error/warning''
- From: Andrew Cagney <ac131313 at ges dot redhat dot com>
- To: gdb-patches at sources dot redhat dot com
- Date: Wed, 18 Sep 2002 19:59:24 -0400
- Subject: [rfa:doco] Document ``maint internal-error/warning''
Hello,
This patch updates my previous doco for this command. The example
matches GDB's output.
ok?
Andrew
2002-09-18 Andrew Cagney <ac131313@redhat.com>
* gdb.texinfo (Maintenance Commands): Document ``maint
internal-error'' and ``maint internal-warning''.
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.120
diff -u -r1.120 gdb.texinfo
--- gdb.texinfo 5 Sep 2002 12:13:08 -0000 1.120
+++ gdb.texinfo 18 Sep 2002 23:57:35 -0000
@@ -14339,6 +14339,30 @@
@end table
+@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.
+
@kindex maint print registers
@kindex maint print raw-registers
@kindex maint print cooked-registers