Doxygen 警告：忽略未知标签

Question

使用 Doxygen 生成文档。收到“警告：忽略未知标签”错误，我不明白为什么。

最小、完整和可验证的示例：

/** This is a test */
#include <iostream>

/** \fn foo */
int foo() {
    return 0;
}

int main() {   
    std::cout << "hello world" << std::endl;
    return 0;
}

错误：

[53]: doxygen .\myTest.cpp
Warning: ignoring unknown tag `This' at line 1, file .\myTest.cpp
Warning: ignoring unknown tag `is' at line 1, file .\myTest.cpp
Warning: ignoring unknown tag `a' at line 1, file .\myTest.cpp
Warning: ignoring unknown tag `test' at line 1, file .\myTest.cpp
Warning: ignoring unknown tag `fn' at line 4, file .\myTest.cpp
Warning: ignoring unknown tag `foo' at line 4, file .\myTest.cpp
Warning: ignoring unknown tag `int' at line 5, file .\myTest.cpp
Warning: ignoring unknown tag `foo' at line 5, file .\myTest.cpp
Warning: ignoring unknown tag `return' at line 6, file .\myTest.cpp
Warning: ignoring unknown tag `0' at line 6, file .\myTest.cpp
Warning: ignoring unknown tag `int' at line 9, file .\myTest.cpp
Warning: ignoring unknown tag `main' at line 9, file .\myTest.cpp
Warning: ignoring unknown tag `std' at line 10, file .\myTest.cpp
Warning: ignoring unknown tag `cout' at line 10, file .\myTest.cpp
Warning: ignoring unknown tag `hello' at line 10, file .\myTest.cpp
Warning: ignoring unknown tag `world' at line 10, file .\myTest.cpp
Warning: ignoring unknown tag `std' at line 10, file .\myTest.cpp
Warning: ignoring unknown tag `endl' at line 10, file .\myTest.cpp
Warning: ignoring unknown tag `return' at line 11, file .\myTest.cpp
Warning: ignoring unknown tag `0' at line 11, file .\myTest.cpp
Searching for include files...
Searching for example files...
Searching for images...
Searching for dot files...
Searching for files to exclude
Searching for files to process...
...other stuff...

谢谢，此致，基思 :^)

Answer 1

您将文件传递到 doxygen，就好像它是配置文件，而不是 cpp。这就是为什么它在每个单词上都会给你一个错误。

要生成文档，您现在可以输入：

doxygen <config-file>

见http://www.doxygen.nl/manual/starting.html#step2

相反，在您的源旁边生成一个配置文件：

doxygen -g myconfig.conf

然后运行 ​​doxygen：

doxygen myconfig.conf

由于默认为INPUT =，这将默认从当前目录中的文件构建文档。