diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index eb24d42777..6594a465c7 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -3,6 +3,10 @@ * gdb.texinfo (Breakpoints, Set Watchpoints): Elaborate and clarify on the possible meanings of ``expression'' watched by watchpoints. Add indexing. + (Prompting, Errors, Invalidation, Annotations for Running) + (Source Annotations): Fix index entries by adding "annotation" to + them, to discriminate from index entries that point to the more + general topic descriptions. 2006-10-17 Daniel Jacobowitz diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 19287d6b59..1275cbc786 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -21529,34 +21529,34 @@ features the following annotations: The input types are @table @code -@findex pre-prompt -@findex prompt -@findex post-prompt +@findex pre-prompt annotation +@findex prompt annotation +@findex post-prompt annotation @item prompt When @value{GDBN} is prompting for a command (the main @value{GDBN} prompt). -@findex pre-commands -@findex commands -@findex post-commands +@findex pre-commands annotation +@findex commands annotation +@findex post-commands annotation @item commands When @value{GDBN} prompts for a set of commands, like in the @code{commands} command. The annotations are repeated for each command which is input. -@findex pre-overload-choice -@findex overload-choice -@findex post-overload-choice +@findex pre-overload-choice annotation +@findex overload-choice annotation +@findex post-overload-choice annotation @item overload-choice When @value{GDBN} wants the user to select between various overloaded functions. -@findex pre-query -@findex query -@findex post-query +@findex pre-query annotation +@findex query annotation +@findex post-query annotation @item query When @value{GDBN} wants the user to confirm a potentially dangerous operation. -@findex pre-prompt-for-continue -@findex prompt-for-continue -@findex post-prompt-for-continue +@findex pre-prompt-for-continue annotation +@findex prompt-for-continue annotation +@findex post-prompt-for-continue annotation @item prompt-for-continue When @value{GDBN} is asking the user to press return to continue. Note: Don't expect this to work well; instead use @code{set height 0} to disable @@ -21568,14 +21568,14 @@ presence of annotations. @section Errors @cindex annotations for errors, warnings and interrupts -@findex quit +@findex quit annotation @smallexample ^Z^Zquit @end smallexample This annotation occurs right before @value{GDBN} responds to an interrupt. -@findex error +@findex error annotation @smallexample ^Z^Zerror @end smallexample @@ -21590,7 +21590,7 @@ cannot expect not to receive it either, however; an error annotation does not necessarily mean that @value{GDBN} is immediately returning all the way to the top level. -@findex error-begin +@findex error-begin annotation A quit or error annotation may be preceded by @smallexample @@ -21612,13 +21612,13 @@ The following annotations say that certain pieces of state may have changed. @table @code -@findex frames-invalid +@findex frames-invalid annotation @item ^Z^Zframes-invalid The frames (for example, output from the @code{backtrace} command) may have changed. -@findex breakpoints-invalid +@findex breakpoints-invalid annotation @item ^Z^Zbreakpoints-invalid The breakpoints may have changed. For example, the user just added or @@ -21629,8 +21629,8 @@ deleted a breakpoint. @section Running the Program @cindex annotations for running programs -@findex starting -@findex stopping +@findex starting annotation +@findex stopping annotation When the program starts executing due to a @value{GDBN} command such as @code{step} or @code{continue}, @@ -21648,16 +21648,16 @@ is output. Before the @code{stopped} annotation, a variety of annotations describe how the program stopped. @table @code -@findex exited +@findex exited annotation @item ^Z^Zexited @var{exit-status} The program exited, and @var{exit-status} is the exit status (zero for successful exit, otherwise nonzero). -@findex signalled -@findex signal-name -@findex signal-name-end -@findex signal-string -@findex signal-string-end +@findex signalled annotation +@findex signal-name annotation +@findex signal-name-end annotation +@findex signal-string annotation +@findex signal-string-end annotation @item ^Z^Zsignalled The program exited with a signal. After the @code{^Z^Zsignalled}, the annotation continues: @@ -21681,17 +21681,17 @@ as @code{Illegal Instruction} or @code{Segmentation fault}. @var{intro-text}, @var{middle-text}, and @var{end-text} are for the user's benefit and have no particular format. -@findex signal +@findex signal annotation @item ^Z^Zsignal The syntax of this annotation is just like @code{signalled}, but @value{GDBN} is just saying that the program received the signal, not that it was terminated with it. -@findex breakpoint +@findex breakpoint annotation @item ^Z^Zbreakpoint @var{number} The program hit breakpoint number @var{number}. -@findex watchpoint +@findex watchpoint annotation @item ^Z^Zwatchpoint @var{number} The program hit watchpoint number @var{number}. @end table @@ -21700,7 +21700,7 @@ The program hit watchpoint number @var{number}. @section Displaying Source @cindex annotations for source display -@findex source +@findex source annotation The following annotation is used instead of displaying source code: @smallexample