From: Jim Kingdon <jkingdon@engr.sgi.com>
Date: Tue, 12 Oct 1993 19:03:38 +0000 (+0000)
Subject: * stabs.texinfo (Common Blocks): Minor cleanups.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=05238df4e27e616554f2039d97647ef68b2dd99d;p=binutils-gdb.git

* stabs.texinfo (Common Blocks): Minor cleanups.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 9adbe654b58..2915535f1e0 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,7 @@
 Tue Oct 12 09:11:45 1993  Jim Kingdon  (kingdon@lioth.cygnus.com)
 
+	* stabs.texinfo (Common Blocks): Minor cleanups.
+
 	* stabs.texinfo: Update ld stabs in elf relocation to reflect the fact
 	that Sun has backed away from the linker kludge and thus the relevant
 	issue is changes to the SunPRO tools, not the Solaris linker.
diff --git a/gdb/doc/stabs.texinfo b/gdb/doc/stabs.texinfo
index 2fa12e39fe7..fcb1327c250 100644
--- a/gdb/doc/stabs.texinfo
+++ b/gdb/doc/stabs.texinfo
@@ -858,20 +858,26 @@ I believe Fortran is the only language with this feature.
 
 @findex N_BCOMM
 @findex N_ECOMM
+@findex C_BCOMM
+@findex C_ECOMM
 A @code{N_BCOMM} stab begins a common block and an @code{N_ECOMM} stab
 ends it.  The only field that is significant in these two stabs is the
 string, which names a normal (non-debugging) symbol that gives the
-address of the common block.
+address of the common block.  According to IBM documentation, only the
+@code{N_BCOMM} has the name of the common block (even though their
+compiler actually puts it both places).
 
 @findex N_ECOML
-Each stab between the @code{N_BCOMM} and the @code{N_ECOMM} specifies a
-member of that common block; its value is the offset within the
-common block of that variable.  The @code{N_ECOML} stab type is
-documented for this purpose, but Sun's Fortran compiler uses
-@code{N_GSYM} instead.  The test case I looked at had a common block
-local to a function and it used the @samp{V} symbol descriptor; I assume
-one would use @samp{S} if not local to a function (that is, if a common
-block @emph{can} be anything other than local to a function).
+@findex C_ECOML
+The stabs for the members of the common block are between the
+@code{N_BCOMM} and the @code{N_ECOMM}; the value of each stab is the
+offset within the common block of that variable.  IBM uses the
+@code{C_ECOML} stab type, and there is a corresponding @code{N_ECOML}
+stab type, but Sun's Fortran compiler uses @code{N_GSYM} instead.  The
+variables within a common block use the @samp{V} symbol descriptor (I
+believe this is true of all Fortran variables).  Other stabs (at least
+type declarations using @code{C_DECL}) can also be between the
+@code{N_BCOMM} and the @code{N_ECOMM}.
 
 @node Statics
 @section Static Variables