darkkirb/old-cross-binutils
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Changes agreed w/gnu, summarized in mail of Tue Apr 2 15:52:44 1991

Browse source 
RENAMES:
 add-syms -> add-symbol-file
 info->show convenience
 info->show directories
 info editing->show commands
 info->help targets
 info->show values
 info->show version
 set subcommands:
  addressprint->print address
  arrayprint->print array
  prettyprint->print pretty
  screen-height->height
  screen-width->width
  unionprint->print union
  vtblprint->print vtbl
DELETED: info history (syn "show values" remains)
ADDED: help target BLAH
This commit is contained in:
Roland Pesch 1991-04-05 23:35:32 +00:00
parent 4a69e6d6cf
commit 41d786f7a5
1 changed files with 77 additions and 87 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

164
gdb/doc/gdb.texinfo
View file

@ -1086,7 +1086,6 @@ values, you can use @samp{show} with no arguments; you may also use
@kindex show version @kindex show version
@item show version @item show version
@c FIXME: chgd to "show version" from "info". Verify John doing same to GDBv4.
Show what version of _GDBN__ is running. You should include this Show what version of _GDBN__ is running. You should include this
information in _GDBN__ bug-reports. If multiple versions of _GDBN__ are information in _GDBN__ bug-reports. If multiple versions of _GDBN__ are
in use at your site, you may occasionally want to make sure what version in use at your site, you may occasionally want to make sure what version
@ -2346,7 +2345,7 @@ for @samp{backtrace}.
Each line in the backtrace shows the frame number and the function name. Each line in the backtrace shows the frame number and the function name.
The program counter value is also shown---unless you use @samp{set The program counter value is also shown---unless you use @samp{set
addressprint off}. The backtrace also shows the source file name and print address off}. The backtrace also shows the source file name and
line number, as well as the arguments to the function. The program line number, as well as the arguments to the function. The program
counter value is omitted if it is at the beginning of the code for that counter value is omitted if it is at the beginning of the code for that
line number. line number.
@ -2667,8 +2666,8 @@ Reset the source path to empty again. This requires confirmation.
The @samp{directory} command will not repeat if you press @key{RET} a The @samp{directory} command will not repeat if you press @key{RET} a
second time after executing it once. second time after executing it once.
@item info directories @item show directories
@kindex info directories @kindex show directories
Print the source path: show which directories it contains. Print the source path: show which directories it contains.
@end table @end table
@ -3185,17 +3184,17 @@ This limit also applies to the display of strings.
Display the number of elements of a large array that _GDBN__ will print Display the number of elements of a large array that _GDBN__ will print
before losing patience. before losing patience.
@item set arrayprint @item set print array
@itemx set arrayprint on @itemx set print array on
@kindex set arrayprint @kindex set print array
_GDBN__ will pretty print arrays. This format is more convenient to read, _GDBN__ will pretty print arrays. This format is more convenient to read,
but uses more space. The default is off. but uses more space. The default is off.
@item set arrayprint off. @item set print array off.
Return to compressed format for arrays. Return to compressed format for arrays.
@item show arrayprint @item show print array
@kindex show arrayprint @kindex show print array
Show whether compressed or pretty format is selected for displaying Show whether compressed or pretty format is selected for displaying
arrays. arrays.
@ -3222,33 +3221,33 @@ The default is off.
Show whether C++ names in assembly listings will be printed in mangled Show whether C++ names in assembly listings will be printed in mangled
or demangled form. or demangled form.
@item set vtblprint @item set print vtbl
@itemx set vtblprint on @itemx set print vtbl on
@kindex set vtblprint @kindex set print vtbl
Pretty print C++ virtual function tables. The default is off. Pretty print C++ virtual function tables. The default is off.
@item set vtblprint off @item set print vtbl off
Do not pretty print C++ virtual function tables. Do not pretty print C++ virtual function tables.
@item show vtblprint @item show print vtbl
@kindex show vtblprint @kindex show print vtbl
Show whether C++ virtual function tables are pretty printed, or not. Show whether C++ virtual function tables are pretty printed, or not.
@item set addressprint @item set print address
@item set addressprint on @item set print address on
@kindex set addressprint @kindex set print address
_GDBN__ will print memory addresses in stack traces, structure values, pointer _GDBN__ will print memory addresses in stack traces, structure values, pointer
values, breakpoints, etc. The default is on. values, breakpoints, etc. The default is on.
@item set addressprint off @item set print address off
Do not print addresses. Do not print addresses.
@item show addressprint @item show print address
@kindex show addressprint @kindex show print address
Show whether or not addresses are to be printed. Show whether or not addresses are to be printed.
@item set prettyprint on @item set print pretty on
@kindex set prettyprint @kindex set print pretty
Cause _GDBN__ to print structures in an indented format with one member per Cause _GDBN__ to print structures in an indented format with one member per
line, like this: line, like this:
@ -3263,7 +3262,7 @@ $1 = @{
@} @}
@end example @end example
@item set prettyprint off @item set print pretty off
Cause _GDBN__ to print structures in a compact format, like this: Cause _GDBN__ to print structures in a compact format, like this:
@smallexample @smallexample
@ -3274,20 +3273,20 @@ $1 = @{next = 0x0, flags = @{sweet = 1, sour = 1@}, meat \
@noindent @noindent
This is the default format. This is the default format.
@item show prettyprint @item show print pretty
@kindex show prettyprint @kindex show print pretty
Show which format _GDBN__ will use to print structures. Show which format _GDBN__ will use to print structures.
@item set unionprint on @item set print union on
@kindex set unionprint @kindex set print union
Tell _GDBN__ to print unions which are contained in structures. This is the Tell _GDBN__ to print unions which are contained in structures. This is the
default setting. default setting.
@item set unionprint off @item set print union off
Tell _GDBN__ not to print unions which are contained in structures. Tell _GDBN__ not to print unions which are contained in structures.
@item show unionprint @item show print union
@kindex show unionprint @kindex show print union
Ask _GDBN__ whether or not it will print unions which are contained in Ask _GDBN__ whether or not it will print unions which are contained in
structures. structures.
@ -3310,14 +3309,14 @@ struct thing foo = @{Tree, @{Acorn@}@};
@end smallexample @end smallexample
@noindent @noindent
with @samp{set unionprint on} in effect @samp{p foo} would print with @samp{set print union on} in effect @samp{p foo} would print
@smallexample @smallexample
$1 = @{it = Tree, form = @{tree = Acorn, bug = Cocoon@}@} $1 = @{it = Tree, form = @{tree = Acorn, bug = Cocoon@}@}
@end smallexample @end smallexample
@noindent @noindent
and with @samp{set unionprint off} in effect it would print and with @samp{set print union off} in effect it would print
@smallexample @smallexample
$1 = @{it = Tree, form = @{...@}@} $1 = @{it = Tree, form = @{...@}@}
@ -3382,19 +3381,16 @@ then the value recorded in the value history by the @samp{print} command
remains 4 even though the value of @code{x} has changed. remains 4 even though the value of @code{x} has changed.
@table @code @table @code
@kindex info values @kindex show values
@item info values @item show values
@itemx info history Print the last ten values in the value history, with their item numbers.
@kindex info history This is like @samp{p@ $$9} repeated ten times, except that @samp{show
These two commands are synonymous. Either form will print the last ten values} does not change the history.
values in the value history, with their item numbers. This is like
@samp{p@ $$9} repeated ten times, except that @samp{info values} does
not change the history.
@item info values @var{n} @item show values @var{n}
Print ten history values centered on history item number @var{n}. Print ten history values centered on history item number @var{n}.
@item info values + @item show values +
Print ten history values just after the values last printed. Print ten history values just after the values last printed.
@end table @end table
@ -3433,8 +3429,8 @@ that variable already has a value of a different type. The convenience
variable, when used as an expression, has the type of its current value. variable, when used as an expression, has the type of its current value.
@table @code @table @code
@item info convenience @item show convenience
@kindex info convenience @kindex show convenience
Print a list of convenience variables used so far, and their values. Print a list of convenience variables used so far, and their values.
Abbreviated @samp{i con}. Abbreviated @samp{i con}.
@end table @end table
@ -3943,7 +3939,7 @@ _GDBN__, the @samp{load} command may be available. Where it exists, it
is meant to make @var{filename} (an executable) available for debugging is meant to make @var{filename} (an executable) available for debugging
on the remote system---by downloading, or dynamic linking, for example. on the remote system---by downloading, or dynamic linking, for example.
@samp{load} also records @var{filename}'s symbol table in _GDBN__, like @samp{load} also records @var{filename}'s symbol table in _GDBN__, like
the @samp{add-syms} command. the @samp{add-symbol-file} command.
If @samp{load} is not available on your _GDBN__, attempting to execute If @samp{load} is not available on your _GDBN__, attempting to execute
it gets the error message ``@code{You can't do that when your target is it gets the error message ``@code{You can't do that when your target is
@ -3963,10 +3959,10 @@ _fi__(_I960__)
@samp{load} will not repeat if you press @key{RET} again after using it. @samp{load} will not repeat if you press @key{RET} again after using it.
@item add-syms @var{filename} @var{address} @item add-symbol-file @var{filename} @var{address}
@kindex add-syms @kindex add-symbol-file
@cindex dynamic linking @cindex dynamic linking
The @samp{add-syms} command reads additional symbol table information The @samp{add-symbol-file} command reads additional symbol table information
from the file @var{filename}. You would use this command when that file from the file @var{filename}. You would use this command when that file
has been dynamically loaded (by some other means) into the program that has been dynamically loaded (by some other means) into the program that
is running. @var{address} should be the memory address at which the is running. @var{address} should be the memory address at which the
@ -3974,23 +3970,21 @@ file has been loaded; _GDBN__ cannot figure this out for itself.
The symbol table of the file @var{filename} is added to the symbol table The symbol table of the file @var{filename} is added to the symbol table
originally read with the @samp{symbol-file} command. You can use the originally read with the @samp{symbol-file} command. You can use the
@samp{add-syms} command any number of times; the new symbol data thus @samp{add-symbol-file} command any number of times; the new symbol data thus
read keeps adding to the old. To discard all old symbol data instead, read keeps adding to the old. To discard all old symbol data instead,
use the @samp{symbol-file} command. use the @samp{symbol-file} command.
@samp{add-syms} will not repeat if you press @key{RET} after using it. @samp{add-symbol-file} will not repeat if you press @key{RET} after using it.
@item info files @item info files
@itemx info target @itemx info target
@kindex info files @kindex info files
@kindex info target @kindex info target
@samp{info files} and @samp{info target} are synonymous; both print the @samp{info files} and @samp{info target} are synonymous; both print the
current targets (@pxref{Targets}), including the names of the current targets (@pxref{Targets}), including the names of the executable
executable and core dump files currently in use by _GDBN__, and the files and core dump files currently in use by _GDBN__, and the files from
from which symbols were loaded. which symbols were loaded. The command @samp{help targets} lists all
possible targets rather than current ones.
Beware: the similar command @samp{info targets} lists all possible
targets rather than current ones.
@end table @end table
@ -4175,24 +4169,20 @@ target machine.
Further @var{parameters} are interpreted by the target protocol, but Further @var{parameters} are interpreted by the target protocol, but
typically include things like device names or host names to connect typically include things like device names or host names to connect
with, process numbers, and baud rates. Executing with, process numbers, and baud rates.
@example
target @var{type}
@end example
@noindent
(without any parameters) will issue a message about what
parameters are required for that target type.
The @samp{target} command will not repeat if you press @key{RET} again The @samp{target} command will not repeat if you press @key{RET} again
after executing the command. after executing the command.
@item info targets @item help targets
@kindex info targets @kindex help targets
Displays the names of all targets available. Beware: the similar Displays the names of all targets available. To display targets
command @samp{info target} displays targets currently in use rather than currently selected, use either @samp{info target} or @samp{info files}
all available ones. @samp{info files} gives the same information as (@pxref{Files}).
@samp{info target} (@pxref{Files}).
@item help target @var{name}
Describe a particular target, including any parameters necessary to
select it.
@end table @end table
Here are some common targets (available, or not, depending on the _GDBN__ Here are some common targets (available, or not, depending on the _GDBN__
@ -4293,7 +4283,7 @@ To resume the remote program and stop debugging it, use the @samp{detach}
command. command.
Other remote targets may be available in your Other remote targets may be available in your
configuration of _GDBN__; use @samp{info targets} to list them. configuration of _GDBN__; use @samp{help targets} to list them.
@node Controlling _GDBN__,,, @node Controlling _GDBN__,,,
@chapter Controlling _GDBN__ @chapter Controlling _GDBN__
@ -4428,14 +4418,14 @@ These commands display the state of the _GDBN__ history parameters.
@end table @end table
@table @code @table @code
@kindex info editing @kindex show commands
@item info editing @item show commands
Display the last ten commands in the command history. Display the last ten commands in the command history.
@item info editing @var{n} @item show commands @var{n}
Print ten commands centered on command number @var{n}. Print ten commands centered on command number @var{n}.
@item info editing + @item show commands +
Print ten commands just after the commands last printed. Print ten commands just after the commands last printed.
@end table @end table
@ -4455,18 +4445,18 @@ rather than simply letting it overflow onto the following line.
Normally _GDBN__ knows the size of the screen from the termcap data base Normally _GDBN__ knows the size of the screen from the termcap data base
together with the value of the @code{TERM} environment variable and the together with the value of the @code{TERM} environment variable and the
@code{stty rows} and @code{stty cols} settings. If this is not correct, @code{stty rows} and @code{stty cols} settings. If this is not correct,
you can override it with the @samp{set screen-height} and @samp{set you can override it with the @samp{set height} and @samp{set
screen-width} commands: width} commands:
@table @code @table @code
@item set screen-height @var{lpp} @item set height @var{lpp}
@itemx show screen-height @itemx show height
@itemx set screen-width @var{cpl} @itemx set width @var{cpl}
@itemx show screen-width @itemx show width
@kindex set screen-height @kindex set height
@kindex set screen-width @kindex set width
@kindex show screen-width @kindex show width
@kindex show screen-height @kindex show height
These @samp{set} commands specify a screen height of @var{lpp} lines and These @samp{set} commands specify a screen height of @var{lpp} lines and
a screen width of @var{cpl} characters. The associated @samp{show} a screen width of @var{cpl} characters. The associated @samp{show}
commands display the current settings. commands display the current settings.