[PATCH] Document "info symbol"

[PATCH] Document "info symbol"

[Eli Zaretskii]

The GDB manual didn't mention "info symbol".  Now it does.

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".


--- gdb/doc/gdb.te~	Wed Jan 24 00:48:56 2001
+++ gdb/doc/gdb.texinfo	Fri Mar 23 21:50:52 2001
@@ -4634,6 +4634,7 @@
 
 @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:
@@ -4643,6 +4644,10 @@
 $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.
 
@@ -7520,6 +7525,21 @@
 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