[unix-history] / usr / man / man1 / f77.1

.TH F77 1
.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 `.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
In the same way,
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 \-p
Prepare object files for profiling, see
.IR  prof (1).
.TP
.SM
.B \-O
Invoke an
object-code optimizer.
.TP
.SM
.B \-S
Compile the named programs, and leave the
assembler-language output on corresponding files suffixed `.s'.
(No `.o' is created.).
.TP
.B \-f
Use a floating point interpreter (for PDP11's that lack
11/70-style floating point).
.TP
.BR \-o " output"
Name the final output file
.I output
instead of `a.out'.
.PP
The following options are peculiar to
.IR f77 .
.TP
.SM
.BR \-onetrip
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 \-u
Make the default type of a variable `undefined' rather than using the default Fortran rules.
.TP
.BR \-C
Compile code to check that subscripts are within declared array bounds.
.TP
.BR \-w
Suppress all warning messages.
If the option is `\-w66', only Fortran 66 compatibility warnings are suppressed.
.TP
.BR \-F
Apply EFL and Ratfor preprocessor to relevant files, put the result in the file
with the suffix changed to `.f', but do not compile.
.TP
.BR \-m
Apply the M4 preprocessor to each `.r' or `.e' file before transforming
it with the Ratfor or EFL preprocessor.
.TP
.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.
.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'.
.SH FILES
.nf
.ta \w'/usr/lib/libF77.a   'u
file.[fresc]	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
/usr/lib/libF77.a	intrinsic function library
/usr/lib/libI77.a	Fortran I/O library
/lib/libc.a	C library, see section 3
.fi
.SH "SEE ALSO"
S. I. Feldman,
P. J. Weinberger,
.I
A Portable Fortran 77 Compiler
.br
prof(1), cc(1), ld(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
The Fortran 66 subset of the language has been
exercised extensively;
the newer features have not.
Commit	Line	Data
c1030a02 TL	1	.TH F77 1
	2	.SH NAME
	3	f77 \- Fortran 77 compiler
	4	.SH SYNOPSIS
	5	.B f77
	6	[ option ] ... file ...
	7	.SH DESCRIPTION
	8	.I F77
	9	is the UNIX Fortran 77 compiler.
	10	It accepts several types of arguments:
	11	.PP
	12	Arguments whose names end with `.f' are taken to be
	13	Fortran 77 source programs;
	14	they are compiled, and
	15	each object program is left on the file in the current directory
	16	whose name is that of the source with `.o' substituted
	17	for '.f'.
	18	.PP
	19	Arguments whose names end with `.r' or `.e' are taken to be Ratfor or EFL
	20	source programs, respectively; these are first transformed by the
	21	appropriate preprocessor, then compiled by f77.
	22	.PP
	23	In the same way,
	24	arguments whose names end with `.c' or `.s' are taken to be C or assembly source programs
	25	and are compiled or assembled, producing a `.o' file.
	26	.PP
	27	The following options have the same meaning as in
	28	.IR cc (1).
	29	See
	30	.IR ld (1)
	31	for load-time options.
	32	.TP
	33	.B \-c
	34	Suppress loading and produce `.o' files for each source
	35	file.
	36	.TP
	37	.B \-p
	38	Prepare object files for profiling, see
	39	.IR prof (1).
	40	.TP
	41	.SM
	42	.B \-O
	43	Invoke an
	44	object-code optimizer.
	45	.TP
	46	.SM
	47	.B \-S
	48	Compile the named programs, and leave the
	49	assembler-language output on corresponding files suffixed `.s'.
	50	(No `.o' is created.).
	51	.TP
	52	.B \-f
	53	Use a floating point interpreter (for PDP11's that lack
	54	11/70-style floating point).
	55	.TP
	56	.BR \-o " output"
	57	Name the final output file
	58	.I output
	59	instead of `a.out'.
	60	.PP
	61	The following options are peculiar to
	62	.IR f77 .
	63	.TP
	64	.SM
65	.BR \-onetrip
66	Compile DO loops that are performed at least once if reached.
67	(Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.)
68	.TP
69	.BR \-u
70	Make the default type of a variable `undefined' rather than using the default Fortran rules.
71	.TP
72	.BR \-C
73	Compile code to check that subscripts are within declared array bounds.
74	.TP
75	.BR \-w
76	Suppress all warning messages.
77	If the option is `\-w66', only Fortran 66 compatibility warnings are suppressed.
78	.TP
79	.BR \-F
80	Apply EFL and Ratfor preprocessor to relevant files, put the result in the file
81	with the suffix changed to `.f', but do not compile.
82	.TP
83	.BR \-m
84	Apply the M4 preprocessor to each `.r' or `.e' file before transforming
85	it with the Ratfor or EFL preprocessor.
86	.TP
87	.TP
88	.BI \-E x
89	Use the string
90	.I x
91	as an EFL option in processing `.e' files.
92	.TP
93	.BI \-R x
94	Use the string
95	.I x
96	as a Ratfor option in processing `.r' files.
97	.PP
98	Other arguments
99	are taken
100	to be either loader option arguments, or F77-compatible
101	object programs, typically produced by an earlier
102	run,
103	or perhaps libraries of F77-compatible routines.
104	These programs, together with the results of any
105	compilations specified, are loaded (in the order
106	given) to produce an executable program with name
107	`a.out'.
108	.SH FILES
109	.nf
110	.ta \w'/usr/lib/libF77.a 'u
111	file.[fresc] input file
112	file.o object file
113	a.out loaded output
114	./fort[pid].? temporary
115	/usr/lib/f77pass1 compiler
116	/lib/f1 pass 2
117	/lib/c2 optional optimizer
118	/usr/lib/libF77.a intrinsic function library
119	/usr/lib/libI77.a Fortran I/O library
120	/lib/libc.a C library, see section 3
121	.fi
122	.SH "SEE ALSO"
123	S. I. Feldman,
124	P. J. Weinberger,
125	.I
126	A Portable Fortran 77 Compiler
127	.br
128	prof(1), cc(1), ld(1)
129	.SH DIAGNOSTICS
130	The diagnostics produced by
131	.I f77
132	itself are intended to be
133	self-explanatory.
134	Occasional messages may be produced by the loader.
135	.SH BUGS
136	The Fortran 66 subset of the language has been
137	exercised extensively;
138	the newer features have not.