From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 13438 invoked by alias); 21 Sep 2004 21:08:20 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 13389 invoked from network); 21 Sep 2004 21:08:19 -0000 Received: from unknown (192.220.74.81) by sourceware.org with QMTP; 21 Sep 2004 21:08:19 -0000 Received: (qmail 85437 invoked by uid 19025); 21 Sep 2004 21:08:18 -0000 Date: Tue, 21 Sep 2004 21:08:00 -0000 From: Jason Molenda To: Eli Zaretskii Cc: gdb-patches@sources.redhat.com Subject: Re: COMMITTED/doc-patch stabs reader: Recognize language hint in SO stab Message-ID: <20040921140818.A84759@molenda.com> References: <4F2AF76A-E71B-11D8-B4BD-000A9569836A@apple.com> <7137-Fri06Aug2004115131+0300-eliz@gnu.org> <20040920122812.A43212@molenda.com> <01c49f8c$Blat.v2.2.2$f86dcdc0@zahav.net.il> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="+HP7ph2BbKc20aGI" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <01c49f8c$Blat.v2.2.2$f86dcdc0@zahav.net.il>; from eliz@gnu.org on Tue, Sep 21, 2004 at 06:41:05AM +0300 X-SW-Source: 2004-09/txt/msg00348.txt.bz2 --+HP7ph2BbKc20aGI Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 516 On Tue, Sep 21, 2004 at 06:41:05AM +0300, Eli Zaretskii wrote: > > Date: Mon, 20 Sep 2004 12:28:12 -0700 > > From: Jason Molenda > > Cc: gdb-patches@sources.redhat.com, jimb@redhat.com, kettenis@jive.nl, > > dpatel@apple.com > > > > So I'd like to get the documentation checked in to gdb, at least. > > Can you approve this? The patch goes through makeinfo and texi2html > > without any warnings; the generated HTML looks fine. > > Approved. Please commit this. Thanks, done. J --+HP7ph2BbKc20aGI Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="patch.txt" Content-length: 1716 2004-09-21 Jason Molenda (jmolenda@apple.com) * gdb.texinfo (Paths and Names of the Source Files): Document the meaning of values in the 'desc' field of a SO stab. Index: stabs.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/stabs.texinfo,v retrieving revision 1.15 diff -u -p -r1.15 stabs.texinfo --- stabs.texinfo 14 Jun 2004 22:26:34 -0000 1.15 +++ stabs.texinfo 21 Sep 2004 20:59:49 -0000 @@ -422,9 +422,33 @@ file. This information is contained in value of the symbol is the start address of the portion of the text section corresponding to that file. -With the Sun Solaris2 compiler, the desc field contains a -source-language code. -@c Do the debuggers use it? What are the codes? -djm +Some compilers use the desc field to indicate the language of the +source file. Sun's compilers started this usage, and the first +constants are derived from their documentation. Languages added +by gcc/gdb start at 0x32 to avoid conflict with languages Sun may +add in the future. A desc field with a value 0 indicates that no +language has been specified via this mechanism. + +@table @asis +@item @code{N_SO_AS} (0x1) +Assembly language +@item @code{N_SO_C} (0x2) +K&R traditional C +@item @code{N_SO_ANSI_C} (0x3) +ANSI C +@item @code{N_SO_CC} (0x4) +C++ +@item @code{N_SO_FORTRAN} (0x5) +Fortran +@item @code{N_SO_PASCAL} (0x6) +Pascal +@item @code{N_SO_FORTRAN90} (0x7) +Fortran90 +@item @code{N_SO_OBJC} (0x32) +Objective-C +@item @code{N_SO_OBJCPLUS} (0x33) +Objective-C++ +@end table Some compilers (for example, GCC2 and SunOS4 @file{/bin/cc}) also include the directory in which the source was compiled, in a second --+HP7ph2BbKc20aGI--