From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3074 invoked by alias); 20 Sep 2004 19:28:13 -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 2969 invoked from network); 20 Sep 2004 19:28:12 -0000 Received: from unknown (192.220.74.81) by sourceware.org with QMTP; 20 Sep 2004 19:28:12 -0000 Received: (qmail 46550 invoked by uid 19025); 20 Sep 2004 19:28:12 -0000 Date: Mon, 20 Sep 2004 19:28:00 -0000 From: Jason Molenda To: Eli Zaretskii Cc: gdb-patches@sources.redhat.com, jimb@redhat.com, kettenis@jive.nl, dpatel@apple.com Subject: Re: RFA/doc-patch stabs reader: Recognize language hint in SO stab Message-ID: <20040920122812.A43212@molenda.com> References: <4F2AF76A-E71B-11D8-B4BD-000A9569836A@apple.com> <7137-Fri06Aug2004115131+0300-eliz@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="sdtB3X0nJg68CQEu" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <7137-Fri06Aug2004115131+0300-eliz@gnu.org>; from eliz@gnu.org on Fri, Aug 06, 2004 at 11:51:32AM +0300 X-SW-Source: 2004-09/txt/msg00320.txt.bz2 --sdtB3X0nJg68CQEu Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 1335 On Fri, Aug 06, 2004 at 11:51:32AM +0300, Eli Zaretskii wrote: > > From: Jason Molenda > > Date: Thu, 5 Aug 2004 13:09:08 -0700 > > > > Eli, I added a table documenting these values to stabs.texinfo. Do you > > think this is a correct use of a texinfo table? [...] > Therefore, if the indentation and the general formatting of @table is > okay with you, I think the following will look better: > > +@table @asis > +@item @code{N_SO_AS} (0x1) > +Assembly language > > etc., you get the point. Thanks for the feedback, Eli. Attached is an updated patch to the documentation. The FSF has just accepted the generation of this code, the original patch posted here: http://gcc.gnu.org/ml/gcc-patches/2004-08/msg00917.html And approved here: http://gcc.gnu.org/ml/gcc-patches/2004-09/msg01572.html 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. Thanks. Jason (sending from my molenda.com acct instead of apple.com because of irrelevant/uninteresting technical difficulties.) 2004-09-20 Jason Molenda (jason-cl@molenda.com) * stabs.texinfo (Paths and Names of the Source Files): Document the meaning of values in the 'desc' field of a SO stab. --sdtB3X0nJg68CQEu Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="pa.txt" Content-length: 1532 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 20 Sep 2004 19:21:10 -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 --sdtB3X0nJg68CQEu--