* gdb.texinfo (Output Formats): Mention "info symbol" and provide

	a cross-reference to its description.
	(Symbols): Document "info symbol".

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 05f7f728d70b55ef527b92649a133ac0e6f200f6..a6dcf506a661f187e1f11ea75f3b0b36a05649f5 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2001-03-26  Eli Zaretskii  <eliz@is.elta.co.il>
+
+       * gdb.texinfo (Output Formats): Mention "info symbol" and provide
+       a cross-reference to its description.
+       (Symbols): Document "info symbol".
+
 2001-03-21  Eli Zaretskii  <eliz@is.elta.co.il>
 
        * gdbint.texinfo (Algorithms): New section "Watchpoints" and new

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 4f7d94677dbed274c98b7a9a5c092554cf3aa2cc..18a123bc1260b3a1ec60caa631fc3b246a0a4762 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -4641,6 +4641,7 @@ see @ref{Memory,,Examining memory}.}
 
 @item a
 @cindex unknown address, locating
+@cindex locate address
 Print as an address, both absolute in hexadecimal and as an offset from
 the nearest preceding symbol.  You can use this format used to discover
 where (in what function) an unknown address is located:
@@ -4650,6 +4651,10 @@ where (in what function) an unknown address is located:
 $3 = 0x54320 <_initialize_vx+396>
 @end example
 
+@noindent
+The command @code{info symbol 0x54320} yields similar results.
+@xref{Symbols, info symbol}.
+
 @item c
 Regard as an integer and print it as a character constant.
 
@@ -7527,6 +7532,21 @@ Note the contrast with @samp{print &@var{symbol}}, which does not work
 at all for a register variable, and for a stack local variable prints
 the exact address of the current instantiation of the variable.
 
+@kindex info symbol
+@item info symbol @var{addr}
+Print the name of a symbol which is stored at the address @var{addr}.
+If no symbol is stored exactly at @var{addr}, @value{GDBN} prints the
+nearest symbol and an offset from it:
+
+@example
+(@value{GDBP}) info symbol 0x54320
+_initialize_vx + 396 in section .text
+@end example
+
+@noindent
+This is the opposite of the @code{info address} command.  You can use
+it to find out the name of a variable or a function given its address.
+
 @kindex whatis
 @item whatis @var{expr}
 Print the data type of expression @var{expr}.  @var{expr} is not