FORFLO: Help & Documentation. FORFLO is started by the command RUN PUB:FORFLO. FORFLO performs many functions on FORTRAN source files: 1. Relabel FORTRAN source ststements. Statements are given new numbers in ascending sequence. As a part of this process, FORMAT statements may be moved to the end of the program and relabeled. 2. Create a flowchart of the source program 3. Optionally, reformat the source file into 80 column card images, suitable for batch oriented compilers. --------------------------------------------------------------------- FORFLO commands have the following form: revision,listing_source Each of the terms in a command takes the form of: DEV:NAME.EXT, where DEV is a device name, NAME and EXT are the file name and extension of the file to be written on the device. The "revision" term denotes the output file where the revised source will be written. If no extension is given then ".FOR" will be sed. The "listing" term denotes the destination of the listing file. This can be LPT: or it may be a disk file. If no extension is given ".LST" is assumed. The "source" term names the file that is to be processed. A project-programmer number, enclosed in square brackets is permitted in the source term. If no extension is given with the source file name and if the file named (with blank extension) can not be found, then the extension ".F4" is tried. If the DEVice term is omitted anywhere, the device DSK is assumed. If "NAME." appears, this forces a blank extension. If the "revision" term is omitted then no revised source file will be created. The command ,listing_source will produce only a listing file. If the listing term is omitted, then no flowchart or cross reference can be made. The revised file only is created by the command: revision_source. If both the listing and revision terms are omitted, then the input file will be checked for those errors that FORFLO can detect. Error messages will be sent to the user console. Note the command _source without switches is illegal because (see below) the absence of switches in the command implies flowcharting, but no flowchart occurs without a listing device. Switches are used to change the default operation of the program. All switches are in the form of "/nnnL" where nnn is a (possibly empty, empty = 0) string of digits and L stands for a particular switch letter. If no switches are seen in the command then the following defaults are specified: Cross Reference, Flowchart, relabeling (increment = 10) Format shuffle (first Format number = 10010) If any switch is seen then the program will be set for relabeling (by 10) only. Switches are then used to specify further actions to be performed by the program. Switches may appear anywhere in the command string as long as they do not break any name specification. The available switches are: /nnnS Use nnn as the increment in sequence numbering. The default increment is zero. If the increment is zero then DEC formst will be used in the revision file. If the increment is non-zero then 80 column card image output will be prepared. Sequenceing is done in columns 73-80. Columns 73-76 contain a four letter subroutine name; Columns 77-80 contain a four digit number that counts multiples of the sequencing increment /nnnL Use nnn as the increment in renumbering the statement labels. /L OR /0L implies no renumbering of statements. The default increment is 10. /A Make a Flowchart (implies /C). A listing device is required. /H Type the Help Listing (This listing). The Help file should be on SYS:FORFLO.HLP. /T No Tab conversion. Tabs that occur in the source file will not be converted to spaces. /0S is implied by /T. If conversion to card images is requested, then tabs will be changed to blanks. /B This switch causes blank lines in the source to be deleted. /K Keypunch conversion. The following substitutions are made: ( FOR % ) FOR < = FOR # ' FOR @ + FOR & This is provided to aid the conversion of decks punched on 026 keypunches to 029 character codes. /nnnF Format Shuffle: All the FORMAT statements in the program will be moved to the end of the program. The argument, nnn, is used to specify the number with which the first format should be relabeled. /C Make a Cross Reference table. A listing device is required. /Q QUIET. Suppress all of the listing except for the flowchart. /X Flowchart only. This is the same as /L/A/S/T/Q. No source modification is done; the listing includes only the Flowchart. /Y Do everything. The effect is: 1. Move FORMATs to the end of the program. 2. Resequence the statement numbers 3. Flowchart the revised program. (No sequencing is done. Tabs are preserved.) /W No warnings: if this switch is set then no warning messages about line truncation will be typed. Lines that exceed 72 columns (counting tabs as occupying multiple columns) are truncated to 72 columns. Whenever line truncation occurs a message is typed. If this switch is set then the message is suppressed. --------------------------------------------------------------------- Command abbreviation. The command: source is an abbreviation of the command name,name_source where "name" is the name of the source file found in "source". The command: NAME! will cause the core image file named NAME to be loaded from device SYS and started. See the Time-Sharing Monitor manual, DEC-T9-MTZA-D, Addendum 1, section 6.3 for details. .KJOB .