mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-02-11 13:02:10 +08:00
gdb.texinfo (Source Annotations): Fix index entries by adding
"annotation" to them, to discriminate from index entries that point to the more general topic descriptions.
This commit is contained in:
parent
0ced0c34ad
commit
e5ac9b532c
@ -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 <dan@codesourcery.com>
|
||||
|
||||
|
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user