From: Ian Lance Taylor <ian@airs.com>
Date: Fri, 26 Jan 1996 16:54:35 +0000 (+0000)
Subject: 	* binutils.texi (nm): Improve documentation on symbol types.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=85d4b870660b4fd7dc52443fb9692afec834844c;p=binutils-gdb.git

	* binutils.texi (nm): Improve documentation on symbol types.
	(objdump): Reference the stabs manual from the discussion of the
	--stabs option.
---

diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index a3b9db2a4cb..6d6bbd9e8dd 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,3 +1,9 @@
+Fri Jan 26 11:53:42 1996  Ian Lance Taylor  <ian@cygnus.com>
+
+	* binutils.texi (nm): Improve documentation on symbol types.
+	(objdump): Reference the stabs manual from the discussion of the
+	--stabs option.
+
 Thu Jan 25 11:21:46 1996  Raymond Jou  <rjou@mexican.cygnus.com>
 
 	* mpw-make.sed: Add a "stamps" target.
diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index 3b857d21166..40a2cfe3d16 100644
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -604,25 +604,61 @@ local; if uppercase, the symbol is global (external).
 @c would be nice.
 @table @code
 @item A
-Absolute.
+The symbol's value is absolute, and will not be changed by further
+linking.
 
 @item B
-BSS (uninitialized data).
+The symbol is in the uninitialized data section (known as BSS).
 
 @item C
-Common.
+The symbol is common.  Common symbols are uninitialized data.  When
+linking, multiple common symbols may appear with the same name.  If the
+symbol is defined anywhere, the common symbols are treated as undefined
+references.  For more details on common symbols, see the discussion of
+--warn-common in @ref{Options,,Linker options,ld.info,The GNU linker}.
 
 @item D
-Initialized data.
+The symbol is in the initialized data section.
+
+@item G
+The symbol is in a initialized data section for small objects.  Some
+object file formats permit more efficient access to small data objects,
+such as a global int variable as opposed to a large global array.
 
 @item I
-Indirect reference.
+The symbol is an indirect reference to another symbol.  This is a GNU
+extension to the a.out object file format which is rarely used.
+
+@item N
+The symbol is a debugging symbol.
+
+@item R
+The symbol is in a read only data section.
+
+@item S
+The symbol is in a uninitialized data section for small objects.
 
 @item T
-Text (program code).
+The symbol is in the text (code) section.
 
 @item U
-Undefined.
+The symbol is undefined.
+
+@item W
+The symbol is weak.  When a weak defined symbol is linked with a normal
+defined symbol, the normal defined symbol is used with no error.  When a
+weak undefined symbol is linked and the symbol is not defined, the value
+of the weak symbol becomes zero with no error.
+
+@item -
+The symbol is a stabs symbol in an a.out object file.  In this case, the
+next values printed are the stabs other field, the stabs desc field, and
+the stab type.  Stabs symbols are used to hold debugging information;
+for more information, see @ref{Top,Stabs,Stabs Overview,stabs.info, The
+``stabs'' debug format}.
+
+@item ?
+The symbol type is unknown, or object file format specific.
 @end table
 
 @item
@@ -1128,7 +1164,8 @@ ELF file.  This is only useful on systems (such as Solaris 2.0) in which
 @code{.stab} debugging symbol-table entries are carried in an ELF
 section.  In most other file formats, debugging symbol-table entries are
 interleaved with linkage symbols, and are visible in the @samp{--syms}
-output.
+output.  For more information on stabs symbols, see @ref{Top,Stabs,Stabs
+Overview,stabs.info, The ``stabs'' debug format}.
 
 @item --start-address=@var{address}
 @cindex start-address