Doxygen-如何记录具有非标准扩展名 (.INI) 的文件

Question

我有一个简单的问题：如何记录 .INI 文件？

我有一个具有以下布局的 C++ 项目：

readme.txt
src
    main.cpp
data
    simple.ini

我从 readme.txt 和 main.cpp 生成文档没有问题，但是 simple.ini 中的文档根本没有显示在 html 输出中。我已修复 Doxygen 文件以包含以下内容：

INPUT = . src data
FILE_PATTERNS = *.cpp *.txt *.ini

那没有帮助。我还明确指定了 simple.ini：

INPUT = readme.txt data/simple.ini src

但它也不起作用。在 simple.ini 中，我使用 ';' 评论：

; @file simple.ini
; This file will do blah blah blah
[section1]
key1 = foo
key2 = bar
...

我也尝试使用 '#' 作为注释字符，但它也不起作用。如何让 doxygen 处理 simple.ini？

Answer 1

Doxygen 期望/**或 ///启动一个 doxygen 感知的评论块。我不知道它是否有效，但我会尝试评论：

; /// @file simple.ini
; /// This file will do blah blah blah
...