1 CLEANUP

CLEANUP is a program that will clean up FORTRAN 77 source code files.
It includes the features of the old INDENT, TIDY and COMCLEAN
programs, as well as some unique new features. A new file is created
containing the CLEANed code (filespec.FOR if the job completed 
successfully, or filespec.NEW otherwise.) Warning and error messages
produced during processing are written to filespec.LOG. 

Execute the program by entering:

    CLEANUP filespec [optionspec [authorspec]] [quesize]

where filespec is the name of the FORTRAN source file and optionspec
is an optional file of program options. Options may also be specified
by using control cards inserted within the source file. If no options
are specified, program defaults are used.  Authorspec is an optional
file of author information for the PROLOGUE option. Optionspec must be
entered before authorspec, if authorspec is specified. Entering
quesize causes the job to be run in the specified batch queue. If no
quesize is entered, the default is MEDIUM. See DOCUMENT:CLEANUP.DOC
for more information and sample files. 

2 OPTIONS

ALIGN[=n]          - Align all equal signs in assignment statements
                     in column 'n'
ARGUMENT           - Put a space between each
                     argument in statements with argument lists 
COMMENT[=x]        - Change all comment
                     characters to a single specified character 
CONTINUE[=x]       - Use a single character for all continuations
DLINES=x           - Convert VAX D_LINES into comments (x=1) or
                     convert VAX D_LINES into code (x=2)
EXCOMM             - Move '!' type comments (at the end of cards) to
                     to become stand alone comments preceeding the
                     card that contained them
EXEMPT             - Skip a particular subprogram(s) 
INCLUDE            - Add the code specified by the VAX FORTRAN INCLUDE
                     statement to the file being CLEANed 
INDENT[=n]         - Indent IF blocks and DO loops n columns
MOVE               - Move all FORMAT statements to the ends of 
                     subprograms
PROLOGUE[*]        - Create prologues for subprograms (optionally 
                     specifying '*' for author information file
RENUMBER[=min/inc] - Renumber, right justify and replace all references 
                     to the  statement numbers.  Start at min, and 
                     increment by inc.
STRUCTURE          - Structure specification statements by aligning the 
                     variable names in columns
WARNINGS           - Produce warning messages about deletions          

2 DEFAULTS

NOALIGN, NOARGUMENT, NOCOMMENT, CONTINUE=(sequence), DLINES=0, EXCOMM, 
NOEXEMPT, NOINCLUDE, NOINDENT, NOMOVE, NOPROLOGUE, STRUCTURE, WARNING

2 NON-OPTIONAL_FEATURES

CLEANUP automatically :
- replaces Hollerith fields with character strings
- replaces blank cards with comment cards
- deletes unreferenced statement labels
- deletes unreferenced CONTINUE statements
- converts unused FORMAT statements to comment cards
- breaks lines for continuation only after an operator or delimiter
- spaces continued portion of assignment statements past the column
  where the equal sign resides

2 BATCH_QUEUES

SHORT - to use queue SYS$BATCH (1.5 minutes CPU)
none  - to use queue BAT$MEDIUM (20 minutes CPU)
LONG  - to use queue BAT$LONG (60 minutes CPU)
XLONG - to use queue BAT$XLONG (no CPU time limit)
