From 146212247ccbc90666cb15f923333eccb905e452 Mon Sep 17 00:00:00 2001 From: Jim Kingdon Date: Tue, 8 Jun 1993 20:46:45 +0000 Subject: [PATCH] * gdb.texinfo (Print Settings): Move all stuff relating to symbolic addresses together. Also motivate the set print symbol-filename command and suggest other solutions. --- gdb/doc/ChangeLog | 6 ++++ gdb/doc/gdb.texinfo | 69 ++++++++++++++++++++++++++++----------------- 2 files changed, 49 insertions(+), 26 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index e33d17ba322..9643f727faa 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +Tue Jun 8 13:42:04 1993 Jim Kingdon (kingdon@cygnus.com) + + * gdb.texinfo (Print Settings): Move all stuff relating to symbolic + addresses together. Also motivate the set print symbol-filename + command and suggest other solutions. + Tue Jun 1 22:46:43 1993 Fred Fish (fnf@cygnus.com) * gdb.texinfo (set print elements): Note that the number of diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 2a13f0d5093..0624d468194 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -4125,7 +4125,50 @@ all machines---whether or not they involve pointer arguments. @item show print address @kindex show print address Show whether or not addresses are to be printed. +@end table + +When @value{GDBN} prints a symbolic address, it normally prints the +closest earlier symbol plus an offset. If that symbol does not uniquely +identify the address (for example, it is a name whose scope is a single +source file), you may need to disambiguate. One way to do this is with +@code{info line}, for example @code{info line *0x4537}. Alternately, +you can set @value{GDBN} to print the source file and line number when +it prints a symbolic address: + +@table @code +@item set print symbol-filename on +@kindex set print symbol-filename +Tell @value{GDBN} to print the source file name and line number of a +symbol in the symbolic form of an address. + +@item set print symbol-filename off +Do not print source file name and line number of a symbol. This is the +default. + +@item show print symbol-filename +@kindex show print symbol-filename +Show whether or not @value{GDBN} will print the source file name and +line number of a symbol in the symbolic form of an address. +@end table + +Also, you may wish to see the symbolic form only if the address being +printed is reasonably close to the closest earlier symbol: + +@table @code +@item set print max-symbolic-offset @var{max-offset} +@kindex set print max-symbolic-offset +Tell @value{GDBN} to only display the symbolic form of an address if the +offset between the closest earlier symbol and the address is less than +@var{max-offset}. The default is 0, which means to always print the +symbolic form of an address, if any symbol precedes it. + +@item show print max-symbolic-offset +@kindex show print max-symbolic-offset +Ask how large the maximum offset is that @value{GDBN} will print in a +symbolic address. +@end table +@table @code @item set print array @itemx set print array on @kindex set print array @@ -4247,32 +4290,6 @@ and with @code{set print union off} in effect it would print @smallexample $1 = @{it = Tree, form = @{...@}@} @end smallexample - -@item set print max-symbolic-offset @var{maxoff} -@kindex set print max-symbolic-offset -Tell @value{GDBN} to only display the symbolic form of an address if the -offset between the closest earlier symbol and the address is less than -@var{maxoff}. The default is 0, which means to always print the -symbolic form of an address, if any symbol precedes it. - -@item show print max-symbolic-offset -@kindex show print max-symbolic-offset -Ask how large the maximum offset is that @value{GDBN} will print in a -symbolic address. - -@item set print symbol-filename on -@kindex set print symbol-filename -Tell @value{GDBN} to print the source filename and linenumber of a symbol -in the symbolic form of an address. - -@item set print symbol-filename off -Do not print source filename and linenumber of a symbol. This is the default. - -@item show print symbol-filename -@kindex show print symbol-filename -Show whether or not @value{GDBN} will print the source filename and linenumber -of a symbol in the symbolic form of an address. - @end table @ifclear CONLY -- 2.30.2