本人写信给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.
本人写信给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.