From dc637ad798886a7f16ded45ac77492773a8eb05f Mon Sep 17 00:00:00 2001 From: Toon Moene Date: Wed, 14 Nov 2001 01:16:47 +0100 Subject: [PATCH] g77.1: Remove from CVS. 2001-11-14 Toon Moene * g77.1: Remove from CVS. * Make-lang.in: Build g77.1 in $(srcdir). Add --section=1 to POD2MAN command line. * invoke.texi: Correct copyright years. Add more sections to man page. Add GFDL. From-SVN: r46996 --- gcc/f/ChangeLog | 8 + gcc/f/Make-lang.in | 16 +- gcc/f/g77.1 | 365 --------------------------------------------- gcc/f/invoke.texi | 58 ++++--- 4 files changed, 54 insertions(+), 393 deletions(-) delete mode 100644 gcc/f/g77.1 diff --git a/gcc/f/ChangeLog b/gcc/f/ChangeLog index d1b4d7578c7..07e2cfd3fb1 100644 --- a/gcc/f/ChangeLog +++ b/gcc/f/ChangeLog @@ -1,3 +1,11 @@ +2001-11-14 Toon Moene + + * g77.1: Remove from CVS. + * Make-lang.in: Build g77.1 in $(srcdir). + Add --section=1 to POD2MAN command line. + * invoke.texi: Correct copyright years. + Add more sections to man page. Add GFDL. + Fri Nov 9 23:16:45 2001 Neil Booth * com.c (ffe_print_identifier): Rename. diff --git a/gcc/f/Make-lang.in b/gcc/f/Make-lang.in index 9597cf56a7b..a3596d65a92 100644 --- a/gcc/f/Make-lang.in +++ b/gcc/f/Make-lang.in @@ -201,7 +201,7 @@ 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 +$(srcdir)/f/g77.1: $(srcdir)/f/invoke.texi case "$(LANGUAGES)" in \ *[fF]77*) $(STAMP) lang-f77;; \ *) rm -f lang-f77;; \ @@ -209,13 +209,11 @@ f/g77.1: $(srcdir)/f/g77.1 $(srcdir)/f/invoke.texi 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) || \ + ($(POD2MAN) --section=1 f/g77.pod > f/g77.1.T$$$$ && \ + mv -f f/g77.1.T$$$$ $(srcdir)/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; \ else true; fi # This dance is all about producing accurate documentation for g77's @@ -340,7 +338,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: f/g77.1 installdirs +f77.install-man: $(srcdir)/f/g77.1 installdirs case "$(LANGUAGES)" in \ *[fF]77*) $(STAMP) $(libsubdir)/lang-f77.man;; \ *) rm -f $(libsubdir)/lang-f77.man;; \ @@ -348,11 +346,11 @@ f77.install-man: 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) f/g77.1 $(man1dir)/$(G77_CROSS_NAME)$(manext); \ + $(INSTALL_DATA) $(srcdir)/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) f/g77.1 $(man1dir)/$(G77_INSTALL_NAME)$(manext); \ + $(INSTALL_DATA) $(srcdir)/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.1 b/gcc/f/g77.1 deleted file mode 100644 index 88eb6762d99..00000000000 --- a/gcc/f/g77.1 +++ /dev/null @@ -1,365 +0,0 @@ -.\" Copyright (c) 1995, 1996, 1997, Free Software Foundation -*-Text-*- -.\" See section COPYING for conditions for redistribution -.\" FIXME: no info here on predefines. Should there be? extra for F77... -.TH G77 1 "1999-02-14" "GNU Tools" "GNU Tools" -.de BP -.sp -.ti \-.2i -\(** -.. -.SH NAME -g77 \- GNU project Fortran Compiler (v0.5.24) -.SH SYNOPSIS -.RB g77 " [" \c -.IR option " | " "filename " ].\|.\|. -.SH WARNING -The information in this man page is an extract from the full -documentation of the GNU Fortran compiler (version 0.5.24), -and is limited to the meaning of some of the options. -.PP -This man page is not up to date, since no volunteers want to -maintain it. If you find a discrepancy between the man page and the -software, please check the Info file, which is the authoritative -documentation. -.\" .PP -.\" The version of GNU Fortran documented by the Info file is 0.5.24, -.\" which includes substantial improvements and changes since 0.5.24, -.\" the version documented in this man page. -.PP -If we find that the things in this man page that are out of date cause -significant confusion or complaints, we will stop distributing the man -page. The alternative, updating the man page when we update the Info -file, is impractical because the rest of the work of maintaining GNU Fortran -leaves us no time for that. The GNU project regards man pages as -obsolete and should not let them take time away from other things. -.PP -For complete and current documentation, refer to the Info file `\|\c -.B g77\c -\&\|' or the manual -.I -Using and Porting GNU Fortran (for version 0.5.24)\c -\&. Both are made from the Texinfo source file -.BR g77.texi . -.PP -If your system has the `\|\c -.B info\c -\&\|' command installed, the command `\|\c -.B info g77\c -\&\|' should work, unless -.B g77 -has not been properly installed. -If your system lacks `\|\c -.B info\c -\&\|', or you wish to avoid using it for now, -the command `\|\c -.B more /usr/info/g77.info*\c -\&\|' should work, unless -.B g77 -has not been properly installed. -.PP -If -.B g77 -has not been properly installed, so that you -cannot easily access the Info file for it, -ask your system administrator, or the installer -of -.B g77 -(if you know who that is) to fix the problem. -.SH DESCRIPTION -The C and F77 compilers are integrated; -.B g77 -is a program to call -.B gcc -with options to recognize programs written in Fortran (ANSI FORTRAN 77, -also called F77). -.B gcc -processes input files -through one or more of four stages: preprocessing, compilation, -assembly, and linking. This man page contains full descriptions for -.I only -F77-specific aspects of the compiler, though it also contains -summaries of some general-purpose options. For a fuller explanation -of the compiler, see -.BR gcc ( 1 ). - -For complete documentation on GNU Fortran, type `\|\c -.B info g77\c -\&\|'. - -F77 source files use the suffix `\|\c -.B .f\c -\&\|', `\|\c -.B .for\c -\&\|', or `\|\c -.B .FOR\c -\&\|'; F77 files to be preprocessed by -.BR cpp ( 1 ) -use the suffix `\|\c -.B .F\c -\&\|', `\|\c -.B .fpp\c -\&\|', or `\|\c -.B .FPP\c -\&\|'; Ratfor source files use the suffix `\|\c -.B .r\c -\&\|' (though -.B ratfor -itself is not supplied as part of -.B g77\c -\&). -.SH OPTIONS -There are many command-line options, including options to control -details of optimization, warnings, and code generation, which are -common to both -.B gcc -and -.B g77\c -\&. For full information on all options, see -.BR gcc ( 1 ). - -Options must be separate: `\|\c -.B \-dr\c -\&\|' is quite different from `\|\c -.B \-d \-r -\&\|'. - -Most `\|\c -.B \-f\c -\&\|' and `\|\c -.B \-W\c -\&\|' options have two contrary forms: -.BI \-f name -and -.BI \-fno\- name\c -\& (or -.BI \-W name -and -.BI \-Wno\- name\c -\&). Only the non-default forms are shown here. - -.TP -.B \-c -Compile or assemble the source files, but do not link. The compiler -output is an object file corresponding to each source file. -.TP -.BI \-D macro -Define macro \c -.I macro\c -\& with the string `\|\c -.B 1\c -\&\|' as its definition. -.TP -.BI \-D macro = defn -Define macro \c -.I macro\c -\& as \c -.I defn\c -\&. -.TP -.B \-E -Stop after the preprocessing stage; do not run the compiler proper. The -output is preprocessed source code, which is sent to the -standard output. -.TP -.B \-g -Produce debugging information in the operating system's native format -(for DBX or SDB or DWARF). GDB also can work with this debugging -information. On most systems that use DBX format, `\|\c -.B \-g\c -\&\|' enables use -of extra debugging information that only GDB can use. - -Unlike most other Fortran compilers, GNU Fortran allows you to use `\|\c -.B \-g\c -\&\|' with -`\|\c -.B \-O\c -\&\|'. The shortcuts taken by optimized code may occasionally -produce surprising results: some variables you declared may not exist -at all; flow of control may briefly move where you did not expect it; -some statements may not be executed because they compute constant -results or their values were already at hand; some statements may -execute in different places because they were moved out of loops. - -Nevertheless it proves possible to debug optimized output. This makes -it reasonable to use the optimizer for programs that might have bugs. -.TP -.BI "\-I" "dir"\c -\& -Append directory \c -.I dir\c -\& to the list of directories searched for include files. -.TP -.BI "\-L" "dir"\c -\& -Add directory \c -.I dir\c -\& to the list of directories to be searched -for `\|\c -.B \-l\c -\&\|'. -.TP -.BI \-l library\c -\& -Use the library named \c -.I library\c -\& when linking. -.TP -.B \-nostdinc -Do not search the standard system directories for header files. Only -the directories you have specified with -.B \-I -options (and the current directory, if appropriate) are searched. -.TP -.B \-O -Optimize. Optimizing compilation takes somewhat more time, and a lot -more memory for a large function. See the GCC documentation for -further optimisation options. Loop unrolling, in particular, may be -worth investigating for typical numerical Fortran programs. -.TP -.BI "\-o " file\c -\& -Place output in file \c -.I file\c -\&. -.TP -.B \-S -Stop after the stage of compilation proper; do not assemble. The output -is an assembler code file for each non-assembler input -file specified. -.TP -.BI \-U macro -Undefine macro \c -.I macro\c -\&. -.TP -.B \-v -Print (on standard error output) the commands executed to run the -stages of compilation. Also print the version number of the compiler -driver program and of the preprocessor and the compiler proper. The -version numbers of g77 itself and the GCC distribution on which it is -based are distinct. -.TP -.B \-Wall -Issue warnings for conditions which pertain to usage that we recommend -avoiding and that we believe is easy to avoid, even in conjunction -with macros. -.PP - -.SH FILES -.ta \w'LIBDIR/g77\-include 'u -file.h C header (preprocessor) file -.br -file.f Fortran source file -.br -file.for Fortran source file -.br -file.FOR Fortran source file -.br -file.F preprocessed Fortran source file -.br -file.fpp preprocessed Fortran source file -.br -file.FPP preprocessed Fortran source file -.br -file.r Ratfor source file (ratfor not included) -.br -file.s assembly language file -.br -file.o object file -.br -a.out link edited output -.br -\fITMPDIR\fR/cc\(** temporary files -.br -\fILIBDIR\fR/cpp preprocessor -.br -\fILIBDIR\fR/f771 compiler -.br -\fILIBDIR\fR/libg2c.a Fortran run-time library -.br -\fILIBDIR\fR/libgcc.a GCC subroutine library -.br -/lib/crt[01n].o start-up routine -.br -/lib/libc.a standard C library, see -.IR intro (3) -.br -/usr/include standard directory for -.B #include -files -.br -\fILIBDIR\fR/include standard gcc directory for -.B #include -.br - files. -.sp -.I LIBDIR -is usually -.B /usr/local/lib/\c -.IR machine / version . -.sp -.I TMPDIR -comes from the environment variable -.B TMPDIR -(default -.B /usr/tmp -if available, else -.B /tmp\c -\&). -.SH "SEE ALSO" -gcc(1), cpp(1), as(1), ld(1), gdb(1), adb(1), dbx(1), sdb(1). -.br -.RB "`\|" g77 "\|', `\|" gcc "\|', `\|" cpp "\|'," -.RB "`\|" as "\|', `\|" ld "\|'," -and -.RB "`\|" gdb "\|'" -entries in -.B info\c -\&. -.br -.I -Using and Porting GNU Fortran (for version 0.5.24)\c -, James Craig Burley; -.I -Using and Porting GNU CC (for version 2.0)\c -, Richard M. Stallman; -.I -The C Preprocessor\c -, Richard M. Stallman; -.I -Debugging with GDB: the GNU Source-Level Debugger\c -, Richard M. Stallman and Roland H. Pesch; -.I -Using as: the GNU Assembler\c -, Dean Elsner, Jay Fenlason & friends; -.I -gld: the GNU linker\c -, Steve Chamberlain and Roland Pesch. - -.SH BUGS -For instructions on how to report bugs, type `\|\c -.B info g77 -n Bugs\c -\&\|'. - -.SH COPYING -Copyright (c) 1991-1998 Free Software Foundation, Inc. -.PP -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. -.PP -Permission is granted to copy and distribute modified versions of this -manual under the conditions for verbatim copying, provided that the -entire resulting derived work is distributed under the terms of a -permission notice identical to this one. -.PP -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. -.SH AUTHORS -See the GNU CC Manual for the contributors to GNU CC. -See the GNU Fortran Manual for the contributors to -GNU Fortran. diff --git a/gcc/f/invoke.texi b/gcc/f/invoke.texi index caae931ed5f..38b17d52096 100644 --- a/gcc/f/invoke.texi +++ b/gcc/f/invoke.texi @@ -1,27 +1,30 @@ -@c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, -@c 2000, 2001 Free Software Foundation, Inc. +@c Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001 +@c 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. +Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001 +Free Software Foundation, Inc. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with the +Invariant Sections being ``GNU General Public License'' and ``Funding +Free Software'', the Front-Cover texts being (a) (see below), and with +the Back-Cover Texts being (b) (see below). A copy of the license is +included in the gfdl(7) man page. + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development. @c man end @c Set file name and title for the man page. @setfilename g77 @@ -39,6 +42,7 @@ Only the most useful options are listed here; see below for the remainder. @c man end @c man begin SEEALSO +gpl(7), gfdl(7), fsf-funding(7), 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}. @@ -60,6 +64,8 @@ See the Info entry for @file{g77}, or @cindex command options @cindex options, GNU Fortran command +@c man begin DESCRIPTION + 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}, @@ -82,6 +88,8 @@ 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. +@c man end + @menu * Option Summary:: Brief list of all @code{g77} options, without explanations. @@ -106,6 +114,8 @@ one is not the default. @node Option Summary @section Option Summary +@c man begin OPTIONS + Here is a summary of all the options specific to GNU Fortran, grouped by type. Explanations are in the following sections. @@ -208,6 +218,8 @@ by type. Explanations are in the following sections. @end smallexample @end table +@c man end + @menu * Overall Options:: Controlling the kind of output: an executable, object files, assembler files, @@ -231,6 +243,8 @@ by type. Explanations are in the following sections. @cindex overall options @cindex options, overall +@c man begin OPTIONS + Compilation can involve as many as four stages: preprocessing, code generation (often what is really meant by the term ``compilation''), assembly, and linking, always in that order. The first three @@ -2156,10 +2170,14 @@ This probably will break any calls to the @code{libg2c} library, at the very least, even if it is built with the same option. @end table +@c man end + @node Environment Variables @section Environment Variables Affecting GNU Fortran @cindex environment variables +@c man begin ENVIRONMENT + GNU Fortran currently does not make use of any environment variables to control its operation above and beyond those that affect the operation of @code{gcc}. @@ -2167,3 +2185,5 @@ that affect the operation of @code{gcc}. @xref{Environment Variables,,Environment Variables Affecting GNU CC, gcc,Using and Porting GNU CC}, for information on environment variables. + +@c man end -- 2.30.2