From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 21539 invoked by alias); 9 Nov 2005 08:37:55 -0000 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 Received: (qmail 21512 invoked by uid 22791); 9 Nov 2005 08:37:52 -0000 Received: from ausmtp02.au.ibm.com (HELO ausmtp02.au.ibm.com) (202.81.18.187) by sourceware.org (qpsmtpd/0.30-dev) with ESMTP; Wed, 09 Nov 2005 08:37:52 +0000 Received: from sd0208e0.au.ibm.com (d23rh904.au.ibm.com [202.81.18.202]) by ausmtp02.au.ibm.com (8.12.10/8.12.10) with ESMTP id jA98Vdxa077206 for ; Wed, 9 Nov 2005 19:31:44 +1100 Received: from d23av03.au.ibm.com (d23av03.au.ibm.com [9.190.250.244]) by sd0208e0.au.ibm.com (8.12.10/NCO/VERS6.7) with ESMTP id jA98eZGY170410 for ; Wed, 9 Nov 2005 19:40:36 +1100 Received: from d23av03.au.ibm.com (loopback [127.0.0.1]) by d23av03.au.ibm.com (8.12.11/8.13.3) with ESMTP id jA98bXxc018133 for ; Wed, 9 Nov 2005 19:37:33 +1100 Received: from [9.181.133.252] ([9.181.133.252]) by d23av03.au.ibm.com (8.12.11/8.12.11) with ESMTP id jA98bVQU018037; Wed, 9 Nov 2005 19:37:31 +1100 Date: Wed, 09 Nov 2005 17:41: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-SW-Source: 2005-11/txt/msg00108.txt.bz2 Hi Eli, Thanks for your comment. I got some more understanding about the documenting mechnism now. On Tue, 8 Nov 2005, Eli Zaretskii wrote: > > Do I need to do anything other to verify that? > > It's preferable to also "make dvi". > It seems that it need tetex and te_latex. Would you please tell me where I can get these packages? I found that none of FC4, RHEL and SLES include these package. > I'd remove most of this text, leaving just this: > > @value{GDBN} can be used to debug programs written in Fortran, but it > currently supports only the features of the Fortran 77 language. > > (The manual is not the place to tell users we are improving GDB. > Reading that doesn't help them if they need those unimplemented > features now.) Okay, I will adopt most of what you said. But what about replace the word "only" with "mainly", because there is a little support for F95 already in current GDB. Here goes the revised patch. I checked it with "make info". No obvious problem is found. Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.284 diff -c -3 -p -r1.284 gdb.texinfo *** gdb.texinfo 7 Nov 2005 13:56:48 -0000 1.284 --- gdb.texinfo 9 Nov 2005 08:24:00 -0000 *************** function, @code{_NSPrintForDebugger}, de *** 9124,9129 **** --- 9124,9182 ---- @subsection Fortran @cindex Fortran-specific support in @value{GDBN} + @value{GDBN} can be used to debug programs written in Fortran, but it + currently supports mainly 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 structures. 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 *************** all @code{COMMON} blocks visible at curr *** 9134,9144 **** 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 --- 9187,9192 ---- Regards - Wu Zhou