From: Roland Pesch Date: Fri, 1 Oct 1993 01:30:04 +0000 (+0000) Subject: Assorted small improvements, mostly from FSF editing pass (Melissa). X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=6b51acad7e1a828d2b5b207b1fe8a576a00fd98e;p=binutils-gdb.git Assorted small improvements, mostly from FSF editing pass (Melissa). --- diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 7d7f8c30182..db77f1ec6bc 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +Thu Sep 30 18:24:56 1993 Roland H. Pesch (pesch@fowanton.cygnus.com) + + * gdb.texinfo, remote.texi: assorted small improvements, mostly + from Melissa at FSF's editing pass. + Thu Sep 30 11:54:38 1993 Jim Kingdon (kingdon@lioth.cygnus.com) * gdb.texinfo: Remove stuff about ar and 14 character filenames. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 4fad9a3b85a..8e072c2140c 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -54,11 +54,11 @@ END-INFO-DIR-ENTRY This file documents the GNU debugger @value{GDBN}. @c !!set edition, date, version -This is Edition 4.09, April 1993, +This is Edition 4.09, August 1993, of @cite{Debugging with @value{GDBN}: the GNU Source-Level Debugger} for GDB Version @value{GDBVN}. -Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993 Free Software Foundation, Inc. +Copyright (C) 1988, '89, '90, '91, '92, '93 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -89,8 +89,8 @@ into another language, under the above conditions for modified versions. @sp 1 @c !!set edition, date, version @subtitle Edition 4.09, for @value{GDBN} version @value{GDBVN} -@subtitle April 1993 -@author by Richard M. Stallman and Roland H. Pesch +@subtitle August 1993 +@author Richard M. Stallman and Roland H. Pesch @page @tex {\parskip=0pt @@ -102,7 +102,14 @@ into another language, under the above conditions for modified versions. @end tex @vskip 0pt plus 1filll -Copyright @copyright{} 1988, 1989, 1990, 1991, 1992, 1993 Free Software Foundation, Inc. +Copyright @copyright{} 1988, '89, '90, '91, '92, '93 Free Software +Foundation, Inc. +@sp 2 +Published by the Free Software Foundation @* +675 Massachusetts Avenue, @* +Cambridge, MA 02139 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 @@ -266,7 +273,7 @@ Kingdon (releases 3.5, 3.4, 3.3); and Randy Smith (releases 3.2, 3.1, significantly to the structure, stability, and capabilities of the entire debugger. -Richard Stallman, assisted at various times by Pete TerMaat, Chris +Richard Stallman, assisted at various times by Peter TerMaat, Chris Hanson, and Richard Mlynarik, handled releases through 2.8. @ifclear CONLY @@ -831,11 +838,11 @@ them, so long as enough of the option is present to be unambiguous. than @samp{-}, though we illustrate the more usual convention.) @table @code -@item -symbols=@var{file} +@item -symbols @var{file} @itemx -s @var{file} Read symbol table from file @var{file}. -@item -exec=@var{file} +@item -exec @var{file} @itemx -e @var{file} Use file @var{file} as the executable file to execute when @ifset BARETARGET @@ -846,12 +853,12 @@ appropriate, and for examining pure data in conjunction with a core dump. @end ifclear -@item -se=@var{file} +@item -se @var{file} Read symbol table from file @var{file} and use it as the executable file. @ifclear BARETARGET -@item -core=@var{file} +@item -core @var{file} @itemx -c @var{file} Use file @var{file} as a core dump to examine. @@ -861,12 +868,12 @@ Connect to process ID @var{number}, as with the @code{attach} command case @samp{-c} specifies that file as a core dump to read). @end ifclear -@item -command=@var{file} +@item -command @var{file} @itemx -x @var{file} Execute @value{GDBN} commands from file @var{file}. @xref{Command Files,, Command files}. -@item -directory=@var{directory} +@item -directory @var{directory} @itemx -d @var{directory} Add @var{directory} to the path to search for source files. @@ -947,7 +954,7 @@ Program exited normally. (which is ordinarily issued whenever a program running under @value{GDBN} control terminates) is not issued when running in batch mode. -@item -cd=@var{directory} +@item -cd @var{directory} Run @value{GDBN} using @var{directory} as its working directory, instead of the current directory. @@ -979,7 +986,7 @@ a signal to display the source code for the frame. Set the line speed (baud rate or bits per second) of any serial interface used by @value{GDBN} for remote debugging. -@item -tty=@var{device} +@item -tty @var{device} Run using @var{device} for your program's standard input and output. @c FIXME: kingdon thinks there is more to -tty. Investigate. @end ifset @@ -1482,7 +1489,7 @@ wrong program. When you issue the @code{run} command, your program begins to execute immediately. @xref{Stopping, ,Stopping and continuing}, for discussion of how to arrange for your program to stop. Once your program has -stopped, you may calls functions in your program, using the @code{print} +stopped, you may call functions in your program, using the @code{print} or @code{call} commands. @xref{Data, ,Examining Data}. If the modification time of your symbol file has changed since the @@ -2111,7 +2118,7 @@ expression changes, without having to predict a particular place where this may happen. Watchpoints currently execute two orders of magnitude more slowly than -other breakpoints, but this can well be worth it to catch errors where +other breakpoints, but this can be well worth it to catch errors where you have no clue what part of your program is the culprit. Some processors provide special hardware to support watchpoint evaluation; future releases of @value{GDBN} will use such hardware if it is available. @@ -2495,15 +2502,6 @@ cont end @end example -@cindex lost output -@c Do we need to mention this at all? I am sort of tempted to mention -@c it in case people are used to seeing this section of the manual. But -@c for new users it is an annoyance--it documents something which isn't -@c there. -kingdon, 6 Jul 93 -Previous versions of @value{GDBN} (4.9 and earlier) would flush pending -input when executing breakpoint commands, if your program used raw mode -for the terminal. This is no longer true. - @ignore @c I don't think this is true any longer, now that only readline @c switches to or from raw mode. In any event, it is a (relatively @@ -2631,27 +2629,25 @@ or when stepping, your program may stop even sooner, due to a breakpoint. @end ifset @ifclear BARETARGET -a breakpoint or to a signal. (If due to a signal, you may want to use +a breakpoint or a signal. (If due to a signal, you may want to use @code{handle}, or use @samp{signal 0} to resume execution. @xref{Signals, ,Signals}.) @end ifclear @table @code -@item continue @r{[}@var{count}@r{]} -@itemx c @r{[}@var{count}@r{]} -@itemx fg @r{[}@var{count}@r{]} +@item continue @r{[}@var{ignore-count}@r{]} +@itemx c @r{[}@var{ignore-count}@r{]} +@itemx fg @r{[}@var{ignore-count}@r{]} @kindex continue @kindex c @kindex fg -Resume program execution, at the address where your program last -stopped; any breakpoints set at that address are bypassed. The optional -argument @var{count} means to set the ignore count of a breakpoint which -you are stopped at to @var{count} @minus{} 1, just like the @code{ignore} -command (@pxref{Conditions, ,Break conditions}). This means that the -program does not stop at that breakpoint until the @var{count}th time -it is hit. - -The argument @var{count} is meaningful only when your program +Resume program execution, at the address where your program last stopped; +any breakpoints set at that address are bypassed. The optional argument +@var{ignore-count} allows you to specify a further number of times to +ignore a breakpoint at this location; its effect is like that of +@code{ignore} (@pxref{Conditions, ,Break conditions}). + +The argument @var{ignore-count} is meaningful only when your program stopped due to a breakpoint. At other times, the argument to @code{continue} is ignored. @@ -2726,7 +2722,7 @@ Contrast this with the @code{return} command (@pxref{Returning, @item until @kindex until -@item u +@itemx u @kindex u Continue running until a source line past the current line, in the current stack frame, is reached. This command is used to avoid single @@ -2771,7 +2767,7 @@ instruction stepping, and hence is slower than @code{until} with an argument. @item until @var{location} -@item u @var{location} +@itemx u @var{location} Continue running your program until either the specified location is reached, or the current stack frame returns. @var{location} is any of the forms of argument acceptable to @code{break} (@pxref{Set Breaks, @@ -2973,6 +2969,7 @@ and so on upward. These numbers do not really exist in your program; 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 @@ -4093,7 +4090,7 @@ These settings are useful for debugging programs in any language: @table @code @item set print address -@item set print address on +@itemx set print address on @kindex set print address @value{GDBN} will print memory addresses showing the location of stack traces, structure values, pointer values, breakpoints, and so forth, @@ -4398,10 +4395,11 @@ pointers back to the types defined in the symbol table. @cindex @code{$} @cindex @code{$$} @cindex history number -The values printed are given @dfn{history numbers} for you to refer to them -by. These are successive integers starting with one. @code{print} shows you -the history number assigned to a value by printing @samp{$@var{num} = } -before the value; here @var{num} is the history number. +The values printed are given @dfn{history numbers} by which you can +refer to them. These are successive integers starting with one. +@code{print} shows you the history number assigned to a value by +printing @samp{$@var{num} = } before the value; here @var{num} is the +history number. To refer to any previous value, use @samp{$} followed by the value's history number. The way @code{print} labels its output is designed to @@ -4487,9 +4485,9 @@ set $foo = *object_ptr would save in @code{$foo} the value contained in the object pointed to by @code{object_ptr}. -Using a convenience variable for the first time creates it; but its value -is @code{void} until you assign a new value. You can alter the value with -another assignment at any time. +Using a convenience variable for the first time creates it, but its +value is @code{void} until you assign a new value. You can alter the +value with another assignment at any time. Convenience variables have no fixed types. You can assign a convenience variable any type of value, including structures and arrays, even if @@ -4980,7 +4978,7 @@ is printed and evaluation of the expression is aborted. Output messages when the @value{GDBN} range checker detects a range error, but attempt to evaluate the expression anyway. Evaluating the expression may still be impossible for other reasons, such as accessing -memory that the process does not own (a typical example from many UNIX +memory that the process does not own (a typical example from many Unix systems). @item show range @@ -5685,7 +5683,7 @@ represents a variable or constant of integral type. @item m represents an identifier that belongs to a set. Generally used in the same function with the metavariable @var{s}. The type of @var{s} should -be @code{SET OF @var{mtype}} (where @var{mtype} is the type of @var{m}. +be @code{SET OF @var{mtype}} (where @var{mtype} is the type of @var{m}). @item n represents a variable or constant of integral or floating-point type. @@ -6003,7 +6001,7 @@ local variable, this prints the stack-frame offset at which the variable is always stored. Note the contrast with @samp{print &@var{symbol}}, which does not work -at all for a register variables, and for a stack local variable prints +at all for a register variable, and for a stack local variable prints the exact address of the current instantiation of the variable. @item whatis @var{exp} @@ -6298,7 +6296,7 @@ already executed, in order to examine its execution in more detail. @table @code @item signal @var{signalnum} @kindex signal -Resume execution where your program stopped, but give it immediately the +Resume execution where your program stopped, but immediately give it the signal number @var{signalnum}. Alternatively, if @var{signalnum} is zero, continue execution without @@ -6692,12 +6690,12 @@ Print the names of the shared libraries which are currently loaded. @itemx share @var{regex} @kindex sharedlibrary @kindex share -This is an obsolescent command; you can use it to explicitly -load shared object library symbols for files matching a UNIX regular -expression, but as with files loaded automatically, it will only load -shared libraries required by your program for a core file or after -typing @code{run}. If @var{regex} is omitted all shared libraries -required by your program are loaded. +This is an obsolescent command; you can use it to explicitly load shared +object library symbols for files matching a Unix regular expression, but +as with files loaded automatically, it will only load shared libraries +required by your program for a core file or after typing @code{run}. If +@var{regex} is omitted all shared libraries required by your program are +loaded. @end table @end ifclear diff --git a/gdb/doc/remote.texi b/gdb/doc/remote.texi index bf04d0ff5eb..5b7ec90e1e8 100644 --- a/gdb/doc/remote.texi +++ b/gdb/doc/remote.texi @@ -68,14 +68,14 @@ For @sc{sparc} architectures. @item m68k-stub.c @kindex m68k-stub.c -@kindex Motorola 680x0 -@kindex 680x0 +@cindex Motorola 680x0 +@cindex 680x0 For Motorola 680x0 architectures. @item i386-stub.c @kindex i386-stub.c -@kindex Intel -@kindex 386 +@cindex Intel +@cindex 386 For Intel 386 and compatible architectures. @end table @@ -225,7 +225,7 @@ steps. @enumerate @item Make sure you have the supporting low-level routines -(@pxref{Bootstrapping}): +(@pxref{Bootstrapping,,What you must do for the stub}): @display @code{getDebugChar}, @code{putDebugChar}, @code{flush_i_cache}, @code{memset}, @code{exceptionHandler}. @@ -885,8 +885,8 @@ sequences will get you back to the @value{GDBN} command prompt: @value{GDBN} enables developers to spawn and debug tasks running on networked VxWorks targets from a Unix host. Already-running tasks spawned from the VxWorks shell can also be debugged. @value{GDBN} uses code that runs on -both the UNIX host and on the VxWorks target. The program -@code{gdb} is installed and executed on the UNIX host. (It may be +both the Unix host and on the VxWorks target. The program +@code{gdb} is installed and executed on the Unix host. (It may be installed with the name @code{vxgdb}, to distinguish it from a @value{GDBN} for debugging programs on the host itself.) @@ -909,7 +909,7 @@ VxWorks, see the manufacturer's manual. Once you have included the RDB interface in your VxWorks system image and set your Unix execution search path to find @value{GDBN}, you are ready -to run @value{GDBN}. From your UNIX host, run @code{gdb} (or +to run @value{GDBN}. From your Unix host, run @code{gdb} (or @code{vxgdb}, depending on your installation). @value{GDBN} comes up showing the prompt: @@ -961,7 +961,7 @@ command again. @cindex download to VxWorks If you have connected to the VxWorks target and you want to debug an object that has not yet been loaded, you can use the @value{GDBN} -@code{load} command to download a file from UNIX to VxWorks +@code{load} command to download a file from Unix to VxWorks incrementally. The object file given as an argument to the @code{load} command is actually opened twice: first by the VxWorks target in order to download the code, then by @value{GDBN} in order to read the symbol @@ -1204,11 +1204,11 @@ retransmit-timeout}. (These commands are @emph{only} available when @cindex MIPS remote floating point @cindex floating point, MIPS remote If your target board does not support the MIPS floating point -coprocessor, use the command @samp{set mipsfpu off} (you may wish to put -this in your @value{GDBINIT} file). This will tell @value{GDBN} how to -find the return value of functions which return floating point values, -and tell it to call functions on the board without saving the floating -point registers. +coprocessor, you should use the command @samp{set mipsfpu off} (you may +wish to put this in your @value{GDBINIT} file). This tells @value{GDBN} +how to find the return value of functions which return floating point +values. It also allows @value{GDBN} to avoid saving the floating point +registers when calling functions on the board. @end ifset @ifset SIMS