Return to f77.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/f77.1, revision 1.1

1.1     ! root        1: .TH F77 1 "13 May 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: f77 \- Fortran 77 compiler
        !             5: .SH SYNOPSIS
        !             6: .B f77
        !             7: [ option ] ... file ...
        !             8: .SH DESCRIPTION
        !             9: .I F77
        !            10: is the UNIX Fortran 77 compiler.
        !            11: It accepts several types of arguments:
        !            12: .PP
        !            13: Arguments whose names end with `.f' are taken to be
        !            14: Fortran 77 source programs;
        !            15: they are compiled, and
        !            16: each object program is left on the file in the current directory
        !            17: whose name is that of the source with `.o' substituted
        !            18: for '.f'.
        !            19: .PP
        !            20: Arguments whose names end with `.F' are also taken to be Fortran 77 source
        !            21: programs; these are first processed by the C preprocessor before being
        !            22: compiled by
        !            23: .I f77.
        !            24: .PP
        !            25: Arguments whose names end with `.r' or `.e' are taken to be Ratfor
        !            26: or EFL source programs respectively; these are first transformed by the
        !            27: appropriate preprocessor, then compiled by f77.
        !            28: .PP
        !            29: Arguments whose names end with `.c' or `.s' are taken to be C or assembly
        !            30: source programs and are compiled or assembled, producing a `.o' file.
        !            31: .PP
        !            32: The following options have the same meaning as in
        !            33: .IR cc (1).
        !            34: See
        !            35: .IR ld (1)
        !            36: for load-time options.
        !            37: .TP
        !            38: .B \-c
        !            39: Suppress loading and produce `.o' files for each source 
        !            40: file.
        !            41: .TP
        !            42: .B \-g
        !            43: Have the compiler produce additional symbol table information for
        !            44: .IR dbx (1).
        !            45: Also pass the
        !            46: .B \-lg
        !            47: flag to
        !            48: .IR ld (1).
        !            49: .TP
        !            50: .BR \-o " output"
        !            51: Name the final output file
        !            52: .I output
        !            53: instead of `a.out'.
        !            54: .TP
        !            55: .B \-p
        !            56: Prepare object files for profiling, see
        !            57: .IR  prof (1).
        !            58: .TP
        !            59: .B \-pg
        !            60: Causes the compiler to produce counting code in the manner of
        !            61: .B \-p,
        !            62: but invokes a run-time recording mechanism that keeps more extensive
        !            63: statistics and produces a
        !            64: .I gmon.out
        !            65: file at normal termination. An execution profile can then be generated
        !            66: by use of
        !            67: .IR gprof (1).
        !            68: .TP
        !            69: .BR \-w
        !            70: Suppress all warning messages.
        !            71: If the option is `\-w66', only Fortran 66 compatibility warnings are suppressed.
        !            72: .TP
        !            73: .BI \-D name=def
        !            74: .TP
        !            75: .BI \-D name
        !            76: Define the
        !            77: .I name
        !            78: to the C preprocessor, as if by `#define'. If no definition is given, the name
        !            79: is defined as "1". (`.F' suffix files only).
        !            80: .TP
        !            81: .BI \-I dir
        !            82: `#include' files whose names do not begin with `/' are always sought
        !            83: first in the directory of the
        !            84: .I file
        !            85: argument, then in directories named in
        !            86: .B \-I
        !            87: options, then in directories on a standard list. (`.F' suffix files only).
        !            88: .TP
        !            89: .B \-O
        !            90: Invoke an
        !            91: object-code optimizer.
        !            92: .TP
        !            93: .B \-S
        !            94: Compile the named programs, and leave the
        !            95: assembler-language output on corresponding files suffixed `.s'.
        !            96: (No `.o' is created.).
        !            97: .PP
        !            98: The following options are peculiar to
        !            99: .IR f77 .
        !           100: .TP
        !           101: .B \-i2
        !           102: Make the default integer constants
        !           103: and variables short.
        !           104: .RB ( \-i4
        !           105: is the default for this option). All logical quantities will be short.
        !           106: .TP
        !           107: .BR \-m
        !           108: Apply the M4 preprocessor to each `.r' file before transforming
        !           109: it with the Ratfor or EFL preprocessor.
        !           110: .TP
        !           111: .SM
        !           112: .BR \-onetrip
        !           113: Compile DO loops that are performed at least once if reached.
        !           114: (Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.)
        !           115: .TP
        !           116: .BR \-u
        !           117: Make the default type of a variable `undefined' rather than using the default Fortran rules.
        !           118: .TP
        !           119: .BR \-v
        !           120: Print the version number of the compiler, and the name of each pass as it
        !           121: executes.
        !           122: .TP
        !           123: .BR \-C
        !           124: Compile code to check that subscripts are within declared array bounds.
        !           125: .TP
        !           126: .BR \-F
        !           127: Apply the C, EFL, or Ratfor preprocessors to relevant files, put the
        !           128: result in the file with the suffix changed to `.f', but do not compile.
        !           129: .TP
        !           130: .BI \-E x
        !           131: Use the string 
        !           132: .I x
        !           133: as an EFL option in processing `.e' files.
        !           134: .TP
        !           135: .BI \-R x
        !           136: Use the string 
        !           137: .I x
        !           138: as a Ratfor option in processing `.r' files.
        !           139: .TP
        !           140: \fB\-N\fR[\fBqxscn\fR]\fInnn
        !           141: Make static tables in the compiler bigger. The compiler will complain
        !           142: if it overflows its tables and suggest you apply one or more of these
        !           143: flags. These flags have the following meanings:
        !           144: .RS
        !           145: .TP
        !           146: .B q
        !           147: Maximum number of equivalenced variables. Default is 150.
        !           148: .TP
        !           149: .B x
        !           150: Maximum number of external names (common block names, subroutine and
        !           151: function names). Default is 200.
        !           152: .TP
        !           153: .B s
        !           154: Maximum number of statement numbers. Default is 401.
        !           155: .TP
        !           156: .B c
        !           157: Maximum depth of nesting for control statements (e.g. DO loops). Default is
        !           158: 20.
        !           159: .TP
        !           160: .B n
        !           161: Maximum number of identifiers. Default is 1009.
        !           162: .RE
        !           163: .TP
        !           164: .BR \-U
        !           165: Do not convert upper case letters to lower case. The default is to convert
        !           166: Fortran programs to lower case except within character string constants.
        !           167: .PP
        !           168: Other arguments
        !           169: are taken
        !           170: to be either loader option arguments, or F77-compatible
        !           171: object programs, typically produced by an earlier
        !           172: run,
        !           173: or perhaps libraries of F77-compatible routines.
        !           174: These programs, together with the results of any
        !           175: compilations specified, are loaded (in the order
        !           176: given) to produce an executable program with name
        !           177: `a.out'.
        !           178: .SH FILES
        !           179: .nf
        !           180: .ta \w'/usr/lib/libF77_p.a   'u
        !           181: file.[fFresc]  input file
        !           182: file.o object file
        !           183: a.out  loaded output
        !           184: ./fort[pid].?  temporary
        !           185: /usr/lib/f77pass1      compiler
        !           186: /lib/f1        pass 2
        !           187: /lib/c2        optional optimizer
        !           188: /lib/cpp       C preprocessor
        !           189: /usr/lib/libF77.a      intrinsic function library
        !           190: /usr/lib/libI77.a      Fortran I/O library
        !           191: /usr/lib/libU77.a      UNIX interface library
        !           192: /usr/lib/libF77_p.a    profiling intrinsic function library
        !           193: /usr/lib/libI77_p.a    profiling Fortran I/O library
        !           194: /usr/lib/libU77_p.a    profiling UNIX interface library
        !           195: /lib/libc.a    C library, see section 3
        !           196: mon.out        file produced for analysis by prof(1).
        !           197: gmon.out       file produced for analysis by gprof(1).
        !           198: .fi
        !           199: .SH "SEE ALSO"
        !           200: S. I. Feldman,
        !           201: P. J. Weinberger,
        !           202: .I
        !           203: A Portable Fortran 77 Compiler
        !           204: .br
        !           205: D. L. Wasley,
        !           206: .I
        !           207: Introduction to the f77 I/O Library
        !           208: .br
        !           209: prof(1), gprof(1), cc(1), ld(1), efl(1), ratfor(1)
        !           210: .SH DIAGNOSTICS
        !           211: The diagnostics produced by
        !           212: .I f77
        !           213: itself are intended to be
        !           214: self-explanatory.
        !           215: Occasional messages may be produced by the loader.
        !           216: .SH BUGS
        !           217: This compiler is still somewhat experimental.
        !           218: The optimizer occasionally makes mistakes;
        !           219: it should be avoided when debugging if apparently incorrect results
        !           220: are obtained.
        !           221: Because of an assembler error, complaints about long branches may occur
        !           222: with very large source files; such errors can be avoided by splitting
        !           223: the sources into smaller sections.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.