Welcome to FOR_STUDY, your FORTRAN source browser. Use FOR_STUDY to check, document, and design your FORTRAN application.
To begin using FOR_STUDY, you must first define (or select) a project. A project consists of a group of FORTRAN source files (and libraries) that comprise either an application or library. In addition, specify the FORTRAN vendor with the FOR Option (and possibly other syntax related options).
Following the definition of the project, you will need to generate interfaces for the routines in the project. This is done with the INTRF option. The in-context messages produced by FOR_STUDY from this, as well as regular analysis, can be viewed from the Messages selection on the Table of Contents. Review carefully any error messages produced - either correcting the source or choosing more appropriate syntax options. The interfaces generated from this analysis are used to document the routines call frame and to check calls for consistency. An interface analysis should be done whenever routines are added (or deleted) from the project, or the argument list definition is changed.
Interfaces are generated in Fortran-90 format and output to the "fstudy.ntf" file (or the filename supplied with the INF option). In general, these interfaces are valid Fortran-90 source and can be used with 90 compilers. The interfaces are also output with the Local reports and are the first item displayed when jumped to from either the Function summary or Call Tree.
After generating interfaces for the application FOR_STUDY must be run once again (but without the INTRF option) to generate the various reports for the application. To be accurate, the entire application must be analyzed by FOR_STUDY in one run.
The Interface Option, -INTRF, generates interfaces for the project. Any interface file present when the run begins, will be read and those interfaces added to the internal table. When processing finishes, all interfaces generated for the routines processed, plus those defined in your original interface file, will be written out to the new file. Old interfaces (corresponding to deleted or renamed routines) can be purged if desired with the purge interface option (-INTRF=P).
The Interface option must be run at least once for a given application prior to regular analysis by FOR_STUDY, but you don't need to make an interface run prior to every regular run. However, whenever you change function definitions (i.e., add routines, rename them, or change argument lists), you should re-generate interfaces for the application or library. Messages will be issued during regular runs when the function/subroutine definition differs with the interface - or if no interface is provided for a given routine. NOTE: Don't confuse these messages with interface warnings issued with calls to routines.
When the Interface option is selected, no Reports are generated. Syntax Errors should be resolved either by correcting the source code, or by selecting more appropriate syntax options - and the interfaces re-run. (Note: syntax errors are due to different FORTRAN statement construction and should get your immediate attention, whereas semantic errors resolution may be delayed until later in the analysis.) Otherwise incorrect interfaces or reports may be generated.