This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [RFC/Doc]: Some words about Fortran debugging


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]