As far as I can see, https://fortran-lang.org/packages/programming only lists one documentation tool, FORD (https://github.com/Fortran-FOSS-Programmers/ford), which using the words of his creator is “in a pretty deep coma” (FORD issue #317): despite 67 open issues and 17 pull requests, the last commit is dated 15 months ago. This lack of maintenance discourages its adoption.
- What are the alternatives for documenting Fortran code in a robust, sustainable way? I am particularly interested in generating documentation that is mathematically rich, and that would benefit from diagrams and links to research articles.
In case the answer is Doxygen:
FORD’s documentation states that it was written “due to Doxygen’s poor handling of Fortran”. Could somebody be more specific, and describe the issues with Doxygen’s handling of Fortran?
I’ve read that Doxygen allowing rich text via Markdown rather than reST makes it less powerful than Sphinx, and that there seems to be ways of inserting reST in Doxygen comments and produce Sphinx documentation via Doxygen XML output -> some tools (Breathe?) -> Sphinx. Would this work for a Fortran code?
Is FORD-ready code compatible with Doxygen or vice-versa?