[unix-history] / usr / doc / ratfor / m99

.bp
.if t .1C
.SH
Appendix: Usage on
.UC UNIX 
and
.UC GCOS .
.PP
Beware _
local customs vary.
Check with a native before going into the jungle.
.SH
UNIX
.PP
The program
.UL ratfor
is the basic translator; it takes either a list
of file names or the standard input and writes
Fortran on the standard output.
Options include
.UL \-6x ,
which uses
.UL x
as a continuation character in column 6
.UC UNIX "" (
uses 
.UL & 
in column 1),
and
.UL \-C ,
which causes Ratfor comments to be copied into
the generated Fortran.
.PP
The program
.UL rc
provides an interface to the
.UL ratfor
command which is much the same as
.UL cc .
Thus
.P1
rc [options] files
.P2
compiles the files specified by
.UL files .
Files with names ending in
.UL \&.r
are Ratfor source; other files are assumed to
be for the loader.
The flags
.UL \-C 
and
.UL \-6x
described above are recognized, as are
.P1
-c	compile only; don't load
-f	save intermediate Fortran .f files
-r	Ratfor only; implies -c and -f
-2	use big Fortran compiler (for large programs)
-U	flag undeclared variables (not universally available)
.P2
Other flags are passed on to the loader.
.SH
GCOS
.PP
The program
.UL \&./ratfor
is the bare translator, and is identical to the
.UC UNIX
version, except that the continuation convention
is 
.UL &
in column 6.
Thus
.P1
\&./ratfor  files  >output
.P2
translates the Ratfor source on
.UL files 
and
collects the generated Fortran on file
`output'
for subsequent processing.
.PP
.UL \&./rc
provides much the same services as
.UL rc 
(within the limitations of
.UC GCOS ),
regrettably with a somewhat different syntax.
Options recognized by
.UL ./rc
include
.P1
.ta 1.2i
name	Ratfor source or library, depending on type
h=/name	make TSS H* file (runnable version); run as /name
r=/name	update and use random library
a=	compile as ascii (default is bcd)
C=	copy comments into Fortran
f=name	Fortran source file
g=name	gmap source file
.P2
Other options are as specified for the
.UL \&./cc
command described in [4].
.SH
TSO, TSS, and other systems
.PP
Ratfor exists on
various other systems;
check with the author for specifics.
Commit	Line	Data
8340f87c BJ	1	.bp
	2	.if t .1C
	3	.SH
	4	Appendix: Usage on
	5	.UC UNIX
	6	and
	7	.UC GCOS .
	8	.PP
	9	Beware _
	10	local customs vary.
	11	Check with a native before going into the jungle.
	12	.SH
	13	UNIX
	14	.PP
	15	The program
	16	.UL ratfor
	17	is the basic translator; it takes either a list
	18	of file names or the standard input and writes
	19	Fortran on the standard output.
	20	Options include
	21	.UL \-6x ,
	22	which uses
	23	.UL x
	24	as a continuation character in column 6
	25	.UC UNIX "" (
	26	uses
	27	.UL &
	28	in column 1),
	29	and
	30	.UL \-C ,
	31	which causes Ratfor comments to be copied into
	32	the generated Fortran.
	33	.PP
	34	The program
	35	.UL rc
	36	provides an interface to the
	37	.UL ratfor
	38	command which is much the same as
	39	.UL cc .
	40	Thus
	41	.P1
	42	rc [options] files
	43	.P2
	44	compiles the files specified by
	45	.UL files .
	46	Files with names ending in
	47	.UL \&.r
	48	are Ratfor source; other files are assumed to
	49	be for the loader.
	50	The flags
	51	.UL \-C
	52	and
	53	.UL \-6x
	54	described above are recognized, as are
	55	.P1
	56	-c compile only; don't load
	57	-f save intermediate Fortran .f files
	58	-r Ratfor only; implies -c and -f
	59	-2 use big Fortran compiler (for large programs)
	60	-U flag undeclared variables (not universally available)
	61	.P2
	62	Other flags are passed on to the loader.
	63	.SH
	64	GCOS
65	.PP
66	The program
67	.UL \&./ratfor
68	is the bare translator, and is identical to the
69	.UC UNIX
70	version, except that the continuation convention
71	is
72	.UL &
73	in column 6.
74	Thus
75	.P1
76	\&./ratfor files >output
77	.P2
78	translates the Ratfor source on
79	.UL files
80	and
81	collects the generated Fortran on file
82	`output'
83	for subsequent processing.
84	.PP
85	.UL \&./rc
86	provides much the same services as
87	.UL rc
88	(within the limitations of
89	.UC GCOS ),
90	regrettably with a somewhat different syntax.
91	Options recognized by
92	.UL ./rc
93	include
94	.P1
95	.ta 1.2i
96	name Ratfor source or library, depending on type
97	h=/name make TSS H* file (runnable version); run as /name
98	r=/name update and use random library
99	a= compile as ascii (default is bcd)
100	C= copy comments into Fortran
101	f=name Fortran source file
102	g=name gmap source file
103	.P2
104	Other options are as specified for the
105	.UL \&./cc
106	command described in [4].
107	.SH
108	TSO, TSS, and other systems
109	.PP
110	Ratfor exists on
111	various other systems;
112	check with the author for specifics.