Extraction of documentation from fortran 90 source code: An industrial experience

Autoren Josef Pichler
Editoren A Cleve
F. Ricca
M. Cerioli
TitelExtraction of documentation from fortran 90 source code: An industrial experience
BuchtitelProceedings of the 17th European Conference on Software Maintenance and Reengineering (CSMR 2013)
Typin Konferenzband
VerlagIEEE
ISBN978-1-4673-5833-0
MonatApril
Jahr2013
Seiten99-402 (DOI: 10.1109/CSMR.2013.58)
SCCH ID#1266
Abstract

Software programs in scientific and engineering domains typically contain complex and extensive computations that are additionally optimized concerning running time or memory requirements. As a consequence, the actual computations are often hard to comprehend from the source code only. This paper presents tool support to extract documentation from source code that reveals the actual computation. We discuss how to generate the entire documentation from the source code automatically by using a minimum of additional annotations. This makes writing documentation manually obsolete and ensures consistency between source code and documentation. Furthermore, the extracted documentation is given in a notation expected and comprehensible by domain experts. We applied our approach in the electrical engineering domain for software systems implemented in the Fortran 90 programming langugage.