![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to man1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / f2c / doc|
Return to man1 CVS log | Up to [Research Unix] / researchv10no / cmd / f2c / doc |
1.1 root 1: From mwm Tue Jan 10 14:56:38 EST 1989
2: To: dmg
3: Subject: newer man
4:
5:
6: Dave,
7:
8: This is the latest version of the man page. It includes some things
9: (like -c, -L) which aren't implemented. But it will give you a better picture
10: of the files generated by f2c.
11:
12: f2c -- Fortran 77 to C tranlator
13:
14: ENVIRONMENT VARIABLES
15: f2cdebug -- Holds filename for diagnostic output. This only matters
16: when the debugging switch has been given on the command line.
17:
18: USER FILES
19: .f -- Fortran 77 source files
20: f2c.h -- Standard include file for the resulting C code
21:
22: SYSTEM FILES
23: raw_data -- Holds unordered, untyped initializers generated by DATA
24: statements. This file will be sorted and copied into
25: init_file.
26: init_file -- Holds the untyped initializers generated by Fortran
27: DATA statements. This is zeroed for each function in the
28: input.
29: c_functions -- Holds all translated functions. After the entire
30: input file has been processed, the table of constant values
31: gets prepended to this file; the result is the final
32: product, contained in c_output.
33: c_output -- Holds the translated C code.
34: p1_file -- Contains an intermediate form of the Fortran file. This
35: p1_file.BAK for debugging.
36: p1_file.BAK -- Holds a copy of the p1 file for the previous
37: function. This is useful in debugging because p1_file is
38: zeroed immediately after a function is tranlated.
39:
40: COMMAND LINE OPTIONS
41: -o <filename> -- Write all output to the given filename. If many
42: source files are input, they will be appended to this file
43: (does this make sense? No, make it only useful for one; the
44: default will be to write to infile.c)
45: -w66 -- Suppress warnings about any non-Fortran 66 features used.
46: -w -- Suppress all warnings.
47: -66, -6 -- Generate an error when a generic function (f77 feature) is
48: used. Also generate an error when an extension to Fortran
49: 77 is used (hex/oct/bin constant, automatic/static/double
50: complex types).
51: -d -- Set debug flag
52: -1, -onetrip -- perform each DO loop at least once
53: -I2 -- use shorts for integers, logicals
54: -I4 -- use longs for integers, logicals
55: -Is -- use short subscripts on arrays
56: -U -- don't convert all uppercase to lowercase
57: -u -- make the default variable type undefined
58: -O<#> -- use <#> register variables [NOT IMPLEMENTED]
59: -C -- Check that array subscripts lie within bounds at runtime
60: -Nq -- Set the max number of equivalences
61: -Nx -- Set the max number of externs
62: -Ns -- Set the max number of statement numbers
63: -Nc -- Set the max number of control constructs (loops, IF-THEN-ELSE)
64: -Nn -- Set the max number of identifiers (hash table size)
65: -c -- include the original Fortran in the output.
66: -L -- omit unreferenced labels
67:
68:
69:
70: From mwm Tue Jan 10 14:54:38 EST 1989
71: To: dmg
72:
73: f2c -- Fortran 77 to C translator
74:
75: SWITCHES
76: May be invoked with the same switches as f77
77:
78: FILES
79: - Fortran input files are given on the command line; these must have a
80: .f suffix
81: - Generated C code will appear in a file called c_output in the
82: current working directory
83: - Several intermediate files are generated, and not removed. These
84: are:
85: c_functions -- first copy of the generated C code, minus the
86: table of constant values
87: expr_file -- useless, old data
88: init_file -- holds static initializations on a function by
89: function basis
90: p1_file -- function by function intermediate file, only
91: readable using the pfilter.awk script in
92: /usr/mwm/f2c
93: p1_file.BAK -- same as above, useful for debugging since
94: p1_file is always zeroed on termination
95:
96: - Every generated C file begins with '#include "f2c.h"'; this can be
97: found in /usr/mwm/f2c/f2c.h
98: - f2c calls the program /usr/mwm/f2c/f2cpass1 - this is hardcoded
99: right now.
100:
101: ENVIRONMENT
102: - When environment variable f2cdebug is nonempty, debugging
103: output will be written to that filename.
104:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.