Extraction of documentation from fortran 90 source code: An industrial experience
|Title||Extraction of documentation from fortran 90 source code: An industrial experience|
|Booktitle||Proceedings of the 17th European Conference on Software Maintenance and Reengineering (CSMR 2013)|
|Pages||99-402 (DOI: 10.1109/CSMR.2013.58)|
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.