.\" Copyright (c) 1995-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 NAMEg77 \- GNU project Fortran Compiler (v0.5.24).SH SYNOPSIS.RB g77 " [" \c.IR option " | " "filename " ].\|.\|..SH WARNINGThe information in this man page is an extract from the fulldocumentation of the GNU Fortran compiler (version 0.5.24),and is limited to the meaning of some of the options..PPThis man page is not up to date, since no volunteers want tomaintain it.  If you find a discrepancy between the man page and thesoftware, please check the Info file, which is the authoritativedocumentation..\" .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..PPIf we find that the things in this man page that are out of date causesignificant confusion or complaints, we will stop distributing the manpage.  The alternative, updating the man page when we update the Infofile, is impractical because the rest of the work of maintaining GNU Fortranleaves us no time for that.  The GNU project regards man pages asobsolete and should not let them take time away from other things..PPFor complete and current documentation, refer to the Info file `\|\c.B g77\c\&\|' or the manual.IUsing and Porting GNU Fortran (for version 0.5.24)\c\&.  Both are made from the Texinfo source file.BR g77.texi ..PPIf your system has the `\|\c.B info\c\&\|' command installed, the command `\|\c.B info g77\c\&\|' should work, unless.B g77has 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 g77has not been properly installed..PPIf.B g77has not been properly installed, so that youcannot easily access the Info file for it,ask your system administrator, or the installerof.B g77(if you know who that is) to fix the problem..SH DESCRIPTIONThe C and F77 compilers are integrated;.B g77is a program to call.B gccwith options to recognize programs written in Fortran (ANSI FORTRAN 77,also called F77)..B gccprocesses input filesthrough one or more of four stages: preprocessing, compilation,assembly, and linking.  This man page contains full descriptions for.I onlyF77-specific aspects of the compiler, though it also containssummaries of some general-purpose options.  For a fuller explanationof 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 ratforitself is not supplied as part of.B g77\c\&)..SH OPTIONSThere are many command-line options, including options to controldetails of optimization, warnings, and code generation, which arecommon to both.B gccand.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 nameand.BI \-fno\- name\c\& (or.BI \-W nameand.BI \-Wno\- name\c\&). Only the non-default forms are shown here..TP.B \-cCompile or assemble the source files, but do not link.  The compileroutput is an object file corresponding to each source file..TP.BI \-D macroDefine macro \c.I macro\c\& with the string `\|\c.B 1\c\&\|' as its definition..TP.BI \-D macro = defnDefine macro \c.I macro\c\& as \c.I defn\c\&..TP.B \-EStop after the preprocessing stage; do not run the compiler proper.  Theoutput is preprocessed source code, which is sent to thestandard output..TP.B \-gProduce debugging information in the operating system's native format(for DBX or SDB or DWARF).  GDB also can work with this debugginginformation.  On most systems that use DBX format, `\|\c.B \-g\c\&\|' enables useof 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 occasionallyproduce surprising results: some variables you declared may not existat all; flow of control may briefly move where you did not expect it;some statements may not be executed because they compute constantresults or their values were already at hand; some statements mayexecute in different places because they were moved out of loops.Nevertheless it proves possible to debug optimized output.  This makesit 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 searchedfor `\|\c.B \-l\c\&\|'..TP.BI \-l library\c\&Use the library named \c.I library\c\& when linking..TP.B \-nostdincDo not search the standard system directories for header files.  Onlythe directories you have specified with.B \-Ioptions (and the current directory, if appropriate) are searched..TP.B \-OOptimize.  Optimizing compilation takes somewhat more time, and a lotmore memory for a large function.  See the GCC documentation forfurther optimisation options.  Loop unrolling, in particular, may beworth investigating for typical numerical Fortran programs..TP.BI "\-o " file\c\&Place output in file \c.I file\c\&..TP.B \-SStop after the stage of compilation proper; do not assemble.  The outputis an assembler code file for each non-assembler inputfile specified..TP.BI \-U macroUndefine macro \c.I macro\c\&..TP.B \-vPrint (on standard error output) the commands executed to run thestages of compilation.  Also print the version number of the compilerdriver program and of the preprocessor and the compiler proper.  Theversion numbers of g77 itself and the GCC distribution on which it isbased are distinct..TP.B \-WallIssue warnings for conditions which pertain to usage that we recommendavoiding and that we believe is easy to avoid, even in conjunctionwith macros..PP.SH FILES.ta \w'LIBDIR/g77\-include 'ufile.h    C header (preprocessor) file.brfile.f    Fortran source file.brfile.for  Fortran source file.brfile.FOR  Fortran source file.brfile.F    preprocessed Fortran source file.brfile.fpp  preprocessed Fortran source file.brfile.FPP  preprocessed Fortran source file.brfile.r    Ratfor source file (ratfor not included).brfile.s    assembly language file.brfile.o    object file.bra.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 #includefiles.br\fILIBDIR\fR/include	standard gcc directory for.B #include.br			files..sp.I LIBDIRis usually.B /usr/local/lib/\c.IR machine / version ..sp.I TMPDIRcomes from the environment variable.B TMPDIR(default.B /usr/tmpif 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.IUsing and Porting GNU Fortran (for version 0.5.24)\c, James Craig Burley;.IUsing and Porting GNU CC (for version 2.0)\c, Richard M. Stallman;.IThe C Preprocessor\c, Richard M. Stallman;.IDebugging with GDB: the GNU Source-Level Debugger\c, Richard M. Stallman and Roland H. Pesch;.IUsing as: the GNU Assembler\c, Dean Elsner, Jay Fenlason & friends;.Igld: the GNU linker\c, Steve Chamberlain and Roland Pesch..SH BUGSFor instructions on how to report bugs, type `\|\c.B info g77 -n Bugs\c\&\|'..SH COPYINGCopyright (c) 1991-1998 Free Software Foundation, Inc..PPPermission is granted to make and distribute verbatim copies ofthis manual provided the copyright notice and this permission noticeare preserved on all copies..PPPermission is granted to copy and distribute modified versions of thismanual under the conditions for verbatim copying, provided that theentire resulting derived work is distributed under the terms of apermission notice identical to this one..PPPermission is granted to copy and distribute translations of thismanual into another language, under the above conditions for modifiedversions, except that this permission notice may be included intranslations approved by the Free Software Foundation instead of inthe original English..SH AUTHORSSee the GNU CC Manual for the contributors to GNU CC.See the GNU Fortran Manual for the contributors toGNU Fortran.