diff options
author | Jim Kingdon <jkingdon@engr.sgi.com> | 1994-04-28 21:43:10 +0000 |
---|---|---|
committer | Jim Kingdon <jkingdon@engr.sgi.com> | 1994-04-28 21:43:10 +0000 |
commit | dd3a7d45f9c4812b29dac67425e50fb06650840e (patch) | |
tree | 129c2f10e063a88e3a1cd894c35fb5667052debf /gdb/doc/annotate.texi | |
parent | a0cf46812cd57a8561ed6399b4aff14259374407 (diff) | |
download | gdb-dd3a7d45f9c4812b29dac67425e50fb06650840e.zip gdb-dd3a7d45f9c4812b29dac67425e50fb06650840e.tar.gz gdb-dd3a7d45f9c4812b29dac67425e50fb06650840e.tar.bz2 |
* annotate.texi: New file, to document annotations.
Diffstat (limited to 'gdb/doc/annotate.texi')
-rw-r--r-- | gdb/doc/annotate.texi | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/gdb/doc/annotate.texi b/gdb/doc/annotate.texi index 404f94f..4545721 100644 --- a/gdb/doc/annotate.texi +++ b/gdb/doc/annotate.texi @@ -64,6 +64,7 @@ This is Edition @value{EDITION}, @value{DATE}. * Server:: Issuing a command without affecting user state. * Values:: Values are marked as such. * Prompting:: GDB annotations marking GDB's need for input. +* Errors:: Annotations for error messages. * Breakpoint Info:: Information on breakpoints. * Invalidation:: Some annotations describe things now invalid. * Source:: Annotations describing source code. @@ -278,6 +279,42 @@ prompting. This is because the counting of lines is buggy in the presence of annotations. @end table +@node Errors +@chapter Errors + +@example +^Z^Zquit +@end example + +This annotation occurs right before GDB responds to an interrupt. + +@example +^Z^Zerror +@end example + +This annotation occurs right before GDB responds to an error. + +Quit and error annotations indicate that any annotations which GDB was +in the middle of may end abruptly. For example, if a +@code{value-history-begin} annotation is followed by a @code{error}, one +cannot expect to receive the matching @code{value-history-end}. One +cannot expect not to receive it either, however; an error annotation +does not necessarily mean that GDB is immediately returning all the way +to the top level. + +A quit or error annotation may be preceded by + +@example +^Z^Zerror-begin +@end example + +Any output between that and the quit or error annotation is the error +message. + +Warning messages are not yet annotated. +@c If we want to change that, need to fix warning(), type_error(), +@c range_error(), and possibly other places. + @node Breakpoint Info @chapter Information on Breakpoints |