Water Resources Applications Software
Summary of SYSDOC
NAME
sysdoc - System documentation for Fortran source code
ABSTRACT
The SYSDOC program is used to produce detailed documentation
directly from Fortran source code. The program produces text files
summarizing programs, subroutines, functions, and common blocks and
includes details on the links between them. SYSDOC can be used to
analyze standard Fortran 77 that conforms to the conventions
described in the documentation. The program recognizes two
extensions to the Fortran 77 standard, include files and lower case.
HISTORY
Version 1.0 1996/03/01
DATA REQUIREMENTS
Source code must be ANSI Fortran 77 compliant and must conform to
the conventions described in the documentation. Each main program,
subroutine, and function should include comments describing the
purpose of the routine and each input argument. The program cannot
process PARAMETER Statements that contain nested parenthesis.
SYSDOC can process include files.
OUTPUT OPTIONS
For each program, subroutine, and (or) function included, the report
may contain (1) routine name; (2) routine type, order number in the
source file, and the name of the source file; (3) description of the
purpose of the routine; (4) for each argument, the order number,
name, data type and size, the input/modify/output status, and a
description; (5) usage of common block variables; (6) list of any
called routines, both intrinsics and externals; and (7) list of any
other routines in the report that call the routine. Optional index
files may also be generated.
SYSTEM REQUIREMENTS
SYSDOC is written in Fortran 77 with the following extension: use of
include files. The UTIL library from LIB is required to recompile.
For more information, see System Requirements in LIB.
DOCUMENTATION
Flynn, K.M., Kittle, J.L., Jr., and Lumb, A.M., 1994, A Fortran
coding convention for use in the U.S. Geological Survey, Water
Resources Division: U.S. Geological Survey Open-File Report
94-501, 64 p.
CONTACTS
Operation and Distribution:
U.S. Geological Survey
Hydrologic Analysis Software Support Program
437 National Center
Reston, VA 20192
h2osoft@usgs.gov
Official versions of U.S. Geological Survey water-resources analysis
software are available for electronic retrieval via the World Wide
Web (WWW) at:
http://water.usgs.gov/software/
and via anonymous File Transfer Protocol (FTP) from:
water.usgs.gov (path: /pub/software).
The WWW page and anonymous FTP directory from which the SYSDOC
software can be retrieved are, respectively:
http://water.usgs.gov/software/sysdoc.html
--and--
/pub/software/general/sysdoc
The URL for this page is: http://water.usgs.gov/cgi-bin/man_wrdapp?sysdoc
Send questions or comments to h2osoft@usgs.gov