From 722b117b5a5a1b992e4f3f1a18b1840e5c4ac87b Mon Sep 17 00:00:00 2001 From: Toon Moene Date: Thu, 8 Nov 2001 01:07:58 +0100 Subject: [PATCH] Make-lang.in: Add rules for building g77.1. 2001-11-08 Toon Moene * Make-lang.in: Add rules for building g77.1. * invoke.texi: Add man page stuff. Move indexing from g77.texi to here. * g77.texi: Remove indexing specific to invoke.texi. * news.texi: Document that g77.1 is now a generated file. From-SVN: r46840 --- gcc/f/ChangeLog | 9 ++++ gcc/f/Make-lang.in | 27 ++++++++++-- gcc/f/g77.texi | 49 --------------------- gcc/f/invoke.texi | 105 +++++++++++++++++++++++++++++++++++++++++++++ gcc/f/news.texi | 12 +++--- 5 files changed, 144 insertions(+), 58 deletions(-) diff --git a/gcc/f/ChangeLog b/gcc/f/ChangeLog index cc346bd7b6b..7a683ba2eaf 100644 --- a/gcc/f/ChangeLog +++ b/gcc/f/ChangeLog @@ -1,3 +1,12 @@ +2001-11-08 Toon Moene + + * Make-lang.in: Add rules for building g77.1. + * invoke.texi: Add man page stuff. Move indexing + from g77.texi to here. + * g77.texi: Remove indexing specific to invoke.texi. + * news.texi: Document that g77.1 is now a generated + file. + Tue Nov 6 21:17:47 2001 Neil Booth * com.c: Include langhooks-def.h. diff --git a/gcc/f/Make-lang.in b/gcc/f/Make-lang.in index 464c75ed81d..6ea4635f4de 100644 --- a/gcc/f/Make-lang.in +++ b/gcc/f/Make-lang.in @@ -165,7 +165,9 @@ f77.all.cross: g77-cross$(exeext) f77.start.encap: g77$(exeext) f77.rest.encap: -f77.info: $(srcdir)/f/g77.info +# Note the kludge to get g77.1 to build. + +f77.info: $(srcdir)/f/g77.info f/g77.1 f77.dvi: f/g77.dvi # g77 documentation. @@ -199,6 +201,23 @@ f/g77.dvi: $(srcdir)/f/g77.texi $(srcdir)/f/bugs.texi \ cd f && $(TEXI2DVI) -I $$s/doc/include $$s/f/g77.texi; \ else true; fi +f/g77.1: $(srcdir)/f/g77.1 $(srcdir)/f/invoke.texi + case "$(LANGUAGES)" in \ + *[fF]77*) $(STAMP) lang-f77;; \ + *) rm -f lang-f77;; \ + esac + if [ -f lang-f77 ]; then \ + if [ x$(GENERATED_MANPAGES) = xgenerated-manpages ]; then \ + $(TEXI2POD) < $(srcdir)/f/invoke.texi > f/g77.pod; \ + ($(POD2MAN) f/g77.pod > f/g77.1.T$$$$ && \ + mv -f f/g77.1.T$$$$ f/g77.1) || \ + (rm -f f/g77.1.T$$$$ && exit 1); \ + rm -f f/g77.pod; \ + else \ + cp $(srcdir)/f/g77.1 f/g77.1; \ + fi; \ + else true; fi + # This dance is all about producing accurate documentation for g77's # intrinsics with minimum fuss. f/ansify appends "\n\" to C strings # so ANSI C compilers can compile f/intdoc.h -- gcc can compile f/intdoc.in @@ -321,7 +340,7 @@ f77.install-info: f77.info installdirs # Make sure `installdirs' target (from gcc Makefile) has been # run, since we use libsubdir to store our `flag' file, lang-f77. -f77.install-man: $(srcdir)/f/g77.1 installdirs +f77.install-man: f/g77.1 installdirs case "$(LANGUAGES)" in \ *[fF]77*) $(STAMP) $(libsubdir)/lang-f77.man;; \ *) rm -f $(libsubdir)/lang-f77.man;; \ @@ -329,11 +348,11 @@ f77.install-man: $(srcdir)/f/g77.1 installdirs -if [ -f $(libsubdir)/lang-f77.man -a -f f771$(exeext) ] ; then \ if [ -f g77-cross$(exeext) ] ; then \ rm -f $(man1dir)/$(G77_CROSS_NAME)$(manext); \ - $(INSTALL_DATA) $(srcdir)/f/g77.1 $(man1dir)/$(G77_CROSS_NAME)$(manext); \ + $(INSTALL_DATA) f/g77.1 $(man1dir)/$(G77_CROSS_NAME)$(manext); \ chmod a-x $(man1dir)/$(G77_CROSS_NAME)$(manext); \ else \ rm -f $(man1dir)/$(G77_INSTALL_NAME)$(manext); \ - $(INSTALL_DATA) $(srcdir)/f/g77.1 $(man1dir)/$(G77_INSTALL_NAME)$(manext); \ + $(INSTALL_DATA) f/g77.1 $(man1dir)/$(G77_INSTALL_NAME)$(manext); \ chmod a-x $(man1dir)/$(G77_INSTALL_NAME)$(manext); \ fi; \ else true; fi diff --git a/gcc/f/g77.texi b/gcc/f/g77.texi index 49a1516650b..6988a7d852a 100644 --- a/gcc/f/g77.texi +++ b/gcc/f/g77.texi @@ -840,55 +840,6 @@ Use the @samp{-v} option with @code{g77} to see what is going on---the first line of output is the invocation of the @code{gcc} command. -@node Invoking G77 -@chapter GNU Fortran Command Options -@cindex GNU Fortran command options -@cindex command options -@cindex options, GNU Fortran command - -The @code{g77} command supports all the options supported by the -@code{gcc} command. -@xref{Invoking GCC,,GNU CC Command Options,gcc,Using and Porting GNU CC}, -for information -on the non-Fortran-specific aspects of the @code{gcc} command (and, -therefore, the @code{g77} command). - -@cindex options, negative forms -@cindex negative forms of options -All @code{gcc} and @code{g77} options -are accepted both by @code{g77} and by @code{gcc} -(as well as any other drivers built at the same time, -such as @code{g++}), -since adding @code{g77} to the @code{gcc} distribution -enables acceptance of @code{g77}-specific options -by all of the relevant drivers. - -In some cases, options have positive and negative forms; -the negative form of @samp{-ffoo} would be @samp{-fno-foo}. -This manual documents only one of these two forms, whichever -one is not the default. - -@menu -* Option Summary:: Brief list of all @code{g77} options, - without explanations. -* Overall Options:: Controlling the kind of output: - an executable, object files, assembler files, - or preprocessed source. -* Shorthand Options:: Options that are shorthand for other options. -* Fortran Dialect Options:: Controlling the variant of Fortran language - compiled. -* Warning Options:: How picky should the compiler be? -* Debugging Options:: Symbol tables, measurements, and debugging dumps. -* Optimize Options:: How much optimization? -* Preprocessor Options:: Controlling header files and macro definitions. - Also, getting dependency information for Make. -* Directory Options:: Where to find header files and libraries. - Where to find the compiler executable files. -* Code Gen Options:: Specifying conventions for function calls, data layout - and register usage. -* Environment Variables:: Env vars that affect GNU Fortran. -@end menu - @include invoke.texi @include news.texi diff --git a/gcc/f/invoke.texi b/gcc/f/invoke.texi index 08febaafc6f..caae931ed5f 100644 --- a/gcc/f/invoke.texi +++ b/gcc/f/invoke.texi @@ -1,3 +1,108 @@ +@c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, +@c 2000, 2001 Free Software Foundation, Inc. +@c This is part of the G77 manual. +@c For copying conditions, see the file g77.texi. + +@ignore +@c man begin COPYRIGHT +Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, +1998, 1999, 2000, 2001 Free Software Foundation, Inc. + +Permission is granted to make and distribute verbatim copies of this +manual provided the copyright notice and this permission notice are +preserved on all copies. + +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided also that the +entire resulting derived work is distributed under the terms of a +permission notice identical to this one. + +Permission is granted to copy and distribute translations of this manual +into another language, under the above conditions for modified versions, +except that this permission notice may be included in translations +approved by the Free Software Foundation instead of in the original +English. +@c man end +@c Set file name and title for the man page. +@setfilename g77 +@settitle GNU project Fortran 77 compiler. +@c man begin SYNOPSIS +g77 [@option{-c}|@option{-S}|@option{-E}] [@option{-std=}@var{standard}] + [@option{-g}] [@option{-pg}] [@option{-O}@var{level}] + [@option{-W}@var{warn}@dots{}] [@option{-pedantic}] + [@option{-I}@var{dir}@dots{}] [@option{-L}@var{dir}@dots{}] + [@option{-D}@var{macro}[=@var{defn}]@dots{}] [@option{-U}@var{macro}] + [@option{-f}@var{option}@dots{}] [@option{-m}@var{machine-option}@dots{}] + [@option{-o} @var{outfile}] @var{infile}@dots{} + +Only the most useful options are listed here; see below for the +remainder. +@c man end +@c man begin SEEALSO +cpp(1), gcov(1), gcc(1), as(1), ld(1), gdb(1), adb(1), dbx(1), sdb(1) +and the Info entries for @file{gcc}, @file{cpp}, @file{g77}, @file{as}, +@file{ld}, @file{binutils} and @file{gdb}. +@c man end +@c man begin BUGS +For instructions on reporting bugs, see +@w{@uref{http://gcc.gnu.org/bugs.html}}. Use of the @command{gccbug} +script to report bugs is recommended. +@c man end +@c man begin AUTHOR +See the Info entry for @file{g77}, or +@w{@uref{http://gcc.gnu.org/thanks.html}}, for contributors to G77@. +@c man end +@end ignore + +@node Invoking G77 +@chapter GNU Fortran Command Options +@cindex GNU Fortran command options +@cindex command options +@cindex options, GNU Fortran command + +The @code{g77} command supports all the options supported by the +@code{gcc} command. +@xref{Invoking GCC,,GNU CC Command Options,gcc,Using and Porting GNU CC}, +for information +on the non-Fortran-specific aspects of the @code{gcc} command (and, +therefore, the @code{g77} command). + +@cindex options, negative forms +@cindex negative forms of options +All @code{gcc} and @code{g77} options +are accepted both by @code{g77} and by @code{gcc} +(as well as any other drivers built at the same time, +such as @code{g++}), +since adding @code{g77} to the @code{gcc} distribution +enables acceptance of @code{g77}-specific options +by all of the relevant drivers. + +In some cases, options have positive and negative forms; +the negative form of @samp{-ffoo} would be @samp{-fno-foo}. +This manual documents only one of these two forms, whichever +one is not the default. + +@menu +* Option Summary:: Brief list of all @code{g77} options, + without explanations. +* Overall Options:: Controlling the kind of output: + an executable, object files, assembler files, + or preprocessed source. +* Shorthand Options:: Options that are shorthand for other options. +* Fortran Dialect Options:: Controlling the variant of Fortran language + compiled. +* Warning Options:: How picky should the compiler be? +* Debugging Options:: Symbol tables, measurements, and debugging dumps. +* Optimize Options:: How much optimization? +* Preprocessor Options:: Controlling header files and macro definitions. + Also, getting dependency information for Make. +* Directory Options:: Where to find header files and libraries. + Where to find the compiler executable files. +* Code Gen Options:: Specifying conventions for function calls, data layout + and register usage. +* Environment Variables:: Env vars that affect GNU Fortran. +@end menu + @node Option Summary @section Option Summary diff --git a/gcc/f/news.texi b/gcc/f/news.texi index cd62b25340d..dca301ec194 100644 --- a/gcc/f/news.texi +++ b/gcc/f/news.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc. +@c Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001 Free Software Foundation, Inc. @c This is part of the G77 manual. @c For copying conditions, see the file g77.texi. @@ -9,7 +9,7 @@ @c in the standalone derivations of this file (e.g. NEWS). @set copyrights-news 1995,1996,1997,1998,1999,2000,2001 -@set last-update-news 2001-10-29 +@set last-update-news 2001-11-08 @include root.texi @@ -154,7 +154,10 @@ The following information was last updated on @value{last-update-news}: @heading In development, 0.5.27, @code{GCC} 3.1 versus @code{GCC} 3.0: @itemize @bullet -@ifclear USERVISONLY +@item +g77 now has its man page generated from the texinfo documentation, +to guarantee that it remains up to date. + @item g77 used to reject the following program on 32-bit targets: @smallexample @@ -174,7 +177,7 @@ because 140 000 000 reals is larger than the largest bit-extent that can be expressed in 32 bits. However, bit-sizes never play a role after offsets have been converted to byte addresses. Therefore this check has been removed. Note: On GNU/Linux systems one has to compile programs that occupy more -than 1 Gbyte statically, i.e.@: g77 -static ... +than 1 Gbyte statically, i.e.@: @code{g77 -static ...}. @item Based on work done by Juergen Pfeifer (@email{juergen.pfeifer@@gmx.net}) @@ -203,7 +206,6 @@ that permits the use of zero length substrings of the form Based on code developed by Pedro Vazquez (@email{vazquez@@penelope.iqm.unicamp.br}), the @code{libf2c} library is now able to read and write files larger than 2 Gbyte on 32-bit target machines, if the operating system supports this. -@end ifclear @end itemize @heading In 0.5.26, @code{GCC} 3.0 versus @code{GCC} 2.95: