sources/f2c/f2c.1

   1
   2      F2C(1)                                                     F2C(1)
   3
   4      NAME
   5           f2c - Convert Fortran 77 to C or C++
   6
   7      SYNOPSIS
   8           f2c [ option ... ] file ...
   9
  10      DESCRIPTION
  11           F2c converts Fortran 77 source code in files with names end-
  12           ing in `.f' or `.F' to C (or C++) source files in the
  13           current directory, with `.c' substituted for the final `.f'
  14           or `.F'.  If no Fortran files are named, f2c reads Fortran
  15           from standard input and writes C on standard output.  File
  16           names that end with `.p' or `.P' are taken to be prototype
  17           files, as produced by option `-P', and are read first.
  18
  19           The following options have the same meaning as in f77(1).
  20
  21           -C   Compile code to check that subscripts are within
  22                declared array bounds.
  23
  24           -I2  Render INTEGER and LOGICAL as short, INTEGER*4 as long
  25                int.  Assume the default libF77 and libI77:  allow only
  26                INTEGER*4 (and no LOGICAL) variables in INQUIREs.
  27                Option `-I4' confirms the default rendering of INTEGER
  28                as long int.
  29
  30           -onetrip
  31                Compile DO loops that are performed at least once if
  32                reached.  (Fortran 77 DO loops are not performed at all
  33                if the upper limit is smaller than the lower limit.)
  34
  35           -U   Honor the case of variable and external names.  Fortran
  36                keywords must be in lower case.
  37
  38           -u   Make the default type of a variable `undefined' rather
  39                than using the default Fortran rules.
  40
  41           -w   Suppress all warning messages.  If the option is
  42                `-w66', only Fortran 66 compatibility warnings are
  43                suppressed.
  44
  45           The following options are peculiar to f2c.
  46
  47           -A   Produce ANSI C.  Default is old-style C.
  48
  49           -a   Make local variables automatic rather than static
  50                unless they appear in a DATA, EQUIVALENCE, NAMELIST, or
  51                SAVE statement.
  52
  53           -C++ Output C++ code.
  54
  55           -c   Include original Fortran source as comments.
  56
  57      Page 1                    Tenth Edition         (printed 1/28/90)
  58
  59      F2C(1)                                                     F2C(1)
  60
  61           -E   Declare uninitialized COMMON to be Extern (overridably
  62                defined in f2c.h as extern).
  63
  64           -ec  Place uninitialized COMMON blocks in separate files:
  65                COMMON /ABC/ appears in file abc_com.c.  Option `-e1c'
  66                bundles the separate files into the output file, with
  67                comments that give an unbundling sed(1) script.
  68
  69           -ext Complain about f77(1) extensions.
  70
  71           -g   Include original Fortran line numbers as comments.
  72
  73           -i2  Similar to -I2, but assume a modified libF77 and libI77
  74                (compiled with -Df2c_i2), so INTEGER and LOGICAL vari-
  75                ables may be assigned by INQUIRE.
  76
  77           -P   Write a file.P of ANSI (or C++) prototypes for pro-
  78                cedures defined in each input file.f or file.F.  When
  79                reading Fortran from standard input, write prototypes
  80                at the beginning of standard output.  Implies -A unless
  81                option `-C++' is present.  Option -Ps implies -P , and
  82                gives exit status 4 if rerunning f2c may change proto-
  83                types or declarations.
  84
  85           -p   Supply preprocessor definitions to make common-block
  86                members look like local variables.
  87
  88           -R   Do not promote REAL functions and operations to DOUBLE
  89                PRECISION.  Option `-!R' confirms the default, which
  90                imitates f77.
  91
  92           -r8  Promote REAL to DOUBLE PRECISION, COMPLEX to DOUBLE
  93                COMPLEX.
  94
  95           -Tdir
  96                Put temporary files in directory dir.
  97
  98           -w8  Suppress warnings when COMMON or EQUIVALENCE forces
  99                odd-word alignment of doubles.
 100
 101           -Wn  Assume n characters/word (default 4) when initializing
 102                numeric variables with character data.
 103
 104           -z   Do not implicitly recognize DOUBLE COMPLEX.
 105
 106           -!c  Inhibit C output, but produce -P output.
 107
 108           -!I  Reject include statements.
 109
 110           -!it Don't infer types of untyped EXTERNAL procedures from
 111                use as parameters to previously defined or prototyped
 112                procedures.
 113
 114      Page 2                    Tenth Edition         (printed 1/28/90)
 115
 116      F2C(1)                                                     F2C(1)
 117
 118           -!P  Do not attempt to infer ANSI or C++ prototypes from
 119                usage.
 120
 121           The resulting C invokes the support routines of f77; object
 122           code should be loaded by f77 or with ld(1) or cc(1) options
 123           -lF77 -lI77 -lm.  Calling conventions are those of f77: see
 124           the reference below.
 125
 126      FILES
 127           file.[fF]
 128                input file
 129
 130           *.c  output file
 131
 132           /usr/include/f2c.h
 133                header file
 134
 135           /usr/lib/libF77.a
 136                intrinsic function library
 137
 138           /usr/lib/libI77.a
 139                Fortran I/O library
 140
 141           /lib/libc.a
 142                C library, see section 3
 143
 144      SEE ALSO
 145           S. I. Feldman and P. J. Weinberger, `A Portable Fortran 77
 146           Compiler', UNIX Time Sharing System Programmer's Manual,
 147           Tenth Edition, Volume 2, AT&T Bell Laboratories, 1990.
 148
 149      DIAGNOSTICS
 150           The diagnostics produced by f2c are intended to be self-
 151           explanatory.
 152
 153      BUGS
 154           Floating-point constant expressions are simplified in the
 155           floating-point arithmetic of the machine running f2c, so
 156           they are typically accurate to at most 16 or 17 decimal
 157           places.
 158           Untypable EXTERNAL functions are declared int.
 159
 160      Page 3                    Tenth Edition         (printed 1/28/90)
 161