This is the mail archive of the
gdb-patches@sourceware.cygnus.com
mailing list for the GDB project.
GDB manual changes
- To: gdb-patches at sourceware dot cygnus dot com
- Subject: GDB manual changes
- From: Stan Shebs <shebs at shebs dot cnchost dot com>
- Date: Tue, 28 Mar 2000 09:06:00 -0800
- CC: 3diff at gnu dot org
- Reply-To: shebs at shebs dot cnchost dot com
I've just committed a pile of changes to the manual. This includes
the duplication of the top-level menu for the benefit of @ifhtml,
the re-removal of node links, and various formatting changes to
make @smallbook come out right (as requested by Brian Youmans).
I tested on 3.12, 3.12h (RH 6.1 version), and 4.0. Apparently
texi2html has a problem with the top-level menu that is under
@ifhtml, and it gets garbled, although 4.0 makeinfo -html works
fine (but it can only make one monster html file, sigh). It's
functionally no worse than before, but looks bad.
I'm still planning to rewrite the introduction to use a more
meaningful example program, and we still have undocumented
commands that ought to be mentioned, so this isn't the end,
but this should be a good base for the next round of tweaks.
(I left the remote protocol section mostly untouched, since JT
has a patch to apply.)
Stan
2000-03-28 Stan Shebs <shebs@apple.com>
* gdb.texinfo: Update dates, bump to Eighth Edition (note
expectation of additional changes before release), update
ISBN, add copy of top-level menu for @ifhtml, remove explicit
node links, rephrase and/or shorten lines to fix formatting
problem in both regular and @smallbook formats.
* annotate.texi: Shorten lines in example, use smallexample
consistently everywhere.
* Makefile.in: Add comment about texinfo 4.0 html generation.
(SFILES_INCLUDED): Add annotate.texi.
Index: Makefile.in
===================================================================
RCS file: /cvs/src/src/gdb/doc/Makefile.in,v
retrieving revision 1.3
diff -p -r1.3 Makefile.in
*** Makefile.in 2000/03/24 07:27:24 1.3
--- Makefile.in 2000/03/28 16:33:45
*************** TEXIDIR=${gdbdir}/../texinfo
*** 40,45 ****
--- 40,49 ----
# where to find makeinfo, preferably one designed for texinfo-2
MAKEINFO=makeinfo
+ # Note that texinfo 4.0's makeinfo --html can only generate a
+ # single file, which would be too large, so continue to use
+ # texi2html. -sts 2000-03-28
+
MAKEHTML = texi2html
MAKEHTMLFLAGS = -glossary -menu -split_chapter
*************** TEXINDEX = texindex
*** 83,89 ****
DVIPS = dvips
# Main GDB manual's source files
! SFILES_INCLUDED = gdb-cfg.texi
SFILES_LOCAL = $(srcdir)/gdb.texinfo GDBvn.texi $(SFILES_INCLUDED)
--- 87,93 ----
DVIPS = dvips
# Main GDB manual's source files
! SFILES_INCLUDED = gdb-cfg.texi $(srcdir)/annotate.texi
SFILES_LOCAL = $(srcdir)/gdb.texinfo GDBvn.texi $(SFILES_INCLUDED)
Index: annotate.texi
===================================================================
RCS file: /cvs/src/src/gdb/doc/annotate.texi,v
retrieving revision 1.3
diff -p -r1.3 annotate.texi
*** annotate.texi 2000/03/24 07:30:06 1.3
--- annotate.texi 2000/03/28 16:33:45
***************
*** 60,68 ****
@chapter @value{GDBN} Annotations
@end ifclear
! This chapter describes annotations in @value{GDBN}, the GNU symbolic debugger.
! Annotations are designed to interface @value{GDBN} to graphical user interfaces
! or other similar programs which want to interact with @value{GDBN} at a
relatively high level.
@ignore
--- 60,68 ----
@chapter @value{GDBN} Annotations
@end ifclear
! This chapter describes annotations in @value{GDBN}. Annotations are
! designed to interface @value{GDBN} to graphical user interfaces or other
! similar programs which want to interact with @value{GDBN} at a
relatively high level.
@ignore
*************** additional information, and a newline.
*** 100,109 ****
cannot contain newline characters.
Any output not beginning with a newline and two @samp{control-z}
! characters denotes literal output from @value{GDBN}. Currently there is no need
! for @value{GDBN} to output a newline followed by two @samp{control-z} characters,
! but if there was such a need, the annotations could be extended with an
! @samp{escape} annotation which means those three characters as output.
A simple example of starting up @value{GDBN} with annotations is:
--- 100,110 ----
cannot contain newline characters.
Any output not beginning with a newline and two @samp{control-z}
! characters denotes literal output from @value{GDBN}. Currently there is
! no need for @value{GDBN} to output a newline followed by two
! @samp{control-z} characters, but if there was such a need, the
! annotations could be extended with an @samp{escape} annotation which
! means those three characters as output.
A simple example of starting up @value{GDBN} with annotations is:
*************** A simple example of starting up @value{G
*** 111,120 ****
$ gdb --annotate=2
GNU GDB 5.0
Copyright 2000 Free Software Foundation, Inc.
! GDB is free software, covered by the GNU General Public License, and you are
! welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
! There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "sparc-sun-sunos4.1.3"
^Z^Zpre-prompt
--- 112,123 ----
$ gdb --annotate=2
GNU GDB 5.0
Copyright 2000 Free Software Foundation, Inc.
! GDB is free software, covered by the GNU General Public License,
! and you are welcome to change it and/or distribute copies of it
! under certain conditions.
Type "show copying" to see the conditions.
! There is absolutely no warranty for GDB. Type "show warranty"
! for details.
This GDB was configured as "sparc-sun-sunos4.1.3"
^Z^Zpre-prompt
*************** quit
*** 126,144 ****
$
@end smallexample
! Here @samp{quit} is input to @value{GDBN}; the rest is output from @value{GDBN}. The three
! lines beginning @samp{^Z^Z} (where @samp{^Z} denotes a @samp{control-z}
! character) are annotations; the rest is output from @value{GDBN}.
@node Server Prefix
@section The Server Prefix
@cindex server prefix for annotations
! To issue a command to @value{GDBN} without affecting certain aspects of the state
! which is seen by users, prefix it with @samp{server }. This means that
! this command will not affect the command history, nor will it affect
! @value{GDBN}'s notion of which command to repeat if @key{RET} is pressed on a
! line by itself.
The server prefix does not affect the recording of values into the value
history; to print a value without recording it into the value history,
--- 129,148 ----
$
@end smallexample
! Here @samp{quit} is input to @value{GDBN}; the rest is output from
! @value{GDBN}. The three lines beginning @samp{^Z^Z} (where @samp{^Z}
! denotes a @samp{control-z} character) are annotations; the rest is
! output from @value{GDBN}.
@node Server Prefix
@section The Server Prefix
@cindex server prefix for annotations
! To issue a command to @value{GDBN} without affecting certain aspects of
! the state which is seen by users, prefix it with @samp{server }. This
! means that this command will not affect the command history, nor will it
! affect @value{GDBN}'s notion of which command to repeat if @key{RET} is
! pressed on a line by itself.
The server prefix does not affect the recording of values into the value
history; to print a value without recording it into the value history,
*************** use the @code{output} command instead of
*** 148,155 ****
@section Values
@cindex annotations for values
! When a value is printed in various contexts, @value{GDBN} uses annotations to
! delimit the value from the surrounding text.
@findex value-history-begin
@findex value-history-value
--- 152,159 ----
@section Values
@cindex annotations for values
! When a value is printed in various contexts, @value{GDBN} uses
! annotations to delimit the value from the surrounding text.
@findex value-history-begin
@findex value-history-value
*************** delimit the value from the surrounding t
*** 157,169 ****
If a value is printed using @code{print} and added to the value history,
the annotation looks like
! @example
^Z^Zvalue-history-begin @var{history-number} @var{value-flags}
@var{history-string}
^Z^Zvalue-history-value
@var{the-value}
^Z^Zvalue-history-end
! @end example
where @var{history-number} is the number it is getting in the value
history, @var{history-string} is a string, such as @samp{$5 = }, which
--- 161,173 ----
If a value is printed using @code{print} and added to the value history,
the annotation looks like
! @smallexample
^Z^Zvalue-history-begin @var{history-number} @var{value-flags}
@var{history-string}
^Z^Zvalue-history-value
@var{the-value}
^Z^Zvalue-history-end
! @end smallexample
where @var{history-number} is the number it is getting in the value
history, @var{history-string} is a string, such as @samp{$5 = }, which
*************** a value which can be dereferenced and @s
*** 176,186 ****
If the value is not added to the value history (it is an invalid float
or it is printed with the @code{output} command), the annotation is similar:
! @example
^Z^Zvalue-begin @var{value-flags}
@var{the-value}
^Z^Zvalue-end
! @end example
@findex arg-begin
@findex arg-name-end
--- 180,190 ----
If the value is not added to the value history (it is an invalid float
or it is printed with the @code{output} command), the annotation is similar:
! @smallexample
^Z^Zvalue-begin @var{value-flags}
@var{the-value}
^Z^Zvalue-end
! @end smallexample
@findex arg-begin
@findex arg-name-end
*************** or it is printed with the @code{output}
*** 189,195 ****
When @value{GDBN} prints an argument to a function (for example, in the output
from the @code{backtrace} command), it annotates it as follows:
! @example
^Z^Zarg-begin
@var{argument-name}
^Z^Zarg-name-end
--- 193,199 ----
When @value{GDBN} prints an argument to a function (for example, in the output
from the @code{backtrace} command), it annotates it as follows:
! @smallexample
^Z^Zarg-begin
@var{argument-name}
^Z^Zarg-name-end
*************** from the @code{backtrace} command), it a
*** 197,203 ****
^Z^Zarg-value @var{value-flags}
@var{the-value}
^Z^Zarg-end
! @end example
where @var{argument-name} is the name of the argument,
@var{separator-string} is text which separates the name from the value
--- 201,207 ----
^Z^Zarg-value @var{value-flags}
@var{the-value}
^Z^Zarg-end
! @end smallexample
where @var{argument-name} is the name of the argument,
@var{separator-string} is text which separates the name from the value
*************** for the user's benefit (such as @samp{=}
*** 211,217 ****
@findex field-end
When printing a structure, @value{GDBN} annotates it as follows:
! @example
^Z^Zfield-begin @var{value-flags}
@var{field-name}
^Z^Zfield-name-end
--- 215,221 ----
@findex field-end
When printing a structure, @value{GDBN} annotates it as follows:
! @smallexample
^Z^Zfield-begin @var{value-flags}
@var{field-name}
^Z^Zfield-name-end
*************** When printing a structure, @value{GDBN}
*** 219,225 ****
^Z^Zfield-value
@var{the-value}
^Z^Zfield-end
! @end example
where @var{field-name} is the name of the field, @var{separator-string}
is text which separates the name from the value for the user's benefit
--- 223,229 ----
^Z^Zfield-value
@var{the-value}
^Z^Zfield-end
! @end smallexample
where @var{field-name} is the name of the field, @var{separator-string}
is text which separates the name from the value for the user's benefit
*************** same meanings as in a @code{value-histor
*** 228,236 ****
When printing an array, @value{GDBN} annotates it as follows:
! @example
^Z^Zarray-section-begin @var{array-index} @var{value-flags}
! @end example
where @var{array-index} is the index of the first element being
annotated and @var{value-flags} has the same meaning as in a
--- 232,240 ----
When printing an array, @value{GDBN} annotates it as follows:
! @smallexample
^Z^Zarray-section-begin @var{array-index} @var{value-flags}
! @end smallexample
where @var{array-index} is the index of the first element being
annotated and @var{value-flags} has the same meaning as in a
*************** annotated and @var{value-flags} has the
*** 238,260 ****
of elements, where is element can be either a single element:
@findex elt
! @example
@samp{,} @var{whitespace} ; @r{omitted for the first element}
@var{the-value}
^Z^Zelt
! @end example
or a repeated element
@findex elt-rep
@findex elt-rep-end
! @example
@samp{,} @var{whitespace} ; @r{omitted for the first element}
@var{the-value}
^Z^Zelt-rep @var{number-of-repititions}
@var{repetition-string}
^Z^Zelt-rep-end
! @end example
In both cases, @var{the-value} is the output for the value of the
element and @var{whitespace} can contain spaces, tabs, and newlines. In
--- 242,264 ----
of elements, where is element can be either a single element:
@findex elt
! @smallexample
@samp{,} @var{whitespace} ; @r{omitted for the first element}
@var{the-value}
^Z^Zelt
! @end smallexample
or a repeated element
@findex elt-rep
@findex elt-rep-end
! @smallexample
@samp{,} @var{whitespace} ; @r{omitted for the first element}
@var{the-value}
^Z^Zelt-rep @var{number-of-repititions}
@var{repetition-string}
^Z^Zelt-rep-end
! @end smallexample
In both cases, @var{the-value} is the output for the value of the
element and @var{whitespace} can contain spaces, tabs, and newlines. In
*************** user that repitition is being depicted.
*** 267,275 ****
Once all the array elements have been output, the array annotation is
ended with
! @example
^Z^Zarray-section-end
! @end example
@node Frame Annotations
@section Frames
--- 271,279 ----
Once all the array elements have been output, the array annotation is
ended with
! @smallexample
^Z^Zarray-section-end
! @end smallexample
@node Frame Annotations
@section Frames
*************** to frames printed when @value{GDBN} stop
*** 282,291 ****
@findex frame-begin
The frame annotation begins with
! @example
^Z^Zframe-begin @var{level} @var{address}
@var{level-string}
! @end example
where @var{level} is the number of the frame (0 is the innermost frame,
and other frames have positive numbers), @var{address} is the address of
--- 286,295 ----
@findex frame-begin
The frame annotation begins with
! @smallexample
^Z^Zframe-begin @var{level} @var{address}
@var{level-string}
! @end smallexample
where @var{level} is the number of the frame (0 is the innermost frame,
and other frames have positive numbers), @var{address} is the address of
*************** designed to convey the level to the user
*** 295,303 ****
does not depend on the language). The frame ends with
@findex frame-end
! @example
^Z^Zframe-end
! @end example
Between these annotations is the main body of the frame, which can
consist of
--- 299,307 ----
does not depend on the language). The frame ends with
@findex frame-end
! @smallexample
^Z^Zframe-end
! @end smallexample
Between these annotations is the main body of the frame, which can
consist of
*************** consist of
*** 305,314 ****
@itemize @bullet
@item
@findex function-call
! @example
^Z^Zfunction-call
@var{function-call-string}
! @end example
where @var{function-call-string} is text designed to convey to the user
that this frame is associated with a function call made by @value{GDBN} to a
--- 309,318 ----
@itemize @bullet
@item
@findex function-call
! @smallexample
^Z^Zfunction-call
@var{function-call-string}
! @end smallexample
where @var{function-call-string} is text designed to convey to the user
that this frame is associated with a function call made by @value{GDBN} to a
*************** function in the program being debugged.
*** 316,325 ****
@item
@findex signal-handler-caller
! @example
^Z^Zsignal-handler-caller
@var{signal-handler-caller-string}
! @end example
where @var{signal-handler-caller-string} is text designed to convey to
the user that this frame is associated with whatever mechanism is used
--- 320,329 ----
@item
@findex signal-handler-caller
! @smallexample
^Z^Zsignal-handler-caller
@var{signal-handler-caller-string}
! @end smallexample
where @var{signal-handler-caller-string} is text designed to convey to
the user that this frame is associated with whatever mechanism is used
*************** A normal frame.
*** 334,345 ****
This can optionally (depending on whether this is thought of as
interesting information for the user to see) begin with
! @example
^Z^Zframe-address
@var{address}
^Z^Zframe-address-end
@var{separator-string}
! @end example
where @var{address} is the address executing in the frame (the same
address as in the @code{frame-begin} annotation, but printed in a form
--- 338,349 ----
This can optionally (depending on whether this is thought of as
interesting information for the user to see) begin with
! @smallexample
^Z^Zframe-address
@var{address}
^Z^Zframe-address-end
@var{separator-string}
! @end smallexample
where @var{address} is the address executing in the frame (the same
address as in the @code{frame-begin} annotation, but printed in a form
*************** benefit.
*** 352,363 ****
@findex frame-args
Then comes
! @example
^Z^Zframe-function-name
@var{function-name}
^Z^Zframe-args
@var{arguments}
! @end example
where @var{function-name} is the name of the function executing in the
frame, or @samp{??} if not known, and @var{arguments} are the arguments
--- 356,367 ----
@findex frame-args
Then comes
! @smallexample
^Z^Zframe-function-name
@var{function-name}
^Z^Zframe-args
@var{arguments}
! @end smallexample
where @var{function-name} is the name of the function executing in the
frame, or @samp{??} if not known, and @var{arguments} are the arguments
*************** individually as well, @pxref{Value Annot
*** 371,377 ****
@findex frame-source-end
If source information is available, a reference to it is then printed:
! @example
^Z^Zframe-source-begin
@var{source-intro-string}
^Z^Zframe-source-file
--- 375,381 ----
@findex frame-source-end
If source information is available, a reference to it is then printed:
! @smallexample
^Z^Zframe-source-begin
@var{source-intro-string}
^Z^Zframe-source-file
*************** If source information is available, a re
*** 381,387 ****
^Z^Zframe-source-line
@var{line-number}
^Z^Zframe-source-end
! @end example
where @var{source-intro-string} separates for the user's benefit the
reference from the text which precedes it, @var{filename} is the name of
--- 385,391 ----
^Z^Zframe-source-line
@var{line-number}
^Z^Zframe-source-end
! @end smallexample
where @var{source-intro-string} separates for the user's benefit the
reference from the text which precedes it, @var{filename} is the name of
*************** If @value{GDBN} prints some information
*** 393,402 ****
library, which load segment, etc.; currently only done on the RS/6000),
it is annotated with
! @example
^Z^Zframe-where
@var{information}
! @end example
Then, if source is to actually be displayed for this frame (for example,
this is not true for output from the @code{backtrace} command), then a
--- 397,406 ----
library, which load segment, etc.; currently only done on the RS/6000),
it is annotated with
! @smallexample
^Z^Zframe-where
@var{information}
! @end smallexample
Then, if source is to actually be displayed for this frame (for example,
this is not true for output from the @code{backtrace} command), then a
*************** output, not in addition.
*** 419,425 ****
When @value{GDBN} is told to display something using the @code{display} command,
the results of the display are annotated:
! @example
^Z^Zdisplay-begin
@var{number}
^Z^Zdisplay-number-end
--- 423,429 ----
When @value{GDBN} is told to display something using the @code{display} command,
the results of the display are annotated:
! @smallexample
^Z^Zdisplay-begin
@var{number}
^Z^Zdisplay-number-end
*************** the results of the display are annotated
*** 433,439 ****
^Z^Zdisplay-value
@var{value}
^Z^Zdisplay-end
! @end example
where @var{number} is the number of the display, @var{number-separator}
is intended to separate the number from what follows for the user,
--- 437,443 ----
^Z^Zdisplay-value
@var{value}
^Z^Zdisplay-end
! @end smallexample
where @var{number} is the number of the display, @var{number-separator}
is intended to separate the number from what follows for the user,
*************** annotation which denotes the end of any
*** 459,469 ****
associated with the input. For example, the @code{prompt} input type
features the following annotations:
! @example
^Z^Zpre-prompt
^Z^Zprompt
^Z^Zpost-prompt
! @end example
The input types are
--- 463,473 ----
associated with the input. For example, the @code{prompt} input type
features the following annotations:
! @smallexample
^Z^Zpre-prompt
^Z^Zprompt
^Z^Zpost-prompt
! @end smallexample
The input types are
*************** presence of annotations.
*** 508,523 ****
@cindex annotations for errors, warnings and interrupts
@findex quit
! @example
^Z^Zquit
! @end example
This annotation occurs right before @value{GDBN} responds to an interrupt.
@findex error
! @example
^Z^Zerror
! @end example
This annotation occurs right before @value{GDBN} responds to an error.
--- 512,527 ----
@cindex annotations for errors, warnings and interrupts
@findex quit
! @smallexample
^Z^Zquit
! @end smallexample
This annotation occurs right before @value{GDBN} responds to an interrupt.
@findex error
! @smallexample
^Z^Zerror
! @end smallexample
This annotation occurs right before @value{GDBN} responds to an error.
*************** to the top level.
*** 532,540 ****
@findex error-begin
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.
--- 536,544 ----
@findex error-begin
A quit or error annotation may be preceded by
! @smallexample
^Z^Zerror-begin
! @end smallexample
Any output between that and the quit or error annotation is the error
message.
*************** The output from the @code{info breakpoin
*** 551,561 ****
@findex breakpoints-headers
@findex breakpoints-table
! @example
^Z^Zbreakpoints-headers
@var{header-entry}
^Z^Zbreakpoints-table
! @end example
where @var{header-entry} has the same syntax as an entry (see below) but
instead of containing data, it contains strings which are intended to
--- 555,565 ----
@findex breakpoints-headers
@findex breakpoints-table
! @smallexample
^Z^Zbreakpoints-headers
@var{header-entry}
^Z^Zbreakpoints-table
! @end smallexample
where @var{header-entry} has the same syntax as an entry (see below) but
instead of containing data, it contains strings which are intended to
*************** of:
*** 566,572 ****
@findex record
@findex field
! @example
^Z^Zrecord
^Z^Zfield 0
@var{number}
--- 570,576 ----
@findex record
@findex field
! @smallexample
^Z^Zrecord
^Z^Zfield 0
@var{number}
*************** of:
*** 588,594 ****
@var{ignore-count}
^Z^Zfield 9
@var{commands}
! @end example
Note that @var{address} is intended for user consumption---the syntax
varies depending on the language.
--- 592,598 ----
@var{ignore-count}
^Z^Zfield 9
@var{commands}
! @end smallexample
Note that @var{address} is intended for user consumption---the syntax
varies depending on the language.
*************** varies depending on the language.
*** 596,604 ****
The output ends with
@findex breakpoints-table-end
! @example
^Z^Zbreakpoints-table-end
! @end example
@node Invalidation
@section Invalidation Notices
--- 600,608 ----
The output ends with
@findex breakpoints-table-end
! @smallexample
^Z^Zbreakpoints-table-end
! @end smallexample
@node Invalidation
@section Invalidation Notices
*************** deleted a breakpoint.
*** 630,644 ****
When the program starts executing due to a @value{GDBN} command such as
@code{step} or @code{continue},
! @example
^Z^Zstarting
! @end example
is output. When the program stops,
! @example
^Z^Zstopped
! @end example
is output. Before the @code{stopped} annotation, a variety of
annotations describe how the program stopped.
--- 634,648 ----
When the program starts executing due to a @value{GDBN} command such as
@code{step} or @code{continue},
! @smallexample
^Z^Zstarting
! @end smallexample
is output. When the program stops,
! @smallexample
^Z^Zstopped
! @end smallexample
is output. Before the @code{stopped} annotation, a variety of
annotations describe how the program stopped.
*************** successful exit, otherwise nonzero).
*** 658,664 ****
The program exited with a signal. After the @code{^Z^Zsignalled}, the
annotation continues:
! @example
@var{intro-text}
^Z^Zsignal-name
@var{name}
--- 662,668 ----
The program exited with a signal. After the @code{^Z^Zsignalled}, the
annotation continues:
! @smallexample
@var{intro-text}
^Z^Zsignal-name
@var{name}
*************** annotation continues:
*** 668,674 ****
@var{string}
^Z^Zsignal-string-end
@var{end-text}
! @end example
where @var{name} is the name of the signal, such as @code{SIGILL} or
@code{SIGSEGV}, and @var{string} is the explanation of the signal, such
--- 672,678 ----
@var{string}
^Z^Zsignal-string-end
@var{end-text}
! @end smallexample
where @var{name} is the name of the signal, such as @code{SIGILL} or
@code{SIGSEGV}, and @var{string} is the explanation of the signal, such
*************** The program hit watchpoint number @var{n
*** 698,706 ****
@findex source
The following annotation is used instead of displaying source code:
! @example
^Z^Zsource @var{filename}:@var{line}:@var{character}:@var{middle}:@var{addr}
! @end example
where @var{filename} is an absolute file name indicating which source
file, @var{line} is the line number within that file (where 1 is the
--- 702,710 ----
@findex source
The following annotation is used instead of displaying source code:
! @smallexample
^Z^Zsource @var{filename}:@var{line}:@var{character}:@var{middle}:@var{addr}
! @end smallexample
where @var{filename} is an absolute file name indicating which source
file, @var{line} is the line number within that file (where 1 is the
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.8
diff -p -r1.8 gdb.texinfo
*** gdb.texinfo 2000/03/28 02:25:13 1.8
--- gdb.texinfo 2000/03/28 16:33:52
***************
*** 1,5 ****
\input texinfo @c -*-texinfo-*-
! @c Copyright 1988-1999
@c Free Software Foundation, Inc.
@c
@c %**start of header
--- 1,5 ----
\input texinfo @c -*-texinfo-*-
! @c Copyright 1988-2000
@c Free Software Foundation, Inc.
@c
@c %**start of header
***************
*** 25,39 ****
@syncodeindex vr cp
@c !!set GDB manual's edition---not the same as GDB version!
! @set EDITION Seventh
@c !!set GDB manual's revision date
! @set DATE February 1999
! @c THIS MANUAL REQUIRES TEXINFO-2 macros and info-makers to format properly.
@c This is a dir.info fragment to support semi-automated addition of
! @c manuals to an info tree. zoo@cygnus.com is developing this facility.
@dircategory Programming & development tools.
@direntry
* Gdb: (gdb). The @sc{gnu} debugger.
--- 25,39 ----
@syncodeindex vr cp
@c !!set GDB manual's edition---not the same as GDB version!
! @set EDITION Eighth
@c !!set GDB manual's revision date
! @set DATE March 2000
! @c THIS MANUAL REQUIRES TEXINFO 3.12 OR LATER.
@c This is a dir.info fragment to support semi-automated addition of
! @c manuals to an info tree.
@dircategory Programming & development tools.
@direntry
* Gdb: (gdb). The @sc{gnu} debugger.
*************** This is the @value{EDITION} Edition, @va
*** 47,53 ****
of @cite{Debugging with @value{GDBN}: the @sc{gnu} Source-Level Debugger}
for @value{GDBN} Version @value{GDBVN}.
! Copyright (C) 1988-1999 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
--- 47,53 ----
of @cite{Debugging with @value{GDBN}: the @sc{gnu} Source-Level Debugger}
for @value{GDBN} Version @value{GDBVN}.
! Copyright (C) 1988-2000 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
*************** into another language, under the above c
*** 85,101 ****
}
@end tex
- @c ISBN seems to be wrong...
-
@vskip 0pt plus 1filll
! Copyright @copyright{} 1988-1999 Free Software Foundation, Inc.
@sp 2
Published by the Free Software Foundation @*
59 Temple Place - Suite 330, @*
Boston, MA 02111-1307 USA @*
! Printed copies are available for $20 each. @*
! ISBN 1-882114-11-6 @*
!
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
--- 85,98 ----
}
@end tex
@vskip 0pt plus 1filll
! Copyright @copyright{} 1988-2000 Free Software Foundation, Inc.
@sp 2
Published by the Free Software Foundation @*
59 Temple Place - Suite 330, @*
Boston, MA 02111-1307 USA @*
! ISBN 1-882114-77-9 @*
!
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
*************** into another language, under the above c
*** 110,127 ****
@end titlepage
@page
-
- @node Top, Summary, (dir), (dir)
@ifinfo
@top Debugging with @value{GDBN}
This file describes @value{GDBN}, the @sc{gnu} symbolic debugger.
This is the @value{EDITION} Edition, @value{DATE}, for @value{GDBN} Version
@value{GDBVN}.
! Copyright (C) 1988-1999 Free Software Foundation, Inc.
@end ifinfo
@menu
* Summary:: Summary of @value{GDBN}
* Sample Session:: A sample @value{GDBN} session
--- 107,173 ----
@end titlepage
@page
@ifinfo
+ @node Top, Summary, (dir), (dir)
+
@top Debugging with @value{GDBN}
This file describes @value{GDBN}, the @sc{gnu} symbolic debugger.
This is the @value{EDITION} Edition, @value{DATE}, for @value{GDBN} Version
@value{GDBVN}.
+
+ Copyright (C) 1988-2000 Free Software Foundation, Inc.
+
+ @menu
+ * Summary:: Summary of @value{GDBN}
+ * Sample Session:: A sample @value{GDBN} session
+
+ * Invocation:: Getting in and out of @value{GDBN}
+ * Commands:: @value{GDBN} commands
+ * Running:: Running programs under @value{GDBN}
+ * Stopping:: Stopping and continuing
+ * Stack:: Examining the stack
+ * Source:: Examining source files
+ * Data:: Examining data
! * Languages:: Using @value{GDBN} with different languages
!
! * Symbols:: Examining the symbol table
! * Altering:: Altering execution
! * GDB Files:: @value{GDBN} files
! * Targets:: Specifying a debugging target
! * Configurations:: Configuration-specific information
! * Controlling GDB:: Controlling @value{GDBN}
! * Sequences:: Canned sequences of commands
! * Emacs:: Using @value{GDBN} under @sc{gnu} Emacs
! * Annotations:: @value{GDBN}'s annotation interface.
!
! * GDB Bugs:: Reporting bugs in @value{GDBN}
! * Formatting Documentation:: How to format and print @value{GDBN} documentation
!
! * Command Line Editing:: Command Line Editing
! * Using History Interactively:: Using History Interactively
! * Installing GDB:: Installing GDB
! * Index:: Index
! @end menu
!
@end ifinfo
+
+ @c the replication sucks, but this avoids a texinfo 3.12 lameness
+
+ @ifhtml
+ @node Top
+
+ @top Debugging with @value{GDBN}
+
+ This file describes @value{GDBN}, the @sc{gnu} symbolic debugger.
+
+ This is the @value{EDITION} Edition, @value{DATE}, for @value{GDBN} Version
+ @value{GDBVN}.
+
+ Copyright (C) 1988-2000 Free Software Foundation, Inc.
+
@menu
* Summary:: Summary of @value{GDBN}
* Sample Session:: A sample @value{GDBN} session
*************** Copyright (C) 1988-1999 Free Software Fo
*** 144,150 ****
* Controlling GDB:: Controlling @value{GDBN}
* Sequences:: Canned sequences of commands
* Emacs:: Using @value{GDBN} under @sc{gnu} Emacs
! * Annotations:: @value{GDBN}'s annotations interface.
* GDB Bugs:: Reporting bugs in @value{GDBN}
* Formatting Documentation:: How to format and print @value{GDBN} documentation
--- 190,196 ----
* Controlling GDB:: Controlling @value{GDBN}
* Sequences:: Canned sequences of commands
* Emacs:: Using @value{GDBN} under @sc{gnu} Emacs
! * Annotations:: @value{GDBN}'s annotation interface.
* GDB Bugs:: Reporting bugs in @value{GDBN}
* Formatting Documentation:: How to format and print @value{GDBN} documentation
*************** Copyright (C) 1988-1999 Free Software Fo
*** 155,161 ****
* Index:: Index
@end menu
! @node Summary, Sample Session, Top, Top
@unnumbered Summary of @value{GDBN}
The purpose of a debugger such as @value{GDBN} is to allow you to see what is
--- 201,209 ----
* Index:: Index
@end menu
! @end ifhtml
!
! @node Summary
@unnumbered Summary of @value{GDBN}
The purpose of a debugger such as @value{GDBN} is to allow you to see what is
*************** underscore.
*** 205,211 ****
* Contributors:: Contributors to GDB
@end menu
! @node Free Software, Contributors, Summary, Summary
@unnumberedsec Free software
@value{GDBN} is @dfn{free software}, protected by the @sc{gnu}
--- 253,259 ----
* Contributors:: Contributors to GDB
@end menu
! @node Free Software
@unnumberedsec Free software
@value{GDBN} is @dfn{free software}, protected by the @sc{gnu}
*************** Fundamentally, the General Public Licens
*** 221,227 ****
you have these freedoms and that you cannot take these freedoms away
from anyone else.
! @node Contributors, , Free Software, Summary
@unnumberedsec Contributors to @value{GDBN}
Richard Stallman was the original author of @value{GDBN}, and of many
--- 269,275 ----
you have these freedoms and that you cannot take these freedoms away
from anyone else.
! @node Contributors
@unnumberedsec Contributors to @value{GDBN}
Richard Stallman was the original author of @value{GDBN}, and of many
*************** Thomas, Michael Tiemann, Tom Tromey, Ron
*** 360,366 ****
Zuhn have made contributions both large and small.
! @node Sample Session, Invocation, Summary, Top
@chapter A Sample @value{GDBN} Session
You can use this manual at your leisure to read all about @value{GDBN}.
--- 408,414 ----
Zuhn have made contributions both large and small.
! @node Sample Session
@chapter A Sample @value{GDBN} Session
You can use this manual at your leisure to read all about @value{GDBN}.
*************** session with the @value{GDBN} @code{quit
*** 630,636 ****
(@value{GDBP}) @b{quit}
@end smallexample
! @node Invocation, Commands, Sample Session, Top
@chapter Getting In and Out of @value{GDBN}
This chapter discusses how to start @value{GDBN}, and how to get out of it.
--- 678,684 ----
(@value{GDBP}) @b{quit}
@end smallexample
! @node Invocation
@chapter Getting In and Out of @value{GDBN}
This chapter discusses how to start @value{GDBN}, and how to get out of it.
*************** type @kbd{quit} or @kbd{C-d} to exit.
*** 648,654 ****
* Shell Commands:: How to use shell commands inside @value{GDBN}
@end menu
! @node Invoking GDB, Quitting GDB, Invocation, Invocation
@section Invoking @value{GDBN}
Invoke @value{GDBN} by running the program @code{@value{GDBP}}. Once started,
--- 696,702 ----
* Shell Commands:: How to use shell commands inside @value{GDBN}
@end menu
! @node Invoking GDB
@section Invoking @value{GDBN}
Invoke @value{GDBN} by running the program @code{@value{GDBP}}. Once started,
*************** in sequential order. The order makes a
*** 725,731 ****
* Mode Options:: Choosing modes
@end menu
! @node File Options, Mode Options, Invoking GDB, Invoking GDB
@subsection Choosing files
When @value{GDBN} starts, it reads any arguments other than options as
--- 773,779 ----
* Mode Options:: Choosing modes
@end menu
! @node File Options
@subsection Choosing files
When @value{GDBN} starts, it reads any arguments other than options as
*************** but build a @file{.syms} file for future
*** 833,839 ****
gdb -batch -nx -mapped -readnow programname
@end example
! @node Mode Options, , File Options, Invoking GDB
@subsection Choosing modes
You can run @value{GDBN} in various alternative modes---for example, in
--- 881,887 ----
gdb -batch -nx -mapped -readnow programname
@end example
! @node Mode Options
@subsection Choosing modes
You can run @value{GDBN} in various alternative modes---for example, in
*************** no-warranty blurb, and exit.
*** 1014,1020 ****
@end table
! @node Quitting GDB, Shell Commands, Invoking GDB, Invocation
@section Quitting @value{GDBN}
@cindex exiting @value{GDBN}
@cindex leaving @value{GDBN}
--- 1062,1068 ----
@end table
! @node Quitting GDB
@section Quitting @value{GDBN}
@cindex exiting @value{GDBN}
@cindex leaving @value{GDBN}
*************** If you have been using @value{GDBN} to c
*** 1042,1048 ****
device, you can release it with the @code{detach} command
(@pxref{Attach, ,Debugging an already-running process}).
! @node Shell Commands, , Quitting GDB, Invocation
@section Shell commands
If you need to execute occasional shell commands during your
--- 1090,1096 ----
device, you can release it with the @code{detach} command
(@pxref{Attach, ,Debugging an already-running process}).
! @node Shell Commands
@section Shell commands
If you need to execute occasional shell commands during your
*************** Execute the @code{make} program with the
*** 1071,1077 ****
arguments. This is equivalent to @samp{shell make @var{make-args}}.
@end table
! @node Commands, Running, Invocation, Top
@chapter @value{GDBN} Commands
You can abbreviate a @value{GDBN} command to the first few letters of the command
--- 1119,1125 ----
arguments. This is equivalent to @samp{shell make @var{make-args}}.
@end table
! @node Commands
@chapter @value{GDBN} Commands
You can abbreviate a @value{GDBN} command to the first few letters of the command
*************** show you the alternatives available, if
*** 1086,1092 ****
* Help:: How to ask @value{GDBN} for help
@end menu
! @node Command Syntax, Completion, Commands, Commands
@section Command syntax
A @value{GDBN} command is a single line of input. There is no limit on
--- 1134,1140 ----
* Help:: How to ask @value{GDBN} for help
@end menu
! @node Command Syntax
@section Command syntax
A @value{GDBN} command is a single line of input. There is no limit on
*************** Any text from a @kbd{#} to the end of th
*** 1129,1135 ****
nothing. This is useful mainly in command files (@pxref{Command
Files,,Command files}).
! @node Completion, Help, Command Syntax, Commands
@section Command completion
@cindex completion
--- 1177,1183 ----
nothing. This is useful mainly in command files (@pxref{Command
Files,,Command files}).
! @node Completion
@section Command completion
@cindex completion
*************** overload-resolution off} to disable over
*** 1248,1254 ****
see @ref{Debugging C plus plus, ,@value{GDBN} features for C++}.
! @node Help, , Completion, Commands
@section Getting help
@cindex online documentation
@kindex help
--- 1296,1302 ----
see @ref{Debugging C plus plus, ,@value{GDBN} features for C++}.
! @node Help
@section Getting help
@cindex online documentation
@kindex help
*************** apropos reload
*** 1331,1340 ****
@noindent results in:
@smallexample
! @group
! set symbol-reloading -- Set dynamic symbol table reloading multiple times in one run
! show symbol-reloading -- Show dynamic symbol table reloading multiple times in one run
! @end group
@end smallexample
@kindex complete
--- 1379,1390 ----
@noindent results in:
@smallexample
! @c @group
! set symbol-reloading -- Set dynamic symbol table reloading
! multiple times in one run
! show symbol-reloading -- Show dynamic symbol table reloading
! multiple times in one run
! @c @end group
@end smallexample
@kindex complete
*************** if your version of @value{GDBN} comes wi
*** 1433,1439 ****
@end table
! @node Running, Stopping, Commands, Top
@chapter Running Programs Under @value{GDBN}
When you run a program under @value{GDBN}, you must first generate
--- 1483,1489 ----
@end table
! @node Running
@chapter Running Programs Under @value{GDBN}
When you run a program under @value{GDBN}, you must first generate
*************** kill a child process.
*** 1459,1465 ****
* Processes:: Debugging programs with multiple processes
@end menu
! @node Compilation, Starting, Running, Running
@section Compiling for debugging
In order to debug a program effectively, you need to generate
--- 1509,1515 ----
* Processes:: Debugging programs with multiple processes
@end menu
! @node Compilation
@section Compiling for debugging
In order to debug a program effectively, you need to generate
*************** Older versions of the @sc{gnu} C compile
*** 1500,1506 ****
format; if your @sc{gnu} C compiler has this option, do not use it.
@need 2000
! @node Starting, Arguments, Compilation, Running
@section Starting your program
@cindex starting
@cindex running
--- 1550,1556 ----
format; if your @sc{gnu} C compiler has this option, do not use it.
@need 2000
! @node Starting
@section Starting your program
@cindex starting
@cindex running
*************** time @value{GDBN} read its symbols, @val
*** 1576,1582 ****
table, and reads it again. When it does this, @value{GDBN} tries to retain
your current breakpoints.
! @node Arguments, Environment, Starting, Running
@section Your program's arguments
@cindex arguments (to your program)
--- 1626,1632 ----
table, and reads it again. When it does this, @value{GDBN} tries to retain
your current breakpoints.
! @node Arguments
@section Your program's arguments
@cindex arguments (to your program)
*************** it again without arguments.
*** 1610,1616 ****
Show the arguments to give your program when it is started.
@end table
! @node Environment, Working Directory, Arguments, Running
@section Your program's environment
@cindex environment (of your program)
--- 1660,1666 ----
Show the arguments to give your program when it is started.
@end table
! @node Environment
@section Your program's environment
@cindex environment (of your program)
*************** your program. You may wish to move sett
*** 1693,1699 ****
files that are only run when you sign on, such as @file{.login} or
@file{.profile}.
! @node Working Directory, Input/Output, Environment, Running
@section Your program's working directory
@cindex working directory (of your program)
--- 1743,1749 ----
files that are only run when you sign on, such as @file{.login} or
@file{.profile}.
! @node Working Directory
@section Your program's working directory
@cindex working directory (of your program)
*************** Set the @value{GDBN} working directory t
*** 1717,1723 ****
Print the @value{GDBN} working directory.
@end table
! @node Input/Output, Attach, Working Directory, Running
@section Your program's input and output
@cindex redirection
--- 1767,1773 ----
Print the @value{GDBN} working directory.
@end table
! @node Input/Output
@section Your program's input and output
@cindex redirection
*************** When you use the @code{tty} command or r
*** 1771,1777 ****
command, only the input @emph{for your program} is affected. The input
for @value{GDBN} still comes from your terminal.
! @node Attach, Kill Process, Input/Output, Running
@section Debugging an already-running process
@kindex attach
@cindex attach
--- 1821,1827 ----
command, only the input @emph{for your program} is affected. The input
for @value{GDBN} still comes from your terminal.
! @node Attach
@section Debugging an already-running process
@kindex attach
@cindex attach
*************** control whether or not you need to confi
*** 1827,1833 ****
confirm} command (@pxref{Messages/Warnings, ,Optional warnings and
messages}).
! @node Kill Process, Threads, Attach, Running
@section Killing the child process
@table @code
--- 1877,1883 ----
confirm} command (@pxref{Messages/Warnings, ,Optional warnings and
messages}).
! @node Kill Process
@section Killing the child process
@table @code
*************** next type @code{run}, @value{GDBN} notic
*** 1852,1858 ****
reads the symbol table again (while trying to preserve your current
breakpoint settings).
! @node Threads, Processes, Kill Process, Running
@section Debugging programs with multiple threads
@cindex threads of execution
--- 1902,1908 ----
reads the symbol table again (while trying to preserve your current
breakpoint settings).
! @node Threads
@section Debugging programs with multiple threads
@cindex threads of execution
*************** For example,
*** 2017,2025 ****
@example
(@value{GDBP}) info threads
! * 3 system thread 26607 worker (wptr=0x7b09c318 "@@") at quicksort.c:137
! 2 system thread 26606 0x7b0030d8 in __ksleep () from /usr/lib/libc.2
! 1 system thread 27905 0x7b003498 in _brk () from /usr/lib/libc.2
@end example
@table @code
--- 2067,2078 ----
@example
(@value{GDBP}) info threads
! * 3 system thread 26607 worker (wptr=0x7b09c318 "@@") \@*
! at quicksort.c:137
! 2 system thread 26606 0x7b0030d8 in __ksleep () \@*
! from /usr/lib/libc.2
! 1 system thread 27905 0x7b003498 in _brk () \@*
! from /usr/lib/libc.2
@end example
@table @code
*************** programs with multiple threads.
*** 2069,2075 ****
@xref{Set Watchpoints,,Setting watchpoints}, for information about
watchpoints in programs with multiple threads.
! @node Processes, , Threads, Running
@section Debugging programs with multiple processes
@cindex fork, debugging programs which call
--- 2122,2128 ----
@xref{Set Watchpoints,,Setting watchpoints}, for information about
watchpoints in programs with multiple threads.
! @node Processes
@section Debugging programs with multiple processes
@cindex fork, debugging programs which call
*************** You can use the @code{catch} command to
*** 2146,2152 ****
a @code{fork}, @code{vfork}, or @code{exec} call is made. @xref{Set
Catchpoints, ,Setting catchpoints}.
! @node Stopping, Stack, Running, Top
@chapter Stopping and Continuing
The principal purposes of using a debugger are so that you can stop your
--- 2199,2205 ----
a @code{fork}, @code{vfork}, or @code{exec} call is made. @xref{Set
Catchpoints, ,Setting catchpoints}.
! @node Stopping
@chapter Stopping and Continuing
The principal purposes of using a debugger are so that you can stop your
*************** running or not, what process it is, and
*** 2175,2181 ****
* Thread Stops:: Stopping and starting multi-thread programs
@end menu
! @node Breakpoints, Continuing and Stepping, Stopping, Stopping
@section Breakpoints, watchpoints, and catchpoints
@cindex breakpoints
--- 2228,2234 ----
* Thread Stops:: Stopping and starting multi-thread programs
@end menu
! @node Breakpoints
@section Breakpoints, watchpoints, and catchpoints
@cindex breakpoints
*************** all breakpoint in that range are operate
*** 2249,2255 ****
* Error in Breakpoints:: ``Cannot insert breakpoints''
@end menu
! @node Set Breaks, Set Watchpoints, Breakpoints, Breakpoints
@subsection Setting breakpoints
@c FIXME LMB what does GDB do if no code on line of breakpt?
--- 2302,2308 ----
* Error in Breakpoints:: ``Cannot insert breakpoints''
@end menu
! @node Set Breaks
@subsection Setting breakpoints
@c FIXME LMB what does GDB do if no code on line of breakpt?
*************** Shared library events.
*** 2481,2487 ****
@end table
! @node Set Watchpoints, Set Catchpoints, Set Breaks, Breakpoints
@subsection Setting watchpoints
@cindex setting watchpoints
--- 2534,2540 ----
@end table
! @node Set Watchpoints
@subsection Setting watchpoints
@cindex setting watchpoints
*************** when a non-current thread's activity cha
*** 2624,2630 ****
watchpoints, in contrast, watch an expression in all threads.)
@end quotation
! @node Set Catchpoints, Delete Breaks, Set Watchpoints, Breakpoints
@subsection Setting catchpoints
@cindex catchpoints, setting
@cindex exception handlers
--- 2677,2683 ----
watchpoints, in contrast, watch an expression in all threads.)
@end quotation
! @node Set Catchpoints
@subsection Setting catchpoints
@cindex catchpoints, setting
@cindex exception handlers
*************** breakpoints to stop your program when an
*** 2732,2738 ****
raised.
! @node Delete Breaks, Disabling, Set Catchpoints, Breakpoints
@subsection Deleting breakpoints
@cindex clearing breakpoints, watchpoints, catchpoints
--- 2785,2791 ----
raised.
! @node Delete Breaks
@subsection Deleting breakpoints
@cindex clearing breakpoints, watchpoints, catchpoints
*************** breakpoints (@value{GDBN} asks confirmat
*** 2777,2783 ****
confirm off}). You can abbreviate this command as @code{d}.
@end table
! @node Disabling, Conditions, Delete Breaks, Breakpoints
@subsection Disabling breakpoints
@kindex disable breakpoints
--- 2830,2836 ----
confirm off}). You can abbreviate this command as @code{d}.
@end table
! @node Disabling
@subsection Disabling breakpoints
@kindex disable breakpoints
*************** breakpoint of its own, but it does not c
*** 2850,2856 ****
breakpoints; see @ref{Continuing and Stepping, ,Continuing and
stepping}.)
! @node Conditions, Break Commands, Disabling, Breakpoints
@subsection Break conditions
@cindex conditional breakpoints
@cindex breakpoint conditions
--- 2903,2909 ----
breakpoints; see @ref{Continuing and Stepping, ,Continuing and
stepping}.)
! @node Conditions
@subsection Break conditions
@cindex conditional breakpoints
@cindex breakpoint conditions
*************** variables}.
*** 2967,2973 ****
Ignore counts apply to breakpoints, watchpoints, and catchpoints.
! @node Break Commands, Breakpoint Menus, Conditions, Breakpoints
@subsection Breakpoint command lists
@cindex breakpoint commands
--- 3020,3026 ----
Ignore counts apply to breakpoints, watchpoints, and catchpoints.
! @node Break Commands
@subsection Breakpoint command lists
@cindex breakpoint commands
*************** cont
*** 3048,3054 ****
end
@end example
! @node Breakpoint Menus, Error in Breakpoints, Break Commands, Breakpoints
@subsection Breakpoint menus
@cindex overloading
@cindex symbol overloading
--- 3101,3107 ----
end
@end example
! @node Breakpoint Menus
@subsection Breakpoint menus
@cindex overloading
@cindex symbol overloading
*************** Use the "delete" command to delete unwan
*** 3095,3101 ****
@end smallexample
@c @ifclear BARETARGET
! @node Error in Breakpoints, , Breakpoint Menus, Breakpoints
@subsection ``Cannot insert breakpoints''
@c
@c FIXME!! 14/6/95 Is there a real example of this? Let's use it.
--- 3148,3154 ----
@end smallexample
@c @ifclear BARETARGET
! @node Error in Breakpoints
@subsection ``Cannot insert breakpoints''
@c
@c FIXME!! 14/6/95 Is there a real example of this? Let's use it.
*************** When this message is printed, you need t
*** 3148,3154 ****
hardware-assisted breakpoints and watchpoints, and then continue.
! @node Continuing and Stepping, Signals, Breakpoints, Stopping
@section Continuing and stepping
@cindex stepping
--- 3201,3207 ----
hardware-assisted breakpoints and watchpoints, and then continue.
! @node Continuing and Stepping
@section Continuing and stepping
@cindex stepping
*************** proceed until the function returns.
*** 3350,3356 ****
An argument is a repeat count, as in @code{next}.
@end table
! @node Signals, Thread Stops, Continuing and Stepping, Stopping
@section Signals
@cindex signals
--- 3403,3409 ----
An argument is a repeat count, as in @code{next}.
@end table
! @node Signals
@section Signals
@cindex signals
*************** a result of the fatal signal once it saw
*** 3446,3452 ****
you can continue with @samp{signal 0}. @xref{Signaling, ,Giving your
program a signal}.
! @node Thread Stops, , Signals, Stopping
@section Stopping and starting multi-thread programs
When your program has multiple threads (@pxref{Threads,, Debugging
--- 3499,3505 ----
you can continue with @samp{signal 0}. @xref{Signaling, ,Giving your
program a signal}.
! @node Thread Stops
@section Stopping and starting multi-thread programs
When your program has multiple threads (@pxref{Threads,, Debugging
*************** Display the current scheduler locking mo
*** 3531,3537 ****
@end table
! @node Stack, Source, Stopping, Top
@chapter Examining the Stack
When your program has stopped, the first thing you need to know is where it
--- 3584,3590 ----
@end table
! @node Stack
@chapter Examining the Stack
When your program has stopped, the first thing you need to know is where it
*************** currently executing frame and describes
*** 3570,3576 ****
@end menu
! @node Frames, Backtrace, Stack, Stack
@section Stack frames
@cindex frame, definition
--- 3623,3629 ----
@end menu
! @node Frames
@section Stack frames
@cindex frame, definition
*************** and so on upward. These numbers do not
*** 3608,3618 ****
they are assigned by @value{GDBN} to give you a way of designating stack
frames in @value{GDBN} commands.
! @c below produces an acceptable overful hbox. --mew 13aug1993
@cindex frameless execution
Some compilers provide a way to compile functions so that they operate
! without stack frames. (For example, the @code{@value{GCC}} option
! @samp{-fomit-frame-pointer} generates functions without a frame.)
This is occasionally done with heavily used library functions to save
the frame setup time. @value{GDBN} has limited facilities for dealing
with these function invocations. If the innermost function invocation
--- 3661,3675 ----
they are assigned by @value{GDBN} to give you a way of designating stack
frames in @value{GDBN} commands.
! @c The -fomit-frame-pointer below perennially causes hbox overflow
! @c underflow problems.
@cindex frameless execution
Some compilers provide a way to compile functions so that they operate
! without stack frames. (For example, the @value{GCC} option
! @example
! @samp{-fomit-frame-pointer}
! @end example
! generates functions without a frame.)
This is occasionally done with heavily used library functions to save
the frame setup time. @value{GDBN} has limited facilities for dealing
with these function invocations. If the innermost function invocation
*************** to another without printing the frame.
*** 3636,3642 ****
@code{frame}.
@end table
! @node Backtrace, Selection, Frames, Stack
@section Backtraces
@cindex backtraces
--- 3693,3699 ----
@code{frame}.
@end table
! @node Backtrace
@section Backtraces
@cindex backtraces
*************** The display for frame zero does not begi
*** 3699,3705 ****
value, indicating that your program has stopped at the beginning of the
code for line @code{993} of @code{builtin.c}.
! @node Selection, Frame Info, Backtrace, Stack
@section Selecting a frame
Most commands for examining the stack and other data in your program work on
--- 3756,3762 ----
value, indicating that your program has stopped at the beginning of the
code for line @code{993} of @code{builtin.c}.
! @node Selection
@section Selecting a frame
Most commands for examining the stack and other data in your program work on
*************** in @value{GDBN} command scripts, where t
*** 3785,3791 ****
distracting.
@end table
! @node Frame Info, , Selection, Stack
@section Information about a frame
There are several other commands to print information about the selected
--- 3842,3848 ----
distracting.
@end table
! @node Frame Info
@section Information about a frame
There are several other commands to print information about the selected
*************** exception handlers, visit the associated
*** 3861,3867 ****
@end table
! @node Source, Data, Stack, Top
@chapter Examining Source Files
@value{GDBN} can print parts of your program's source, since the debugging
--- 3918,3924 ----
@end table
! @node Source
@chapter Examining Source Files
@value{GDBN} can print parts of your program's source, since the debugging
*************** prefer to use Emacs facilities to view s
*** 3883,3889 ****
* Machine Code:: Source and machine code
@end menu
! @node List, Search, Source, Source
@section Printing source lines
@kindex list
--- 3940,3946 ----
* Machine Code:: Source and machine code
@end menu
! @node List
@section Printing source lines
@kindex list
*************** Specifies the line containing the progra
*** 4000,4006 ****
@var{address} may be any expression.
@end table
! @node Search, Source Path, List, Source
@section Searching source files
@cindex searching
@kindex reverse-search
--- 4057,4063 ----
@var{address} may be any expression.
@end table
! @node Search
@section Searching source files
@cindex searching
@kindex reverse-search
*************** for @var{regexp}. It lists the line tha
*** 4026,4032 ****
this command as @code{rev}.
@end table
! @node Source Path, Machine Code, Search, Source
@section Specifying source directories
@cindex source path
--- 4083,4089 ----
this command as @code{rev}.
@end table
! @node Source Path
@section Specifying source directories
@cindex source path
*************** directories you want in the source path.
*** 4109,4115 ****
directories in one command.
@end enumerate
! @node Machine Code, , Source Path, Source
@section Source and machine code
You can use the command @code{info line} to map source lines to program
--- 4166,4172 ----
directories in one command.
@end enumerate
! @node Machine Code
@section Source and machine code
You can use the command @code{info line} to map source lines to program
*************** assemblers for x86-based targets.
*** 4210,4216 ****
@end table
! @node Data, Languages, Source, Top
@chapter Examining Data
@cindex printing data
--- 4267,4273 ----
@end table
! @node Data
@chapter Examining Data
@cindex printing data
*************** Table}.
*** 4265,4271 ****
* Floating Point Hardware:: Floating point hardware
@end menu
! @node Expressions, Variables, Data, Data
@section Expressions
@cindex expressions
--- 4322,4328 ----
* Floating Point Hardware:: Floating point hardware
@end menu
! @node Expressions
@section Expressions
@cindex expressions
*************** a cast). This construct is allowed rega
*** 4318,4324 ****
normally supposed to reside at @var{addr}.
@end table
! @node Variables, Arrays, Expressions, Data
@section Program variables
The most common kind of expression to use is the name of a variable
--- 4375,4381 ----
normally supposed to reside at @var{addr}.
@end table
! @node Variables
@section Program variables
The most common kind of expression to use is the name of a variable
*************** Program or @sc{gnu} CC, gcc.info, Using
*** 4439,4445 ****
information.
! @node Arrays, Output Formats, Variables, Data
@section Artificial arrays
@cindex artificial array
--- 4496,4502 ----
information.
! @node Arrays
@section Artificial arrays
@cindex artificial array
*************** p dtab[$i++]->fv
*** 4511,4517 ****
@dots{}
@end example
! @node Output Formats, Memory, Arrays, Data
@section Output formats
@cindex formatted output
--- 4568,4574 ----
@dots{}
@end example
! @node Output Formats
@section Output formats
@cindex formatted output
*************** To reprint the last value in the value h
*** 4580,4586 ****
you can use the @code{print} command with just a format and no
expression. For example, @samp{p/x} reprints the last value in hex.
! @node Memory, Auto Display, Output Formats, Data
@section Examining memory
You can use the command @code{x} (for ``examine'') to examine memory in
--- 4637,4643 ----
you can use the @code{print} command with just a format and no
expression. For example, @samp{p/x} reprints the last value in hex.
! @node Memory
@section Examining memory
You can use the command @code{x} (for ``examine'') to examine memory in
*************** If the @code{x} command has a repeat cou
*** 4685,4691 ****
are from the last memory unit printed; this is not the same as the last
address printed if several units were printed on the last line of output.
! @node Auto Display, Print Settings, Memory, Data
@section Automatic display
@cindex automatic display
@cindex display of expressions
--- 4742,4748 ----
are from the last memory unit printed; this is not the same as the last
address printed if several units were printed on the last line of output.
! @node Auto Display
@section Automatic display
@cindex automatic display
@cindex display of expressions
*************** there is no variable @code{last_char}---
*** 4781,4787 ****
automatically. The next time your program stops where @code{last_char}
is meaningful, you can enable the display expression once again.
! @node Print Settings, Value History, Auto Display, Data
@section Print settings
@cindex format options
--- 4838,4844 ----
automatically. The next time your program stops where @code{last_char}
is meaningful, you can enable the display expression once again.
! @node Print Settings
@section Print settings
@cindex format options
*************** Do not pretty print C++ virtual function
*** 5142,5148 ****
Show whether C++ virtual function tables are pretty printed, or not.
@end table
! @node Value History, Convenience Vars, Print Settings, Data
@section Value history
@cindex value history
--- 5199,5205 ----
Show whether C++ virtual function tables are pretty printed, or not.
@end table
! @node Value History
@section Value history
@cindex value history
*************** values are available, @code{show values
*** 5219,5225 ****
Pressing @key{RET} to repeat @code{show values @var{n}} has exactly the
same effect as @samp{show values +}.
! @node Convenience Vars, Registers, Value History, Data
@section Convenience variables
@cindex convenience variables
--- 5276,5282 ----
Pressing @key{RET} to repeat @code{show values @var{n}} has exactly the
same effect as @samp{show values +}.
! @node Convenience Vars
@section Convenience variables
@cindex convenience variables
*************** On HP-UX systems, if you refer to a func
*** 5305,5311 ****
begins with a dollar sign, @value{GDBN} searches for a user or system
name first, before it searches for a convenience variable.
! @node Registers, Floating Point Hardware, Convenience Vars, Data
@section Registers
@cindex registers
--- 5362,5368 ----
begins with a dollar sign, @value{GDBN} searches for a user or system
name first, before it searches for a convenience variable.
! @node Registers
@section Registers
@cindex registers
*************** code generated by your compiler. If som
*** 5404,5410 ****
@value{GDBN} is unable to locate the saved registers, the selected stack
frame makes no difference.
! @node Floating Point Hardware, , Registers, Data
@section Floating point hardware
@cindex floating point
--- 5461,5467 ----
@value{GDBN} is unable to locate the saved registers, the selected stack
frame makes no difference.
! @node Floating Point Hardware
@section Floating point hardware
@cindex floating point
*************** floating point chip. Currently, @samp{i
*** 5420,5426 ****
the ARM and x86 machines.
@end table
! @node Languages, Symbols, Data, Top
@chapter Using @value{GDBN} with Different Languages
@cindex languages
--- 5477,5483 ----
the ARM and x86 machines.
@end table
! @node Languages
@chapter Using @value{GDBN} with Different Languages
@cindex languages
*************** language}.
*** 5446,5452 ****
* Support:: Supported languages
@end menu
! @node Setting, Show, Languages, Languages
@section Switching between source languages
There are two ways to control the working language---either have @value{GDBN}
--- 5503,5509 ----
* Support:: Supported languages
@end menu
! @node Setting
@section Switching between source languages
There are two ways to control the working language---either have @value{GDBN}
*************** program, and will display that source co
*** 5480,5486 ****
* Automatically:: Having @value{GDBN} infer the source language
@end menu
! @node Filenames, Manually, Setting, Setting
@subsection List of filename extensions and languages
If a source file name ends in one of the following extensions, then
--- 5537,5543 ----
* Automatically:: Having @value{GDBN} infer the source language
@end menu
! @node Filenames
@subsection List of filename extensions and languages
If a source file name ends in one of the following extensions, then
*************** Assembler source file. This actually be
*** 5520,5526 ****
In addition, you may set the language associated with a filename
extension. @xref{Show, , Displaying the language}.
! @node Manually, Automatically, Filenames, Setting
@subsection Setting the working language
If you allow @value{GDBN} to set the language automatically,
--- 5577,5583 ----
In addition, you may set the language associated with a filename
extension. @xref{Show, , Displaying the language}.
! @node Manually
@subsection Setting the working language
If you allow @value{GDBN} to set the language automatically,
*************** might not have the effect you intended.
*** 5552,5558 ****
printed would be the value of @code{a}. In Modula-2, this means to compare
@code{a} to the result of @code{b+c}, yielding a @code{BOOLEAN} value.
! @node Automatically, , Manually, Setting
@subsection Having @value{GDBN} infer the source language
To have @value{GDBN} set the working language automatically, use
--- 5609,5615 ----
printed would be the value of @code{a}. In Modula-2, this means to compare
@code{a} to the result of @code{b+c}, yielding a @code{BOOLEAN} value.
! @node Automatically
@subsection Having @value{GDBN} infer the source language
To have @value{GDBN} set the working language automatically, use
*************** written in one source language can be us
*** 5571,5577 ****
a different source language. Using @samp{set language auto} in this
case frees you from having to set the working language manually.
! @node Show, Checks, Setting, Languages
@section Displaying the language
The following commands help you find out which language is the
--- 5628,5634 ----
a different source language. Using @samp{set language auto} in this
case frees you from having to set the working language manually.
! @node Show
@section Displaying the language
The following commands help you find out which language is the
*************** the source language @var{language}.
*** 5613,5619 ****
List all the filename extensions and the associated languages.
@end table
! @node Checks, Support, Show, Languages
@section Type and range checking
@quotation
--- 5670,5676 ----
List all the filename extensions and the associated languages.
@end table
! @node Checks
@section Type and range checking
@quotation
*************** for the default settings of supported la
*** 5646,5652 ****
@cindex type checking
@cindex checks, type
! @node Type Checking, Range Checking, Checks, Checks
@subsection An overview of type checking
Some languages, such as Modula-2, are strongly typed, meaning that the
--- 5703,5709 ----
@cindex type checking
@cindex checks, type
! @node Type Checking
@subsection An overview of type checking
Some languages, such as Modula-2, are strongly typed, meaning that the
*************** is setting it automatically.
*** 5717,5723 ****
@cindex range checking
@cindex checks, range
! @node Range Checking, , Type Checking, Checks
@subsection An overview of range checking
In some languages (such as Modula-2), it is an error to exceed the
--- 5774,5780 ----
@cindex range checking
@cindex checks, range
! @node Range Checking
@subsection An overview of range checking
In some languages (such as Modula-2), it is an error to exceed the
*************** Show the current setting of the range ch
*** 5776,5782 ****
being set automatically by @value{GDBN}.
@end table
! @node Support, , Checks, Languages
@section Supported languages
@value{GDBN} supports C, C++, Fortran, Java, Chill, assembly, and Modula-2.
--- 5833,5839 ----
being set automatically by @value{GDBN}.
@end table
! @node Support
@section Supported languages
@value{GDBN} supports C, C++, Fortran, Java, Chill, assembly, and Modula-2.
*************** language reference or tutorial.
*** 5801,5807 ****
* Chill:: Chill
@end menu
! @node C, Modula-2, Support, Support
@subsection C and C++
@cindex C and C++
--- 5858,5864 ----
* Chill:: Chill
@end menu
! @node C
@subsection C and C++
@cindex C and C++
*************** CC, gcc.info, Using @sc{gnu} CC}, for mo
*** 5836,5842 ****
* Debugging C plus plus:: @value{GDBN} features for C++
@end menu
! @node C Operators, C Constants, C, C
@subsubsection C and C++ operators
@cindex C and C++ operators
--- 5893,5899 ----
* Debugging C plus plus:: @value{GDBN} features for C++
@end menu
! @node C Operators
@subsubsection C and C++ operators
@cindex C and C++ operators
*************** predefined meaning.
*** 5996,6002 ****
* C Constants::
@end menu
! @node C Constants, C plus plus expressions, C Operators, C
@subsubsection C and C++ constants
@cindex C and C++ constants
--- 6053,6059 ----
* C Constants::
@end menu
! @node C Constants
@subsubsection C and C++ constants
@cindex C and C++ constants
*************** and @samp{@{&"hi", &"there", &"fred"@}}
*** 6064,6070 ****
* Debugging C::
@end menu
! @node C plus plus expressions, C Defaults, C Constants, C
@subsubsection C++ expressions
@cindex expressions in C++
--- 6121,6127 ----
* Debugging C::
@end menu
! @node C plus plus expressions
@subsubsection C++ expressions
@cindex expressions in C++
*************** calling virtual functions correctly, pri
*** 6169,6175 ****
objects, calling functions in a base subobject, casting objects, and
invoking user-defined operators.
! @node C Defaults, C Checks, C plus plus expressions, C
@subsubsection C and C++ defaults
@cindex C and C++ defaults
--- 6226,6232 ----
objects, calling functions in a base subobject, casting objects, and
invoking user-defined operators.
! @node C Defaults
@subsubsection C and C++ defaults
@cindex C and C++ defaults
*************** for further details.
*** 6190,6196 ****
@c unimplemented. If (b) changes, it might make sense to let this node
@c appear even if Mod-2 does not, but meanwhile ignore it. roland 16jul93.
! @node C Checks, Debugging C, C Defaults, C
@subsubsection C and C++ type and range checks
@cindex C and C++ checks
--- 6247,6253 ----
@c unimplemented. If (b) changes, it might make sense to let this node
@c appear even if Mod-2 does not, but meanwhile ignore it. roland 16jul93.
! @node C Checks
@subsubsection C and C++ type and range checks
@cindex C and C++ checks
*************** Range checking, if turned on, is done on
*** 6222,6228 ****
indices are not checked, since they are often used to index a pointer
that is not itself an array.
! @node Debugging C, Debugging C plus plus, C Checks, C
@subsubsection @value{GDBN} and C
The @code{set print union} and @code{show print union} commands apply to
--- 6279,6285 ----
indices are not checked, since they are often used to index a pointer
that is not itself an array.
! @node Debugging C
@subsubsection @value{GDBN} and C
The @code{set print union} and @code{show print union} commands apply to
*************** with pointers and a memory allocation fu
*** 6238,6244 ****
* Debugging C plus plus::
@end menu
! @node Debugging C plus plus, , Debugging C, C
@subsubsection @value{GDBN} features for C++
@cindex commands for C++
--- 6295,6301 ----
* Debugging C plus plus::
@end menu
! @node Debugging C plus plus
@subsubsection @value{GDBN} features for C++
@cindex commands for C++
*************** available choices, or to finish the type
*** 6321,6327 ****
@xref{Completion,, Command completion}, for details on how to do this.
@end table
! @node Modula-2, Chill, C, Support
@subsection Modula-2
@cindex Modula-2, @value{GDBN} support
--- 6378,6384 ----
@xref{Completion,, Command completion}, for details on how to do this.
@end table
! @node Modula-2
@subsection Modula-2
@cindex Modula-2, @value{GDBN} support
*************** table.
*** 6345,6351 ****
* GDB/M2:: @value{GDBN} and Modula-2
@end menu
! @node M2 Operators, Built-In Func/Proc, Modula-2, Modula-2
@subsubsection Operators
@cindex Modula-2 operators
--- 6402,6408 ----
* GDB/M2:: @value{GDBN} and Modula-2
@end menu
! @node M2 Operators
@subsubsection Operators
@cindex Modula-2 operators
*************** treats the use of the operator @code{IN}
*** 6469,6475 ****
@end quotation
@cindex Modula-2 built-ins
! @node Built-In Func/Proc, M2 Constants, M2 Operators, Modula-2
@subsubsection Built-in functions and procedures
Modula-2 also makes available several built-in procedures and functions.
--- 6526,6532 ----
@end quotation
@cindex Modula-2 built-ins
! @node Built-In Func/Proc
@subsubsection Built-in functions and procedures
Modula-2 also makes available several built-in procedures and functions.
*************** an error.
*** 6581,6587 ****
@end quotation
@cindex Modula-2 constants
! @node M2 Constants, M2 Defaults, Built-In Func/Proc, Modula-2
@subsubsection Constants
@value{GDBN} allows you to express the constants of Modula-2 in the following
--- 6638,6644 ----
@end quotation
@cindex Modula-2 constants
! @node M2 Constants
@subsubsection Constants
@value{GDBN} allows you to express the constants of Modula-2 in the following
*************** Pointer constants consist of integral va
*** 6630,6636 ****
Set constants are not yet supported.
@end itemize
! @node M2 Defaults, Deviations, M2 Constants, Modula-2
@subsubsection Modula-2 defaults
@cindex Modula-2 defaults
--- 6687,6693 ----
Set constants are not yet supported.
@end itemize
! @node M2 Defaults
@subsubsection Modula-2 defaults
@cindex Modula-2 defaults
*************** code compiled from a file whose name end
*** 6644,6650 ****
working language to Modula-2. @xref{Automatically, ,Having @value{GDBN} set
the language automatically}, for further details.
! @node Deviations, M2 Checks, M2 Defaults, Modula-2
@subsubsection Deviations from standard Modula-2
@cindex Modula-2, deviations from
--- 6701,6707 ----
working language to Modula-2. @xref{Automatically, ,Having @value{GDBN} set
the language automatically}, for further details.
! @node Deviations
@subsubsection Deviations from standard Modula-2
@cindex Modula-2, deviations from
*************** argument.
*** 6674,6680 ****
All built-in procedures both modify @emph{and} return their argument.
@end itemize
! @node M2 Checks, M2 Scope, Deviations, Modula-2
@subsubsection Modula-2 type and range checks
@cindex Modula-2 checks
--- 6731,6737 ----
All built-in procedures both modify @emph{and} return their argument.
@end itemize
! @node M2 Checks
@subsubsection Modula-2 type and range checks
@cindex Modula-2 checks
*************** whose types are not equivalent is an err
*** 6702,6708 ****
Range checking is done on all mathematical operations, assignment, array
index bounds, and all built-in functions and procedures.
! @node M2 Scope, GDB/M2, M2 Checks, Modula-2
@subsubsection The scope operators @code{::} and @code{.}
@cindex scope
@kindex .
--- 6759,6765 ----
Range checking is done on all mathematical operations, assignment, array
index bounds, and all built-in functions and procedures.
! @node M2 Scope
@subsubsection The scope operators @code{::} and @code{.}
@cindex scope
@kindex .
*************** an error if the identifier @var{id} was
*** 6742,6748 ****
module @var{module}, or if @var{id} is not an identifier in
@var{module}.
! @node GDB/M2, , M2 Scope, Modula-2
@subsubsection @value{GDBN} and Modula-2
Some @value{GDBN} commands have little use when debugging Modula-2 programs.
--- 6799,6805 ----
module @var{module}, or if @var{id} is not an identifier in
@var{module}.
! @node GDB/M2
@subsubsection @value{GDBN} and Modula-2
Some @value{GDBN} commands have little use when debugging Modula-2 programs.
*************** address can be specified by an integral
*** 6763,6769 ****
In @value{GDBN} scripts, the Modula-2 inequality operator @code{#} is
interpreted as the beginning of a comment. Use @code{<>} instead.
! @node Chill, , Modula-2, Support
@subsection Chill
The extensions made to @value{GDBN} to support Chill only support output
--- 6820,6826 ----
In @value{GDBN} scripts, the Modula-2 inequality operator @code{#} is
interpreted as the beginning of a comment. Use @code{<>} instead.
! @node Chill
@subsection Chill
The extensions made to @value{GDBN} to support Chill only support output
*************** of @value{GDBN} which support these topi
*** 6785,6791 ****
* Chill defaults::
@end menu
! @node How modes are displayed, Locations, Chill, Chill
@subsubsection How modes are displayed
The Chill Datatype- (Mode) support of @value{GDBN} is directly related
--- 6842,6848 ----
* Chill defaults::
@end menu
! @node How modes are displayed
@subsubsection How modes are displayed
The Chill Datatype- (Mode) support of @value{GDBN} is directly related
*************** type = SET (karli = 10, susi = 20, fritz
*** 6813,6822 ****
@end smallexample
If the type is an unnumbered set the set element values are omitted.
@item
! @emph{Range Mode} which is displayed by @code{type = <basemode>
! (<lower bound> : <upper bound>)}, where @code{<lower bound>, <upper
! bound>} can be of any discrete literal expression (e.g. set element
! names).
@end itemize
@item @r{@emph{Powerset Mode:}}
--- 6870,6881 ----
@end smallexample
If the type is an unnumbered set the set element values are omitted.
@item
! @emph{Range Mode} which is displayed by
! @smallexample
! @code{type = <basemode>(<lower bound> : <upper bound>)}
! @end smallexample
! where @code{<lower bound>, <upper bound>} can be of any discrete literal
! expression (e.g. set element names).
@end itemize
@item @r{@emph{Powerset Mode:}}
*************** type, and is therefore not really of int
*** 6852,6862 ****
@item @r{@emph{Synchronization Modes:}}
@itemize @bullet
@item
! @emph{Event Mode} which is displayed by @code{EVENT (<event length>)},
where @code{(<event length>)} is optional.
@item
! @emph{Buffer Mode} which is displayed by @code{BUFFER (<buffer length>)
! <buffer element mode>}, where @code{(<buffer length>)} is optional.
@end itemize
@item @r{@emph{Timing Modes:}}
--- 6911,6927 ----
@item @r{@emph{Synchronization Modes:}}
@itemize @bullet
@item
! @emph{Event Mode} which is displayed by
! @smallexample
! @code{EVENT (<event length>)}
! @end smallexample
where @code{(<event length>)} is optional.
@item
! @emph{Buffer Mode} which is displayed by
! @smallexample
! @code{BUFFER (<buffer length>)<buffer element mode>}
! @end smallexample
! where @code{(<buffer length>)} is optional.
@end itemize
@item @r{@emph{Timing Modes:}}
*************** Real Modes are predefined with @code{REA
*** 6873,6884 ****
@item @r{@emph{String Modes:}}
@itemize @bullet
@item
! @emph{Character String Mode} which is displayed by @code{CHARS(<string
! length>)}, followed by the keyword @code{VARYING} if the String Mode is
! a varying mode
@item
! @emph{Bit String Mode} which is displayed by @code{BOOLS(<string
! length>)}.
@end itemize
@item @r{@emph{Array Mode:}}
--- 6938,6955 ----
@item @r{@emph{String Modes:}}
@itemize @bullet
@item
! @emph{Character String Mode} which is displayed by
! @smallexample
! @code{CHARS(<string length>)}
! @end smallexample
! followed by the keyword @code{VARYING} if the String Mode is a varying
! mode
@item
! @emph{Bit String Mode} which is displayed by
! @smallexample
! @code{BOOLS(<string
! length>)}
! @end smallexample
@end itemize
@item @r{@emph{Array Mode:}}
*************** type = STRUCT (
*** 6914,6920 ****
@end smallexample
@end table
! @node Locations, Values and their Operations, How modes are displayed, Chill
@subsubsection Locations and their accesses
A location in Chill is an object which can contain values.
--- 6985,6991 ----
@end smallexample
@end table
! @node Locations
@subsubsection Locations and their accesses
A location in Chill is an object which can contain values.
*************** represents the address where the referen
*** 6942,6952 ****
value of the location referenced by the pointer, use the dereference
operator @samp{->}.
! Values of procedure mode locations are displayed by @code{@{ PROC
(<argument modes> ) <return mode> @} <address> <name of procedure
! location>}. @code{<argument modes>} is a list of modes according to the
! parameter specification of the procedure and @code{<address>} shows the
! address of the entry point.
@ignore
Locations of instance modes are displayed just like a structure with two
--- 7013,7027 ----
value of the location referenced by the pointer, use the dereference
operator @samp{->}.
! Values of procedure mode locations are displayed by
! @smallexample
! @code{@{ PROC
(<argument modes> ) <return mode> @} <address> <name of procedure
! location>}
! @end smallexample
! @code{<argument modes>} is a list of modes according to the parameter
! specification of the procedure and @code{<address>} shows the address of
! the entry point.
@ignore
Locations of instance modes are displayed just like a structure with two
*************** therefore the result can be quite confus
*** 6995,7001 ****
(@value{GDBP}) print int (s(3 up 4)) XXX TO be filled in !! XXX
@end smallexample
! @node Values and their Operations, Chill type and range checks, Locations, Chill
@subsubsection Values and their Operations
Values are used to alter locations, to investigate complex structures in
--- 7070,7076 ----
(@value{GDBP}) print int (s(3 up 4)) XXX TO be filled in !! XXX
@end smallexample
! @node Values and their Operations
@subsubsection Values and their Operations
Values are used to alter locations, to investigate complex structures in
*************** same manner as in Chill programs refer t
*** 7065,7071 ****
@end itemize
@item String Element Value
! A string element value is specified by @code{<string value>(<index>)},
where @code{<index>} is a integer expression. It delivers a character
value which is equivalent to the character indexed by @code{<index>} in
the string.
--- 7140,7149 ----
@end itemize
@item String Element Value
! A string element value is specified by
! @smallexample
! @code{<string value>(<index>)}
! @end smallexample
where @code{<index>} is a integer expression. It delivers a character
value which is equivalent to the character indexed by @code{<index>} in
the string.
*************** expression, then this procedure is calle
*** 7102,7109 ****
effects. This can lead to confusing results if used carelessly.}.
Values of duration mode locations are represented by @code{ULONG} literals.
- Values of time mode locations are represented by @code{TIME(<secs>:<nsecs>)}.
@ignore
This is not implemented yet:
--- 7180,7191 ----
effects. This can lead to confusing results if used carelessly.}.
Values of duration mode locations are represented by @code{ULONG} literals.
+
+ Values of time mode locations appear as
+ @smallexample
+ @code{TIME(<secs>:<nsecs>)}
+ @end smallexample
@ignore
This is not implemented yet:
*************** Membership operator.
*** 7198,7204 ****
@end table
@end table
! @node Chill type and range checks, Chill defaults, Values and their Operations, Chill
@subsubsection Chill type and range checks
@value{GDBN} considers two Chill variables mode equivalent if the sizes
--- 7280,7286 ----
@end table
@end table
! @node Chill type and range checks
@subsubsection Chill type and range checks
@value{GDBN} considers two Chill variables mode equivalent if the sizes
*************** off}.
*** 7224,7230 ****
see last paragraph ?
@end ignore
! @node Chill defaults, , Chill type and range checks, Chill
@subsubsection Chill defaults
If type and range checking are set automatically by @value{GDBN}, they
--- 7306,7312 ----
see last paragraph ?
@end ignore
! @node Chill defaults
@subsubsection Chill defaults
If type and range checking are set automatically by @value{GDBN}, they
*************** code compiled from a file whose name end
*** 7237,7243 ****
working language to Chill. @xref{Automatically, ,Having @value{GDBN} set
the language automatically}, for further details.
! @node Symbols, Altering, Languages, Top
@chapter Examining the Symbol Table
The commands described in this chapter allow you to inquire about the
--- 7319,7325 ----
working language to Chill. @xref{Automatically, ,Having @value{GDBN} set
the language automatically}, for further details.
! @node Symbols
@chapter Examining the Symbol Table
The commands described in this chapter allow you to inquire about the
*************** Replace symbol definitions for the corre
*** 7402,7413 ****
object file with a particular name is seen again.
@item set symbol-reloading off
! Do not replace symbol definitions when re-encountering object files of
! the same name. This is the default state; if you are not running on a
! system that permits automatically relinking modules, you should leave
! @code{symbol-reloading} off, since otherwise @value{GDBN} may discard symbols
! when linking large programs, that may contain several modules (from
! different directories or libraries) with the same name.
@kindex show symbol-reloading
@item show symbol-reloading
--- 7484,7496 ----
object file with a particular name is seen again.
@item set symbol-reloading off
! Do not replace symbol definitions when encountering object files of the
! same name more than once. This is the default state; if you are not
! running on a system that permits automatic relinking of modules, you
! should leave @code{symbol-reloading} off, since otherwise @value{GDBN}
! may discard symbols when linking large programs, that may contain
! several modules (from different directories or libraries) with the same
! name.
@kindex show symbol-reloading
@item show symbol-reloading
*************** required for each object file from which
*** 7459,7465 ****
@value{GDBN} reads symbols (in the description of @code{symbol-file}).
@end table
! @node Altering, GDB Files, Symbols, Top
@chapter Altering Execution
Once you think you have found an error in your program, you might want to
--- 7542,7548 ----
@value{GDBN} reads symbols (in the description of @code{symbol-file}).
@end table
! @node Altering
@chapter Altering Execution
Once you think you have found an error in your program, you might want to
*************** address, or even return prematurely from
*** 7481,7487 ****
* Patching:: Patching your program
@end menu
! @node Assignment, Jumping, Altering, Altering
@section Assignment to variables
@cindex assignment
--- 7564,7570 ----
* Patching:: Patching your program
@end menu
! @node Assignment
@section Assignment to variables
@cindex assignment
*************** $2 = 1
*** 7552,7558 ****
The program being debugged has been started already.
Start it from the beginning? (y or n) y
Starting program: /home/smith/cc_progs/a.out
! "/home/smith/cc_progs/a.out": can't open to read symbols: Invalid bfd target.
(@value{GDBP}) show g
The current BFD target is "=4".
@end group
--- 7635,7642 ----
The program being debugged has been started already.
Start it from the beginning? (y or n) y
Starting program: /home/smith/cc_progs/a.out
! "/home/smith/cc_progs/a.out": can't open to read symbols:
! Invalid bfd target.
(@value{GDBP}) show g
The current BFD target is "=4".
@end group
*************** set @{int@}0x83040 = 4
*** 7587,7593 ****
@noindent
stores the value 4 into that memory location.
! @node Jumping, Signaling, Assignment, Altering
@section Continuing at a different address
Ordinarily, when you continue your program, you do so at the place where
--- 7671,7677 ----
@noindent
stores the value 4 into that memory location.
! @node Jumping
@section Continuing at a different address
Ordinarily, when you continue your program, you do so at the place where
*************** that has already executed, in order to e
*** 7640,7646 ****
detail.
@c @group
! @node Signaling, Returning, Jumping, Altering
@section Giving your program a signal
@table @code
--- 7724,7730 ----
detail.
@c @group
! @node Signaling
@section Giving your program a signal
@table @code
*************** the signal handling tables (@pxref{Signa
*** 7669,7675 ****
passes the signal directly to your program.
! @node Returning, Calling, Signaling, Altering
@section Returning from a function
@table @code
--- 7753,7759 ----
passes the signal directly to your program.
! @node Returning
@section Returning from a function
@table @code
*************** returned. In contrast, the @code{finish
*** 7700,7706 ****
and Stepping, ,Continuing and stepping}) resumes execution until the
selected stack frame returns naturally.
! @node Calling, Patching, Returning, Altering
@section Calling program functions
@cindex calling functions
--- 7784,7790 ----
and Stepping, ,Continuing and stepping}) resumes execution until the
selected stack frame returns naturally.
! @node Calling
@section Calling program functions
@cindex calling functions
*************** calls a function in the target. This is
*** 7722,7728 ****
method of putting the scratch area on the stack does not work in systems
that have separate instruction and data spaces.
! @node Patching, , Calling, Altering
@section Patching programs
@cindex patching binaries
--- 7806,7812 ----
method of putting the scratch area on the stack does not work in systems
that have separate instruction and data spaces.
! @node Patching
@section Patching programs
@cindex patching binaries
*************** Display whether executable files and cor
*** 7757,7763 ****
as well as reading.
@end table
! @node GDB Files, Targets, Altering, Top
@chapter @value{GDBN} Files
@value{GDBN} needs to know the file name of the program to be debugged,
--- 7841,7847 ----
as well as reading.
@end table
! @node GDB Files
@chapter @value{GDBN} Files
@value{GDBN} needs to know the file name of the program to be debugged,
*************** program. To debug a core dump of a prev
*** 7770,7776 ****
* Symbol Errors:: Errors reading symbol files
@end menu
! @node Files, Symbol Errors, GDB Files, GDB Files
@section Commands to specify files
@cindex symbol table
--- 7854,7860 ----
* Symbol Errors:: Errors reading symbol files
@end menu
! @node Files
@section Commands to specify files
@cindex symbol table
*************** directories to search, just as the shell
*** 7799,7805 ****
to run. You can change the value of this variable, for both @value{GDBN}
and your program, using the @code{path} command.
! On systems with memory-mapped files, an auxiliary file
@file{@var{filename}.syms} may hold symbol table information for
@var{filename}. If so, @value{GDBN} maps in the symbol table from
@file{@var{filename}.syms}, starting up more quickly. See the
--- 7883,7889 ----
to run. You can change the value of this variable, for both @value{GDBN}
and your program, using the @code{path} command.
! On systems with memory-mapped files, an auxiliary file named
@file{@var{filename}.syms} may hold symbol table information for
@var{filename}. If so, @value{GDBN} maps in the symbol table from
@file{@var{filename}.syms}, starting up more quickly. See the
*************** Otherwise, symbols must be loaded manual
*** 8050,8056 ****
Display the current autoloading size threshold, in megabytes.
@end table
! @node Symbol Errors, , Files, GDB Files
@section Errors reading symbol files
While reading a symbol file, @value{GDBN} occasionally encounters problems,
--- 8134,8140 ----
Display the current autoloading size threshold, in megabytes.
@end table
! @node Symbol Errors
@section Errors reading symbol files
While reading a symbol file, @value{GDBN} occasionally encounters problems,
*************** it.
*** 8139,8145 ****
@end table
! @node Targets, Configurations, GDB Files, Top
@chapter Specifying a Debugging Target
@cindex debugging target
--- 8223,8229 ----
@end table
! @node Targets
@chapter Specifying a Debugging Target
@cindex debugging target
*************** command to specify one of the target typ
*** 8165,8171 ****
@end menu
! @node Active Targets, Target Commands, Targets, Targets
@section Active targets
@cindex stacking targets
--- 8249,8255 ----
@end menu
! @node Active Targets
@section Active targets
@cindex stacking targets
*************** files}). To specify as a target a proce
*** 8200,8206 ****
the @code{attach} command (@pxref{Attach, ,Debugging an already-running
process}).
! @node Target Commands, Byte Order, Active Targets, Targets
@section Commands for managing targets
@table @code
--- 8284,8290 ----
the @code{attach} command (@pxref{Attach, ,Debugging an already-running
process}).
! @node Target Commands
@section Commands for managing targets
@table @code
*************** specifies a fixed address.
*** 8332,8338 ****
@code{load} does not repeat if you press @key{RET} again after using it.
@end table
! @node Byte Order, Remote, Target Commands, Targets
@section Choosing target byte order
@cindex choosing target byte order
--- 8416,8422 ----
@code{load} does not repeat if you press @key{RET} again after using it.
@end table
! @node Byte Order
@section Choosing target byte order
@cindex choosing target byte order
*************** Note that these commands merely adjust i
*** 8372,8378 ****
data on the host, and that they have absolutely no effect on the
target system.
! @node Remote, KOD, Byte Order, Targets
@section Remote debugging
@cindex remote debugging
--- 8456,8462 ----
data on the host, and that they have absolutely no effect on the
target system.
! @node Remote
@section Remote debugging
@cindex remote debugging
*************** configuration of @value{GDBN}; use @code
*** 8396,8402 ****
* Remote Serial:: @value{GDBN} remote serial protocol
@end menu
! @node Remote Serial, , Remote, Remote
@subsection The @value{GDBN} remote serial protocol
@cindex remote serial debugging, overview
--- 8480,8486 ----
* Remote Serial:: @value{GDBN} remote serial protocol
@end menu
! @node Remote Serial
@subsection The @value{GDBN} remote serial protocol
@cindex remote serial debugging, overview
*************** recently added stubs.
*** 8494,8500 ****
* NetWare:: Using the `gdbserve.nlm' program
@end menu
! @node Stub Contents, Bootstrapping, Remote Serial, Remote Serial
@subsubsection What the stub can do for you
@cindex remote serial stub
--- 8578,8584 ----
* NetWare:: Using the `gdbserve.nlm' program
@end menu
! @node Stub Contents
@subsubsection What the stub can do for you
@cindex remote serial stub
*************** to make certain your program stops at a
*** 8545,8551 ****
start of your debugging session.
@end table
! @node Bootstrapping, Debug Session, Stub Contents, Remote Serial
@subsubsection What you must do for the stub
@cindex remote stub, support routines
--- 8629,8635 ----
start of your debugging session.
@end table
! @node Bootstrapping
@subsubsection What you must do for the stub
@cindex remote stub, support routines
*************** but in general the stubs are likely to u
*** 8636,8642 ****
subroutines which @code{@value{GCC}} generates as inline code.
! @node Debug Session, Protocol, Bootstrapping, Remote Serial
@subsubsection Putting it all together
@cindex remote serial debugging summary
--- 8720,8726 ----
subroutines which @code{@value{GCC}} generates as inline code.
! @node Debug Session
@subsubsection Putting it all together
@cindex remote serial debugging summary
*************** steps.
*** 8645,8651 ****
@enumerate
@item
! Make sure you have the supporting low-level routines
(@pxref{Bootstrapping,,What you must do for the stub}):
@display
@code{getDebugChar}, @code{putDebugChar},
--- 8729,8735 ----
@enumerate
@item
! Make sure you have defined the supporting low-level routines
(@pxref{Bootstrapping,,What you must do for the stub}):
@display
@code{getDebugChar}, @code{putDebugChar},
*************** If you type @kbd{y}, @value{GDBN} abando
*** 8742,8748 ****
remote} again to connect once more.) If you type @kbd{n}, @value{GDBN}
goes back to waiting.
! @node Protocol, Server, Debug Session, Remote Serial
@subsubsection Communication protocol
@cindex debugging stub, example
--- 8826,8832 ----
remote} again to connect once more.) If you type @kbd{n}, @value{GDBN}
goes back to waiting.
! @node Protocol
@subsubsection Communication protocol
@cindex debugging stub, example
*************** bytes. For a software breakpoint, @var{
*** 9264,9270 ****
the instruction to be patched. For hardware breakpoints and watchpoints
@var{length} specifies the memory region to be monitored. To avoid
potential problems with duplicate packets, the operations should be
! implemented in an ident-potentent way.
@item
@tab reply @code{E}@var{NN}
@tab for an error
--- 9348,9354 ----
the instruction to be patched. For hardware breakpoints and watchpoints
@var{length} specifies the memory region to be monitored. To avoid
potential problems with duplicate packets, the operations should be
! implemented in an idempotent way.
@item
@tab reply @code{E}@var{NN}
@tab for an error
*************** applicable for certains sorts of targets
*** 9312,9325 ****
@tab
The process terminated with signal @var{AA}.
! @item @code{N}@var{AA}@code{;}@var{tttttttt}@code{;}@var{dddddddd}@code{;}@var{bbbbbbbb} @strong{(obsolete)}
@tab
! @var{AA} = signal number; @var{tttttttt} = address of symbol "_start";
! @var{dddddddd} = base of data section; @var{bbbbbbbb} = base of bss
! section. @emph{Note: only used by Cisco Systems targets. The difference
! between this reply and the "qOffsets" query is that the 'N' packet may
! arrive spontaneously whereas the 'qOffsets' is a query initiated by the
! host debugger.}
@item @code{O}@var{XX...}
@tab
--- 9396,9409 ----
@tab
The process terminated with signal @var{AA}.
! @item @code{N}@var{AA}@code{;}@var{t...}@code{;}@var{d...}@code{;}@var{b...} @strong{(obsolete)}
@tab
! @var{AA} = signal number; @var{t...} = address of symbol "_start";
! @var{d...} = base of data section; @var{b...} = base of bss section.
! @emph{Note: only used by Cisco Systems targets. The difference between
! this reply and the "qOffsets" query is that the 'N' packet may arrive
! spontaneously whereas the 'qOffsets' is a query initiated by the host
! debugger.}
@item @code{O}@var{XX...}
@tab
*************** Example sequence of a target being stepp
*** 9536,9542 ****
<- @code{+}
@end example
! @node Server, NetWare, Protocol, Remote Serial
@subsubsection Using the @code{gdbserver} program
@kindex gdbserver
--- 9620,9626 ----
<- @code{+}
@end example
! @node Server
@subsubsection Using the @code{gdbserver} program
@kindex gdbserver
*************** text depends on the host system, but whi
*** 9638,9644 ****
@samp{Connection refused}.
@end table
! @node NetWare, , Server, Remote Serial
@subsubsection Using the @code{gdbserve.nlm} program
@kindex gdbserve.nlm
--- 9722,9728 ----
@samp{Connection refused}.
@end table
! @node NetWare
@subsubsection Using the @code{gdbserve.nlm} program
@kindex gdbserve.nlm
*************** argument is a device name (usually a ser
*** 9695,9701 ****
communications with the server via serial line @file{/dev/ttyb}.
@end table
! @node KOD, , Remote, Targets
@section Kernel Object Display
@cindex kernel object display
--- 9779,9785 ----
communications with the server via serial line @file{/dev/ttyb}.
@end table
! @node KOD
@section Kernel Object Display
@cindex kernel object display
*************** There is currently no way to determine w
*** 9734,9740 ****
is supported other than to try it.
! @node Configurations, Controlling GDB, Targets, Top
@chapter Configuration-Specific Information
While nearly all @value{GDBN} commands are available for all native and
--- 9818,9824 ----
is supported other than to try it.
! @node Configurations
@chapter Configuration-Specific Information
While nearly all @value{GDBN} commands are available for all native and
*************** are quite different from each other.
*** 9754,9760 ****
* Architectures::
@end menu
! @node Native, Embedded OS, Configurations, Configurations
@section Native
This section describes details specific to particular native
--- 9838,9844 ----
* Architectures::
@end menu
! @node Native
@section Native
This section describes details specific to particular native
*************** configurations.
*** 9765,9778 ****
* SVR4 Process Information:: SVR4 process information
@end menu
! @node HP-UX, SVR4 Process Information, Native, Native
@subsection HP-UX
On HP-UX systems, if you refer to a function or variable name that
begins with a dollar sign, @value{GDBN} searches for a user or system
name first, before it searches for a convenience variable.
! @node SVR4 Process Information, , HP-UX, Native
@subsection SVR4 process information
@kindex /proc
--- 9849,9862 ----
* SVR4 Process Information:: SVR4 process information
@end menu
! @node HP-UX
@subsection HP-UX
On HP-UX systems, if you refer to a function or variable name that
begins with a dollar sign, @value{GDBN} searches for a user or system
name first, before it searches for a convenience variable.
! @node SVR4 Process Information
@subsection SVR4 process information
@kindex /proc
*************** received.
*** 9817,9823 ****
Show all the above information about the process.
@end table
! @node Embedded OS, Embedded Processors, Native, Configurations
@section Embedded Operating Systems
This section describes configurations involving the debugging of
--- 9901,9907 ----
Show all the above information about the process.
@end table
! @node Embedded OS
@section Embedded Operating Systems
This section describes configurations involving the debugging of
*************** architectures.
*** 9831,9837 ****
@value{GDBN} includes the ability to debug programs running on
various real-time operating systems.
! @node VxWorks, , Embedded OS, Embedded OS
@subsection Using @value{GDBN} with VxWorks
@cindex VxWorks
--- 9915,9921 ----
@value{GDBN} includes the ability to debug programs running on
various real-time operating systems.
! @node VxWorks
@subsection Using @value{GDBN} with VxWorks
@cindex VxWorks
*************** run @value{GDBN}. From your Unix host,
*** 9898,9904 ****
* VxWorks Attach:: Running tasks
@end menu
! @node VxWorks Connection, VxWorks Download, VxWorks, VxWorks
@subsubsection Connecting to VxWorks
The @value{GDBN} command @code{target} lets you connect to a VxWorks target on the
--- 9982,9988 ----
* VxWorks Attach:: Running tasks
@end menu
! @node VxWorks Connection
@subsubsection Connecting to VxWorks
The @value{GDBN} command @code{target} lets you connect to a VxWorks target on the
*************** When this happens, add the appropriate d
*** 9931,9937 ****
the @value{GDBN} command @code{path}, and execute the @code{target}
command again.
! @node VxWorks Download, VxWorks Attach, VxWorks Connection, VxWorks
@subsubsection VxWorks download
@cindex download to VxWorks
--- 10015,10021 ----
the @value{GDBN} command @code{path}, and execute the @code{target}
command again.
! @node VxWorks Download
@subsubsection VxWorks download
@cindex download to VxWorks
*************** history. (This is necessary in order to
*** 9977,9983 ****
debugger's data structures that reference the target system's symbol
table.)
! @node VxWorks Attach, , VxWorks Download, VxWorks
@subsubsection Running tasks
@cindex running VxWorks tasks
--- 10061,10067 ----
debugger's data structures that reference the target system's symbol
table.)
! @node VxWorks Attach
@subsubsection Running tasks
@cindex running VxWorks tasks
*************** where @var{task} is the VxWorks hexadeci
*** 9993,9999 ****
or suspended when you attach to it. Running tasks are suspended at
the time of attachment.
! @node Embedded Processors, Architectures, Embedded OS, Configurations
@section Embedded Processors
This section goes into details specific to particular embedded
--- 10077,10083 ----
or suspended when you attach to it. Running tasks are suspended at
the time of attachment.
! @node Embedded Processors
@section Embedded Processors
This section goes into details specific to particular embedded
*************** configurations.
*** 10018,10024 ****
* Z8000:: Zilog Z8000
@end menu
! @node A29K Embedded, ARM, Embedded Processors, Embedded Processors
@subsection AMD A29K Embedded
@menu
--- 10102,10108 ----
* Z8000:: Zilog Z8000
@end menu
! @node A29K Embedded
@subsection AMD A29K Embedded
@menu
*************** name of the program to be debugged, as i
*** 10046,10052 ****
@end table
! @node A29K UDI, A29K EB29K, A29K Embedded, A29K Embedded
@subsubsection A29K UDI
@cindex UDI
--- 10130,10136 ----
@end table
! @node A29K UDI
@subsubsection A29K UDI
@cindex UDI
*************** working directory, you must set the envi
*** 10070,10076 ****
to its pathname.
@end table
! @node A29K EB29K, Comms (EB29K), A29K UDI, A29K Embedded
@subsubsection EBMON protocol for AMD29K
@cindex EB29K board
--- 10154,10160 ----
to its pathname.
@end table
! @node A29K EB29K
@subsubsection EBMON protocol for AMD29K
@cindex EB29K board
*************** board) and a serial port on the Unix sys
*** 10085,10091 ****
assume you've hooked the cable between the PC's @file{COM1} port and
@file{/dev/ttya} on the Unix system.
! @node Comms (EB29K), gdb-EB29K, A29K EB29K, A29K Embedded
@subsubsection Communications setup
The next step is to set up the PC's port, by doing something like this
--- 10169,10175 ----
assume you've hooked the cable between the PC's @file{COM1} port and
@file{/dev/ttya} on the Unix system.
! @node Comms (EB29K)
@subsubsection Communications setup
The next step is to set up the PC's port, by doing something like this
*************** other way---perhaps floppy-disk transfer
*** 10207,10213 ****
from the Unix system to the PC; @value{GDBN} does @emph{not} download it over the
serial line.
! @node gdb-EB29K, Remote Log, Comms (EB29K), A29K Embedded
@subsubsection EB29K cross-debugging
Finally, @code{cd} to the directory containing an image of your 29K
--- 10291,10297 ----
from the Unix system to the PC; @value{GDBN} does @emph{not} download it over the
serial line.
! @node gdb-EB29K
@subsubsection EB29K cross-debugging
Finally, @code{cd} to the directory containing an image of your 29K
*************** once again, after your @value{GDBN} sess
*** 10251,10257 ****
Type @kbd{CTTY con} to return command input to the main DOS console,
and type @kbd{~.} to leave @code{tip} or @code{cu}.
! @node Remote Log, , gdb-EB29K, A29K Embedded
@subsubsection Remote log
@kindex eb.log
@cindex log file for EB29K
--- 10335,10341 ----
Type @kbd{CTTY con} to return command input to the main DOS console,
and type @kbd{~.} to leave @code{tip} or @code{cu}.
! @node Remote Log
@subsubsection Remote log
@kindex eb.log
@cindex log file for EB29K
*************** of the commands sent to it. Running @sa
*** 10263,10269 ****
another window often helps to understand trouble with @code{EBMON}, or
unexpected events on the PC side of the connection.
! @node ARM, H8/300, A29K Embedded, Embedded Processors
@subsection ARM
@table @code
--- 10347,10353 ----
another window often helps to understand trouble with @code{EBMON}, or
unexpected events on the PC side of the connection.
! @node ARM
@subsection ARM
@table @code
*************** ARM Demon monitor.
*** 10280,10286 ****
@end table
! @node H8/300, H8/500, ARM, Embedded Processors
@subsection Hitachi H8/300
@table @code
--- 10364,10370 ----
@end table
! @node H8/300
@subsection Hitachi H8/300
@table @code
*************** what speed to use over the serial device
*** 10337,10343 ****
* Hitachi Special:: Special @value{GDBN} commands for Hitachi micros.
@end menu
! @node Hitachi Boards, Hitachi ICE, H8/300, H8/300
@subsubsection Connecting to Hitachi boards
@c only for Unix hosts
--- 10421,10427 ----
* Hitachi Special:: Special @value{GDBN} commands for Hitachi micros.
@end menu
! @node Hitachi Boards
@subsubsection Connecting to Hitachi boards
@c only for Unix hosts
*************** to detect program completion.
*** 10450,10456 ****
In either case, @value{GDBN} sees the effect of a @sc{reset} on the
development board as a ``normal exit'' of your program.
! @node Hitachi ICE, Hitachi Special, Hitachi Boards, H8/300
@subsubsection Using the E7000 in-circuit emulator
@kindex target e7000@r{, with Hitachi ICE}
--- 10534,10540 ----
In either case, @value{GDBN} sees the effect of a @sc{reset} on the
development board as a ``normal exit'' of your program.
! @node Hitachi ICE
@subsubsection Using the E7000 in-circuit emulator
@kindex target e7000@r{, with Hitachi ICE}
*************** If your E7000 is installed as a host on
*** 10470,10476 ****
specify its hostname; @value{GDBN} uses @code{telnet} to connect.
@end table
! @node Hitachi Special, , Hitachi ICE, H8/300
@subsubsection Special @value{GDBN} commands for Hitachi micros
Some @value{GDBN} commands are available only for the H8/300:
--- 10554,10560 ----
specify its hostname; @value{GDBN} uses @code{telnet} to connect.
@end table
! @node Hitachi Special
@subsubsection Special @value{GDBN} commands for Hitachi micros
Some @value{GDBN} commands are available only for the H8/300:
*************** to check which variant is currently in e
*** 10487,10493 ****
@end table
! @node H8/500, i960, H8/300, Embedded Processors
@subsection H8/500
@table @code
--- 10571,10577 ----
@end table
! @node H8/500
@subsection H8/500
@table @code
*************** memory}. The accepted values for @var{m
*** 10503,10509 ****
@end table
! @node i960, M32R/D, H8/500, Embedded Processors
@subsection Intel i960
@table @code
--- 10587,10593 ----
@end table
! @node i960
@subsection Intel i960
@table @code
*************** downloads @var{filename} to the 960 as w
*** 10556,10562 ****
* Nindy Reset:: Nindy reset command
@end menu
! @node Nindy Startup, Nindy Options, i960, i960
@subsubsection Startup with Nindy
If you simply start @code{@value{GDBP}} without using any command-line
--- 10640,10646 ----
* Nindy Reset:: Nindy reset command
@end menu
! @node Nindy Startup
@subsubsection Startup with Nindy
If you simply start @code{@value{GDBP}} without using any command-line
*************** simply start up with no Nindy connection
*** 10574,10580 ****
with an empty line. If you do this and later wish to attach to Nindy,
use @code{target} (@pxref{Target Commands, ,Commands for managing targets}).
! @node Nindy Options, Nindy Reset, Nindy Startup, i960
@subsubsection Options for Nindy
These are the startup options for beginning your @value{GDBN} session with a
--- 10658,10664 ----
with an empty line. If you do this and later wish to attach to Nindy,
use @code{target} (@pxref{Target Commands, ,Commands for managing targets}).
! @node Nindy Options
@subsubsection Options for Nindy
These are the startup options for beginning your @value{GDBN} session with a
*************** The standard @samp{-b} option controls t
*** 10617,10623 ****
port.
@c @group
! @node Nindy Reset, , Nindy Options, i960
@subsubsection Nindy reset command
@table @code
--- 10701,10707 ----
port.
@c @group
! @node Nindy Reset
@subsubsection Nindy reset command
@table @code
*************** a break is detected.
*** 10630,10636 ****
@end table
@c @end group
! @node M32R/D, M68K, i960, Embedded Processors
@subsection Mitsubishi M32R/D
@table @code
--- 10714,10720 ----
@end table
@c @end group
! @node M32R/D
@subsection Mitsubishi M32R/D
@table @code
*************** Mitsubishi M32R/D ROM monitor.
*** 10641,10647 ****
@end table
! @node M68K, M88K, M32R/D, Embedded Processors
@subsection M68k
The Motorola m68k configuration includes ColdFire support, and
--- 10725,10731 ----
@end table
! @node M68K
@subsection M68k
The Motorola m68k configuration includes ColdFire support, and
*************** ROMBUG ROM monitor for OS/9000.
*** 10692,10698 ****
@end table
! @node M88K, MIPS Embedded, M68K, Embedded Processors
@subsection M88K
@table @code
--- 10776,10782 ----
@end table
! @node M88K
@subsection M88K
@table @code
*************** BUG monitor, running on a MVME187 (m88k)
*** 10703,10709 ****
@end table
! @node MIPS Embedded, PowerPC, M88K, Embedded Processors
@subsection MIPS Embedded
@cindex MIPS boards
--- 10787,10793 ----
@end table
! @node MIPS Embedded
@subsection MIPS Embedded
@cindex MIPS boards
*************** forever because it has no way of knowing
*** 10847,10853 ****
to run before stopping.
@end table
! @node PowerPC, PA, MIPS Embedded, Embedded Processors
@subsection PowerPC
@table @code
--- 10931,10937 ----
to run before stopping.
@end table
! @node PowerPC
@subsection PowerPC
@table @code
*************** SDS monitor, running on a PowerPC board
*** 10868,10874 ****
@end table
! @node PA, SH, PowerPC, Embedded Processors
@subsection HP PA Embedded
@table @code
--- 10952,10958 ----
@end table
! @node PA
@subsection HP PA Embedded
@table @code
*************** W89K monitor, running on a Winbond HPPA
*** 10883,10889 ****
@end table
! @node SH, Sparclet, PA, Embedded Processors
@subsection Hitachi SH
@table @code
--- 10967,10973 ----
@end table
! @node SH
@subsection Hitachi SH
@table @code
*************** Hitachi SH-3 and SH-3E target systems.
*** 10906,10912 ****
@end table
! @node Sparclet, Sparclite, SH, Embedded Processors
@subsection Tsqware Sparclet
@cindex Sparclet
--- 10990,10996 ----
@end table
! @node Sparclet
@subsection Tsqware Sparclet
@cindex Sparclet
*************** run @value{GDBN}. From your Unix host,
*** 10960,10966 ****
* Sparclet Execution:: Running and debugging
@end menu
! @node Sparclet File, Sparclet Connection, Sparclet, Sparclet
@subsubsection Setting file to debug
The @value{GDBN} command @code{file} lets you choose with program to debug.
--- 11044,11050 ----
* Sparclet Execution:: Running and debugging
@end menu
! @node Sparclet File
@subsubsection Setting file to debug
The @value{GDBN} command @code{file} lets you choose with program to debug.
*************** When this happens, add the appropriate d
*** 10990,10996 ****
the @value{GDBN} commands @code{path} and @code{dir}, and execute the
@code{target} command again.
! @node Sparclet Connection, Sparclet Download, Sparclet File, Sparclet
@subsubsection Connecting to Sparclet
The @value{GDBN} command @code{target} lets you connect to a Sparclet target.
--- 11074,11080 ----
the @value{GDBN} commands @code{path} and @code{dir}, and execute the
@code{target} command again.
! @node Sparclet Connection
@subsubsection Connecting to Sparclet
The @value{GDBN} command @code{target} lets you connect to a Sparclet target.
*************** main () at ../prog.c:3
*** 11009,11015 ****
Connected to ttya.
@end example
! @node Sparclet Download, Sparclet Execution, Sparclet Connection, Sparclet
@subsubsection Sparclet download
@cindex download to Sparclet
--- 11093,11099 ----
Connected to ttya.
@end example
! @node Sparclet Download
@subsubsection Sparclet download
@cindex download to Sparclet
*************** If the code is loaded at a different add
*** 11035,11041 ****
to, you may need to use the @code{section} and @code{add-symbol-file} commands
to tell @value{GDBN} where to map the symbol table.
! @node Sparclet Execution, , Sparclet Download, Sparclet
@subsubsection Running and debugging
@cindex running and debugging Sparclet programs
--- 11119,11125 ----
to, you may need to use the @code{section} and @code{add-symbol-file} commands
to tell @value{GDBN} where to map the symbol table.
! @node Sparclet Execution
@subsubsection Running and debugging
@cindex running and debugging Sparclet programs
*************** Breakpoint 1, main (argc=1, argv=0xeffff
*** 11055,11061 ****
(gdbslet)
@end example
! @node Sparclite, ST2000, Sparclet, Embedded Processors
@subsection Fujitsu Sparclite
@table @code
--- 11139,11145 ----
(gdbslet)
@end example
! @node Sparclite
@subsection Fujitsu Sparclite
@table @code
*************** remote protocol.
*** 11069,11075 ****
@end table
! @node ST2000, Z8000, Sparclite, Embedded Processors
@subsection Tandem ST2000
@value{GDBN} may be used with a Tandem ST2000 phone switch, running Tandem's
--- 11153,11159 ----
@end table
! @node ST2000
@subsection Tandem ST2000
@value{GDBN} may be used with a Tandem ST2000 phone switch, running Tandem's
*************** sequences gets you back to the @value{GD
*** 11118,11124 ****
@kbd{@key{RET}~@key{C-d}} (Return, followed by tilde and control-D).
@end table
! @node Z8000, , ST2000, Embedded Processors
@subsection Zilog Z8000
@cindex Z8000
--- 11202,11208 ----
@kbd{@key{RET}~@key{C-d}} (Return, followed by tilde and control-D).
@end table
! @node Z8000
@subsection Zilog Z8000
@cindex Z8000
*************** conventions; for example, @w{@samp{b fpu
*** 11169,11175 ****
conditional breakpoint that suspends only after at least 5000
simulated clock ticks.
! @node Architectures, , Embedded Processors, Configurations
@section Architectures
This section describes characteristics of architectures that affect
--- 11253,11259 ----
conditional breakpoint that suspends only after at least 5000
simulated clock ticks.
! @node Architectures
@section Architectures
This section describes characteristics of architectures that affect
*************** all uses of @value{GDBN} with the archit
*** 11181,11187 ****
* MIPS::
@end menu
! @node A29K, Alpha, Architectures, Architectures
@subsection A29K
@table @code
--- 11265,11271 ----
* MIPS::
@end menu
! @node A29K
@subsection A29K
@table @code
*************** processors.
*** 11207,11218 ****
@end table
! @node Alpha, MIPS, A29K, Architectures
@subsection Alpha
See the following section.
! @node MIPS, , Alpha, Architectures
@subsection MIPS
@cindex stack on Alpha
--- 11291,11302 ----
@end table
! @node Alpha
@subsection Alpha
See the following section.
! @node MIPS
@subsection MIPS
@cindex stack on Alpha
*************** These commands are available @emph{only}
*** 11247,11253 ****
for debugging programs on Alpha or MIPS processors.
! @node Controlling GDB, Sequences, Configurations, Top
@chapter Controlling @value{GDBN}
You can alter the way @value{GDBN} interacts with you by using the
--- 11331,11337 ----
for debugging programs on Alpha or MIPS processors.
! @node Controlling GDB
@chapter Controlling @value{GDBN}
You can alter the way @value{GDBN} interacts with you by using the
*************** described here.
*** 11265,11271 ****
* Debugging Output:: Optional messages about internal happenings
@end menu
! @node Prompt, Editing, Controlling GDB, Controlling GDB
@section Prompt
@cindex prompt
--- 11349,11355 ----
* Debugging Output:: Optional messages about internal happenings
@end menu
! @node Prompt
@section Prompt
@cindex prompt
*************** Directs @value{GDBN} to use @var{newprom
*** 11291,11297 ****
Prints a line of the form: @samp{Gdb's prompt is: @var{your-prompt}}
@end table
! @node Editing, History, Prompt, Controlling GDB
@section Command editing
@cindex readline
@cindex command line editing
--- 11375,11381 ----
Prints a line of the form: @samp{Gdb's prompt is: @var{your-prompt}}
@end table
! @node Editing
@section Command editing
@cindex readline
@cindex command line editing
*************** Disable command line editing.
*** 11321,11327 ****
Show whether command line editing is enabled.
@end table
! @node History, Screen Size, Editing, Controlling GDB
@section Command history
@value{GDBN} can keep track of the commands you type during your
--- 11405,11411 ----
Show whether command line editing is enabled.
@end table
! @node History
@section Command history
@value{GDBN} can keep track of the commands you type during your
*************** Print ten commands centered on command n
*** 11418,11424 ****
Print ten commands just after the commands last printed.
@end table
! @node Screen Size, Numbers, History, Controlling GDB
@section Screen size
@cindex size of screen
@cindex pauses in output
--- 11502,11508 ----
Print ten commands just after the commands last printed.
@end table
! @node Screen Size
@section Screen size
@cindex size of screen
@cindex pauses in output
*************** Likewise, you can specify @samp{set widt
*** 11460,11466 ****
from wrapping its output.
@end table
! @node Numbers, Messages/Warnings, Screen Size, Controlling GDB
@section Numbers
@cindex number representation
@cindex entering numbers
--- 11544,11550 ----
from wrapping its output.
@end table
! @node Numbers
@section Numbers
@cindex number representation
@cindex entering numbers
*************** Display the current default base for num
*** 11507,11513 ****
Display the current default base for numeric display.
@end table
! @node Messages/Warnings, Debugging Output , Numbers, Controlling GDB
@section Optional warnings and messages
By default, @value{GDBN} is silent about its inner workings. If you are
--- 11591,11597 ----
Display the current default base for numeric display.
@end table
! @node Messages/Warnings
@section Optional warnings and messages
By default, @value{GDBN} is silent about its inner workings. If you are
*************** Displays state of confirmation requests.
*** 11583,11589 ****
@end table
! @node Debugging Output, ,Messages/Warnings, Controlling GDB
@section Optional messages about internal happenings
@table @code
@kindex set debug arch
--- 11667,11673 ----
@end table
! @node Debugging Output
@section Optional messages about internal happenings
@table @code
@kindex set debug arch
*************** Displays the current state of displaying
*** 11654,11660 ****
debugging info.
@end table
! @node Sequences, Emacs, Controlling GDB, Top
@chapter Canned Sequences of Commands
Aside from breakpoint commands (@pxref{Break Commands, ,Breakpoint
--- 11738,11744 ----
debugging info.
@end table
! @node Sequences
@chapter Canned Sequences of Commands
Aside from breakpoint commands (@pxref{Break Commands, ,Breakpoint
*************** files.
*** 11669,11675 ****
* Output:: Commands for controlled output
@end menu
! @node Define, Hooks, Sequences, Sequences
@section User-defined commands
@cindex user-defined command
--- 11753,11759 ----
* Output:: Commands for controlled output
@end menu
! @node Define
@section User-defined commands
@cindex user-defined command
*************** without asking when used inside a user-d
*** 11762,11768 ****
commands that normally print messages to say what they are doing omit the
messages when used in a user-defined command.
! @node Hooks, Command Files, Define, Sequences
@section User-defined command hooks
@cindex command hooks
@cindex hooks, for commands
--- 11846,11852 ----
commands that normally print messages to say what they are doing omit the
messages when used in a user-defined command.
! @node Hooks
@section User-defined command hooks
@cindex command hooks
@cindex hooks, for commands
*************** If an error occurs during the execution
*** 11808,11814 ****
If you try to define a hook which does not match any known command, you
get a warning from the @code{define} command.
! @node Command Files, Output, Hooks, Sequences
@section Command files
@cindex command files
--- 11892,11898 ----
If you try to define a hook which does not match any known command, you
get a warning from the @code{define} command.
! @node Command Files
@section Command files
@cindex command files
*************** without asking when used in a command fi
*** 11871,11877 ****
normally print messages to say what they are doing omit the messages
when called from command files.
! @node Output, , Command Files, Sequences
@section Commands for controlled output
During the execution of a command file or a user-defined command, normal
--- 11955,11961 ----
normally print messages to say what they are doing omit the messages
when called from command files.
! @node Output
@section Commands for controlled output
During the execution of a command file or a user-defined command, normal
*************** string are the simple ones that consist
*** 11951,11957 ****
letter.
@end table
! @node Emacs, Annotations, Sequences, Top
@chapter Using @value{GDBN} under @sc{gnu} Emacs
@cindex Emacs
--- 12035,12041 ----
letter.
@end table
! @node Emacs
@chapter Using @value{GDBN} under @sc{gnu} Emacs
@cindex Emacs
*************** environment. Users of this environment
*** 12125,12135 ****
each value is printed in its own window.
@end ignore
! @node Annotations, GDB Bugs, Emacs, Top
@chapter @value{GDBN} Annotations
@include annotate.texi
! @node GDB Bugs, Command Line Editing, Annotations, Top
@chapter Reporting Bugs in @value{GDBN}
@cindex bugs in @value{GDBN}
@cindex reporting bugs in @value{GDBN}
--- 12209,12219 ----
each value is printed in its own window.
@end ignore
! @node Annotations
@chapter @value{GDBN} Annotations
@include annotate.texi
! @node GDB Bugs
@chapter Reporting Bugs in @value{GDBN}
@cindex bugs in @value{GDBN}
@cindex reporting bugs in @value{GDBN}
*************** information that enables us to fix the b
*** 12149,12155 ****
* Bug Reporting:: How to report bugs
@end menu
! @node Bug Criteria, Bug Reporting, GDB Bugs, GDB Bugs
@section Have you found a bug?
@cindex bug criteria
--- 12233,12239 ----
* Bug Reporting:: How to report bugs
@end menu
! @node Bug Criteria
@section Have you found a bug?
@cindex bug criteria
*************** If you are an experienced user of debugg
*** 12181,12187 ****
for improvement of @value{GDBN} are welcome in any case.
@end itemize
! @node Bug Reporting, , Bug Criteria, GDB Bugs
@section How to report bugs
@cindex bug reports
@cindex @value{GDBN} bugs, reporting
--- 12265,12271 ----
for improvement of @value{GDBN} are welcome in any case.
@end itemize
! @node Bug Reporting
@section How to report bugs
@cindex bug reports
@cindex @value{GDBN} bugs, reporting
*************** things without first using the debugger
*** 12371,12387 ****
@c Use -I with makeinfo to point to the appropriate directory,
@c environment var TEXINPUTS with TeX.
! @node Command Line Editing, Using History Interactively, GDB Bugs, Top
@chapter Command Line Editing
@include rluser.texinfo
! @node Using History Interactively, Formatting Documentation, Command Line Editing, Top
@chapter Using History Interactively
@include inc-hist.texinfo
! @node Formatting Documentation, Installing GDB, Using History Interactively, Top
@appendix Formatting Documentation
@cindex @value{GDBN} reference card
--- 12455,12471 ----
@c Use -I with makeinfo to point to the appropriate directory,
@c environment var TEXINPUTS with TeX.
! @node Command Line Editing
@chapter Command Line Editing
@include rluser.texinfo
! @node Using History Interactively
@chapter Using History Interactively
@include inc-hist.texinfo
! @node Formatting Documentation
@appendix Formatting Documentation
@cindex @value{GDBN} reference card
*************** make gdb.dvi
*** 12467,12473 ****
Then give @file{gdb.dvi} to your @sc{dvi} printing program.
! @node Installing GDB, Index, Formatting Documentation, Top
@appendix Installing @value{GDBN}
@cindex configuring @value{GDBN}
@cindex installation
--- 12551,12557 ----
Then give @file{gdb.dvi} to your @sc{dvi} printing program.
! @node Installing GDB
@appendix Installing @value{GDBN}
@cindex configuring @value{GDBN}
@cindex installation
*************** let @value{GDBN} debug child processes w
*** 12587,12593 ****
* Configure Options:: Summary of options for configure
@end menu
! @node Separate Objdir, Config Names, Installing GDB, Installing GDB
@section Compiling @value{GDBN} in another directory
If you want to run @value{GDBN} versions for several host or target machines,
--- 12671,12677 ----
* Configure Options:: Summary of options for configure
@end menu
! @node Separate Objdir
@section Compiling @value{GDBN} in another directory
If you want to run @value{GDBN} versions for several host or target machines,
*************** directories, you can run @code{make} on
*** 12648,12654 ****
if they are NFS-mounted on each of the hosts); they will not interfere
with each other.
! @node Config Names, Configure Options, Separate Objdir, Installing GDB
@section Specifying names for hosts and targets
The specifications used for hosts and targets in the @code{configure}
--- 12732,12738 ----
if they are NFS-mounted on each of the hosts); they will not interfere
with each other.
! @node Config Names
@section Specifying names for hosts and targets
The specifications used for hosts and targets in the @code{configure}
*************** Invalid configuration `i986v': machine `
*** 12690,12696 ****
@code{config.sub} is also distributed in the @value{GDBN} source
directory (@file{gdb-@value{GDBVN}}, for version @value{GDBVN}).
! @node Configure Options, , Config Names, Installing GDB
@section @code{configure} options
Here is a summary of the @code{configure} options and arguments that
--- 12774,12780 ----
@code{config.sub} is also distributed in the @value{GDBN} source
directory (@file{gdb-@value{GDBVN}}, for version @value{GDBVN}).
! @node Configure Options
@section @code{configure} options
Here is a summary of the @code{configure} options and arguments that
*************** There is no convenient way to generate a
*** 12759,12765 ****
There are many other options available as well, but they are generally
needed for special purposes only.
! @node Index, , Installing GDB, Top
@unnumbered Index
@printindex cp
--- 12843,12849 ----
There are many other options available as well, but they are generally
needed for special purposes only.
! @node Index
@unnumbered Index
@printindex cp