4.3BSD-UWisc/man/man1/f77.1

Compare this file to the similar file:
Show the results in this format:
.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)f77.1	6.4 (Berkeley) 5/5/86
.\"
.TH F77 1 "May 5, 1986"
.UC 4
.SH NAME
f77 \- Fortran 77 compiler
.SH SYNOPSIS
.B f77
[ option ] ... file ...
.SH DESCRIPTION
.I F77
is the UNIX Fortran 77 compiler.
It accepts several types of arguments:
.PP
Arguments whose names end with `.f' are taken to be
Fortran 77 source programs;
they are compiled, and
each object program is left on the file in the current directory
whose name is that of the source with `.o' substituted
for '.f'.
.PP
Arguments whose names end with `.F' are also taken to be Fortran 77 source
programs; these are first processed by the C preprocessor before being
compiled by
.I f77.
.PP
Arguments whose names end with `.r' or `.e' are taken to be Ratfor
or EFL source programs respectively; these are first transformed by the
appropriate preprocessor, then compiled by f77.
.PP
Arguments whose names end with `.c' or `.s' are taken to be C or assembly
source programs and are compiled or assembled, producing a `.o' file.
.PP
The following options have the same meaning as in
.IR cc (1).
See
.IR ld (1)
for load-time options.
.TP
.B \-c
Suppress loading and produce `.o' files for each source 
file.
.TP
.B \-g
Produce additional symbol table information for
.IR dbx (1)
and pass the
.B \-lg
flag to
.IR ld (1)
so that on abnormal terminations, the memory image is written
to file \fIcore\fP.
Incompatible with
.BR \-O .
.TP
.BR \-o " output"
Name the final output file
.I output
instead of `a.out'.
.TP
.B \-p
Prepare object files for profiling, see
.IR  prof (1).
.TP
.B \-pg
Causes the compiler to produce counting code in the manner of
.B \-p,
but invokes a run-time recording mechanism that keeps more extensive
statistics and produces a
.I gmon.out
file at normal termination. An execution profile can then be generated
by use of
.IR gprof (1).
.TP
.BR \-w
Suppress all warning messages.
If the option is `\-w66', only Fortran 66 compatibility warnings are suppressed.
.TP
.BI \-D name=def
.TP
.BI \-D name
Define the
.I name
to the C preprocessor, as if by `#define'. If no definition is given, the name
is defined as "1". (`.F' suffix files only).
.TP
.BI \-I dir
`#include' files whose names do not begin with `/' are always sought
first in the directory of the
.I file
argument, then in directories named in
.B \-I
options, then in directories on a standard list. (`.F' suffix files only).
.TP
.B \-O
Invoke an
object-code optimizer.
Incompatible with
.BR \-g .
.TP
.B \-S
Compile the named programs, and leave the
assembler-language output on corresponding files suffixed `.s'.
(No `.o' is created.).
.PP
The following options are peculiar to
.IR f77 .
.TP
.B \-d
Used for debugging the compiler.
.TP
.B \-i2
On machines which support short integers, make the default integer constants
and variables short.
.RB ( \-i4
is the standard value of this option). All logical quantities will be short.
.TP
.B \-q
Suppress printing of file names and program unit names during compilation.
.TP
.BR \-m
Apply the M4 preprocessor to each `.r' file before transforming
it with the Ratfor or EFL preprocessor.
.TP
.SM
.BR \-onetrip
.TP
.BR \-1
Compile DO loops that are performed at least once if reached.
(Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.)
.TP
.BR \-r8
Treat all floating point variables,
constants, functions and intrinsics
as double precision and all complex
quantities as double complex.
.TP
.BR \-u
Make the default type of a variable `undefined' rather than using the default Fortran rules.
.TP
.BR \-v
Print the version number of the compiler, and the name of each pass as it
executes.
.TP
.BR \-C
Compile code to check that subscripts are within declared array bounds.
For multi-dimensional arrays, only the equivalent linear subscript is checked.
.TP
.BR \-F
Apply the C preprocessor to `.F' files, and the EFL, or Ratfor preprocessors
to `.e' and `.r' files, put the
result in the file with the suffix changed to `.f', but do not compile.
.TP
.BI \-E x
Use the string 
.I x
as an EFL option in processing `.e' files.
.TP
.BI \-R x
Use the string 
.I x
as a Ratfor option in processing `.r' files.
.TP
\fB\-N\fR[\fBqxscn\fR]\fInnn
Make static tables in the compiler bigger. The compiler will complain
if it overflows its tables and suggest you apply one or more of these
flags. These flags have the following meanings:
.RS
.TP
.B q
Maximum number of equivalenced variables. Default is 150.
.TP
.B x
Maximum number of external names (common block names, subroutine and
function names). Default is 200.
.TP
.B s
Maximum number of statement numbers. Default is 401.
.TP
.B c
Maximum depth of nesting for control statements (e.g. DO loops). Default is
20.
.TP
.B n
Maximum number of identifiers. Default is 1009.
.RE
.TP
.BR \-U
Do not convert upper case letters to lower case. The default is to convert
Fortran programs to lower case except within character string constants.
.PP
Other arguments
are taken
to be either loader option arguments, or F77-compatible
object programs, typically produced by an earlier
run,
or perhaps libraries of F77-compatible routines.
These programs, together with the results of any
compilations specified, are loaded (in the order
given) to produce an executable program with name
`a.out'.
.PP
Programs compiled with
.I f77
produce memory dumps in file
.I core
upon abnormal termination if the
.B \(mig
flag was specified during loading.
If the environment variable
.I f77_dump_flag
is set to a value beginning with
.B y
or
.BR n ,
dumps for abnormal terminations are respectively forced or
suppressed.
.SH FILES
.nf
.ta \w'/usr/lib/libF77_p.a   'u
file.[fFresc]	input file
file.o	object file
a.out	loaded output
./fort[pid].?	temporary
/usr/lib/f77pass1	compiler
/lib/f1	pass 2
/lib/c2	optional optimizer
/lib/cpp	C preprocessor
/usr/lib/libF77.a	intrinsic function library
/usr/lib/libI77.a	Fortran I/O library
/usr/lib/libU77.a	UNIX interface library
/usr/lib/libm.a	math library
/lib/libc.a	C library, see section 3
/usr/lib/libF77_p.a	profiling intrinsic function library
/usr/lib/libI77_p.a	profiling Fortran I/O library
/usr/lib/libU77_p.a	profiling UNIX interface library
/usr/lib/libm_p.a	profiling math library
/usr/lib/libc_p.a	profiling C library, see section 3
mon.out	file produced for analysis by prof(1).
gmon.out	file produced for analysis by gprof(1).
.fi
.SH "SEE ALSO"
S. I. Feldman,
P. J. Weinberger,
J. Berkman,
.I
A Portable Fortran 77 Compiler
.br
D. L. Wasley,
J. Berkman,
.I
Introduction to the f77 I/O Library
.br
fpr(1), fsplit(1), ld(1), ar(1), ranlib(1), dbx(1), intro(3f)
.br
efl(1), ratfor(1), struct(1), prof(1), gprof(1), cc(1)
.SH DIAGNOSTICS
The diagnostics produced by
.I f77
itself are intended to be
self-explanatory.
Occasional messages may be produced by the loader.
.SH BUGS
Files longer than about 50,000 lines must be split up to be compiled.