From: Jim Kingdon <jkingdon@engr.sgi.com>
Date: Mon, 12 Jul 1993 18:41:14 +0000 (+0000)
Subject: * stabs.texinfo: N_MAIN is sometimes used for C.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=499a5faaae215d4a9731b693cc9166238e09bcda;p=binutils-gdb.git

* stabs.texinfo: N_MAIN is sometimes used for C.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index e22b3ccdc7f..3e65a5f4f72 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,7 @@
+Mon Jul 12 13:37:02 1993  Jim Kingdon  (kingdon@lioth.cygnus.com)
+
+	* stabs.texinfo: N_MAIN is sometimes used for C.
+
 Fri Jul  9 09:47:02 1993  Peter Schauer  (pes@regent.e-technik.tu-muenchen.de)
 
 	* gdbint.texinfo (Host, Target Conditionals): Remove TM_FILE_OVERRIDE.
diff --git a/gdb/doc/stabs.texinfo b/gdb/doc/stabs.texinfo
index ff1a6c69607..acba1cc8fca 100644
--- a/gdb/doc/stabs.texinfo
+++ b/gdb/doc/stabs.texinfo
@@ -357,12 +357,24 @@ types used to describe C language source files.
 @chapter Encoding for the structure of the program
 
 @menu
+* Main Program::		Indicate what the main program is
 * Source Files::		The path and name of the source file
 * Line Numbers::		
 * Procedures::			
 * Block Structure::		
 @end menu
 
+@node Main Program
+@section Main Program
+
+Most languages allow the main program to have any name.  The
+@code{N_MAIN} stab type is used for a stab telling the debugger what
+name is used in this program.  Only the name is significant; it will be
+the name of a function which is the main program.  Most C compilers do
+not use this stab; they expect the debugger to simply assume that the
+name is @samp{main}, but some C compilers emit an @code{N_MAIN} stab for
+the @samp{main} function.
+
 @node Source Files
 @section The path and name of the source files
 
@@ -3022,8 +3034,8 @@ Static symbol (data segment variable with internal linkage), @xref{N_STSYM}.
 @item 0x28     N_LCSYM   
 .lcomm symbol (BSS segment variable with internal linkage), @xref{N_LCSYM}.
 
-@item 0x2a     N_MAIN    
-Name of main routine (not used in C), @xref{N_MAIN}.
+@item 0x2a N_MAIN    
+Name of main routine, @xref{Main Program}.
 
 @c FIXME: discuss this in the main body of the text where we talk about
 @c using N_FUN for variables.
@@ -3419,7 +3431,6 @@ Finally, any further information.
 * N_FUN::			C Function name or text segment variable
 * N_STSYM::			Initialized static symbol
 * N_LCSYM::			Uninitialized static symbol
-* N_MAIN::			Name of main routine (not for C)
 * N_PC::			Pascal global symbol
 * N_NSYMS::			Number of symbols
 * N_NOMAP::			No DST map
@@ -3517,18 +3528,6 @@ Unitialized static (.lcomm) symbol(BSS segment w/internal linkage).
 value  -> BSS Address
 @end example
 
-@node N_MAIN
-@section 42 - 0x2a - N_MAIN       
-Name of main routine (not used in C)
-
-@display
-.stabs "name", N_MAIN, NIL, NIL, NIL
-@end display
-
-@example
-"name" -> "name_of_main_routine"  
-@end example
-
 @node N_PC
 @section 48 - 0x30 - N_PC               
 Global symbol (for Pascal)