![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to f2c.1t CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / cmd / f2c|
Return to f2c.1t CVS log | Up to [Research Unix] / researchv10dc / cmd / f2c |
1.1 root 1: . \" Definitions of F, L and LR for the benefit of systems
2: . \" whose -man lacks them...
3: .de F
4: .nh
5: .if n \%\&\\$1
6: .if t \%\&\f(CW\\$1\fR
7: .hy 14
8: ..
9: .de L
10: .nh
11: .if n \%`\\$1'
12: .if t \%\&\f(CW\\$1\fR
13: .hy 14
14: ..
15: .de LR
16: .nh
17: .if n \%`\\$1'\\$2
18: .if t \%\&\f(CW\\$1\fR\\$2
19: .hy 14
20: ..
21: .TH F2C 1
22: .CT 1 prog_other
23: .SH NAME
24: f\^2c \(mi Convert Fortran 77 to C or C++
25: .SH SYNOPSIS
26: .B f\^2c
27: [
28: .I option ...
29: ]
30: .I file ...
31: .SH DESCRIPTION
32: .I F2c
33: converts Fortran 77 source code in
34: .I files
35: with names ending in
36: .L .f
37: or
38: .L .F
39: to C (or C++) source files in the
40: current directory, with
41: .L .c
42: substituted
43: for the final
44: .L .f
45: or
46: .LR .F .
47: If no Fortran files are named,
48: .I f\^2c
49: reads Fortran from standard input and
50: writes C on standard output.
51: .I File
52: names that end with
53: .L .p
54: or
55: .L .P
56: are taken to be prototype
57: files, as produced by option
58: .LR -P ,
59: and are read first.
60: .PP
61: The following options have the same meaning as in
62: .IR f\^77 (1).
63: .TP
64: .B -C
65: Compile code to check that subscripts are within declared array bounds.
66: .TP
67: .B -I2
68: Render INTEGER and LOGICAL as short,
69: INTEGER\(**4 as long int. Assume the default \fIlibF77\fR
70: and \fIlibI77\fR: allow only INTEGER\(**4 (and no LOGICAL)
71: variables in INQUIREs. Option
72: .L -I4
73: confirms the default rendering of INTEGER as long int.
74: .TP
75: .B -onetrip
76: Compile DO loops that are performed at least once if reached.
77: (Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.)
78: .TP
79: .B -U
80: Honor the case of variable and external names. Fortran keywords must be in
81: .I
82: lower
83: case.
84: .TP
85: .B -u
86: Make the default type of a variable `undefined' rather than using the default Fortran rules.
87: .TP
88: .B -w
89: Suppress all warning messages.
90: If the option is
91: .LR -w66 ,
92: only Fortran 66 compatibility warnings are suppressed.
93: .PP
94: The following options are peculiar to
95: .IR f\^2c .
96: .TP
97: .B -A
98: Produce
99: .SM ANSI
100: C.
101: Default is old-style C.
102: .TP
103: .B -a
104: Make local variables automatic rather than static
105: unless they appear in a
106: .SM "DATA, EQUIVALENCE, NAMELIST,"
107: or
108: .SM SAVE
109: statement.
110: .TP
111: .B -C++
112: Output C++ code.
113: .TP
114: .B -c
115: Include original Fortran source as comments.
116: .TP
117: .B -E
118: Declare uninitialized
119: .SM COMMON
120: to be
121: .B Extern
122: (overridably defined in
123: .F f2c.h
124: as
125: .B extern).
126: .TP
127: .B -ec
128: Place uninitialized
129: .SM COMMON
130: blocks in separate files:
131: .B COMMON /ABC/
132: appears in file
133: .BR abc_com.c .
134: Option
135: .LR -e1c
136: bundles the separate files
137: into the output file, with comments that give an unbundling
138: .IR sed (1)
139: script.
140: .TP
141: .B -ext
142: Complain about
143: .IR f\^77 (1)
144: extensions.
145: .TP
146: .B -f
147: Assume free-format input: accept text after column 72 and do not
148: pad fixed-format lines shorter than 72 characters with blanks.
149: .TP
150: .B -72
151: Treat text appearing after column 72 as an error.
152: .TP
153: .B -g
154: Include original Fortran line numbers in \f(CW#line\fR lines.
155: .TP
156: .B -h
157: Emulate Fortran 66's treatment of Hollerith: try to align character strings on
158: word (or, if the option is
159: .LR -hd ,
160: on double-word) boundaries.
161: .TP
162: .B -i2
163: Similar to
164: .BR -I2 ,
165: but assume a modified
166: .I libF77
167: and
168: .I libI77
169: (compiled with
170: .BR -Df\^2c_i2 ),
171: so
172: .SM INTEGER
173: and
174: .SM LOGICAL
175: variables may be assigned by
176: .SM INQUIRE
177: and array lengths are stored in short ints.
178: .TP
179: .B -kr
180: Use temporary values to enforce Fortran expression evaluation
181: where K&R (first edition) parenthesization rules allow rearrangement.
182: If the option is
183: .LR -krd ,
184: use double precision temporaries even for single-precision operands.
185: .TP
186: .B -P
187: Write a
188: .IB file .P
189: of ANSI (or C++) prototypes
190: for definitions in each input
191: .IB file .f
192: or
193: .IB file .F .
194: When reading Fortran from standard input, write prototypes
195: at the beginning of standard output. Option
196: .B -Ps
197: implies
198: .B -P
199: and gives exit status 4 if rerunning
200: .I f\^2c
201: may change prototypes or declarations.
202: .TP
203: .B -p
204: Supply preprocessor definitions to make common-block members
205: look like local variables.
206: .TP
207: .B -R
208: Do not promote
209: .SM REAL
210: functions and operations to
211: .SM DOUBLE PRECISION.
212: Option
213: .L -!R
214: confirms the default, which imitates
215: .IR f\^77 .
216: .TP
217: .B -r
218: Cast values of REAL functions (including intrinsics) to REAL.
219: .TP
220: .B -r8
221: Promote
222: .SM REAL
223: to
224: .SM DOUBLE PRECISION, COMPLEX
225: to
226: .SM DOUBLE COMPLEX.
227: .TP
228: .B -s
229: Preserve multidimensional subscripts.
230: .TP
231: .BI -T dir
232: Put temporary files in directory
233: .I dir.
234: .TP
235: .B -w8
236: Suppress warnings when
237: .SM COMMON
238: or
239: .SM EQUIVALENCE
240: forces odd-word alignment of doubles.
241: .TP
242: .BI -W n
243: Assume
244: .I n
245: characters/word (default 4)
246: when initializing numeric variables with character data.
247: .TP
248: .B -z
249: Do not implicitly recognize
250: .SM DOUBLE COMPLEX.
251: .TP
252: .B -!bs
253: Do not recognize \fIb\fRack\fIs\fRlash escapes
254: (\e", \e', \e0, \e\e, \eb, \ef, \en, \er, \et, \ev) in character strings.
255: .TP
256: .B -!c
257: Inhibit C output, but produce
258: .B -P
259: output.
260: .TP
261: .B -!I
262: Reject
263: .B include
264: statements.
265: .TP
266: .B -!i8
267: Disallow
268: .SM INTEGER*8.
269: .TP
270: .B -!it
271: Don't infer types of untyped
272: .SM EXTERNAL
273: procedures from use as parameters to previously defined or prototyped
274: procedures.
275: .TP
276: .B -!P
277: Do not attempt to infer
278: .SM ANSI
279: or C++
280: prototypes from usage.
281: .PP
282: The resulting C invokes the support routines of
283: .IR f\^77 ;
284: object code should be loaded by
285: .I f\^77
286: or with
287: .IR ld (1)
288: or
289: .IR cc (1)
290: options
291: .BR "-lF77 -lI77 -lm" .
292: Calling conventions
293: are those of
294: .IR f\&77 :
295: see the reference below.
296: .br
297: .SH FILES
298: .TP
299: .IB file .[fF]
300: input file
301: .TP
302: .B *.c
303: output file
304: .TP
305: .F /usr/include/f2c.h
306: header file
307: .TP
308: .F /usr/lib/libF77.a
309: intrinsic function library
310: .TP
311: .F /usr/lib/libI77.a
312: Fortran I/O library
313: .TP
314: .F /lib/libc.a
315: C library, see section 3
316: .SH "SEE ALSO"
317: S. I. Feldman and
318: P. J. Weinberger,
319: `A Portable Fortran 77 Compiler',
320: \fIUNIX Time Sharing System Programmer's Manual\fR,
321: Tenth Edition, Volume 2, AT&T Bell Laboratories, 1990.
322: .SH DIAGNOSTICS
323: The diagnostics produced by
324: .I f\^2c
325: are intended to be
326: self-explanatory.
327: .SH BUGS
328: Floating-point constant expressions are simplified in
329: the floating-point arithmetic of the machine running
330: .IR f\^2c ,
331: so they are typically accurate to at most 16 or 17 decimal places.
332: .br
333: Untypable
334: .SM EXTERNAL
335: functions are declared
336: .BR int .
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.