16得票5回答
Doxygen 1.8.7 / GraphViz 2.38 兼容性问题

我最近从使用 Doxygen 1.8.4 和 GraphViz 2.36 升级到了 Doxygen 1.8.7 和 GraphViz 2.38,但在生成图表时遇到了问题。 在编译期间,我收到了大量的错误信息,格式如下: 错误:运行 dot 出现问题:exit code=-1,comm...

15得票3回答
在Doxygen中将“内部”文档与“外部”文档分开

我希望使用Doxygen来记录一个库。文档将被两类人阅读:用户,他们仅关心外部API;开发者,他们想查看所有函数/结构的文档。 我想使用两个不同的Doxyfile来创建这些文档。是否有一些“标记”可以放在注释块中,以标记注释是内部的还是外部的?

14得票3回答
Doxygen中图像路径错误

tl;dr问题: doxygen在查找doxygen注释中引用的图像时使用的实际算法是什么?另外,什么被认为是最佳实践,不会在将来的doxygen版本中出现问题? 详细信息: 我们正在尝试制定一个政策,即与doxygen注释相关联的任何图像都应该本地化到引用位置,这意味着我们将在源树中分...

34得票2回答
如何为Doxygen设置输入目录?

我有一个目录,其中保存了所有的源代码和头文件。我想运行Doxygen来生成这些源代码的文档,但是我不想更改这个目录中任何东西(尤其是不能添加子目录以保存Doxygen文档)。 我该如何实现我的需求? 我认为我需要执行以下步骤: - 创建并进入“文档”目录。 - 在此目录中执行doxygen...

10得票2回答
如何在Doxygen中对typedef进行分类?

我在我的C++代码中使用了typedef结构体。目前它们被列为\var typedef。有更好的方法吗?以下是我目前所拥有的示例:/*! \var typedef etc * \brief A type defined structure for etc * * \param x ty...

27得票10回答
Doxygen,维护过于繁重?

我目前开始使用Doxygen来记录我的源代码。我已经注意到语法非常繁琐,每次修改源代码时,我也需要更改注释,我真的有一种每次在源代码中做出更改时都要花费太多时间修改注释的印象。 你有没有一些关于高效地记录我的源代码的技巧? 是否存在一些编辑器(或现有编辑器的插件)用于Doxygen执行以下...

17得票4回答
sh: dot: 命令未找到 + doxygen + Lion

MacOS 版本:10.7.2(狮子山) Doxygen 版本:1.7.5.1 Graphviz 版本:2.29 Doxygen 配置:DOT_PATH = ../../../../Applications/Contents/MacOS/Graphviz HAVE_DOT = YES S...

9得票1回答
如何使用Doxygen记录具有相同名称的枚举值?

我想用Doxygen记录两个包含一些相似值的类枚举。但是这会为每个具有相同名称的字段生成重复文本。 以下是我的两个枚举: /*! * \enum OperandType * \brief A type of operand. Represents the location of the...

44得票2回答
Sphinx已经适合用于C++文档吗?

我想尝试使用文档生成器来为一个新的C++项目生成文档。我认为我的选择是Doxygen或Sphinx。因为我有一些Python项目想要使用Sphinx,所以我想知道Sphinx是否也适用于C++。 Sphinx 网站表明支持C++,但我找不到一个能帮助我开始编写C++文档的文档。 一个类似的问...

24得票3回答
使用Doxygen生成Markdown文件作为文档。

我知道可以在注释中使用Markdown,并且doxygen可以理解它。但是我需要知道是否可以以Markdown格式生成文档? 我需要从C++文件中生成这些文档。