* stabs.texinfo (Source Files): Document N_SO used to mark the end

	of a source file.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 24d28fd12bb0b74b033c941542fd922e8c7e2c1f..e5aa67aa088dfba004d5f315d18881f912a22485 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+Wed Feb  1 20:26:36 1995  Jim Kingdon  (kingdon@lioth.cygnus.com)
+
+       * stabs.texinfo (Source Files): Document N_SO used to mark the end
+       of a source file.
+
 Mon Jan 23 14:23:37 1995  Jim Kingdon  (kingdon@lioth.cygnus.com)
 
        * gdb.texinfo (Processes): New node.

diff --git a/gdb/doc/stabs.texinfo b/gdb/doc/stabs.texinfo
index 24f7149a108ec81ead7a6fdddc803146b4c6dee8..62e13a73c36467686e62b7d519de368ecd929882 100644 (file)
--- a/gdb/doc/stabs.texinfo
+++ b/gdb/doc/stabs.texinfo
@@ -435,6 +435,15 @@ Instead of @code{N_SO} symbols, XCOFF uses a @code{.file} assembler
 directive which assembles to a standard COFF @code{.file} symbol;
 explaining this in detail is outside the scope of this document.
 
+@c FIXME: Exactly when should the empty N_SO be used?  Why?
+If it is useful to indicate the end of a source file, this is done with
+an @code{N_SO} symbol with an empty string for the name.  The value is
+the address of the end of the text section for the file.  For some
+systems, there is no indication of the end of a source file, and you
+just need to figure it ended when you see an @code{N_SO} for a different
+source file, or a symbol ending in @code{.o} (which at least some
+linkers insert to mark the start of a new @code{.o} file).
+
 @node Include Files
 @section Names of Include Files