Doxygen 什么应该放在“a”中;模块";或;“集团”;在强氧中?

Doxygen 什么应该放在“a”中;模块";或;“集团”;在强氧中?,doxygen,Doxygen,这类似于,但更具体一点。在一个组或模块中放置的预期元素是什么?如果我放置整个文件(包括@file构造),该文件仍会列在“全局文件”部分中。如果我不这样做,它会更有意义,但仍然没有大纲,描述模块的详细文本也不见了。即使有详细文本,也不在顶部,很难找到。对它的引用不会出现在细节部分,而是出现在模块中。我开始相信它一定是为了别的目的。我的问题是目的是什么?什么东西要放在一个组中?强氧组经常被忽略的价值是,它们使您能够(在文档中)将逻辑上相关但在代码中分离的东西放在一起 假设您有两个模块/类/任何东西。

这类似于,但更具体一点。在一个组或模块中放置的预期元素是什么?如果我放置整个文件(包括@file构造),该文件仍会列在“全局文件”部分中。如果我不这样做,它会更有意义,但仍然没有大纲,描述模块的详细文本也不见了。即使有详细文本,也不在顶部,很难找到。对它的引用不会出现在细节部分,而是出现在模块中。我开始相信它一定是为了别的目的。我的问题是目的是什么?什么东西要放在一个组中?

强氧组经常被忽略的价值是,它们使您能够(在文档中)将逻辑上相关但在代码中分离的东西放在一起

假设您有两个模块/类/任何东西。一个是碗,一个是水果。每个模块都是一个单独的代码模块,应保持这样的状态,并在强氧输出中进行了描述

但是,您希望为用户提供一些关于如何创建水果碗的指导

通过在Bowl和Fruit中的代码的相关部分中使用
ingroup Fruitbowls
,生成的文档将自动描述水果、碗和水果碗所需的内容,无需额外文本(除了
\defgroupfruitbowls
允许您在某个地方从类Fruit和Bowl等中介绍水果碗的组装)


本质上,组是一种将共享逻辑用途的代码段聚集在一起的方式,而不是一种代码结构(即模块)。

您错过了我问题的要点。“通过在代码的相关部分中使用ingroup”,相关部分是什么?是“文件”吗或者仅仅是特定的结构,或者仅仅是功能,或者全部三个部分都不能很好地工作。其他所有部分都有问题。
@section
命令用于组织纯文本-它与代码没有任何关系。我所说的“相关部分”指的是您选择的与之相关的任何内容(在我的示例中)通过使用
@ingroup@{
}
将其包围,您可以选择是否包围特定结构、方法或整个文件。使用组的更简单方法(如果您不希望此矩阵的好处)就是简单地用相同的组名包装多个相关文件的内容。这可能与C语言比OO语言更相关。你仍然完全没有回答这个问题。很公平;我认为你仍然完全没有理解组的意义。我试图回答“什么东西要放在一个组中?”.如果不是这个问题,我建议你重新措辞。