From: Jim Kingdon <jkingdon@engr.sgi.com>
Date: Wed, 16 Mar 1994 18:52:45 +0000 (+0000)
Subject: 	* stabs.texinfo (Alternate Entry Points): New node, rewritten from
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=6d244da7a16f4dcfe559d7727d63baf8f60c1b15;p=binutils-gdb.git

	* stabs.texinfo (Alternate Entry Points): New node, rewritten from
	N_ENTRY node.

	* stabs.texinfo (Type Descriptors): Add 'Y' type descriptor.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 21de3a663e7..44b9470ba53 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,8 @@
 Wed Mar 16 08:20:19 1994  Jim Kingdon  (kingdon@lioth.cygnus.com)
 
+	* stabs.texinfo (Alternate Entry Points): New node, rewritten from
+	N_ENTRY node.
+
 	* stabs.texinfo (Type Descriptors): Add 'Y' type descriptor.
 
 Tue Mar 15 08:43:02 1994  Jim Kingdon  (kingdon@lioth.cygnus.com)
diff --git a/gdb/doc/stabs.texinfo b/gdb/doc/stabs.texinfo
index ffad6791147..9fe48a93881 100644
--- a/gdb/doc/stabs.texinfo
+++ b/gdb/doc/stabs.texinfo
@@ -385,6 +385,7 @@ blocks of code.
 * Procedures::
 * Nested Procedures::
 * Block Structure::
+* Alternate Entry Points::      Entering procedures except at the beginning.
 @end menu
 
 @node Main Program
@@ -680,6 +681,19 @@ Sun documents the desc field of @code{N_LBRAC} and
 However, dbx seems to not care, and GCC always sets desc to
 zero.
 
+@node Alternate Entry Points
+@section Alternate Entry Points
+
+Some languages, like Fortran, have the ability to enter procedures at
+some place other than the beginning.  One can declare an alternate entry
+point.  The @code{N_ENTRY} stab is for this; however, the Sun FORTRAN compiler
+doesn't use it.  According to AIX documentation, only the name of a
+@code{C_ENTRY} stab is significant; the address of the alternate entry
+point comes from the corresponding external symbol.  A previous revision
+of this document said that the value of an @code{N_ENTRY} stab was the
+address of the alternate entry point, but I don't know the source for
+that information.
+
 @node Constants
 @chapter Constants
 
@@ -3189,7 +3203,7 @@ Parameter variable; see @ref{Parameters}.
 End of an include file; see @ref{Include Files}.
 
 @item 0xa4     N_ENTRY
-Alternate entry point; see @ref{N_ENTRY}.
+Alternate entry point; see @ref{Alternate Entry Points}.
 
 @item 0xc0     N_LBRAC
 Beginning of a lexical block; see @ref{Block Structure}.
@@ -3527,7 +3541,6 @@ Finally, any further information.
 * N_MOD2::			Modula2 information "for imc"
 * N_CATCH::			GNU C++ "catch" clause
 * N_SSYM::			Structure or union element
-* N_ENTRY::			Alternate entry point
 * N_SCOPE::			Modula2 scope information (Sun only)
 * Gould::			non-base register symbols used on Gould systems
 * N_LENG::			Length of preceding entry
@@ -3671,16 +3684,6 @@ The value is the offset in the structure.
 <<?looking at structs and unions in C I didn't see these>>
 @end deffn
 
-@node N_ENTRY
-@section N_ENTRY
-
-@deffn @code{.stabn} N_ENTRY
-@findex N_ENTRY
-Alternate entry point.
-The value is its address.
-<<?>>
-@end deffn
-
 @node N_SCOPE
 @section N_SCOPE