Documenting automated Fortran-C++ bindings with SWIG

Abstract

A new SWIG/Fortran tool introduced in Johnson et al. [to appear] automatically generates native Fortran 2003 interfaces to C and C++ libraries. This allows a seamless integration of existing C++ libraries into the Fortran applications. However, using the generated interfaces is complicated by the lack of appropriate documentation. In this report, we document a way to automatically port the existing Doxygen documentation of the C++ libraries to Fortran. We use ForTrilinos library as our target application, and discuss the scope and limitations of this approach.