【问题标题】:Does Lazy C++ (lzz) play nice with Doxygen?Lazy C++ (lzz) 是否与 Doxygen 配合得很好?
【发布时间】:2010-02-17 02:51:44
【问题描述】:

有没有人尝试在 Lazy C++ 源文件中嵌入 Doxygen cmets?任何问题?生成头文件/源文件后,Doxygen cmets 去哪里了?

【问题讨论】:

    标签: c++ doxygen lazy-c++


    【解决方案1】:

    我继续下载 Lazy C++ 来试用它,它似乎与 Doxygen 不兼容。我的 Doxygen cmets 根本没有出现在生成的头文件/源文件中。

    然后我尝试让 Doxygen 解析我的 lzz 文件,该文件有一个特殊的 #hdr 预处理器命令。 Doxygen 只是忽略了那个特殊的预处理器命令,生成的文档看起来很好。

    所以这个故事的寓意是简单地让 Doxygen 解析 *.lzz 文件,而不是生成的 *.h / *.cpp 文件。 :-)

    【讨论】:

    • 还有一个问题:我会记得在修复错误/错误时更改 *.lzz 文件(而不是生成的文件)吗? :-P
    • “我会记得对 *.lzz 文件进行更改吗” - 这是生成代码的普遍问题。如果您要编辑生成的文件,请将 cmets 放在那里,然后停止使用预处理器。否则,仅编辑 .lzz 文件并为您不想自动生成的内容创建自己的非生成 .cpp 和 .h 文件。
    • 我通常做的是删除生成的文件,然后重新生成它们,这是构建过程的一部分 - 这使得编辑生成的文件是徒劳的。
    • @Emile: 'lzz' 通过自动将声明拆分为标头/源来减少您的整体编码工作。此外,在优化(即 lzz 添加宏 LZZ_INLINE)和调试(lzz 添加大量#line 指令)之间,您真的不想编辑生成的标题/源代码。在我的 emacs 环境中,我有一些 lisp 将生成的头文件和源文件缓冲区标记为只读。如果您对此感兴趣,请按以下步骤操作:stackoverflow.com/questions/943760/…
    • @Justin:如果你这样删除生成的文件,会不会破坏增量编译,导致“重新编译世界”?
    猜你喜欢
    • 2010-09-11
    • 1970-01-01
    • 1970-01-01
    • 2013-03-02
    • 2021-10-25
    • 2011-06-08
    • 2011-01-18
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多