【问题标题】:doxygen with IDL/ODL带有 IDL/ODL 的 doxygen
【发布时间】:2010-06-17 17:32:16
【问题描述】:

如果你的 C++ 项目有一堆 .ODL 文件从 ODL 编译器生成的 .h 文件,应该告诉 doxygen 解析 .odl 和 .h,还是只解析非此即彼?一般来说,我不喜欢记录生成的代码,但 IDL 是一种特殊情况。

无论如何,ODL 文件的成员列表在我的测试中似乎不太正常,ODL 文件是否正确解析?

【问题讨论】:

    标签: c++ com doxygen idl


    【解决方案1】:

    this page 看来,Doxygen 完美支持解析*idl*.odl 文件。也许您对 cme​​ts 格式有一些问题?

    无论如何,我建议您不要同时解析 *.idl/*.odl 文件和生成的 .h 文件。根据定义,后者生成并表示与*.idl/*.old 文件中定义的类相同的类。

    解析两者就像记录同一组类两次,这显然不是一个好主意。

    【讨论】:

    • 这是我最初的想法……但是使用这些接口的类会发生什么……它们包含 .h 文件,所以这不是意味着链中的“间隙”吗?
    • 我不确定注释格式,即使没有源 cmets,我也将其设置为生成所有内容(我们正在对现有项目进行氧合)。我得到一个指向“xxx.odl”的链接,但点击它并没有像 .h 文件那样显示文件的来源。
    • @John:我怀疑 Doxygen 可以生成指向生成文件的链接(也就是它自己解析的文件)。关于链中的“差距”:我想这只是一种看待事物的方式;)Imo,认为某些未生成的类使用生成的文件是完全可以的。这里没有真正的“差距”:只是一个额外的“链接”(“世代”)。
    猜你喜欢
    • 2013-05-09
    • 1970-01-01
    • 2019-10-20
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2011-11-05
    • 1970-01-01
    相关资源
    最近更新 更多