[comp.lang.fortran] Documentation for f77

bill@stratus.UUCP (Bill Appelbe) (10/26/87)

We have developed a modified f77 compiler (that provides microtasking
primitives) front-end (based on 4.2 BSD source) ... and I'm realizing
the need for a good document to simplify the maintenance task (Universities
have a fairly high turn over! and our modified compiler has been worked
on by several people at UCSD, Georgia Tech., and UCSC over a period of
almost 3 years now).

The modified f77 compiler is actually a static analyzer that checks for
potential bugs, or anomalies, due to the (mis)use of multitasking. Our
second pass is totally independent of the f77 p2 (except for the parsing
of the I-code and symbol table files), but our pass1 is 99% the same as
the f77 p1.

All of the above is just the preamble to the question ...

Does anyone have any `source code documentation' for f77 pass1
(e.g., descriptions of the I-code, symbol table format, 
annotated cross-references, etc.) that we could `build upon'
rather than starting from scratch.
Anything that is public-domain, or rather close-to-free to holders
of a BSD UNIX/V source licence, would be appreciated!
I know of and have the source documentation for portable C compiler
(no, not just the standard `guide to the portable C compiler'), and
would like to put together something comparable, and have a willing
undergraduate to help.
Our documentation is being put together this quarter, and, of-course,
we are willing to give it to other sites with a source licence ...
Documentation of the changes we have made will be separate from the
documentation of the vanilla 4.2 BSD p1.

Failing anyone having any available documentation for f77, can anyone recommend
or provide a `guide to writing technical source code documentation'
that I could give to our technical writer?
	Cheers -- Bill (bill@gatech.edu, 404-894-6187)