ESTS0643 TIDY6.21.

1. NAME OR DESIGNATION OF PROGRAM:  TIDY6.21.

3. DESCRIPTION OF PROBLEM OR FUNCTION

TIDY6.21 is a utility program for processing FORTRAN source programs into a standard form which is easy to read and modify. In processing FORTRAN software it renumbers statement labels so that they appear in increasing order, removes statement labels from unreferenced statements, deletes unreferenced  FORMAT and CONTINUE statements, and indents DO loops and IF levels.  FORMAT statements may optionally be collected at the end of routines. Blanks are inserted and removed to improve readability. Automatic generation of an END statement at the end of a routine can be suppressed if desired, which allows for the processing of FORTRAN INCLUDE files. Hollerith strings and strings delimited by a character other than an apostrophe are recognized and, optionally, translated to apostrophe-delimited strings. All lower-case alphabetical characters are translated to upper-case except those in strings, Hollerith constants, and COMMENT statements. In addition, the character used to denote alternate return addresses in CALL statements can be changed.

4. METHOD OF SOLUTION

TIDY accepts as input ANSI FORTRAN 77 source, some IBM- and CDC-specific statements, and FORTRAN II and FORTRAN IV source statements. The utility identifies each statement by type and class. Each FORTRAN keyword implies a different statement type, of which there are 80. These are grouped into 9 statement classes and treated independently by the program. TIDY processing is done in two passes.

5. RESTRICTIONS ON THE COMPLEXITY OF THE PROBLEM

Maxima of -
   1500 distinct statement numbers
   1500 distinct reference numbers
     19 continuation statements
     10 nested DO loops
Generally, vendor extensions to ANSI FORTRAN 77 are not supported.

6. TYPICAL RUNNING TIME

Execution time varies with the size of the program that is being processed. NESC processed the sample problems  in 2 minutes on an IBM PS/2 Model 70 and in 15 seconds on an IBM4331.

In the tests performed at the NEA/DB, the sample problems were executed on the following systems: 1) PC-Brett Pentium processor of 75 MHz under MS-DOS 6.2; 2) DEC 3000 Model 300X, Alpha  AXP Workstation running DEC OSF/1 V3.2 Only a few tenths of a second are required to execute the sample problems in any of the test systems.

7. UNUSUAL FEATURES OF THE PROGRAM

Users may select various options for processing or "tidying" their programs.

8. RELATED AND AUXILIARY PROGRAMS

The original TIDY was developed by  Harry M. Murphy, Jr., Air Force Weapons Laboratory, Kirtland Air Force Base, New Mexico, in 1966. TIDY and TIDY4.63 (NESC Abstract 857) perform similar functions for CDC, Cray and UNIVAC computers.

10. REFERENCES:

- H.M. Murphy Jr.:
  TIDY A Computer Code for Renumbering and Editing FORTRAN Source
  Programs
  Version 6.21 (September 21, 1990)
- L. Eyberger:
  NESC Note 91-03
  TIDY6.21, NESC no. 896.PC
  TIDY6.21 IBM PC Version Flexible Disk Cartridge Description and
  Implementation Information (October 3, 1990)

11. MACHINE REQUIREMENTS

TIDY6.21 requires 161 Kbytes of memory on an  IBM/PS Model 70 and 395 Kbytes on an IBM4331.

The program TIDY was installed compiled and executed on the following systems: 1) PC-Brett Pentium processor of 75 MHz, base memory 640 Kbyte and extended memory 16 Mbyte. The filesizes of the executables created with the Lahey compiler system F77L/EM-32 and with the Microsoft FORTRAN compiler are 317 and 131 Kbyte respectively. 2) DEC 3000 Model 300X - Alpha AXP Architecture Workstation, available memory 96 Mbyte.

13. OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED:  MS-DOS; PC-DOS

the program TIDY was installed compiled/linked and its  executed in the following systems: (1) PC-Brett Pentium processor of 75 MHz, under MS-DOS 6.2 ; the source file was compiled and linked using: - the Microsoft FORTRAN compiler (Version 5.1) and linker (Version 5.15) - the Lahey F77L/EM-32 compiler (Version 5.20) and linker (Version 5.1L). (2) DEC 3000 Model 300X - Alpha AXP Architecture Workstation under DEC OSF/1 V3.2; the source file was compiled using the DEC Fortran (f77) compiler (Version 3.4)

14. OTHER PROGRAMMING OR OPERATING INFORMATION OR RESTRICTIONS

Conversion information for implementing the IBM PC version in the UNIX environment is included in that package.

After implementing the instructions provided within the package to install TIDY on UNIX systems, the program TIDY was successfully compiled, linked and executed in the UNIX environment of a DEC 3000 Alpha AXP Architecture Workstation under OSF/1.

15. NAME AND ESTABLISHMENT OF AUTHOR

          A.G. Stangenberger
          Department of Forestry and Resource Management
          University of California, Berkeley

File name	File description	Records
ESTS0643_01.001	Information file of program TIDY Vers. 6.21	537
ESTS0643_01.002	Notes on converting TIDY on UNIX systems	30
ESTS0643_01.003	Source code of program TIDY for MS-DOS syst.	4775
ESTS0643_01.004	Source code of program TIDY for DEC OSF/1	4789
ESTS0643_01.005	Source code of function KUPPER for UNIX syst	71
ESTS0643_01.006	Include file with definition of COMMON's	45
ESTS0643_01.007	Include file containing the logical units	10
ESTS0643_01.008	TIDY executable file created with the Lahey	0
ESTS0643_01.009	TIDY executable file created with the MicroS	0
ESTS0643_01.010	Input file, sample problem # 1	65
ESTS0643_01.011	Input file, sample problem # 2	80
ESTS0643_01.012	Input file, sample problem # 3	81
ESTS0643_01.013	Printed output file, sample problem # 1	147
ESTS0643_01.014	Printed output file, sample problem # 2	161
ESTS0643_01.015	Printed output file, sample problem # 3	97
ESTS0643_01.016	Punched output file, sample problem # 1	54
ESTS0643_01.017	Punched output file, sample problem # 2	52
ESTS0643_01.018	Punched output file, sample problem # 3	29
ESTS0643_01.019	Lahey auxiliary file of runtime error messg.	0
ESTS0643_01.020	DOS file-names	19