本文主要是介绍Fortran文档自动生成器FORD试用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
手里有一个授权的第三方fortran代码库AGMG,单个库文件代码量将近5000行。可授权方并没有提供开发者文档。为了辅助阅读代码,想着自己生成一个。
针对fortran的自动文档生成,主要有以下几种:
Doxygen,代码注释格式要求严格。而手里的源代码格式明显不符合,所以直接pass掉了。
f90doc,使用起来很方便,能列出module内的变量、函数等信息,但无法画出Doxygen那样的函数调用图。
最后选了FORD。
安装后测试了几个小文件,效果非常不错,和Doxygen有异曲同工之妙。但对AGMG串行版库测试时却报了错。
其中ford-6.0.0版报告segment fault,加--debug也无法给出traceback信息。
回退到ford-5.0.6版,报告IndexError:string index out of range。应该是字符串数组的问题。
`Traceback (most recent call last):
File ".../.conda/envs/py36/bin/ford", line 8, in
sys.exit(run())
File ".../.conda/envs/py36/lib/python3.6/site-packages/ford/init.py", line 357, in run
main(proj_data,proj_docs,md)
File ".../.conda/envs/py36/lib/python3.6/site-packages/ford/init.py", line 310, in main
project = ford.fortran_project.Project(proj_data)
File
这篇关于Fortran文档自动生成器FORD试用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!