From: Ian Lance Taylor <ian@airs.com>
Date: Wed, 13 Dec 1995 17:36:52 +0000 (+0000)
Subject: 	* stabs.texinfo (Include Files): Document the values the SunOS4
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=120e5e89125b8d2622a724e1ebb5a863504cec69;p=binutils-gdb.git

	* stabs.texinfo (Include Files): Document the values the SunOS4
	linker creates for N_BINCL/N_EINCL/N_EXCL stabs.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index fe69725491d..bb669f66b73 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+Wed Dec 13 12:35:28 1995  Ian Lance Taylor  <ian@cygnus.com>
+
+	* stabs.texinfo (Include Files): Document the values the SunOS4
+	linker creates for N_BINCL/N_EINCL/N_EXCL stabs.
+
 Fri Dec  8 21:08:44 1995  Fred Fish  <fnf@cygnus.com>
 
 	* gdbint.texinfo (Releases): Change gdb.tar.Z to gdb.tar.gz.
diff --git a/gdb/doc/stabs.texinfo b/gdb/doc/stabs.texinfo
index ca01bb79d0b..07692726dcd 100644
--- a/gdb/doc/stabs.texinfo
+++ b/gdb/doc/stabs.texinfo
@@ -463,11 +463,10 @@ the start of this one.  To specify the main source file again, use an
 @findex N_EXCL
 The @code{N_BINCL} approach works as follows.  An @code{N_BINCL} symbol
 specifies the start of an include file.  In an object file, only the
-string is significant; the Sun linker puts data into some of the
-other fields.  The end of the include file is marked by an
-@code{N_EINCL} symbol (which has no string field).  In an object
-file, there is no significant data in the @code{N_EINCL} symbol; the Sun
-linker puts data into some of the fields.  @code{N_BINCL} and
+string is significant; the Sun linker puts data into some of the other
+fields.  The end of the include file is marked by an @code{N_EINCL}
+symbol (which has no string field).  In an object file, there is no
+significant data in the @code{N_EINCL} symbol.  @code{N_BINCL} and
 @code{N_EINCL} can be nested.
 
 If the linker detects that two source files have identical stabs between
@@ -476,7 +475,14 @@ for a header file), then it only puts out the stabs once.  Each
 additional occurance is replaced by an @code{N_EXCL} symbol.  I believe
 the Sun (SunOS4, not sure about Solaris) linker is the only one which
 supports this feature.
-@c What do the fields of N_EXCL contain? -djm
+
+The SunOS4 linker sets the value of a @code{N_BINCL} symbol to the total
+of all the characters in the stabs strings included in the header file,
+omitting the file number.  The value of an @code{N_EXCL} symbol is the
+same as the value of the @code{N_BINCL} symbol it replaces.  I do not
+know if this information is used by anything.  The @code{N_EINCL} value,
+and the values of the other and description fields for all three, appear
+to always be zero.
 
 @findex C_BINCL
 @findex C_EINCL