Doxygen或獅身人面像自動文檔Fortran

Question

我一直在使用Sphinx文件的Python代碼，但我現在正在一個Fortran項目，我也想autodocument。這可以通過Sphinx使用an extension來完成，但看起來這更多是Doxygen的本地特徵。

我寧願使用Sphinx，只是爲了讓事情保持一致（我已經開始用它手動）。

有沒有人爲此使用Sphinx或者有其他建議嗎？

Answer 1

近年來，Fortran支持Doxygen得到了很大改進，它甚至可以（有點）處理Fortran中的接口和類。但是，爲了記錄C++和類似的語言而編寫的，它的Fortran輸出並不真正感受到native [*]。另外，有些東西（如公共/私人功能）仍然無法正常工作（從版本1.8.5開始）。 我從來沒有嘗試過用於Fortran項目的Sphinx的autodoc功能，所以我不幸與Doxygen做了比較。

[*]例如模塊和接口被列爲數據類型。如果你想要一個例子，你可以看看DoxygenAPI documentation of one of my projects。