RbG: A documentation generator for scientific and engineering software

M. Moser, G. Fleck, M. Witlatschil. RbG: A documentation generator for scientific and engineering software. pages 464-468, 3, 2015.

Autoren
  • Michael Moser
  • Günther Fleck
  • Michael Witlatschil
BuchProceedings of the 22nd IEEE International Conference on Software Analysis, Evolution (SANER'15)
TypIn Konferenzband
VerlagIEEE
ISBN978-1-4799-8469-5/15
Monat3
Jahr2015
Seiten464-468
Abstract

This paper demonstrates RbG, a new tool intended for the generation of high-quality documentation from source code of scientific and engineering applications. RbG extracts mathematical formulae and decision tables from program statements by means of static code analysis and generates corresponding documentation in the Open Document Format or LaTeX. Annotations in source code comments are used to define the structure of the generated documents, include additional textual and graphical descriptions, and control extraction of formulae on a fine-grained level. Furthermore, RbG provides an interpreter to generate function plots for extracted formulae. In this tool demonstration we briefly introduce the tool and show its usage for different scenarios such as reverse engineering and re-documentation of legacy code and documentation generation during development and maintenance of software.