我正在开发一个 C 项目,该项目有许多不同的作者和许多不同的文档风格。
我是以下的忠实粉丝doxygen http://www.doxygen.org/和其他文档生成工具,我想迁移这个项目以使用这些系统之一。
有人知道有一种工具可以扫描源代码注释中的关键字,如“描述”、“作者”、“文件名”和其他类型的上下文,以智能地将注释转换为标准格式吗?如果没有,我想我可以编写一个疯狂的脚本,或者手动转换。
Thanks
当我读到 O'Reilly 的书时,我唯一能想到的就是莱克斯+雅克 http://oreilly.com/catalog/9781565920002,是不是有代码可以在命令行上输出注释,第 2 章中有一节展示了如何解析代码中的注释,包括//
and /*..*/
...页面上有一个链接作为示例,下载文件程序.zip http://examples.oreilly.com/9781565920002/progs.zip,您要查找的文件是ch2-09.l
需要构建的,可以轻松修改以输出注释。然后可以在脚本中使用它来过滤掉“名称”、“描述”等...
如果您有兴趣,我可以在这里发布有关如何执行此操作的说明?
Edit:我想我已经找到了您正在寻找的东西,一个预构建的评论文档提取器here http://web.archive.org/web/20100520023623/http://community.ingres.com/wiki/Documentation_Comment_Extractor.
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)