使用 Boost.Test 宏为 doxygen 预定义的内容答案

【问题标题】：what predefined to use for doxygen with Boost.Test macros使用 Boost.Test 宏为 doxygen 预定义的内容
【发布时间】：2016-07-28 17:57:30
【问题描述】：

Boost.Test 框架测试宏使 doxygen 感到困惑。有没有办法帮助 doxygen 更好地使用 BOOST_TEST_* 和 BOOST_AUTO_TEST_* 宏？ ref api page?

【问题讨论】：

附带问题：为什么要在单元测试文件上运行 doxygen？
用于实现的内部文档；不适用于公共 api 的典型文档。
为此，我使用了 Doxygen 的 @snippet 命令，这样与您的文档无关的内容就会被丢弃。
是的，我也尝试过 sn-p。感谢您的反馈。您是否有推荐的优秀 C++ 文档示例作为模型来尝试和遵循？

标签： c++ doxygen boost-test

【解决方案1】：

我遇到了这个PREDEFINED doxygen 设置，似乎有帮助：

PREDEFINED             = "BOOST_AUTO_TEST_CASE(name)=void name()" \
                         "BOOST_AUTO_TEST_SUITE(name)=namespace BoostTest { class name {public:" \
                         "BOOST_FIXTURE_TEST_SUITE(name,data)=namespace BoostTest { class name {public:" \
                         "BOOST_AUTO_TEST_SUITE_END()=};}" \
                         "BOOST_CONCEPT_REQUIRES(req,type)=type " \
                         "BOOST_CONCEPT_ASSERT(req)= "

【讨论】：