gfortran manual patch
Joseph S. Myers
jsm@polyomino.org.uk
Thu May 13 12:41:00 GMT 2004
This patch fixes the gfortran manual dvi generation. It also removes a
"set DEVELOPMENT" that appears on the title page (gcc-common.texi provides
an @set DEVELOPMENT for all manuals) and an obsolete section about
compiling gfortran which had an excessively overfull hbox. It passes
"make info" and dvi generation. Applied to mainline.
Note: the gfortran doc build/install code in fortran/Make-lang.in hasn't
been updated for various mainline changes to those interfaces; as a
side-effect, "make dvi" still does not build the gfortran manual. The
current interfaces should be documented in sourcebuild.texi, or look at
other language Make-lang.in files for examples. In particular,
generated-manpages has changed, dvi is now a double-colon rule and front
ends shouldn't need their own rules to install info files.
Problems with the manual not fixed by this patch:
gfortran should not have its own version number; other parts of the
compiler use the common GCC one; g77 got rid of its own version number
long ago. The version number (with a different value) is defined also as
GFC_VERSION in gfortran.h, though I don't see this used for anything.
Contrary to the claim in the manual, it does not document how to report
bugs; nor should it as that is documented in bugs.html.
The whole "Compiling and Testing" chapter should go away; binaries have a
place to document them in install.texi, as do prerequisites such as GMP.
Index: ChangeLog
===================================================================
RCS file: /cvs/gcc/gcc/gcc/fortran/ChangeLog,v
retrieving revision 1.2
diff -u -r1.2 ChangeLog
--- ChangeLog 13 May 2004 06:40:29 -0000 1.2
+++ ChangeLog 13 May 2004 12:29:21 -0000
@@ -1,3 +1,9 @@
+2004-05-13 Joseph S. Myers <jsm@polyomino.org.uk>
+
+ * gfortran.texi: Use @table @emph instead of @itemize @emph.
+ Remove "set DEVELOPMENT".
+ (Compiling GFORTRAN): Remove.
+
2004-05-09 Tobias Schlüter <tobias.schlueter@physik.uni-muenchen.de>
* array.c (match_subscript, match_array_ref): Add comments
Index: gfortran.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/fortran/gfortran.texi,v
retrieving revision 1.2
diff -u -r1.2 gfortran.texi
--- gfortran.texi 13 May 2004 06:40:30 -0000 1.2
+++ gfortran.texi 13 May 2004 12:29:21 -0000
@@ -1,17 +1,12 @@
\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename gfortran.info
-@set last-update March 10, 2004
+@set last-update 13 May 2004
@set copyrights-gfortran 1999-2004
@set version-gfortran 0.235
@include gcc-common.texi
-@c This indicates that this documentation is still under development.
-@c For example, if this option is set, overfull boxes are marked with
-@c an ugly black square.
-set DEVELOPMENT
-
@settitle The GNU Fortran 95 Compiler
@c Create a separate index for command line options
@@ -398,7 +393,6 @@
@menu
* Precompiled Binaries::
* General notes about compiling GFORTRAN::
-* Compiling GFORTRAN::
* Testing::
@end menu
@@ -426,29 +420,6 @@
Note: GMP is only required for the compiler itself. Compiled fortran programs
do not depend on the GMP library.
-@node Compiling GFORTRAN
-@section Compiling GFORTRAN
-@cindex Make-lang.in
-
-To build gfortran, you first need to get a copy of the GCC source tree.
-gfortran uses the new @dfn{GENERIC} intermediate representation
-to communicate with the back end.
-This new IR has not been merged yet with the GCC mainline,
-so you'll need to get a snapshot of the
-@emph{tree-ssa-20020619-branch} from the GCC CVS repository.
-This branch also contains the latest version
-You can check out this branch from the GNU Subversions server:
-
-@example
-$ export CVS_RSH=ssh
-$ cvs -z9 -d :ext:anoncvs@@subversions.gnu.org:/cvsroot/gcc co -r tree-ssa-20020619-branch gcc
-@end example
-
-You can now build GCC following the instructions on the
-@uref{htpp://gcc.gnu.org/,GCC homepage},
-(configure with @option{--enable-languages=f95}).
-
-
@node Testing
@section Testing
@cindex Test suite
@@ -502,7 +473,7 @@
@node Compiler Status
@section Compiler Status
-@itemize @emph
+@table @emph
@item Front end
This is the part of gfortran which parses a source file, verifies that it
is valid Fortran 95, performs compile time replacement of constants
@@ -518,7 +489,7 @@
front end and translate it to the GENERIC form required by the GCC back
end. Work is ongoing in these parts of gfortran, but a large part has
already been completed.
-@end itemize
+@end table
@node Library Status
@section Library Status
--
Joseph S. Myers
jsm@polyomino.org.uk
More information about the Fortran
mailing list