asio中的GENERATING_DOCUMENTATION宏定义的作用是什么？

Question

最近在看asio的源码，其中有一个宏定义的具体意思不明，查遍了国内外网站都没有相关记录，具体就是下面这个宏：GENERATING_DOCUMENTATION

Answer 1

本人写信给asio作者Chris，得到的回复是：Asio uses Doxygen to generate documentation directly from the Asio source code. Sometimes the generated documentation needs to be different to the real C++ implementation. Usually this happens when I want the documentation to contain simpler class or function declarations. The GENERATING_DOCUMENTATION macro is used to protect source code that should only be seen by Doxygen.