Doxygen：如何在源代码之外创建额外的类文档？

Question

我想添加关于我的核心类的详细信息，而不是将其全部嵌入源文件中的这些类之上。

例如，我想创建一个单独的文件，其中包含有关 Foo 类的大量信息，可能在 markdown 或 html 中。然后，当我在 doxygen 创建的输出中查看 Foo 类时，我希望 Foo 的类页面在其详细信息部分包含我所有大量且标记精美的文档以及我做过的任何其他 cmets 放在类Foo 之上。

这可能吗？

Answer 1

如果你当前有一个文件 Foo.h

/**
A short description of class Foo.
*/
class Foo
{
}

您可以在扩展名为 .dox 的文件中添加其他文档（我们称之为 Foo.dox）

/**
More details about Foo.

Maybe you only want to distribute this to your nicer customers.

@class Foo Foo.h
*/

不要忘记将 .dox 文件添加到配置文件的 INPUT 行

INPUT = \
Foo.h Foo.dox