From 3f73b7c868651d5949f00995e65008ce1687e6c3 Mon Sep 17 00:00:00 2001 From: Jim Kingdon Date: Thu, 11 Nov 1993 19:58:00 +0000 Subject: [PATCH] * gdb.texinfo (C): In addition to saying people have to use g++ for good results, say they have to use stabs. Specifically say cfront doesn't work well. (Summary): Merge in information on Modula-2, Pascal, and Chill from the gdb README. Add xrefs to places where the support for the various languages is described in detail. --- gdb/doc/ChangeLog | 9 +++++++++ gdb/doc/gdb.texinfo | 26 ++++++++++++++++++++------ 2 files changed, 29 insertions(+), 6 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 2d868da2ee..2b1513d083 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,12 @@ +Thu Nov 11 13:26:45 1993 Jim Kingdon (kingdon@lioth.cygnus.com) + + * gdb.texinfo (C): In addition to saying people have to use g++ for + good results, say they have to use stabs. Specifically say cfront + doesn't work well. + (Summary): Merge in information on Modula-2, Pascal, and Chill from + the gdb README. Add xrefs to places where the support for the various + languages is described in detail. + Mon Nov 8 11:47:34 1993 Jim Kingdon (kingdon@lioth.cygnus.com) * stabs.texinfo: Clean up stuff about visibility and virtual diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index df5cc2a79b..49bd76af11 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -208,12 +208,21 @@ effects of one bug and go on to learn about another. @end itemize @ifclear CONLY -@ifclear MOD2 -You can use @value{GDBN} to debug programs written in C or C++. -@end ifclear +You can use @value{GDBN} to debug programs written in C or C++. For +more information, @xref{C}. + @ifset MOD2 -You can use @value{GDBN} to debug programs written in C, C++, and -Modula-2. +@c I use "MOD2" as a "miscellaneous languages" flag here. According to +@c a comment in all-cfg.texi, there should be separate flags for chill +@c and Pascal, but that seems kind of silly since we only mention them +@c in passing--IMHO the manual should be configurable as little as we +@c can get away with -kingdon. +Support for Modula-2 and Chill is partial. For information on Modula-2, +@xref{Modula-2}; there is no further documentation on Chill yet. + +Pascal programs which use sets, subranges, file variables, or nested +functions will not currently work. @value{GDBN} does not support +entering expressions, printing values, etc. using Pascal syntax. @end ifset @ifset FORTRAN @cindex Fortran @@ -5235,7 +5244,12 @@ together. The C++ debugging facilities are jointly implemented by the GNU C++ compiler and @value{GDBN}. Therefore, to debug your C++ code effectively, you must compile your C++ programs with the GNU C++ compiler, -@code{g++}. +@code{g++}. Also, you must be using the stabs debugging format; see the +documentation for the GNU C++ compiler for more information on how to +select that format. + +In particular, cfront based compilers such as Sun's C++ are not fully +supported. @end ifclear @ifset CONLY @node C