Fortran文档自动生成器FORD试用

最新推荐文章于 2024-04-26 10:04:46 发布

lyz@csdn

最新推荐文章于 2024-04-26 10:04:46 发布

阅读量322

点赞数

分类专栏： Linux 文章标签： python linux anaconda doxygen

本文链接：https://blog.csdn.net/u011604213/article/details/115551987

版权

本文介绍了一次尝试使用FORD为一个大型Fortran代码库生成文档的经历。由于原始代码不符合Doxygen的注释规范，作者选择了FORD。在遇到ford-6.0.0版本的segment fault错误和ford-5.0.6版本的IndexError后，通过修改源代码并打印调试信息，发现问题是由于FORD不支持Fortran77语法。经过调整代码，成功生成了HTML文档，虽然ford-6.0.0仍然存在问题，但已将其报告给FORD项目团队。生成的文档主页展示良好，但函数调用图因保密原因未展示。

摘要由CSDN通过智能技术生成

手里有一个授权的第三方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

最低0.47元/天解锁文章

lyz@csdn

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Fortran文档自动生成器FORD试用

手里有一个授权的第三方fortran代码库AGMG，单个库文件代码量将近5000行。可授权方并没有提供开发者文档。为了辅助阅读代码，想着自己生成一个。针对fortran的自动文档生成，主要有以下几种：Doxygen，代码注释格式要求严格。而手里的源代码格式明显不符合，所以直接pass掉了。f90doc，使用起来很方便，能列出module内的变量、函数等信息，但无法画出Doxygen那样的函数调用图。最后选了FORD。安装后测试了几个小文件，效果非常不错，和Doxygen有异曲同工之妙。但
复制链接

扫一扫

专栏目录