Documentation tools for Fortran codes

Help
2

  1. Doxygen’s treatment of Fortran is not so bad for Fortran 90 code. However, based on my experience, problems start to emerge when there is a Fortran 2003 OOP code or Fortran 2008 features like submodule. If people continue using it, then one can hope to see the new features of Fortran being supported in the future as well.

  2. I cannot speak of other Fortran documentation tools. However, I can attest that the document preparation with and syntax of Doxygen is relatively straightforward and powerful enough to achieve my goals. Compared to the sphinx, I like Doxygen’s syntax and find it more appealing and easier to implement. Equations are also easy to implement and follow the syntax of LaTex.

Here is an example: https://www.cdslab.org/paramonte/notes/api/kernel/index.html

The preparation of this entire documentation using Doxygen took 2-3 days to complete.

2 Likes