Re: COMMITTED/doc-patch stabs reader: Recognize language hint in SO stab

[Jason Molenda <jason-swarelist@molenda.com>]

[-- Attachment #1: Type: text/plain, Size: 516 bytes --]

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 <jason-swarelist@molenda.com>
> > 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

[-- Attachment #2: patch.txt --]
[-- Type: text/plain, Size: 1716 bytes --]

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