aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorJim Kingdon <jkingdon@engr.sgi.com>1993-07-12 18:41:14 +0000
committerJim Kingdon <jkingdon@engr.sgi.com>1993-07-12 18:41:14 +0000
commit499a5faaae215d4a9731b693cc9166238e09bcda (patch)
tree9e21ac5fe82f7eda09b4a8e236e785430325575e /gdb
parent1326dacef924696d3969b43f152b39443b728c43 (diff)
downloadgdb-499a5faaae215d4a9731b693cc9166238e09bcda.zip
gdb-499a5faaae215d4a9731b693cc9166238e09bcda.tar.gz
gdb-499a5faaae215d4a9731b693cc9166238e09bcda.tar.bz2
* stabs.texinfo: N_MAIN is sometimes used for C.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/ChangeLog4
-rw-r--r--gdb/doc/stabs.texinfo29
2 files changed, 18 insertions, 15 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index e22b3cc..3e65a5f 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 ff1a6c6..acba1cc 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)