🚀 go-pugleaf

Submitted-by: mako@uihepa.hep.uiuc.edu ("Makoto Shimojima, Univ of Tsukuba/CDF")
Posting-number: Volume 4, Issue 56
Archive-name: fortran_index/part01

            INDEX-FORTRAN Cross Referencer and Flow Chart Generator

                                     V3.29

     Michael N.  LeVine
     Code 3512
     Naval Weapons Center
     China Lake
     California
     93555

     (619) 939-2614
      AVN  437-2614
     levine%fidler.decnet@nwc.navy.mil


                                    ABSTRACT

          INDEX is a FORTRAN source cross-referenceing  and  flow  charting
     utility  that  allows  the  user  to  look  at individual source files
     (optionally saving the data for an overall SUPER INDEX) and  determine
     what  variables  are  used  on  what  lines  and  how  they  are used.
     Furthermore the user can select for display/save for SUPER INDEX  only
     those  variables  or COMMON blocks with the characteristics that he is
     interested  in-global/local,  assigned   value/not   assigned   value,
     used/unused,   imported/exported,   etc   in  any  combination.   Also
     available is the optional ability to show up to four additional  items
     of information for display during the regular and SUPER INDEX:

          The variable storage location information (local, in COMMON,
          passed by argument, etc).

          The  variable  type   (REAL   F_Floating,   structured   etc
          includeing if an array)

          Usage in FUNCTION/SUBROUTINE  calls  (routine  used  in  and
          argument number).

          A user selected tag of up to 31 characters.

     The data saved for a SUPER INDEX listing (consisting of 6  data  items
     as  outlined  above) can be displayed with a great deal of flexibility
     as to the data item selection, order and format (or saved in  an  ISAM
     data  file for the user to work on directly).  A special option of the
     SUPER INDEX allows the output of a list of module entry  points  which
     pass  data  in and out by argument, the name of each argument and it's
     type , the name of any module which call that entry point  along  with
     the  the  name  of  each variable passed in the corresponding argument
     position and it's type.  The resulting information supplied allows the
     user to follow the flow of data throughout a program or find the usage
     of any selected data variable as required.

          If selected, the user may at the same time generate a flow  chart
     of  the  source  file  (optional  mini form available) currently being
     cross-referenced.

          If wanted, the user can generate in place of the SUPER INDEX,  an
     entry  point  cross  reference  listing  showing  who calls who and is
     called by who (with optional graphical tree output).