home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V7 / usr / doc / ratfor / m99 < prev   
Encoding:
Text File  |  1979-01-10  |  2.1 KB  |  113 lines

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