Tweak Doxygen Comments for Experimental SIMD
This commit improves Doxygen documentation generation for the experimental SIMD features in libstdc++ by adjusting macro definitions and comment placement.
This commit improves the Doxygen documentation for the experimental SIMD (Single Instruction, Multiple Data) features in libstdc++. It defines Doxygen macros for the SIMD namespace and adjusts the placement of these macros and Doxygen comments in the <experimental/simd> header. This ensures that the SIMD components are correctly documented within the std::experimental::parallelism_v2 namespace.
In Details
The libstdc++ uses Doxygen to generate API documentation. The <experimental/simd> header defines the _GLIBCXX_SIMD_BEGIN_NAMESPACE and _GLIBCXX_SIMD_END_NAMESPACE macros to encapsulate the std::experimental::parallelism_v2 namespace. This commit adjusts the Doxygen configuration and the placement of these macros to ensure correct documentation generation, working around a potential Doxygen issue.
For Context
Doxygen is a tool used to automatically generate documentation from source code. SIMD (Single Instruction, Multiple Data) is a technique that allows processors to perform the same operation on multiple data points simultaneously, improving performance for certain types of calculations. This commit improves the documentation generated for the SIMD features in the C++ standard library.