                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
.
