This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
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