There is a substantial body of existing Fortran software that has considerable scientific and commercial value, but whose potential is sometimes difficult to exploit to the full because of a lack of structure and internal documentation. This article discusses, by means of an example, how the OLYMPUS COMPOSITOR can be used to regenerate such software semi-automatically so that it meets improved documentation standards. Comments and headings can be edited in on-line, using a free format, and the COMPOSITOR then produces a clear standard layout in which the Fortran statement numbers are correlated with the decimally numbered sections and subsections of an individual routine, and the meaning of the code is clarified by appropriate indentation and cross-referencing. Using the OLYMPUS GENERATOR one can also restructure the COMMON blocks and construct indexes of variables. It is suggested that such techniques can materially enhance the usefulness of a great deal of Fortran software, including some of the programs already included in the CPC Program Library.
Read full abstract