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. |