This is the mail archive of the
gdb-patches@sourceware.cygnus.com
mailing list for the GDB project.
Re: [PATCH] Fix texinfo problems...
Eli Zaretskii wrote:
>
> > *Please* don't add the node links back!! I went to some trouble to get
> > rid of them all, because they make for an utter nightmare when you're
> > trying to add new material. They're only useful if you want to link
> > nodes in some fashion other than that implied by the chapter/section
> > structure, and as of yet I haven't heard anyone come up with a good
> > rationale for linking in any other way.
> >
> > The replication of the TOC node with ifinfo and ifhtml is sufficient
> > to make the manual generate correctly with three versions of texinfo,
> > so I'm mystified as to why you think these other changes are necessary...
>
> I'm sorry, but please _don't_ delete them until I've cut this 5.0 branch
> :-) Without top level node entries I found that makeinfo 3.12 I was
> using failed.
>
> I tested with Texinfo 3.12 the patches that only duplicated the Top
> node and the menu, and they worked for me. Perhaps you could post the
> error messages you get with those patches, and we could then find out
> how to solve that.
>
> (Are you sure you used Texinfo 3.12 without any patches?)
Oops,
There wasn't anything wrong with your patch - I simply missed it in my
haste to get gdb/doc building again, sorry :-( The reason I was seeing
problems was that I'd not duplicated the node as you had done.
The attatched converts my botch into your patch.
I've also dropped a copy of texinfo-3.12 into the snapshots directory.
sorry,
Andrew
Stan, ok?
Tue Mar 28 16:06:22 2000 Andrew Cagney <cagney@b1.cygnus.com>
* gdb.texinfo,annotate.texi: Revert Fri Mar 24 18:06:34 2000
Andrew Cagney <cagney@b1.cygnus.com>.
From Wed 22 Mar 2000 Eli Zaretskii <eliz@delorie.com>:
* gdb.texinfo: Replace @ifnottex with duplicated @ifhtml and
@ifinfo nodes. Kludge to work around bug in texinfo 3.12.
Index: gdb/doc/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 06:16:20
***************
*** 55,64 ****
@syncodeindex fn cp
- @ifclear GDBN
@node Annotations
@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
--- 55,62 ----
Index: gdb/doc/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 06:17:00
*************** into another language, under the above c
*** 110,118 ****
@end titlepage
@page
-
- @node Top, Summary, (dir), (dir)
@ifinfo
@top Debugging with @value{GDBN}
This file describes @value{GDBN}, the @sc{gnu} symbolic debugger.
--- 110,117 ----
@end titlepage
@page
@ifinfo
+ @node Top
@top Debugging with @value{GDBN}
This file describes @value{GDBN}, the @sc{gnu} symbolic debugger.
*************** This is the @value{EDITION} Edition, @va
*** 121,127 ****
--- 120,170 ----
@value{GDBVN}.
Copyright (C) 1988-1999 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 annotations 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
+
+ @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-1999 Free Software Foundation, Inc.
@menu
* Summary:: Summary of @value{GDBN}
* Sample Session:: A sample @value{GDBN} session
*************** Copyright (C) 1988-1999 Free Software Fo
*** 154,161 ****
* Installing GDB:: Installing GDB
* 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
--- 197,206 ----
* Installing GDB:: Installing GDB
* 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}
--- 250,256 ----
* 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
--- 266,272 ----
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}.
--- 405,411 ----
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.
--- 675,681 ----
(@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,
--- 693,699 ----
* 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
--- 770,776 ----
* 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
--- 878,884 ----
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}
--- 1059,1065 ----
@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
--- 1087,1093 ----
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
--- 1116,1122 ----
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
--- 1131,1137 ----
* 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
--- 1174,1180 ----
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
--- 1293,1299 ----
see @ref{Debugging C plus plus, ,@value{GDBN} features for C++}.
! @node Help
@section Getting help
@cindex online documentation
@kindex help
*************** 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
--- 1478,1484 ----
@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
--- 1504,1510 ----
* 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
--- 1545,1551 ----
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)
--- 1621,1627 ----
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)
--- 1655,1661 ----
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)
--- 1738,1744 ----
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
--- 1762,1768 ----
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
--- 1816,1822 ----
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
--- 1872,1878 ----
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
--- 1897,1903 ----
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
*************** 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
--- 2114,2120 ----
@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
--- 2191,2197 ----
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
--- 2220,2226 ----
* 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?
--- 2294,2300 ----
* 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
--- 2526,2532 ----
@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
--- 2669,2675 ----
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
--- 2777,2783 ----
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
--- 2822,2828 ----
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
--- 2895,2901 ----
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
--- 3012,3018 ----
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
--- 3093,3099 ----
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.
--- 3140,3146 ----
@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
--- 3193,3199 ----
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
--- 3395,3401 ----
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
--- 3491,3497 ----
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
--- 3576,3582 ----
@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
--- 3615,3621 ----
@end menu
! @node Frames
@section Stack frames
@cindex frame, definition
*************** to another without printing the frame.
*** 3636,3642 ****
@code{frame}.
@end table
! @node Backtrace, Selection, Frames, Stack
@section Backtraces
@cindex backtraces
--- 3681,3687 ----
@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
--- 3744,3750 ----
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
--- 3830,3836 ----
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
--- 3906,3912 ----
@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
--- 3928,3934 ----
* 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
--- 4045,4051 ----
@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
--- 4071,4077 ----
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
--- 4154,4160 ----
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
--- 4255,4261 ----
@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
--- 4310,4316 ----
* 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
--- 4363,4369 ----
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
--- 4484,4490 ----
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
--- 4556,4562 ----
@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
--- 4625,4631 ----
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
--- 4730,4736 ----
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
--- 4826,4832 ----
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
--- 5187,5193 ----
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
--- 5264,5270 ----
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
--- 5350,5356 ----
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
--- 5449,5455 ----
@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
--- 5465,5471 ----
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}
--- 5491,5497 ----
* 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
--- 5525,5531 ----
* 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,
--- 5565,5571 ----
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
--- 5597,5603 ----
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
--- 5616,5622 ----
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
--- 5658,5664 ----
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
--- 5691,5697 ----
@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
--- 5762,5768 ----
@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.
--- 5821,5827 ----
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++
--- 5846,5852 ----
* 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
--- 5881,5887 ----
* 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
--- 6041,6047 ----
* 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++
--- 6109,6115 ----
* 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
--- 6214,6220 ----
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
--- 6235,6241 ----
@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
--- 6267,6273 ----
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++
--- 6283,6289 ----
* 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
--- 6366,6372 ----
@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
--- 6390,6396 ----
* 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.
--- 6514,6520 ----
@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
--- 6626,6632 ----
@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
--- 6675,6681 ----
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
--- 6689,6695 ----
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
--- 6719,6725 ----
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 .
--- 6747,6753 ----
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.
--- 6787,6793 ----
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
--- 6808,6814 ----
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
--- 6830,6836 ----
* 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 = 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.
--- 6959,6965 ----
@end smallexample
@end table
! @node Locations
@subsubsection Locations and their accesses
A location in Chill is an object which can contain values.
*************** 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
--- 7040,7046 ----
(@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
*************** 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
--- 7243,7249 ----
@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
--- 7269,7275 ----
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
--- 7282,7288 ----
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
*************** 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
--- 7504,7510 ----
@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
--- 7526,7532 ----
* Patching:: Patching your program
@end menu
! @node Assignment
@section Assignment to variables
@cindex assignment
*************** 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
--- 7632,7638 ----
@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
--- 7685,7691 ----
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
--- 7714,7720 ----
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
--- 7745,7751 ----
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
--- 7767,7773 ----
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,
--- 7802,7808 ----
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
--- 7815,7821 ----
* Symbol Errors:: Errors reading symbol files
@end menu
! @node Files
@section Commands to specify files
@cindex symbol table
*************** 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,
--- 8095,8101 ----
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
--- 8184,8190 ----
@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
--- 8210,8216 ----
@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
--- 8245,8251 ----
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
--- 8377,8383 ----
@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
--- 8417,8423 ----
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
--- 8441,8447 ----
* 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
--- 8539,8545 ----
* 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
--- 8590,8596 ----
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
--- 8681,8687 ----
subroutines which @code{@value{GCC}} generates as inline code.
! @node Debug Session
@subsubsection Putting it all together
@cindex remote serial debugging summary
*************** 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
--- 8787,8793 ----
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
*************** 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
--- 9581,9587 ----
<- @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
--- 9683,9689 ----
@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
--- 9740,9746 ----
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
--- 9779,9785 ----
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
--- 9799,9805 ----
* 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
--- 9810,9823 ----
* 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
--- 9862,9868 ----
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
--- 9876,9882 ----
@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
--- 9943,9949 ----
* 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
--- 9976,9982 ----
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
--- 10022,10028 ----
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
--- 10038,10044 ----
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
--- 10063,10069 ----
* 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
--- 10091,10097 ----
@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
--- 10115,10121 ----
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
--- 10130,10136 ----
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
--- 10252,10258 ----
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
--- 10296,10302 ----
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
--- 10308,10314 ----
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
--- 10325,10331 ----
@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
--- 10382,10388 ----
* 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}
--- 10495,10501 ----
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:
--- 10515,10521 ----
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
--- 10532,10538 ----
@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
--- 10548,10554 ----
@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
--- 10601,10607 ----
* 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
--- 10619,10625 ----
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
--- 10662,10668 ----
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
--- 10675,10681 ----
@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
--- 10686,10692 ----
@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
--- 10737,10743 ----
@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
--- 10748,10754 ----
@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
--- 10892,10898 ----
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
--- 10913,10919 ----
@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
--- 10928,10934 ----
@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
--- 10951,10957 ----
@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.
--- 11005,11011 ----
* 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.
--- 11035,11041 ----
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
--- 11054,11060 ----
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
--- 11080,11086 ----
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
--- 11100,11106 ----
(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
--- 11114,11120 ----
@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
--- 11163,11169 ----
@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
--- 11214,11220 ----
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
--- 11226,11232 ----
* 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
--- 11252,11263 ----
@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
--- 11292,11298 ----
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
--- 11310,11316 ----
* 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
--- 11336,11342 ----
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
--- 11366,11372 ----
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
--- 11463,11469 ----
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
--- 11505,11511 ----
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
--- 11552,11558 ----
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 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
--- 11699,11705 ----
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
--- 11714,11720 ----
* 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
--- 11807,11813 ----
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
--- 11853,11859 ----
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
--- 11916,11922 ----
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
--- 11996,12002 ----
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}
--- 12170,12178 ----
each value is printed in its own window.
@end ignore
@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
--- 12192,12198 ----
* 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
--- 12224,12230 ----
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
*** 12370,12387 ****
@c inc-hist.texinfo
@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
--- 12413,12423 ----
@c inc-hist.texinfo
@c Use -I with makeinfo to point to the appropriate directory,
@c environment var TEXINPUTS with TeX.
@include rluser.texinfo
@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
--- 12503,12509 ----
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,
--- 12623,12629 ----
* 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}
--- 12684,12690 ----
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
--- 12726,12732 ----
@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
--- 12795,12801 ----
There are many other options available as well, but they are generally
needed for special purposes only.
! @node Index
@unnumbered Index
@printindex cp
Tue Mar 28 16:06:22 2000 Andrew Cagney <cagney@b1.cygnus.com>
* inc-hist.texinfo, rluser.texinfo: Revert change Fri Mar 24
18:04:32 2000 Andrew Cagney <cagney@b1.cygnus.com>.
Unconditionally provide @chapter and @node.
Index: readline/doc/inc-hist.texinfo
===================================================================
RCS file: /cvs/src/src/readline/doc/inc-hist.texinfo,v
retrieving revision 1.2
diff -p -r1.2 inc-hist.texinfo
*** inc-hist.texinfo 2000/03/24 07:30:07 1.2
--- inc-hist.texinfo 2000/03/28 06:20:17
*************** Permission is granted to copy and distri
*** 23,32 ****
into another language, under the above conditions for modified versions.
@end ignore
- @ifclear GDBN
@node Using History Interactively
@chapter Using History Interactively
- @end ifclear
@ifset BashFeatures
This chapter describes how to use the GNU History Library interactively,
--- 23,30 ----
Index: readline/doc/rluser.texinfo
===================================================================
RCS file: /cvs/src/src/readline/doc/rluser.texinfo,v
retrieving revision 1.2
diff -p -r1.2 rluser.texinfo
*** rluser.texinfo 2000/03/24 07:30:07 1.2
--- rluser.texinfo 2000/03/28 06:20:21
*************** into another language, under the above c
*** 36,45 ****
@comment If you are including this manual as an appendix, then set the
@comment variable readline-appendix.
- @ifclear GDBN
@node Command Line Editing
@chapter Command Line Editing
- @end ifclear
This chapter describes the basic features of the @sc{GNU}
command line editing interface.
--- 36,43 ----