From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 27122 invoked by alias); 23 Nov 2005 02:56:08 -0000 Received: (qmail 27115 invoked by uid 22791); 23 Nov 2005 02:56:08 -0000 X-Spam-Check-By: sourceware.org Received: from ausmtp04.au.ibm.com (HELO ausmtp04) (202.81.18.152) by sourceware.org (qpsmtpd/0.31) with ESMTP; Wed, 23 Nov 2005 02:56:07 +0000 Received: from sd0208e0.au.ibm.com (d23rh904.au.ibm.com [202.81.18.202]) by ausmtp04 (8.12.10/8.12.10) with ESMTP id jAN2tg9A097320 for ; Wed, 23 Nov 2005 13:55:42 +1100 Received: from d23av01.au.ibm.com (d23av01.au.ibm.com [9.190.250.242]) by sd0208e0.au.ibm.com (8.12.10/NCO/VERS6.8) with ESMTP id jAN2wndB220448 for ; Wed, 23 Nov 2005 13:58:50 +1100 Received: from d23av01.au.ibm.com (loopback [127.0.0.1]) by d23av01.au.ibm.com (8.12.11/8.13.3) with ESMTP id jAN2tlMl009235 for ; Wed, 23 Nov 2005 13:55:47 +1100 Received: from [9.181.133.252] ([9.181.133.252]) by d23av01.au.ibm.com (8.12.11/8.12.11) with ESMTP id jAN2tf0j009077; Wed, 23 Nov 2005 13:55:44 +1100 Date: Wed, 23 Nov 2005 13:55:00 -0000 From: Wu Zhou To: Eli Zaretskii cc: gdb-patches@sources.redhat.com Subject: Re: [RFC/Doc]: Some words about Fortran debugging In-Reply-To: Message-ID: References: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2005-11/txt/msg00428.txt.bz2 On Tue, 22 Nov 2005, Eli Zaretskii wrote: > > Could I check in this patch into gdb_6_4 branch as well. > > Yes, please do. Checked in. Thanks. Appended is the cvs diff. 2005-11-23 Wu Zhou * gdb.texinfo (Fortran): Add some words about Fortran debugging. Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.282.2.3 diff -u -p -r1.282.2.3 gdb.texinfo --- gdb.texinfo 16 Nov 2005 12:44:11 -0000 1.282.2.3 +++ gdb.texinfo 23 Nov 2005 02:29:12 -0000 @@ -9124,6 +9124,59 @@ function, @code{_NSPrintForDebugger}, de @subsection Fortran @cindex Fortran-specific support in @value{GDBN} +@value{GDBN} can be used to debug programs written in Fortran, but it +currently supports only the features of Fortran 77 language. + +@cindex trailing underscore, in Fortran symbols +Some Fortran compilers (@sc{gnu} Fortran 77 and Fortran 95 compilers +among them) append an underscore to the names of variables and +functions. When you debug programs compiled by those compilers, you +will need to refer to variables and functions with a trailing +underscore. + +@menu +* Fortran Operators:: Fortran operators and expressions +* Fortran Defaults:: Default settings for Fortran +* Special Fortran commands:: Special @value{GDBN} commands for Fortran +@end menu + +@node Fortran Operators +@subsubsection Fortran operators and expressions + +@cindex Fortran operators and expressions + +Operators must be defined on values of specific types. For instance, +@code{+} is defined on numbers, but not on characters or other non- +arithmetic types. Operators are often defined on groups of types. + +@table @code +@item ** +The exponentiation operator. It raises the first operand to the power +of the second one. + +@item : +The range operator. Normally used in the form of array(low:high) to +represent a section of array. +@end table + +@node Fortran Defaults +@subsubsection Fortran Defaults + +@cindex Fortran Defaults + +Fortran symbols are usually case-insensitive, so @value{GDBN} by +default uses case-insensitive matches for Fortran symbols. You can +change that with the @samp{set case-insensitive} command, see +@ref{Symbols}, for the details. + +@node Special Fortran commands +@subsubsection Special Fortran commands + +@cindex Special Fortran commands + +@value{GDBN} had some commands to support Fortran specific feature, +such as common block displaying. + @table @code @cindex @code{COMMON} blocks, Fortran @kindex info common @@ -9134,11 +9187,6 @@ all @code{COMMON} blocks visible at curr printed. @end table -Fortran symbols are usually case-insensitive, so @value{GDBN} by -default uses case-insensitive matches for Fortran symbols. You can -change that with the @samp{set case-insensitive} command, see -@ref{Symbols}, for the details. - @node Pascal @subsection Pascal Regards - Wu Zhou