home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pdp10 / tops-10 / forflo.hlp < prev    next >
Text File  |  1995-04-05  |  6KB  |  187 lines
  1.                 FORFLO: Help & Documentation.
  2.  
  3.         FORFLO is started by the command RUN PUB:FORFLO.
  4.  
  5.         FORFLO performs many functions on FORTRAN source files:
  6.  
  7.         1.      Relabel FORTRAN  source  ststements.  Statements  are
  8. given  new  numbers in ascending sequence. As a part of this process,
  9. FORMAT statements may  be  moved  to  the  end  of  the  program  and
  10. relabeled.
  11.  
  12.         2.      Create a flowchart of the source program
  13.  
  14.         3.      Optionally, reformat the source file into  80  column
  15. card images, suitable for batch oriented compilers.
  16.  
  17. ---------------------------------------------------------------------
  18.  
  19.         FORFLO commands have the following form:
  20.  
  21.         revision,listing_source
  22.  
  23.         Each of the terms in a command takes the form of:
  24.  
  25.         DEV:NAME.EXT,
  26.                 where DEV is a device name, NAME and EXT are  the  file  name
  27. and extension of the file to be written on the device.
  28.  
  29.         The "revision" term denotes the output file where the revised
  30. source will be written.  If no extension is given then ".FOR" will be
  31. sed.
  32.  
  33.         The  "listing"  term  denotes  the destination of the listing
  34. file.  This can be LPT: or it may be a disk file.  If no extension is
  35. given ".LST" is assumed.
  36.  
  37.         The  "source" term names the file that is to be processed.  A
  38. project-programmer number, enclosed in square brackets  is  permitted
  39. in  the  source  term.  If no extension is given with the source file
  40. name and if the file named (with blank extension) can not  be  found,
  41. then the extension ".F4" is tried.
  42.  
  43.         If  the  DEVice  term  is omitted anywhere, the device DSK is
  44. assumed.
  45.  
  46.         If "NAME." appears, this forces a blank extension.
  47.  
  48.         If the "revision" term is omitted then no revised source file
  49. will be created.  The command
  50.  
  51.         ,listing_source
  52.  
  53. will produce only a listing file.
  54.  
  55.         If  the  listing  term is omitted, then no flowchart or cross
  56. reference can be made.  The revised  file  only  is  created  by  the
  57. command:
  58.  
  59.         revision_source.
  60.  
  61.         If  both the listing and revision terms are omitted, then the
  62. input file will be checked for those errors that FORFLO  can  detect.
  63. Error  messages  will  be sent to the user console.  Note the command
  64. _source without switches is illegal because (see below)  the  absence
  65. of  switches  in  the  command implies flowcharting, but no flowchart
  66. occurs without a listing device.
  67.  
  68.         Switches are used to change  the  default  operation  of  the
  69. program.    All  switches  are  in the form of "/nnnL" where nnn is a
  70. (possibly empty, empty = 0) string of  digits  and  L  stands  for  a
  71. particular switch letter.
  72.  
  73.         If  no  switches  are  seen in the command then the following
  74. defaults are specified:
  75.  
  76.         Cross Reference, Flowchart, relabeling (increment = 10)
  77.         Format shuffle (first Format number = 10010)
  78.  
  79.         If  any  switch  is  seen  then  the  program will be set for
  80. relabeling (by 10) only.  Switches are then used to  specify  further
  81. actions  to be performed by the program. Switches may appear anywhere
  82. in the command  string  as  long  as  they  do  not  break  any  name
  83. specification.
  84.  
  85.         The available switches are:
  86.  
  87.  
  88.         /nnnS
  89.         Use  nnn  as the increment in sequence numbering. The default
  90. increment is zero. If the increment is zero then DEC formst  will  be
  91. used  in  the  revision  file.   If the increment is non-zero then 80
  92. column card image output will be prepared.  Sequenceing  is  done  in
  93. columns  73-80.  Columns 73-76 contain a four letter subroutine name;
  94. Columns 77-80 contain a four digit number that  counts  multiples  of
  95. the sequencing increment
  96.  
  97.  
  98.         /nnnL
  99.         Use nnn as the increment in renumbering the statement labels.
  100. /L OR /0L implies no renumbering of statements. The default increment
  101. is 10.
  102.  
  103.         /A
  104.         Make a Flowchart (implies /C). A listing device is required.
  105.  
  106.         /H
  107.         Type  the  Help Listing (This listing).  The Help file should
  108. be on SYS:FORFLO.HLP.
  109.  
  110.         /T
  111.         No  Tab  conversion.  Tabs that occur in the source file will
  112. not be converted to spaces.  /0S is implied by /T. If  conversion  to
  113. card images is requested, then tabs will be changed to blanks.
  114.  
  115.  
  116.         /B
  117.         This switch causes blank lines in the source to be deleted.
  118.  
  119.         /K
  120.         Keypunch conversion.  The following substitutions are made:
  121.  
  122.         ( FOR %
  123.         ) FOR <
  124.         = FOR #
  125.         ' FOR @
  126.         + FOR &
  127.  
  128.         This is provided to aid the conversion of  decks  punched  on
  129. 026 keypunches to 029 character codes.
  130.  
  131.         /nnnF
  132.         Format Shuffle:   All the FORMAT statements  in  the  program
  133. will  be moved to the end of the program.  The argument, nnn, is used
  134. to  specify  the  number  with  which  the  first  format  should  be
  135. relabeled.
  136.  
  137.         /C
  138.         Make a Cross Reference table. A listing device is required.
  139.  
  140.         /Q
  141.         QUIET.  Suppress all of the listing except for the flowchart.
  142.  
  143.         /X
  144.         Flowchart only. This is the same as  /L/A/S/T/Q.   No  source
  145. modification is done; the listing includes only the Flowchart.
  146.  
  147.         /Y
  148.         Do everything.  The effect is:
  149.                 1. Move FORMATs to the end of the program.
  150.                 2. Resequence the statement numbers
  151.                 3. Flowchart the revised program.
  152.                 (No sequencing is done. Tabs are preserved.)
  153.  
  154.         /W
  155.         No  warnings:  if this switch is set then no warning messages
  156. about line truncation will be typed.  Lines that  exceed  72  columns
  157. (counting  tabs  as  occupying  multiple columns) are truncated to 72
  158. columns.   Whenever line truncation occurs a message  is  typed.   If
  159. this switch is set then the message is suppressed.
  160.  
  161.  
  162. ---------------------------------------------------------------------
  163.  
  164.         Command abbreviation.  The command:
  165.  
  166.         source
  167.  
  168.         is an abbreviation of the command
  169.  
  170.         name,name_source
  171.  
  172.         where "name" is the name of the source file found in "source".
  173.  
  174.  
  175.  
  176.  
  177.         The command:
  178.  
  179.                 NAME!
  180.  
  181.         will  cause  the core image file named NAME to be loaded from
  182. device  SYS  and  started.  See  the  Time-Sharing  Monitor   manual,
  183. DEC-T9-MTZA-D, Addendum 1, section 6.3 for details.
  184.  
  185. .KJOB
  186. .
  187.